双栏模型选择器 JuYueYe/dsh-personal-model-picker

dsh-personal-model-picker

DSH（DeepSeek Harness）的紧凑双栏模型选择器：左栏供应商、右栏模型，鼠标悬停左栏即切换右栏；输入框旁的触发器同时显示当前模型与推理等级。

双栏模型选择器

非官方插件，改编自官方包 @deepseek-ai/dsh-client-ui-model-selection（MIT，Copyright (c) 2026 DeepSeek），不是 DeepSeek 发布或背书的作品。

本仓库包含两个包

| 位置 | 包名 | 做什么 |
| 根目录 | dsh-personal-model-picker | 输入框旁的双栏模型选择器（就是下面这份文档） |
| packages/dsh-reasoning-effort | dsh-reasoning-effort | 设置 → 模型里每张 pi-ai 提供商卡片的模型目录编辑器：逐模型「思考模式」开关 + 七个档位勾选 + 批量开启思考模式 |

两者互相独立，可单独安装：

- 本包（根目录）按下方「怎么安装」用 github:JuYueYe/dsh-personal-model-picker 安装；
- 第二个包不能用同一个 github 规格装（那是根目录的包）。先克隆仓库，再按绝对路径安装子目录：

git clone https://github.com/JuYueYe/dsh-personal-model-picker

然后在 Plugins 页填 <克隆目录>/packages/dsh-reasoning-effort，或用 npm pack 打成 tgz 安装。

改了什么

它替换官方的模型入口，而不是叠加：bundle patch 先禁用官方 ui-model-selection 条目，再插入自己。相对官方，只有下面这些差异，功能语义保持一致。

| # | 变更点 | 官方 | 本插件 |
| 1 | 供应商 / 模型选择 | 逐级钻取：根菜单 → 该菜单里的模型列表 | 双栏并列：左供应商、右模型；悬停（或聚焦、点击）左栏即切换右栏，两栏各自滚动 |
| 2 | 面板高度 | 随内容变化 | 固定 348px（28px 列头 + 320px 模型列 + 卡片内边距），不随悬停供应商的模型数量变化 |
| 3 | 触发器 | 只显示模型名 | 模型名 + 推理等级 |
| 4 | 推理等级 | 根菜单里的一行 | 触发器上直接显示当前值，展开为独立一栏 |
| 5 | 与官方共存 | — | 互斥替换：cordis.patch.yml 里 disabled: true 官方入口 + insert 本插件 |
| 6 | 面板背景 | 玻璃质感：--dsw-menu-surface-fill（浅色 58% / 深色 45% 不透明）+ backdrop-filter: blur(40px) | 不透明：--dsw-alias-bg-layer-1（浅色 #fff / 深色 #232324），后方内容不会透出来 |

没有改的部分（与官方行为一致）：/model 命令照常可用；两个入口共用同一份 per-session 模型目录，从哪个入口改结果都一样；子代理会话一律不可选模型；目录加载失败时按供应商分组列出失败行并可重新加载。

为什么高度必须是常量：面板按下边缘定位（top = 触发器上沿 − 8 − 实测高度）。高度若跟随悬停供应商的模型数量变化，面板顶边就会上下移动，静止的指针下方随即换成另一个供应商，于是触发换栏、再次改变高度——形成「界面上下乱跳」的反馈环。固定高度后，悬停只切换右栏内容。

为什么背景要不透明：官方面板是浅色 58% / 深色 45% 不透明的填充，加 backdrop-filter: blur(40px) saturate(150%) 凑出来的玻璃质感。本插件不套那层模糊，若沿用同一个半透明填充，面板就会直接“看穿”到后面的正文与输入框。因此这里改用不透明的 --dsw-alias-bg-layer-1（浅色 #fff / 深色 #232324），随主题切换；模型列的吸顶表头用同一个 token。

版本与兼容

- 当前版本 1.1.2。已在 DSH 核心 0.2.0-rc.2（官方桌面端 nightly）实测通过；原始改编基线为 0.1.5-rc.2。
- 图标导出随核心版本改过名：0.1.5 时代是 IconXxx14 / IconXxx16，0.2.0-rc.2 起统一为 IconXxxRegular。本插件按 ...Regular 取名——名字对不上时图标取到 undefined，React 渲染 <undefined /> 会抛错，座位项被槽机制除名（abdicate），表现为模型入口整个消失（而不是样式错乱）。换核时先核对 @deepseek-ai/dsh-client-ui-primitives 的实际导出。
- 用词与官方对齐：推理等级（官方 menu.effort）。

怎么安装

1. 在 DSH 当前 profile 的 Plugins 页安装，填：

github:JuYueYe/dsh-personal-model-picker

需要钉死某个版本时加 ref：

github:JuYueYe/dsh-personal-model-picker#<commit>

安装时插件管理器会把本包追加进该 profile 的 dsh.profile.bundles 并默认启用；仅下载依赖不会启用 bundle patch，若装完没生效，先确认 bundles 列表里有它。

2. 刷新页面（Ctrl+R）。打包版里客户端插件的新增不会免刷新生效；若输入框旁仍无变化，重启宿主。

更新

依赖规格不带 ref 时，lockfile 会把 commit 钉住，直接重装通常显示 Already up to date 而拉不到新提交。任选其一：

cd <DSH_HOME>/profiles/<profile>
pnpm update dsh-personal-model-picker

- 卸载后重装；
- 或用带新 #<commit> 的规格安装。

卸载 / 回滚

停用该 bundle，或把它从 dsh.profile.bundles 移除，然后重启宿主，官方模型入口即恢复。本插件只禁用官方那一个 entry、不直接改官方文件，因此移除后不会留下需要手工修复的残留。

许可与来源

MIT，版权归上游，完整声明见 THIRD_PARTY_NOTICES.md。React 与 DSH 宿主服务由宿主提供，本包不随附另一套运行时。

- 官方元数据：https://registry.npmjs.org/@deepseek-ai%2fdsh-client-ui-model-selection/0.1.5-rc.2
- 上游仓库：https://github.com/deepseek-ai/deepseek-harness → packages/client/ui-model-selection

内部实现（界面细节、数据流、边界行为、字典、目录结构、构建与校验）见 docs/INTERNALS.md。