前言¶
在 DeepSeek Harness（DSH）里写 Composer 会话时，换模型往往要在一层层分组下拉里找供应商和具体模型。供应商一多，同一套 profile 里配置的 key 和模型目录都在，但交互路径变长。下面介绍社区插件 dsh-model-quick-switch（npm 包名 @aichixiaojuzi/dsh-model-quick-switch）：它只替换输入框工具行上的「模型」入口，用左供应商、右模型的双栏面板做切换，排序、别名、收藏和最近使用都留在本机浏览器里，选模型仍走 Host 官方的目录与 session.selectModel，和 /model 弹窗保持一致。
这是什么¶
维护者为 aichixiaojuzi。插件定位是 Provider-first model switcher for the DSH composer——输入框里的双栏模型切换器，所有供应商在左侧一级可见。分类上属于社区目录里的「模型推理」类插件；源码与说明见 GitHub 仓库，目录页见 SkillHub 插件页。当前 npm 版本为 0.2.0，许可证 MIT，要求 dsh >= 0.2.1-rc.4。
它解决什么问题¶
官方模型菜单按分组嵌套时，多个供应商要逐层展开。该插件把所有真实供应商放进左栏一级列表（另有「收藏」「最近」入口），鼠标扫过左侧行即切换右侧模型列表，点选即切换。支持拖拽或键盘调整供应商与模型顺序、本机别名、星标收藏、最近 12 次成功切换记录，以及按名称/别名/供应商名的模糊搜索。子代理等会话不可用时插件会主动留空，把席位交还官方控件。
核心功能¶
双栏与选中态¶
左列：收藏、最近、全部供应商（一级可见）。右列：当前供应商下的模型。已选模型与左侧当前供应商使用同一种高亮（实心底色 + 左侧品牌色竖条）；鼠标悬停仅临时底色，移开后只保留当前选中行。
排序与收藏¶
供应商顺序、各供应商内模型顺序、收藏顺序均可拖拽；键盘用户可用 Alt + ↑/↓ 移动当前行。模型行右侧星标可收藏；每次成功切换会记录最近 12 个模型。顶部搜索框跨供应商匹配模型名、供应商名及别名。
右键菜单¶
左侧真实供应商行右键：重命名（本机显示别名）、打开面板时默认选它、置顶/上移/下移、重置该组模型顺序、全部加入收藏或清空该组收藏、刷新供应商与模型、从面板删除（仅影响本地面板，profile 配置不动，底部可恢复）。
右侧模型行右键：重命名、恢复原名、收藏/取消收藏（与星标同效）。
推理强度与其它¶
选中模型后，行下方可展开该模型适配器声明的推理强度档位并切换。目录自带的模型 badge（如「新」）会显示在名称旁。面板支持完整键盘导航（↑/↓、Home/End、PageUp/PageDown、Enter、Esc）。某供应商目录加载失败时不占左栏列表，错误仍保留在目录中，可通过刷新重试。列表头 ↻ 与打开面板时会重新解析当前会话已配置的供应商与模型，新加 key 或供应商无需重启应用。
数据边界¶
选择逻辑使用官方 ctx.modelDirectories 与同一 session.selectModel；Host 拒绝会在面板底部红字提示。顺序、别名、默认供应商、收藏、最近、已删除供应商列表保存在浏览器 localStorage（键名 dsh.model-quick-switch.v1），不写 profile、不新增 Host 路由。插件不联网、不上报、不读密钥，只读 Host 已下发的模型目录。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议在 GitHub 查看源码与 MIT 许可证，确认符合你的环境策略。
桌面端（profile 名为 desktop）：
dsh plugin --profile desktop add @aichixiaojuzi/dsh-model-quick-switch
Web 端（profile 名为 web）：
dsh plugin --profile web add @aichixiaojuzi/dsh-model-quick-switch
也可在 GUI 插件市场搜索 dsh-model-quick-switch 安装。装好后刷新页面，输入框工具行原模型入口即变为双栏面板入口。
本地开发联调时，README 提供从源码 link 安装的方式（需自行 clone 到本地路径后使用 link: 前缀），本文不展开 clone 步骤。
典型用法¶
- 打开 Composer 新会话，在输入框工具行点击原「模型」位置，展开双栏面板。
- 在左栏点选或悬停供应商，在右栏点选目标模型；若模型支持多档推理强度，在展开区点选档位。
- 常用模型点右侧星标进入「收藏」；需要时用顶部搜索跨供应商定位。
- 在 profile 里新增供应商或模型后，左栏供应商右键选「刷新供应商与模型」，或打开面板时的自动解析即可，无需重启 DSH。
- 左栏某供应商暂不想出现在面板里时，右键「从面板删除」；需要时在左栏底部「已删除 N 个 · 恢复」找回。
卸载时在插件页禁用 bundle，官方模型选择器会恢复。若要一并清除收藏与排序，删除浏览器 localStorage 中的 dsh.model-quick-switch.v1 即可。
适用场景与注意¶
适合在 DSH Web 客户端长期维护多供应商、多模型，且希望在一级列表里快速切换的开发者。窄屏下触发按钮仍显示模型名（超出省略），不做图标化收缩。「重命名」仅改本机显示名，不改底层 id，也不改写 Host 目录名称。收藏里若某模型暂时从目录消失，键仍保留，重新出现后会回到收藏。
DSH 生态理念是「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文所述安装与能力均以仓库 README 与 package.json 为准。
结尾¶
dsh-model-quick-switch 用供应商优先的双栏 UI 缩短 Composer 里换模型的路径，同时不替代 Host 的模型目录与选模 API。进一步了解可访问 SkillHub 目录页 与 GitHub：aichixiaojuzi/dsh-model-quick-switch。
