DSH Provider Switch（供应商启停 + 模型搜索 + 重命名）

DSH 静态插件（web profile）。三个功能：

1. 供应商启用/禁用：在「设置 → 模型」页，每个供应商行的「编辑」按钮前有一个「已启用/已禁用」开关。
   • 禁用后：该供应商的模型从输入框模型选择器中隐藏（整组过滤）；会话不会再调用该供应商的任何模型（llm/stream waterfall fail-closed 拦截，调用直接报 PROVIDER_DISABLED 错误，不重试）。
   • 新添加的供应商/模型默认启用（状态只记录「禁用集合」）。
2. 模型搜索：输入框模型选择器的模型面板顶部有搜索框，可关键字过滤（匹配模型名、描述、供应商名，不区分大小写）。
3. 供应商重命名：在「设置 → 模型」页展开供应商编辑卡片后，点击卡片标题（供应商名称）即可内联编辑显示名；Enter 或点击「应用」按钮提交，Esc 或「取消」放弃。重命名写入 llm-pi-ai 命名空间的 providers.<id>.displayName 字段，settings 事件驱动即时同步。清空名称可重置为默认（显示 provider id）。

前置条件

• dsh web ≥ 0.1.0-rc.6（dsh --version 查看）
• Node.js ≥ 20
• pnpm（dsh plugin 命令通过它管理 profile 依赖，缺了会报 pnpm not found on PATH）

安装

从 npm 安装（推荐）：

dsh plugin --profile web add dsh-provider-switch

直接从 GitHub 安装：

dsh plugin --profile web add github:zuojinxin/dsh-provider-switch

两种方式都不需要手动编辑任何 profile 文件——cordis.patch.yml 会在安装时由 DSH CLI 自动把 bundle 加进 profile 的 dsh.profile.bundles。

安装后重启 dsh web 即可生效。

验证是否生效

启动日志里出现这一行，说明 Host 半部分已加载：

[provider-switch] settings namespace ready, disabled=[]

然后在「设置 → 模型」页确认每行供应商都出现了「已启用/已禁用」开关。

卸载

dsh plugin --profile web remove dsh-provider-switch

插件 dispose 时会尽力把 settings 命名空间重置为空（replace({})）；最坏情况 ~/.dsh/settings.yaml 里残留一个空键（DSH 自家配置文件的几字节，不是插件创建的文件）：

provider-switch: {}

手动删掉这两行即可彻底清除。

行为说明

• 重命名失败提示（v0.4.0）：重命名失败时错误提示会带上服务端返回的具体原因（如 llm-pi-ai namespace not registered），而不是笼统的「重命名失败」。
• 供应商重命名（v0.3.0）：展开供应商编辑卡片后，卡片标题（[class*=editorTitle]）可点击变为内联输入框。Enter 或「应用」按钮提交到 Host 的 /api/provider-switch/rename 端点，Host 通过 settings.mutate('llm-pi-ai', [{op:'set', path:['providers',<id>,'displayName'], value:<新名>}]) 写入官方 settings 命名空间；空名称走 unset 重置为 provider id。提交后 settings/document-updated 事件驱动官方模型页重载，新名称即时同步显示。「应用」按钮通过 capture-phase click 拦截：先完成重命名写入，再二次点击放行官方 apply（保存其他字段/关闭卡片）。Esc 或「取消」放弃编辑。同样是 DOM 注入 hack，官方升级改类名时标题回退为不可点击（不影响其他功能）。
• /model 命令弹层过滤（v0.2.0）：输入框 /model 弹出的命令面板现在同样隐藏被禁用供应商的模型。实现方式：官方 contract 不允许重名 commandUi.register（抛错）、decorate 只对 host 命令生效，因此包装运行时已注册 model 贡献的 ui.options 函数（选项 id 形如 <providerId>/<modelId>，按前缀过滤；failure/* 行保留）。若 DSH 升级改动 CommandUiRuntime 内部结构，此处静默降级为不过滤，其他功能不受影响；插件卸载时恢复原函数。
• 开关位置：官方「设置 → 模型」页每行供应商（li[class*=rowCard]）的操作区。这是 DOM 注入（MutationObserver + [class*=...] 子串匹配），依赖官方页面的 CSS 类名；DSH 升级改动类名时开关会消失（优雅降级，不影响其他功能），届时更新本插件即可。
• 模型选择器：shadow 官方 conversation.input.model 槽（priority -1，官方标注支持的 shadows-shipped-ui 姿势），是官方 ModelSelect 的 fork，保留两级菜单/推理等级/键盘导航/错误重试等全部原功能，增量改动只有：顶部搜索框、禁用组过滤、当前模型供应商被禁用时的警示条。数据面完全复用官方 modelDirectories 服务（同一份目录、同一个 selectModel RPC）。
• 拦截调用：ctx.on("llm/stream", ...) —— DSH 所有模型调用（会话主循环、会话标题生成、压缩摘要）都必经 dsh-llm 的 llm/stream waterfall。对禁用供应商不调用 next()，返回抛 LlmError(PROVIDER_DISABLED, status 403) 的合成流：会话立即收到明确错误，不会重试、不会打到供应商。
• 持久化：禁用集合写入 DSH 自己的 settings 文档（命名空间 provider-switch，落在 ~/.dsh/settings.yaml），与官方「添加模型」同一套机制。插件本身不创建任何文件/文件夹。
• 热重载（HMR）插件代码会触发 dispose 清理，禁用列表会被重置（进程重启不受影响）。

文件

• lib/index.js — Host 半部分：settings 命名空间注册、llm/stream 拦截、/api/provider-switch/{state,set,rename} 三个 HTTP 端点。
• lib/client.js — Client 半部分：模型选择器 fork（搜索+过滤）、设置页行内开关（DOM 注入）、供应商编辑卡片标题内联重命名（DOM 注入）、样式。
• cordis.patch.yml — 安装挂载层。

已知限制

• 设置页开关和重命名都是 DOM 注入 hack，官方页面类名变化时开关/重命名不显示（其他功能不受影响）。
• /model 弹层过滤依赖 CommandUiRuntime 的内部存储结构（live.contributions），DSH 升级若改动该结构会静默降级为不过滤（输入框模型座不受影响）。
• 禁用供应商只拦模型调用，不隐藏「设置 → 模型」页里的供应商行（行仍在，可随时重新启用）。
• 重命名时若同时修改了官方字段（API Key、baseURL 等），重命名写入会使 settings revision 前进，官方 apply 可能收到 settings-conflict 错误（官方卡片会提示冲突，再次点击应用即可）。
• 插件只拦 llm/stream waterfall。任何绕过该 waterfall 直连供应商的调用方（例如走原生 fetch 的搜索类插件）不在拦截范围内。

开发

见 CONTRIBUTING.md（本地 junction 安装、版本快照规范、沙箱测试怎么跑）。

许可

MIT · 详见 LICENSE