WorkBuddy Usage Dashboard & Floating Orb: Local Parsing of Session Records for Credit and Token Usage Insights

前言

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 桌面悬浮球。

解决三个具体问题:

  1. WorkBuddy 用了多少积分、多少 Token,没有汇总入口;
  2. 哪次对话最贵、哪个模型、哪个项目用得最多,无从对比;
  3. 想要”装个用量看板 / 用量统计 / 消耗统计 / 悬浮球 / 积分监控”,不想自己写脚本。

触发场景就是用户提出上述任一需求时使用该 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 各自的区别,安装方式以官方页面为准。

安装前确认两点:

  1. 本机存在 WorkBuddy 会话记录目录 ~/.workbuddy/projects/,且其中有 *.jsonl 文件,否则看板没有数据源;
  2. 悬浮球功能仅适用于 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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye