前言¶

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