Files

105 lines
4.6 KiB
Markdown
Raw Permalink Normal View History

# 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 点数流水」