前言¶
在使用 DeepSeek Harness (DSH) Web GUI 進行開發時，開發者需要直觀地瞭解當前工具的運行狀態以及 Token 消耗情況。現有界面通常缺乏這種實時的、可視化的反饋。dsh-work-buddy 插件通過一個像素風格的機器人提供這種反饋，並記錄會話產出。
是什麼¶
由 AMC-tp 維護的插件。它將一個原創的方頭履帶機器人添加到 Web GUI 右下角。機器人不僅模擬工作狀態（思考、打字），還作爲賬本記錄完成回合數、Token 使用量以及估算費用。
狀態機¶
機器人共有五個狀態，通過觀察機器人的行爲和圖標變化即可判斷當前 DSH 的運行情況：
- 摸魚中：沒有運行中的工具，也沒有流式輸出。機器人眼睛眯成縫，腳邊有一條魚，頭頂飄出 z。
- 思考中：右上角冒出思考氣泡，舉起右臂。觸發條件爲 DOM 中存在
[data-streaming]。 - 寫代碼：面前有一臺筆記本，雙手搭在鍵盤上，屏幕光標閃動。觸發條件爲 DOM 中存在
[data-tool][data-state="running"]。 - 等你選擇：睜大眼睛，左上角粉色問號氣泡（閃爍）。觸發條件爲
ctx.uiSession.pendingInteractions非空。 - 完成！撒花：從忙碌回到空閒（連續 3 次採樣且忙碌時間超過 0.9 秒）。機器人雙臂高舉，四周落彩紙。
賬本與計費¶
點擊機器人可展開賬本面板。賬本支持按今日、本週、本月、年度查看數據。
- 數據展示：第一行顯示完成數、Token（以百萬爲單位）和估算費用。
- 數據來源：完成數由狀態機防抖計數；Token 來自
binding.session.projections.faceOf('tokenUsage')的增量記錄；費用基於 DeepSeek 官方價目表（含高峯/非高峯）。 - 定價模型：支持
deepseek-v4-flash和deepseek-v4-pro兩個模型，不同模型在高峯和非高峯時段有不同費率。 - 存儲位置：數據存儲在瀏覽器的
localStorage中，路徑爲dsh-work-buddy/ledger/v2。
安裝與啓用¶
通過命令行安裝：
dsh plugin --profile web add github:AMC-tp/dsh-work-buddy
或使用本地路徑：
dsh plugin --profile web add link:D:\path\to\dsh-work-buddy
安裝後需重啓 dsh web。
使用方法¶
- 查看狀態：鼠標懸停在機器人上，顯示當前狀態文字。
- 查看賬本：點擊機器人，展開面板查看詳細數據。
- 切換視圖：在面板中選擇 Today / Week / Month / Year。
- 調整模型：在賬本中切換定價模型。
- 重置：點擊面板內的 Reset 清空賬本數據（不清除結算基線）。
注意事項¶
- 插件無構建步驟，無第三方依賴，純瀏覽器端運行。
- 費用爲估算值，並非官方賬單。計價時間取的是增量落賬時刻，而非請求發起時刻。
- 數據存儲在瀏覽器的
localStorage中，路徑爲dsh-work-buddy/ledger/v2。卸載插件不會刪除已存儲的賬本數據。
