dsh-opg-usage：在 DSH 界面裏實時查看 OpenCode Go 套餐額度

前言¶

用 OpenCode Go 套餐跑任務，額度還剩多少、什麼時候重置，通常得離開當前界面去別處查。查一次不夠，還得記住上次查的時間估算消耗，稍不留神就撞上限制。

dsh-opg-usage 解決的就是這個問題：把額度面板直接掛進 DSH 的界面裏，常駐一個浮動膠囊，隨看隨刷。下面介紹它的功能、安裝和使用方式。

這是什麼¶

dsh-opg-usage 是一個 DSH Web 插件，由 M4sh1r0-444 維護，MIT 許可證。它是一個可拖拽、可收縮的浮動膠囊，展示 OpenCode Go 套餐在滾動窗口、本週、本月三個額度窗口下的已用百分比、剩餘百分比與重置倒計時。

插件分 Host 和 Client 兩半：Host 半註冊本地 API 路由，負責讀憑據、請求 OpenCode 官方額度接口並返回歸一化 JSON；Client 半註冊到 Web 客戶端的 shell.overlay 槽位，輪詢該路由並渲染膠囊。

核心功能¶

插件提供的能力如下，均已寫入 README：

1、右上角浮動膠囊，默認顯示 Go · 周 X% · 月 Y%，用綠/黃/紅圓點提示額度健康度——已用超過 50% 變黃，超過 80% 變紅。

2、點擊膠囊展開完整面板，可以看到三個窗口的已用/剩餘百分比、進度條、狀態徽章和重置倒計時。

3、按住膠囊或面板標題欄可以自由拖拽位置，位置自動限制在視口內，不會被拖出屏幕。

4、每 60 秒自動刷新一次，也支持通過 ⟳ 按鈕手動刷新；連接異常時顯示具體原因，並可重試。

5、面板浮於所有界面之上，包括展開的 better-sidebar 右側面板——它註冊的 shell.overlay 層級已抬升。

6、淺色 / 深色主題自適應，使用 DSH 主題 token，不需要手動切換配色。

安裝與啓用¶

這個插件沒有 dsh plugin add 之類的命令，安裝方式是手動編輯 DSH web profile 的 package.json，添加 github 依賴並登記 bundles：

{
  "dependencies": {
    "dsh-opg-usage": "github:M4sh1r0-444/dsh-opg-usage"
  },
  "dsh": {
    "profile": {
      "bundles": [ "...", "dsh-opg-usage" ]
    }
  }
}

文件路徑爲 ~/.dsh/profiles/<name>/package.json，其中 <name> 換成你自己的 profile 名。

然後執行安裝並重啓：

cd ~/.dsh/profiles/<name>
pnpm install
# 重啓 DSH

插件會自動掛載宿主端並接入 Web 客戶端，無需其它配置。當前版本爲 0.1.0，要求 Node >= 18。插件是純 JavaScript，沒有構建步驟，也沒有第三方運行時依賴，宿主側只用到 Node 內置的 fetch。

典型用法¶

裝好重啓後，日常操作只有幾個動作：

膠囊：點擊展開 / 收起；按住拖動調整位置
面板：點 ⟳ 手動刷新；點「收起」摺疊回膠囊

數據來自 OpenCode 官方額度接口 https://opencode.ai/zen/go/v1/usage。憑據方面，插件自動讀取 ~/.local/share/opencode/auth.json 中的 opencode-go 項（sk- 開頭的 API key），不需要手動配置。

展開面板後看到的三個窗口對應 Host 半返回的 rolling / weekly / monthly 字段，每個窗口帶 percent、remaining 和 resetsAt。

適用場景與注意¶

適合同時用 DSH 和 OpenCode Go 套餐、想在跑任務時不離開界面就掌握額度餘量的用戶。如果你需要在額度緊張時決定任務節奏，常駐膠囊加 60 秒自動刷新基本夠用。

安裝前有幾點值得確認：

1、插件以當前 dsh 進程的權限運行，會讀取本地的 auth.json 並向 opencode.ai 發請求。安裝前建議先查看倉庫源碼，確認行爲符合預期。許可證爲 MIT，README 與 package.json 均有標明。

2、隱私方面，README 寫明所有請求在本機完成：Host 進程直接請求 opencode.ai，不經過任何第三方；API key 僅用於請求 OpenCode 官方接口，不寫日誌、不上傳。

3、插件依賴 shell.overlay 槽位，與 better-sidebar 同屏使用時層級已抬升，面板不會被遮擋。

結尾¶

dsh-opg-usage 做的事情很集中：把 OpenCode Go 的額度數據變成一個常駐、可拖拽、自動刷新的界面元素，安裝只改一個 profile 文件。如果你在用這個套餐，值得一試。

GitHub 倉庫：https://github.com/M4sh1r0-444/dsh-opg-usage
社區目錄頁：https://www.skillhub.cn/plugins/M4sh1r0-444/dsh-opg-usage

需要說明，社區目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係。