前言¶
用 DeepSeek Harness（DSH）做多會話、多工作區開發時，錢包餘額和單次對話花了多少，往往要切到別處查看；工作區維度更是缺少彙總。Spendwatch 是 awychoi 維護的客戶端插件，在同一界面展示 DeepSeek 餘額、當前會話花費，以及每個工作區累計花費（含已歸檔會話），讀取與 DSH 相同的 DeepSeek 賬戶，無需額外登錄或單獨配置頁。
這是什麼¶
Spendwatch（dsh-spendwatch）面向 DSH 0.2.x，分類爲客戶端插件：通過 cordis.patch.yml 注入側邊欄與會話輸入區 UI，在瀏覽器端展示花費信息；餘額數據由 Host 側已登錄賬戶或 DEEPSEEK_API_KEY 讀取，密鑰與賬戶 token 留在 Host，不進入瀏覽器。
維護者：awychoi。許可證：MIT。當前 package 版本：1.6.0。與 DeepSeek 無隸屬關係。
核心功能¶
餘額（左側邊欄）¶
展示 DeepSeek 錢包最近一次返回的真實餘額；附帶峯谷時段標記，以及距離下一次計價切換的倒計時。峯谷規則與 Host 使用同一價目表，每 10 秒重算，包含北京工作日規則與中國法定節假日（資料註明節假日覆蓋至 2026，2027 日期需官方公佈後自行補充）。
刷新時機：當前對話產生新的花費時、回到窗口時、或點擊餘額時；空閒時不輪詢。
工作區合計（工作區列表行）¶
每個工作區行顯示該工作區全部會話的累計花費，包含已歸檔會話，不是僅統計當前打開的對話。實現上把工作區合計掛在 Host 工作區行的 data-row-key="workspace:<id>" 上；若 Host 佈局變更，該展示可能消失。
會話花費（輸入框下方 pill）¶
消息框下方顯示當前對話的估算花費，含 subagent。Fork 後的對話只對 fork 之後產生的用量計費；Host 摺疊事件時會跳過低於 inheritedEventCount 的事件，避免繼承歷史重複計費。
數據如何更新¶
會話合計跟隨各次 model call 上報的 usage；工作區合計在持久化摺疊值之上疊加活躍會話。搜索相關：web/deepseek-search-llm-request 事件按查詢計數，並用 search.estimatedInputTokens / search.estimatedOutputTokens 按搜索模型費率估算（真實輔助用量未寫入 session log）；Search/Fetch API 按成功請求 $0.75/1K 的計費在本插件使用的 Messages search + 本地 HTTP fetch 路徑下未建模。
準確度說明¶
- 餘額：DeepSeek 接口返回的真實錢包值。
- 花費：估算值，爲 tokens × 公開價目（含峯谷、cache hit/miss）；未定價模型跳過。不要用 Spendwatch 對賬發票，DeepSeek 賬本可能事後結算。
可在 Host 側維護 pricing.json（啓動時校驗，異常時回退內置副本）調整 token 費率、搜索 token 估計或節假日；修改後需重啓 DSH。
安裝與啓用¶
在 DSH 中按下列步驟安裝（命令與倉庫 URL 以 README 爲準，勿自行拼接 CLI 插件名）：
- 打開 Plugins → Install。
- 選擇 Git repository，填入：
https://github.com/awychoi/dsh-spendwatch
- 按提示 重啓 DSH。
錢包通過已登錄 DeepSeek 賬戶讀取；若使用 API Key，則通過環境變量 DEEPSEEK_API_KEY（由 Host 使用，不暴露給瀏覽器）。
典型用法¶
安裝並重啓後無需單獨設置頁：側邊欄可見餘額與峯谷倒計時；切換或瀏覽工作區列表時可見各行工作區合計；在任意對話中發送消息後，輸入框下方會出現當前會話花費 pill。需要更新價目或節假日時，編輯 Host 可用的 pricing.json 並重啓 DSH。
卸載：在 DSH 插件列表移除 Spendwatch 並重啓；插件不額外持久化本地數據。
適用場景與注意¶
適合：長期在 DSH 裏跑多工作區、多會話，希望一眼看到餘額、當前對話成本及各工作區總花費的開發者。
注意：
- 插件以當前 DSH 進程權限運行；安裝前請閱讀 GitHub 倉庫 源碼與 MIT 許可證，自行評估信任邊界。
- 與 Host 存在耦合（工作區行 DOM、價目表、session 摺疊與搜索事件語義）；升級 DSH 大版本後若 UI 或 Host API 變化，部分展示可能失效，需關注 README 中的 host-coupling 說明。
- 側邊欄與 composer 各帶 crash boundary；缺少
sessionQuery、workspaceRegistry或deepseekAccount時對應塊降級，不會用 API Key 冒充賬戶餘額展示。
社區插件目錄見 SkillHub，與 DeepSeek / 幻方無官方從屬關係。
鏈接¶
- 目錄頁：https://www.skillhub.cn/plugins/awychoi/dsh-spendwatch
- 源碼與說明：https://github.com/awychoi/dsh-spendwatch
Spendwatch 把錢包、當前會話與工作區維度的花費放在 DSH 常用界面裏，減少切頁查賬；花費數字爲價目表估算，餘額以 DeepSeek 返回爲準，適合日常控費參考而非財務對賬。
