From c7b3c84fb18b76aca38eb136b1baf6446ea3cabb Mon Sep 17 00:00:00 2001 From: argszero Date: Fri, 14 Aug 2026 22:03:10 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20platform=20fee=20=E2=80=94=20sharer=20e?= =?UTF-8?q?arns=2090%=20of=20consumption,=2010%=20to=20platform=20(v1.7)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/user-stories.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/docs/user-stories.md b/docs/user-stories.md index 9a2f181..89adf91 100644 --- a/docs/user-stories.md +++ b/docs/user-stories.md @@ -2,6 +2,7 @@ > **本文档以中文撰写**（用户故事主体、验收标准、流程说明均为中文；关键术语保留中英对照）。 > +> **v1.7（2026-08-15）· 平台收益抽成 10%.** 平台从分享者收益中抽取 **10%**：消费者支付 N 点 → 分享者获得 **N × 90%**（按小数点数规则，保留 2 位小数）、**N × 10% 归平台**。示例：A 消费 B 的 key 10 点 → A 扣 10 点、B 收益 9 点、平台分 1 点。核心机制表新增「平台抽成 Platform fee」；分享者收益相关 AC 更新（收益 = 消费点数 × 90%）；新增边界场景 **E-16**（小数抽成精度，如消费 3 点 → 收益 2.7 点）；平台运营者角色补充：平台分成是运营收入来源。 > **v1.6（2026-08-15）· 点数锚定改为人民币（CNY）.** **1 点 ≈ 1 元人民币**（替代旧规则 1 USD = 1,000 点）；**消费点数可为小数**（按 token 用量 × 模型单价精确计费，可能产生小数点数；余额与交易金额保留 2 位小数，四舍五入）。模型定价：**CNY 模型直接 1 元 = 1 点**（如 GLM-5.2 输出 28 元/百万 → 28 点/百万）；**USD 模型按 ~7.2 汇率折算为人民币点数**（如 OpenAI 输出 $25/百万 ≈ 180 点/百万）。更新 US-1 / US-2 / US-6 / US-23 / 对齐表；新增 **E-15**（小数计费精度）。 > **v1.5（2026-08-15）· 改用中文撰写.** 全文主体改为中文：产品模型、角色定义、用户故事（「作为〈角色〉，我希望〈能力〉，以便〈价值〉」格式）、关键流程、边界场景等均以中文书写；关键术语中英对照（点数 Points、Key 池 Key pool、上架 Listing、消费 Consumption、收益 Earnings、API Key）；用户故事与验收标准（AC）用中文；保留 mermaid 流程图（图中文字中文化）。**内容与 v1.4 完全一致，仅语言变化，不引入新机制。** > **v1.4（2026-08-15）· 修正新人赠送机制（防薅羊毛）.** 旧的「注册即送 10 点（1 周有效）」**替换**为**每日赠送机制**：**每天送 1 点**（每日 1 点），每次赠送的点数**有效期 1 天**（当日有效，过期清零），**注册起连续 10 个自然日**每天发放 1 点（10 天后停止）；用户需**每天登录 / 回来**才能领取当日 1 点——未领取日的点数**不发、不积累**。不变：分享收益点数永久有效；未来充值点数永久有效；消费扣减顺序先扣有有效期的点数。防薅动机：每日 1 点 / 1 天有效，集中注册多号无意义。更新 US-3 / US-22 / US-23 / 流程 J-1 / 边界场景 E-13；新增 **E-14**（当日赠送未领取）。 @@ -35,7 +36,8 @@ | **Key 池 Key pool** | 平台托管的模型上游 API key（静态加密存储）。企业版：管理员上传；公共版：分享者上传。 | | **上架 Listing** | 分享者上架一个闲置 key 并声明配额。**单价不由分享者设定**——平台按模型价格表自动定价（参考单价 = 模型输出价，点数 / 1M tokens）。 | | **消费 Consumption** | 用户花点数通过平台调用模型（聊天 / API）。 | -| **收益 Earnings** | 有人通过分享者的 key 消费时，分享者赚取点数。 | +| **收益 Earnings** | 有人通过分享者的 key 消费时，分享者赚取点数（消费点数 × 90%，见「平台抽成」）。 | +| **平台抽成 Platform fee** | 平台从分享者每笔收益中抽取 **10%**：消费者支付 N 点 → 分享者获得 **N × 90%**、**N × 10% 归平台**。示例：消费 10 点 → 分享者得 9 点、平台分 1 点。抽成后金额按小数点数规则保留 2 位小数（如消费 3 点 → 收益 2.7 点）。平台分成是运营收入来源。 | | **API Key (atk_)** | 平台签发的 key（`atk_live_…`），让用户 / 脚本调用平台 API。在设置页管理。 | | **配额 / 分配 Quota / allocation** | 企业版：每个部门、每个成员的每月点数配额。 | | **管理视图 Admin view** | 仅角色可见的视图：key 池管理、成员管理、用量报表、组织（部门）管理。 | @@ -147,9 +149,9 @@ flowchart LR - **US-10** 作为分享者，我希望暂停 / 恢复 / 重新上架 / 删除上架，以便控制我的 key 何时被消费。 - AC：暂停 = 停止接单，可恢复；删除 = 从平台永久移除，不可逆，需确认；重新上架可激活已暂停 / 已下架的上架。 - **US-11** 作为分享者，我希望知道我的 key 何时被消费，以便看到收益累积。 - - AC：每次消费产生一条「收益」交易（对方模型、tokens、+点数）；设置页有通知开关（「共享 key 被消费时通知」）。 + - AC：每次消费产生一条「收益」交易（对方模型、tokens、+点数 = 消费点数 × 90%，扣除 10% 平台分成）；设置页有通知开关（「共享 key 被消费时通知」）。 - **US-24** 作为分享者，我希望收益点数永久有效，以便从分享中积累长期价值。 - - AC：收益点数（收益点数）永不过期；钱包显示「收益点数 · 永久」；只在所有有有效期的（赠送）点数被扣完后才被扣减。 + - AC：收益点数（收益点数）永不过期；钱包显示「收益点数 · 永久」；只在所有有有效期的（赠送）点数被扣完后才被扣减。收益金额 = 消费点数 × 90%（已扣 10% 平台抽成）。 #### 关键流程（Key Flow）— J-2: 上传 key → 首次收益 @@ -172,7 +174,7 @@ flowchart LR ### 2.4 用户类型 D — 平台运营者（Platform Operator：宿主本人 / 部署者） -> **身份**: 平台运营者 = **宿主本人**（deployer / owner of this deployment）。该角色已定义，**目前没有其他特殊操作**（不做内容审核、不做违规处理、不做市场调节等，规划中也无需加入，保持最小）。 +> **身份**: 平台运营者 = **宿主本人**（deployer / owner of this deployment）。该角色已定义，**目前没有其他特殊操作**（不做内容审核、不做违规处理、不做市场调节等，规划中也无需加入，保持最小）。平台从分享者收益中抽取的 **10% 分成是运营收入来源**。 #### 目标（Goals） @@ -335,6 +337,7 @@ flowchart LR | E-13 | **每日赠送点数过期**（Daily gift point expired） | 【公共】 | 每次每日赠送的点数有效期 **1 天**（当日有效）——当日未用点数在当天结束时过期 / 清零。有效期可见（如「有效期至今日」）。消费**先扣有有效期的（赠送）点数**，再扣永久点数，所以每日赠送点数会被先用掉、永久点数永不因过期竞争而损失。 | | E-14 | **当日赠送未领取**（Daily gift not claimed） | 【公共】 | 赠送机制**注册起连续 10 个自然日**、每天 1 点；若用户某天未登录，当日点数**不发、不积累**（不积累、不补发）——机制仍在第 10 天后结束。 | | E-15 | **小数计费精度**（Fractional billing precision） | 【通用】 | 消费按 token 用量 × 模型单价精确计算，结果可为小数；金额与余额**统一保留 2 位小数、四舍五入**（如 0.374 → 0.37、0.375 → 0.38）；交易记录与钱包显示一致，避免「显示 0.37 实际扣 0.374」的歧义。 | +| E-16 | **小数抽成精度**（Fractional platform-fee precision） | 【公共】 | 分享者收益 = 消费点数 × 90%，结果可为小数；收益金额**保留 2 位小数、四舍五入**（如消费 3 点 → 收益 2.7 点、平台分 0.3 点；消费 1 点 → 收益 0.9 点）。平台抽成与分享者收益之和始终等于消费者支付金额（四舍五入误差按平台侧吸收，保证分享者所得准确）。 | --- @@ -344,7 +347,7 @@ flowchart LR |---|---|---| | 页面 / 导航 | `ui/index.html`（仪表盘 / 市场 / 共享 / 钱包 / 交易记录 / 设置 + 管理视图） | 每个故事映射到具体页面；管理视图按角色门控，其余共用。 | | 点数与定价 | `ui/js/data.js`（**1 点 ≈ 1 元 CNY**；CNY 模型直接 1 元 = 1 点，USD 模型按 ~7.2 汇率折算；参考价 = 输出价 点数/1M） | US-1、US-2、US-8 使用同一套规则；没有分享者自定定价；消费点数可为小数（保留 2 位）。 | -| 点数有效期与扣减顺序 | `docs/user-stories.md` v1.6（每日赠送 1 点 / 1 天有效 / 连续 10 天；收益与充值永久；先扣赠送；金额保留 2 位小数） | US-22、US-23、US-24、E-13、E-14、E-15 一致；UI mock（feat/gift-daily-ui）显示今日赠送（+1）、有效期与连续天数计数。 | +| 点数有效期与扣减顺序 | `docs/user-stories.md` v1.7（每日赠送 1 点 / 1 天有效 / 连续 10 天；收益与充值永久；先扣赠送；金额保留 2 位小数；分享收益扣 10% 平台分成） | US-22、US-23、US-24、E-13、E-14、E-15、E-16 一致；UI mock 显示今日赠送（+1）、有效期与连续天数计数，收益按 90% 计入。 | | Key 脱敏与安全 | `ui/js/data.js`、`ui/README.md`（脱敏 key、加密托管、删除确认） | US-8、US-9、US-21、E-05 一致。 | | 企业语义 | `ui/js/data.js`（key 池状态、部门、成员未分配） | US-12…US-16、E-03、E-06 一致。 | | 集中式架构 | `docs/architecture.md`（平台托管 key、计量引擎、账本） | 全文基于集中式执行假设；消费 / 收益都流经平台账本。 |