前言¶

在 DeepSeek Harness 裏同時接 DeepSeek 賬號、官方 API、OpenRouter、SiliconFlow 等多家 provider 時，餘額和當日 token 消耗往往分散在各處，Harness 側欄本身也不會統一幫你算「今天花了多少、按模型和會話怎麼拆」。社區插件 @pipilu123566/dsh-balance 已經在側欄做了餘額與消耗估算；若你更習慣俄語界面，或希望把 USD/CNY 金額旁邊看到按俄羅斯央行（ЦБ РФ）日匯率折算的近似盧布（₽），維護者 artuasova 的 dsh-balance-ru 是在上游基礎上的非官方俄語 fork，分類爲聯網工具（需聯網拉取匯率，本地緩存 6 小時）。

下面介紹它做什麼、與上游的差異，以及如何按 README 安裝啓用。

這是什麼¶

dsh-balance-ru 是 DeepSeek Harness 的客戶端 Web 插件：在側欄底部提供 「Баланс」/ 餘額 面板，彙總各 provider 餘額、當日消耗（按模型、會話、單輪對話），並支持自定義「provider/模型」百萬 token 單價。fork 在 @pipilu123566/dsh-balance 的餘額與計價邏輯上增加了 盧布近似顯示 與 內置俄語詞典（約 86 條），無需單獨裝語言包。許可證 MIT；當前 release 版本 1.2.0，要求 Harness Desktop engines.dsh: 0.2.1-rc.5。

• 目錄頁：https://www.skillhub.cn/plugins/artuasova/dsh-balance-ru
• 倉庫：https://github.com/artuasova/dsh-balance-ru

核心功能¶

餘額與 provider¶

支持 DeepSeek 賬號、官方 DeepSeek API、OpenRouter、SiliconFlow 等文檔化餘額 endpoint 的 provider；同一 provider 下多模型共用一行餘額。無密鑰、無餘額權限、限流、未知單價、未上報消耗等狀態會明確展示，而不是顯示成零餘額。

盧布顯示（僅 UI）¶

各金額旁可顯示形如 ≈ 295 ₽ 的近似值，依據 ЦБ РФ 日匯率對 USD 與 CNY 折算。這是 展示層：不會把數據存成盧布，也不會跨幣種相加。無網絡時仍顯示原幣種，不帶 ₽。匯率來源爲 cbr-xml-daily.ru（CORS 可用），備用 https://open.er-api.com/v6/latest/USD；瀏覽器請求，緩存 6 小時。懸停 ₽ 可看匯率日期；小於 100 ₽ 精確到戈比，≥100 ₽ 精確到盧布。

當日消耗與模型價格¶

按 Harness 記錄的 token 用量與你在插件裏配置的模型價格估算：當日總額、按模型/會話拆分、聊天中每一輪的消耗。「Цены моделей / 模型價格」可設輸入、輸出、緩存讀/寫等每百萬 token 價格（CNY 或 USD），保存後會重算曆史估算。

俄語界面¶

插件註冊語言 「Русский」（fallback en）。切換路徑：Настройки → Общие → Язык → Русский（設置 → 通用 → 語言）。僅本插件界面俄語化；Harness 其餘部分若無語言包仍爲英語，缺鍵回退英文，界面不會缺字。

與上游 @pipilu123566/dsh-balance@1.1.0 的差異¶

內部服務名仍保留上游命名（如 pipiluBalance、pipiluTokenUsage）；index.js、balances.js、usage.js、pricing.js 邏輯未改，盧布與俄語在 client.js 等客戶端側。

環境要求¶

• DeepSeek Harness 0.2.1-rc.5（Desktop），由 package.json 的 engines.dsh 校驗。
• Windows、macOS 或 Linux；插件在 Harness Web UI 中運行。
• 查看 ₽ 需互聯網（匯率緩存 6 小時）；餘額與消耗數據仍來自 Harness 自帶服務，匯率不參與後端計算。

安裝與啓用¶

安裝命令以下游 README 爲準，不要用 github:owner/repo 自行拼接。

1. 完全退出 DeepSeek Harness（不要只最小化窗口）。
2. 下載 release 包 dsh-balance-ru-1.2.0.tgz（其它版本見 Releases）。
3. 若曾安裝上游 @pipilu123566/dsh-balance，先移除，profile 裏只保留一個餘額插件：

dsh plugin --profile desktop remove @pipilu123566/dsh-balance

4. 從本地 tgz 安裝（--ignore-scripts 爲 README 指定參數）：

dsh plugin --profile desktop add ./dsh-balance-ru-1.2.0.tgz --ignore-scripts

macOS 上若 dsh 不在 PATH：

'/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh' \
  plugin --profile desktop add ./dsh-balance-ru-1.2.0.tgz --ignore-scripts

Windows 可使用：

"%LOCALAPPDATA%\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add .\dsh-balance-ru-1.2.0.tgz --ignore-scripts

5. 重新打開 Harness：側欄底部出現 「Баланс」；懸停或點擊可固定面板，Esc 關閉。

開發時可從目錄鏈接安裝（README 示例，路徑換成你的 checkout）：

dsh plugin --profile desktop add "/полный/путь/к/dsh-balance-ru" --ignore-scripts

典型用法¶

1. 安裝並打開側欄 Баланс，查看各 provider 可用餘額；需要盧布參考時保持聯網，看各行 ≈ … ₽。
2. 在面板中查看 當日消耗 及按模型、會話、單輪明細，對照聊天用量排查異常。
3. 打開 模型價格，爲常用 provider/模型填寫每百萬 token 價格（CNY 或 USD），保存後歷史估算會更新。
4. 若使用俄語插件文案：設置 → 通用 → 語言 → Русский。

README 截圖基於 Harness 0.2.1-rc.5 環境；面板行爲以你本機 Harness 版本爲準。

適用場景與注意¶

適合：在 Harness Desktop 0.2.1-rc.5 上多 provider 並用、需要側欄統一看餘額與當日消耗；在俄羅斯或俄語環境下工作，希望插件 UI 爲俄語；希望在 USD/CNY 旁快速看 ЦБ 近似盧布，便於心理賬戶（非記賬憑證）。

注意：

• 插件以當前 Harness / dsh 進程權限運行，安裝前請閱讀 倉庫源碼 與 MIT 許可證；非 DeepSeek、非上游作者官方產品。
• 與上游並存會衝突：只保留 dsh-balance-ru 或上游其一。
• ₽ 爲近似展示，正式財務仍以 provider 原幣種賬單爲準。
• SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；星標與分類以目錄頁展示爲準（資料中 GitHub 1 star，分類 聯網工具）。

結尾¶

dsh-balance-ru 在成熟餘額插件之上補了兩塊實用能力：ЦБ 匯率下的盧布參考顯示 與 內置俄語。若你的 Harness 版本滿足 0.2.1-rc.5，可按 release tgz 與上述 dsh plugin --profile desktop add 步驟接入。

• 目錄：https://www.skillhub.cn/plugins/artuasova/dsh-balance-ru
• GitHub：https://github.com/artuasova/dsh-balance-ru