Token 统计技能安装说明 (token-stats v1.0.7)

一、安装(3 步)

解压本压缩包,得到 token-stats/ 文件夹
把整个 token-stats/ 文件夹复制到 WorkBuddy 的 skills 目录:
- Windows: C:\Users\<你的用户名>\.workbuddy\skills\
- macOS / Linux: ~/.workbuddy/skills/
重启 WorkBuddy(或新开一个对话),技能即生效

二、使用

首次使用:请先手动触发一次——在对话中输入「统计token」,确认技能正常出图标后再依赖自动展示。首次触发时会自动在你的平台上建立「每周一刷新价格表」自动化任务(见第五节),无需手动配置
自动:每次对话收尾,按当前展示偏好自动展示 token 用量图标(默认「本轮 + 历史汇总」两个;可改为仅单轮或完全关闭,见第六节)
手动:对话中说「统计token」「本次对话用了多少token」即可触发
切换展示形态:对话中说「关闭 token 统计」/「只显示单轮」/「恢复完整统计」,即可持久化切换收尾展示形态(见第六节),无需每轮重复指定

三、环境要求

WorkBuddy(Windows / macOS / Linux 均可)
Python 3.10+(纯标准库,零依赖;或直接使用 WorkBuddy 自带的托管 Python)

四、注意事项

统计功能本身不联网、不上传:数据来自本地存盘,纯本地读取 token 用量
价格估算功能会按需联网:① 首次使用自动创建「每周一刷新价格表」任务; ② 发现未收录的新模型时立即联网补价;③ 每周一自动化任务联网核对官方价(见第五节)。均不涉及你的对话内容。如不需要,可在对话中说"关闭 token 统计的价格刷新",关闭后完全本地运行
官方价估算仅供参考,与实际扣费可能不同(受套餐/折扣/峰谷时段影响)

五、价格表每周一自动刷新（首次自动创建，后续仅提醒）

价格表需要联网核对厂商官方价才能保持准确:

首次使用自动创建:你首次触发本技能统计 token 时,Agent 会自动在你的平台上建立「每周一刷新大模型官方价格表」任务(每周一 00:00 联网核对各厂商官方定价页并回写 prices.json 的 input / output / cache_hit / updated / source),并写入初始化标志。
后续仅检测、不强制重建:首次之后,每次触发统计 token 时,Agent 只检查该任务是否存在; 存在则跳过;若不存在(如你在界面里误删),仅提醒你、不再自动重建,由你决定是否恢复。
自动化任务存于本地 ~/.workbuddy/workbuddy.db,不随压缩包分发;换机 / 重装技能后首次触发仍会自动建立(符合预期)。

如需手动创建或恢复(或想确认),可在对话中说:

"创建一个自动化任务,名称「每周一刷新大模型官方价格表」,每周一 00:00 运行: 读取 token-stats 技能目录的 prices.json,联网核对各模型官方定价页, 更新 input / output / cache_hit / updated / source 字段。"

即使没有该任务也不影响日常使用:新模型出现时,统计过程会自动识别并立即联网补价。

六、展示偏好开关（手动关闭 / 仅单轮）

收尾展示形态由持久化偏好控制,无需每轮口头指定。

偏好存于技能目录内 .workbuddy/stats_pref.json(运行时生成、不随压缩包分发),取值三档:

| 取值 | 含义 | 收尾展示 | |------|------|----------| | full | 完整(默认) | 本轮图标 + 历史汇总图标 | | single | 仅单轮 | 只展示本轮 token 图标,不显示历史总量 | | off | 完全关闭 | 收尾不展示任何 token 统计 |

切换方式(在对话中直接说即可,无需手动编辑文件):

「关闭 token 统计」/「别再显示 token 了」→ 完全关闭
「只显示单轮 token」/「只统计本轮」→ 仅单轮
「恢复完整 token 统计」/「恢复 token 统计」→ 回到完整(默认)

偏好文件跟随技能目录;换机 / 重装技能后会被重置为 full(相当于回到默认)。该开关只影响"收尾自动展示",不影响价格表刷新自动化(第五节,那是独立机制)。

七、本次统计自身开销提醒

运行本技能统计 token 时,agent 思考、跑脚本、读/传 widget HTML 也会消耗真实 token。这些 token 已计入你看到的统计数字中,并按当前对话使用的大模型单价计价。

为让你直观看到这部分开销,生成的图标底部会自动附一行提醒:

本次统计自身约消耗 X token(读入≈…/传出≈…),按 <当前模型> 单价 ≈ ¥Y

<当前模型> 在价格表中有记录时,会按该模型 input/output 单价折算人民币;
不在价格表时,仅显示 token 数、不折算人民币(不报错)。

Agent 调用脚本时需带上 --current-model <当前模型名>(如 hy3/mimo-v2.5), 提醒即由脚本自动生成在图标底部,无需手动编写。注意:读入+传出 widget HTML 是这部分开销的绝对大头,对话轮次越多、历史汇总图标越大,开销越高。

八、免责声明

本技能为个人开发、免费分享的第三方工具,与 WorkBuddy 官方无关,也不受任何模型厂商官方支持。
统计数据仅供参考:输入/输出/缓存等 token 来自 WorkBuddy 本地记录,若平台记录不完整(如子任务/工具调用未落盘),统计结果可能与模型官方平台不一致;官方价与积分为估算值,不代表实际扣费。
不承诺准确性与适用性:技能按"现状"提供,开发者不对统计误差、漏统计或使用本技能造成的任何直接/间接损失负责。
隐私说明:统计本身只在本地处理、不上传;联网仅用于价格表更新(首次创建、新模型补价、每周一核对),不涉及你的对话内容。
使用本技能即视为同意以上条款;如有疑虑,请勿安装使用。