模型选择增强 ManoloRemiddi/dsh-model-picker-augmented

dsh-model-picker-augmented

MIT License — Copyright (c) 2026 Manolo Remiddi SPDX-License-Identifier: MIT — 完整许可文本见 LICENSE。

为 DeepSeek Harness 打造的可搜索、精选的 composer 模型选择器。

这个插件把 composer 里的模型选择器替换成可搜索版本，并新增 Model Picker Augmented 设置页，让你精确控制哪些模型出现在列表里、哪些固定在顶部。

功能

- 实时模型搜索 —— 模型列表顶部有搜索框，边输入边过滤，同时匹配模型名和服务商名。没有匹配项的组会消失；查询为空时恢复完整列表。
- 显示 / 隐藏模型 —— 在设置页里把从不使用的模型从选择器列表中隐藏。隐藏的模型仍会列在设置里（标记为 Hidden），随时可以恢复。
- 固定到顶部 —— 把常用模型固定住；它们会显示在模型列表最顶部的 Pinned 分区（并从下方所属服务商组里移除，避免重复）。在设置里用上下箭头调整顺序。
- 刷新服务商 —— 这个按钮先强制运行中的 harness 从磁盘重新读取 ~/.dsh/settings.yaml，这样你加进文件里的服务商和模型无需重启 harness 就能出现 —— 刷新完成时，文件里新增的服务商块已经生效。随后它重新读取实时目录，对每个有 baseURL 的启用服务商检查其端点，把文件里尚未列出的模型追加到 settings.yaml 中该服务商的 models 列表 —— 有 baseURL 但还没有 models 列表的服务商，一键就能自动补全，不用手动编辑。如果文件同步本身失败，刷新会继续并报告错误（settings.yaml sync failed: …）。页面还会跟随宿主推送的 harness 目录变更（设置提交、适配器重新注册、凭据更新），保持视图实时更新。
- 选择器其余部分完全保持原样：两级 Model/Effort 菜单、effort 等级、键盘导航、错误/重试状态，以及与 /model 命令的完整同步（两者共用同一个模型目录）。

要求

- DeepSeek Harness（dsh）>= 0.1.5-rc.1（已在 0.1.5-rc.1 上验证）
- web GUI 配置档（--profile web），它提供本插件所依赖的组件（@deepseek-ai/dsh-client-ui-conversation、@deepseek-ai/dsh-client-ui-settings、@deepseek-ai/dsh-client-ui-model-selection、@deepseek-ai/dsh-client-locale）。

安装

直接从 GitHub release 安装经过测试的 1.1.2 包：

dsh plugin --profile web add https://github.com/ManoloRemiddi/dsh-model-picker-augmented/releases/download/v1.1.2/dsh-model-picker-augmented-1.1.2.tgz

重启 DSH 并重新加载其网页。这个包通过 GitHub Releases 发布；没有发布到 npm。已经用 link: 方式安装的用户，应该把链接的 checkout 更新到 tag v1.1.2，而不是再装一份。保留你现有的设置和模型凭据。

源码安装：

这个插件是 DSH bundle 补丁包（和其他可热插拔的 web 插件同一套路）：

git clone --branch v1.1.2 --depth 1 https://github.com/ManoloRemiddi/dsh-model-picker-augmented.git
cd dsh-model-picker-augmented
pnpm install
dsh plugin --profile web add link:$(pwd)

pnpm install 不能省：link: 包会从自己的目录解析依赖，而 node 那一半需要 schemastery 来支撑持久化设置命名空间。然后重启 harness（或重新加载 web GUI）。此时 composer 的模型选择器已经变成可搜索的版本，并且 Settings → Model Picker Augmented 下会出现一个 Model Picker Augmented 页面。

卸载：

dsh plugin --profile web remove dsh-model-picker-augmented

用法

1. 打开任意会话，点击 composer 工具行最右端的模型选择器。
2. 输入 Model 打开列表——在顶部的搜索框里输入内容即可过滤（比如 qwen 只显示 Qwen 模型以及提供这些模型的服务商；清空搜索框就重新显示全部）。
3. 打开 Settings → Model Picker Augmented 进行整理：
- 每个模型的 Visible / Hidden 开关（隐藏的模型会从选择器里消失，但仍列在这里，随时可以重新启用）。
- 每个模型的 Pin to top，配合上下箭头调整置顶区的顺序。
- Refresh providers 用来把运行中的 harness 与 settings.yaml 同步（通过文件添加的服务商和模型无需重启即可出现），并检查服务商端点是否有新模型；详见下面的 How it works。

工作原理

- 浏览器那一半以 shadowing 优先级注册进 composer 的具名模型席位（conversation.input.model），并注册进设置面板（settings.section）。
- 模型数据来自 harness 本身：选择器读取的是内置选择器所用的同一份按会话的 advisory directory（modelDirectories 服务），设置页面则通过 Remote API（remote.session.modelCatalog）拉取全局目录。插件不额外添加任何模型数据——如果某个模型没出现在选择器里，那它就不在你配置的服务商目录中（见下文）。
- 整理结果（隐藏的模型 + 置顶顺序）持久保存在你的机器上：node 那一半注册了 model-picker-augmented 设置命名空间，每次改动都通过 harness 设置系统写入 ~/.dsh/settings.yaml（model-picker-augmented: { hidden: …, pinned: … }），所以你的置顶和隐藏模型能扛过页面刷新、浏览器重启和机器重启。启动时，浏览器那一半会用存储的值给选择器做水合。
- Refresh providers（设置页面）分两个阶段运行，只有你点击时才执行：
1. 让 harness 与 settings.yaml 同步。 它通过 settings commit API 向插件自己的 model-picker-augmented 命名空间发起一次空写。每次写 settings 都会强制 harness 在持久化之前从磁盘重新读取 settings.yaml；任何已经漂移的文件——harness 运行期间手动添加的服务商或模型——都会经由正常的 settings 管道重新发布，于是它们的路由会实时重新注册，无需重启。只有插件的 curation 段会被重写；文件的其他所有段原样通过（注释也保留）。如果这一步失败，刷新会继续使用内存中的目录，并报告 settings.yaml sync failed: …。
2. 重新读取目录并同步端点。 接着它获取 remote.session.modelCatalog（目录 + 各服务商的失败信息）、remote.llm.listProviders 和 remote.llm.listConfigurableProviders（活动路由及其 settings 位置），以及 remote.settings.describe（当前 llm-pi-ai 配置档 + revision）。对于每个带 baseURL 的活动服务商，只要其分组提供真实模型，它就会针对该 baseURL 调用 remote.llm.discoverModels（自动使用已存储的凭据），并把文件中尚未列出的模型追加到该服务商的 models 列表，写入一次带 revision 校验的 settings.mutate；如果服务商有 baseURL 但还没有 models 列表，则把返回结果直接采纳为完整列表。缺失的 name/contextWindow/maxTokens 用 harness 默认值补齐。写入走 settings commit API（不是直接改文件），所以 settings.yaml 始终是唯一事实来源，运行中的 harness 会立即采用新模型；composer 选择器则通过宿主的 settings/document-updated / llm/adapters-updated 事件跟进。

除此之外不写任何东西：阶段 1 只动 model-picker-augmented 段，阶段 2 只做追加——已有的模型条目绝不重写，没有 baseURL 的服务商直接跳过。

关于模型可用性的说明

选择器只能显示本地已安装的服务商目录所知道的模型。zai 和 openrouter 服务商会回退到内置的 pi-ai 目录，除非它们在 settings.yaml 中的 llm-pi-ai 配置档带有显式的 models 列表（此时该列表会替换内置目录）。服务商新公布的模型（比如新的 GLM 或 Qwen 档位）只有加进该列表后才会出现。

添加服务商已公布但你的目录缺少的模型

最快的路径是 Model Picker Augmented 页面上的 Refresh providers 按钮：在 settings.yaml 的 llm-pi-ai.providers 下添加一个服务商块（给它一个 baseURL，如果端点需要就再加 API key），然后点击 Refresh。Refresh 会先让运行中的 harness 与文件同步——无需重启需要时，它会从端点拉取服务商的模型列表，并写入 settings.yaml。你也可以用内置的 Settings → Models 页面（它的 fetch-from-endpoint 流程会从服务商拉取当前目录），或者直接编辑 ~/.dsh/settings.yaml。每个条目需要 id、name、contextWindow 和 maxTokens（正整数）。因为显式的 models 列表会替换内置目录，所以要把你想看到的每一个模型都列出来——省略的条目会从选择器里消失：

~/.dsh/settings.yaml — llm-pi-ai section (example: Z.ai) llm-pi-ai: providers: zai: apiKeyEnv: ZAI_API_KEY models:
- id: glm-4.5-air
name: GLM-4.5-Air
contextWindow: 131072
maxTokens: 98304
- id: glm-5.3
name: GLM-5.3
contextWindow: 1048576
maxTokens: 131072
- id: glm-5.3-flash
name: GLM-5.3-Flash
contextWindow: 1048576
maxTokens: 131072
…plus every other zai model you want to keep

openrouter 也一样（例如 qwen/qwen3.8-max）。改完文件后，下次点 Refresh providers 时运行中的 harness 就会读取：Refresh providers 先把 settings.yaml 同步进 harness（不用重启），再检查端点有没有新模型。如果 Refresh 报出 settings.yaml sync failed: …，说明文件没有生效——检查 YAML（比如声明了服务商却没有目录条目，就需要 baseURL），然后重新点 Refresh。真实规格来自服务商（Z.ai 文档、OpenRouter）——或者让 fetch-from-endpoint 流程帮你填。

License

MIT — Copyright (c) 2026 Manolo Remiddi. See LICENSE.

每个源文件都带有 MIT 头；package.json 通过 license 和 author 字段声明。

DSH 0.1.5 compatibility (1.1.2)

1.1.1 版使用了已移除的 connection.api 浏览器接口，可能让 DSH GUI 停摆，报错 “Cannot read properties of undefined (reading settings)”。1.1.2 版声明了作用域内的 remote.settings、remote.llm 和 remote.session 依赖，并使用它们当前的方法、位置参数和 Result 值。Pins 和隐藏模型保留原有的 settings 命名空间与格式。

运行 pnpm test 可覆盖客户端初始化、curation 写入、服务商发现、带修订检查的模型添加和目录错误的回归测试。测试使用内存中的 settings 服务，绝不访问凭据或线上模型端点。

2026-09-10 用 DSH 0.1.5-rc.1 和 Chromium 152 验证：完整的 DSH GUI 加载时没有插件失败，composer 搜索能过滤模型，settings 目录正常渲染，pin 在页面重载后依然保留。临时测试 pin 已移除，原有 curation 设置确认完好。