前言¶

在 DeepSeek Harness（DSH）裏跑任務時，賬戶餘額和實際花費往往要切到 設置 → 賬戶 才能看清；按會話、按天花了多少，平臺側也沒有現成的細賬接口。若你希望在側邊欄常駐看到餘額、今日與本月消耗，並自行設定預算、估算「還能用幾天」，同時把近 7 天的消耗按會話彙總在本地留檔，社區插件 dsh-balance-chip-cesare（維護者 Cesare97，分類：客戶端）就是圍繞這一缺口做的：數據主要來自與設置頁相同的 account/getBalance，消耗由余額變動推導，賬本落在瀏覽器 localStorage，除餘額讀取與每週匯率查詢外不上傳本地統計。

這是什麼¶

dsh-balance-chip-cesare 是 DSH 的側欄「餘額與消耗」插件，固定在 設置 入口上方。當前 package 版本爲 0.7.2，許可證 MIT。它展示充值餘額、贈送餘額與各類消耗統計，並提供每日/每月預算、可用天數（runway）、多幣種顯示與 CNY↔USD 換算、近 7 天按會話明細，以及 JSON/CSV 導出與導入。插件在 DSH Web 客戶端注入運行（dsh.client.platform: web，immediately: true），Host 半爲 lib/index.js，瀏覽器 bundle 爲 lib/client.js。

核心功能¶

側欄與面板¶

• 餘額行：充值餘額、贈送餘額、今日消耗；側欄摺疊時顯示貨幣符號，懸停可看具體數字。
• 面板：餘額、贈送、可用天數、今日/本月/本次會話消耗、無歸屬「其他」、近 7 天柱狀圖、會話消耗 Top 5、最近任務 4 條。

預算與超支提示¶

支持按顯示幣種分別設置 每日 與 每月 預算，以進度條和百分比展示；超支時面板與側欄相關數字會變紅。

可用天數（runway）¶

取最近 7 個完整日中 有花費的天數 爲分母：總花費 ÷ 天數 = 日均消耗，再用當前可用餘額 ÷ 日均。README 舉例：5 天共花 ¥4 → 日均 ¥0.80，再據此估算餘額可支撐天數。

幣種與匯率¶

顯示幣種可選：自動 / CNY / USD / 賬戶持有的其他幣種；USD 始終可選，CNY 餘額可按緩存參考匯率換算。CNY→USD 匯率 每週 自動更新，也可在插件設置裏手動刷新；請求公共 Frankfurter/ECB 接口，不消耗模型 token；刷新失敗時保留上次匯率。

近 7 天明細¶

近 7 天可按會話合計，並可查看每天各會話分別花費。自 0.7.0 起爲精確記錄；更早日期會依保留的任務記錄還原並標註「估算」。無法歸屬到任務的消耗歸入「其他」，只計入日總額。

語言與刷新¶

界面語言可跟隨系統，或選中文 / English / Italiano，插件內立即生效。餘額讀取間隔可選 15 / 30 / 60 秒或暫停；此外在啓動、任務結束結算、憑據變化、頁面重新可見、手動刷新時也會讀取。

數據從哪來、有多大誤差¶

餘額來自 Remote 命令 account/getBalance，與 設置 → 賬戶 一致。DSH Host 沒有 按會話計費的查詢接口，因此消耗由總可用餘額（充值 + 贈送）變化推導：

1. 每次成功讀取並與上次比較；下降記爲消耗，優先歸到正在運行的任務，或 20 秒結算窗口內剛結束的任務；上升視爲充值/贈送。
2. 沒有任何任務可歸屬的下降進入「其他」，只計入日總額。
3. 超過 6 小時未讀取時，賬本基線視爲過期，下次讀取只重置基線，不補記未知變動。

這是近似賬本：重疊運行的任務消耗會算給最近開始的那個；任務結束超過 20 秒纔到賬的費用可能無法歸到該會話。使用時宜把數字當作 趨勢與自檢，而非與官方賬單逐分對齊。

存儲與隱私¶

統計賬本鍵前綴 dsh-balance-chip/stats/v1，含 days（約 60 天）、sessions（約 120 個）、sessionDays（0.7.0 起）、runs（約 50 個）、last、unattributed。偏好在 settings/v1，匯率緩存在 fx/v1。除 account/getBalance 與週期性的匯率 GET 外，插件 README 說明不發起其他請求，本地統計數據不上傳。導出、導入、清除統計在面板 設置 中操作。

安裝與啓用¶

在 DSH 項目依賴中安裝（命令以倉庫 README 爲準）：

pnpm add github:Cesare97/dsh-balance-chip-cesare

安裝後將其加入 profile 的 dsh.profile.bundles，或在客戶端 設置 → 插件 中啓用。本地開發時可用 link: 指向源碼目錄，無需把 git clone 當作官方安裝步驟。

插件以當前 DSH 進程的權限運行；安裝前建議瀏覽 GitHub 倉庫 源碼與 MIT 許可證，確認符合你的環境與合規要求。

典型用法¶

1. 安裝並啓用後，在側欄 設置 上方打開餘額行，點開面板查看今日、本月與本會話消耗及 7 天趨勢。
2. 在面板 設置 中配置每日/每月預算與顯示幣種；需要美元參考價時確認匯率已更新（或手動刷新）。
3. 關注「可用天數」與預算進度條，超支時側欄與面板會標紅。
4. 查看近 7 天按會話明細；對標註「估算」的歷史日期的數字保持謹慎。
5. 定期在 設置 中導出 JSON/CSV 備份；換瀏覽器或清站點數據前可先導出再在目標環境導入。

刷新策略可在 15 / 30 / 60 秒與暫停之間切換；頻繁任務結束時插件也會在結算相關時機觸發讀取。

適用場景與注意¶

適合：長期在 DSH Web 端跑 Agent、希望側欄常駐餘額與消耗、需要自制預算與 runway、要在本機保留 7 天會話級消耗趨勢的開發者和個人用戶。

注意：

• 消耗歸屬是客戶端推導，Parallel 任務、長時間未打開頁面等情況會放大誤差。
• 數據僅存於當前瀏覽器 localStorage；清緩存、換設備會導致賬本丟失，除非先導出。
• 社區目錄 SkillHub 插件頁 與 GitHub 爲獨立生態信息源，與 DeepSeek / 幻方無官方從屬關係。

維護者提供離線檢查腳本，供改包或貢獻時使用：

node scripts/check.mjs

結尾¶

dsh-balance-chip-cesare 把賬戶餘額、推導消耗、預算、runway 和多幣種換算收到側欄一處，並用本地賬本補齊近 7 天會話視圖；在認清「無官方按會話賬單、數字爲近似」的前提下，適合作爲日常用量的自控面板。更多信息見 SkillHub 目錄 與 GitHub：Cesare97/dsh-balance-chip-cesare。