前言¶

在 DeepSeek Harness 裏跑智能體、對接 OpenCode Go 時，訂閱額度往往要另開控制台或查文檔才能對齊「5 小時滾動 / 每週 / 每月」還剩多少。官方底欄已有會話統計、Token 用量等藥丸，但不會直接展示 OpenCode Go 的三段額度比例。

社區插件 dsh-opencode-quota（倉庫內包名 dsh-opencode-quota-full）把 OpenCode Go 的已用百分比掛進 conversation.composer.dock 同一行，不另佔一條狀態欄，也不把 API key 下發到瀏覽器。下面介紹它的定位、安裝與配置。

這是什麼¶

一句話：在 Harness 輸入框下方官方狀態行最左側增加一個藥丸，顯示 5 小時（rolling）/ 每週 / 每月 的已用百分比；點擊可展開詳情浮層。

核心功能¶

底欄展示與交互（均來自倉庫 README）：

• 藥丸示例文案形態：◔ 5小時 3% · 每週 1% · 每月 0%
• 百分比爲已用比例；顏色：綠 < 60%、黃 < 85%、紅 ≥ 85%
• 點擊藥丸展開 StatDialog 風格浮層：各窗口已用 %、剩餘 %、重置時間、進度條
• 浮層可「刷新」、或跳轉 OpenCode Console；Esc 或點擊外部關閉
• 每 60 秒自動刷新，頁面重新可見時立即刷新；樣式使用宿主主題 token，淺色 / 深色適配

數據與安全：

• 瀏覽器通過同源 GET /opencode-quota/stats 拉取（帶 Harness 登錄 cookie）
• Host 半在進程內解析 OPENCODE_GO_API_KEY，再請求 https://opencode.ai/inference/go/v1/usage；API key 不進入瀏覽器
• 成功結果 Host 內緩存 30 秒（可配置），併發合併爲一次上游調用；失敗不緩存
• 上游只返回百分比，插件不做美元換算

上游 usage 中 rolling 對應 5 小時滾動窗口，weekly / monthly 分別爲每週、每月。

插件以最小 order 併入官方 dock，不遮擋聊天區；僅在帶 Web 服務的 profile（desktop / web）生效。

安裝與啓用¶

插件是 DSH bundle（dsh.bundle.patch + dsh.client），倉庫根目錄即包目錄，無構建步驟。

從 GitHub 安裝：

dsh plugin --profile desktop add github:wang-yzh/dsh-opencode-quota

若本地已有源碼目錄，可同時爲 desktop / web 添加：

dsh plugin --profile desktop add /path/to/dsh-opencode-quota-full
dsh plugin --profile web add /path/to/dsh-opencode-quota-full

也可在 Harness 設置 → 插件 中用插件管理器安裝本地目錄或倉庫地址。

安裝後需要刷新頁面，以便瀏覽器 bundle 重新發布。

卸載並重裝示例（開發調試用）：

dsh plugin --profile desktop remove dsh-opencode-quota-full
dsh plugin --profile desktop add /path/to/dsh-opencode-quota-full

說明：package.json 中聲明與 DeepSeek Harness 0.2.2-rc.1 兼容；README 記載在該版本 Windows + 官方 desktop profile 上完成驗證。

配置¶

在 profile 的 cordis.patch.yml 中可選覆蓋 opencode-quota 條目：

- id: opencode-quota
  config:
    credentialRef: OPENCODE_GO_API_KEY
    apiBaseUrl: https://opencode.ai/inference/go/v1
    cacheMs: 30000

憑據寫入 ~/.dsh/.credentials.yaml，或通過 設置 → 模型 / 憑據：

OPENCODE_GO_API_KEY: oc_sk_...

cacheMs 最小 1000（毫秒）。

典型用法¶

1. 按上一節安裝插件並配置 OPENCODE_GO_API_KEY。
2. 刷新 Harness 頁面，進入已有會話（底欄 dock 與官方藥丸一樣，新建會話首屏可能不顯示）。
3. 看狀態行最左側藥丸上的三段百分比；顏色反映已用比例是否接近上限。
4. 點擊藥丸查看各窗口剩餘 % 與 resetsAt；需要即時數據時點「刷新」。

未登錄訪問 /opencode-quota/stats 會返回 401；憑據錯誤或上游失敗時，失敗結果不會被 Host 緩存。

適用場景與注意¶

適合誰：在 Harness desktop / web 里長期使用 OpenCode Go，希望在寫 prompt 時一眼看到三段額度，而不是頻繁切到控制台。

限制（README 已知）：

• headless profile 不註冊路由
• 官方接口無金額字段，插件不提供金額換算
• 上游若只返回部分窗口，界面只渲染已返回項，不整體報錯

安全與權限：插件 Host 半在 當前 DSH 進程權限 下運行，並會代表你調用 OpenCode 用量 API。安裝前建議閱讀倉庫源碼與 LICENSE（Host 查詢結構參考 dsh-plugin-opencode-usage）。社區目錄 SkillHub 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

dsh-opencode-quota 把 OpenCode Go 的 5 小時 / 每週 / 每月已用百分比嵌入 Harness 官方底欄，API key 留在 Host，瀏覽器只拿百分比。需要進一步細節或提 issue，見 GitHub：https://github.com/wang-yzh/dsh-opencode-quota ；目錄收錄：https://www.skillhub.cn/plugins/wang-yzh/dsh-opencode-quota 。