预设切换器 neutronslime/dsh-preset-switcher-fork

dsh-preset-switcher

Fork 说明：上游 jeffcwj/dsh-preset-switcher 最后提交是 2026-08-17，未适配 DSH 0.2.1。该版本移除了宿主 webRuntime 服务（现在提供 webApp），而上游插件
inject: ['webServer', 'webRuntime'] 因此永远不挂载、/preset-switch/api 404，
前端下拉菜单随之失效。本 fork 只做兼容修复（见 CHANGELOG.md），功能与上游一致。
已在 DSH 0.2.1-rc.2 上验证：插件正常挂载，list / switch / repair 三个方法均按预期返回。安装方式见下方「安装 / 更新」，一条 dsh plugin add 即可。

概述

DSH Web 插件：在任何时候切换当前会话的代理预设（模式），包括对话已经开始之后 — 原生 UI 不允许这样做（"已开始的对话的代理预设已固定"）。

核心功能

- 顶部下拉菜单：会话标题操作栏中的「当前模式 ▾」按钮，列出所有预设（如 standard=标准模式、code=PTC 模式、minimal=极简模式、cordis=创造模式），用 ✓ 标记当前预设，点击即切换。
- 失效预设修复：如果会话记录的预设已被删除（自定义预设被移除），恢复将失败导致会话不可用。下拉菜单中的「修复失效模式会话」操作（及 repair API）会扫描所有会话日志并重写失效引用 — 最后一个 agent-preset/selected 事件，否则是标题 — 重置为默认预设，操作前自动备份日志并跳过活跃会话。切换未加载的会话时若引用失效也会自动修复。
- 受控路由：POST /preset-switch/api，参数 { method: 'list' | 'switch' | 'repair', sessionId, presetId, target? }（回环/可信主机限制，与 dsh-sounds 相同）。

工作原理

原生 API（agentPresets.select）通过空白会话检查来保护切换操作。本插件底层调用同一原子原语 — agentPresets.recompose(agent.ctx, presetId) — 将代理的作用域重新链接到目标预设的常驻挂载点。新组合在链接移动前确保完成，因此损坏的预设不会影响会话。成功后插件追加与代理记录相同的 agent-preset/selected 会话事件，使投影和标题标签同步更新。

限制：仅已加载的活跃会话可切换；子代理拥有的会话将被拒绝；新的工具集/人设从下一个模型步骤生效。

安装 / 更新

需要 DSH 0.2.1-rc.2（或同代 0.2.x）。插件是纯 JavaScript，没有构建步骤，装完即用。

方式一（推荐）：直接从 GitHub 仓库安装
dsh plugin --profile web add github:neutronslime/dsh-preset-switcher-fork

方式二：克隆到你自己选的目录，再从该目录安装（不依赖作者机器上的任何路径）
git clone https://github.com/neutronslime/dsh-preset-switcher-fork.git
dsh plugin --profile web add .\dsh-preset-switcher-fork

安装或升级后重启 dsh web（profile 启动时会合并 cordis.patch.yml），刷新页面，会话标题栏右侧就会出现「当前模式 ▾」按钮。

dsh plugin 把参数转交给 profile 目录里的 pnpm，不需要全局 npm；想自己检查打包内容， npm pack --dry-run 也可以（node 20.17+ 或 22.9+ 即可，npm 11 实测无碍）。

文件结构

| 文件 | 说明 |
| cordis.patch.yml | Bundle 补丁：将插件行插入 profile 的 cordis 树（dsh.bundle.patch） |
| lib/index.js | 服务端：受控 /preset-switch/api 路由（list / switch / repair）及会话日志修复逻辑 |
| lib/client.js | 浏览器端：顶部下拉菜单（ClientModuleSystem bundle，React 通过 module-table externals） |
| scripts/ | restart-web.ps1（通用版重启+探测，路径自动推导）、inspect-session.mjs / repair-session.mjs（独立日志工具） |

许可证

MIT

dsh-preset-switcher

Fork 说明：上游 jeffcwj/dsh-preset-switcher 最后一次提交是 2026-08-17，在 DSH 0.2.1 上跑不起来：该版本移除了宿主 webRuntime 服务（web 运行时现在提供 webApp），所以上游的 inject: ['webServer', 'webRuntime'] 永远挂不上，/preset-switch/api 返回 404，顶栏下拉菜单也失效了。本 fork 只做兼容性修复（见 CHANGELOG.md），功能与上游一致。已在 DSH 0.2.1-rc.2 上验证：插件能挂载，list / switch / repair 都按预期返回。安装只需一条 dsh plugin add；见下文「安装 / 更新」。

概述

DSH web 插件：随时切换当前会话的智能体预设（模式），会话已经开始也能切——原生 UI 不允许这样做（「已开始的会话，智能体预设固定」）。

功能

- 顶栏下拉菜单：会话顶栏操作区里有个「当前模式 ▾」按钮，列出全部预设（例如 standard=标准模式、code=PTC 模式、minimal=极简模式、cordis=创造模式），用 ✓ 标出会话当前用的那个，点击即切换。
- 失效预设修复：如果会话记录的预设被删了（自定义预设被移除），恢复会失败，会话也就用不了了。下拉菜单里的「修复失效模式会话」操作（以及 repair API）会扫描每个会话日志，把失效引用——最后一条 agent-preset/selected 事件，没有就改头部——改写成默认预设，改写前先备份日志，并跳过活跃会话。切换一个未加载、引用已失效的会话时，也会自动修复。
- 受限路由：POST /preset-switch/api，请求体为 { method: 'list' | 'switch' | 'repair', sessionId, presetId, target? }（回环 / 受信主机限制，与 dsh-sounds 相同）。

工作原理

原生 API（agentPresets.select）在切换前会做空白会话检查。本插件在底层调用同一个原子操作——agentPresets.recompose(agent.ctx, presetId)——把智能体的作用域重新挂到目标预设的常驻挂载上。链接移动之前会先确保新组合可用，所以预设有问题时会话不受影响。成功后，插件追加一条与代理记录相同的 agent-preset/selected 会话事件，投影和顶栏标签随之更新。

限制：只能切换活跃（当前已加载）的会话；子代理拥有的会话会被拒绝；新的工具集 / 人格从下一个模型步骤开始生效。

安装 / 更新

需要 DSH 0.2.1-rc.2（或其他 0.2.x 版本）。插件是纯 JavaScript，没有构建步骤。

Option 1 (recommended): install straight from the GitHub repository
dsh plugin --profile web add github:neutronslime/dsh-preset-switcher-fork

Option 2: clone into a directory of your choosing, then install from it
git clone https://github.com/neutronslime/dsh-preset-switcher-fork.git
dsh plugin --profile web add .\dsh-preset-switcher-fork
安装或升级后重启 dsh web（配置档启动时会合并 cordis.patch.yml），刷新页面，会话头部就会出现「当前模式 ▾」按钮。

dsh plugin 会把命令转发给配置档目录里的 pnpm，所以不需要全局安装 npm；想检查 tarball 也可以运行 npm pack --dry-run（node 20.17+ 或 22.9+；npm 11 没问题）。

目录结构

| 文件 | 说明 |
| cordis.patch.yml | 打包补丁：把插件行插入配置档的 cordis 树（dsh.bundle.patch）。 |
| lib/index.js | 宿主侧：带围栏的 /preset-switch/api 路由（list / switch / repair），以及会话日志修复逻辑。 |
| lib/client.js | 浏览器侧：头部下拉菜单（ClientModuleSystem bundle，React 通过 module-table externals 引入）。 |
| scripts/ | restart-web.ps1（不依赖端口的重启 + 探测；所有路径在运行时推导）、inspect-session.mjs / repair-session.mjs（独立日志工具）。 |

许可证

MIT