dsh-gateway-models
只有宿主半边的插件：给网关路由（OpenCode Go + Command Code）补齐引擎拿不到的协议、地址与模型清单，并给发往 OpenCode 的请求附加会话头。
它做什么
- 给
opencode-go路由声明 wire 协议（api: openai-completions），目录外的模型不再报needs an api。 - 启动时读引擎自己的模型目录，把 DeepSeek V4.1 模型补进
opencode-go清单并排到第一位（你自己配过的条目原样保留、顺序不变）。 - 路由没有
baseURL时补上https://opencode.ai/zen/go/v1；你已经配过的地址一个字节都不动。 - 给
commandcode路由声明api与baseURL（你只填密钥，不用填地址），并从它公开的目录接口补齐模型清单（只增不改、幂等）。 - 给发往 OpenCode / OpenCode Go 路由的请求附加
x-opencode-session：默认每个会话一个随机 UUID，绝不把内部会话 ID 发给第三方（mode: 'session-id'是显式可选）。
安装
- 用 DSH Ready GUI（推荐）：插件随 GUI 内置，打开 GUI → 设置窗口 →「第三方插件」勾选网关路由，装完按提示重启引擎（它没有页面半边）。
- 其它 DSH 宿主（
dsh web/ CLI）—— 任选一条：
# 推荐：直接从 GitHub 装
dsh plugin --profile web add github:itchenshi/dsh-gateway-models
# 备选：从本仓库 Release 的 tarball 装
dsh plugin --profile web add https://github.com/itchenshi/dsh-gateway-models/releases/download/v0.2.6/dsh-gateway-models-0.2.6.tgz
两条命令装到的都是这个仓库的完整内容（含 cordis.patch.yml），装完不需要额外配置。
> 本包还不在 npm 上（registry.npmjs.org 查无此包），只能用上面两种方式装。
使用
没有页面半边，也不需要打开任何界面 —— 重启引擎后它在装配层改配置。你可以在模型选择器里确认：第一项是 DeepSeek V4.1 Flash，llm-pi-ai.providers.opencode-go 里它排在第一位。
Command Code 那一半只对你自己配置过的路由（用户层里有它，比如填过密钥）动手，并按接口地址（api.commandcode.ai）识别路由 —— 路由名叫 commandcode、commandcode-goat 还是别的都行。
配置
cordis.patch.yml 里 id: opencode-go 这一行的 config，全部可选：
| 键 | 默认 | 说明 |
|---|---|---|
providers |
[opencode, opencode-go] |
附加会话头的路由名；自定义路由名时加进来 |
commandcodeProviders |
无 | 额外的 Command Code 路由 id；仅当某条路由的地址在配置里看不到时才要填 |
mode |
uuid |
uuid = 每会话随机 UUID（安全默认）；session-id = 发送内部会话 ID |
debug |
false |
true 时记录每个收到会话头的流式调用 |
debugFile |
无 | 追加 JSON 日志的路径；仅 $DSH_HOME/logs 或系统临时目录下的路径生效，超过 8 MiB 停止追加 |
兼容性
- 需要 DSH >= 0.2.0-rc.2（引擎 0.2.0 更换了设置服务 API，0.1.x 上无法写入路由配置）。
- Node >= 20。
- 依赖的是引擎装配层、
settings服务与llm事件的公开契约；契约变了引擎会在启动时显式报插件加载失败，而不是静默失效。
常见问题
V4.1 模型没出现？ 看宿主启动日志有没有 [gateway-models] active for providers [opencode, opencode-go] with mode uuid (debug=off)。如果打的是 llm.discoverModels() is unavailable 或 could not detect the "opencode-go" model catalog，说明引擎目录读不到 —— 这时插件跳过自动补模型，而不是猜。
Command Code 的模型列表没补齐？ 正常会打 [gateway-models] "commandcode": N model(s) from the provider catalog (list X -> Y)；如果打的是 could not read the Command Code model catalog (...)，说明那次公开目录请求失败了，插件保持原列表不动。
它会读我的 API key 吗？ 不会。插件只写路由配置，密钥始终由引擎按 apiKeyEnv 自己解析。唯一出站请求是 GET https://api.commandcode.ai/provider/v1/models（公开、不需要 key、请求里不发 Authorization）。它也不注册任何本机 HTTP 路由。
写配置失败会留下半份吗？ 不会。写入走 settings 服务，会重跑引擎的严格校验，校验不过整笔拒绝（日志给出原因）。
开发
node --check lib/index.js
npm test # node tests/test.mjs：本地行为测试（不联网、不需要引擎）
新增 V4.1 型号只需往 V4_1_MODELS 里加一条；planRouteUpdate() / withV41ModelsFirst() / withV41Defaults() / isV41() 分别负责「写什么」「怎么置顶」「怎么补字段」「是不是 v4.1」，都有单测。
许可
MIT
