前言¶
DeepSeek Harness（DSH）通過插件機制擴展功能。對於 OpenCode Zen 的模型列表，官方文檔僅提供 ID，缺乏上下文窗口、輸出限制等元數據，且列表會動態變更。手動維護容易導致配置滯後或錯誤。dsh-opencode-models 插件用於從 opencode.ai 獲取實時模型列表，對比本地配置，並支持通過工具或設置頁面進行添加、刪除和同步。
安裝¶
通過命令行安裝插件：
dsh plugin --profile web add github:wyouwd1/dsh-opencode-models
核心功能¶
該插件提供了以下能力：
- 獲取與比較：
oc_model_status工具按路由抓取實時模型列表，並報告配置數量與在線數量之間的差異。 - 添加模型：
oc_model_add工具用於添加模型條目。如果未提供上下文窗口或最大 Token 數，插件會自動假設爲contextWindow: 128000和maxTokens: 32000。 - 刪除模型：
oc_model_remove工具用於從路由中移除已配置的模型 ID。 - 同步漂移：
oc_model_sync工具用於預覽並應用漂移，或清理過時/下架的模型。 - Web 界面管理：設置頁面頂部固定展示“OpenCode Models”區域，支持批量刪除和同步操作。
典型用法¶
- 檢查當前配置與在線列表的差異：
oc_model_status
- 添加新模型（自動應用默認容量）：
oc_model_add
- 同步漂移並清理過時模型：
oc_model_sync apply pruneStale
配置與注意事項¶
- 無需配置：插件不要求額外的配置鍵。路由遵循官方 OpenCode Zen 端點佈局，認證使用現有的
apiKeyEnv（即PI_AI_API_KEY）。 - 立即生效：模型列表的修改在下一個請求時立即生效，無需重啓 DSH 進程。
- 默認容量假設：對於未知模型，插件默認假設
contextWindow: 128000和maxTokens: 32000。如果假設錯誤，會導致性能下降。僅特定的免費級別模型 ID（如big-pickle,ox-alpha-free）被官方允許。 - 寫入保護：設置頁面的寫入操作受版本控制保護，防止併發寫入衝突。
生態背景¶
DeepSeek Harness 理念是“一切皆插件”。本插件由社區開發者 wyouwd1 維護，託管在 GitHub 和社區目錄。
