DSH Collapsible Model Selector

为 DeepSeek Harness（DSH）的模型选择器添加按供应商独立折叠的分组界面，同时保留官方的数据、选择、配置和调用逻辑。

Adds independently collapsible provider groups to the DeepSeek Harness model selector while preserving the official data, selection, configuration, and invocation paths.

上图是 AI 生成的原创概念图，用于表达供应商分组、展开、折叠和模型连接关系，不代表 DSH 的实际界面或 DeepSeek 官方视觉。

实际界面

模型菜单：

设置页：

功能

• 每个模型供应商可以独立展开或折叠，并显示模型数量。
• 可在 DSH 设置中选择“当前供应商”“全部展开”“全部折叠”或“单组展开”。
• 可切换舒适/紧凑列表密度，以及跟随系统/关闭折叠动画。
• 展开、收起、箭头和透明度使用统一的 160 ms 对称动画，并支持 prefers-reduced-motion。
• 提供 menuitem、menuitemradio、aria-expanded、aria-controls、aria-checked 和可见项键盘导航。
• 模型触发器支持上下方向键直接打开菜单，并聚焦首项或末项。
• 直接复用官方 modelDirectories 服务、model 本地化命名空间和选择数据结构。
• 自定义席位使用优先级 -1；模型目录接口缺失或席位同步渲染失败时，DSH 会退让到官方优先级 0 的选择器。选择请求失败会在菜单中显示错误。
• 不新增命令、Host 配置 schema 或 RPC，也绝不重复注册官方 model 本地化命名空间。

设置

打开 DSH 的“设置”，选择“模型选择器”即可修改：

• 供应商分组的初始展开策略。
• 模型列表的舒适或紧凑密度。
• 折叠动画是否跟随系统设置。

默认值与 0.1.x 的行为一致：仅展开当前供应商、舒适密度、动画跟随系统。偏好保存在当前浏览器与 DSH Web 地址的 localStorage 中，会即时生效并在刷新后保留；它们不会写入 settings.yaml、修改模型配置或改变调用数据。浏览器阻止本地存储时，设置页会明确提示，更改仅在当前页面生命周期内有效。

兼容性

0.2.2 声明兼容 DSH Web >=0.1.7-rc.1 <0.1.8-0，要求 Node.js 22 或更高版本。开发依赖固定在 0.1.7-rc.2，已对照 rc.1/rc.2 的模型目录和席位接口。版本范围包含后续 0.1.7 预发布版及稳定版，但新版本仍需实际验证；0.1.8 及更高版本不会被自动视为兼容。GitHub Actions 在提交时检查类型、测试、构建及安装包，并每天扫描 npm 上的全部 DSH 发布版本（含预发布版）；发现高于已验证基线的版本会提示复核。

Version 0.2.2 declares DSH Web compatibility for >=0.1.7-rc.1 <0.1.8-0 and requires Node.js 22 or newer. Development dependencies are pinned to 0.1.7-rc.2; the model directory and slot APIs were compared across rc.1 and rc.2. Later 0.1.7 releases still need validation. 0.1.8 and newer are outside the declared range. GitHub Actions checks the committed build and watches all published DSH versions, including prereleases, for releases newer than the verified baseline.

从 GitHub 安装

先确认安装命令使用的 DSH 版本与正在运行的 Web 服务一致。若 dsh 已加入 PATH，在 PowerShell 中运行：

dsh --version
dsh plugin --profile web add 'https://github.com/ZoeHao2026/dsh-ui-model-selection-collapsible.git#v0.2.2'
dsh plugin --profile web ls --depth 0

若使用 DSH Launcher、且 PATH 中没有同版本的 dsh，可指定正在运行的确切 DSH 版本执行相同操作。例如当前 rc.2：

$dshVersion = '0.1.7-rc.2'
pnpm dlx "@deepseek-ai/dsh@$dshVersion" plugin --profile web add 'https://github.com/ZoeHao2026/dsh-ui-model-selection-collapsible.git#v0.2.2'
pnpm dlx "@deepseek-ai/dsh@$dshVersion" plugin --profile web ls --depth 0

升级时将 Git URL 的 tag 改为新发布版本，重新运行 add。安装后重启 DSH Web 并在浏览器中硬刷新；确认插件页无“异常”，模型菜单能展开、收起并完成选择。插件包名保持为 @local/dsh-ui-model-selection-collapsible，以兼容已有配置。不要使用旧版 ~/.dsh/profiles/node_modules 中的 CLI 来管理新版 Launcher 服务。

卸载

dsh plugin --profile web remove '@local/dsh-ui-model-selection-collapsible'

卸载后重启 DSH。官方模型选择器会继续提供默认席位。

本地开发

git clone https://github.com/ZoeHao2026/dsh-ui-model-selection-collapsible.git
Set-Location dsh-ui-model-selection-collapsible
pnpm install --frozen-lockfile
pnpm run verify

$sourceRoot = (Get-Location).Path
dsh plugin --profile web add "link:$sourceRoot"

pnpm run verify 会依次执行 TypeScript 类型检查、Vitest/jsdom 测试、bundle 构建和真实 lazy-CJS/apply 冒烟测试。仓库提交 lib/ 构建产物，CI 会在重新构建后验证产物没有差异。

设计边界

插件只替换 conversation.input.model 的可视席位，并通过官方 settings.section 扩展点添加自己的设置页。它不会修改 DSH 官方插件或模型选择 RPC，也不会注册 model locale。modelDirectories 服务延迟出现或卸载时，自定义席位不会挂载；目录接口不符合预期或席位同步渲染失败时，DSH 的席位错误边界会退让到官方席位。异步模型选择失败时保留菜单并显示错误，不会触发官方席位退让。设置外壳不存在时，仅隐藏设置页，不影响模型席位。

项目状态

这是独立的社区插件，并非 DeepSeek 官方项目。仓库通过 GitHub 的 dsh-plugin topic 加入 DSH 官方推荐的社区插件发现机制。

许可证

插件代码采用 MIT License。基于 DeepSeek Harness 的组件行为和样式，并在 bundle 中包含 clsx；完整归属与第三方许可证见 THIRD_PARTY_NOTICES.md 和 LICENSES。