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