docs: listing form selects provider → plan → model (v1.9)

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）的价格，

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 何时被消费，以便看到收益累积。