前言¶

在 DeepSeek Harness（DSH）裏使用 OpenCode GO 套餐時，5 小時滾動、本週、本月三個額度窗口往往在官網或設置頁才能看到。頻繁切頁面不適合寫代碼、跑智能體的節奏。社區插件 @skyrocks/dsh-go-quota（倉庫 skyrocks/dsh-go-quota）把這三段用量放到對話輸入框下方的 dock：標籤、迷你進度條、百分比；懸浮可看重置倒計時，點擊可立即刷新。下文按定位、功能、安裝、配置與注意點說明用法。

這是什麼¶

• 定位：DSH 客戶端插件，包名 @skyrocks/dsh-go-quota，插件行 id 爲 go-quota。
• 維護者：skyrocks（MIT 許可證；當前包版本 0.1.9，以 package.json 爲準）。
• 目錄頁：skillhub.cn/plugins/skyrocks/dsh-go-quota（社區目錄，與 DeepSeek / 幻方無官方從屬關係）。
• 解決的問題：在 DSH 內只讀展示 OpenCode GO 套餐用量，不必單獨打開 OpenCode 站點；當前會話 provider 不是 opencode-go 時整條隱藏，避免干擾其它模型。

核心功能¶

下列能力均來自項目 README 與實現說明，已覈實要點如下。

三窗口展示與交互¶

1. 常駐顯示 5 小時 / 本週 / 本月 三個窗口：進度條表示已用比例，旁路百分比數字。
2. 閾值變色：已用 <80% 爲綠（#6bd586），≥80% 琥珀，≥90% 紅。
3. 懸浮展開詳情與重置倒計時；點擊（或 Enter / 空格）強制刷新；客戶端約每 5 分鐘自動 read()。
4. 掛載在槽位 conversation.composer.dock 的最後（上下文百分比之後）。

憑據與請求（Host 側）¶

1. 只讀當前 DSH 配置裏的 opencode-go 憑據引用（經 settings.describe() 與 ctx.credentials.resolve()），不讀 auth.json，不掃描無關環境變量；Key 僅在 Host 進程內用於請求，不進瀏覽器。
2. 默認請求 GET https://opencode.ai/zen/go/v1/usage，Authorization: Bearer <key>；Host 側約 45 秒緩存，刷新會繞過緩存。
3. 零運行時依賴（README 標明 runtime deps 爲 0）；純 ESM + 瀏覽器 bundle，無原生模塊。

環境與兼容¶

不支持 DSH 0.1.x；0.3.x 需 engines.dsh 放行且接口可能變化。

安裝與啓用¶

插件以當前 DSH 進程權限運行；安裝前可在 GitHub 查看源碼與 MIT 許可證。安裝命令須使用資料原文，勿自行拼接錯誤形式。

圖形界面（推薦）¶

1. 打開 DSH 桌面端，進入 設置 → 插件。
2. 點「添加插件」，在彈窗粘貼：

github:skyrocks/dsh-go-quota

3. 確認安裝，等待依賴解析完成。
4. 完全退出 DSH 再重新打開（macOS Cmd+Q；Windows 從托盤退出）。只關窗口不夠，Host 插件僅在啓動時加載。
5. 在對話中選擇 opencode-go 模型，輸入框下方應出現 GO 5h … · 周 … · 月 …。

列表中顯示 @skyrocks/dsh-go-quota（id go-quota）。若曾裝過 0.1.8 及更早的 dsh-go-quota，需先移除舊包再裝新包，避免同 id 衝突。

命令行（可選）¶

桌面版 profile 示例：

dsh plugin --profile desktop add github:skyrocks/dsh-go-quota

使用 dsh web 時將 --profile desktop 換成 --profile web。安裝後同樣需要完全退出並重啓 DSH。

其它來源（tarball、本地絕對路徑目錄）見倉庫 README「其他安裝來源」；Windows 目錄安裝宜用 file:C:\... 或 tarball，避免 link: 盤符問題。

配置（可選）¶

包內 cordis.patch.yml 自帶默認值，一般無需修改。覆蓋時在用戶層寫入同 id 配置，例如桌面 profile：

路徑：~/.dsh/profiles/desktop/cordis.patch.yml

- id: go-quota
  config:
    baseUrl: https://opencode.ai/zen/go/v1/usage
    timeoutMs: 15000   # 單次請求超時（毫秒）
    cacheMs: 45000     # Host 側緩存（毫秒）；點擊刷新會繞過

修改後需重啓 DSH。

典型用法¶

1. 在 DSH 中配置好 OpenCode GO 的 apiKeyEnv（「設置 → 模型」或 llm-pi-ai 的 providers["opencode-go"]）。
2. 安裝插件並重啓後，選用 opencode-go 模型開始對話。
3. 看輸入框下方三條進度：快速判斷本週 / 本月是否接近上限；臨近 80% / 90% 時顏色會變琥珀 / 紅。
4. 需要最新數據時點擊 dock 區域刷新，不必等 5 分鐘輪詢。

常見錯誤提示與處理（如「GO 未配置」「401」「403」）見倉庫 README「常見問題」表。

適用場景與注意¶

適合誰：長期用 DSH + OpenCode GO、希望在寫 prompt 時一眼看到三窗口額度的開發者。

務必注意：

• 插件請求出站用量接口，Key 解析依賴你本地的 DSH 配置與憑據存儲；安裝前應自行審閱 GitHub 倉庫 源碼。
• 官方接口主要返回賬戶級百分比，無按模型 / 設備明細；界面只顯示百分比，不顯示剩餘金額，避免誤讀名義套餐價。
• 用量接口未公開穩定文檔，可能變更；若 baseUrl 或字段變化，可改配置或向維護者提 issue。
• DSH 生態理念是「一切皆插件」；本插件與 DeepSeek、OpenCode 均無隸屬關係。

結尾¶

dsh-go-quota 把 OpenCode GO 的 5 小時 / 周 / 月額度收到輸入框下方，只在對 opencode-go 會話時顯示，並儘量把 Key 留在 Host。需要安裝指引與架構圖時，以倉庫 README 爲準。

• 目錄頁：https://www.skillhub.cn/plugins/skyrocks/dsh-go-quota
• GitHub：https://github.com/skyrocks/dsh-go-quota