前言¶
用 DeepSeek Harness（DSH）接千問平臺 API、又用阿里雲代金券或賬戶餘額付費時，對話窗口裏看不到「券還剩多少、什麼時候到期」。賬單和消費統計是另一套問題；若只想知道當前還能用的錢，需要單獨查阿里雲 BSS 存量。下面介紹社區插件 dsh-aliyun-balance（維護者 wai549077），在 DSH 界面上懸浮一行顯示代金券餘額與賬戶餘額的合計，懸停可看券明細與失效時間；只讀 BSS，不做消費統計。
這是什麼¶
dsh-aliyun-balance 是 DSH 插件，npm 包名 dsh-aliyun-balance，當前版本 0.1.2，許可證 MIT。在 SkillHub 分類爲聯網工具；包元數據裏還標註了「費用」「Web UI」，支持 host 與 web 兩種 surface。
它回答的問題是：還剩多少錢能花（代金券餘額 + 阿里雲賬戶餘額），而不是花了多少。數據來自阿里雲 BSS 的當前存量；與 dsh-cost-meter 互補——後者按 token 估算消費，且無法查代金券明細。
README 寫明主要面向領了阿里雲 300 元「雲工開物」高校認證學生專屬代金券、並用千問平臺 API 接入 DSH 的用戶；倉庫內另有從領券到接入的圖文教程（docs/阿里雲300學生券-千問AI平臺-DSH接入教程.md）。
核心功能¶
界面上一行類似：
可用 ☰ ¥128.50
「可用」爲可用合計（代金券餘額 + 賬戶餘額）。操作要點：
| 操作 | 效果 |
|---|---|
| 懸停 | 展開明細：券餘額、面值/已用、最早失效時間、現金/信控等（均爲 BSS 直讀，非推算） |
| 單擊（非 ☰） | 繞過緩存立即刷新 |
| 拖動 / 雙擊 | 改位置 / 復位默認位置 |
| 點 ☰ | 打開面板：憑據、外觀、顯示項 |
餘額與券默認每 5 分鐘刷新一次。插件不統計消費，不看會話事件；想知道花了多少需用 dsh-cost-meter。
可選「計價時段」顯示（千問平臺閒忙口徑，東八區 22:00–08:00 爲閒時），僅對 README 列出的部分按閒忙雙檔計價的模型有意義；用不上可在面板關閉。
網絡權限在 package.json 中聲明爲 https://*.aliyuncs.com；憑據區可改 endpoint，但只允許 *.aliyuncs.com 域名。
安裝與啓用¶
DSH 從本地目錄安裝插件：先把含 package.json 的目錄放在固定位置（勿放臨時目錄，移動後需重裝），再在桌面端會話裏說明本地路徑，例如：
把 D:\Plugins\dsh-aliyun-balance 這個本地目錄作爲插件裝上
官方 README 提供的獲取目錄方式包括：
從 GitHub 克隆（推薦）：
git clone https://github.com/wai549077/dsh-aliyun-balance.git dsh-aliyun-balance
從 npm 安裝包到本地：
npm i dsh-aliyun-balance
命令行添加（注意 profile）：
dsh plugin add dsh-aliyun-balance
README 說明：dsh plugin 不能用於桌面端的 desktop profile（該 profile 僅由 Electron 應用管理）。桌面端用對話式本地目錄安裝，或等插件市場直裝後對 DSH 說「把 dsh-aliyun-balance 裝上」；web（dsh web） 可用：
dsh plugin --profile web add dsh-aliyun-balance
裝完自檢：界面應出現那一行；Windows 下日誌 %USERPROFILE%\.dsh\.dsh-aliyun-balance.log 中應有 {"event":"apply"}。若未出現，重開一次客戶端。實測環境爲 DSH Desktop（Windows）2.0.17；web profile 機制同源但 README 標明未經實測。
未配置憑據時，那一行會顯示「未配置」。
配置憑據¶
- 在阿里雲 RAM 創建子賬號（不要用主賬號），建議勾選「使用永久 AccessKey 訪問」，不勾控制台登錄。
- 只讀授權：
bss:DescribeAcccount（官方拼寫爲雙c）、bss:DescribeCoupons，或系統策略AliyunBSSReadOnlyAccess。 - 創建 AccessKey，保存 AccessKey ID / Secret（Secret 僅創建時顯示一次）。
- DSH 中點 ☰ → 憑據與設置 → 填入 AK/SK → 保存憑據 → 測試連接。
憑據寫入 DSH 官方憑據服務；本地 ~/.dsh/.credentials.yaml 爲明文 YAML，務必使用只讀子賬號 AK。插件設置接口不回顯密鑰，只返回 hasAk / hasSk；查詢主機爲 business.aliyuncs.com，無寫操作。
典型用法¶
完成安裝與憑據後，日常使用即：看那一行的合計金額；快到期或想覈對券面值/已用時懸停；需要改 AK、外觀或關閉計價時段時點 ☰ 進面板。單擊一行可強制刷新，適合剛充值或剛扣券後想立刻看存量。
與 dsh-cost-meter 搭配時：本插件盯「還能花多少」，cost-meter 盯「這輪對話大概花了多少」，二者數據來源不同，不重疊。
適用場景與注意¶
適合： 用阿里雲代金券和/或賬戶餘額爲 DSH（尤其千問 API）付費、希望在 IDE 內常駐看到存量與券失效信息的開發者。
安裝前： 插件在 DSH 進程權限下運行，會持有你配置的 AK/SK 並訪問阿里雲 BSS；安裝前應閱讀 GitHub 倉庫 源碼與 MIT 許可證，確認只讀 RAM 策略滿足你的安全要求。
讀數注意： BSS 存量相對實際扣減可能有延遲，不宜用對話前後餘額差反推單次消費。插件不上傳界面上的阿里雲數據到第三方（README「關於」一節說明）。
故障排查可參考 README：Forbidden 多爲 RAM 缺 bss:Describe* / bss:Query*；位置異常可雙擊復位或取消「鎖定位置」。
結尾¶
dsh-aliyun-balance 把阿里雲代金券與賬戶餘額收成 DSH 裏可拖動的一行掛件，只讀 BSS、只報存量，和消費統計類插件分工明確。目錄與詳情見 SkillHub 插件頁，源碼與完整安裝說明見 GitHub：wai549077/dsh-aliyun-balance。
