前言¶
WorkBuddy 的积分和 Token 消耗没有现成的后台页面,想知道”这个月花了多少”“哪次对话最贵”,只能自己翻日志或凭感觉。本机会话记录其实就躺在 ~/.workbuddy/projects/*/*.jsonl 里,只是没人把它读出来。
下面介绍的这个 Skill,做的事情就是把这些 jsonl 记录解析成一张用量看板,并额外提供一个 macOS 桌面悬浮球。数据不离开本机,不需要 API Key,也不需要联网。
这是什么¶
WorkBuddy用量看板与悬浮球,由社区发布者 user_4a403661 出品,坐标 @user_4a403661/workbuddy-usage-dashboard,当前版本 1.0.2,来源为 community,分类 it-ops-security,在 SkillHub 上的评分为 100000,下载量 1201。
一句话定位:本机 WorkBuddy 的积分 / Token 消耗看板 + macOS 桌面悬浮球。
解决三个具体问题:
- WorkBuddy 用了多少积分、多少 Token,没有汇总入口;
- 哪次对话最贵、哪个模型、哪个项目用得最多,无从对比;
- 想要”装个用量看板 / 用量统计 / 消耗统计 / 悬浮球 / 积分监控”,不想自己写脚本。
触发场景就是用户提出上述任一需求时使用该 Skill。
核心功能¶
先看官方简介里已核实的能力:
- 解析本地会话记录:直接读取
~/.workbuddy/projects/*/*.jsonl,不依赖 API Key、不联网,数据不出本机。元数据标注requires_api_key=false。 - 积分 / Token 消耗看板:看 WorkBuddy 用了多少积分、Token 消耗情况。
- 按次对比:找出哪次对话最贵。
- 分布统计:模型用量分布、项目用量分布。
- 看板零第三方依赖:纯标准库实现,不需要 pip / npm 安装任何东西,降低环境问题。
- macOS 桌面悬浮球:macOS 原生圆形浮窗,实时显示活跃对话数与今日消耗。
安装与启用¶
官方页面地址:
https://api.skillhub.cn/user_4a403661/workbuddy-usage-dashboard
SkillHub 展示页:
https://www.skillhub.cn/skills/user_4a403661/workbuddy-usage-dashboard
通过对应客户端(SkillHub / Cursor / Codex CLI / Claude Code 等支持通用 SKILL.md 格式的 Agent 客户端)安装该 Skill 后即可触发。需要说明的是,已抓取的官方资料中没有给出具体的安装命令或客户端差异说明,本文不臆测 Cursor、Codex CLI、Claude Code 各自的区别,安装方式以官方页面为准。
安装前确认两点:
- 本机存在 WorkBuddy 会话记录目录
~/.workbuddy/projects/,且其中有*.jsonl文件,否则看板没有数据源; - 悬浮球功能仅适用于 macOS,需要系统允许桌面浮窗。
典型用法¶
该 Skill 的使用方式是直接向 Agent 提出需求,例如:
查看我这个月 WorkBuddy 用了多少积分和 Token
哪次对话最贵?
按模型和项目统计一下用量分布
装个悬浮球,实时显示今日消耗
Agent 会调用该 Skill 解析本地 jsonl 记录并给出结果。看板部分零第三方依赖、纯标准库,不需要额外配置环境;悬浮球是 macOS 原生圆形浮窗,显示活跃对话数与今日消耗。
由于官方资料中未给出更细的逐字段输出示例,具体的字段名和展示形式以实际运行为准,本文不编造样例数据。
适用场景与注意¶
适合:
- 想掌握 WorkBuddy 积分 / Token 消耗、但没有后台可查的个人开发者;
- 关注”哪次对话最贵”、想按模型或项目做用量复盘的人;
- macOS 用户,想用一个桌面悬浮球持续看今日消耗。
限制:
- 数据源依赖本地记录:Skill 解析的是
~/.workbuddy/projects/*/*.jsonl,该目录为空或不存在时,看板与悬浮球无数据可显示; - 仅 macOS 有悬浮球:看板功能跨平台可用,悬浮球是 macOS 原生浮窗,其他系统上该能力不可用;
- 版本与评分信息:当前版本 1.0.2,评分 100000、下载 1201(以已抓取的 SkillHub 资料为准);
- 不联网、不出本机是特性也是前提:如果需要跨机器汇总用量,这个 Skill 不适用。
结尾¶
这个 Skill 的价值在于把散落在 ~/.workbuddy/projects/*/*.jsonl 里的会话记录变成了可查的用量视图:积分、Token、最贵对话、模型与项目分布,一个本地看板解决;macOS 用户再附赠一个实时显示今日消耗的桌面悬浮球。零第三方依赖、无 API Key、不联网,数据不出本机。
官方地址:https://api.skillhub.cn/user_4a403661/workbuddy-usage-dashboard