root
ab62d666b4
Cover onboarding, workspace, article creation, brand library, media publishing, knowledge base, image library, GEO tracking, desktop client, KOL marketplace, AI points, and FAQ — sourced from actual views and i18n rather than the v1 PRD. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
105 lines
4.6 KiB
Markdown
105 lines
4.6 KiB
Markdown
# AI 点数与套餐
|
||
|
||
省心推用 **AI 点数** 作为内部计费单位，覆盖各类 AI 调用（文章生成、模板分析、片段优化等）。本章只讲点数与套餐的可见行为；具体计费公式以平台财务规则为准。
|
||
|
||
## 1. 在哪里看点数
|
||
|
||
### 个人中心 → AI 点数明细
|
||
|
||
路径 `/account/ai-points`。页面包含：
|
||
|
||
- **可用点数**（balance）：当前剩余可消耗点数
|
||
- **基准字数**（baseChars）：当前套餐的「每 N 字消耗 1 点」基准
|
||
- **消耗流水**：最近几条点数变动记录
|
||
|
||
### Web 端右上角侧边栏
|
||
|
||
侧边栏底部"套餐与额度"区域聚合显示：
|
||
|
||
- **当前套餐**（如 免费版）+ **状态正常**
|
||
- **会员到期** 时间
|
||
- **生成文章** 配额（剩余/总额）
|
||
- **AI 点数** 余额
|
||
- **重置时间**：免费版的配额重置周期
|
||
|
||
## 2. 点数消耗规则
|
||
|
||
### 计费基础
|
||
|
||
- 每个 AI 调用按"请求字数 / 基准字数"换算成点数
|
||
- 套餐越高，**基准字数** 越大（同样请求消耗的点数越少）
|
||
- 流水里能看到「{字数} 字 / 基准 {基准}」的换算说明
|
||
|
||
### 预占与确认
|
||
|
||
AI 任务在提交时会**先预占**对应点数，任务完成后才正式确认扣除：
|
||
|
||
| 状态 | 含义 |
|
||
| --- | --- |
|
||
| **处理中**（pending） | 已预占，等待结果 |
|
||
| **已扣除**（completed） | 任务成功，正式扣除 |
|
||
| **已退回**（refunded） | 任务失败，预占点数原路退回 |
|
||
| **失败**（failed） | 任务失败但点数处理异常（少见） |
|
||
|
||
> 预占机制保证你不会"跑了一半发现点数不够"，但同时也意味着排队任务会占用余额。
|
||
|
||
## 3. 点数消耗场景
|
||
|
||
每条流水会带 **使用场景** 标签，常见的：
|
||
|
||
| 场景代号 | 中文显示 | 对应行为 |
|
||
| --- | --- | --- |
|
||
| `template_analyze` | AI 分析 | 模版向导第 1 步的 AI 品牌分析（关键词/竞品/标题候选） |
|
||
| `template_title_generate` | AI 生成标题 | 模版向导第 2 步生成 5 个标题候选 |
|
||
| `template_outline_generate` | AI 生成大纲 | 模版向导第 3 步生成完整大纲 |
|
||
| `article_selection_optimize` | 文章片段优化 | 文章编辑器里选中段落让 AI 改写 |
|
||
| `kol_prompt_generate` | KOL 模版生成 | KOL 管理页用 AI 帮你写一段 prompt 初稿 |
|
||
| `kol_prompt_optimize` | KOL 模版优化 | KOL 管理页让 AI 优化已有 prompt |
|
||
|
||
> 注意：模版生成的"正文"消耗主体在 **生成额度**（按文章篇数计），AI 分析/标题/大纲走的是 AI 点数。两者是分开计量的。
|
||
|
||
## 4. 套餐与配额
|
||
|
||
侧边栏的"套餐与额度"区域展示当前套餐核心配额：
|
||
|
||
- **生成文章**：按月或周期计；用尽后无法再发起新生成任务
|
||
- **AI 点数**：可用余额
|
||
- **重置时间**：免费版的配额重置时间点
|
||
|
||
更细的配额（品牌数上限、关键词总数、单关键词问题数）在 [品牌词库](./04-品牌词库.md) 页面顶部条形展示。
|
||
|
||
### 配额耗尽时的提示
|
||
|
||
- **生成文章额度用尽**：发起任务时弹窗提示，并引导查看升级入口
|
||
- **AI 点数不足**：AI 分析、标题生成、大纲生成等按钮置灰，提示"点数不足"
|
||
- **品牌/关键词/问题数到上限**：新建按钮置灰，提示具体上限值
|
||
|
||
## 5. 流水排查
|
||
|
||
进入 **AI 点数明细** 页查看流水：
|
||
|
||
- **使用场景**：哪类操作触发的扣点
|
||
- **点数**：本次消耗（负数表示扣除，正数表示退回）
|
||
- **计费字数**：实际请求字数
|
||
- **创建时间**、**状态**
|
||
|
||
如果有"莫名其妙的扣点"：
|
||
|
||
1. 看流水里的 **使用场景**，对照表确认是哪个动作触发的
|
||
2. 看 **状态**，**已退回** 表示任务失败已退还，无需关注
|
||
3. 单条扣点异常偏高时，把流水截图反馈给运营/管理员
|
||
|
||
## 6. 升级套餐
|
||
|
||
侧边栏"套餐与额度"区域提供升级入口（按租户配置可能为占位）。当前主要由销售/管理员人工对接。升级后：
|
||
|
||
- 配额（品牌/关键词/问题/文章/点数）实时生效
|
||
- 已有任务的预占、流水保留不变
|
||
- 旧版本套餐的配额不会"翻新"（即不会自动多送月初配额）
|
||
|
||
## 7. 常见问题
|
||
|
||
- **点数不够但工作台还能点生成**：因为前端只在提交时校验余额，进入向导前不拦截。提交时如果点数不足才会拒绝
|
||
- **任务失败了，但点数还是扣了**：核对流水里对应记录的 **状态**；正常应该是 **已退回**。如果显示 **失败**（极少见）或仍是 **已扣除**，请提工单
|
||
- **看不到 AI 点数明细**：需要登录态正常 + 当前账号有 AI 用量记录才会展示流水；从未触发 AI 调用的全新账号会显示「暂无 AI 点数流水」
|