前言¶

在 dsh-TUI 的使用场景中，子代理通常继承主会话的模型配置。如果需要子代理使用不同的推理强度或更轻量的模型来处理特定任务，默认行为无法满足需求。dsh-tui-model-switch 插件提供了解决方案，允许为主会话和子代理配置独立的模型路由。

插件简介¶

dsh-tui-model-switch 是一个为 dsh-TUI 设计的插件，允许子代理在不同的提供商、模型或推理努力下运行，同时保持主会话配置不变。该插件由 FUSU123fusu 维护，基于 MIT 许可证开源。

安装与启用¶

安装插件需要执行以下命令。安装后必须重启 DSH 服务才能生效。

dsh plugin --profile dsh-tui add github:FUSU123fusu/dsh-tui-model-switch

核心功能¶

• 子代理模型路由：允许子代理在独立的提供商、模型或推理努力下运行。
• TUI 配置界面：通过 /settings 屏幕的“模型路由”区块进行配置。
• 实时生效：设置变更后自动重载，无需重启。
• 跨平台支持：在非 TUI 主机上也能工作，通过命令行查看状态。

使用方法¶

1. 打开 TUI 界面，进入 /settings 屏幕并找到“模型路由”区块。
2. 在“子代理模型”选项中选择“自定义（Custom）”。
3. 从已配置的提供商和模型列表中选择子代理使用的模型。如果列表不可用，可手动输入 provider/model。
4. 可选：设置推理强度，支持 low、medium、high 或 max。留空则跟随模型默认值。
5. 通过 /model-switch 命令查看当前生效的路由配置。
6. 若需恢复无插件状态，可将子代理模型设为“跟随主会话（Follow main session）”。

工作机制与限制¶

• 优先级：调用方显式指定的 provider/model 会覆盖插件设置。
• 推理努力：仅通过拦截器注入，仅影响 origin: subagent 的会话。
• 计划执行：计划执行（plan-execute）阶段的模型路由功能待 TUI 审批面板扩展后支持。
• 非 TUI 主机：设置配置在后台持久化，但 /settings 界面不会渲染；可通过命令行查看路由状态。

注意事项¶

• 安装后务必重启 DSH。
• 插件代码托管在 GitHub，使用前请确认源码与许可证。
• 插件不提供计划执行阶段的模型路由支持。