← 返回列表
⚠ 装前注意
DeepSeek Harness Web GUI 的一键服务商/模型切换客户端插件。
基本兼容但装前注意：未发布到 npm registry，仅可从源码安装 · 最近上游提交 2026/9/9 · 已提供中文文档
DeepSeek Harness Web GUI 的一键式提供商/模型切换客户端插件
综合分
33.3
GitHub 分
33.3
用户评分
—
★ Stars
0
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add 2275803244-cpu/dsh-model-switcher未发布到 npm registry，仅可从源码安装，改用 GitHub 源安装
信任档位：已验证本站已于 0 天前真实安装成功
- 是什么
- dsh 原生插件 · chat
- 装得上吗
- 本站已真实安装成功（非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 16 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/26
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/26（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包dsh-client-ui-model-switcher（未发布到 npm，仅可源码安装）
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
未发布到 npm registry，仅可从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/26 06:11:56
用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成dsh-client-ui-model-switcher
DeepSeek Harness Web GUI 的一键服务商/模型切换客户端插件。
会话标题栏加一个滑块按钮：弹出所有已配置的服务商和它们的模型，点一下即切换，不用再进设置一个个配。
功能
- 替换原生模型选择器：输入框右下角的原生模型选择器被替换为增强版——默认显示当前服务商的模型列表，点击「切换服务商 →」可换服务商，两级联动：顶部一排服务商 chips（带模型数），先点服务商，下方联动显示该服务商的模型列表，点模型即切换，服务商（及其地址）自动跟随
- 只显示配置好的：面板通过 llm.providers + settings.describe + credentials.describe 检查每个服务商的 key 状态，没有 key 的服务商不显示（补 key 后自动出现）
- 当前状态：面板顶部显示当前服务商 / 模型，当前项带蓝色高亮和 ✓
- 实时目录：打开时自动刷新模型目录（与 /model 命令、composer 模型席位共享同一份状态，任一入口切换其它入口同步）
- 异常提示：服务商不可用、目录加载失败、失败的服务商列表都会显示
- 会话限制：子代理会话（不支持切换模型的）会禁用并提示
实现要点
- 槽位：conversation.session.header.actions（order=25）
- 服务：modelDirectories（ctx.modelDirectories.directoryFor(sessionId)）
- 目录状态：react.useSyncExternalStore 订阅 directory.store（uSES 兼容 SnapshotStore）
- 切换：directory.select({ provider, model })——与 /model 弹窗和 composer 模型席位同一个控制器，Host 是唯一事实源
- 纯浏览器侧，手写 ModuleLoader bundle，零构建（仅 react / react/jsx-runtime）
安装
pnpm --dir "$HOME\.dsh\profiles\web" add github:2275803244-cpu/dsh-model-switcher
cordis.patch.yml 追加：
- insert:
- id: ui-model-switcher
name: 'dsh-client-ui-model-switcher'
重启 dsh web，会话标题栏出现滑块按钮。
服务商目录来自 设置 → 模型 里已配置的适配器；要增加新服务商（如本地 Ollama），先在模型设置中配置好，一键切换里就会出现。
0.8.1 修复（本地补丁）
针对 DSH 0.1.2-rc.1 的 Remote 契约与原生选择器行为修正了以下问题（test/client.test.cjs 覆盖）：
| # | 问题 | 修复 |
| - | ---- | ---- |
| 1 | usableProviders 调用不存在的 API（llm.providers({})、settings.describe({})、credentials.describe({refs})），异常被吞掉后返回 null，"只显示配好 key 的服务商" 实际从未生效 | 改用 llm.listProviders() + llm.listConfigurableProviders() + settings.describe() + credentials.describe(refs: string[])，并用注册表判定路由是否 active |
| 2 | 取 API 面用 connection.api，该属性在 ConnectionHandle 上不存在（当前实现是 ctx.remote），导致上面第 1 条必然失败 | 改用 ctx.remote（inject 增加 remote），保留 connection.api 兜底 |
| 3 | usableMap 跨开关持久，补 key 后重开面板仍被旧的过滤结果挡住 | 每次打开重置并重新拉取，异步结果用 live 标记防竞态 |
| 4 | 过滤后若一个服务商都不剩，面板空白无法切换 | 过滤结果为空时回退到完整列表 |
| 5 | 切换模型只提交 {provider, model}，丢掉推理强度：与 /model 弹窗/composer 席位行为不一致，原生席位会带 reasoning.defaultEffort，重选当前模型时保留用户已选强度 | 新增 selectionFor()，与原生 selectionOf() 同语义 |
| 6 | 两个触发器都显示原始模型 id（deepseek-v4.1-flash-expires-on-0910），且不显示推理强度 | 新增 modelName()/effortLabel()，显示模型名 + · 强度 |
| 7 | 面板打开时点触发器不会关闭 | 触发器改为切换语义 |
| 8 | rootRef.current 可能为 null 时的 contains() 抛错 | 加空值保护 |
测试：
node test/client.test.cjs # 10 项断言，无需安装依赖
卸载
pnpm --dir "$HOME\.dsh\profiles\web" remove dsh-client-ui-model-switcher
删掉 cordis.patch.yml 的 ui-model-switcher 行，重启
贡献
欢迎提交 PR！请先阅读 CONTRIBUTING.md。
- 跑测试：node test/client.test.cjs（提交前必须全绿）
- 提交信息遵循 Conventional Commits
参考
- ModelDirectory / ModelDirectoryResolver：dsh-client-ui-model-selection/lib/types/client/service.d.ts、directory.d.ts
- 目录状态契约：dsh-client-ui-model-selection/lib/types/client/directory.d.ts
- 类型：dsh-host-apiproxy/lib/types/api/sessions.d.ts（ModelSelection / ModelProviderGroup / SessionModels）