前言¶

DSH 的插件化思路允許在 dsh web 中擴展常駐能力。對於使用 DeepSeek API 和 OpenCodeGo（opencode.ai Go 計劃）的開發者，餘額與餘量是日常需要確認的指標。dsh-balance 將這兩項信息放進 dsh web GUI：左下角常駐徽章，點擊查看詳情，並在設置頁管理 Key。

這是什麼¶

• 倉庫：linshule/dsh-balance
• 維護者：linshule
• 許可證：MIT
• 定位：dsh web GUI 常駐插件，同時顯示 DeepSeek API 賬戶餘額與 OpenCodeGo 計劃餘量。

核心功能¶

常駐徽章¶

左下角懸浮、可拖拽的雙段徽章，同時顯示 DeepSeek 賬戶餘額與 OpenCodeGo 計劃餘量。拖動後可鬆手記憶位置，瀏覽器 localStorage 中保存爲 dsh-balance.pos。

詳情彈層¶

點擊徽章展開彈層，查看 DeepSeek 餘額明細、OpenCodeGo 三窗口進度條與重置時間。彈層內可就地保存或清除 Key，並可立即刷新。

設置頁¶

提供兩個獨立設置頁：

• 設置 → DeepSeek 餘額
• 設置 → OpenCodeGo 餘量

Key 管理¶

DeepSeek API Key 持久化到 ~/.dsh/ds-balance.json，權限爲 0600，僅本機可讀。

OpenCodeGo Key 可留空，默認自動讀取 DSH 憑據；也可在設置頁單獨指定一個 Key 覆蓋。

自動刷新¶

插件存活期間按設定間隔自動刷新余額與餘量。默認間隔爲 1 分鐘，刷新間隔跨重啓記憶。瀏覽器本地狀態中保存爲 dsh-balance.intervalMs。

網絡重試¶

遇到網絡抖動時，使用 curl 走 HTTP/1.1 並自動重試。

安裝與啓用¶

先安裝插件，再重啓 dsh web 生效。

從 GitHub 倉庫安裝：

dsh plugin --profile web add github:linshule/dsh-balance

本地鏈接安裝，適合開發模式：

git clone https://github.com/linshule/dsh-balance.git <profile>/plugins/ds-balance
dsh plugin --profile web add link:./plugins/dsh-balance

資料中也列出 npm 包安裝命令：

dsh plugin --profile web add @linshule/dsh-balance

該方式在抓取資料中標註爲“發佈後可用”，未提供已發佈確認，本文不作爲確定安裝方式。

典型用法¶

1、重啓 dsh web 後，點擊左下角徽章，或進入設置 → DeepSeek 餘額。

2、粘貼 DeepSeek API Key（形如 sk-...）並保存。該 Key 會持久化到 ~/.dsh/ds-balance.json，重啓後無需重填。

3、如果使用 OpenCodeGo，且默認提供商爲 opencode-go，可保留 OpenCodeGo Key 爲空；插件默認讀取 ~/.dsh/.credentials.yaml 中的 OPENCODE_GO_API_KEY。也可以在設置頁單獨指定一個 Key 覆蓋。

4、拖動徽章調整位置，鬆手後自動記憶。

5、在徽章彈層內點擊立即刷新，可重新查詢當前餘額與餘量。

安全與注意¶

插件以當前 dsh 進程權限運行，安裝前應檢查源碼與 MIT 許可證。

已覈實資料中的安全限制包括：

• 所有 /api/ds-balance/* 路由僅迴環地址可訪問，即 127.0.0.1 / localhost。
• 非迴環地址一律 403。
• 請求體 ≤ 16 KiB。
• sec-fetch-site: cross-site 請求會被拒絕。
• DeepSeek API Key 以 0600 權限持久化在 ~/.dsh/ds-balance.json，僅本機可讀。

瀏覽器本地狀態包含徽章位置 dsh-balance.pos 與刷新間隔 dsh-balance.intervalMs。清空 localStorage 會丟失這些狀態。

結尾¶

dsh-balance 將 DeepSeek 餘額和 OpenCodeGo 餘量放進 dsh web 的常駐界面，減少在設置頁或外部頁面之間切換。已覈實資料未給出目錄頁 URL，本文不猜測；倉庫地址爲：

https://github.com/linshule/dsh-balance