dsh-custom-provider

Readme

# dsh-custom-provider

[dsh](https://github.com/deepseek-ai/deepseek-harness)（DeepSeek Harness）Web 设置页扩展插件：新增「自定义模型 / Custom models」设置分区（排在 Models 之后），补上官方 Models 页面不提供的能力编辑——

1. **子代理模型白名单**（页面顶部卡片，全部下拉选择，不手填）
   - **委派时模型自选**：启用后 `subagent` 工具增加可选 `provider`/`model`/`reasoning_effort` 参数并注册 `list_subagent_models` 工具，每次委派可从白名单自选；白名单外路由在创建子代理前被拒；
   - 省略显式选择的委派沿用父会话当前路由（`agent-default-model` 只决定新会话的出厂路由，与本卡片无关）。
   - 0.6.0 起移除了「固定默认模型」（静态 `agentOptions`）半卡：它写在 host 面 `tool-subagent` 行，而 web 层禁用 host 面委派行、由 agent preset 接管，功能从未生效。
2. **逐模型能力**
   - **图片输入支持**：`llm-pi-ai` 每模型 `input`（目录路由写 `modelOverrides.<modelId>` 外科覆盖，声明路由整表重写 `models`）；`llm-deepseek` 每模型 `inputModalities`；
   - **Reasoning effort 映射**：`llm-pi-ai` 每模型 `reasoningEfforts`（勾选等级进选择器，值为线路拼写；`off` 可留空；`false` = 非推理模型）+ 路由级默认 effort（`reasoning` 字段）；`llm-deepseek` effort 集合固定且锁定路由级，此页只提供路由级字段。

只显示已激活的路由；休眠（未配置）路由隐藏并在顶部提示隐藏条数。写入走官方 Models 页同一 wire（`settings.mutate` path ops + namespace revision 围栏），两页共存不冲突，保存即生效无需重启。

## 安装

```sh
dsh plugin --profile web add "github:homily707/dsh-custom-provider"
# 本地开发：dsh plugin --profile web add link:<本仓库检出路径>
```

`dsh plugin add` 只管依赖，装完还需把 `dsh-custom-provider` 加进 `~/.dsh/profiles/web/package.json` 的 `dsh.profile.bundles` 数组才会被加载。重启 `dsh web`（或 `dsh --profile web`）后刷新页面，设置面板即出现「自定义模型」分区。

### 导航图标（宿主补丁，可选）

设置面板左列的图标是宿主包 `dsh-client-ui-settings-general` 里按 section id 硬编码的 `navIcon()` 映射（`models`→数据图标，未知 id 默认齿轮），插件侧无挂钩。要让本分区与「模型」页同图标，需给宿主文件加一行（dsh 升级会覆盖，需重打）：

```sh
python3 - <<'EOF'
f = '<dsh 安装目录>/node_modules/@deepseek-ai/dsh-client-ui-settings-general/lib/client.js'
s = open(f).read()
old = '\t\tif (id === "agent-presets") return'
new = '\t\tif (id === "custom-provider") return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconDataOutline16, {\n\t\t\tclassName: SettingsRoot_module_css_default.navIcon,\n\t\t\tsize: 16\n\t\t});\n' + old
assert s.count(old) == 1
open(f, 'w').write(s.replace(old, new))
EOF
# 然后重启 dsh web 并刷新页面
```

## 工作方式

- **浏览器半侧**（`client.js`）以 `window.__ModuleLoader__.load({id, factory})` 的 lazy-CJS 工厂格式手写，经 `dsh.client` / `exports["./client"]` 由 client-modules 半侧扫入 boot graph，从 `/plugins/dsh-custom-provider/client.js` 提供，无需重建 Web app；注册进 `settings.section` list slot。
- **Host 半侧**（`index.js`）注册 `GET/PUT /model-capabilities/subagent` webserver 路由：子代理卡片写入 `$DSH_HOME/cordis.patch.yml`（home 级用户补丁层）中由本插件托管的标记块（`# >>>/<<< dsh-custom-provider subagent (managed)`）——只改写标记块内内容，文件中其他手工条目与注释逐字节保留；写前整文件 parse 校验，写用 tmp+rename。web profile 的 patchReload 为 `live`，保存后 dsh 热加载补丁行；其他 profile 需重启。仅对之后创建的会话生效。
- 取数：`api.llm.providers({})`、`ctx.settingsScope.describe()` mirror、`api.llm.models({})`、`remote.llm.listProviders` + `remote.session.modelCatalog`（下拉选项）。
- 冲突（`settings-conflict`）时提示收起重开；推送来的 invalidation 会自动刷新页面数据。

## 已知限制

- deepseek 路由无逐模型 effort 映射（适配器锁定在路由级）；pi-ai 逐模型字段只有能力映射，没有「每模型默认档」——默认档只有路由级一档。
- 子代理模型自选策略在会话创建时采样记录，改动只对之后的新会话生效。
- loader patch 的 `config` 是整键替换，托管块全量重声明 `dsh-base` 的 `tool-subagent` 基线；dsh 升级若改变基线需同步 `index.js` 的 `BASE_TOOL_CONFIG`。
- 省略显式选择的委派走父会话路由、不经白名单校验（dsh 设计：纯继承豁免策略）；如需控制省略路径落点，调 `agent-default-model`（`~/.dsh/settings.yaml`）或 composer 当前模型。

## English

A dsh (DeepSeek Harness) web Settings extension adding a "Custom models" section: a subagent delegation allow-list card (the per-delegation model-choice toggle plus the `subagent-model-selection` allowed routes, mounted through a managed marker block of `$DSH_HOME/cordis.patch.yml` and the ordinary settings wire), and per-model image-input / reasoning-effort mapping for `llm-pi-ai` / `llm-deepseek` routes. Writes go through the same `settings.mutate` wire as the Models page, so both coexist; saves hot-apply on the web profile. The static fixed-route (`agentOptions`) knob was removed in 0.6.0 — on web profiles it landed on the host-plane `tool-subagent` row that dsh-web-app disables in favor of agent presets, so it never reached the running tool.

## License

MIT