腾讯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兜底；报告可能不完整属正常现象，如实告知用户即可。
