dsh-model-organizer 0.3.2 → 0.3.4

package/DEVELOPING.md

@@ -1,108 +1,63 @@
 # 开发笔记
 
-面向改这个插件的人（包括未来的我）。用户文档在 [README.md](./README.md)。
+面向改这个插件的人。用户文档在 [README.md](./README.md)。
 
-## ⚠️ 改代码前务必先读：踩过的坑
+## 升级 DSH 后座位凭空消失？先查服务名
 
-1. **profile bundle 必须声明 `dsh.bundle.patch`**（指向 `cordis.patch.yml`）。缺了它 dsh 启动即报
-   `profile bundle "..." declares no dsh.bundle in its package.json`。
+cordis 的 `ctx.inject([...])` **只要有一个服务永不出现，回调就永远不执行** —— 不报错、不打日志。所以服务改名会让整个座位静默消失。
 
-2. **顶层 `inject` 必须声明座位 standardProps 会读取的每一个服务**（本插件：`locale, slots, sessions, remote, remote.session, remote.settings`）。
-   少一个 → 渲染时抛 `cannot get property "remote.session" without inject` → **条目被静默弃权（abdicate）并回退到内置 UI**，界面无任何报错。
-   调用 `remote.settings.mutate` 还必须显式声明 **`remote.settings`**。
+已发生一次：0.1.7 把客户端设置镜像服务 `settingsScope` 改名为 `configForms`（提供者仍是 `@deepseek-ai/dsh-client-ui-settings`，`describe()` 返回同一个 mirror）。设置页浮窗因此消失，而输入框菜单照常（它注入的 `slots/modelDirectories/sessions` 没变）。
 
-3. **owner props 以组件 props 传入，不经过座位的 `inject` 工厂**：`settings.models.provider-card` 的 `inject` 不接收参数，必须读 `props.provider`。
+`apply()` 里同时注入两个名字，一次性标志保证只挂载一次：
 
-4. **`single` 座位优先级**：同优先级注册会**直接抛错**；运行时为非 chain 座位**自动分配**优先级（`--nextPriority` 递减），**后注册者胜出**。
-
-5. **drop 事件会在行与容器上各触发一次**（冒泡），需用 ref 加锁，否则重复写入。
-
-6. **边框必须用 longhand**（`borderWidth/borderStyle/borderColor`）。用 shorthand `border` 再叠加 `borderColor` 时，React 会把 shorthand 展开成 longhand；回退时移除 `borderColor`，`border-color` 就落回 **currentColor** —— 表现为「拖拽结束后高亮边框一直不消失」。
-
-7. **拖拽会把源行留在焦点上**。行加 `tabIndex:-1`、drop/dragend 时 `blur()`；并且**不要给行画 `:focus-visible` 背景**（官方 `option` 类自带一条，会变成「拖完还留一块灰底」）。
-
-8. **原生拖拽会让文字变成可拖对象**（浏览器弹「松开鼠标即可搜索」）。解决：`-webkit-user-drag:none` 加在**行的内容**上，不要加在行本身（加在行上会让行也拖不动）。这条是从侧边栏会话行的实现里学来的。
-
-9. **primitive 图标不转发 inline `style`**：需要旋转/变色请传 `className`（本插件为此注入一张极小的自有样式表）。
-
-10. **数组顺序可控，record 键顺序不可控**：`providers` 是 record，宿主要规范化键顺序，整体 `set` 与 `unset`+`set` 都实测无效 —— 所以供应商顺序只能存本机偏好。
-
-11. **面板里用到的每个局部变量都要真的声明**：曾在 `ProviderModelOrder` 里用了 `C`（官方类名映射）却没定义 → `ReferenceError` → 条目再次被静默弃权，表现为「面板整个不见了」。
-
-12. 浏览器半只需 `react` / `react-dom` / `@deepseek-ai/dsh-client-ui-primitives`（都在 shell 的 PLATFORM_MODULES 种子里），无需 `dsh.client.external`。
-
-## 兼容性与鲁棒性（已核查）
-
-### 已发现并修复的真实冲突
-
-**`settings.models.provider-card` 被 `@linxin666/dsh-client-ui-model-capabilities` 占用。**
-该座位是 **keyed**，key 由官方页面固定派发为供应商的 settings namespace（`llm-pi-ai`）；而该插件已经用同一个 key 注册了「模型能力」面板。SlotCore 对 keyed 座位**一个 key 只保留一个占用者**，且同 key 同优先级会直接抛错 —— 它用 `try/catch` 吞掉异常，所以**本插件早期版本一直在静默压制它的「模型能力」面板**（实测：让出该座位后，每个供应商卡片立刻出现「模型能力」）。
-
-**修复**：本插件不再占用该座位，模型排序改由自己拥有的 `settings.models.footer`（list 座位，`id: model-organizer-provider-order`）承载 —— list 座位按 id 去重，天然可与该插件的 `ui-model-capabilities` 共存。
-
-### 其它已做的加固
-
-| 风险 | 处理 |
-| :-- | :-- |
-| 官方 CSS module 哈希变化 / 被别的模块误命中 | 运行时解析前缀，并用**只有该模块才有的第二个类**（`_optionCopy`）校验；缓存与样式表数量绑定；全部失败则退回内置回退样式 |
-| 座位契约变更（prop 改名等） | **不拦截**：让渲染抛错 → SlotCore 弃权该条目 → 官方内置组件自动回填 |
-| 座位被重命名 / 移除 | `slots.inject` 永不触发 → 对应面板静默消失，其它功能不受影响 |
-| 单个座位注册失败 | 每个座位注册独立 `guard`，失败只记一条 warn，**不会拖垮整个插件** |
-| 写入被拒绝 / ops 契约变化 | `mutate` 的同步抛错与 promise 拒绝都有捕获，并在表头显示失败原因 |
-| 本机偏好 | `localStorage` key 带命名空间，读写都有 try/catch |
-| 注入的样式表 | `<style id="dsh-model-organizer-style">`，类名统一 `dsh-mo-*` 前缀，注入幂等 |
-| 服务端半边 | 只有空 `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()));
+```
 
-- **`conversation.input.model` 是 single 座位**：将来若另一个插件以相同优先级注册，SlotCore 会抛错（本插件的 `guard` 会记 warn，官方内置组件仍会渲染）。
-- **官方模型页若改变 keyed 派发约定**，依赖该座位的插件会失效 —— 本插件已不依赖它。
-- **官方 CSS module 若改名**（例如删掉 `optionCopy`），校验会失败并退回回退样式：功能可用、外观降级。
-- **卡片排序**是本插件唯一会改官方 DOM 的地方（给官方列表设 `display:flex` + 给 `li` 设 CSS `order`，不移动节点）。若 DSH 改那棵 DOM，该功能会静默降级，其余功能不受影响。
+**规律**：升级后座位不见了，第一件事是去新版 `dsh-client-ui-*` 包里 grep 自己注入的每个服务名。
 
-## 排查手册
+## 座位的失败模式（决定了代码结构）
 
-### 让 agent 浏览器不显示窗口（消除抢焦点）
+- **条目渲染时抛错 → 被静默弃权，官方内置 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` 座位同优先级注册会**直接抛错**；运行时会为非 chain 座位自动分配优先级，后注册者胜出。
+- 未声明的局部变量（`ReferenceError`）同样会导致弃权，表现就是"整个面板不见了"。
 
-`dsh-ego-browser` 驱动的 Chromium 是 DSH 的子进程，默认以真实窗口存在，并且**每次动作工具都会 `Target.activateTarget` 把它顶到前台**（这就是「用着用着 Chrome 跳出来」的原因）。让它完全不出现窗口：
+## 与官方模块的耦合
 
-```powershell
-# 只对当前终端会话生效（先这样试）
-$env:EGO_LINUX_HEADLESS = 1
-dsh web
+- **官方 CSS-module 类名靠运行时解析**：锚定只有该模块才有的类名，并用第二个类名（如 `_optionCopy`）校验；解析失败退回内置回退样式（功能可用、外观降级）。
+- **0.1.7-rc.1 的构建丢了官方菜单规则的两条属性**：线上生效的 `_7KE1Ra_menu` 里既没有 `background` 也没有 `border-radius`（源码里是 `var(--dsw-specific-menu)` 和 `16px`），所以**官方菜单本身表现为全透明+直角**。本插件不依赖那条规则：运行时从 `document.body` 解析 `--dsw-specific-menu` 内联补上背景，并补 `var(--dsw-radius-lg)` 圆角。升级后可重新检查这条规则是否已修复。
+- **浮层必须 `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 去重）。
 
-# 永久生效（设完必须重开终端，再启动 DSH）
-setx EGO_LINUX_HEADLESS 1
-```
+## 开发环境
 
-- 显式设置 `1/true/yes/on` **优先于**「有没有显示环境」的自动推断（含 Windows）。
-- 浏览器是**单例常驻**进程：改完要重启 DSH（或 `ego-browser --stop`）才冷启动生效。
-- **代价**：只损失「实时观察窗」；其余 `ego_*` 工具（导航/点击/输入/JS/截图/下载）全部照常。
-- 不要用 `chromeArgs` 传 `--headless` —— 它在 `CHROME_BLOCKED` 黑名单里，会被过滤掉。
+- **`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 不随代码变化，普通刷新一直用缓存。
+- **浏览器半只需 `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 时踩过的坑
 
-DSH 把客户端 bundle 以 `Cache-Control: public, max-age=31536000, immutable` 下发，而 URL 不随代码变化 —— 普通刷新会一直用缓存。**必须 Ctrl+Shift+R**（或在 DevTools → Network 勾 Disable cache）。
+- **边框必须用 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
-# 1. 改代码后升版本号（npm 不允许覆盖已发布的版本）
-#    package.json 的 version：0.3.2 → 0.3.3
-# 2. 提交并推送
+# npm 不允许覆盖已发布的版本号：先升版本，再提交，最后发布
+npm version patch        # 或手改 package.json 的 version
 git add -A && git commit -m "..." && git push
-# 3. 发布
 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`，不要放进仓库）。
-
-## 附：关于「(modlens vision)」供应商分组
-
-这些是 **`@liustack/modlens` 自动生成的「视觉变体」路由**，不是配置重复项：
-
-- 机制：modlens 扫描已注册 provider，找出上游元数据声明为 `text` 且不含 image 的模型（默认按 `deepseek` / `glm` / `mimo` 前缀族匹配），为它们注册一条**声明支持图片输入**的伴随路由，界面名加 `(modlens vision)`。
-- 用途：选中该分组下的模型后，粘贴/拖拽图片会走 DSH 原生附件流程，在调用（纯文本）模型前把图片转成证据文本。不选这个分组时，纯文本模型无法接收图片。
-- 调整：编辑 `$DSH_HOME/profiles/<profile>/cordis.patch.yml` 里的 `modlens` 配置（`families` / `discover`），整条关掉用 `visionProvider: false`。视觉引擎配置在 `~/.modlens/config.json`。
+发布需要带 **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`，不要放进仓库）。

package/README.md

@@ -36,7 +36,9 @@ dsh plugin --profile web add github:NimoXie15/dsh-model-organizer
 dsh plugin --profile web add link:/absolute/path/to/dsh-model-organizer
 ```
 
-> 升级插件后如果界面没变化，按 **Ctrl+Shift+R** 强刷一次（DSH 的客户端 bundle 带一年 immutable 缓存，普通刷新不会重新下载）。
+> **兼容性**：已在 DSH `0.1.7` 上实测，`0.1.5` 起都可用（0.1.7 调整了一处内部接口，本插件已做兼容处理）。
+>
+> 升级插件后如果界面没变化，按 **Ctrl+Shift+R** 强刷一次（浏览器可能还在用缓存的旧版本）。
 
 ## 截图
 
@@ -56,9 +58,9 @@ dsh plugin --profile web add link:/absolute/path/to/dsh-model-organizer
 
 ## 已知限制
 
-- 只处理 `llm-pi-ai` 命名空间下的供应商（DeepSeek 官方供应商不在其中）
-- 供应商顺序、浮窗位置是本机偏好，不跨设备同步
-- 只占用两个官方扩展点（`conversation.input.model`、`settings.models.footer`），不改官方代码
+- 只对「设置 → 模型」里自己添加的供应商生效，**DeepSeek 官方供应商不在其中**
+- 供应商顺序、浮窗位置只保存在本机浏览器，不跨设备同步；模型顺序写在设置里，会跟着走
+- 不修改 DSH 本体，只通过官方提供的扩展点接入
 
 ## 许可
 
@@ -66,4 +68,4 @@ MIT
 
 ---
 
-开发笔记、兼容性审计、排查手册见 [DEVELOPING.md](./DEVELOPING.md)。
+想自己改这个插件、或者想了解它内部怎么实现的，见 [DEVELOPING.md](./DEVELOPING.md)。

package/lib/client.js

@@ -41,7 +41,7 @@ window.__ModuleLoader__.load({
       "order.unsaved": "有未保存改动",
       "order.readonly": "当前环境不可写入该设置",
       "providers.title": "供应商与模型顺序",
-      "providers.hint": "拖动行即可调整顺序",
+      "providers.hint": "点击收起/展开，长按拖拽调整",
       "providers.expand": "展开顺序面板",
       "providers.collapse": "收起顺序面板",
       "providers.saved": "已保存 ✓",
@@ -66,7 +66,7 @@ window.__ModuleLoader__.load({
       "order.unsaved": "Unsaved changes",
       "order.readonly": "This settings document is read-only here",
       "providers.title": "Provider and model order",
-      "providers.hint": "Drag a row to reorder",
+      "providers.hint": "Click to collapse/expand, press and drag to reorder",
       "providers.expand": "Expand the order panel",
       "providers.collapse": "Collapse the order panel",
       "providers.saved": "Saved ✓",
@@ -90,7 +90,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 = "b23";
+    const BUILD = "b24";
 
     let officialClasses = null;
     let officialClassesSheets = -1;
@@ -265,11 +265,16 @@ window.__ModuleLoader__.load({
       /* Floating presentation: the panel sits in the corner of the Models page so
          provider/API configuration and reordering are visible at the same time. */
       floatPanel: {
-        position: "fixed", right: 20, bottom: 20, zIndex: 900, width: 380, maxWidth: "calc(100vw - 40px)",
+        position: "fixed", right: 20, bottom: 20, zIndex: 10000, width: 380, maxWidth: "calc(100vw - 40px)",
         display: "flex", flexDirection: "column", padding: 4,
         border: "1px solid var(--dsw-alias-border-l1)", borderRadius: 14,
-        background: "var(--dsw-specific-menu, var(--dsw-alias-bg-module, #222))",
-        boxShadow: "0 10px 30px rgba(0,0,0,.34)", color: "var(--dsw-alias-label-primary)"
+        /* The theme's menu token is an OPAQUE colour (a color-mix), so using it as-is
+           makes this panel a solid box and the blur below has nothing to show. Mixing
+           it back toward transparent restores the frosted look in the theme's colour. */
+        background: "color-mix(in srgb, var(--dsw-specific-menu, #26262a) 50%, transparent)",
+        backdropFilter: "var(--dsw-menu-backdrop-filter, blur(28px) saturate(1.6))",
+        boxShadow: "var(--dsw-elevation-prominent, 0 10px 30px rgba(0,0,0,.34))",
+        color: "var(--dsw-alias-label-primary)"
       },
       /* The shipped `cell` sets min-width:100%; the head must stay inside the panel. */
       panelHeadCell: { display: "flex", alignItems: "center", gap: 6, flex: "1 1 auto", minWidth: 0 },
@@ -853,9 +858,26 @@ window.__ModuleLoader__.load({
         ref: menuRef,
         id: idRef.current + "-menu",
         className: C !== null ? C.menu : undefined,
-        style: C !== null
-          ? (menuPos !== null ? menuPos : MEASURE_STYLE)
-          : Object.assign({}, S.fallbackMenu, menuPos !== null ? menuPos : MEASURE_STYLE),
+        /* The shipped `_menu` rule asks for var(--dsw-specific-menu), but that lookup
+           comes out transparent on this node while the same token is defined on <body>.
+           Resolving it here and setting it inline is what makes the menu look like the
+           shipped one instead of a see-through pane. */
+        style: Object.assign({
+          background: (function () {
+            try {
+              const v = getComputedStyle(document.body).getPropertyValue("--dsw-specific-menu").trim();
+              if (v.length > 0) return v;
+            } catch (e) {}
+            return "#26262a";
+          })(),
+          /* This build ships _7KE1Ra_menu without its background or radius (the source
+             declares both), so the shipped menu renders as a square transparent pane.
+             Both are restored here from the theme's own tokens. */
+          borderRadius: "var(--dsw-radius-lg, 16px)"
+        },
+          C !== null
+            ? (menuPos !== null ? menuPos : MEASURE_STYLE)
+            : Object.assign({}, S.fallbackMenu, menuPos !== null ? menuPos : MEASURE_STYLE)),
         role: "menu",
         "aria-label": t("composer.title"),
         "aria-busy": loading || busy
@@ -1105,6 +1127,42 @@ window.__ModuleLoader__.load({
       return known.concat(rest);
     }
 
+    /* A seat entry that throws is silently abdicated, so "my panel is missing" and
+       "my panel threw" look identical from the page. This boundary turns the throw
+       into one visible line, so the failure can be reported instead of guessed. */
+    class PanelBoundary extends React.Component {
+      constructor(props) {
+        super(props);
+        this.state = { err: null };
+      }
+      static getDerivedStateFromError(err) {
+        return { err: err };
+      }
+      render() {
+        if (this.state.err !== null) {
+          const message = String((this.state.err && this.state.err.message) || this.state.err);
+          return h("div", {
+            "data-mo": "panel-error",
+            style: {
+              margin: "8px 0", padding: "6px 10px", borderRadius: 8, fontSize: 12, lineHeight: "18px",
+              whiteSpace: "pre-wrap",
+              border: "1px solid var(--dsw-alias-state-error-primary, #f85149)",
+              color: "var(--dsw-alias-state-error-primary, #f85149)"
+            }
+          }, "dsh-model-organizer 渲染失败：" + message);
+        }
+        return this.props.children;
+      }
+    }
+
+    function ProviderOrderPanelGuarded(props) {
+      return h(PanelBoundary, null, h(ProviderOrderPanel, props));
+    }
+
+    function ProviderGroupedModelSelectGuarded(props) {
+      return h(PanelBoundary, null, h(ProviderGroupedModelSelect, props));
+    }
+
     function ProviderOrderPanel(props) {
       const C = resolveOfficialClasses();
       ensureOwnStyles();
@@ -1164,21 +1222,9 @@ window.__ModuleLoader__.load({
       const idsKey = ids.join("|");
       const dirty = order !== null && order.join("|") !== sourceKey;
 
-      /* Mirror the stored order onto the shipped provider cards (CSS `order` only —
-         the DOM React rendered is never touched). The cards may be (re)rendered after
-         this effect runs, which drops the inline styles, so it is applied again on the
-         next frame and once more shortly after. */
-      useEffect(function () {
-        const list = idsKey.length === 0 ? [] : idsKey.split("|");
-        applyCardOrder(display, list);
-        const frame = requestAnimationFrame(function () { applyCardOrder(display, list); });
-        const timer = setTimeout(function () { applyCardOrder(display, list); }, 400);
-        return function () {
-          cancelAnimationFrame(frame);
-          clearTimeout(timer);
-        };
-      }, [sourceKey, idsKey]);
-
+      /* 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
+         floating panel to the Models page and nothing else. */
       function commit(next) {
         if (next.join("|") === baseIds.join("|")) { setOrder(null); return; }
         writeProviderOrder(next);
@@ -1352,56 +1398,19 @@ window.__ModuleLoader__.load({
         : Object.assign({}, S.floatPanel, { left: panelPos.left, top: panelPos.top, right: "auto", bottom: "auto" });
       /* Original layout (header first, list below) with a TOP-anchored panel: the
          header never moves and collapsing pulls the bottom edge up. */
-      return h("div", { ref: panelRef, style: panelStyle },
-        head,
-        panelOpen ? h("div", { style: S.floatBody }, list) : null
+      /* Portalled to <body>: the footer seat lives deep inside the settings page, so a
+         fixed panel there is trapped in that subtree's stacking context and any other
+         plugin's floating widget paints over it. At body level the z-index is global. */
+      return ReactDOM.createPortal(
+        h("div", { ref: panelRef, style: panelStyle, "data-mo": "panel" },
+          head,
+          panelOpen ? h("div", { style: S.floatBody }, list) : null
+        ),
+        document.body
       );
     }
 
     /* -------------------------------- helpers --------------------------------- */
-    /* The Models page renders one <li> per provider inside its own <ul>. The host
-       owns that order (the settings document cannot express it — verified), so the
-       stored preference is applied as CSS `order` on a flex column: the DOM is left
-       exactly as React rendered it, only the visual sequence changes. Cards that do
-       not correspond to a settings provider (catalog-only rows) stay pinned first. */
-    function applyCardOrder(providers, ids) {
-      try {
-        const names = [];
-        for (const id in providers) {
-          const dn = providers[id] ? providers[id].displayName : undefined;
-          if (typeof dn === "string" && dn.length > 0) names.push([id, dn]);
-        }
-        if (names.length === 0) return;
-        names.sort(function (a, b) { return b[1].length - a[1].length; });
-
-        let list = null;
-        let best = 0;
-        const lists = document.querySelectorAll("ul");
-        for (let i = 0; i < lists.length; i++) {
-          const items = lists[i].children;
-          let hits = 0;
-          for (let j = 0; j < items.length; j++) {
-            const text = items[j].textContent || "";
-            for (let k = 0; k < names.length; k++) if (text.indexOf(names[k][1]) !== -1) { hits++; break; }
-          }
-          if (hits >= 2 && hits > best) { best = hits; list = lists[i]; }
-        }
-        if (list === null) return;
-
-        list.style.display = "flex";
-        list.style.flexDirection = "column";
-        const rank = {};
-        for (let i = 0; i < ids.length; i++) rank[ids[i]] = i;
-        const items = list.children;
-        for (let i = 0; i < items.length; i++) {
-          const text = items[i].textContent || "";
-          let matched;
-          for (let k = 0; k < names.length; k++) if (text.indexOf(names[k][1]) !== -1) { matched = names[k][0]; break; }
-          const r = matched === undefined ? undefined : rank[matched];
-          items[i].style.order = String(r === undefined ? -1 : r);
-        }
-      } catch (e) {}
-    }
 
     function namespaceView(view, namespace) {
       if (!view || !view.namespaces) return null;
@@ -1450,6 +1459,18 @@ window.__ModuleLoader__.load({
 
     function apply(ctx) {
       try { window.__dshModelOrganizerBuild = BUILD; } catch (e) {}
+      /* A DOM marker proving this bundle actually applied, independent of any seat.
+         Seat registration is silent by design (a throw abdicates the entry), so
+         "is the new code even loaded?" is otherwise unanswerable from the page. */
+      try {
+        if (document.body !== null && document.querySelector('[data-mo="boot"]') === null) {
+          const boot = document.createElement("div");
+          boot.setAttribute("data-mo", "boot");
+          boot.setAttribute("data-mo-build", BUILD);
+          boot.hidden = true;
+          document.body.appendChild(boot);
+        }
+      } catch (e) {}
       ctx.effect(function () { return ctx.locale.register(NS, { zh: zh, en: en }); }, "dsh-model-organizer: dictionaries");
       const t = ctx.locale.bind(NS);
 
@@ -1477,12 +1498,31 @@ window.__ModuleLoader__.load({
                 t: t
               };
             }
-          }, ProviderGroupedModelSelect); });
+          }, ProviderGroupedModelSelectGuarded); });
         });
       });
 
-      ctx.inject(["slots", "settingsScope", "remote", "remote.settings"], function (scope) {
-        const mirror = scope.settingsScope.describe();
+      /* The settings mirror moved homes: DSH 0.1.7 exposes it as `configForms`
+         (provided by ui-settings); 0.1.5/0.1.6 exposed the same object as
+         `settingsScope`. A cordis `ctx.inject` whose service never appears simply
+         never runs, so injecting only the old name made this whole seat vanish
+         without a single error once DSH renamed it. Inject both names and mount
+         once — whichever resolves first wins, the other stays dormant. */
+      let orderPanelMounted = false;
+
+      function mountOrderPanel(scope, mirror) {
+        if (orderPanelMounted) return;
+        orderPanelMounted = true;
+        /* Mark that the service resolved and the panel is being mounted — this
+           separates "the seat never rendered" from "the inject never fired". */
+        try {
+          if (document.body !== null && document.querySelector('[data-mo="panel-mounted"]') === null) {
+            const mark = document.createElement("div");
+            mark.setAttribute("data-mo", "panel-mounted");
+            mark.hidden = true;
+            document.body.appendChild(mark);
+          }
+        } catch (e) {}
         mirror.ensure();
         const mutate = function (ops, revision) { return scope.remote.settings.mutate(PI_AI_NS, ops, revision); };
 
@@ -1504,9 +1544,16 @@ window.__ModuleLoader__.load({
               id: "model-organizer-provider-order",
               order: 100,
               inject: face
-            }, ProviderOrderPanel);
+            }, ProviderOrderPanelGuarded);
           });
         });
+      }
+
+      ctx.inject(["slots", "configForms", "remote", "remote.settings"], function (scope) {
+        mountOrderPanel(scope, scope.configForms.describe());
+      });
+      ctx.inject(["slots", "settingsScope", "remote", "remote.settings"], function (scope) {
+        mountOrderPanel(scope, scope.settingsScope.describe());
       });
     }
 

package/package.json

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