@nimoxie/dsh-model-organizer 0.3.4 → 0.3.6

package/{DEVELOPING.md → DEVELOPMENT.md}

@@ -1,72 +1,75 @@
-# 开发笔记
-
-面向改这个插件的人。用户文档在 [README.md](./README.md)。
-
-## 升级 DSH 后座位凭空消失？先查服务名
-
-cordis 的 `ctx.inject([...])` **只要有一个服务永不出现，回调就永远不执行** —— 不报错、不打日志。所以服务改名会让整个座位静默消失。
-
-已发生一次：0.1.7 把客户端设置镜像服务 `settingsScope` 改名为 `configForms`（提供者仍是 `@deepseek-ai/dsh-client-ui-settings`，`describe()` 返回同一个 mirror）。设置页浮窗因此消失，而输入框菜单照常（它注入的 `slots/modelDirectories/sessions` 没变）。
-
-`apply()` 里同时注入两个名字，一次性标志保证只挂载一次：
-
-```js
-ctx.inject(["slots", "configForms", "remote", "remote.settings"], (s) => mountOrderPanel(s, s.configForms.describe()));
-ctx.inject(["slots", "settingsScope", "remote", "remote.settings"], (s) => mountOrderPanel(s, s.settingsScope.describe()));
-```
-
-**规律**：升级后座位不见了，第一件事是去新版 `dsh-client-ui-*` 包里 grep 自己注入的每个服务名。
-
-## 座位的失败模式（决定了代码结构）
-
-- **条目渲染时抛错 → 被静默弃权，官方内置 UI 自动回填**，界面上没有任何提示。
-- **座位注册本身失败 → 该座位静默消失**，其它功能不受影响。
-- 所以：每个座位注册各套一层 `guard`（失败只记 warn，不拖垮插件）；组件外套 `PanelBoundary`（把抛错变成页面上的一行红字，而不是"凭空消失"）。
-- **顶层 `inject` 必须列全座位 standardProps 会读的每个服务**（本插件：`locale, slots, sessions, remote, remote.session, remote.settings`）。少一个 → 渲染抛 `cannot get property "..." without inject` → 弃权。用 `remote.settings.mutate` 必须显式声明 `remote.settings`。
-- `single` 座位在**同一优先级已有注册**时会直接抛错。不写 `priority` 时，运行时会为非 chain 座位自动分配一个唯一的优先级（后注册的更低，渲染时胜出），所以只有显式写了撞车的 `priority` 才会抛。
-- 未声明的局部变量（`ReferenceError`）同样会导致弃权，表现就是"整个面板不见了"。
-
-## 与官方模块的耦合
-
-- **官方 CSS-module 类名靠运行时解析**：锚定只有该模块才有的类名，并用第二个类名（如 `_optionCopy`）校验；解析失败退回内置回退样式（功能可用、外观降级）。
-- **官方菜单规则长期缺 `background` 和 `border-radius`**：0.1.7-rc.1 的构建把这两条属性丢了（源码里是 `var(--dsw-specific-menu)` 和 `16px`），0.2.0-rc.1 依旧如此、类名 hash 还是 `_7KE1Ra`，官方菜单本身仍是全透明+直角。本插件不依赖那条规则：运行时从 `document.body` 解析 `--dsw-specific-menu` 内联补上背景，并补 `var(--dsw-radius-lg)` 圆角。
-- **0.2.0 起 `--dsw-specific-menu` 变成半透明**（=`--dsw-menu-surface-fill`，浅色 `#f8f9fa94` / 深色 `#43454a73`）。官方菜单的"磨砂"其实是 **`MenuSurface` 原语**的 material 层：半透明填充 + `--dsw-menu-backdrop-filter` 模糊；`_menu` 类只管几何（且长期缺 background）。只把 token 内联当背景、没有模糊，观感是"透"而不是"磨砂"——composer 菜单已改走 `MenuSurface`，内联 token 只作为原语缺失时的回退。
-- **composer 菜单的层级跟官方 `ModelSelect` 对齐**：根层 = 「模型 / 推理等级」两个 cell，各 drill 进自己的列表；「模型」层放本插件的改进（供应商分组、可折叠、按保存顺序），「推理等级」层是官方样式的单选列表。无返回行（官方就没有）：Esc 逐层返回，选中或点外部关闭。↑/↓ 在当前层循环移焦点，drill/返回时焦点交接（进层聚焦首行或搜索框，回根层聚焦首 cell）。搜索框（rc.2+）也照搬：>4 个模型才出现、`rankByName` 排序、清除按钮回焦输入框、搜索时强制展开全部分组；rc.1 的样式表没有 search 类，解析器以 `hasSearchRow` 探测，没有就不渲染。**portal 必须作为根 div 的 React 子节点**（合成事件沿 React 树冒泡而非 DOM 树），否则菜单内的 ↑/↓ 收不到。
-- **0.2.0-rc.2 的 CSS hash 从 `_7KE1Ra` 变为 `_wq12jW`**（新增 search 类所致），`.menu` 规则逐属性未变——运行时解析不受影响，但别在任何地方硬编码 hash。
-- **选择失败走官方 Toast**（`P.Toast`，`text/icon/anchor/onDone`）报错，不静默；select 面具把 `RemoteResult.error` 透传给组件。**设置页卡片顺序用 CSS `order` 镜像**（`.rows` 本就是 flex column）：卡片 DOM 里没有供应商标识，按 `rowName` 文本↔`displayName` 匹配，同名供应商会歧义；镜像锚在 seat 原位的隐藏标记上，MutationObserver 兜底卡片增删。
-- **0.2.0-rc.1 核验记录**：`configForms` 仍在、`settingsScope` 已彻底移除（`apply()` 里双注入两个名字的写法继续有效）；`settings.models.footer` 与 `conversation.input.model` 两个座位均未改名；官方 CSS hash 未变，运行时类名解析不用改。
-- **浮层必须 `ReactDOM.createPortal` 到 `document.body`**：座位在设置页很深的子树里，`position: fixed` 会被困在那个子树的堆叠上下文，被别的插件的悬浮组件盖住 —— 提高 z-index 也没用。
-- **不要占用 `settings.models.provider-card`**：它是 keyed 座位，key 是供应商的 settings namespace，已被 `@linxin666/dsh-client-ui-model-capabilities` 占用；keyed 座位一个 key 只留一个占用者，同 key 同优先级注册会抛错（而且对方用 try/catch 吞掉，等于静默压制它）。本插件只用自己的 `settings.models.footer`（list 座位，按 id 去重）。
-
-## 开发环境
-
-- **`file:` 依赖是打包快照，`link:` 才是符号链接。** profile 里写 `"file:../../../dsh-model-organizer"` 时 pnpm 把目录打包**复制**进 store，DSH 加载的是 `profiles/<p>/node_modules/.../lib/client.js` 那份副本 —— 改仓库**不生效**。
-  排查：grep 那份副本的 `BUILD` 常量，和仓库对比。
-  修法：`dsh plugin --profile web remove dsh-model-organizer && dsh plugin --profile web add link:./dsh-model-organizer`
-- **改完要 Ctrl+Shift+R**：客户端 bundle 以 `Cache-Control: immutable, max-age=31536000` 下发，且 URL 不随代码变化，普通刷新一直用缓存。
-- **浏览器侧（`lib/client.js`）只需 `react` / `react-dom` / `@deepseek-ai/dsh-client-ui-primitives`**——三者都是 shell 内置提供给插件的模块（PLATFORM_MODULES），所以 `dsh.client` 里不需要 `external` 声明。
-- profile bundle 必须声明 `dsh.bundle.patch`（指向 `cordis.patch.yml`），否则 dsh 启动即报 `declares no dsh.bundle`。
-
-## 写 UI 时踩过的坑
-
-- **primitives 的新组件（MenuSurface/Input/StateDot 等）是 `React.forwardRef` 包装的——是对象不是函数**。`typeof X === "function"` 永远为 false，所有这类门控静默失败、全部走降级路径（本插件因此丢过 MenuSurface 的磨砂和整个搜索框）。组件判定用 `isComponent`：函数，或带 `.render` 函数的对象。`rankByName` 这类工具函数才是真函数。
-
-- **边框必须用 longhand**（`borderWidth/borderStyle/borderColor`）。用 shorthand `border` 再叠加 `borderColor` 时 React 会展开 shorthand；回退时移除 `borderColor`，`border-color` 落回 `currentColor` → "拖拽结束后高亮边框一直不消失"。
-- **拖拽会把源行留在焦点上**：行加 `tabIndex:-1`，drop/dragend 时 `blur()`；并且不要给行画 `:focus-visible` 背景（官方 `option` 类自带一条 → "拖完还留一块灰底"）。
-- **原生拖拽会让文字变成可拖对象**（浏览器弹「松开鼠标即可搜索」）：`-webkit-user-drag:none` 加在**行的内容**上，不要加在行本身（加在行上会让行也拖不动）。
-- **drop 会在行与容器上各触发一次**（冒泡），需加锁，否则重复写入。
-- **primitive 图标不转发 inline `style`**：需要旋转/变色请传 `className`。
-- **`providers` 是 record，键顺序由宿主规范化**：整体 `set` 与 `unset`+`set` 都实测无效，所以供应商顺序只能存 `localStorage`（模型顺序是数组，可以写进文档）。
-
-## 发版
-
-```sh
-# npm 不允许覆盖已发布的版本号：先升版本，再提交，最后发布
-npm version patch        # 或手改 package.json 的 version
-git add -A && git commit -m "..." && git push
-npm publish
-```
-
-发布需要带 **Bypass 2FA** 的 Granular Access Token（npm 2025-11 起只支持 granular token）：npmjs.com → 头像 → Access Tokens → Generate New Token → Packages 选 **All Packages + Read and write (publish and stage)**、**Organizations 选 No access**、勾 **Bypass two-factor authentication**；然后 `npm config set //registry.npmjs.org/:_authToken=npm_xxx`（写进用户级 `.npmrc`，不要放进仓库）。
-
-包是 scoped 名（`@nimoxie/dsh-model-organizer`，用户作用域），`publishConfig.access: "public"` 已写进 package.json，`npm publish` 不用再带参数。老的无作用域名 `dsh-model-organizer` 已停更，记得发一次 `npm deprecate dsh-model-organizer "已迁移到 @nimoxie/dsh-model-organizer"` 留路标。
+# 开发笔记
+
+面向改这个插件的人。用户文档在 [README.md](./README.md)。
+
+## 升级 DSH 后座位凭空消失？先查服务名
+
+cordis 的 `ctx.inject([...])` **只要有一个服务永不出现，回调就永远不执行** —— 不报错、不打日志。所以服务改名会让整个座位静默消失。
+
+已发生一次：0.1.7 把客户端设置镜像服务 `settingsScope` 改名为 `configForms`（提供者仍是 `@deepseek-ai/dsh-client-ui-settings`，`describe()` 返回同一个 mirror）。设置页浮窗因此消失，而输入框菜单照常（它注入的 `slots/modelDirectories/sessions` 没变）。
+
+`apply()` 里同时注入两个名字，一次性标志保证只挂载一次：
+
+```js
+ctx.inject(["slots", "configForms", "remote", "remote.settings"], (s) => mountOrderPanel(s, s.configForms.describe()));
+ctx.inject(["slots", "settingsScope", "remote", "remote.settings"], (s) => mountOrderPanel(s, s.settingsScope.describe()));
+```
+
+**规律**：升级后座位不见了，第一件事是去新版 `dsh-client-ui-*` 包里 grep 自己注入的每个服务名。
+
+## 座位的失败模式（决定了代码结构）
+
+- **条目渲染时抛错 → 被静默弃权，官方内置 UI 自动回填**，界面上没有任何提示。
+- **座位注册本身失败 → 该座位静默消失**，其它功能不受影响。
+- 所以：每个座位注册各套一层 `guard`（失败只记 warn，不拖垮插件）；组件外套 `PanelBoundary`（把抛错变成页面上的一行红字，而不是"凭空消失"）。
+- **顶层 `inject` 必须列全座位 standardProps 会读的每个服务**（本插件：`locale, slots, sessions, remote, remote.session, remote.settings`）。少一个 → 渲染抛 `cannot get property "..." without inject` → 弃权。用 `remote.settings.mutate` 必须显式声明 `remote.settings`。
+- `single` 座位在**同一优先级已有注册**时会直接抛错。不写 `priority` 时，运行时会为非 chain 座位自动分配一个唯一的优先级（后注册的更低，渲染时胜出），所以只有显式写了撞车的 `priority` 才会抛。
+- 未声明的局部变量（`ReferenceError`）同样会导致弃权，表现就是"整个面板不见了"。
+
+## 与官方模块的耦合
+
+- **官方 CSS-module 类名靠运行时解析**：锚定只有该模块才有的类名，并用第二个类名（如 `_optionCopy`）校验；解析失败退回内置回退样式（功能可用、外观降级）。
+- **官方菜单规则长期缺 `background` 和 `border-radius`**：0.1.7-rc.1 的构建把这两条属性丢了（源码里是 `var(--dsw-specific-menu)` 和 `16px`），0.2.0-rc.1 依旧如此、类名 hash 还是 `_7KE1Ra`，官方菜单本身仍是全透明+直角。本插件不依赖那条规则：运行时从 `document.body` 解析 `--dsw-specific-menu` 内联补上背景，并补 `var(--dsw-radius-lg)` 圆角。
+- **0.2.0 起 `--dsw-specific-menu` 变成半透明**（=`--dsw-menu-surface-fill`，浅色 `#f8f9fa94` / 深色 `#43454a73`）。官方菜单的"磨砂"其实是 **`MenuSurface` 原语**的 material 层：半透明填充 + `--dsw-menu-backdrop-filter` 模糊；`_menu` 类只管几何（且长期缺 background）。只把 token 内联当背景、没有模糊，观感是"透"而不是"磨砂"——composer 菜单已改走 `MenuSurface`，内联 token 只作为原语缺失时的回退。
+- **composer 菜单的层级跟官方 `ModelSelect` 对齐**：根层 = 「模型 / 推理等级」两个 cell，各 drill 进自己的列表；「模型」层放本插件的改进（供应商分组、可折叠、按保存顺序），「推理等级」层是官方样式的单选列表。无返回行（官方就没有）：Esc 逐层返回，选中或点外部关闭。↑/↓ 在当前层循环移焦点，drill/返回时焦点交接（进层聚焦首行或搜索框，回根层聚焦首 cell）。搜索框（rc.2+）也照搬：>4 个模型才出现、`rankByName` 排序、清除按钮回焦输入框、搜索时强制展开全部分组；rc.1 的样式表没有 search 类，解析器以 `hasSearchRow` 探测，没有就不渲染。**portal 必须作为根 div 的 React 子节点**（合成事件沿 React 树冒泡而非 DOM 树），否则菜单内的 ↑/↓ 收不到。
+- **0.2.0-rc.2 的 CSS hash 从 `_7KE1Ra` 变为 `_wq12jW`**（新增 search 类所致），`.menu` 规则逐属性未变——运行时解析不受影响，但别在任何地方硬编码 hash。
+- **选择失败走官方 Toast**（`P.Toast`，`text/icon/anchor/onDone`）报错，不静默；select 面具把 `RemoteResult.error` 透传给组件。**设置页卡片顺序用 CSS `order` 镜像**（`.rows` 本就是 flex column）：卡片 DOM 里没有供应商标识，按 `rowName` 文本↔`displayName` 匹配，同名供应商会歧义；镜像锚在 seat 原位的隐藏标记上，MutationObserver 兜底卡片增删。**未匹配的卡片（官方供应商、添加草稿）刻意钉在最前**：给它们写空 `order`（默认值 0）而不是 `1000+`，既排在已配置供应商之前，又顺手清掉历史脏值。观察器盯的是**容纳列表的区段容器**、而不是列表本身——列表会被 React 整体替换，盯它就会在替换后失效；另加 rAF + 300ms 两次兜底，覆盖首屏卡片晚到的那一趟。**对话框菜单里未匹配的供应商同样置顶**：`applyProviderOrder(ids, preferred, true)`，且 id 按最后一段比较（菜单给的是路由 id `llm-pi-ai/amd`，设置页存的是 `amd`）。
+- **0.2.0-rc.1 核验记录**：`configForms` 仍在、`settingsScope` 已彻底移除（`apply()` 里双注入两个名字的写法继续有效）；`settings.models.footer` 与 `conversation.input.model` 两个座位均未改名；官方 CSS hash 未变，运行时类名解析不用改。
+- **浮层必须 `ReactDOM.createPortal` 到 `document.body`**：座位在设置页很深的子树里，`position: fixed` 会被困在那个子树的堆叠上下文，被别的插件的悬浮组件盖住 —— 提高 z-index 也没用。
+- **不要占用 `settings.models.provider-card`**：它是 keyed 座位，key 是供应商的 settings namespace，已被 `@linxin666/dsh-client-ui-model-capabilities` 占用；keyed 座位一个 key 只留一个占用者，同 key 同优先级注册会抛错（而且对方用 try/catch 吞掉，等于静默压制它）。本插件只用自己的 `settings.models.footer`（list 座位，按 id 去重）。
+
+## 开发环境
+
+- **`file:` 依赖是打包快照，`link:` 才是符号链接。** profile 里写 `"file:../../../dsh-model-organizer"` 时 pnpm 把目录打包**复制**进 store，DSH 加载的是 `profiles/<p>/node_modules/.../lib/client.js` 那份副本 —— 改仓库**不生效**。
+  排查：grep 那份副本的 `BUILD` 常量，和仓库对比。
+  修法：`dsh plugin --profile <profile> remove @nimoxie/dsh-model-organizer && dsh plugin --profile <profile> add link:./dsh-model-organizer`
+- **改完要 Ctrl+Shift+R**：客户端 bundle 以 `Cache-Control: immutable, max-age=31536000` 下发，且 URL 不随代码变化，普通刷新一直用缓存。
+- **浏览器侧（`lib/client.js`）只需 `react` / `react-dom` / `@deepseek-ai/dsh-client-ui-primitives`**——三者都是 shell 内置提供给插件的模块（PLATFORM_MODULES），所以 `dsh.client` 里不需要 `external` 声明。
+- profile bundle 必须声明 `dsh.bundle.patch`（指向 `cordis.patch.yml`），否则 dsh 启动即报 `declares no dsh.bundle`。
+
+## 写 UI 时踩过的坑
+
+- **primitives 的新组件（MenuSurface/Input/StateDot 等）是 `React.forwardRef` 包装的——是对象不是函数**。`typeof X === "function"` 永远为 false，所有这类门控静默失败、全部走降级路径（本插件因此丢过 MenuSurface 的磨砂和整个搜索框）。组件判定用 `isComponent`：函数，或带 `.render` 函数的对象。`rankByName` 这类工具函数才是真函数。
+- **图标名要用 primitives 实际导出的名字**：只有 `IconXxxOutlineRegular` / `IconXxxOutlineMedium` / `IconXxxFillRegular` 这类后缀，**没有 `IconXxxOutline16`/`14` 尺寸数字名**。猜错名字 `icon()` 静默返回 null——本插件的勾、分组箭头因此从第一版起就没渲染过，靠触发器的文字兜底掩盖至今。发新图标前先 grep 导出表。
+
+- **边框必须用 longhand**（`borderWidth/borderStyle/borderColor`）。用 shorthand `border` 再叠加 `borderColor` 时 React 会展开 shorthand；回退时移除 `borderColor`，`border-color` 落回 `currentColor` → "拖拽结束后高亮边框一直不消失"。
+- **拖拽会把源行留在焦点上**：行加 `tabIndex:-1`，drop/dragend 时 `blur()`；并且不要给行画 `:focus-visible` 背景（官方 `option` 类自带一条 → "拖完还留一块灰底"）。
+- **原生拖拽会让文字变成可拖对象**（浏览器弹「松开鼠标即可搜索」）：`-webkit-user-drag:none` 加在**行的内容**上，不要加在行本身（加在行上会让行也拖不动）。
+- **drop 会在行与容器上各触发一次**（冒泡），需加锁，否则重复写入。
+- **primitive 图标不转发 inline `style`**：需要旋转/变色请传 `className`。
+- **`providers` 是 record，键顺序由宿主规范化**：整体 `set` 与 `unset`+`set` 都实测无效，所以供应商顺序只能存 `localStorage`（模型顺序是数组，可以写进文档）。
+
+## 发版
+
+```sh
+# npm 不允许覆盖已发布的版本号：先升版本，再提交，最后发布
+npm version patch        # 或手改 package.json 的 version
+git add -A && git commit -m "..." && git push
+npm publish
+```
+
+发布需要带 **Bypass 2FA** 的 Granular Access Token（npm 2025-11 起只支持 granular token）：npmjs.com → 头像 → Access Tokens → Generate New Token → Packages 选 **All Packages + Read and write (publish and stage)**、**Organizations 选 No access**、勾 **Bypass two-factor authentication**；然后 `npm config set //registry.npmjs.org/:_authToken=npm_xxx`（写进用户级 `.npmrc`，不要放进仓库）。
+
+包是 scoped 名（`@nimoxie/dsh-model-organizer`，用户作用域），`publishConfig.access: "public"` 已写进 package.json，`npm publish` 不用再带参数。老的无作用域名 `dsh-model-organizer` 已停更，记得发一次 `npm deprecate dsh-model-organizer "已迁移到 @nimoxie/dsh-model-organizer"` 留路标。
+
+**改包名是牵一发动全身的**——包名是宿主解析插件的文件系统坐标，不止 package.json：`cordis.patch.yml` 的 `insert.name`（按包名从 node_modules 找插件，找不到则插件整体不加载）、`lib/client.js` 的 `__ModuleLoader__.load({ id })`（模块 id 必须等于包名，否则 bundle 二次执行时被判定为重复抢注，boot 直接失败）。localStorage 键和 locale 命名空间是纯数据键，刻意不改（改了丢用户排序数据）。

package/README.md

@@ -4,53 +4,54 @@
 
 ## 它解决什么问题
 
-官方那个模型下拉是一个扁平长列表——供应商只是粘性小标题，模型多的时候要滚很久，也没法按自己的习惯排序。这个插件把它改成两级：**先看供应商，点开才看模型**，并且供应商和模型的顺序都能直接拖。
+官方那个模型下拉是一个扁平长列表——供应商只是粘性小标题，模型多的时候要滚很久，也没法按自己的习惯排序。这个插件把它改成两级：**根层先选「模型」或「推理等级」，模型层里按供应商分组**，供应商和模型的顺序都能直接拖。
 
 ## 功能
 
 **输入框的模型菜单**
-- 根层与官方一致：「模型」「推理等级」两个入口（推理等级只在模型声明了等级时出现，怎么声明见下文）
-- 「模型」里保留本插件的改进：按供应商分组、可折叠，顺序与设置页浮窗一致，当前模型打 ✓
+- 根层与官方一致：「模型」「推理等级」两个入口——「推理等级」**常驻**，未配置等级的模型上置灰、不可点
+- 「模型」里保留本插件的改进：按供应商分组、可折叠，顺序与设置页浮窗一致，当前模型字体加粗高亮
 - 模型多于 4 个时，「模型」层顶部有官方同款的「搜索模型」框（0.2.0-rc.2 起官方才有此样式，旧版自动隐藏）
 - 外观完全沿用官方样式（同一个菜单表面、同一套图标，含官方的毛玻璃背景）
 
 **排序**
 - 在「设置 → 模型」右下角的浮窗里，**直接拖动**供应商行或模型行
-- 模型顺序保存到 DSH 的 `settings.yaml`：换浏览器、清缓存都不丢，所有打开这份 DSH 的设备共用；供应商顺序只记在当前浏览器里
+- 模型顺序通过官方设置接口持久化（跟着 DSH 的配置走，不存浏览器）；供应商顺序只记在当前浏览器里
 
 ## 安装
 
+`<profile>` 是你的目标环境：浏览器版用 `web`，桌面客户端用 `desktop`。
+
 ```sh
-dsh plugin --profile web add @nimoxie/dsh-model-organizer
+dsh plugin --profile <profile> add @nimoxie/dsh-model-organizer
 ```
 
-装完重启 web 服务（关掉再 `dsh web`）。卸载：
+- 浏览器版（`web`）：装完重启服务（关掉再 `dsh web`）。
+- 桌面客户端（`desktop`）：桌面 profile 由客户端独占管理，请在客户端的「插件管理」页添加本包（包名 `@nimoxie/dsh-model-organizer`）。
+
+卸载（CLI 可管理的环境）：
 
 ```sh
-dsh plugin --profile web remove @nimoxie/dsh-model-organizer
+dsh plugin --profile <profile> remove @nimoxie/dsh-model-organizer
 ```
 
-也可以从 GitHub 或本地目录装：
+也可以从 GitHub 或本地目录装（开发用）：
 
 ```sh
-dsh plugin --profile web add github:NimoXie15/dsh-model-organizer
-dsh plugin --profile web add link:/absolute/path/to/dsh-model-organizer
+dsh plugin --profile <profile> add github:NimoXie15/dsh-model-organizer
+dsh plugin --profile <profile> add link:/absolute/path/to/dsh-model-organizer
 ```
 
-> **兼容性**：已在 DSH `0.1.7`、`0.2.0-rc.1` 上核验，`0.1.5` 起都可用（0.1.7 调整了一处内部接口，本插件已做兼容处理）。注意 0.2.0 起官方主题把菜单背景改成了半透明，模型菜单也随之变通透——这是跟随官方新皮肤，不是故障。
+> **兼容性**：已在 DSH `0.1.7`、`0.2.0-rc.1`（web）、`0.2.0-rc.2`（桌面端）上核验，`0.1.5` 起都可用。
 >
 > 升级插件后如果界面没变化，按 **Ctrl+Shift+R** 强刷一次（浏览器可能还在用缓存的旧版本）。
 
-## 截图
-
-📷 待补充。
-
-## 想让「推理等级」出现，需要模型自己声明
+## 想让「推理等级」可用，需要模型自己声明
 
-只有模型提供了等级，菜单里才会出现「推理等级」入口——这与官方行为一致。在你的 `settings.yaml` 里给模型加上：
+「推理等级」入口常驻菜单根层；只有模型声明了等级，它才可点、才会在按钮上显示当前等级。在模型配置里加上（`llm-pi-ai.providers.<供应商>.models[]`；0.2.x 在 profile 的 `cordis.patch.yml`，0.1.x 在 `settings.yaml`）：
 
 ```yaml
-# settings.yaml → llm-pi-ai.providers.<供应商>.models[]
+# llm-pi-ai.providers.<供应商>.models[]（0.2.x 在 profile 的 cordis.patch.yml；0.1.x 在 settings.yaml）
 - id: <你的模型 ID>
   reasoningEfforts:      # 键=菜单里显示的等级，值=选中时发给模型的 API 参数；只有 off 可以留空
     off:
@@ -59,8 +60,8 @@ dsh plugin --profile web add link:/absolute/path/to/dsh-model-organizer
 
 ## 已知限制
 
-- 排序浮窗只列「设置 → 模型」里自己添加的供应商，**DeepSeek 官方供应商不能排序**（输入框菜单里照常出现、可选）
-- 供应商顺序、浮窗位置只存在当前浏览器；模型顺序存在 `settings.yaml` 里，同一份 DSH 的所有设备共用——两台机器各装一份 DSH 则互不相通
+- 排序浮窗只列「设置 → 模型」里自己添加的供应商；**DeepSeek 官方供应商不能排序**，它们在设置页卡片和输入框菜单里都**固定在顶部**，照常出现、可选
+- 供应商顺序、浮窗位置只存在当前浏览器；模型顺序存在 DSH 的用户配置里，同一份 DSH 的所有设备共用——两台机器各装一份 DSH 则互不相通
 - 不修改 DSH 本体，只通过官方提供的扩展点接入
 
 ## 许可
@@ -69,4 +70,4 @@ MIT
 
 ---
 
-想自己改这个插件、或者想了解它内部怎么实现的，见 [DEVELOPING.md](./DEVELOPING.md)。
+想自己改这个插件、或者想了解它内部怎么实现的，见 [DEVELOPMENT.md](./DEVELOPMENT.md)。

package/cordis.patch.yml

@@ -1,6 +1,6 @@
-# dsh-model-organizer bundle patch: one host row over the web profile.
+# @nimoxie/dsh-model-organizer bundle patch: one host row over the web profile.
 # The row name resolves from the profile's own node_modules where
 # `dsh plugin --profile web add <path>` installed this package.
 - insert:
     - id: model-organizer
-      name: dsh-model-organizer
+      name: "@nimoxie/dsh-model-organizer"

package/lib/client.js

@@ -1,5 +1,5 @@
 window.__ModuleLoader__.load({
-  id: "dsh-model-organizer",
+  id: "@nimoxie/dsh-model-organizer",
   factory: (require) => {
     const module = { exports: {} };
     const exports = module.exports;
@@ -42,6 +42,7 @@ window.__ModuleLoader__.load({
       "composer.searchClear": "清除搜索",
       "composer.searchEmpty": "没有匹配的模型。",
       "composer.selectFailed": "选择失败：{msg}",
+      "composer.effortNone": "未配置",
       "composer.none": "未选择模型",
       "composer.empty": "暂无可用模型",
       "composer.locked": "当前不可切换模型",
@@ -51,7 +52,6 @@ window.__ModuleLoader__.load({
       "composer.effort": "推理等级",
       "composer.effortDefault": "Default",
       "composer.effortEmpty": "当前模型未提供推理等级。",
-      "composer.effortBack": "模型",
       "composer.refreshing": "正在刷新模型列表…",
       "order.title": "模型顺序",
       "order.hint": "拖动 ⠿ 调整，松手即保存",
@@ -72,6 +72,7 @@ window.__ModuleLoader__.load({
       "composer.searchClear": "Clear search",
       "composer.searchEmpty": "No matching models.",
       "composer.selectFailed": "Selection failed: {msg}",
+      "composer.effortNone": "Not configured",
       "composer.none": "No model",
       "composer.empty": "No models available",
       "composer.locked": "Model switching unavailable",
@@ -81,7 +82,6 @@ window.__ModuleLoader__.load({
       "composer.effort": "Effort",
       "composer.effortDefault": "Default",
       "composer.effortEmpty": "This model provides no reasoning effort levels.",
-      "composer.effortBack": "Model",
       "composer.refreshing": "Refreshing model list…",
       "order.title": "Model order",
       "order.hint": "Drag ⠿ to reorder, then save",
@@ -115,7 +115,7 @@ window.__ModuleLoader__.load({
        code changes, so a browser can keep running an old build until a hard reload.
        Kept OFF the UI (it is not user-facing): read it as
        `window.__dshModelOrganizerBuild` when a stale build is suspected. */
-    const BUILD = "b29";
+    const BUILD = "b33";
 
     let officialClasses = null;
     let officialClassesSheets = -1;
@@ -232,6 +232,11 @@ window.__ModuleLoader__.load({
           /* (the header's own arrow button is gone — the row toggles on click) */
 
           ".dsh-mo-model{padding-left:28px;position:relative;}",
+          /* Permanent-but-unconfigured effort cell: caption tone (the search
+             placeholder's token — dimmed is unreadably faint), not-allowed
+             cursor, hover-proof (doubled selectors outrank the shipped rules). */
+          ".dsh-mo-cell-disabled,.dsh-mo-cell-disabled.dsh-mo-cell-disabled{color:var(--dsw-alias-label-caption);cursor:not-allowed;}",
+          ".dsh-mo-cell-disabled:hover,.dsh-mo-cell-disabled.dsh-mo-cell-disabled:hover{background:transparent;cursor:not-allowed;}",
           ".dsh-mo-model::before{content:'';position:absolute;left:15px;top:50%;width:5px;height:5px;margin-top:-2.5px;border-radius:50%;background:var(--dsw-alias-label-tertiary);opacity:.5;}",
           ".dsh-mo-model[aria-checked='true']::before{background:var(--dsw-alias-label-primary);opacity:.9;}"
         ];
@@ -240,6 +245,8 @@ window.__ModuleLoader__.load({
            aria-checked, so the drag lists are untouched. */
         if (C !== null) {
           rules.push("." + C.option + "[aria-checked='true'] ." + C.modelName + "{font-weight:600}");
+          /* cellValue paints its own color; fold it back to the dimmed cell's. */
+          rules.push(".dsh-mo-cell-disabled ." + C.cellValue + "{color:inherit;}");
         }
         style.textContent = rules.join("");
       } catch (e) {}
@@ -602,7 +609,7 @@ window.__ModuleLoader__.load({
         const ids = [];
         const byId = {};
         for (let i = 0; i < groups.length; i++) { ids.push(groups[i].id); byId[groups[i].id] = groups[i]; }
-        const ordered = applyProviderOrder(ids, readProviderOrder());
+        const ordered = applyProviderOrder(ids, readProviderOrder(), true);
         const out = [];
         for (let i = 0; i < ordered.length; i++) if (byId[ordered[i]] !== undefined) out.push(byId[ordered[i]]);
         return out;
@@ -815,12 +822,12 @@ window.__ModuleLoader__.load({
         .split("{model}").join(label)
         .split("{effort}").join(effortLabel === undefined ? "" : effortLabel);
 
-      const chevronIcon = icon("IconChevronDownOutline14", {
+      const chevronIcon = icon("IconChevronDownOutlineRegular", {
         className: C !== null ? cx(C.chevron, open && C.chevronOpen) : undefined,
         style: C === null ? S.caret : undefined
       });
       const triggerChildren = [];
-      const triggerGlyph = icon("IconDataOutline16", { key: "g", className: C !== null ? C.triggerIcon : undefined, size: 16 });
+      const triggerGlyph = icon("IconDataOutlineRegular", { key: "g", className: C !== null ? C.triggerIcon : undefined, size: 16 });
       if (triggerGlyph !== null) triggerChildren.push(triggerGlyph);
       triggerChildren.push(h("span", { key: "l", className: C !== null ? C.triggerLabel : undefined, style: C === null ? S.chipLabel : undefined }, label));
       if (effortLabel !== undefined) {
@@ -892,7 +899,7 @@ window.__ModuleLoader__.load({
           h("span", { key: "n", className: C !== null ? C.cellLabel : undefined, style: C === null ? undefined : undefined }, group.name || group.id),
           h("span", { key: "v", className: C !== null ? C.cellValue : undefined, style: C === null ? S.groupCount : undefined }, group.models.length + " " + t("composer.count"))
         ];
-        const groupChevron = icon("IconChevronRightOutline14", {
+        const groupChevron = icon("IconChevronRightOutlineRegular", {
           key: "i",
           className: C !== null ? cx(C.cellChevron, "dsh-mo-chev") : "dsh-mo-chev",
           style: C === null ? S.groupChevron : undefined
@@ -911,7 +918,7 @@ window.__ModuleLoader__.load({
 
         const items = !isOpen ? [] : group.models.map(function (model) {
           const selected = current !== null && current.provider === group.id && current.model === model.id;
-          const check = selected ? icon("IconCheckOutline16", { key: "k" }) : null;
+          const check = selected ? icon("IconCheckOutlineRegular", { key: "k" }) : null;
           return h("button", {
             key: model.id,
             ref: itemRef(),
@@ -956,23 +963,26 @@ window.__ModuleLoader__.load({
         },
           h("span", { key: "l", className: C !== null ? C.cellLabel : undefined }, t("composer.menuModel")),
           h("span", { key: "v", className: C !== null ? C.cellValue : undefined }, label),
-          icon("IconChevronRightOutline14", { key: "c", className: C !== null ? C.cellChevron : undefined })
+          icon("IconChevronRightOutlineRegular", { key: "c", className: C !== null ? C.cellChevron : undefined })
+        ));
+        /* The effort entry is PERMANENT (unlike the shipped conditional one):
+           models without declared levels render it dimmed, unclickable and
+           skipped by the keyboard walk, so the root pair never reflows. */
+        const effortEnabled = reasoning !== undefined;
+        paneChildren.push(h("button", {
+          key: "effort",
+          ref: itemRef(),
+          type: "button",
+          role: "menuitem",
+          className: C !== null ? cx(C.cell, !effortEnabled && "dsh-mo-cell-disabled") : undefined,
+          style: C === null ? S.fallbackGroupTitle : undefined,
+          disabled: !effortEnabled,
+          onClick: effortEnabled ? function () { setPane("effort"); } : undefined
+        },
+          h("span", { key: "l", className: C !== null ? C.cellLabel : undefined }, t("composer.effort")),
+          h("span", { key: "v", className: C !== null ? C.cellValue : undefined }, effortEnabled ? effortLabel : t("composer.effortNone")),
+          icon("IconChevronRightOutlineRegular", { key: "c", className: C !== null ? cx(C.cellChevron, !effortEnabled && "dsh-mo-cell-disabled") : undefined })
         ));
-        if (reasoning !== undefined) {
-          paneChildren.push(h("button", {
-            key: "effort",
-            ref: itemRef(),
-            type: "button",
-            role: "menuitem",
-            className: C !== null ? C.cell : undefined,
-            style: C === null ? S.fallbackGroupTitle : undefined,
-            onClick: function () { setPane("effort"); }
-          },
-            h("span", { key: "l", className: C !== null ? C.cellLabel : undefined }, t("composer.effort")),
-            h("span", { key: "v", className: C !== null ? C.cellValue : undefined }, effortLabel),
-            icon("IconChevronRightOutline14", { key: "c", className: C !== null ? C.cellChevron : undefined })
-          ));
-        }
       } else if (pane === "effort") {
         if (effortChoices.length === 0) {
           paneChildren.push(h("div", { key: "ee", className: C !== null ? C.empty : undefined, style: C === null ? S.menuEmpty : undefined }, t("composer.effortEmpty")));
@@ -983,7 +993,7 @@ window.__ModuleLoader__.load({
             style: C === null ? S.fallbackGroups : undefined
           }, effortChoices.map(function (level) {
             const selected = effectiveEffort === level.effort;
-            const check = selected ? icon("IconCheckOutline16", { key: "k" }) : null;
+            const check = selected ? icon("IconCheckOutlineRegular", { key: "k" }) : null;
             return h("button", {
               key: level.key,
               ref: itemRef(),
@@ -1221,7 +1231,7 @@ window.__ModuleLoader__.load({
       if (note === "ok") notes.push(h("span", { key: "ok", style: S.ok }, t("order.saved")));
       else if (note !== null) notes.push(h("span", { key: "n", style: S.dirty }, note));
       for (let i = 0; i < notes.length; i++) headChildren.push(notes[i]);
-      const headChevron = icon("IconChevronRightOutline14", {
+      const headChevron = icon("IconChevronRightOutlineRegular", {
         key: "c",
         className: C !== null ? cx(C.cellChevron, "dsh-mo-chev") : "dsh-mo-chev",
         style: C === null ? S.groupChevron : undefined
@@ -1292,7 +1302,6 @@ window.__ModuleLoader__.load({
       try { window.localStorage.setItem(ORDER_STORAGE_KEY, JSON.stringify(ids)); } catch (e) {}
     }
 
-    const PANEL_STORAGE_KEY = "dsh-model-organizer.panelOpen";
     const PANEL_POS_KEY = "dsh-model-organizer.panelPos";
 
 
@@ -1311,30 +1320,33 @@ window.__ModuleLoader__.load({
       try { window.localStorage.setItem(PANEL_POS_KEY, JSON.stringify(pos)); } catch (e) {}
     }
 
-    /* ALWAYS expanded on mount. A remembered collapse is indistinguishable from
-       "the default is collapsed" the next time the page opens, which is not what
-       this panel is for. */
-    function readPanelOpen() {
-      return true;
-    }
 
-    function writePanelOpen(open) {
-      try { window.localStorage.setItem(PANEL_STORAGE_KEY, open ? "1" : "0"); } catch (e) {}
+    /* Provider ids come from two different worlds: the Settings page states them plainly
+       ("amd"), while the composer menu reads the host's model directory, whose ids may be
+       route ids ("llm-pi-ai/amd"). Comparing the last path segment makes the two match. */
+    function providerKey(id) {
+      const text = String(id);
+      const cut = text.lastIndexOf("/");
+      return cut === -1 ? text : text.slice(cut + 1);
     }
 
-    /* Stored order first, then everything else in document order. */
-    function applyProviderOrder(ids, preferred) {
+    /* Stored order first, then everything else in document order — or the other way
+       round when `unknownFirst` is set. The composer menu wants unknownFirst: an id no
+       stored preference mentions is a provider this plugin does not manage (the shipped
+       ones), and those belong on top, exactly like the Settings page pins its unlisted
+       cards. */
+    function applyProviderOrder(ids, preferred, unknownFirst) {
       if (preferred.length === 0) return ids;
       const rank = {};
-      for (let i = 0; i < preferred.length; i++) rank[preferred[i]] = i;
+      for (let i = 0; i < preferred.length; i++) rank[providerKey(preferred[i])] = i;
       const known = [];
       const rest = [];
       for (let i = 0; i < ids.length; i++) {
-        if (rank[ids[i]] === undefined) rest.push(ids[i]);
+        if (rank[providerKey(ids[i])] === undefined) rest.push(ids[i]);
         else known.push(ids[i]);
       }
-      known.sort(function (a, b) { return rank[a] - rank[b]; });
-      return known.concat(rest);
+      known.sort(function (a, b) { return rank[providerKey(a)] - rank[providerKey(b)]; });
+      return unknownFirst === true ? rest.concat(known) : known.concat(rest);
     }
 
     /* A seat entry that throws is silently abdicated, so "my panel is missing" and
@@ -1395,9 +1407,11 @@ window.__ModuleLoader__.load({
       const openState = useState({});
       const openMap = openState[0];
       const setOpenMap = openState[1];
-      const panelState = useState(readPanelOpen);
+      /* The panel always mounts expanded: a remembered collapse is
+         indistinguishable from "collapsed by default" on the next page open. */
+      const panelState = useState(true);
       const panelOpen = panelState[0];
-      const setPanelOpen = function (next) { writePanelOpen(next); panelState[1](next); };
+      const setPanelOpen = panelState[1];
       const posState = useState(readPanelPos);
       const panelPos = posState[0];
       const setPanelPos = posState[1];
@@ -1427,18 +1441,23 @@ window.__ModuleLoader__.load({
          Cards carry no provider identity in the DOM — match through the
          displayName text each card renders. */
       const seatRef = useRef(null);
+
+      /* The seat may sit inside slot wrappers between it and the section — climb until a
+         container actually holds the card list. */
+      const seatCardList = function () {
+        let el = seatRef.current;
+        for (let hop = 0; hop < 6 && el !== null; hop++) {
+          el = el.parentElement;
+          if (el === null) return null;
+          const list = el.querySelector("ul");
+          if (list !== null) return list;
+        }
+        return null;
+      };
+
       const mirrorCards = function () {
         try {
-          const seat = seatRef.current;
-          if (seat === null) return;
-          /* The seat may sit inside slot wrappers between it and the section —
-             climb until a container actually holds the card list. */
-          let list = null;
-          let el = seat;
-          for (let hop = 0; hop < 6 && el !== null && list === null; hop++) {
-            el = el.parentElement;
-            if (el !== null) list = el.querySelector("ul");
-          }
+          const list = seatCardList();
           if (list === null) return;
           const byName = {};
           for (const id in display) {
@@ -1451,27 +1470,45 @@ window.__ModuleLoader__.load({
           if (Object.keys(byName).length === 0) return;
           const rank = {};
           baseIds.forEach(function (id, index) { rank[id] = index + 1; });
-          let unknown = 1000;
+          /* Configured providers take ranks 1..N. Anything else — the shipped DeepSeek
+             card, the add-provider draft — keeps the default order 0, which sorts it
+             ahead of the ranked cards. Clearing the inline value also drops whatever an
+             earlier pass wrote there, so a card that used to be unranked and is ranked
+             now (or the reverse) never keeps a stale position. */
           for (let i = 0; i < list.children.length; i++) {
             const li = list.children[i];
             const nameEl = li.querySelector ? li.querySelector('[class*="rowName"]') : null;
             const name = nameEl !== null ? nameEl.textContent : null;
             const id = name !== null && byName[name] !== undefined ? byName[name] : null;
             if (id !== null && rank[id] !== undefined) li.style.order = String(rank[id]);
-            else li.style.order = String(unknown++);
+            else li.style.order = "";
           }
         } catch (e) {}
       };
 
       useEffect(function () {
         mirrorCards();
+        /* The card list is rendered asynchronously and React may replace the list node
+           itself, so the observer watches the section wrapper that holds it — two levels
+           above the seat, where the climb above finds the card list. That node exists
+           from the first paint and survives the list being swapped out. Every pass
+           re-resolves the list by climbing, mutations are coalesced to one pass per
+           frame, and a frame plus one delayed pass cover the first paint, where the cards
+           routinely do not exist yet. */
+        const frame = requestAnimationFrame(function () { mirrorCards(); });
+        const timer = setTimeout(function () { mirrorCards(); }, 300);
+        const stop = function () { cancelAnimationFrame(frame); clearTimeout(timer); };
         const seat = seatRef.current;
-        const container = seat !== null ? seat.parentElement : null;
-        const list = container !== null ? container.querySelector("ul") : null;
-        if (list === null || typeof MutationObserver !== "function") return undefined;
-        const observer = new MutationObserver(function () { mirrorCards(); });
-        observer.observe(list, { childList: true });
-        return function () { observer.disconnect(); };
+        const section = seat !== null && seat.parentElement !== null ? seat.parentElement.parentElement : null;
+        if (section === null || typeof MutationObserver !== "function") return stop;
+        let queued = false;
+        const observer = new MutationObserver(function () {
+          if (queued) return;
+          queued = true;
+          requestAnimationFrame(function () { queued = false; mirrorCards(); });
+        });
+        observer.observe(section, { childList: true, subtree: true });
+        return function () { observer.disconnect(); stop(); };
       }, [sourceKey, stored]);
 
       useLayoutEffect(function () {
@@ -1481,8 +1518,6 @@ window.__ModuleLoader__.load({
       }, [panelPos, panelOpen]);
 
       const ids = order === null ? baseIds : order;
-      const idsKey = ids.join("|");
-      const dirty = order !== null && order.join("|") !== sourceKey;
 
       /* The shipped provider cards are left exactly as React renders them. Ordering used
          to be mirrored onto them with inline `order`; that is gone — this plugin adds a
@@ -1606,7 +1641,7 @@ window.__ModuleLoader__.load({
             h("span", { key: "n", className: C !== null ? C.cellLabel : undefined, style: C === null ? S.rowName : undefined }, profile.displayName || id),
             h("span", { key: "c", className: C !== null ? C.cellValue : undefined, style: C === null ? S.rowMeta : undefined }, count + " " + t("composer.count"))
           ];
-          const rowChevron = icon("IconChevronRightOutline14", {
+          const rowChevron = icon("IconChevronRightOutlineRegular", {
             key: "v",
             className: C !== null ? cx(C.cellChevron, "dsh-mo-chev") : "dsh-mo-chev",
             style: C === null ? S.groupChevron : undefined

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimoxie/dsh-model-organizer",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "DSH 模型整理插件：输入框的模型下拉改为「供应商分组 + 模型二级折叠菜单」（含推理等级），并在模型设置页提供一个可拖拽的「供应商与模型顺序」浮窗。",
   "type": "module",
   "main": "lib/index.js",
@@ -17,7 +17,7 @@
     "lib",
     "cordis.patch.yml",
     "README.md",
-    "DEVELOPING.md",
+    "DEVELOPMENT.md",
     "LICENSE"
   ],
   "keywords": [