前言¶
在 DeepSeek Harness（DSH）裏用 OpenCode Go 訂閱時，額度往往分散在 5 小時、本週、本月幾個窗口裏。若要到網頁或單獨工具裏查用量，會打斷在 Harness 裏的對話節奏。社區插件 dsh-opencode-usage-sidebar 把這三段用量和 5 小時窗口重置倒計時放在桌面側欄底部，與當前會話同屏可見。
下面介紹插件的定位、能力與安裝配置方式。事實以 GitHub 倉庫 README 爲準。
這是什麼¶
dsh-opencode-usage-sidebar 由維護者 AAMMNNZZ 發佈，分類爲客戶端插件。它在 DSH 側欄 footer 注入一張 OpenCode Go 訂閱用量卡片：展示 5 小時 / 本週 / 本月 已用比例，並在標題旁對 5 小時窗口重置做實時倒計時。
插件通過 Cordis patch 注入 @deepseek-ai/dsh-client-ui-sidebar，瀏覽器端僅依賴 Harness 已提供的 react，本地 bundle 無需額外 node_modules。上游用量請求由宿主側發起（opencode.ai 會拒絕來自頁面上下文的同類請求），密鑰不進入瀏覽器。
核心功能¶
用量三行與進度條¶
卡片包含三行：5 小時、本週、本月。每行顯示已用百分比和進度條；用量達到 70% 時進度條偏暖色，達到 90% 時爲紅色。README 中說明的數據刷新時機包括：插件配置的輪詢間隔、每次 assistant 回合結束後，以及窗口重新獲得焦點時。
5 小時窗口倒計時¶
OpenCode 標題旁顯示距 5 小時窗口重置的倒計時（例如 1時58分、42分、42秒），每秒更新；窗口重置時文案切換爲 即將刷新。
可選配置¶
可在 profile patch 或環境變量中覆蓋默認行爲（節選）：
| Row config | 環境變量 | 默認 |
|---|---|---|
endpoint |
DSH_OPENCODE_USAGE_ENDPOINT |
https://opencode.ai/zen/go/v1/usage |
credentialRef |
DSH_OPENCODE_USAGE_CREDENTIAL |
OPENCODE_GO_API_KEY |
pollIntervalSec |
DSH_OPENCODE_USAGE_POLL |
60（最小 15） |
cacheMs |
— | 15000 |
瀏覽器側通過同源路由 /dsh-opencode-usage/api/usage（JSON，帶緩存）和 /dsh-opencode-usage/api/stream（SSE，用於回合結束後喚醒各窗口）拉取展示數據。
安裝與啓用¶
在 DSH 桌面 profile 下從倉庫安裝：
dsh plugin --profile desktop add git+https://github.com/AAMMNNZZ/dsh-opencode-usage-sidebar.git
若使用預構建 tarball，可將路徑換爲本地文件：
dsh plugin --profile desktop add file:/path/to/dsh-opencode-usage-sidebar.tgz
卸載：
dsh plugin --profile desktop remove dsh-opencode-usage-sidebar
安裝前建議瀏覽倉庫源碼並確認 MIT 許可證；插件以當前 dsh 進程權限運行，密鑰解析與上游 GET 均在宿主側完成。
配置 API Key¶
插件在請求時從 DSH 憑證存儲讀取引用 OPENCODE_GO_API_KEY，密鑰不包含在插件包內，也不會進入瀏覽器。
最簡路徑：打開 Settings → Models，爲 opencode-go provider 填寫 API key。這會寫入 ~/.dsh/.credentials.yaml 的 refs: OPENCODE_GO_API_KEY，與插件默認的 credentialRef 一致。
若不使用 opencode-go provider，可手動寫入同一 ref：
# ~/.dsh/.credentials.yaml
refs:
OPENCODE_GO_API_KEY: "<your-key>"
完成安裝與憑證配置後，重啓或刷新 DSH 桌面客戶端，側欄底部應出現用量卡片；若 endpoint 或輪詢間隔需定製，再按上表設置 profile 或環境變量。
適用場景與注意¶
適合已在 DSH 中配置 OpenCode Go、希望在側欄持續觀察三段額度與 5 小時重置時間的開發者。不適合未訂閱 OpenCode Go、或不願在本地憑證文件中保存 API key 的環境。
社區插件目錄站點 skillhub.cn 上的條目 便於檢索與分享，與 DeepSeek / 幻方無官方從屬關係；DSH 生態強調「一切皆插件」，安裝來源以 GitHub 與上述目錄頁爲準。
結尾¶
dsh-opencode-usage-sidebar 把 OpenCode Go 的 5 小時、周、月用量與重置倒計時收進 DSH 側欄 footer，減少離開 Harness 查額度的次數。進一步說明與 issue 見 GitHub 倉庫，目錄頁見 skillhub.cn/plugins/AAMMNNZZ/dsh-opencode-usage-sidebar。
