规划执行模型路由 whg20001/DSH_Model_Router

DeepSeek Harness Web：规划/执行模型路由插件 DSH Market dsh-sol-luna-router 是独立于 Pi 的可配置 DSH Cordis Web 模型路由插件。用户可以从当前可用的 provider/model 中分别选择规划模型与执行模型；插件不会限定具体厂商或模型名称。

Sol 和 Luna 是断路器协议中的角色名称，不是固定模型：根代理与 Sol 恢复角色使用用户选择的规划模型，一次性 Luna 实现角色使用用户选择的执行模型。插件同时为每个父 session 保存独立的断路器状态。

模型与角色映射

| 配置 | 使用者 | 职责 |
| 规划模型（planner） | 根代理、Sol 恢复角色 | 规划、验证，以及断路后的单次恢复 |
| 执行模型（executor） | Luna 实现角色 | 执行具体实现任务并返回验证证据 |

例如，用户可以将任意当前可用模型配置为规划模型，并将另一个模型配置为执行模型；模型名称中不需要包含 sol 或 luna。

行为与架构

- 状态阶段：idle、luna、open、sol-recovery、passed、escalated。
- 每次 start_task 清零；Luna 第一次验证失败允许再试一次，第二次打开断路器；之后只允许一个全新的 Sol 恢复，失败即升级。
- 状态以 dsh-sol-luna-router/state（version 1）追加到父 session；启动 Sol 前先追加 sol_started，持久化失败则不会启动子代理。
- 设置 namespace 为 sol-luna-router：enabled 默认 false，planner/executor 分别保存用户选择的规划与执行路由，subagentProvider 默认 spawn，maxDepth 默认 3。禁用时保留已提交的模型选择。
- Web API：GET/PUT /api/sol-luna-router。GET 每次重新查询全部 provider 的模型；单个 provider 失败只形成 warning。PUT 要求同源、JSON 限制、revision 乐观锁，并在启用时校验所选模型当前可用。
- 启用后，根代理请求固定路由到规划模型；Luna 工作器路由到执行模型；Sol 恢复工作器重新使用规划模型。
- 父代理的直接写工具及 subagent、workflow 等旁路会被拦截；读取、搜索、shell 验证与 run_code 不拦截，但协议明确禁止使用 shell 绕过写限制。子代理隐藏 router 工具。

代码分为无 DSH 依赖的 src/core.js、config.js、models.js、http.js、router.js，以及依赖 DSH 的 src/index.js；浏览器端是 src/client.js 的 ModuleLoader bundle。

命令行安装

前置条件：Node.js >=22.19、pnpm，以及已创建的 DSH profile（默认 ~/.dsh/profiles/web）。推荐通过 npm 包运行：

npx dsh-sol-luna-router install

从当前源码目录安装时使用：

node ./bin/dsh-sol-luna-router.js install --source .

CLI 默认使用 DSH_HOME 环境变量，否则使用 ~/.dsh；profile 默认是 web。也可以显式指定：

dsh-sol-luna-router install --dsh-home /path/to/.dsh --profile web

安装命令会自动：

1. 校验插件源、profile、路径边界及 cordis.patch.yml；
2. 备份 profile 的 package.json、cordis.patch.yml 和已发现的 pnpm lockfile；
3. 通过同级暂存目录安全更新 plugins/dsh-sol-luna-router；
4. 执行 pnpm add file: --save --ignore-scripts；
5. 幂等加入下面的 Cordis entry，并在失败时自动回滚：

- insert:
- id: dsh-sol-luna-router
name: dsh-sol-luna-router

先预览所有动作而不写文件、不运行 pnpm：

dsh-sol-luna-router install --dry-run

Windows PowerShell 仍可使用兼容入口；它会转发到同一个 Node CLI：

.\scripts\install.ps1 -PluginSource C:\path\dsh_plugging
.\scripts\install.ps1 -PluginSource C:\path\dsh_plugging -WhatIf

安装成功后重启 DSH Web，在设置页选择规划模型与执行模型，再打开插件启用开关。

诊断

doctor 是只读检查，不会修改 DSH：

dsh-sol-luna-router doctor
dsh-sol-luna-router doctor --json

它检查 Node/pnpm、profile 配置、Cordis 条目、插件副本、profile 依赖以及 peer dependency 版本。pass/warn 返回 0；存在 fail 返回 1。

卸载

dsh-sol-luna-router uninstall

命令会备份配置、删除精确匹配的 Cordis entry、运行 pnpm remove dsh-sol-luna-router --ignore-scripts，并删除身份验证通过的插件副本。可选参数：

dsh-sol-luna-router uninstall --dry-run
dsh-sol-luna-router uninstall --keep-plugin
安装和卸载的备份位于 ~/.dsh/backups/dsh-sol-luna-router/。退出码 3 表示操作失败且自动回滚不完整，应根据命令输出中的备份目录手动恢复。卸载后重启 DSH Web。

限制与安全边界

这是 Cordis 级工具和请求拦截，不是操作系统沙箱。父代理仍能执行 shell；用户应使用 DSH 权限、工作区隔离和审计。run_code 的动态代码需由宿主自身的工具策略审查。模型目录是 advisory，PUT 只在启用时拒绝不在目录中的路由。

npm run smoke:real-dsh 从 DSH_PROFILE_NODE_MODULES，或 DSH_HOME（默认 ~/.dsh）下的共享 profile node_modules 加载 rc.6 包并验证真实模块兼容性；它不会安装、启动或修改 live DSH 服务。项目另已通过隔离的临时 DSH_HOME 验证 Web 插件加载、GET/PUT API、同源拒绝、设置页渲染与保存交互。

验证

npm test
npm run check
npm run smoke:real-dsh
npm pack --dry-run