@huai_xin/dsh-model-picker 0.1.2 → 0.2.0

package/README.md

@@ -12,6 +12,13 @@ DSH 自带的模型选择器是按两级菜单设计的。模型一多，找一
 
 **和官方选择器共用一份状态** — 不是另起炉灶。它复用 DSH 自己的 `modelDirectories` 服务，所以你在输入框里选的模型，和 `/model` 命令弹窗里看到的，永远是同一个。切换过程中（Host 还没确认时）两个入口都会显示"正在切换"。
 
+**搜索跟官方同一套算法** — 有序子序列匹配、前缀优先，`gpt61` 也能找到 `GPT-6.1-Sol`；模型 id 同样是搜索键。
+
+**切档位失败会告诉你** — 提示框挂在控件上方，默认收起，点开才显示原始的 `code: message`。
+
+**档位是一条能拖的滑杆** — 轨道上是各档位的刻度，拖动时滑块跟手，松手才提交一次。滑块整个
+待在轨道里面，不会压出边界；面板是紧凑尺寸，不占半个屏幕。
+
 **跟着模型列表实时变** — 别的插件改了可用模型（开关模型、导入账号、探测到模型不可用……），这个列表会立刻跟着变，不用刷新页面。
 
 **新会话显示默认模型** — 而不是空着或显示"没有可用模型"。
@@ -34,15 +41,23 @@ dsh plugin --profile <你的 profile> add /path/to/dsh-model-picker
 
 不想要了就直接停用或移除这个 bundle，不会影响模型本身是否可用。
 
-## 已知限制
+## 和官方选择器的关系
+
+**只换界面，不换数据。** 模型列表、当前选择、切换、失效刷新——这些都还是 DSH 官方 `ui-model-selection` 的实现，本插件通过它的 `modelDirectories` 服务读取。所以：
+
+- 你在 `/model` 命令里看到的和输入框里看到的，永远是同一个选择
+- 官方插件升级后，数据层的行为会自动跟着变
 
-**会丢掉 provider 插件挂在模型名上的装饰。** DSH 官方选择器声明了一个子槽位 `conversation.input.model.label`，provider 插件往那里挂徽标、可用性提示、促销标记之类的东西。替换者没法继承这个声明——子槽位只能声明一次，官方占用者即使被压住不渲染，它的声明依然有效。所以在这个选择器里，模型名后面不会有那些装饰。
+有一处**已知差异**：provider 插件挂在模型名上的徽标（`conversation.input.model.label`
+子槽位）在这里**不会显示**，模型名回落成纯文本。原因是子槽位声明按 key 独占，官方占用者已经
+声明了它，本插件再声明会直接抛 `already declared`，整个选择器停摆——见
+[AGENTS.md](AGENTS.md) 不变量 2。取舍是：能用的选择器，好过带徽标但不渲染的选择器。
 
-想同时要装饰和这套交互，只能停用官方的 `ui-model-selection` bundle，代价是它的 `/model` 命令一起消失。这是 DSH 槽位架构的限制，不是本插件能绕过的。
+本插件替换的只是那层 UI：把两级菜单换成一次点开的可搜索列表，把思考档位拆成独立控件。
 
 ## 兼容性
 
-需要 DSH `0.2.1-rc` 及以上。模型数据全部走 DSH 自己的 client remote（`session.modelCatalog` / `session.selectModel`），插件本身不认识任何具体 provider——任何 provider 插件注册的模型都会出现在列表里。
+需要 DSH `0.2.1-rc` 及以上。插件本身不认识任何具体 provider——任何 provider 插件注册的模型都会出现在列表里。
 
 ## 开发