前言¶

在 DSH（DeepSeek Harness）上跑 agent 時，DeepSeek 按峯谷時段定價，「今天花了多少、餘額還剩多少」往往要切到別處查。社區裏顯示餘額、推算今日消耗的客戶端插件不少，多數依賴控制台或固定展示邏輯；數字一旦算錯，常見做法是手工清零或重啓。下面介紹的 dsh-peak-chip（維護者 sunsun320）把 本日消耗 與 當前餘額 放在會話頭部一個圓點裏，點開即面板；其設計重點之一是 自修復——插件故障時可由當前會話裏的 agent 按本地維修手冊修，計費側則通過濾波、日界重錨與顯式誤差行，儘量讓錯數自己退回，而不必你反覆清零。

這是什麼¶

dsh-peak-chip 是 DSH 生態下的 客戶端 插件（DSHA / Android WebView mobile 變體爲主，README 寫明 Windows 電腦端未適配）。在會話頭部注入一個 圓點指示燈，點擊後展開面板，核心兩個數：本日消耗、當前餘額；詳單還包括本日首次觀測餘額、今日充值識別、本地 token 審計值、「無法審計」差額，以及誤差三檔告警。

記賬口徑一句話：本地按本機 token 折算的 L，與按餘額變化推算的 S = max(0, V + T) 各算一遍；差額拆成「無法審計」（同賬號其它客戶端消耗，屬正常）與「誤差」（本機多算纔可疑）。充值識別由宿主側做餘額臺階檢測（中位數 3 窗濾波 + 連續窗確認）。完整公式見倉庫內 計費算法說明.md。

插件爲 第三方作品，非 DeepSeek 官方產品；GitHub 倉庫 sunsun320/dsh-peak-chip 當前約 1 star，許可證 MIT（© 2026 deepseekV4.1Flash），package 版本 4.1.8。

核心功能¶

會話內的指示燈與面板¶

1. 圓點：掛在會話頭部，作爲峯谷/消耗狀態的視覺入口。
2. 面板兩數：本日消耗、當前餘額。
3. 詳單：本日首次觀測餘額、當前餘額、今日充值識別、本地審計、「無法審計」、「誤差」及對應告警檔位。

DeepSeek 定價隨峯谷變化；插件把「今日花了多少、還剩多少」放在當前對話上下文中，減少切頁查賬。

自修復：壞了由 agent 讀本地手冊修¶

面板詳單 最底部 有 「一鍵維修」 按鈕。點擊後會在 當前會話輸入框 填入一段「維修契約」（只填、不自動發送）。你需要自行發送，並由 正在使用的 agent 讀取插件目錄內的 維修手冊.md，按手冊完成流程，大致爲：

1. 先問清「發生了什麼」（現象、時間、是否充值/換模型/改設置、期望行爲），不先跑測試或翻代碼；
2. 再診斷：證據、根因、擬改動，經你確認後再改代碼；
3. 改代碼、同步價目表、必要時升 RULE_VERSION；
4. 按手冊 §〇 更新文檔與測試、寫 開發日誌.md、寫 故障記錄/，測試通過後再封包；
5. 修不動則如實收口爲「已知不可修」，而非假裝修好。

Release 包（.tgz）內已含完整源碼（宿主與客戶端）、維修手冊、六套測試及 package.json、cordis.patch.yml，維修不依賴登錄 GitHub 或另行 clone 源碼。若整塊客戶端插件掛掉、按鈕不可用，可把本地 維修手冊.md 路徑直接發給 agent。

誠實邊界：客戶端半邊整體失效時，該按鈕也會消失（同類客戶端插件往往一併受影響）。

數字側的自糾正（不必手工清零）¶

README 強調與「只顯示、錯了靠人清」的同類插件不同，本插件在算法與狀態機層做了多層回退：

• 誤判充值會撤銷：臨時充值參與顯示但不落庫；後續窗口餘額證據不支持則自行消失（文檔舉例：幻影充值行可從數字變回 —）。
• 黃燈滯回：進告警 ≥0.6、出 <0.4，均要求連續 3 窗；水位回落後黃燈自動恢復。
• 日界零攜帶：零點重錨，昨日錯誤不帶入今天。
• 灰態有出口：連續 3 天紅才轉灰（語義爲計費口徑已不成立）；唯一常規出口爲規則版本變更，避免靜默永久鎖死。
• 憑據現取：換 API key 不必重啓插件；缺 DSHA 3090 橋時僅 「充值」按鈕 降級，面板與記賬照常。

精度取捨：只用 API key，不讀控制台¶

作者說明：部分計費插件直接讀官網控制台，口徑更貼近官方明細；本插件 不 走該路徑——實測該賬號下 12 個端點僅 /user/balance 與 /models 返回 200，/user/usage 爲 404，控制台數據不在開放平臺 API 內。讀控制台通常需要 網頁登錄態（Cookie/Token），權限面與可吊銷的 API key 不同。

本插件選擇：官方餘額差分 + 本地 token 審計，僅使用你在 dsh 設置裏配置的 DeepSeek API key（插件不存 key），不碰登錄態。面板上用「無法審計」「誤差」兩行把不確定攤開，而不是給出看似精確卻無法覈對的數字。

安裝與啓用¶

從 GitHub Release 附件安裝（安裝器不執行構建腳本，插件爲零構建、lib/client.js 爲預構建單文件）：

dsha-plugin import dsh-peak-chip-4.1.8.tgz

發佈包直鏈：

https://github.com/sunsun320/dsh-peak-chip/releases/download/v4.1.8/dsh-peak-chip-4.1.8.tgz

裝完後 重啓 dsh web，並在瀏覽器中 刷新頁面。

peer 依賴包括 @deepseek-ai/dsh-credentials、@deepseek-ai/dsh-settings（^0.1.5-rc.2）等；README 驗證環境爲 DSHA 0.1.5-rc2 / dsh 0.1.5-rc.2，arm64，Android 手機 WebView（mobile 變體）。

典型用法¶

1. 在 DSH 中配置好 DeepSeek API key（插件通過 dsh 憑據讀取，不自存）。
2. 按上文命令導入 dsh-peak-chip-4.1.8.tgz 並重啓、刷新 Web 界面。
3. 打開任意會話：看頭部 圓點 顏色/狀態；點擊圓點查看 本日消耗、餘額 及詳單。
4. 若需通過 DSHA 橋發起充值，需本機 127.0.0.1:3090 橋可用；無橋時充值按鈕降級，其餘功能仍可用。
5. 出現顯示異常或插件行爲異常：優先用面板底部 一鍵維修（或手動把 維修手冊.md 交給 agent）；日常只需關注面板上的誤差與「無法審計」行判斷是否正常。

記賬與告警邏輯的細節、閾值參數，以倉庫內 計費算法說明.md、聲明.md、依賴.md 爲準。

接觸面、邊界與適用場景¶

權限與數據（安裝前宜自行覈對源碼）¶

• 讀：$DSH_HOME/.bridge_token（僅用於 DSHA 橋）。
• 連：api.deepseek.com（餘額；憑據來自 dsh 設置）、127.0.0.1:3090（僅「充值」按鈕）。
• 寫：settings 命名空間 dsh-peak-chip（餘額、今日消耗、充值識別、調試窗口、自身路徑等）。
• 無遙測：不向第三方上傳對話或設備標識。

插件以 當前 dsh 進程權限 運行；安裝前應閱讀倉庫源碼與 MIT 許可證，確認接觸面可接受。

明確不做的事¶

• 不代替官方計費；數字均爲本地審計與餘額推算，誤差會顯式展示。
• 不改模型路由、不改定價參數、不自動充值。
• Windows 電腦端未適配（無 3090 橋、休眠/喚醒行爲未覆蓋）。

適合誰¶

• 主要在 DSHA / Android WebView 上用 DSH 對話、希望 會話內 看到今日消耗與餘額的開發者。
• 能接受「API 餘額差分 + 本地 token 審計」精度，並願意看面板上的 無法審計 / 誤差 行的人。
• 希望插件出問題時可由 本地 agent + 維修手冊 就地修、且 Release 包自帶測試與文檔的使用者。

不適合需要 與官網控制台完全一致明細、或必須在 Windows 桌面 dsh 上同等體驗的場景（README 已說明未適配）。

文檔與社區入口¶

DSH 社區插件目錄（如 SkillHub）與 DeepSeek / 幻方無官方從屬關係；選用第三方插件前，建議結合 聲明.md、故障記錄/ 與本地測試（倉庫含 v4-alert、v4-client、v4-drift 等六套測試 + sync）自行判斷是否與你的環境匹配。

經過上面的步驟，你可以在移動端 DSH 會話裏用一個小圓點持續對照 本日消耗與餘額，並在數字或插件異常時，優先依賴其 自修復設計 與顯式誤差口徑，而不是反覆手工清零或盲目信任控制台級精度。