dsh-model-picker-control

DSH 模型选择器总控 — 改名、分区、排序、隐藏、胶囊，一处搞定。

_{跨 provider 分区 · 改模型名与组名 · 拖拽排序 · 隐藏整个 provider 或单个模型 · 后缀胶囊 · 模型文件夹与额度接力 · 一键恢复}

dsh plugin add dsh-model-picker-control

--- ## 为什么做这个 DSH 自带的模型选择器很好用，但显示方式是固定的：provider 的先后顺序写死在代码里，模型名完全跟着目录走，也没办法把两个不同 provider 的模型放到一起。如果你有些模型走账号 provider、有些走合作方 provider，那你真正想要的那个列表从来就不存在。这个插件给你一个独立的设置页 —— 与自带的「模型」页平级 —— 由它接管选择器的**显示**，而不去修改任何第三方插件。把用不到的模型藏起来，把其余的重命名成一眼能认出的名字，把分组拖成你脑子里想问题的顺序，再把不同 provider 的模型合并进「免费」「实验」这样的分区。 ## 功能 | | | |---|---| | **什么都能改名** | 模型显示名、provider 分组名，以及每个模型后面的短后缀胶囊。 | | **跨 provider 分区** | 新建一个分区，把任何 provider 的模型丢进去，它们就渲染成同一组。 | | **拖拽排序** | 用左侧手柄拖动分组与分区（也可以聚焦手柄后按 ↑ ↓）。 | | **隐藏而非删除** | 用眼睛按钮隐藏单个模型；provider 卡片上的眼睛可一键隐藏或显示它的全部模型。目录本身不做任何改动。 | | **组内排序** | 目录原序、按名称或手动（在预览里拖动），可按组单独设置或全局默认。 | | **后缀胶囊** | 名字后面的原生风格小胶囊 —— 蓝 / 暗红 / 青 / 任意自定义颜色 / 炫彩边框 —— 与宿主的 `1017` 徽标并排显示。文字可以留空（只显示一块颜色）。每个分区都有「统一胶囊」，一键给分区内所有模型上同一种颜色；「清除空胶囊」一键移除所有没有文字的胶囊。 | | **模型文件夹** | 在预览卡片里把一行拖到同一分组内另一行的中间，即合并成一个文件夹（family）。文件夹在选择器里只占一行，可加胶囊，成员从上到下接力：请求遇到额度用尽、限流、鉴权失败、网络错误或服务商拒绝（HTTP 400/403/404）时，自动换到下一个成员并重发（等同于一次普通的手动切换模型）；失败的成员按原因停用：额度 / 鉴权到当天零点，网络错误 10 分钟，服务商拒绝 1 小时。被你手动隐藏、被隐藏或不在该文件夹所属分组内的成员会被跳过。文件夹提供第一个成员的推理档位；自动切换后使用新成员的最高档位；模型不提供的档位会在发请求前校正，不会再让整轮失败。完全独立，不依赖其他插件。 | | **分区标题** | 衬线粗体标题（拉丁字母内嵌 Playfair Display），底色从左到右渐隐。**设置 → 通用 → 分区标题艺术效果** 可关闭，恢复 DSH 原本的分区标题。 | | **预览与临时隐藏** | 实时预览卡片，显示选择器最终的样子：拖动调整顺序、展开文件夹，眼睛按钮可临时隐藏额度耗尽的模型（立即保存，无需再按**保存**）。 | | **草稿与保存** | 所有修改先留在本地草稿里，按**保存**才写入；带着未保存的修改离开会先问你。 | | **恢复默认** | 一键清空本插件的设置，回到宿主默认显示。 | ## 界面截图截图由本插件的真实构建产物加示例数据渲染（宿主界面是模拟的，插件代码不是）。选择器里有跨 provider 的 **免费**、**快速**、**旗舰** 分区，大部分名字后面带各种颜色的胶囊（蓝、暗红、青、自定义颜色、炫彩），还有一个只显示颜色的胶囊，以及一个**模型文件夹**（`DeepSeek V4.1 Flash`，标着 `Pool`）：它代表多个模型，其中一个额度用完时自动接力到下一个。

带跨 provider 分区、后缀胶囊与模型文件夹的模型选择器

炫彩胶囊是深紫色的底，彩虹边框缓慢旋转，边框上还有一小点浅色反光朝相反方向缓缓游走，紫色和青色两层光晕各按自己的节奏起伏。光晕只向外延伸几像素，刚好放得进输入框那一行。鼠标悬停时边框多转一圈、光晕变亮，但不会变大；键盘聚焦时出现一圈浅色轮廓。系统设置了「减少动态效果」时保留静态渐变边框，去掉所有动画：

边框旋转的炫彩胶囊

**设置 → 分组与分区** —— 拖动手柄把分组摆成你自己的顺序，改 provider 名或直接隐藏，新建一个分区把任意 provider 的模型并进来：

分组与分区页面

**设置 → 模型** —— 改显示名、填后缀胶囊并选颜色、加入某个分区，或者直接隐藏。没按**保存**之前什么都不会写入：

模型表格页面

**设置 → 选择器预览** —— 选择器最终渲染出来的样子。拖动一行可以调整顺序，拖到另一行的中间则把两者合并成文件夹，用眼睛按钮临时隐藏额度用完的模型（立即生效，无需**保存**）：

展开了模型文件夹的选择器预览

## 安装 ``` dsh plugin add dsh-model-picker-control ``` 然后重启 DSH。打开**设置**，自带「模型」页旁边会多出一个**模型选择器**页。想用本地构建的版本： ```bash git clone https://github.com/qzz19970504/dsh-model-picker-control.git cd dsh-model-picker-control npm install npm test npm pack # 生成 dsh-model-picker-control-<版本号>.tgz dsh plugin add ./dsh-model-picker-control-<版本号>.tgz ``` ## 快速上手 1. 打开**设置 → 模型选择器**。 2. 在**分组与分区**里点**新建**，起个名字，比如「免费」。 3. 在**模型**表格里，把想放进去的模型的分区下拉改成「免费」—— 来自哪个 provider 都行。 4. 拖动分组调整顺序，隐藏用不到的，给重要的模型加个后缀胶囊，比如 `NEW`、`便宜`。想给整个分区上同一种颜色，用它那一行的「统一胶囊」。 5. 可选：在预览卡片里把同一分组内的一个模型拖到另一个的中间，合并成一个从上到下接力的文件夹。 6. 点**保存**，然后打开输入框的模型选择器，立刻就是新的样子，不需要重启。 ## 配置所有内容都存在你 profile 配置里这个插件自己那一行（`config.picker`），通过宿主 settings 服务写入： ```yaml - id: model-picker-control name: 'dsh-model-picker-control' config: picker: version: 1 enabled: true # false = 恢复宿主显示，但保留这些设置 sectionOrder: [p:free, deepseek-official, workbuddy] providers: deepseek-account: { name: DeepSeek 账号, hidden: false } models: deepseek-official/deepseek-pro: { name: DeepSeek-V4.1-Pro, suffix: { text: 便宜, tone: red }, partition: p:free } workbuddy/step-5-preview: { suffix: { text: NEW, tone: cyan }, partition: p:free, hidden: false } partitions: - { id: p:free, name: 免费 } sort: { default: name, bySection: { workbuddy: catalog } } order: { p:free: [deepseek-official/deepseek-pro] } # 排序为手动时使用 tempHidden: [] # 预览里眼睛按钮的临时隐藏 badges: { show1017: true } headings: { art: true } ``` | 键 | 类型 | 说明 | |---|---|---| | `enabled` | boolean | `false` 时交还宿主的默认选择器，但保留你改的内容。 | | `sectionOrder` | string[] | 分组顺序，元素是 provider id 或 `p:<分区 id>`。 | | `providers[id].name` | string | 分组标题，留空 = 用目录里的名字。 | | `providers[id].hidden` | boolean | 隐藏整个 provider。 | | `models["provider/model"].name` | string | 显示名，留空 = 用目录里的名字。 | | `models["provider/model"].suffix` | `{text, tone, color?}` | `tone` 为 `blue` / `red` / `cyan` / `custom`（需要 `color`，`#rrggbb`，默认 `#ffffff`）/ `holo`。最多 20 个字符，`text` 可为空（只显示一块颜色）。 | | `models["provider/model"].partition` | string | 设为 `p:` 把它挪进某个分区。 | | `models["provider/model"].hidden` | boolean | 隐藏这一个模型。 | | `partitions[]` | `{id, name}` | 分区，用于把不同 provider 的模型合并成一组。 | | `sort.default` | `catalog` \| `name` \| `manual` | 组内排序方式。 | | `sort.bySection` | map | 单个分组单独指定排序。 | | `order` | map | 每个分组里 `provider/model` 的顺序列表，手动排序时使用。 | | `tempHidden` | string[] | 用预览里的眼睛按钮临时隐藏的模型，文件夹接力时同样跳过。 | | `badges.show1017` | boolean | 是否显示宿主模型上的 `1017` 徽标。 | | `headings.art` | boolean | 分区标题艺术效果（衬线字体加渐隐底色）。`false` 恢复 DSH 原本的分区标题。 | | `families[]` | `{id, name, section, suffix?, members: [{provider, model}]}` | 成员按从上到下的优先级排列。触发接力的错误：额度/鉴权类（`QUOTA`、`ACCOUNT_QUOTA`、`RATE_LIMIT`、`AUTH`）、网络类（`TRANSPORT`、`SERVER`、`TIMEOUT`）和服务商拒绝（HTTP 400/403/404）。 | ## 实现方式 ``` 输入框 ──► 插槽 conversation.input.model （single，session 作用域） │ ├─ 宿主 @deepseek-ai/dsh-client-ui-model-selection priority 0 └─ 本插件 dsh-model-picker-control priority -1 ← 生效，宿主座位变为 inactive │ │ ctx.modelDirectories.directoryFor(sessionId) ▼ 目录分组 ────────┐ 你的配置 ────────┴──► src/pipeline.js ──► 分组列表（顺序、改名、隐藏、分区） │ ┌────────────────┴────────────────┐ ▼ ▼ 选择器菜单与触发按钮 /model 弹窗的行 │ │ └────────► directory.select() ◄───┘ ``` - 选择器座位 `conversation.input.model` 是一个 single、session 作用域的插槽。插件以 priority `-1` 注册它，从而遮住宿主 priority `0` 的座位；关掉插件，宿主座位立刻回来。选中与切换、推理档位、搜索、键盘导航、pending 状态、subagent 会话不可用这些行为都是从宿主选择器移植而来，并沿用宿主的 `model` 词典。 - `/model` 弹窗走同一条显示管线，所以名字、分组、顺序、隐藏与选择器完全一致。行 id 仍然是 `provider/model`，因此真正切换模型的还是宿主自己的处理函数。 - 模型目录本身不做任何修改。插件读取 `ctx.modelDirectories.directoryFor(sessionId)`，把目录和你的配置组合成分组列表再渲染；选择模型依旧走 `directory.select()`。 - 隐藏只影响显示。已保存的选择即使变得不可见也不会被改动 —— 触发按钮回落到「请选择模型」，你可以重新选一个。 - 写入由宿主 settings 服务做版本校验，失败回滚，并且只碰本插件那一行 —— 不会重写整个 `cordis.patch.yml`。 - 文件夹接力在插件的宿主半运行。它监听 `agent/request-error`：遇到可接力的错误时，把出错的成员停用，用宿主自己的 `selectModel` 切换会话（因此会照常加入「模型已切换」提示），再返回 `{kind: "retry"}` 让请求重发。停用多久取决于错误类型：`QUOTA`、`ACCOUNT_QUOTA`、`RATE_LIMIT`、`AUTH` 停到当天零点；`TRANSPORT`、`SERVER`、`TIMEOUT`（宿主自带的重试用完后才会到这里）停 10 分钟；服务商以 HTTP 400/403/404 拒绝（`PROVIDER_HTTP_ERROR` 或 `INVALID_REQUEST`，状态码取自字段，或消息开头的 `400:` / `HTTP 400`）停 1 小时。上下文超长和其他错误码一律不接力。如果文件夹里每个成员都拒绝同一个请求，10 分钟和 1 小时的停用会被撤销，避免一个有问题的请求把整个文件夹锁住。同一次请求对每个成员最多重试一次。文件夹绑定和已停用的成员存放在 `/state/dsh-model-picker-control.json`（不放进 `picker` 配置，因为写配置会让宿主重新加载模型目录），所以重启 DSH 后仍然有效；到期或点成员上的「立即恢复」按钮即清除。关闭插件后，接力不再起作用。 - 选择器会把上一次成功的模型列表和每个会话最后用的模型存在浏览器的 `localStorage`（`dsh-model-picker-control/catalog`）。完全重启后，宿主要重建模型目录，每个 provider 适配器都要联网列出模型，可能要等很多秒；这时选择器先显示缓存内容。缓存只用于显示，真实列表一到就替换。 - 设置页跟随 GUI 语言提供中文与英文。 ## 常见问题 **会改动别的插件吗？** 不会。它只注册插槽，并在内存里包装宿主的 `/model` 贡献，dispose 时原样还原。 **我把正在用的模型藏了怎么办？** 已保存的选择会保留，触发按钮显示「请选择模型」，选择器里只列出还可见的模型，重选一个即可。 **设置存在哪？** 你的 DSH profile 配置里这个插件那一行，`config.picker`。**全部恢复默认**会清空它。 **能同时保留 `1017` 徽标和我自己的胶囊吗？** 可以，徽标和胶囊是两套独立的渲染，互不影响。 **subagent 会话里能用吗？** 和宿主行为一致：那里选择器显示为不可用。 ## 开发 ```bash npm install npm run build # 把 src/ 拼成 lib/client.js（不需要打包器） npm test # 纯函数管线测试（node:test） npm pack ``` 源码是纯 ESM + `h()` 调用 —— `src/pipeline.js` 是纯数据变换，也是测试覆盖的部分；`src/client/` 放插槽相关代码。 ## 许可 [MIT](./LICENSE)