腾讯Buddy账本（session-usage）—— Agent 执行指令

本技能是给 AI 的执行说明书。它离线读取 WorkBuddy 本机账本，生成「每个任务」的 Token / Credit 消耗明细表。

触发条件

当用户表达以下意图时调用本技能（description 已含触发词，此处强化判断）：

• 想查看 / 生成 / 导出每个任务分别消耗了多少 token、多少 credit；
• 想按**创建时间倒序（新→旧）**查看任务消耗；
• 想看某个任务使用了哪些模型（包括一个任务用多个模型的情况，要求全部列出）；
• 想解释「为什么有的任务有 token 没 credit」（多为 hy3 免费模型，表格已标注）。

执行步骤

在技能目录下运行抽取器（仅依赖 Python 标准库，无需 pip 安装任何包）：

python3 scripts/session_usage.py --out <输出目录>

• --out <dir>：输出目录，默认当前工作目录；建议传当前 workspace 路径，便于 present_files 打开。
• --home <dir>：数据根，默认 ~/.workbuddy（仅迁移/测试用，会改变实际读取路径）。

执行后在该目录生成 2 个文件：

• session-usage.html —— 自包含单文件（无外链、零外网），双击/预览即可看；按创建时间倒序，列出每个任务的「任务标题 / 使用的模型(全部) / 创建时间 / Token(used) / Credit / 状态」，零 Credit 行标红并标注「免费模型」。
• session-usage.csv —— 可下载表格，UTF-8-BOM 编码（Excel 直接打开不乱码）。

交付方式

生成完成后，用 present_files 打开 session-usage.html 预览交回给用户，并附 session-usage.csv 供下载。无需解释全部字段，交给用户自行浏览即可。

字段与口径

• Token（used）：来自 session_usage.used，是 WorkBuddy 官方每任务「真实算力消耗」权威字段，永远记录、与模型无关。
• Credit（credit_json）：来自 session_usage.credit_json，是按模型拆分的计费扣减；免费模型（如 hy3）费率为 0，故 Credit=0 但 Token 照常。表中 模型(全部) 列对 hy3 标注「(免费)」以解释这一现象。
• 使用的模型（全部）：来源为 traces/*/trace_*.json 的 modelInfo.models（数组），按 sessionId 聚合去重，一个任务调用多个模型时全部列出（逗号分隔）；无 trace 记录的任务退回 sessions.model 单值兜底。
• 排序：按 sessions.created_at（epoch 毫秒）倒序，新任务在前；无时间戳排末尾。

约束

• 只读不写：仅以只读模式（mode=ro）读 ~/.workbuddy 下的 workbuddy.db 与 traces/；不修改 WorkBuddy 自身数据、零外部请求、不上传任何数据、不读取任何 API key/密码。
• 数据完整性：trace 解析失败的会话会退回 sessions.model 兜底；报告可能不完整属正常现象，如实告知用户即可。