前言¶

用 DeepSeek Harness（DSH）跑智能體時，消耗往往分散在多輪對話和工具調用裏。平臺側給的是賬戶餘額（錢），會話裏又有 provider 返回的 usage；若只靠賬單或憑感覺，很難回答「今天燒了多少 token」「哪幾個任務最費」「按當前餘額還能撐多少」。社區插件 dsh-plugin-token-audit（維護者 vEvergarden，分類 admin-security）面向上述問題：在本機只讀讀取會話日誌與 DSH 內置賬號服務，用一張可拖動的懸浮卡片彙總日 / 月 / 年分佈、當日 Top5 任務和餘額換算，不寫文件、不碰憑據。

這是什麼¶

dsh-plugin-token-audit 是 DeepSeek Harness 的 Token 用量審計插件（倉庫 vEvergarden/dsh-plugin-token-audit，當前 package 版本 0.2.0，MIT 許可證）。它在 DSH 桌面 Web 端注入 SAO 風格 UI：收起時約 26px 高的膠囊，展開後面板展示統計與交互。數據不依賴額外 API Key，也不讀取 .credentials.yaml。

核心功能¶

下面介紹插件在 README 中明確列出的能力。

用量與時間維度

• 日、月、年三段分佈，柱狀圖帶 tooltip。
• 每次調用的 token 來自本地會話日誌 ~/.dsh/sessions/**/session.v4.jsonl.zstd 裏 assistant/message.data.usage。
• 任務按一輪對話劃分：由 turn/start 到 turn/end 圈定；任務名爲該輪第一條 user/message 正文；時長爲 turn/end.time - turn/start.time。
• 當日消耗 Top5 任務展示 token、時長、調用次數、工具調用數。

餘額與估算

• 餘額通過 DSH 賬號服務 deepseekAccount.getBalance() 獲取；充值與贈金分開展示後合併爲可用總額。
• 「剩餘 token」爲估算：DSH 沒有 token 額度概念，插件用「餘額 ÷ 單價 × 1,000,000」換算，默認單價 2（¥ / 百萬 token），數字帶 ~ 表示估算；可在面板點擊 BAL ¥x @2 改單價，或點擊 LEFT xx 手動指定預算（手動預算優先級更高，顯示爲 *）。實際計費分緩存未命中輸入、緩存命中輸入、輸出三檔，單一單價僅爲近似。

界面與行爲

• 可拖動，位置與頁籤記憶在 localStorage。
• 只讀：不寫任何文件，不碰憑據。
• 主機端提供本地只讀 HTTP 服務（默認端口可在 bundle 配置中指定）。

安裝與啓用¶

前提：DeepSeek Harness 桌面端 0.2.x，Node.js ≥ 22。

一鍵安裝¶

Windows 在插件倉庫根目錄執行：

powershell -ExecutionPolicy Bypass -File .\install.ps1

macOS / Linux：

bash install.sh

裝完後需完全退出 DSH（含托盤圖標）再重新打開。卸載（Windows 示例）：

powershell -ExecutionPolicy Bypass -File .\install.ps1 -Uninstall

手動安裝¶

1. 在 ~/.dsh/profiles/desktop/package.json 的 dependencies 裏增加本地包引用（路徑改爲本機絕對路徑）：

"dsh-plugin-token-audit": "file:/絕對路徑/to/dsh-plugin-token-audit"

2. 在同一文件的 dsh.profile.bundles 數組裏追加 "dsh-plugin-token-audit"。

3. 在 ~/.dsh/profiles/desktop 下執行 pnpm install。

插件通過 bundle 自帶 cordis.patch.yml 注入 Cordis，而不是手寫改 profile 裏的 cordis.patch.yml——DSH 在用戶改設置時會重寫該文件，手寫條目會被抹掉。

配置項¶

bundle 內 patch 示例字段如下（改完後重啓 DSH）：

- insert:
    - id: token-audit
      name: 'dsh-plugin-token-audit'
      config:
        port: 48921         # 本地只讀 HTTP 端口
        budget: 20000000    # 默認日預算（token），0 表示不顯示

典型用法¶

展開面板後，常用操作如下。

主機端啓動時會在 %TEMP%/dsh-token-audit-boot.log 寫一行信標，便於排查本地 HTTP 是否起來。

適用場景與注意¶

適合誰：長期在 DSH 桌面端開發、調試智能體，需要本機視角的 token 分佈、重任務排行和餘額對照，又希望 UI 常駐而不改項目文件的用戶。

權限與安全：插件隨當前 DSH 進程權限運行，只讀本機會話目錄與內置餘額接口；安裝前建議瀏覽 GitHub 源碼 與 MIT 許可證，確認行爲符合你的安全策略。

已知限制（來自上游 README）：

1. 只統計本機當前用戶的會話，不含網頁版與其他設備。
2. 不是官方賬單：token 取自 provider usage，計費口徑仍以平臺爲準。
3. 餘額查詢依賴 DSH 內部服務，大版本升級後可能需要插件適配。
4. Windows 上 install.ps1 爲一等公民；install.sh 爲等價移植，上游註明未在 macOS 上實測。

社區目錄 SkillHub 插件頁 與 GitHub 倉庫相互獨立引用；SkillHub 是社區插件索引，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

dsh-plugin-token-audit 把 DSH 本地會話 usage 與賬戶餘額接到同一塊只讀懸浮卡片上，用日 / 月 / 年視圖和 Top5 任務幫助你在開發過程中把握消耗節奏；安裝走倉庫自帶腳本或 profile bundle，配置通過 bundle 的 cordis.patch.yml 完成。進一步瞭解可訪問目錄頁 skillhub.cn/plugins/vEvergarden/dsh-plugin-token-audit 與倉庫 github.com/vEvergarden/dsh-plugin-token-audit。