前言¶
用 DeepSeek Harness（DSH）做長對話或反覆調模型時，平臺賬單是事後纔看的；輸入框附近通常只有 token 統計，沒有和「賬戶還剩多少錢、這一輪大概花了多少」綁在一起。下面介紹社區客戶端插件 dsh-token-budget-pill（維護者 gutddts）：在對話輸入框下方的統計條裏增加一個 ¥ 膠囊，展示 DeepSeek 賬戶可用餘額與本會話 token 費用估算，點擊可展開明細。它是純客戶端插件，不改 DSH 源碼、不啓獨立服務、不寫會話、不發模型請求。
這是什麼¶
dsh-token-budget-pill 是 DSH 客戶端類插件，通過 conversation.composer.dock 插槽掛在輸入框統計條裏。餘額來自 DSH 賬號 Remote（ctx.remote.account.getBalance()），本會話用量來自 Session 投影（tokenUsage、sessionStats、modelSelection），費用按插件內置的 DeepSeek 官方價目表估算。許可證 MIT，package 版本 1.0.0，面向 DSH 0.2.x（README 標明 DSH 0.2.x badge）。
界面與核心功能¶
統計條膠囊¶
在已有消息的會話裏，輸入框下方統計條會多出一項，形態類似：
[¥] ¥56.68 · 本會話 ¥6.43
- 左側：DeepSeek 賬戶當前可用餘額（充值餘額 + 贈送餘額）
- 右側：本會話 token 的估算費用（按當前模型與當前峯谷時段計價）
- 點擊：展開明細麪板
明細麪板¶
明細包含：可用餘額、充值餘額、贈送餘額（支持 CNY / USD 錢包）；本會話估算費用及佔「起始額度」的百分比進度條；按本會話平均花費估算的「約可再用 N 輪 / X tokens」；Token 明細（緩存命中輸入、緩存未命中輸入、緩存寫入、輸出）；費用明細（緩存命中、緩存未命中、輸出及緩存命中節省）；手動刷新與最近更新時間。
刷新策略¶
頁面可見時每 90 秒自動刷新余額；每輪對話結束後約 4 秒也會自動刷新。刷新失敗時保留上一次成功數字，並標註「顯示上次結果」。
計價口徑¶
插件識別 deepseek-flash / deepseek-v4-pro，並區分高峯 / 空閒時段（高峯爲北京時間週一至週五 09:00–12:00、14:00–18:00；週末與法定節假日爲空閒；節假日未單獨識別）。價目表（元 / 百萬 tokens）如下：
| 模型 | 緩存命中輸入（空閒 / 高峯） | 緩存未命中輸入（空閒 / 高峯） | 輸出（空閒 / 高峯） |
|---|---|---|---|
deepseek-flash |
¥0.02 / ¥0.04 | ¥1 / ¥2 | ¥4 / ¥8 |
deepseek-v4-pro |
¥0.15 / ¥0.30 | ¥4.5 / ¥9 | ¥13.5 / ¥27 |
「本會話估算」僅作參照，實際扣費以 DeepSeek 平臺賬單爲準。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前建議自行查看 GitHub 倉庫 源碼與 MIT 許可證。
方式一：命令行從 GitHub 安裝¶
Web profile：
# dsh web（Web profile）
dsh plugin --profile web add github:gutddts/dsh-token-budget-pill && dsh web
桌面版 profile：
# DSH Desktop（桌面版 profile）
dsh plugin --profile desktop add github:gutddts/dsh-token-budget-pill
安裝器沒有可用 Git 時，可用 tarball：
dsh plugin --profile web add https://github.com/gutddts/dsh-token-budget-pill/archive/refs/heads/main.tar.gz
方式二：插件管理頁¶
打開 設置 → 插件 → 安裝插件，輸入：
github:gutddts/dsh-token-budget-pill
安裝後刷新對話頁或重啓 DSH。注意：需進入已有對話的會話才能看到 dock；新會話歡迎頁爲 hero 模式，不渲染該插槽。
典型用法¶
- 進入任意一個已有消息的會話。
- 看輸入框下方統計條：
[¥] 餘額 · 本會話費用。 - 點擊膠囊展開明細；點明細右上角「刷新」立即重新讀取餘額。
未登錄 DeepSeek 賬號（例如僅使用 API Key）時，餘額區域會提示不可用；本會話 token 與費用估算仍可用。
數據來源、隱私與兼容性¶
| 數據 | 來源 |
|---|---|
| 賬戶餘額 | DSH 賬號 Remote ctx.remote.account.getBalance() |
| Token 用量 | Session 投影 tokenUsage |
| 輪次數 | Session 投影 sessionStats |
| 當前模型 | Session 投影 modelSelection |
| 價格 | 插件內置 DeepSeek 官方價目表 |
憑證不進入頁面：餘額查詢由 DSH 宿主側完成，瀏覽器只接收金額快照。插件不寫 Session、不發模型請求、不向第三方上報；唯一寫入的是頁面內一個 <style> 標籤（插件樣式）。
兼容性要求：DSH 0.2.x，且包含 conversation.composer.dock 插槽與賬號 Remote。README 記錄已在 DSH Desktop 0.2.1-rc.2 上實測餘額讀取、峯谷價估算與 UI 正常。
適用場景與注意¶
適合在 DSH Web 或 Desktop 里長時間對話、需要對照餘額與會話花費的開發者。社區目錄 SkillHub 插件頁 與 GitHub 爲獨立信息源，與 DeepSeek / 幻方無官方從屬關係。
安裝插件前請確認信任維護者與代碼；會話費用爲估算值，高峯時段判定與官方賬單可能存在差異。
結尾¶
dsh-token-budget-pill 把賬戶餘額和本會話 token 費用估算放到輸入框下方，減少「聊完才發現餘額或花費超預期」的情況。進一步瞭解可訪問目錄頁 https://www.skillhub.cn/plugins/gutddts/dsh-token-budget-pill 與源碼 https://github.com/gutddts/dsh-token-budget-pill。
