前言¶
用 DeepSeek Harness（DSH）做智能體或會話開發時，若後端走 OpenDesign 訂閱，額度通常落在控制面：5 小時窗口、7 天窗口、錢包餘額等。推理用的 sk-amr_… 密鑰無法查詢這些額度；控制面 vela_ctrl_… 也不會出現在網頁上，需要走與 vela login 類似的 CLI 設備授權。若只在 OpenDesign 控制台或 CLI 裏零散查看，和 DSH Web 裏的開發節奏容易脫節。
下面介紹社區插件 dsh-od-quota（維護者 WuWei-Peng，GitHub WuWei-Peng/dsh-od-quota）。它是非官方插件，與 Open Design / Powerformer 無隸屬關係，僅通過公開控制面接口讀取你自己賬號的 allowance，並在 DSH Web 客戶端提供側邊欄頁面、設置摘要和會話頂欄進度條，三處 UI 共用同一份讀數。
這是什麼¶
dsh-od-quota 是 DSH 的 Web 客戶端插件（分類：客戶端）。npm 包名 dsh-od-quota，當前資料中版本 0.1.5，許可證 MIT。插件從 OpenDesign 控制面（主機 amr-api.open-design.ai，密鑰前綴 vela_ctrl_…）讀取 plan、錢包、5h/7d 窗口等信息；模型面 amr-link.open-design.ai/v1 的 sk-amr_… 不能讀額度，UI 也會拒絕粘貼該類密鑰。
核心功能¶
三處界面解析同一份 Host 寫入的 quotaJson：
| 入口 | 位置 | 作用 |
|---|---|---|
| 額度頁 | 左側欄「OpenDesign Quota」圖標 → 居中全頁 | 5 小時 / 7 天窗口、錢包、登錄與授權 |
| 設置摘要 | 設置側欄「OpenDesign Quota」 | 狀態、兩條迷你進度條、刷新 / 打開頁面、自動刷新與頂欄開關 |
| 頂欄計量 | 會話標題欄右側（「在應用中打開」箭頭左側） | 套餐名 + 兩條剩餘條；空間不足時逐級收縮；點擊打開額度頁 |
進度條按剩餘百分比着色（綠 / 琥珀 / 紅）；數據過期時會變暗，tooltip 說明原因。額度頁爲全高滾動、內容寬約 960px，兩張大卡展示 5h/7d 百分比、8px 條、剩餘/上限金額與重置倒計時，錢包單獨一張卡；頁腳顯示讀取時間與 powered by dsh 標識。頂欄計量高度 28px，隨標題行可用寬度在 full → compact → mini → hidden 間切換。文案隨 DSH 語言設置（設置 → 通用 → Language）切換，中英 copy 在 client.js 的 COPY 表中。
Host 側（index.js）負責設備授權、調用 billing/preflight 與 billing/summary、默認每 60 秒輪詢一次，並寫回配置；手動刷新通過寫入 refreshNonce 觸發立即讀取。
安裝與啓用¶
安裝後需 重啓一次 dsh web，左側欄會出現 OpenDesign Quota 圖標，設置裏會出現對應摘要項。
資料中的安裝方式如下（均需 --profile web）：
# npm（推薦；插件市場同樣路徑）
dsh plugin --profile web add dsh-od-quota
# 或直接從倉庫
dsh plugin --profile web add github:WuWei-Peng/dsh-od-quota
# 或 GitHub Release 預構建包（無 npm；適合受限網絡/鏡像）
dsh plugin --profile web add https://github.com/WuWei-Peng/dsh-od-quota/releases/latest/download/dsh-od-quota.tgz
package.json 要求 Node ^22.19.0 || >=24.0.0，DSH >=0.2.0-rc.1。
典型用法¶
首次連接（設備授權）¶
- 打開額度頁或設置摘要且尚未配置密鑰時，插件請求
POST /api/v1/cli/device-authorizations，頁面展示 6 位碼、倒計時和可複製的批准鏈接。 - 在瀏覽器登錄 OpenDesign 並批准；插件輪詢得到
controlKey，默認存入 DSH 憑證服務，引用名OPENDESIGN_CONTROL_KEY（可用配置項keyRef修改）。 - 之後約每 60 秒讀取一次並更新
quotaJson；三處 UI 只讀該字段。
也可在 UI 中直接粘貼 vela_ctrl_…；粘貼 sk-amr_… 會被拒絕並說明原因。
設置與刷新¶
在設置摘要中可開關 autoRefresh（60 秒讀一次）和 enabled（關閉則停止輪詢、隱藏頂欄、額度頁顯示禁用說明）。點擊刷新會寫入 refreshNonce；若 Host 拒絕寫入，會提示重試而非無響應按鈕。
配置項（節選）¶
| 字段 | 默認 | 說明 |
|---|---|---|
enabled |
true |
關閉：不輪詢、無頂欄、頁面不可用 |
keyRef |
OPENDESIGN_CONTROL_KEY |
存放控制面密鑰的憑證引用 |
workspaceId |
'' |
空則通過 /workspaces/current 解析 |
autoRefresh |
true |
每 60 秒讀取 |
refreshNonce |
'' |
由頁面刷新按鈕寫入 |
quotaJson / loginJson |
'' |
插件寫入的緩存，頁面只讀 |
適用場景與注意¶
適合誰：在 DSH Web 中長期使用 OpenDesign 訂閱、需要隨時看 5h/7d 與錢包、又不想單獨開控制台或反覆跑 CLI 的開發者。
運行與信任：插件以當前 dsh 進程權限 運行，會訪問控制面 API 並將密鑰存入 DSH 憑證服務。安裝前請自行查看 倉庫源碼 與 MIT 許可證；社區目錄 skillhub.cn 條目 與 DeepSeek / 幻方無官方從屬，DSH 生態是「一切皆插件」的獨立社區形態。
失敗與限制（資料原文要點）：
- 曾有成功讀數時網絡失敗：保留上次數字並標
stale，不會誤報「已登出」。 - 從未成功：顯示未連接及具體錯誤，而非 0%。
- 控制面 401：最多每 5 分鐘自動重登一次，避免輪詢變成授權風暴。
- 控制面 API 爲私有契約，字段變更時頁面與日誌會反映失敗（日誌記字段名不記值），插件不僞造數字。
- 若 Host 超過 3 分鐘無新讀數，頁面與設置會提示 Host 可能未在輪詢；常見原因是運行中改動了安裝目錄或配置導致 Host 半卸載，需重啓
dsh web。
問題反饋： GitHub Issues，或郵件 18728030920@163.com。
結尾¶
經過上面的步驟，你可以在 DSH 會話開發同一界面裏看到 OpenDesign 訂閱額度與頂欄餘量，減少在控制台與 Harness 之間切換。更多信息見目錄頁 skillhub.cn/plugins/WuWei-Peng/dsh-od-quota 與 GitHub WuWei-Peng/dsh-od-quota。
