模型接入 ilmilm/dsh-model-connect

dsh-model-connect · 模型接入

给 DeepSeek Harness（下称 DSH）Web 界面左侧边栏加一个「模型接入」面板：在图形界面里填写第三方 OpenAI / Anthropic 兼容 端点与 API Key，探测该端点提供的模型列表，保存成 dsh-llm-pi-ai 的 provider 路由，随后就能在模型选择器里直接使用。

A sidebar panel for the DeepSeek Harness Web UI: fill in a third-party
OpenAI / Anthropic compatible endpoint and its API key, probe the endpoint's
model catalog, and save it as a dsh-llm-pi-ai provider route — no YAML editing, no cordis.yml surgery, no restart.

不需要改 cordis.yml、不需要手写 providers YAML、不需要重启 DSH。

功能

- 侧边栏入口：左侧 model-connect 图标 → 主区域整页面板（与内置 Plugins / Schedule / SSH 行同一套 shell 插槽）。
- 协议支持：openai-completions（/chat/completions）、openai-responses（/responses）、anthropic-messages（/v1/messages）。
- 模型探测：填好 Base URL 与 Key，点「探测模型」即调用 LLM 服务的 discoverModels 拿回模型清单，自动回填模型 ID。
- 路由保存：写入 llm-pi-ai 命名空间的 providers.<route>，规则与官方 Models 设置页完全一致（providers 是易变字段）。
- Key 安全：API Key 只写进 credentials 服务，引用名形如 <ROUTE>_API_KEY，不会落进 cordis.patch.yml。
- 模型能力：保存时统一写入每个模型条目的上下文窗口、最大输出、输入模态与推理强度（默认 1M / 128K / text+image / high），不再吃适配器兜底值。
- 编辑 / 删除：已有路由可原地改写 Base URL、协议、模型集合；删除时可选择是否连带清除凭据。
- 原生观感：全部使用 --dsw-alias- 设计令牌，跟随主题与深浅色；中英文按当前 locale 自动切换。

目录结构

model-connect/
├── index.js # Host 半：loopback 路由（state / probe / save / remove）+ settings/credentials 写入 ├── client.js # 浏览器半：侧边栏行 + 主区域页面（纯 JS，无构建步骤，React 由模块表提供） ├── cordis.patch.yml # bundle 补丁：把自己 insert 进 Loader 组合 ├── package.json # 清单：exports / files / dsh.bundle / dsh.client.inject ├── locale/ │ ├── zh.json # 面板元信息（中文） │ └── en.json # 面板元信息（英文） ├── icon.svg # 侧边栏图标 └── tools/push-api.ps1 # 无 git 二进制时的 REST 发布脚本

安装

方式一：本地链接（开发 / 自用）

git clone https://github.com/ilmilm/dsh-model-connect.git C:\path\to\model-connect
dsh plugin --profile desktop add C:\path\to\model-connect

然后在 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 数组里追加一项：

"@local/dsh-model-connect"

重启 DSH（或重新加载 profile）后，左侧边栏出现「模型接入」。

方式二：手动登记

1. 把仓库放到任意目录；
2. 编辑 ~/.dsh/profiles/<profile>/package.json：

{
"dependencies": {
"@local/dsh-model-connect": "link:C:/path/to/model-connect"
},
"dsh": {
"profile": {
"bundles": ["...", "@local/dsh-model-connect"]
}
}
}

3. 在 profile 目录执行 pnpm install，重启 DSH。

包名保持 @local/dsh-model-connect（不是发布到 npm 的包），@local/ 作用域配合 link: 依赖即可解析。

使用

1. 左侧点「模型接入」；
2. 填 提供方 ID（如 myrelay，只能字母数字点下划线连字符）、显示名、Base URL（如 https://api.example.com/v1）、协议；
3. 填 API Key，点「探测模型」；
4. 勾选要启用的模型 → 保存；
5. 保存后该路由在原 Models 设置页与模型选择器里立即可见。

模型能力默认值

| 面板字段 | 默认 | 写入 providers.<route>.models[] |
| 上下文窗口 | 1M（1000000） | contextWindow |
| 最大输出 | 128K（128000） | maxTokens |
| 输入模态 | text + image 都勾选 | input: ['text', 'image'] |
| 推理强度 | high | reasoningEfforts: { high: 'high' } |

- K / M 按 1000 进制，与官方 Models 页一致：1M = 1000000，128K = 128000。
- 推理强度选「不启用」→ 不写 reasoningEfforts，模型不推理，选择器里也不出现强度档。
- 保存时这四项统一覆盖该路由下所有模型；编辑已有路由时用第一个模型的值回填表单。
- 字段留空按上面的默认值写入，不会退回适配器兜底。

Host HTTP 路由

所有特权操作都在 Host 半，浏览器半通过下面四条同源路由访问（仅回环地址可调）：

| 方法 | 路径 | 作用 |
| GET | /model-connect/api/state | 当前路由、模型清单、Key 配置状态、命名空间诊断 |
| POST | /model-connect/api/probe | 用草稿端点 + Key 探测模型列表 |
| POST | /model-connect/api/save | 新增 / 更新一条 provider 路由（并写 Key） |
| POST | /model-connect/api/remove | 删除一条路由（可选连带删除 Key） |

安全边界

- 仅回环：socket.remoteAddress 必须是 127.0.0.0/8 或 ::1，Host/Origin 必须同源，Sec-Fetch-Site: cross-site 直接 403；不信任 X-Forwarded-For。
- 请求体上限 256 KiB，非 JSON 直接 400。
- Key 不落配置：cordis.patch.yml 只出现 <ROUTE>_API_KEY 引用名；值存在 credentials 服务里。
- 参数校验：route ID 走 ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$；Base URL 必须是 http(s)；Key 只允许可见 ASCII。

兼容性

- DSH 0.2.x（开发验证于 0.2.1-rc.2）。
- 依赖 Host 服务：webServer、settings、credentials、llm；对应插件需在组合中启用。
- 浏览器半无构建步骤（无 JSX / 无 bundler），React 从浏览器模块表读取。

DeepSeek Harness（DSH）Web UI 里的一条侧边栏入口，外加一个整页面板，把第三方 OpenAI / Anthropic 兼容模型端点注册成一等公民的 dsh-llm-pi-ai 服务商。官方 Models 设置页能做的事它都能做，只是从左侧栏就能进，还带实时模型探测。

功能

- 侧边栏入口 —— 左侧栏一行 model-connect，点开在布局的 keyed main 槽位里打开页面，沿用内置 Plugins / Schedule / SSH 行那套 shell 自有模式。
- 三种协议 —— openai-completions（/chat/completions）、openai-responses（/responses）、anthropic-messages（/v1/messages）。
- 实时模型探测 —— 填好 base URL 和 key，点 Probe，面板调用 LLM 服务的 discoverModels 填充模型列表。
- 路由持久化 —— 在 llm-pi-ai 设置命名空间里写 providers.<route>，规则与随附的 Models 页完全一致（providers 是易变字段）。
- Key 处理 —— API key 只写进 credentials 服务，挂在 <ROUTE>_API_KEY 引用名下；绝不落进 cordis.patch.yml。
- 模型能力 —— 每个保存的模型条目都带明确的上下文窗口、最大输出、输入模态和推理档（默认 1M / 128K / text+image / high），不退回适配器级默认值。
- 编辑 / 删除 —— 已有路由可原地更新（base URL、协议、模型集合）；删除时可选连带删掉已存的凭据。
- 原生观感 —— 所有颜色都取自 --dsw-alias- 设计 token，跟随当前主题；文案按 locale 在中英文之间切换。

目录结构

model-connect/
├── index.js # host half: loopback routes (state/probe/save/remove) + settings & credentials writes
├── client.js # 浏览器端：侧边栏行 + 主槽页面（纯 JS，无需构建步骤，React 从模块表加载） ├── cordis.patch.yml # 打包补丁：把自己插入 Loader 组合 ├── package.json # 清单：exports / files / dsh.bundle / dsh.client.inject ├── locale/ │ ├── zh.json # 面板元数据（中文） │ └── en.json # 面板元数据（英文） ├── icon.svg # 侧边栏图标 └── tools/push-api.ps1 # REST 发布辅助脚本，供没有 git 二进制的机器使用

安装

方式 1 — 本地链接（开发 / 自用）

git clone https://github.com/ilmilm/dsh-model-connect.git C:\path\to\model-connect
dsh plugin --profile desktop add C:\path\to\model-connect

然后把包追加到 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 数组里：

"@local/dsh-model-connect"

重启 DSH（或重新加载配置档），左侧栏就会出现 Model Connect 这一行。

方式 2 — 手动注册

1. 把仓库放到磁盘上任意位置。
2. 编辑 ~/.dsh/profiles/<profile>/package.json：

{
"dependencies": {
"@local/dsh-model-connect": "link:C:/path/to/model-connect"
},
"dsh": {
"profile": {
"bundles": ["...", "@local/dsh-model-connect"]
}
}
}

3. 在配置档目录里运行 pnpm install，然后重启 DSH。

包名保持 @local/dsh-model-connect（没有发布到 npm）； @local/ 作用域通过 link: 依赖解析。

用法

1. 点击左侧栏的 Model Connect。
2. 填写 provider ID（例如 myrelay —— 字母、数字、点、下划线、连字符）、显示名称、base URL（例如 https://api.example.com/v1）和协议。
3. 输入 API key，点击 Probe models。
4. 勾选要启用的模型，然后保存。
5. 路由会立刻出现在自带的 Models 页面和模型选择器里。

能力默认值

| 面板字段 | 默认值 | 写入 providers.<route>.models[] |
| 上下文窗口 | 1M（1000000） | contextWindow |
| 最大输出 | 128K（128000） | maxTokens |
| 输入模态 | 勾选 text + image | input: ['text', 'image'] |
| 推理等级 | high | reasoningEfforts: { high: 'high' } |

- K / M 按十进制算，和自带的 Models 页面一致：1M = 1000000，128K = 128000。
- 推理选「off」会完全省略 reasoningEfforts —— 模型不推理，选择器也不提供等级。
- 保存时这四个值会覆盖该路由下的所有模型；编辑已有路由时，表单会用它的第一个已存模型预填。
- 字段留空时回退到上面的默认值，而不是适配器自己的回退值。

宿主路由

所有特权操作都在宿主端。浏览器端通过四条同源路由访问（仅限回环地址）：

| 方法 | 路径 | 用途 |
| GET | /model-connect/api/state | 当前路由、模型列表、密钥状态、命名空间诊断 |
| POST | /model-connect/api/probe | 探测草稿端点 + 密钥，获取其模型目录 |
| POST | /model-connect/api/save | 插入或更新一条服务商路由（及其密钥） |
| POST | /model-connect/api/remove | 删除一条路由（可选同时删除其凭据） |

安全边界

- 仅限回环地址 —— socket.remoteAddress 必须是 127.0.0.0/8 或 ::1；Host 与 Origin 必须同源；Sec-Fetch-Site: cross-site 一律返回 403。永不信任 X-Forwarded-For。
- 请求体上限 —— 256 KiB，非 JSON 请求体返回 400。
- 密钥不进配置 —— cordis.patch.yml 里只保存 <ROUTE>_API_KEY 引用；密钥值存放在 credentials 服务中。
- 校验 —— 路由 ID 必须匹配 ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$；base URL 必须是 http(s)；密钥只允许可见 ASCII 字符。

兼容性

- DSH 0.2.x（基于 0.2.1-rc.2 开发并验证）。
- 组合中需启用宿主服务 webServer、settings、credentials、llm。
- 浏览器端无需构建步骤（不用 JSX，不用打包器）；React 从浏览器模块表读取。

许可证

MIT —— 见 LICENSE。