前言¶
在 DeepSeek Harness（DSH）裏用 OpenCode Go 或 DeepSeek 官方模型時，額度往往分多個時間窗口，餘額又和 OpenCode 額度不是同一套接口。真正擋住你的經常是 5 小時滾動窗口，而不是月剩餘；要確認還剩多少，通常得切到控制台或設置頁。dsh-opencode-go-usage-badge 在側欄底部放一個只讀小徽標：跟當前對話的模型來源自動切換顯示 OpenCode Go 三窗口額度或 DeepSeek 餘額，不佔佈局、不寫磁盤。
這是什麼¶
dsh-opencode-go-usage-badge 是維護者 Panther-w 發佈的 DSH 客戶端插件（MIT 許可，當前包版本 0.4.2）。它通過 DSH 的 uiSession 讀取當前主視圖會話的 modelSelection，不修改模型或任何設置；在側欄底部摺疊顯示你勾選的額度窗口或餘額數字，展開後可勾選要看的窗口、手動刷新。
社區目錄：skillhub.cn 插件頁。源碼與說明：GitHub 倉庫。
核心功能¶
跟模型來源自動切換¶
插件只識別三個內置 provider id，其他來源顯示灰色「額度 —」，不猜測數字。
| Provider id | 顯示內容 | 前提 |
|---|---|---|
opencode-go |
OpenCode Go 三窗口額度（5h / 1w / 1m） | 在 DSH 中配置 OPENCODE_GO_API_KEY，或登錄 OpenCode Console |
deepseek-account |
DeepSeek 登錄賬號餘額 | 在 DSH「設置 → 賬號與餘額」登錄 |
deepseek-official |
DeepSeek API Key 餘額 | 在 DSH 中配置 DEEPSEEK_API_KEY |
切換對話的模型來源時會立即換源；自定義 provider 別名或改過接口地址的不受支持。
額度窗口與狀態顏色¶
OpenCode Go 的三個窗口各自獨立阻塞。默認摺疊態只顯示你勾選的窗口，順序固定，例如 ● 5h 95% 或 ● 5h 95% · 1w 98%；展開卡可勾選 5h / 1w / 1m，至少保留一個，默認只選 5h，偏好記在瀏覽器 localStorage。
狀態點顏色始終按三個窗口裏最緊的那個上色，即使你隱藏了該窗口；若未顯示的窗口更緊，徽標會加黃色 !，懸停說明是哪個窗口。閾值：高於 20% 綠、6–20% 黃、5% 及以下紅；20% 及以下時數字本身也會變黃/紅。
DeepSeek 官方對話時摺疊顯示如 ● ¥88.00；展開卡可看到總餘額、充值餘額、贈金、數據來源與當前模型；餘額爲 0 或負數時爲紅色。
刷新與緩存¶
頁面可見時每 60 秒刷新；回到前臺、頁面恢復、網絡恢復或切換模型來源時立即刷新。上游結果緩存 30 秒；展開卡的刷新按鈕可繞過緩存。數據超過 5 分鐘會標 !；某次請求失敗時保留該來源上一次成功值；憑據缺失、被拒或退出時清除顯示。
安裝與啓用¶
README 寫明適配 DeepSeek Harness Desktop 0.2.2-rc.1，macOS 實測；Windows / Linux 未做人工實測，CI 會在三平臺跑自動測試。
- 從 Release 下載
dsh-opencode-go-usage-badge-0.4.2.tgz，或準備好本機上的包路徑。 - 在 DSH Desktop 打開「插件 → 添加插件」，輸入 tgz 路徑、倉庫地址或本包絕對路徑；安裝後啓用該 bundle。
- 完全退出並重新打開 DSH Desktop；打開使用上述 provider 的對話，看左下角徽標。
命令行安裝（與 README 一致）：
dsh plugin --profile desktop add /path/to/dsh-opencode-go-usage-badge-0.4.2.tgz
dsh plugin --profile desktop add https://github.com/Panther-w/dsh-opencode-go-usage-badge
卸載：在「插件」頁面移除該插件後重啓 Desktop。
典型用法¶
安裝並重啓後，無需單獨設置頁。在側欄底部掃一眼摺疊數字即可；需要對比多個窗口時點開展開卡勾選 5h / 1w / 1m。若從 OpenCode Go 切到 DeepSeek 官方模型，徽標應自動變爲餘額顯示；未配置對應憑據時，該來源會被清除或無法拉取，需先在 DSH 裏配好 Key 或完成賬號登錄。
設計上是隻讀：瀏覽器只調 DSH 本機同源迴環路由；API Key 與賬號 Token 留在 Host 進程，不由本插件寫入磁盤。無遙測、無診斷上報。
適用場景與注意¶
適合長期在 DSH Desktop 裏交替使用 OpenCode Go 與 DeepSeek 官方模型、又不想頻繁離開對話去查額度或餘額的開發者。插件以當前 DSH 進程權限運行，安裝前建議瀏覽 源碼 與 MIT 許可證。
已知限制（摘自上游說明）：
- 僅支持上述三個內置 provider id；OpenCode Go 與 DeepSeek 餘額接口非公開穩定契約，上游變更可能需要插件適配。
- 依賴 DSH 內部服務與投影字段，DSH 大版本升級後可能需要適配。
- 未配置 Go API Key 時，Host 可能只讀 OpenCode Console 本地憑據
~/.local/share/opencode-console/credential.json（或XDG_DATA_HOME下等價路徑）作兜底；Console 改結構時需插件跟進。
DSH 生態強調「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-opencode-go-usage-badge 把 OpenCode Go 多窗口額度與 DeepSeek 餘額收到側欄一行，跟會話模型來源走，只讀、低額度變色提醒。需要安裝包或 issue 時到 GitHub，在目錄站可查看分類與簡介：Panther-w/dsh-opencode-go-usage-badge。
