前言¶
在 DeepSeek Harness（DSH）裏跑長對話或頻繁調用模型時，單輪用了多少 token、按官方價表折算成多少人民幣、錢包餘額還剩多少，往往要事後去控制台或賬單裏查。高峯與低谷時段單價不同，跨時段的一輪對話還要按每次調用各自的時間戳計價，手工估算容易錯。社區插件 dsh-token-control（目錄展示名 Token Monitor）把上述信息掛在對話輸入區上方，流式更新，並配合北京時間高峯窗口做倒計時提醒。下面介紹它的定位、能力與安裝方式。
這是什麼¶
dsh-token-control 是維護者 RitvaManner 發佈的 DSH 插件，在 SkillHub 社區目錄中歸類爲 admin-security。插件 Host 與 Client 分離，定價、餘額、高峯策略與視圖均可替換；當前狀態爲 v0.1.0，依賴 Node.js ≥ 22、DSH ≥ 0.2.0，許可證 MIT。
一句話定位：在 composer 上方（或可配置掛載點）展示逐輪 token 明細、按價表折算的費用、DeepSeek CNY 錢包餘額，以及高峯/低谷切換倒計時。
核心功能¶
資料中明確列出的讀數與行爲如下。
逐輪 token 與費用
- 每輪分別展示：總 token、輸入合計、輸出、緩存命中、緩存未命中。
- 費用來自價表
DS_CNY_2026_11（來源：DeepSeek 官方 CNY 定價文檔）；每次 API 調用按該調用自身時間戳選擇高峯或低谷單價，跨邊界的一輪仍按調用拆開計費。 - 流式輸出過程中，在 provider 上報用量前，輸出 token 以字符估算並標
≈，上報後替換爲確定值。
餘額
- 通過 Host 調用
GET /user/balance讀取 CNY 錢包。刷新失敗時保留上一次讀數，並標爲過期及對應時間戳。
高峯 / 低谷
- 北京時間週一至週五 09:00–12:00、14:00–18:00 爲高峯；法定假日除外；其餘時間（含週末、假日及調休補班中的週末）按低谷 50% 計價。假日政策引用國務院 2026 年通知。
- 高峯結束前 5 分鐘在讀數區顯示倒計時；切換後約 3 秒靜默提示「已切換」，無彈窗打斷。
架構要點（便於二次開發）
- 目錄分層：
definition（契約與純數據）、provider（可替換實現）、consumer（賬本與 ViewModel）、host（組合根）、client（傳輸與 React 殼）。每個 View 爲src/client/views/下獨立文件，由構建腳本內聯進./client導出，以適配 DSH Client 以 classic script 加載插件 client 的方式。
安裝與啓用¶
在目標 profile 下執行以下命令之一（與倉庫 README 一致）：
# 從 npm（發佈後）
dsh plugin --profile <profile> add dsh-token-control
# 從 GitHub
dsh plugin --profile <profile> add github:RitvaManner/dsh-token-control
# 本地 checkout（開發）
dsh plugin --profile <profile> add .
安裝完成後，打開 Settings → Token Monitor，選擇讀數掛載位置；默認掛載點爲 conversation.input.dock（輸入框上方一行）。
典型用法¶
- 按上一節命令把插件加入當前使用的 DSH profile。
- 在 Harness 設置裏進入 Token Monitor，確認或調整掛載點。
- 正常發起對話：讀數隨輪次與流式輸出更新；餘額按 Host 側策略刷新；臨近高峯結束時關注讀數區倒計時。
若需改 UI 或新增 View，在倉庫內編輯 core.js 或 src/client/views/ 後執行：
node scripts/build-client.mjs
開發模式可用 pnpm dev（在倉庫內使用 .dsh-dev/，不修改 ~/.dsh）。
適用場景與注意¶
適合誰
- 長期在 DSH 桌面或 Web 會話裏調試智能體、需要當場看到 token 與人民幣費用的開發者。
- 需要對照 DeepSeek 高峯 / 低谷計價規則、並希望在切換前收到讀數區提醒的用戶。
安全與權限
- API Key 僅在 Host 通過
ctx.credentials.resolve('DEEPSEEK_API_KEY')解析，只出現在對外請求的Authorization頭；瀏覽器側僅收到字段級 ViewModel，測試約束頁面不會出現 key、上游 URL/正文或 Session。 - 部分路由僅綁定 loopback，但未走 DSH
/api的 connection admission：本機其他進程可能讀到含餘額的快照（不含 key）。安裝前宜閱讀倉庫 Security 小節與源碼；插件以當前 DSH 進程權限運行，社區目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係，並非官方應用商店。
結尾¶
dsh-token-control 把逐輪 token、價表費用、CNY 餘額與高峯倒計時集中到輸入區上方，Host 持鑰、Client 只展示 ViewModel，適合在 DSH 日常開發中做用量與成本自檢。詳情與源碼見 GitHub 倉庫，社區條目見 SkillHub 目錄頁。
