From 5309653a86ec412b2f7411c103a8fe7e54c527b0 Mon Sep 17 00:00:00 2001 From: argszero Date: Mon, 17 Aug 2026 13:37:38 +0800 Subject: [PATCH] docs: neutralize anti-abuse wording in user stories, bump to v1.8 --- docs/user-stories.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/user-stories.md b/docs/user-stories.md index 89adf91..c93ad95 100644 --- a/docs/user-stories.md +++ b/docs/user-stories.md @@ -2,10 +2,11 @@ > **本文档以中文撰写**（用户故事主体、验收标准、流程说明均为中文；关键术语保留中英对照）。 > +> **v1.8（2026-08-17）· 移除面向用户文案中的防薅表述，文档措辞中性化.** 「防薅羊毛」是产品内部设计动机，不应出现在面向用户的界面文案中（UI 侧已同步移除）。本文档中的设计备注措辞中性化：「防薅动机」改为「设计意图」（如每日赠送机制的设计意图是**鼓励每日活跃**，同时降低集中注册多号的收益）。面向用户可见的赠送规则保持「每日赠送 1 点（当日有效）· 连续 10 天」。更新核心机制表「赠送点数」行措辞。 > **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**（当日赠送未领取）。 +> **v1.4（2026-08-15）· 修正新人赠送机制.** 旧的「注册即送 10 点（1 周有效）」**替换**为**每日赠送机制**：**每天送 1 点**（每日 1 点），每次赠送的点数**有效期 1 天**（当日有效，过期清零），**注册起连续 10 个自然日**每天发放 1 点（10 天后停止）；用户需**每天登录 / 回来**才能领取当日 1 点——未领取日的点数**不发、不积累**。不变：分享收益点数永久有效；未来充值点数永久有效；消费扣减顺序先扣有有效期的点数。设计意图：鼓励每日活跃，降低集中注册多号的收益。更新 US-3 / US-22 / US-23 / 流程 J-1 / 边界场景 E-13；新增 **E-14**（当日赠送未领取）。 > **v1.3（2026-08-14）· 明确平台运营者角色（运营者 = 宿主本人）.** 运营者是**部署者 / 拥有者（宿主本人）**，职责仅两项：**① 查看平台运行情况**（运行状态 / 用户数 / 共享 key 数 / 交易量 / 点数流动）和 **② 给指定用户充值点数**（永久有效点数，产生交易记录）。内容审核 / 违规处理 / 市场调节**明确排除**——保持最小。新增 US-运营1 / US-运营2（替换「规划中 Planned」占位）。 > **v1.2（2026-08-14）· 点数机制定案（纯分享经济）.** 每个注册用户赠送 **10 点**（新人体验券）有效 **1 周**；分享收益点数**永久有效**；未来充值点数**永久有效**。消费**先扣有有效期的（赠送）点数**。新增 US-22/23/24 与边界场景 E-13（赠送点数过期）。 > **v1.1（2026-08-14）· 结构调整.** 文档改为**先按部署场景、再按用户类型**组织（场景 → 用户类型 → 故事）：`## 公共场景 Public` / `## 企业场景 Enterprise`，每个场景下列出其用户类型及 Goals / Pain points / User stories / Key flows。复用 v1.0 内容，将归属重新按场景划分。 @@ -29,7 +30,7 @@ |---|---| | **点数 Point** | 平台的计价单位。**1 点 ≈ 1 元人民币（CNY）**（替代旧规则 1 USD = 1,000 点）。**消费点数可为小数**——按 token 用量 × 模型单价精确计费，可能产生小数点数（如一次消费 0.37 点）；余额与交易金额显示保留 **2 位小数**（四舍五入）。 | | **模型定价 Model pricing** | **CNY 模型直接 1 元 = 1 点**（如 GLM-5.2 输出 28 元/百万 tokens → 28 点/百万）；**USD 模型按 ~7.2 汇率折算为人民币点数**（如 OpenAI 输出 $25/百万 tokens ≈ 180 点/百万）。参考单价 = 模型输出价（点数 / 1M tokens）。 | -| **赠送点数 Gift points** | 新用户**每日赠送机制**：**每天 1 点**（每日 1 点），**注册起连续 10 个自然日**；每次赠送的点数**有效期 1 天**（当日有效，过期清零）。用户需**当天登录 / 回来领取**——未领取日的点数**不发、不积累**，第 10 天后停止赠送。防薅动机：每日 1 点 / 1 天有效，集中注册多号无意义。 | +| **赠送点数 Gift points** | 新用户**每日赠送机制**：**每天 1 点**（每日 1 点），**注册起连续 10 个自然日**；每次赠送的点数**有效期 1 天**（当日有效，过期清零）。用户需**当天登录 / 回来领取**——未领取日的点数**不发、不积累**，第 10 天后停止赠送。设计意图：鼓励每日活跃，集中注册多号收益低。 | | **收益点数 Earned points** | 分享 key 赚取的点数；**永久有效**——无有效期。 | | **充值点数 Top-up points** | 未来充值获得的点数；**永久有效**（充值功能当前暂不支持，但规则先定）。 | | **扣减顺序 Deduction order** | 消费**先扣有有效期的（赠送）点数**，再扣永久点数——有效期内点数不浪费，永久点数不会因过期竞争而损失。 |