前言¶

在 DeepSeek Harness（DSH）里長時間跑 Agent 或對話時，阿里雲賬戶餘額、學生/活動代金券還剩多少，往往要單獨打開控制台或另開腳本查。手工查一次不難，難的是和「今天花了多少 token」放在同一塊視野裏對照。社區插件 dsh-aliyun-coupon-api（維護者 tacotuesday22）走阿里雲官方 OpenAPI 做只讀查詢，不需要賬號密碼登錄網頁；憑證用的是 RAM 子用戶的 AccessKey，在側邊欄底部以掛件形式展示餘額與券信息。若本機還安裝了 dsh-cost-meter，同一卡片會多讀一份本地賬本，顯示「今日消耗」一行。

這是什麼¶

dsh-aliyun-coupon-api 是 DeepSeek Harness 的聯網類插件（社區目錄分類：聯網工具）。它通過官方接口 QueryAccountBalance（賬戶餘額）與 DescribeCoupon（優惠券/代金券列表，README 與 package 描述中提及「雲工開物」學生券剩餘額度等場景）拉取數據，在 DSH 側邊欄底部渲染卡片。數據刷新分兩檔：今日消耗每 30 秒讀本地賬本（無網絡）；阿里雲餘額與代金券每 5 分鐘請求一次 API；點擊卡片可強制刷新兩者。未配置 AccessKey 時卡片會提示「未配置」，並可從卡片進入 設置 → 阿里雲代金券 完成引導式配置。

核心功能¶

側邊欄展示形態（示例來自倉庫 README）：

今日  52.0M tokens        ¥1.93
餘額                      ¥0.00
代金券                    ¥276.75
面值 ¥300.00 · 1 張 · 355天后到期

已覈實能力如下：

1. 賬戶餘額 / 代金券：調用阿里雲 BSS 相關 OpenAPI，只讀；推薦 RAM 系統策略 AliyunBSSReadOnlyAccess，或自定義策略限定 bss:DescribeCoupon、bss:DescribeAcccount（官方文檔原始拼寫）等動作。
2. 今日消耗（可選）：依賴本機 dsh-cost-meter 的本地賬本；未安裝則自動隱藏該行。
3. 內置設置頁：保存 AccessKey 前會做校驗；誤填模型 API Key（sk- 開頭）會提示；保存成功後可顯示 AK 末四位。
4. 安全取向：不要求主賬號 Key；文檔強調子用戶僅勾選「使用永久 AccessKey 訪問」，不要勾選「使用控制台訪問」。

插件當前 package 版本爲 1.6.2（MIT 許可證），要求 Node >=20、dsh >=0.1.6，支持 darwin / linux / win32。

安裝與啓用¶

安裝前需確認：向 desktop profile 裝插件時，必須使用 DeepSeek Harness 桌面版自帶的 dsh CLI；npm i -g @deepseek-ai/dsh 的全局 CLI 無法操作 desktop profile，會被拒絕。

Windows 默認 CLI 路徑示例：

%LOCALAPPDATA%\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd

macOS 示例：

/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh

下文用 <dsh> 表示你機器上可用的完整路徑。

獲取安裝包¶

倉庫說明：lib/ 不在 Git 裏，需在項目目錄執行構建後再打包。在 dsh-aliyun-coupon-api 源碼目錄中：

npm install          # prepare 會自動生成 lib/
npm pack             # 生成 dsh-aliyun-coupon-api-<版本>.tgz

也可直接使用他人提供的 .tgz，跳過構建。README 建議用 tarball 安裝，避免 dsh plugin add . 產生指向源碼目錄的符號鏈接（移動或刪除目錄可能導致插件失效）。

安裝到 desktop profile¶

Windows：

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" `
  plugin --profile desktop add .\dsh-aliyun-coupon-api-<版本>.tgz

macOS / Linux：

"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
  plugin --profile desktop add ./dsh-aliyun-coupon-api-<版本>.tgz

若包已發佈到 npm，同樣必須用桌面版 CLI：

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" `
  plugin --profile desktop add dsh-aliyun-coupon-api

確認安裝：

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" `
  plugin --profile desktop list

列表中應出現 dsh-aliyun-coupon-api@<版本>。卸載時將 add 改爲 remove。

安裝後必須完全退出並重啓 DeepSeek Harness；僅刷新頁面不夠，插件在啓動時加載。

配置 AccessKey（只讀 RAM 子用戶）¶

推薦流程：① 建只讀子賬號 → ② 裝插件 → ③ 填 AccessKey → ④ 驗證。AccessKey 的創建必須在 阿里雲 RAM 控制台 由本人操作，不要把 Secret 交給 Agent 或貼到聊天裏。

1. 創建 RAM 用戶：勾選 「使用永久 AccessKey 訪問」，不要勾選「使用控制台訪問」。
2. 授權：最快方式是掛系統策略 AliyunBSSReadOnlyAccess；或按 README 創建自定義策略 DSH-Coupon-ReadOnly。
3. 在 DSH 中：側邊欄卡片點 去設置 ›，在 設置 → 阿里雲代金券 填寫 AccessKey ID 與 Secret，點 保存並測試（驗證失敗不會保存）。

可選：在配置前用環境變量在倉庫裏跑 live 測試（README 提供）：

export ALIBABA_CLOUD_ACCESS_KEY_ID=LTAI...
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=...
npm run test:live

輸出中能看到券餘額與賬戶餘額，說明權限與 Key 可用。

典型用法¶

安裝、重啓並完成 AccessKey 配置後，無需額外命令：側邊欄底部卡片會持續刷新。需要立刻對齊阿里雲側數據時，點擊卡片 即可強制刷新余額與代金券（今日消耗仍按本地賬本節奏更新）。

若與 dsh-cost-meter 同機使用，卡片第一行會顯示當日 token 與對應費用估算；兩行數據來源不同，刷新間隔也不同，屬預期行爲。

適用場景與注意¶

適合誰：已在 DSH 桌面版日常開發、使用阿里雲 BSS 賬戶，希望在 IDE 側邊欄一眼看到餘額與代金券、並可選對照本地 token 賬本的用戶。

權限與安全：

• 插件以當前 DSH 進程權限運行；安裝前應自行閱讀 倉庫源碼 與 MIT 許可證，評估是否接受將 RAM AccessKey 存入 DSH 插件配置。
• 務必使用 子賬號 + 只讀策略，不要用主賬號 AccessKey；填的是 RAM AccessKey（通常 LTAI 開頭），不是 DeepSeek 模型 API Key（sk- 開頭）。
• OpenAPI 調用有頻率設計（5 分鐘緩存）；頻繁點擊強制刷新會增加請求次數，一般日常使用足夠。

社區插件目錄由 SkillHub 等站點維護，與 DeepSeek / 幻方無官方從屬關係；星標與版本以 GitHub 與目錄頁爲準（撰寫時 GitHub 星標爲 0）。

結尾¶

dsh-aliyun-coupon-api 把阿里雲賬戶餘額、代金券與可選的本地「今日消耗」收進 DSH 側邊欄，用官方 OpenAPI 與 RAM 只讀 Key 完成查詢，配置路徑與校驗邏輯在插件設置裏已經串好。需要逐步截圖式教程或故障排除時，以倉庫 README 爲準。

• 社區目錄：https://www.skillhub.cn/plugins/tacotuesday22/dsh-aliyun-coupon-api
• GitHub：https://github.com/tacotuesday22/dsh-aliyun-coupon-api