root/geo

Files

T

root ab62d666b4 docs(user-manual): add product user manual aligned to live code

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>

2026-05-06 00:20:47 +08:00

4.6 KiB

Raw Permalink Blame 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 点数：可用余额
重置时间：免费版的配额重置时间点

更细的配额（品牌数上限、关键词总数、单关键词问题数）在品牌词库页面顶部条形展示。

配额耗尽时的提示

生成文章额度用尽：发起任务时弹窗提示，并引导查看升级入口
AI 点数不足：AI 分析、标题生成、大纲生成等按钮置灰，提示"点数不足"
品牌/关键词/问题数到上限：新建按钮置灰，提示具体上限值

5. 流水排查

进入 AI 点数明细 页查看流水：

使用场景：哪类操作触发的扣点
点数：本次消耗（负数表示扣除，正数表示退回）
计费字数：实际请求字数
创建时间、状态

如果有"莫名其妙的扣点"：

看流水里的 使用场景，对照表确认是哪个动作触发的
看状态，已退回 表示任务失败已退还，无需关注
单条扣点异常偏高时，把流水截图反馈给运营/管理员

6. 升级套餐

侧边栏"套餐与额度"区域提供升级入口（按租户配置可能为占位）。当前主要由销售/管理员人工对接。升级后：

配额（品牌/关键词/问题/文章/点数）实时生效
已有任务的预占、流水保留不变
旧版本套餐的配额不会"翻新"（即不会自动多送月初配额）

7. 常见问题

点数不够但工作台还能点生成：因为前端只在提交时校验余额，进入向导前不拦截。提交时如果点数不足才会拒绝
任务失败了，但点数还是扣了：核对流水里对应记录的状态；正常应该是 已退回。如果显示失败（极少见）或仍是 已扣除，请提工单
看不到 AI 点数明细：需要登录态正常 + 当前账号有 AI 用量记录才会展示流水；从未触发 AI 调用的全新账号会显示「暂无 AI 点数流水」

4.6 KiB Raw Permalink Blame History Unescape Escape