TokenWise · Daily（日常记忆省 token）
这是什么 / 为什么有用（先看值不值）
省 token = 省钱。 你的日常对话，AI 每一轮都在读上下文——读得越多，花得越多。
TokenWise · Daily 让每一轮只读取当下真正需要的那部分记忆：问天气只看天气，问理财只看理财，回忆什么精准取什么，绝不整柜搬出。聊过的有价值信息会自动沉淀成你的专属记忆，越用越省。
实测省 token（2026-08-12 真实场景对照）：
- 问"我的理财持仓怎么样"：通篇重读 25,598 token → 定向读取 4,643 token，省 82%
- 模型越贵省得越多：同样的 token 量，高级模型省钱金额成倍放大
30 秒上手（先看这个）
- 装好技能，对话里说一句「帮我回忆上次理财怎么定的」
- 之后日常对话自动生效：问天气只读天气、问理财只读理财，回答带「来源：xx 档案」
- 聊过的重要信息会自动沉淀成你的专属记忆，越用越省
> 不用记命令、不用配任何东西——说人话就能用。完整机制、工作流、长文件分节策略见随包 engine/ 目录。
安装方法
解压 → 复制整个文件夹到你的 AI 工具技能目录 → 重启会话，说一句"帮我回忆 xxx"，正常返回即安装成功。各工具的具体路径见随包 INSTALL.md（3 步约 1 分钟）。
适配 AI 工具（能装 / 不能装）
| AI 工具 | 适配 | 做法 |
|---|---|---|
| WorkBuddy | ✅ 原生适配 | 复制到 ~/.workbuddy/skills/，对话直接触发 |
| CodeBuddy / Claude Code | ✅ 支持 | 复制到对应 skills 目录 |
| Cursor | ✅ 支持（新版） | 放入 .cursor/skills/ |
| Trae | ✅ 完整适配（实测） | 完整包放进 ~/.trae-cn/skills/<技能名>/（目录名=SKILL.md 的 name）；或核心纪律抄入 ~/.trae-cn/user_rules/ 常驻生效 |
| 纯聊天 AI（网页/App） | ⚠️ 降级可用 | 粘贴随包说明为"自定义指令" |
| 非 AI 工具 / 开发引擎 | ❌ 不适用 | 这是 AI 对话流程型技能 |
怎么用（纯对话触发）
- "帮我回忆上次理财怎么定的" / "我之前说过的 XXX" / "我好像提过那个……"
- 触发一次后，日常对话自动生效；无需配置、无需终端、无依赖
- 触发没反应 / 说错词也别慌：AI 按"语义优先"兜底，识别不出主题域最多补 1 个问题，不会因此通篇重读（降级预案见
engine/REFERENCE.md第 9 节）
装完怎么验证（30 秒自检）
- 说"帮我回忆 XXX"——正常返回 = 装好了
- 问天气只看天气、问理财只看理财，回答带出处（如"来源：理财档案.md"）= 机制生效
- 回答变快、不再"让我翻一下所有记录" = 已在省 token
- 每次回答末尾有合规自检标记（读了哪些记忆域 + 省了多少 token）= 纪律可肉眼核验
- 机械验证安装完整性：跑
node engine/selfcheck.js，10 项校验全过（文件齐 / 元信息合法 / 版本一致 / 引用不断链 / 描述合规 / 章节完整 / 索引表未超红线 / 容错协议六维 / 响应示例覆盖 / 触发词清单与文档一致）= 包本身没问题
> 自检标记让"有没有真的按需读"变成一眼可看：没写具体来源 = 疑似通篇读，直接指正即可。
稳定性与可观测性设计（为什么可靠，不只靠自觉）
纯对话技能没有引擎强制，但用四道机制把"会不会跑偏"变成可预期、可核验：
- 收敛协议（最多 1 次补问）：主题域识别不出时，最多补 1 个问题就走定向搜索兜底，绝不扩散成通篇扫描。
- 确定性兜底输出：每次回答固定带「读了什么记忆域 + 省了多少 token」的合规自检标记——没写具体来源 = 疑似通篇读，一眼可指正。
- 降级链（命中即停）：触发词未命中 → 语义优先匹配 → 定向搜索兜底 → 标准话术交代；任何一步生效即停，不扩散。
- 安全边界不省 token：涉及钱、外发、删除等高危场景不省上下文，宁可多读也不漏关键信息。
- 一致稳定优先：同一主题域、同一问题，重复问结论应一致；触发失败有标准话术（索引缺失/判定失败/被指正时说什么，见随包
engine/REFERENCE.md）。
技术层兜底（可运行，不靠自觉）
上面的机制是"行为约定"，下面这条是可执行的技术保障——即使 AI 完全不遵守规则，安装态本身的完整性依旧能被机械验证：
node engine/selfcheck.js # 人类可读报告；退出码 0=通过 / 1=有问题
node engine/selfcheck.js --quiet # 纯 JSON，可进 CI
自检 11 项（错误码 TWD-D-E001~E011）：必需文件齐全 / frontmatter 合法 / 版本号跨文件一致 / 文档引用不断链 / description 长度合规 / 关键章节存在 / 记忆索引表可解析且未超 50 行红线 / 容错协议六维齐全 / 响应示例场景充足且带量化 / 触发词清单完备且与文档一致 / 核心文档渐进式导读在位（章节导航 + 阅读成本 + 章节不漏 + 三份文档都有「下一步去哪」）。每项失败都给出明确错误码 + 具体修复动作，不静默通过——把「稳定性写在文档里」升级为「稳定性被机械校验」。
容错协议（形式化：超时 / 重试 / 幂等 / 熔断）
把"重试与恢复"从隐含习惯变成显式规则，任何一步都不靠临场判断：
| 维度 | 规则（写死，不自由发挥） |
|---|---|
| 超时（收敛） | 单次回忆任务最多检索 3 轮；第 3 轮仍未命中 → 停止检索，输出已有结论 + 明示"这条我记得不全，你补一句我再补记" |
| 重试 | 主题域判定失败仅补问 1 次；补问后仍失败 → 直接走定向搜索兜底，不再追问 |
| 幂等 | 同一主题域 + 同一问题 → 输出结构一致（结论 / 读了哪个域 / 省了多少），结论不因重跑而漂移；写入记忆遵循"只留最新最全"，重复写入不产生副本 |
| 熔断 | 检测到通篇读（无来源标注 / 读了域外文件）→ 立即停止本轮，输出固定提示；反复违反升级为常驻纪律 |
| 降级顺序 | 触发词未命中 → 语义优先匹配 → 定向搜索兜底 → 标准话术交代；命中即停，不扩散为全面扫描 |
| 不可省 token 场景 | 涉及钱 / 外发 / 删除等高危场景禁止走省 token 路径（安全 > 省钱） |
边界与承诺（诚实原则）
- 纯对话型流程技能：无引擎、无终端、无依赖，不联网、不采集数据，安全可审计
- 省的是实打实的 token 量；省钱金额取决于模型单价（便宜模型单次省几分钱，贵模型成倍放大）
- 它改变 AI 的"读取习惯"，不改变 AI 的"能力"
- 触发词没命中 / 记忆索引异常时，AI 走预置降级预案（定向搜索兜底，绝不扩散成全面扫描）；AI 出错时有标准话术（索引缺失/判定失败/被指正时说什么，见随包
engine/REFERENCE.md）；高频问题与异常处理详见随包references/faq.md
完整实现（唯一事实源）
> 本包完整实现分 3 个文件，按需深入：核心机制 engine/README.md → 工作流 engine/WORKFLOW.md → 验证/触发词/异常处理/极长记忆分节 engine/REFERENCE.md——安装后即可查看。
> 记忆索引表可直接抄 engine/context-index.example.yaml；安装完整性自检跑 engine/selfcheck.js。
