前言¶

使用 DeepSeek Harness（DSH）做 Web GUI 智能體時，用量、上下文和成本往往分散在會話記錄與平臺賬單裏。dsh-board 是一個 DSH 插件，把 DeepSeek 後臺風格的用量統計放進 Web GUI 左下角，用於查看 token 走勢、上下文佔用和估算成本。

這是什麼¶

dsh-board 由 dfkai 維護，許可證爲 MIT。它給 DSH 增加一個側欄用量與成本面板：在 Web GUI 左下角提供計費估算、1M 上下文信息、可視化圖表，以及「詞勳」段位和成就展示。

需要說明的是，面板顯示的是估算值，不是計費憑證，實際扣費以 DeepSeek 平臺賬單爲準。

核心功能¶

計費估算¶

• 使用官方價目。
• 2026-08-17 起按北京時間峯谷自動切價：高峯爲 09:00–12:00、14:00–18:00，閒時按高峯價格的一半計。
• 推理 token 按輸出價計入。

1M 上下文¶

• 顯示上下文佔用百分比。
• 顯示剩餘預算。
• 用堆疊條展示系統、工具、消息的構成。
• 展示子代理耗時。

可視化¶

• 每輪輸入/輸出走勢。
• 累計輸出曲線。
• 12 週日熱力圖。
• 分模型統計。
• 全局會話榜。

「詞勳」段位¶

十級階梯，從「未醒詞芽」到「萬詞王」再到「萬億詞神」。展示方式類似會員卡，包括進度條、解鎖 ETA、每級權益。

成就¶

• 連續打卡天數。
• 9 枚數據驅動徽章。

視覺與徽章¶

• Geist 剋制風。
• 明暗主題適配。
• 中英雙語。
• 零裝飾動畫。
• 橫版徽章默認收起爲菜單寬瓷磚，顯示段位標籤、¥ 花費、總 token、今日本週；點擊後徽章升到面板頂部展開，再點一次收起。

安裝與啓用¶

安裝命令如下：

dsh plugin --profile <profile> add dsh-board@0.2.0

安裝後重啓該 profile，或者新起一個 DSH 進程：

dsh --profile <profile>

可以通過 dump-config 檢查插件層是否出現：

dsh --profile <profile> --dump-config

輸出中應出現：

# == dsh-board 層

關閉與條件開關¶

如果只想臨時關閉面板，可以在當前 profile 的 cordis.patch.yml 中追加：

- id: board
  disabled: true

disabled 支持 !!js 表達式，也可以按條件開關。

開發同步¶

如果你在本地修改插件代碼，可以按下面步驟構建並同步：

pnpm install
pnpm build
pnpm sync -- <profile 目錄>

先安裝依賴，再構建產物，最後同步到指定 profile 目錄。

適用場景與注意¶

適合在使用 DSH Web GUI 的開發者查看本機會話用量、上下文佔用和估算成本。它不是賬單系統，也不是計費憑證。

使用前注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 推理 token 按輸出價計入用量，需要 harness 的 token-meter 修復；舊 harness 上累計總量與成本會少算推理部分。
• 全部數據來自本機 DSH 的公開接口；插件不發起任何第三方網絡請求。
• 唯一持久化是瀏覽器 localStorage 裏的面板摺疊狀態。
• 宿主半僅註冊只讀會話投影（dominantModel、sessionCost），不寫入任何數據。
• 許可證爲 MIT。

結尾¶

dsh-board 的價值比較明確：把 DSH 會話中的 token、上下文和成本估算放進一個側欄面板裏，方便在 Web GUI 中快速查看。倉庫地址：

https://github.com/dfkai/dsh-board