前言¶

在 DeepSeek Harness（dsh）裏跑對話時，token 數能說明調用量，但不一定能直接回答“這一步花了多少錢”“今天花了多少錢”“餘額還剩多少”。如果希望這些數字在 dsh web 界面裏直接可見，而不需要額外去其他頁面查，就需要一個能讀取會話日誌、本地計算費用、並展示餘額與成本分佈的插件。

下面介紹 suanzhang-dsh，一個 DeepSeek Harness 計費插件：側邊欄顯示餘額和今日消費，算賬頁籤按步驟列出費用，官方價自動同步，並支持跨會話、跨天彙總。

這是什麼¶

suanzhang-dsh 是一個 DeepSeek Harness 計費插件，倉庫地址爲：

https://github.com/CZ1900/suanzhang-dsh

許可證爲 MIT。

它面向已經能打開 dsh web、並希望在本機查看 DeepSeek 調用費用的場景。插件本身不調用模型，主要做本地費用計算、餘額展示、官方價同步和成本彙總。

核心功能¶

suanshang-dsh 提供下面這些已覈實的展示與計算能力：

• 側邊欄常駐顯示當前餘額和今日消費。
• 算賬頁籤按步驟列出費用明細。
• 按模型、工具、天、會話可視化成本。
• 成本預測：平均每步 × 步數。
• 官方價自動同步；抓取失敗時回退到內置價。
• 點擊任意步驟行可跳到「軌跡」頁籤，並高亮對應步驟。
• 支持 DeepSeek V4-Flash / V4-Pro，含峯谷計價；也支持 deepseek-chat / deepseek-reasoner。
• 其他模型會顯示「未計價」。
• 支持跨會話、跨天彙總。
• 插件不調用模型，不消耗 token；主要是本地計算，外加兩個用於餘額查詢和官方價獲取的 HTTP 請求。

前置條件¶

安裝前建議先確認幾項條件：

1. 本機已有可打開的 DeepSeek Harness 環境，即 dsh web 能正常打開。
2. Node 版本不低於 22。

可用下面命令確認 Node 版本：

node -v

如果選擇從 GitHub 安裝，還需要本機 Git 可用，並且能訪問 github.com。公司網絡、代理或防火牆可能會攔截 GitHub 訪問，這時可以改用本地複製方式安裝。

DeepSeek API Key 用於餘額查詢。插件默認讀取：

DEEPSEEK_API_KEY

如果沒有配置 API Key，餘額欄會提示未配置，但費用匯總和計價仍可使用。

API Key 的使用範圍比較明確：它只用於一次餘額查詢請求，不落地、不打印、不進日誌、不進截圖；返回前端的信息會先剔除 Key。

安裝與啓用¶

方式一：從 GitHub 安裝¶

先執行安裝命令：

pnpm add https://github.com/CZ1900/suanzhang-dsh.git

這一步會把插件倉庫加入當前項目依賴。

然後編輯 Harness profile 下的 cordis.patch.yml，在頂部加上：

- insert:
    - id: suanzhang
      name: suanzhang-dsh

保存後重啓：

dsh web

重啓後刷新頁面，可以看到側邊欄餘額和「算賬」頁籤。

方式二：本地複製安裝¶

如果 GitHub 訪問受限，可以把倉庫放到 DSH profile 的 node_modules 目錄下。

在 DSH profile 目錄，例如：

~/.dsh/profiles/web

執行：

cp -r /path/to/suanzhang-dsh node_modules/

其中 /path/to/suanzhang-dsh 替換爲本機上的插件目錄。

然後同樣在 cordis.patch.yml 里加上：

- insert:
    - id: suanzhang
      name: suanzhang-dsh

重啓 dsh web 後刷新頁面即可。

典型用法¶

安裝並重啓後，常見操作路徑如下：

1. 打開 dsh web。
2. 在側邊欄查看當前餘額和今日消費。
3. 點擊側邊欄餘額，直接跳進「算賬」頁。
4. 在「算賬」頁查看按步驟列出的費用明細。
5. 查看按模型、工具、天、會話劃分的成本分佈。
6. 使用成本預測，用「平均每步 × 步數」估算後續費用。
7. 點擊任意步驟行，自動跳到「軌跡」頁籤，並高亮那一步。

如果只是想確認環境是否滿足要求，可以先把 Node 版本查清楚：

node -v

價格與數據邊界¶

suanshang-dsh 的計價和數據來源可以分成幾類。

餘額查詢¶

餘額查詢會訪問 DeepSeek 官方接口。默認 baseURL 爲：

https://api.deepseek.com

API Key 僅用於這次餘額查詢請求，不用於本地費用計算。

官方價同步¶

官方價同步會訪問 DeepSeek 公開文檔頁面：

https://api-docs.deepseek.com

該請求無鑑權，只讀。

如果抓取失敗，插件會回退到內置價，不影響費用匯總和展示。

本地費用匯總¶

費用計算和本地彙總會讀取本機會話日誌。顯示、排序、圖表等計算在瀏覽器本地完成，不出本機。

適配模型與關鍵參數¶

支持的模型¶

已覈實支持：

• DeepSeek V4-Flash
• DeepSeek V4-Pro
• deepseek-chat
• deepseek-reasoner

其中 DeepSeek V4-Flash / V4-Pro 支持峯谷計價。

其他模型會顯示「未計價」。

默認關鍵參數¶

以下參數來自已覈實資料，默認值硬編碼在插件中：

輪詢頻率可在 lib/client.js 中的 60000 毫秒處調整；如果希望降低刷新頻率，可以把這個毫秒值改大。

代碼入口¶

已覈實的代碼結構如下：

• lib/index.js：Host 端，包含餘額、計價、彙總、今日相關能力。
• lib/client.js：瀏覽器端 UI。

適用場景與注意¶

suanshang-dsh 適合這類場景：

• 已經在 DSH 中使用 DeepSeek。
• 不想手動換算 token 價格。
• 希望側邊欄直接看到餘額和今日消費。
• 希望把一次對話裏的每一步費用拆出來看。
• 希望按模型、工具、天、會話彙總成本。
• 希望點擊某一步費用時，能跳到對應軌跡步驟。

需要注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 插件本身不消耗 token；真正消耗 token 的是 dsh 對話。
• API Key 只用於餘額查詢，不參與本地費用計算。
• 如果側邊欄或「算賬」頁籤沒有出現，先確認 cordis.patch.yml 中已加入 id: suanzhang 和 name: suanzhang-dsh，然後重啓 dsh web 並刷新頁面。
• 如果餘額顯示「未配置 API Key」或查詢失敗，先到 Harness 設置裏確認 DeepSeek API Key 已配置。
• 如果 pnpm add 安裝失敗，優先檢查本機 Git、網絡、代理或防火牆；無法訪問 GitHub 時改用本地複製安裝。

結尾¶

suanshang-dsh 的價值比較直接：把餘額、今日消費、步驟費用、成本分佈和成本預測放進 DeepSeek Harness 的界面裏，並且主要依靠本地會話日誌完成計算。

GitHub 倉庫地址：

https://github.com/CZ1900/suanzhang-dsh