diff --git a/config/config.example.toml b/config/config.example.toml index 88cf870..f6016c4 100644 --- a/config/config.example.toml +++ b/config/config.example.toml @@ -151,6 +151,55 @@ endpoints = [ { protocol = "anthropic", base_url = "https://api.minimaxi.com/anthropic" }, ] +# —— 按量付费(paygo)Plan:每家厂商至少一个「API(按量)」项(上架表单 Plan 下拉)—— +# deepseek-paygo 见上;以下补齐 智谱 / 阿里云百炼 / 火山方舟 / Kimi / MiniMax + +[[plans]] +id = "zhipu-paygo" +provider = "zhipu" +type = "paygo" +key_prefix = "sk-" # 普通按量 Key +endpoints = [ + { protocol = "openai_chat", base_url = "https://open.bigmodel.cn/api/paas/v4" }, + { protocol = "anthropic", base_url = "https://open.bigmodel.cn/api/anthropic" }, +] + +[[plans]] +id = "aliyun-bailian-paygo" +provider = "aliyun-bailian" +type = "paygo" +key_prefix = "sk-" # 普通按量 Key +endpoints = [ + { protocol = "openai_chat", base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1" }, +] + +[[plans]] +id = "ark-paygo" +provider = "bytedance-ark" +type = "paygo" +key_prefix = "sk-" # 普通按量 Key +endpoints = [ + { protocol = "openai_chat", base_url = "https://ark.cn-beijing.volces.com/api/v3" }, +] + +[[plans]] +id = "moonshot-paygo" +provider = "moonshot" +type = "paygo" +key_prefix = "sk-" # 普通按量 Key +endpoints = [ + { protocol = "openai_chat", base_url = "https://api.moonshot.cn/v1" }, +] + +[[plans]] +id = "minimax-paygo" +provider = "minimax" +type = "paygo" +key_prefix = "sk-" # 普通按量 Key +endpoints = [ + { protocol = "openai_chat", base_url = "https://api.minimaxi.com/v1" }, +] + # ============================================================ # 4. 官方价覆盖(可选) # 覆盖 data/models.json 里聚合源(OpenRouter/litellm)的价格, diff --git a/docs/user-stories.md b/docs/user-stories.md index c93ad95..1bc4ba4 100644 --- a/docs/user-stories.md +++ b/docs/user-stories.md @@ -2,6 +2,7 @@ > **本文档以中文撰写**(用户故事主体、验收标准、流程说明均为中文;关键术语保留中英对照)。 > +> **v1.9(2026-08-17)· 上架流程改为「厂商 → Plan → 模型」.** 分享者上架时选择的是**厂商的 Plan**(而不是厂商/模型):大多数分享的是自己的 Plan 订阅(如阿里 Token Plan、Kimi Code),同一厂商不同 Plan 的 Base URL 可能不同。上架表单改为三级联动「选厂商 → 选 Plan → 选该 Plan 支持的模型」,Plan 下拉中「API(按量)」代表按量计价的 key,其余为订阅 Plan;内置国内已知 Plan 清单(阿里云百炼 / 智谱 / 火山方舟 / Kimi 月之暗面 / MiniMax / DeepSeek,每家至少一个「API(按量)」项)。共享列表展示「厂商 · Plan / 模型」。更新 US-8 / US-9 / 核心机制表「上架 Listing」行。 > **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**(小数计费精度)。 @@ -35,7 +36,7 @@ | **充值点数 Top-up points** | 未来充值获得的点数;**永久有效**(充值功能当前暂不支持,但规则先定)。 | | **扣减顺序 Deduction order** | 消费**先扣有有效期的(赠送)点数**,再扣永久点数——有效期内点数不浪费,永久点数不会因过期竞争而损失。 | | **Key 池 Key pool** | 平台托管的模型上游 API key(静态加密存储)。企业版:管理员上传;公共版:分享者上传。 | -| **上架 Listing** | 分享者上架一个闲置 key 并声明配额。**单价不由分享者设定**——平台按模型价格表自动定价(参考单价 = 模型输出价,点数 / 1M tokens)。 | +| **上架 Listing** | 分享者上架一个闲置 key(选择**厂商 → Plan → 模型**,Plan 下拉中「API(按量)」代表按量计价的 key,其余为订阅 Plan;内置国内已知 Plan 清单)并声明配额。**单价不由分享者设定**——平台按模型价格表自动定价(参考单价 = 模型输出价,点数 / 1M tokens)。 | | **消费 Consumption** | 用户花点数通过平台调用模型(聊天 / API)。 | | **收益 Earnings** | 有人通过分享者的 key 消费时,分享者赚取点数(消费点数 × 90%,见「平台抽成」)。 | | **平台抽成 Platform fee** | 平台从分享者每笔收益中抽取 **10%**:消费者支付 N 点 → 分享者获得 **N × 90%**、**N × 10% 归平台**。示例:消费 10 点 → 分享者得 9 点、平台分 1 点。抽成后金额按小数点数规则保留 2 位小数(如消费 3 点 → 收益 2.7 点)。平台分成是运营收入来源。 | @@ -143,10 +144,10 @@ flowchart LR #### 用户故事(User Stories) -- **US-8** 作为分享者,我希望只填厂商 / 模型 / 声明配额就能上架一个闲置 key,以便以最小成本开始赚点数。 - - AC:上架表单必填厂商、模型、API key(密码输入)、声明配额;参考价按模型价格表自动计算(模型无定价数据时按「默认价」兜底,不报错);平台加密存储 key;key 绝不对他人明文展示。 +- **US-8** 作为分享者,我希望选择「厂商 → Plan → 模型」就能上架一个闲置 key(大多数分享的是自己的 Plan 订阅),以便以最小成本开始赚点数。 + - AC:上架表单为三级联动「选厂商 → 选 Plan → 选该 Plan 支持的模型」,Plan 下拉中「API(按量)」代表按量计价的 key,其余为订阅 Plan;内置国内已知 Plan 清单(阿里云百炼 / 智谱 / 火山方舟 / Kimi 月之暗面 / MiniMax / DeepSeek,每家至少一个「API(按量)」项);选择 Plan 后展示对应提示(key 前缀 / 专属端点);必填 API key(密码输入)、声明配额;参考价按模型价格表自动计算(模型无定价数据时按「默认价」兜底,不报错);平台加密存储 key;key 绝不对他人明文展示。 - **US-9** 作为分享者,我希望看到我的上架列表(脱敏 key、配额用量、收益),以便监控表现。 - - AC:分享页显示统计 + 我的上架列表(key 脱敏如 `sk-****1234`);每行显示已用 / 配额、单价、累计收益、状态。 + - AC:分享页显示统计 + 我的上架列表(key 脱敏如 `sk-****1234`);每行显示「厂商 · Plan / 模型」(如「智谱 · GLM Coding Plan / glm-5.2」)、已用 / 配额、单价、累计收益、状态。 - **US-10** 作为分享者,我希望暂停 / 恢复 / 重新上架 / 删除上架,以便控制我的 key 何时被消费。 - AC:暂停 = 停止接单,可恢复;删除 = 从平台永久移除,不可逆,需确认;重新上架可激活已暂停 / 已下架的上架。 - **US-11** 作为分享者,我希望知道我的 key 何时被消费,以便看到收益累积。