前言¶
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 和社区目录。
