前言¶
寫的時候想不起這輪任務花了多少 token，是 DSH 用戶的常見問題之一：DSH 的界面已經顯示了 token 和緩存讀取數，但多數時候你關心的是「折算成人民幣大概多少錢」。重新打開廠商定價頁手算、或者按提示詞長度估一個數，誤差都很大，而且緩存命中、子代理調用、重試和中斷的請求通常算不進去。
dsh-cost-guard 做的是另一件事：不猜，直接讀 DSH 會話事件裏的真實用量，用你自己配置的單價算出一個本地估算值，放在輸入框下方。插件來自維護者 chenzhiyong1994，在社區插件目錄中歸入 admin-security 分類，開源協議 MIT，當前版本 v5.1.0。下面介紹它的功能、安裝方式和注意事項。
這是什麼¶
一句話：dsh-cost-guard 是一個本地 Cordis 插件 bundle，把 DSH 記錄的真實 token 用量實時換算成金額，顯示在輸入框下方的緊湊標籤裏，並提供按模型累計和可編輯價格表。
兩個常見誤解先澄清：
- 它不攔截、不改寫、不路由 Agent 的執行，只是旁路觀察。沒有預測門禁，也沒有確認遮罩。
- 它給出的金額是本地估算，不是權威賬單。官方價格會變，最終以供應商發票爲準。
package.json 裏用 dsh.bundle.patch 聲明 Host 半部分，用 dsh.client 聲明瀏覽器半部分，所以它不是一個傳統單文件插件，而是按 DSH bundle 的方式安裝。
核心功能¶
按 README 提到的能力逐條整理。
- 基於真實用量。讀取 DSH usage 事件裏的
inputTokens、outputTokens、cacheReadTokens、cacheWriteTokens，覆蓋重試和中斷的請求，不按提示詞大小估算。 - 實時可見。輸入框下方顯示當前或上一次任務的
¥金額，點標籤彈出模型、輸入 / 輸出 / 緩存 token、模型調用次數、峯谷時序與本次會話累計。 - 支持子代理。子代理的用量回捲到根會話當前輪次，並按每次調用實際服務的模型計價。
- 重啓可恢復。如果插件重啓過，首次查看某個會話時會從持久事件日誌回填歷史累計。
- 價格可審計。所有模型單價和峯谷時段在設置頁可見、可改。
- 界面雙語。價格標籤和設置頁跟隨 DSH 通用設置的語言自動切換。
- 完全本地。無遙測、無外部服務、無賬號訪問，不收集 API Key。
安裝與啓用¶
先說明運行要求：DeepSeek Harness 0.2.1+（桌面版或 dsh web），profile 需包含 Web 應用組合包；價格標籤和設置頁需要 DSH Web UI。只有開發時跑 npm run check 才需要 Node.js。
包體是本地目錄安裝，而不是從 GitHub 直接拉取。步驟如下：
- 把倉庫放到一個固定路徑，例如
D:\plugins\dsh-cost-guard。 - 打開 DSH 的 設置 → 插件 → 組合包，從本地目錄安裝；或用等價命令：
dsh plugin --profile <profile> add "D:\plugins\dsh-cost-guard"
- 安裝器報告
restart-required時重啓 DSH。
也可以直接讓 DSH 智能體去裝，等價的提示詞：
把 D:\plugins\dsh-cost-guard 這個 DSH bundle 安裝到當前 profile，
然後在插件清單裏確認 cost-guard 這一行已經激活。
安裝完成後，插件清單裏會出現 開銷監控，設置裏有一級頁面 設置 → 開銷監控，輸入框下方出現價格標籤。兩個半部分都是純 JavaScript，沒有構建步驟。
本地開發改源碼時，把上面的路徑換成 checkout 目錄即可，安裝器會以鏈接方式裝入，改動後重新安裝並重啓生效。
包整體替換即可升級：換文件或拉新 release，再執行一次安裝命令，然後重啓，Host 和瀏覽器兩側都會從新文件重新加載。
配置項¶
打開 設置 → 開銷監控，可配置的內容分四塊：
| 區塊 | 內容 |
|---|---|
| 模型定價 | 輸入未命中、輸出、輸入命中單價；添加自定義模型；恢復默認（需兩步確認） |
| 峯谷計價 | 開關、時段與倍率 |
| 本次運行累計 | 已結算輪次、實際累計、可編輯匯率、按模型統計 |
| 配置備份 | JSON 導出與導入（導入會先校驗再替換當前設置） |
計價模型¶
v5.1.0 的默認單價按 2026-10-28 覈對的 DeepSeek V4.1 Flash / V4 Pro 官方峯谷定價填寫，單位是人民幣元 / 1M tokens，下表爲谷時價：
| 模型 | 輸入·緩存未命中 | 輸出 | 輸入·緩存命中 |
|---|---|---|---|
deepseek-flash |
¥1.00 | ¥4.00 | ¥0.02 |
deepseek-v4-pro |
¥4.50 | ¥13.50 | ¥0.15 |
default 兜底 |
¥1.00 | ¥4.00 | ¥0.02 |
幾個副作用要留意：
- 高峯時段是北京時間週一至週五 09:00–12:00 和 14:00–18:00，單價爲谷價的 2 倍；週末和法定節假日全天爲谷時，2026 年節假日安排已內置。峯谷計價默認開啓，可以在設置頁關閉或改窗口。
- 官方價目沒有單列緩存寫入，緩存寫入 token 按輸入緩存未命中價計算。
- 舊模型名會映射到當前計費行：
deepseek-v4-flash、deepseek-v4-flash-vision-exp→deepseek-flash，deepseek-reasoner→deepseek-v4-pro；已停用的deepseek-chat也映射到 Flash。 - Search / Fetch 由 DeepSeek 另行按次計費（2026-11-01 起 ¥5 / 千次成功請求），插件只統計模型 token，不含這部分請求費。
工作原理¶
Host 半部分（index.js）注入 webServer，摺疊已入日誌的會話事件、歸屬輪次、彙總子代理，首次查看時回填歷史，並暴露兩條數據路由（/cost-guard/live、/cost-guard/rpc）和一條健康檢查路由。Client 半部分（client.js）在 conversation.composer.dock 註冊價格標籤、在 settings.section 註冊設置頁，通過 fetch 讀取 Host。
數據流始終留在當前 DSH 進程內，路由走本機 HTTP，不訪問外部網絡。價格狀態持久化在 ~/.dsh/cost-guard/config.json（識別 $DSH_HOME），重啓後仍在。
適用場景與注意¶
適合的場景：用 DSH 跑日常任務、希望在不打斷工作流的前提下看到每次任務的大致花費；使用子代理的多輪任務；對模型單價和峯谷規則有審計要求的團隊。
安裝前需要注意三件事：
- 插件以當前 DSH 進程的權限運行，能讀到會話事件和本地配置路徑。裝之前先過一遍
index.js和client.js，確認沒有超出預期的行爲。 - 它依賴 DSH 的
webServer、sessions、session/event、conversation.composer.dock、settings.section等 Slot，這些不是穩定的公開 API。DSH 插件接口仍在快速演進，第三方插件的兼容性需要自己承擔，反饋問題時附帶 DSH 版本會更快定位。 - 金額是估算值，調價後記得去設置頁更新單價，否則估算會偏離實際賬單。插件不聯網覈對價格。
結尾¶
dsh-cost-guard 的價值在於把「大概多少錢」這件事從估算變成可比對的數字，並且只做觀察，不介入執行。適合想要知道自己的 token 花在哪裏、又不願意維護一套外部監控腳本的 DSH 用戶。
目錄頁：https://www.skillhub.cn/plugins/chenzhiyong1994/dsh-cost-guard
GitHub：https://github.com/chenzhiyong1994/dsh-cost-guard
需要提醒的是，社區目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，它不是官方應用商店；插件本體在 GitHub 上按 MIT 協議開源，安裝前仍應自行覈對源碼與許可證。
