前言¶
DeepSeek Harness（DSH）內置的 pi-ai 模型目錄會隨發行版更新，往往落後於 OpenCode Go、OpenCode Zen 以及原生 OpenAI Codex 線上可用的模型列表。若只依賴內置目錄，設置裏可能選不到新模型，或仍保留已下線的條目。手動改配置或等待 DSH 發版合併目錄，對日常開發都不方便。
下面介紹社區插件 dsh-opencode-live-models（維護者 Luca4Don3，分類：模型推理）。它在運行時刷新上述三條路線的模型目錄，並在不破壞 OpenCode 會話頭與 prompt-cache 保留策略的前提下合併到 DSH；同時把 ChatGPT 登錄、訂閱用量與 OpenCode Zen 餘額查詢收進同一插件，減少單獨裝「訂閱用量」類 bundle 的重複。
這是什麼¶
dsh-opencode-live-models 是一個 DSH 插件 bundle，當前版本 0.11.3（MIT 許可證）。它面向已在 DSH 裏使用 pi-ai 與 OpenCode / Codex 路線的開發者，解決「內置目錄滯後」和「模型選擇與賬號側信息分散」兩類問題。
插件要求 DSH 0.1.5-rc.1 或更新，且插件自身需 0.3.0 或更新（0.3.0 起不再內置模型描述符；無網絡首次啓動時，相比舊版會少列出一個僅依賴 bundled 描述的模型 space-bunny-free，詳見倉庫 README 的 How it works）。
核心功能¶
實時模型目錄¶
- OpenCode Go（
opencode-go）與 OpenCode Zen（opencode）各自從 Pi catalog 與 live roster 刷新，協議表獨立；一條網關故障不會影響另一條目錄。 - 原生 OpenAI Codex（
openai-codex）同樣走目錄更新與校驗、ETag、緩存與生命週期機制；Codex 仍使用原生 OAuth 與傳輸，不會注入 OpenCode 頭或覆蓋 cache 選項。 - 與 DSH 原生 Settings → Models → Fetch available models 及已保存模型選擇集成；支持 API Key 與 OAuth 路線。0.11.x 起在 live 描述符補全缺失 API 時會同步更新運行時診斷與 Models 設置中的錯誤展示。
登錄與訂閱 / 餘額（只讀）¶
- 在側邊欄 Plugins → dsh-opencode-live-models 詳情頁：Sign in with ChatGPT、重新登錄、授權狀態、回調粘貼兜底與取消。
- 同一詳情頁可 登錄 OpenCode Console（設備授權，文檔化流程僅使用
https://opencode.ai/console/auth/device/*）；Zen 計費優先 Console 工作區登錄，無 Console 授權時纔回退 API Key，過期授權不會靜默換 key 或工作區。 - Settings → Account & balance：在官方 DeepSeek 餘額下方展示已配置憑據的訂閱信息（最多三個 provider、不重複 DeepSeek 卡片）。OpenAI 與 OpenCode Go 以百分比卡片優先展示；OpenCode Zen 以全寬貨幣餘額行放在底部。進入頁面加載，可點 Refresh usage；顯示剩餘配額百分比與重置時間，不把配額換算成金額。結果本地緩存，完全退出 DSH（如 Command+Q）後仍可在下次啓動先看到上次數據再在後臺校驗憑據。
從獨立插件 dsh-subscription-usage 升級時，應先禁用舊 bundle 再啓用本插件，避免重複服務；已有 llm-pi-ai/openai-codex 與 subscriptionUsage 相關憑據可繼續使用。
安裝與啓用¶
安裝 spec 從 codeload.github.com 經 HTTPS 下載，主機需能訪問 GitHub（npm 鏡像不代理該 spec）。
桌面端：側邊欄打開 Plugins，Add plugin，粘貼 spec，選擇 Enable now 並重啓 DSH：
github:Luca4Don3/dsh-opencode-live-models
CLI：add 會安裝並選中 bundle，需重啓 DSH 以完成 compose：
dsh plugin --profile desktop add github:Luca4Don3/dsh-opencode-live-models
典型用法¶
1. 刷新並選擇模型¶
- 確認 DSH 中已配置相應 provider（Codex 需在
llm-pi-aiproviders 裏已有openai-codex）。 - 打開 Settings → Models，使用 Fetch available models，按需勾選模型並保存；取消勾選後需應用選擇並保存才能從目錄中移除條目（0.11.2 起修復「僅增不減」的問題）。
- Go 路線使用既有憑據引用
OPENCODE_GO_API_KEY；Zen 使用OPENCODE_API_KEY。OAuth 與 token 刷新由宿主處理，插件不自行實現 OAuth 或另存一套憑據。
2. ChatGPT 與 Console 登錄¶
- Plugins → dsh-opencode-live-models 詳情頁完成 ChatGPT 或 OpenCode Console 登錄。
- Console 登錄後在設備授權頁選擇與你的 Zen key 對應的工作區。
- 到 Settings → Account & balance 查看或 Refresh usage；Zen 餘額依賴 Console 或 API Key 策略如上。
3. 可選配置¶
在 opencode-live-models 插件條目下可寫：
config:
freshMs: 300000
timeoutMs: 15000
goApiKeyRef: OPENCODE_GO_API_KEY
zenApiKeyRef: OPENCODE_API_KEY
freshMs 默認五分鐘，控制同一次運行內用量卡片的新鮮度；Refresh usage 會強制重新查詢。
適用場景與注意¶
適合：在 DSH 里長期用 OpenCode Go、OpenCode Zen 或 Codex，希望模型列表與上游一致，並在同一處查看 ChatGPT / Go 訂閱用量與 Zen 餘額的開發者。
注意：
- 插件在 當前 DSH 進程權限 下運行；安裝前應在 GitHub 閱讀源碼與 MIT 許可證，自行評估信任邊界。
- 禁用插件會取消進行中的設備授權與計費請求；卸載時會中止進行中的目錄請求（0.6.0 起）。
- 社區目錄 SkillHub 插件頁 與 GitHub 倉庫 爲獨立信息源，與 DeepSeek / 幻方無官方從屬關係；DSH 生態遵循「一切皆插件」思路，以倉庫 README 與版本說明爲準。
結尾¶
dsh-opencode-live-models 把 OpenCode Go、OpenCode Zen 與 Codex 的 live 模型目錄、原生模型選擇，以及 ChatGPT / Console 登錄與只讀用量展示合併到一個 bundle，減少等 pi-ai 內置目錄更新的空窗。需要安裝 spec、變更日誌與細節時，請直接查閱 GitHub README 與 SkillHub 目錄頁。
