root/geo

Fork 0

Files

T

root f69edc2218

Deployment Config CI / Deployment Config (push) Successful in 39s

Details

Backend CI / Backend (push) Successful in 18m14s

Details

feat(tenant): bill AI points by output characters

Previously AI point cost was computed from request (input) characters at
reservation time. Switch to reserving a single point up front and
settling the final cost from the generated output length on completion.

- Reserve 1 point (or FixedPoints) instead of pricing on request chars
- On completion, recompute points from output chars vs base chars,
  update the reservation amounts, and post a ledger delta for the
  top-up/refund; invalidate the workspace quota summary cache
- MarkCompleted now persists final request_chars/base_chars/points
- Use ceil division in calculateAIPointCost so an exact base boundary
  charges one point instead of rolling over
- Thread output text through all CompleteAIPoints callers (article
  selection, KOL assist, question expansion, template assist, compliance
  judge) and return the settled reservation
- Add unit tests plus an integration test gated on TEST_DATABASE_URL
- Update the user manual: billing is by output characters

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-07-09 17:04:37 +08:00

4.6 KiB

Raw 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 Blame History Unescape Escape