前言¶
在 DeepSeek Harness（DSH）里長時間跑會話時，賬戶餘額、當前是峯時還是非峯時、以及本會話已經燒了多少 token，往往要切到瀏覽器或平臺頁面才能看清。官方賬戶區能查餘額，但和 Composer 輸入區不在同一視線裏，補餘額也要離開當前工作流。
下面介紹社區插件 dsh-wallet-ru（npm 包名 dsh-plugin-wallet-ru）。它在 Composer 文檔欄以一行「芯片」展示 тариф（峯時 / 非峯時）、多幣種餘額、本會話 token 與費用，並支持應用內打開充值頁、點擊會話費用查看近 7 日支出柱狀圖。界面文案爲俄語；維護者爲 Vasyarot，歸類爲 DSH 客戶端插件。插件在 SkillHub 目錄 與 GitHub 分發，與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
dsh-wallet-ru 面向 DSH 0.2.x（engines.dsh: >=0.2.1-rc.5 <0.3.0），在 Web 與 Desktop 配置文件的 Composer 文檔區域注入客戶端 UI，並由插件宿主提供 /wallet-ru 等路由聚合定價與用量數據。
芯片示例（來自 README，佈局示意）：
Не пик 12 ч 45 мин · Баланс: $0.83 · ¥12.50 · бонус $1.00 · Сессия: 12,3 тыс. ток · $0.04
↑ 懸停：單價 ↑ 懸停：$, ¥, 贈金 ↑ 點擊：近 7 日支出
文檔欄芯片展示什麼¶
| 元素 | 含義 |
|---|---|
| тариф | Не пик（非峯）綠色，Пик（峯時）紅色 |
| 剩餘時間 | 距離切換 тариф 的倒計時（如 12 ч 45 мин） |
| 餘額 | 美元始終排在最前，下劃線可點擊跳轉充值；人民幣與贈金僅在餘額大於零時顯示 |
| 會話 | 當前會話 token 與美元費用，下劃線可點擊打開 7 日圖表 |
平臺通過 normal_wallets 與 bonus_wallets（每項爲 {currency, balance}）下發幣種；客戶端先打印 USD，再打印非美元錢包（CNY 用 ¥），贈金帶「бонус」標記。
懸停提示與點擊行爲¶
各區塊有獨立 tooltip，不再使用一條長字符串。
峯時 / 非峯時：只展示每百萬 token 的輸入、緩存讀、輸出單價；當前生效 тариф 在上，另一檔在下。非峯時示例價爲輸入 $0.14、緩存 $0.014、輸出 $0.21；峯時約爲 ×2。具體數值來自宿主 GET /wallet-ru 的 perMillion，平臺調價後無需改客戶端。
餘額：分別列出美元、人民幣、贈金；無人民幣時顯示「нет」，無贈金時顯示 0。
會話：無 tooltip；點擊打開近 7 日支出窗口。
點擊餘額金額：在應用內全屏 overlay 打開 platform.deepseek.com/top_up，頂欄含「返回 · 充值 · 重新加載 · 在瀏覽器中打開」。overlay 掛在 shell.overlay，與賬戶模塊的 PlatformOverlay 同一穩定宿主，避免 Composer 文檔重繪把原生 WebView 清掉。若遇 AWS WAF 挑戰導致白屏，可點「重新加載」；open() 網絡失敗時插件最多自動重試 3 次（間隔約 0.8–2.2 秒），成功打開後不會盲目重載。
點擊會話費用：在芯片上方彈出寬 300px 的 7 日柱狀圖，Esc、點外部或再次點擊可關閉。
7 日支出窗口¶
窗口含標題、周合計、詳情行與 7 根柱。柱高對應當日費用；無請求的日子爲細灰條，便於看出空檔。柱下爲俄文縮寫 weekday（пн、вт …）。懸停柱體顯示日期、金額、token 與請求數；未懸停時底部行顯示本週 token 與請求總數。宿主從 sessionPersistence 讀會話日誌，按日彙總並按各請求時刻的 тариф 計費；客戶端也會補齊 7 天窗口以兼容只返回「有消費日期」的舊宿主。
會話 token 與定價數據來源¶
會話 token 來自 slot 的 tokenUsage 投影（useProjection）：無緩存輸入 + 緩存讀 + 緩存寫 + 輸出。殼層未提供投影時顯示 —。美元費用按當前 тариф 的每百萬 token 價計算；緩存寫入按輸入價計。
餘額獲取順序¶
- 已登錄 DeepSeek 賬戶：
deepseekAccount.getBalance()，無需 API Key。 - API Key：
GET https://api.deepseek.com/user/balance，使用 credentials 或環境變量中的DEEPSEEK_API_KEY。
展示金額取自美元錢包；缺失時顯示 $—，原因寫在 tooltip 中。
安裝與啓用¶
插件版本 1.2.0，許可證 MIT，Node >=24。
Web 配置文件（命令須帶 --profile web）：
dsh plugin --profile web add github:Vasyarot/dsh-wallet-ru
CLI 會把包寫入 profile 依賴與 dsh.profile.bundles。安裝後重啓 DSH。
Desktop 配置文件不能用上述 CLI 管理；Electron 會提示 profile "desktop" is managed exclusively by the Electron application。在桌面應用內：
- 側欄 → Plugins（插件）；
- Add plugin（添加插件） → 填入
github:Vasyarot/dsh-wallet-ru或插件目錄絕對路徑； - Install（安裝），再啓用對應 bundle；
- 重啓應用。
卸載：Web 執行 dsh plugin --profile web remove dsh-plugin-wallet-ru；Desktop 在同一插件頁對卡片點 Remove（刪除）。
典型用法¶
安裝並重啓後，無需額外配置即可在 Composer 文檔欄看到芯片。需要充值時點擊下劃線的餘額金額，在 overlay 內完成；若白屏，使用頂欄「重新加載」。要覈對近期消耗，點擊會話費用行打開 7 日圖，懸停各柱查看單日明細。
僅使用 API Key 查餘額時，在 DSH credentials 或環境中配置 DEEPSEEK_API_KEY；登錄賬戶路徑優先，一般不必雙配。
開發者在倉庫根目錄可跑本地檢查（不隨 npm 包發佈）：
node tools/smoke.mjs # tooltip、圖表幾何、芯片 markup
node tools/route-test.mjs # 假宿主上的 /wallet-ru 與 /wallet-ru/usage
適用場景與注意¶
適合在 DSH 0.2.x 下長期用 Composer、希望餘額與 тариф 與輸入區同屏、並偶爾在應用內充值的開發者。界面爲俄語，閱讀 tooltip 與菜單時需接受該語言。
插件與當前 DSH 進程同權限運行；安裝前請自行審閱 源碼 與 MIT 許可證。充值頁依賴平臺 WebView 與網絡；WAF / TLS 異常時以 README 說明的重試與「在瀏覽器中打開」爲準。
主要文件：index.js（GET /wallet-ru、GET /wallet-ru/usage?days=7）、client.js（芯片與圖表）、cordis.patch.yml（profile 樹中的 wallet-ru 條目）。
結尾¶
dsh-wallet-ru 把 DeepSeek 美元 / 人民幣 / 贈金餘額、峯時與非峯時 тариф、本會話用量，以及 7 日支出和內置充值入口，收進 Composer 文檔欄一行交互區，減少在平臺頁與 IDE 之間來回切換。
