前言¶

DSH 的理念是「一切皆插件」。在 DeepSeek Harness Web profile 中，用量信息分散在 provider dispatch、重試、緩存 token 和 session 歷史裏；如果希望重啓後仍能查看，並按提供方、模型和時間範圍篩選，下面介紹一個社區倉庫：xie-tj/dsh-token-usage-ledger。

社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文不把它描述爲官方應用商店。

這是什麼¶

xie-tj/dsh-token-usage-ledger 爲 DeepSeek Harness Web profile 提供持久化用量賬本和可視化 Usage 儀表盤。倉庫 owner 爲 xie-tj；資料未單獨標註“維護者”字段，因此本文只按倉庫名和安裝命令描述。

許可證爲 MIT。

它解決的事情包括：

• 記錄每次 provider dispatch，包括失敗與重試，並保存輸入、輸出和緩存 token。
• 使用 session 歷史回填數據。
• 在 Settings → Usage 中按提供方、模型和時間範圍查看用量。
• 提供獨立持久化賬本：重啓後保留歷史，並對已有 session 執行 best-effort 回填。

核心功能¶

下面列出已覈實能力。

記錄與回填¶

• 記錄每次 provider dispatch，包括失敗與重試。
• 保存輸入、輸出和緩存 token。
• 使用 session 歷史回填數據。
• 獨立持久化賬本：重啓後保留歷史，並對已有 session 執行 best-effort 回填。

展示與篩選¶

• 在 Settings → Usage 中查看用量。
• 支持提供方、模型和最近 7 天／30 天篩選。
• 曲線、柱狀圖和 API 請求次數保留精確值。
• 模型明細使用 K/M/B/T 緊湊單位。
• Token 流量圖表的懸停提示顯示當日輸入、輸出、緩存和總計。
• 單獨展示緩存命中 token，並保留失敗、未計量和重試請求。

數據與接口¶

• 打開版本爲 2 的 usage_ledger storage domain。
• 提供 Remote 方法 usageLedgerPlugin/snapshot，返回 events、models 和 daily。

安裝與啓用¶

先安裝到 Web profile，再啓動 Web profile。已覈實資料給出的命令如下：

dsh plugin --profile web add github:xie-tj/dsh-token-usage-ledger
dsh --profile web

安裝後打開 Settings → Usage 查看用量。

生產環境應將 Git spec 固定到 commit SHA。例如：

dsh plugin --profile web add github:xie-tj/dsh-token-usage-ledger#<commit-sha>

當前版本按 @deepseek-ai/dsh 0.1.0-rc.8 依賴線構建，要求 Node.js ^22.19.0 || >=24.0.0。

典型用法¶

查看用量¶

1、安裝到 Web profile：

dsh plugin --profile web add github:xie-tj/dsh-token-usage-ledger

2、啓動 Web profile：

dsh --profile web

3、打開 Settings → Usage。

4、使用提供方、模型和最近 7 天／30 天篩選。

卸載¶

dsh plugin --profile web remove dsh-plugin-usage-ledger

卸載不會刪除 usage_ledger storage domain 中的已有數據。

從源碼構建¶

pnpm install
pnpm run build

提交前驗證：

pnpm run typecheck
pnpm run build
pnpm run test
pnpm run pack:check

運行依賴與限制¶

Host 依賴¶

Host 插件硬依賴以下服務：

• storageDomain：打開版本爲 2 的 usage_ledger storage domain。
• sessions。
• sessionPersistence。

可選依賴：

• settings。

cordis.patch.yml 不會安裝 storage-domain backend、session persistence provider，也不會爲自定義 profile 增加服務路由。持久化能力取決於 profile 爲 storageDomain 配置的 backend。

數據邊界¶

• 賬本爲 best-effort 派生數據，不是請求事務的一部分。
• 插件不估算 token，不計算費用、折扣、緩存價格或配額影響。
• 頁面合併展示 cache read/write，未分別繪圖；也不顯示價格或金額。
• 持久化保留、清理、導出和遷移工具未實現。
• 迴歸測試不替代真實 Web profile 啓動測試。

當前限制¶

• Web 尚無 workspace 選擇器。
• Legacy session 可能顯示 unknown route。
• 插件設置卡當前只讀，沒有運行時配置項。

適用場景與注意¶

適合在 DSH Web profile 中查看持久化用量、緩存 token、失敗與重試請求，並按提供方和模型篩選的人。

注意以下幾點：

• 插件會作爲 DSH 插件代碼加載進 Web profile，運行權限等同於當前 dsh 進程；安裝前應檢查源碼與許可證。
• 許可證爲 MIT。
• 生產環境應將 Git spec 固定到 commit SHA。
• 卸載不會刪除 usage_ledger storage domain 中的已有數據。
• 插件不計算費用、折扣、緩存價格或配額影響。

結尾¶

這個倉庫的價值，是把用量數據落到獨立 usage_ledger storage domain，並在 Settings → Usage 中提供按提供方、模型和時間範圍查看的可視化界面。

目錄頁鏈接未在已覈實資料中出現，本文不列具體地址。

GitHub：https://github.com/xie-tj/dsh-token-usage-ledger