Token 省钱管家（省 Token 工作协议）· 让 AI 帮你省下自己的账单
> 一句话原理：账单 ≈ Σ（每次调用的上下文大小）。会话越长，每次调用都要把整段重发一遍 → 花费近似平方增长。
> 所以第一杠杆不是"少干活"，而是别让一个会话拖太长。这个技能，就是把这套纪律交给你的 AI 去执行。
一、钱到底花在哪（三个反直觉的事实）
| 你以为 | 实际 |
|---|---|
| 用得贵是因为任务重 | 长会话才是大头：上下文涨到 10 万后，每一次调用都要重发整段 |
| 缓存命中多就便宜 | 命中单价低约 50 倍，但未命中的输入和输出才是花钱主力 |
| 挂着不动不花钱 | 闲置几分钟缓存过期，下一个动作按全价重读整段上下文 |
二、装上后，AI 会主动做这 6 件事
- 一个任务一个窗口 —— 不再把几件事塞进同一个会话
- 上下文到约 12 万，主动提醒收尾 —— 不等你自己发现账单
- 换窗口自动交接 —— 你说一句「我准备换窗口了」，它立刻写好交接文档并给你新窗口的续接提示词，不用你重讲背景
- 读文件先定位再读区间 —— 不整读大文件、命令输出自动截断、不复述已知内容
- 先给结论 —— 不写"好的，我来帮你"，不重复粘贴长内容
- 你要离开时提醒关窗 —— 不让会话挂在后台烧缓存
三、换窗口不忘事：交接机制（最实用的一块）
> 触发词：听到「我准备换窗口了 / 换窗口 / 开个新窗口 / 交接一下 / 这个窗口太长了 / 先这样回头弄」——立刻自动执行整套交接，不用你再催。AI 侧的五步流程写在包内 workflow.md 第 0 节。
收尾时，AI 会把一份 ≤15 行的交接写到固定位置：
任务：<一句话>
已完成：<3-5 条要点 + 产出文件路径>
下一步：<1-2 条>
关键约定/坑：<只写新窗口不知道的>
下次开新窗口前，说一句「我准备换窗口了」（或「交接一下」）——AI 会自己生成这段提示词（自动带上真实的技能路径与交接文件路径），你复制粘贴即可无缝接上：
按「省 Token 工作协议」跟我工作。
先读这两个文件再动手：
1. <本技能目录>/SKILL.md
2. <数据目录>/handoff/最新交接.md
读完用一句话复述「任务 + 下一步」给我确认，然后继续做。
不要复述已知内容，先给结论，别写开场白；上下文到约 12 万提醒我收尾。
省下的正是最贵的那部分——重述历史。交接文件路径固定、每轮覆盖，永远不会找不到；历史版本存 handoff/历史/。
四、账单看得见：日报 / 周报 / 超支提醒 / 任务归因
说一句「出今天的 token 报告」，AI 直接读本机用量记录，生成按小时的表：
| 时段 | 费率 | 运行 | 输入(K) | 未命中(K) | 输出(K) | 花费(¥) | 占比 |
|---|---|---|---|---|---|---|---|
| 09:00-09:59 | 高峰 | 5 | 20165 | 332 | 66.6 | 1.991 | 17% |
| 23:00-23:59 | 高峰 | 13 | 8796 | 515 | 105.5 | 2.205 | 18% |
| 合计 | 109 | 88649 | 3725 | 645.5 | 11.926 | 100% |
表后固定附四段：最贵的单次运行、未命中率异常（= 中途闲置断了缓存）提示、针对当天数据的具体省钱建议、任务/项目花费归因。
另外三件：
- 周报：一句「出本周报告」→ 最近 7 天按天汇总 + 花费趋势（升 / 降 / 持平）
- 超支提醒：设好预算（默认 20 元/天、5 元/单次运行）后，超了自动打 ⚠️，并点名是哪次运行超的
- 按任务归因：干活前打一个开始点，报表就能按任务 / 项目拆花费；没打点的部分记「未标注」，占比高会提醒你
五、怎么用
装上即生效，也可以在对话里直接触发：
- 「按省 token 协议跟我工作」→ 立刻套用全部纪律
- 「我准备换窗口了」（或"换窗口 / 交接一下 / 这窗口太长了"）→ 立刻自动跑交接五步：写交接文档 + 贴续接提示词 + 告诉你下次从哪继续
- 「出今天的 token 报告」→ 按小时账单表（可指定日期、可存盘）
- 「出本周报告」→ 7 天汇总 + 趋势 + 任务归因
- 「这个任务花了多少」→ 按任务打点窗口归因
六、适用与不适用
- 适用：多步任务、长任务、跑测试、读大文件、反复迭代的开发 / 写作 / 调研
- 不适用：一句话问答（本来就没得省）
- 不影响干活：省掉的是浪费（重复读、重复说、拖长会话），不是把正事变少
七、计费与数据
- 单价常量按公开价目预设三档（缓存命中 / 未命中 / 输出）与两个时段（空闲 / 高峰），可自行修改
- 纯本地、只读：只读本机用量记录，不联网、不上传、不写你的业务数据
八、规格
- 版本 1.1.4 ｜ 纯本地离线 ｜ 无第三方依赖（Python 3.8+）
- 兼容 Windows / macOS / Linux
- 执行细节见包内
workflow.md（供 AI 读取，不在本页展示）
