@nimoxie/dsh-ui-tweaks 0.1.0

package/DEVELOPING.md

@@ -0,0 +1,72 @@
+# 开发笔记
+
+面向改这个插件的人。用户文档在 [README.md](./README.md)。
+
+## 骨架（与 dsh-model-organizer 同构）
+
+- `lib/index.js`：host 半区，空 `apply()`，只为让插件出现在 cordis loader / bundle 列表。
+- `lib/client.js`：浏览器半区，`window.__ModuleLoader__.load({ id, factory })` 包裹，`module.exports = { name, apply, inject }`；`apply(ctx)` 由客户端 cordis 上下文调用。
+- `cordis.patch.yml`：`- insert: [{id: ui-tweaks, name: '@nimoxie/dsh-ui-tweaks'}]`。**profile bundle 必须声明 `dsh.bundle.patch`，否则 dsh 启动即报 declares no dsh.bundle**。
+- `package.json`：`exports["./client"]` 指向 client bundle；`dsh.client.platform: "web"`；`dsh.client.inject` 列出需要的官方包（本插件只要 `@deepseek-ai/dsh-api-remotes`，`remote.*` 服务由它提供）。
+- 客户端可用模块：`react` / `react-dom` / `@deepseek-ai/dsh-client-ui-primitives` 都是 shell 内置（PLATFORM_MODULES），不需要 `external` 声明。本插件 v1 没用 React。
+
+### 命名（scoped 后的约定，2026-09-30 因重名加 @nimoxie scope）
+
+- npm 包名 `@nimoxie/dsh-ui-tweaks`；**patch 里的 `insert.name` 必须写全 scope** —— `@linxin666` 系插件全是这样（loader 按它在 node_modules 里解析包）。
+- loader `id` 与 `module.exports.name` 只是内部标识，换名不必跟着改（dsh-model-organizer 改 scoped 后这俩仍是旧值，工作正常）；本插件 loader id 用了全名，`exports.name` 用 `ui-tweaks`。
+- 换名要同步四处：package.json、cordis.patch.yml、两个 profile 的依赖键 + `dsh.profile.bundles` 数组、（桌面 profile 还有 lockfile 与 node_modules 软链路径）。
+
+## 本地开发（link: 才是软链！）
+
+- **`file:` 依赖是打包快照，`link:` 才是符号链接。** profile 里写 `file:` 时 pnpm 把目录复制进 store，改仓库不生效。
+- 安装/重装：
+  ```sh
+  dsh plugin --profile web remove @nimoxie/dsh-ui-tweaks
+  dsh plugin --profile web add "link:D:/tools/DeepSeek Harness/dsh-ui-tweaks"
+  ```
+- 改完 client.js 后页面要 **Ctrl+Shift+R**：客户端 bundle 以 `Cache-Control: immutable, max-age=31536000` 下发且 URL 不随代码变化，普通刷新一直吃缓存。
+- 加载/卸载插件需要**重启 dsh web**（插件在启动时装载）。
+- **桌面 profile 由 Electron 应用独占管理**：npm 版 CLI 装/卸会被拒（`managed exclusively by the Electron application`）。两条路：① 客户端插件管理页安装，spec 填 `link:<路径>`；② 应用完全退出后手动改四件套（package.json 依赖 + `dsh.profile.bundles`、pnpm-lock importers、node_modules 软链）。实测客户端会监听 package.json 变化、自动用自带 pnpm 建好软链。
+
+## 已知坑（多半继承自 dsh-model-organizer 的踩坑记录）
+
+- **`ctx.inject([...])` 只要有一个服务名不存在，回调永远不执行且不报错**。升级 dsh 后功能静默消失，第一件事去新版 `dsh-client-ui-*` 包里 grep 注入的每个服务名。本插件在 8 秒拿不到服务时会给出明确的错误行，不会无限等。
+- 每个模块的注册各套 `guard()`：失败记 `console.warn`，不拖垮同文件其它模块。
+- 官方 CSS-module 类名是「哈希_原名」结构，锚定一律用**属性前缀**（`[class*="tableScroll"]`、`[class*="widthHandle"]`、`[class*="composerSeat"]`），绝不硬编码 hash。
+- **0.2.0-rc.1 已把 0.1.x 的 `data-dsh-part` 标记全部移除**（滚动条/调宽条/输入框的选择器都因此改过一轮）；`[data-slot="..."]` 是渲染器统一输出的，锚插槽容器用它。
+- 浮层挂在 `document.body` 的 Shadow DOM 里：座位在页面深子树里时 `position:fixed` 会被困在堆叠上下文，z-index 再高也没用。
+
+## 更新检查的实现要点
+
+- **全部走官方 remote API**，不自建 host 路由：`pluginManager.listBundles()`（清单+版本）、`installBundle("<名>@latest", { enabled: true, requestId })`（更新）、`waitForInstall(requestId)`（进度）、`cancelInstall(requestId)`（取消）。`installBundle` 的第二参里官方传了 `registry`（来自 `pluginManager.registries()`），本插件省略 —— 若某天报 registry 缺失，先补这个。
+- **registry 比对在浏览器直连**：`registry.npmjs.org` 带 `Access-Control-Allow-Origin: *`（2026-09 实测），逐包串行 fetch `/latest`，不给 registry 打并发。
+- **装完必须回读实际版本**：pnpm 11 的 `minimumReleaseAge` 门禁会静默暂缓当日发布，只看安装请求成功会把「没装上」报成「成功」。回读**只用 `pluginManager.listBundles()`** —— `pluginInventory` 只有 `list()` 没有 `listBundles`，先取它会掉进「回读版本失败」假阳性（踩过）；装完瞬间清单可能短暂不可用，重试 3 次（1.5s 间隔）再下结论。重试后仍读不到就标「已发起·未确认」（可点重查），版本没变才标「暂缓更新」。
+- **本地包识别 = host 路由为主，404 签名兜底**：`listBundles()` 不透传安装来源（`installed` 不是 spec 字符串），而发布到 npm 的本地包（如 `@nimoxie/dsh-model-organizer`）连 404 签名都不命中 —— 所以 host 半区挂了 `GET /api/ui-tweaks/local-plugins`（读 profile `package.json` 的 dependencies，把 `link:/file:/git+/http` 声明的包名回给面板；仅回环放行）。client 每轮检查先取这份名单标「本地链接」，取不到（host 半区未重启）再退回 404 签名。**改 host 半区必须重启 dsh/客户端才生效**（client bundle 刷新即可）。
+  profile 目录定位：先从 `import.meta.url` 向上找带 `dsh.profile.bundles` 且包含自身的 package.json（npm 直装必命中）；软链安装时模块被解析到 profile 外的真实目录，退回 `DSH_HOME/profiles/*` 扫描，多 profile 命中时按 `ELECTRON_RUN_AS_NODE` 区分 desktop/web。
+- **更新严格串行**：pnpm 对 profile 的 package.json 有文件锁，并发发起不会真并行、只会在锁上排队。队列里的项标「等待更新」，正在装的标「更新中 …」，两者都可点取消。
+- `waitForInstall` 的返回形态官方页面之外没有文档，本插件对 `phase/state/status/ok` 多形状都认、240 秒兜底超时；真实跑通后按实际返回收紧。
+- **刻意不检查 dsh 本体**（用户决策）：桌面端自带更新器，web 端本体升级走 npm。
+
+## 动画修复的实现要点（模块 4）
+
+- **原理**：Windows「动画效果」关闭 → Chromium 报 `prefers-reduced-motion: reduce` → dsh 的 40 处（17 包）`@media` 规则关掉动画。页面内**删不掉媒体查询的求值**，但删得掉规则本身：dsh 的 CSS 全部经 `<style>` 标签注入（实测 0 处 adoptedStyleSheets），同源 sheet 的 `cssRules` 可遍历可 `deleteRule` —— 把 reduce 的 media 块整条递归删除，基础动画声明（非 media 规则）立即生效。效果与 dsh-web-shell 的 CDP `Emulation.setEmulatedMedia` 等价，但**不需要调试端口，桌面端也能用**。
+- **JS 门控**：chat 包 3 处 `matchMedia("(prefers-reduced-motion: reduce)")`（滚动平滑 vs 跳转）用 `window.matchMedia` 包装覆盖 —— 在返回的 MediaQueryList 上 `defineProperty("matches")` 影子化，按 no-preference 应答。包装必须在应用渲染前生效（本插件 apply 在合成期，早于挂载）。
+- **晚到样式**：分包懒加载/换肤重写都靠 `MutationObserver(head)` 防抖重扫 + 2s 轮询兜底（纯 CSSOM 枚举，无布局开销）。
+- **取舍**：与 dsh-web-shell 的 `forceAnimations` 相同 —— 覆盖系统无障碍设置。窗口级覆盖（启动器）换成了会话级覆盖（插件），想恢复系统行为就得停用本插件；若将来要做成可开关，参考 dsh-model-organizer 的设置卡座位。
+- web 窗口里本模块与 dsh-web-shell 的 CDP 覆盖并存是**无害冗余**（都指向 no-preference）。
+
+## 从 dsh-web-shell 迁移的功能（2026-09-30）
+
+对话区左侧滚动条与宽表格修复原是 dsh-web-shell 的 CDP 注入脚本，已整体迁入本插件（client bundle 自由 JS），dsh-web-shell 自身删除了对应代码与 `leftScrollbar` / `tableWidthFix` 配置。迁移时保留的全部实现要点都在 `lib/client.js` 各模块的注释里（宿主挂 body 的理由、composerSeat 裁剪 −4px、拖动三层防御、零位移 wheel 解阅读锚点、出血布局三件套等），此处不重复；下面只记两块迁移后才成立的知识：
+
+- **「检查更新」按安装来源分流**：dsh-web-shell 时代来源由 PowerShell 读 profile 依赖判定；迁入插件后走 host 路由（见「更新检查的实现要点」）。
+- **判断 dsh 是否已修宽表格**（决定何时删除模块 1）：打开含 ≥4 列表格的会话，控制台执行 `getComputedStyle(document.querySelector('[class*="tableScroll"]')).maxWidth` —— 若不再是 `100%`（或包裹层不再越界）说明官方已修，删除 `installTableWidthFix` 函数及其 `apply` 里的 guard 行即完全回滚。
+
+## 待办 / 路线
+
+- [ ] 入口按钮从「会话头部 utilities」迁到 `sidebar.footer.action`（常驻可见，@linxin666/dsh-update 用同一个座位）—— 需先验证空座位容器是否也渲染 `data-slot` 锚点。
+- [ ] 有更新时按钮加角标（现在要点开面板才看到）。
+- [ ] i18n（`ctx.locale.register(NS, {zh, en})`，照 dsh-model-organizer 的写法）。
+- [ ] 第 3 优化点：会话内「重启 dsh」按钮（需要 host 侧配合或官方重启 API，未调研）。
+- [ ] `waitForInstall` 终态按实测收紧；`installBundle` 的 registry 参数补齐。
+- [ ] 插件被禁用/卸载时的运行时清理（目前 DOM 残留到页面刷新为止）。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NimoXie
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,34 @@
+# @nimoxie/dsh-ui-tweaks
+
+[DeepSeek Harness (dsh)](https://github.com/deepseek-ai/deepseek-harness) Web UI 的微调合集插件。装上即生效，无需配置。
+
+## 功能
+
+- **宽表格越界修复** —— 修复 dsh 本体的一个 CSS 缺陷（≥4 列表格撑出对话区、右沿被裁掉还看不到滚动条）。放弃官方的「出血」布局，把宽表格收敛回正文列，横向可滚动。
+- **对话区左侧滚动条** —— 对话区的原生滚动条贴在最右缘，宽屏下要横跨半屏去够；本插件在右侧宽度调整条的左边放一条自绘的常显滚动条：拖拽、点轨道翻页、滚轮转动手感都与原生一致，主题自动跟随明暗，且**只在会话页出现**、切到插件页等非会话页自动移除。
+- **动画修复** —— Windows 关闭「动画效果」时 Chromium 会报告 `prefers-reduced-motion: reduce`，dsh 前端几十处媒体查询规则把动画全关（圈圈不转、流光消失）。本插件在页面内清除这些覆盖规则并让 `matchMedia` 按「有动画」应答，效果与 dsh-web-shell 的调试端口覆盖相同，**web 与桌面客户端都生效**。
+- **插件更新检查** —— 会话工具栏多一枚「插件更新」按钮：逐个比对**全部已装插件**与 npm registry 的版本，弹面板列出（名字 / 当前版本 → 远端 / 状态标签）；**有新版本的插件点标签就地更新**，支持「全部更新」与中途取消。**不检查 dsh 本体**（桌面客户端自带更新器；web 端本体升级请走 `npm install -g @deepseek-ai/dsh@next`）。
+
+## 环境要求
+
+- dsh `>= 0.2.0-rc.1`（依赖 0.2.x 的 `remote.pluginManager` / `remote.pluginInventory` 接口）。
+- web / 桌面客户端均可（桌面端同样适用，但桌面端有自己的本体更新，本插件的更新检查只覆盖插件）。
+
+## 安装
+
+```sh
+# 从 npm 安装
+dsh plugin --profile <profile> add @nimoxie/dsh-ui-tweaks
+
+# 本地开发（软链，改完 Ctrl+Shift+R 即生效，见 DEVELOPING.md）
+dsh plugin --profile <profile> add link:<本仓库路径>
+```
+
+## 注意
+
+- 本插件是启动器 dsh-web-shell 的配套插件：对话区滚动条、宽表格修复等界面增强已由本插件提供，`dsh-web-shell` 自身不再注入（其「检查更新」按钮仍负责 **dsh 本体**的比对与升级提示）。
+- 更新走 profile 内的插件安装接口，与官方插件管理页同源；`link:` / `file:` / `git+` 直装的插件没有可比的 registry 版本，会标为「本地链接」跳过。
+
+## 开源协议
+
+[MIT](./LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,7 @@
+# dsh-ui-tweaks 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.
+# Scoped 包名的 name 必须写全（同 @linxin666 系插件），loader 按它解析 node_modules。
+- insert:
+    - id: ui-tweaks
+      name: '@nimoxie/dsh-ui-tweaks'

package/lib/client.js

@@ -0,0 +1,994 @@
+/* dsh-ui-tweaks browser half.
+ *
+ * 三个独立模块，任一失败都不得拖垮其它（各自 guard）：
+ *   1. tablefix   —— 宽表格越界修复（纯 CSS 覆盖，见 README「宽表格修复」）
+ *   2. scrollbar  —— 对话区左侧自绘滚动条（从 dsh-web-shell 移植，选择器适配 0.2.x）
+ *   3. updates    —— 插件更新检查面板（不含 dsh 本体；remote.pluginManager/pluginInventory）
+ *
+ * 装载机制：shell 的 window.__ModuleLoader__.load + factory(require)；
+ * apply(ctx) 由客户端 cordis 上下文调用（同 dsh-model-organizer 的结构）。
+ */
+window.__ModuleLoader__.load({
+  id: "@nimoxie/dsh-ui-tweaks",
+  factory: (require) => {
+    const module = { exports: {} };
+    const exports = module.exports;
+
+    const BUILD = "0.1.0";
+
+    /* 每个模块的注册各套一层 guard：失败只记 warn（座位/模块失败模式是「静默消失」，
+       必须主动吭声；但不能让一个模块的异常打断同文件里其它模块的 apply）。 */
+    function guard(name, fn) {
+      try {
+        return fn();
+      } catch (e) {
+        try { console.warn("[dsh-ui-tweaks:" + BUILD + "]", name, e); } catch (_) {}
+        return null;
+      }
+    }
+
+    /* ======================================================================
+     * 模块 1：宽表格越界修复（对 dsh 本体的只读样式补丁）
+     *
+     * 缺陷（0.2.0-rc.1 实测仍在）：@deepseek-ai/dsh-client-ui-chat 给
+     * .md-table-wide（≥4 列且不在引用块内）做了「出血」布局（width 加宽 +
+     * margin-left 负值左移 + padding-left 推回），而 primitives 的
+     * .tableScroll{max-width:100%} 管不住内部 width:max-content 的表格，
+     * overflow-x:hidden 之下内容直接被裁（实测右沿超出可视区约 280px）。
+     *
+     * 修法：放弃出血，收敛回正文列 —— 同时中和 width / margin-left /
+     * padding-left 三件套并放开 overflow-x（三者缺一不可，只改宽度会留下
+     * 负 margin，只去 margin 不约束宽度则继续越界）。
+     *
+     * 防失效设计：
+     *   ① 选择器用属性前缀 [class*="tableScroll"]（CSS modules「哈希_原名」，
+     *      dsh 换版本改哈希也不失效，绝不硬编码 hash）；
+     *   ② 全部声明带 !important 压过 dsh 自己的规则；
+     *   ③ 单一 <style id> + 存在性检查，删除节点即完全回滚。
+     * ==================================================================== */
+    function installTableWidthFix() {
+      var STYLE_ID = "dshuiw-table-width-fix";
+      if (document.getElementById(STYLE_ID)) { return; }
+      var st = document.createElement("style");
+      st.id = STYLE_ID;
+      st.setAttribute("data-dshuiw", "table-width-fix");
+      st.textContent =
+        "[class*=\"tableScroll\"]{" +
+          "width:100%!important;" +
+          "max-width:100%!important;" +
+          "margin-left:0!important;" +
+          "padding-left:0!important;" +
+          "padding-bottom:0!important;" +
+          "overflow-x:auto!important;" +
+        "}" +
+        /* 内部表格：允许按内容排布（保留列宽语义），宽度交给包裹层约束 */
+        "[class*=\"tableScroll\"]>table{" +
+          "max-width:none!important;" +
+          "min-width:max-content;" +
+        "}" +
+        /* 滚动条尽量细、贴近 dsh 的视觉语言 */
+        "[class*=\"tableScroll\"]{scrollbar-width:thin}";
+      (document.head || document.documentElement).appendChild(st);
+    }
+
+    /* ======================================================================
+     * 模块 2：对话区左侧自绘滚动条（自绘拇指）
+     *
+     * 从 dsh-web-shell 的注入脚本移植（该实现经过 A/B 实测）：
+     *   · 宿主挂 document.body + position:fixed —— 挂进 React 管的容器会被
+     *     「加载更早」等重渲染抹掉；fixed 还让滚动区自己滚时宿主纹丝不动。
+     *   · 拖动 = PointerCapture 下的纯函数：sp.scrollTop 由拇指位置一步算出；
+     *     pointermove 同步写 + scroll 捕获段回纠 + rAF 兜底（三层防御）。
+     *   · 「加载更早」后 dsh 会钉阅读锚点，只有 wheel/pointerdown 等读者意图
+     *     事件会解除 —— 宿主在滚动区外，pointerdown 到不了 dsh 的监听器，
+     *     所以按下/滚轮时补发一个零位移 synthetic wheel（notifyReaderIntent）。
+     *   · 只在「会话视图」显示：scrollport + 右侧调宽条 + 有实际高度三者齐备
+     *     才保留宿主，切到插件页等非会话页自动移除。
+     *   · 高度裁到输入框（composerSeat，sticky 浮在底部）上沿 −4px。
+     *
+     * 0.2.x 选择器适配（0.1.x 的 data-dsh-part 标记已被 dsh 全部移除）：
+     *   滚动区  [data-conversation-scroll]
+     *   调宽条  [class*="widthHandle"][data-side="right"]
+     *   输入框  [class*="composerSeat"]
+     * ==================================================================== */
+    function installLeftScrollbar() {
+      if (window.__DSHUIW_LEFT_SB__) { return; }
+      window.__DSHUIW_LEFT_SB__ = true;
+      var HOST_ID = "dshuiw-scrollbar-host";
+
+      function findScroller() {
+        return document.querySelector('[data-dsh-part="scrollport"]') ||
+               document.querySelector("[data-conversation-scroll]");
+      }
+      function findRightHandle() {
+        var hs = document.querySelectorAll('[data-dsh-part="resize-handle"]');
+        for (var i = 0; i < hs.length; i++) {
+          if (hs[i].getAttribute("data-side") === "right") { return hs[i]; }
+        }
+        /* dsh 0.2.x：宽度调整条 = widthHandle 类 + data-side（无 data-dsh-part） */
+        return document.querySelector('[class*="widthHandle"][data-side="right"]');
+      }
+      function findComposer() {
+        var c = document.querySelector('[data-dsh-part="composer-input"]');
+        if (c) { return c.closest('[class*="composerSeat"]') || c; }
+        return document.querySelector('[class*="composerSeat"]');
+      }
+
+      var sp = null, handle = null, host = null, track = null, thumb = null;
+      var composerEl = null, ro = null;
+      if (window.ResizeObserver) {
+        ro = new ResizeObserver(function () { ensure(); });
+      }
+      var dragging = false, dragOffsetY = 0;
+      var curThumbH = 40, curThumbTop = 0, curTrackH = 0;
+      var trRect = null;
+      var lastPointerY = 0, dragRaf = 0;
+
+      /* 「加载更早」、切会话等操作可能换掉 scrollport 节点：交互点先校验节点
+         身份，变了就重绑，否则写入落在旧节点上 —— 拖动没反应、松手弹回。 */
+      function rebindIfScrollerChanged() {
+        if (sp && findScroller() !== sp) { ensure(); return true; }
+        return false;
+      }
+
+      function visibleHeight() {
+        if (!sp) { return 0; }
+        var c = findComposer();
+        if (!c) { return sp.clientHeight; }
+        var cr = c.getBoundingClientRect();
+        var sr = sp.getBoundingClientRect();
+        if (cr.top >= sr.bottom - 2) { return sp.clientHeight; }
+        var v = cr.top - sr.top - 4;
+        return (v > 80 && v < sp.clientHeight) ? v : sp.clientHeight;
+      }
+
+      function build() {
+        host = document.createElement("div");
+        host.id = HOST_ID;
+        host.style.width = "14px";
+        var sr = host.attachShadow({ mode: "open" });
+        sr.innerHTML = "<style>" +
+          ":host{position:fixed;z-index:6}" +
+          ".track{position:absolute;top:0;right:0;width:100%;height:100%;" +
+          "user-select:none;-webkit-user-select:none;touch-action:none}" +
+          ".track[hidden]{display:none}" +
+          ".thumb{position:absolute;right:0;width:100%;background:transparent}" +
+          ".thumb::after{content:\"\";position:absolute;top:0;bottom:0;right:3px;width:7px;border-radius:4px;" +
+          "background:rgba(128,128,128,.4);" +
+          "background:color-mix(in srgb,currentColor 32%,transparent);" +
+          "transition:width .12s,right .12s,background .12s}" +
+          ".track:hover .thumb::after,.thumb.drag::after{right:2px;width:9px;" +
+          "background:rgba(128,128,128,.62);" +
+          "background:color-mix(in srgb,currentColor 55%,transparent)}" +
+          "</style><div class=\"track\" hidden><div class=\"thumb\"></div></div>";
+        track = sr.querySelector(".track");
+        thumb = sr.querySelector(".thumb");
+        wireEvents();
+        document.body.appendChild(host);
+      }
+
+      /* thumb 几何：高 = 轨道 × 可见比，位置 = scrollTop / scrollHeight */
+      function render() {
+        if (!sp || !track || !thumb) { return; }
+        track.hidden = false;
+        var range = sp.scrollHeight - sp.clientHeight;
+        var th = track.clientHeight;
+        if (range <= 0 || th <= 0) { track.hidden = true; return; }
+        curTrackH = th;
+        curThumbH = Math.round(th * sp.clientHeight / sp.scrollHeight);
+        if (curThumbH < 28) { curThumbH = 28; }
+        if (curThumbH > th) { curThumbH = th; }
+        curThumbTop = Math.round(th * sp.scrollTop / sp.scrollHeight);
+        if (curThumbTop > th - curThumbH) { curThumbTop = th - curThumbH; }
+        if (curThumbTop < 0) { curThumbTop = 0; }
+        if (thumb.style.height !== curThumbH + "px") { thumb.style.height = curThumbH + "px"; }
+        if (thumb.style.top !== curThumbTop + "px") { thumb.style.top = curThumbTop + "px"; }
+      }
+
+      /* 补发零位移 wheel 作纯阅读意图：解除 dsh 的阅读锚点保留（stopPreserving），
+         否则「加载更早」后拖动会被判成程序化滚动、松手弹回锚点。 */
+      function notifyReaderIntent() {
+        if (!sp) { return; }
+        var targets = [sp];
+        try {
+          var outer = sp.closest("[data-conversation-scroll]");
+          if (outer && outer !== sp) { targets.push(outer); }
+        } catch (e) {}
+        for (var i = 0; i < targets.length; i++) {
+          try {
+            targets[i].dispatchEvent(new WheelEvent("wheel", { deltaY: 0, bubbles: false, cancelable: true }));
+          } catch (e) {}
+        }
+      }
+
+      /* 三层防御共用的纯函数：pointermove 同步写 + scroll 捕获段回纠 + rAF 兜底 */
+      function applyDrag() {
+        if (!dragging || !sp || !track || !trRect) { return; }
+        var top = lastPointerY - dragOffsetY - trRect.top;
+        var maxTop = curTrackH - curThumbH;
+        if (maxTop <= 0) { return; }
+        if (top < 0) { top = 0; }
+        if (top > maxTop) { top = maxTop; }
+        var want = top / curTrackH * sp.scrollHeight;
+        if (Math.abs(sp.scrollTop - want) > 0.5) { sp.scrollTop = want; }
+        render();
+      }
+
+      function wireEvents() {
+        track.addEventListener("pointerdown", function (e) {
+          if (!sp || !track) { return; }
+          rebindIfScrollerChanged();
+          if (!sp || !track) { return; }
+          trRect = track.getBoundingClientRect();
+          var tR = thumb.getBoundingClientRect();
+          if (e.clientY >= tR.top && e.clientY <= tR.bottom) {
+            dragging = true;
+            dragOffsetY = e.clientY - tR.top;
+          } else {
+            /* 点轨道 = 标准翻页：拇指中心跳到点击处，顺势进入拖动 */
+            var top0 = e.clientY - trRect.top - curThumbH / 2;
+            var maxTop0 = curTrackH - curThumbH;
+            if (top0 < 0) { top0 = 0; }
+            if (top0 > maxTop0) { top0 = maxTop0; }
+            sp.scrollTop = top0 / curTrackH * sp.scrollHeight;
+            curThumbTop = top0;
+            dragging = true;
+            dragOffsetY = e.clientY - (trRect.top + curThumbTop);
+          }
+          lastPointerY = e.clientY;
+          notifyReaderIntent();
+          thumb.classList.add("drag");
+          try { track.setPointerCapture(e.pointerId); } catch (err) {}
+          e.preventDefault();
+          render();
+          startDragTick();
+        });
+        track.addEventListener("pointermove", function (e) {
+          if (!dragging || !sp || !track || !trRect) { return; }
+          lastPointerY = e.clientY;
+          if (rebindIfScrollerChanged()) { trRect = track.getBoundingClientRect(); }
+          applyDrag();
+        });
+        function release(e) {
+          if (!dragging) { return; }
+          dragging = false;
+          trRect = null;
+          if (dragRaf) { cancelAnimationFrame(dragRaf); dragRaf = 0; }
+          thumb.classList.remove("drag");
+          try { track.releasePointerCapture(e.pointerId); } catch (err) {}
+        }
+        function startDragTick() {
+          if (dragRaf) { cancelAnimationFrame(dragRaf); }
+          var tick = function () {
+            if (!dragging) { dragRaf = 0; return; }
+            rebindIfScrollerChanged();
+            applyDrag();
+            dragRaf = requestAnimationFrame(tick);
+          };
+          dragRaf = requestAnimationFrame(tick);
+        }
+        track.addEventListener("pointerup", release);
+        track.addEventListener("pointercancel", release);
+        /* 悬停在条上时滚轮转发给真容器（同样补发阅读意图） */
+        host.addEventListener("wheel", function (e) {
+          if (!sp) { return; }
+          rebindIfScrollerChanged();
+          if (!sp) { return; }
+          e.preventDefault();
+          notifyReaderIntent();
+          sp.scrollTop += e.deltaY;
+          render();
+        }, { passive: false });
+      }
+
+      function place() {
+        if (!host || !sp) { return; }
+        var q = sp.getBoundingClientRect();
+        var top = Math.round(q.top), h = Math.round(visibleHeight());
+        var edge = handle ? handle.getBoundingClientRect().left : q.right;
+        var left = Math.round(edge - host.offsetWidth);
+        if (host.style.top !== top + "px") { host.style.top = top + "px"; }
+        if (host.style.height !== h + "px") { host.style.height = h + "px"; }
+        if (host.style.left !== left + "px") { host.style.left = left + "px"; }
+      }
+
+      /* scroll 捕获段监听（scroll 不冒泡但下传捕获段），对节点替换天然免疫；
+         拖动期间还负责把非本脚本的 scrollTop 写动立刻纠正回来。 */
+      function onDocScroll(e) {
+        if (!sp || e.target !== sp) { return; }
+        if (dragging) { applyDrag(); } else { render(); }
+      }
+      document.addEventListener("scroll", onDocScroll, { capture: true, passive: true });
+
+      function ensure() {
+        var found = findScroller();
+        if (found !== sp) { sp = found; }
+        var hFound = findRightHandle();
+        if (hFound !== handle) {
+          if (handle) { try { handle.removeEventListener("pointermove", place); } catch (e) {} }
+          handle = hFound;
+          if (handle) { try { handle.addEventListener("pointermove", place, { passive: true }); } catch (e) {} }
+        }
+        /* 只在会话视图显示：scrollport + 调宽条 + 实际高度三者齐备；
+           否则移除宿主（切到插件页等非会话页不留残影）。 */
+        var spVisible = !!(sp && sp.isConnected && sp.getBoundingClientRect().height > 0);
+        if (!spVisible || !handle) {
+          if (host) {
+            try { host.remove(); } catch (e) {}
+            host = null; track = null; thumb = null;
+            dragging = false;
+            dragOffsetY = 0;
+            if (dragRaf) { cancelAnimationFrame(dragRaf); dragRaf = 0; }
+          }
+          return;
+        }
+        if (!host || !host.isConnected) {
+          if (host) { try { host.remove(); } catch (e) {} }
+          host = null; track = null; thumb = null;
+          build();
+        }
+        if (ro) {
+          try { ro.observe(sp); } catch (e) {}
+          var ce = findComposer();
+          if (ce !== composerEl) {
+            if (composerEl) { try { ro.unobserve(composerEl); } catch (e) {} }
+            composerEl = ce;
+            if (composerEl) { try { ro.observe(composerEl); } catch (e) {} }
+          }
+        }
+        place();
+        render();
+      }
+
+      ensure();
+      /* 700ms 兜底轮询：补挂 / 高度 / 落点；不用全文档 MutationObserver
+         （流式输出每帧都有 mutation，ensure 读 rect 会强制布局）。 */
+      setInterval(ensure, 700);
+      window.addEventListener("resize", ensure);
+    }
+
+    /* ======================================================================
+     * 模块 3：插件更新检查面板（不含 dsh 本体 —— 桌面端自带更新器，
+     * web 端本体升级走 npm，都不归这个插件管）
+     *
+     * 全部走官方 remote API，不自建 host 路由：
+     *   remote.pluginManager.listBundles()   → 已装插件包（name/version/installed）
+     *   remote.pluginManager.installBundle(spec, {enabled, requestId}) → 更新
+     *   remote.pluginManager.waitForInstall(requestId) → 安装进度轮询
+     *   remote.pluginManager.cancelInstall(requestId)  → 取消
+     * registry 比对从浏览器直连（registry.npmjs.org 带 CORS *）。
+     *
+     * 更新严格串行（pnpm 对 profile 的 package.json 有文件锁，并发只会在锁上
+     * 排队）；更新完成后回读实际版本 —— pnpm 的 minimumReleaseAge 可能静默
+     * 暂缓当日发布，只看退出状态会把「没装上」报成「成功」。
+     * ==================================================================== */
+    function installPluginUpdates(ctx) {
+      if (window.__DSHUIW_UPDATES__) { return; }
+      window.__DSHUIW_UPDATES__ = true;
+      var BTN_ID = "dshuiw-updates-btn-host";
+      var PANEL_ID = "dshuiw-updates-panel-host";
+      var POS_KEY = "dshuiw-updates-panel-pos";
+
+      /* ---- semver 比较（rc 比数字/字母、正式版 > 预发布版；字符串比会把
+         rc.9 判成大于 rc.10，必须自己实现）---- */
+      function cmpSemver(a, b) {
+        function parse(v) {
+          var m = String(v == null ? "" : v).trim().replace(/^v/, "")
+            .match(/^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/);
+          if (!m) { return null; }
+          return { core: [+m[1], +m[2], +m[3]], pre: m[4] ? m[4].split(".") : null };
+        }
+        var pa = parse(a), pb = parse(b);
+        if (!pa || !pb) { return String(a) === String(b) ? 0 : (String(a) < String(b) ? -1 : 1); }
+        for (var i = 0; i < 3; i++) {
+          if (pa.core[i] !== pb.core[i]) { return pa.core[i] < pb.core[i] ? -1 : 1; }
+        }
+        var ha = pa.pre === null, hb = pb.pre === null;
+        if (ha && hb) { return 0; }
+        if (ha) { return 1; }
+        if (hb) { return -1; }
+        for (var j = 0; j < Math.max(pa.pre.length, pb.pre.length); j++) {
+          var x = pa.pre[j], y = pb.pre[j];
+          if (x === undefined) { return -1; }
+          if (y === undefined) { return 1; }
+          var xn = /^\d+$/.test(x), yn = /^\d+$/.test(y);
+          if (xn && yn) { var d = +x - +y; if (d) { return d < 0 ? -1 : 1; } }
+          else if (xn) { return -1; }
+          else if (yn) { return 1; }
+          else if (x !== y) { return x < y ? -1 : 1; }
+        }
+        return 0;
+      }
+
+      function uuid() {
+        try { if (crypto && crypto.randomUUID) { return crypto.randomUUID(); } } catch (e) {}
+        return "req-" + Date.now() + "-" + Math.random().toString(36).slice(2);
+      }
+      function esc(s) {
+        return String(s == null ? "" : s).replace(/[&<>"]/g, function (c) {
+          return { "&": "&amp;", "<": "&lt;", ">": "&gt;", "\"": "&quot;" }[c];
+        });
+      }
+
+      /* ---- remote 服务解析：ctx.inject 的 scope 优先（缓存复用），超时兜底直读 ctx ---- */
+      var savedScope = null;
+      var got = null;             // checkNow 的服务句柄缓存（{pm}）
+      function pickService(scope, dotted) {
+        var cands = [];
+        var s = scope || savedScope;
+        if (s) {
+          cands.push(s[dotted]);
+          var root = dotted.split(".")[0];
+          if (s[root]) { cands.push(s[root][dotted.split(".")[1]]); }
+        }
+        cands.push(ctx && ctx[dotted]);
+        if (ctx) {
+          var root2 = dotted.split(".")[0];
+          if (ctx[root2]) { cands.push(ctx[root2][dotted.split(".")[1]]); }
+        }
+        for (var i = 0; i < cands.length; i++) { if (cands[i]) { return cands[i]; } }
+        return null;
+      }
+
+      function fetchLatest(name) {
+        var path = String(name).split("/").map(encodeURIComponent).join("/");
+        return fetch("https://registry.npmjs.org/" + path + "/latest", { cache: "no-store" })
+          .then(function (r) {
+            if (r.status === 404) {
+              /* npm 上没有这个包：本地直装（link:/file:）或尚未发布 —— 不是「检查失败」。
+                 官方 listBundles 不透传安装来源，404 就是本地包的唯一可靠签名。 */
+              var e404 = new Error("npm 上查不到此包（未发布或本地直装）");
+              e404.notFound = true;
+              throw e404;
+            }
+            if (!r.ok) { throw new Error("HTTP " + r.status); }
+            return r.json();
+          })
+          .then(function (d) { return d && d.version ? String(d.version) : null; });
+      }
+
+      /* 本地直装（link:/file:/git+/http）没有可比的 registry 版本。
+       * 来源判定主路径是 host 半区的 /api/ui-tweaks/local-plugins（读 profile
+       * 依赖声明）；host 未重启/路由不可用时退回 registry 404 签名。 */
+      function fetchLocalNames(cb) {
+        fetch("/api/ui-tweaks/local-plugins", { cache: "no-store" })
+          .then(function (r) { if (!r.ok) { throw new Error("HTTP " + r.status); } return r.json(); })
+          .then(function (d) { cb(d && d.ok && Array.isArray(d.local) ? d.local : []); })
+          .catch(function () { cb([]); });
+      }
+      function localSource(src) {
+        var s = String(src || "");
+        return /^(link:|file:|git[+:@]|github:|http)/.test(s);
+      }
+
+      /* ---- 面板状态 ---- */
+      var rows = [];              // {name, version, latest, state, why}
+      // state: pending | checking | current | update | local | error | queuing | busy | done | unchanged
+      var queue = [];             // 待更新名单（串行队列）
+      var busyName = "";          // 正在更新的那个
+      var busyReq = "";
+      var cancelling = false;
+      var checking = false;
+      var listeners = [];         // 面板重绘订阅（面板未开时也维护状态）
+
+      function emit() { for (var i = 0; i < listeners.length; i++) { try { listeners[i](); } catch (e) {} } }
+
+      function setRow(name, patch) {
+        for (var i = 0; i < rows.length; i++) {
+          if (rows[i].name === name) { for (var k in patch) { rows[i][k] = patch[k]; } break; }
+        }
+        emit();
+      }
+
+      function checkNow() {
+        if (checking) { return; }
+        checking = true;
+        rows = [];
+        emit();
+        var pm = null;
+        // 服务句柄在回调里现取（ctx.inject 服务齐了才回调，可能异步；waitScope 轮询等待）
+        if (!got) {
+          ctx.inject(["remote", "remote.pluginManager", "remote.pluginInventory"], function (s) {
+            savedScope = s;
+            got = { pm: pickService(s, "remote.pluginManager") };
+          });
+        }
+        var started = Date.now();
+        function waitScope() {
+          if (!got && Date.now() - started < 8000) { setTimeout(waitScope, 150); return; }
+          if (!got || !got.pm) {
+            rows = [{ name: "（插件清单服务不可用）", version: "", latest: "", state: "error", why: "remote.pluginManager 未就绪；请升级 dsh 或稍后重试" }];
+            checking = false; emit(); return;
+          }
+          pm = got.pm;
+          Promise.all([pm.listBundles(), pm.listPlugins()])
+            .then(function (r) {
+              var bundles = (r[0] && r[0].ok && r[0].value) || [];
+              var plugins = (r[1] && r[1].ok && r[1].value) || [];
+              if (!bundles.length && plugins.length) { bundles = plugins; }
+              rows = bundles.map(function (b) {
+                var name = b.name || b.id || "";
+                var ver = b.version != null ? String(b.version) : (b.installedVersion != null ? String(b.installedVersion) : "");
+                var src = typeof b.installed === "string" ? b.installed : (typeof b.source === "string" ? b.source : "");
+                return {
+                  name: name, version: ver, latest: "",
+                  state: localSource(src) ? "local" : (ver ? "checking" : "unknown"),
+                  src: src, why: ""
+                };
+              }).filter(function (x) { return x.name; });
+              checking = false;
+              emit();
+              // 先向 host 半区要本地直装名单，命中的行直接标「本地链接」不进比对 ——
+              // 已发布到 npm 的本地包（如 @nimoxie/dsh-model-organizer）靠它认出；
+              // host 未重启（无路由）时名单为空，退回 registry 404 签名判定。
+              fetchLocalNames(function (localNames) {
+                var localSet = {};
+                (localNames || []).forEach(function (n) { localSet[n] = true; });
+                rows.forEach(function (row) {
+                  if (localSet[row.name] && row.state === "checking") {
+                    row.state = "local";
+                    row.why = "profile 依赖声明为本地路径，不参与 registry 比对";
+                  }
+                });
+                emit();
+                // 逐个查 registry（串行，别对 registry 打并发）
+                var chain = Promise.resolve();
+                rows.forEach(function (row) {
+                  if (row.state !== "checking") { return; }
+                  chain = chain.then(function () {
+                    return fetchLatest(row.name).then(function (v) {
+                      row.latest = v || "";
+                      row.state = v && cmpSemver(v, row.version) > 0 ? "update" : "current";
+                      emit();
+                    }).catch(function (e) {
+                      row.state = e && e.notFound ? "local" : "error";
+                      row.why = String(e && e.message || e);
+                      emit();
+                    });
+                  });
+                });
+              });
+            })
+            .catch(function (e) {
+              rows = [{ name: "（读取插件清单失败）", version: "", latest: "", state: "error", why: String(e && e.message || e) }];
+              checking = false; emit();
+            });
+        }
+        waitScope();
+      }
+
+      /* ---- 更新执行：串行队列；装完回读实际版本判定真实结果 ---- */
+      function enqueue(name) {
+        if (busyName) {
+          if (queue.indexOf(name) < 0 && name !== busyName) { queue.push(name); setRow(name, { state: "queuing" }); }
+          return;
+        }
+        queue.push(name);
+        pump();
+      }
+      function pump() {
+        var name = queue.shift();
+        if (!name) { return; }
+        startOne(name);
+      }
+      function startOne(name) {
+        busyName = name;
+        busyReq = uuid();
+        setRow(name, { state: "busy" });
+        emit();
+        var pm = pickService(null, "remote.pluginManager");
+        if (!pm) { finishOne(name, false, "remote.pluginManager 不可用"); return; }
+        var settled = false;
+        function finish(ok, why) {
+          if (settled) { return; }
+          settled = true;
+          finishOne(name, ok, why || "");
+        }
+        try {
+          pm.installBundle(name + "@latest", { enabled: true, requestId: busyReq })
+            .then(function (res) {
+              if (!res || res.ok === false) {
+                finish(false, (res && res.failure && (res.failure.message || res.failure.reason)) || (res && res.message) || "安装请求被拒");
+                return;
+              }
+              /* 轮询进度；终态形态未知，多形状都认，240s 兜底 */
+              var t0 = Date.now();
+              function poll() {
+                var done = false;
+                try {
+                  var p = pm.waitForInstall ? pm.waitForInstall(busyReq) : null;
+                  Promise.resolve(p).then(function (st) {
+                    var ph = st && (st.phase || st.state || st.status);
+                    if (ph === "done" || ph === "completed" || ph === "finished" || (st && st.ok === true)) { done = true; finish(true, ""); }
+                    else if (ph === "failed" || ph === "error" || ph === "cancelled" || (st && st.ok === false)) {
+                      finish(false, (st && st.failure && (st.failure.message || st.failure.reason)) || "安装失败");
+                    }
+                  }).catch(function () { /* 轮询失败不作为终态 */ });
+                } catch (e) {}
+                if (!done && !settled && Date.now() - t0 < 240000) { setTimeout(poll, 900); }
+                else if (!settled && Date.now() - t0 >= 240000) { finish(false, "更新超时（240 秒未结束）"); }
+              }
+              poll();
+            })
+            .catch(function (e) { finish(false, String(e && e.message || e)); });
+        } catch (e) { finish(false, String(e && e.message || e)); }
+      }
+      /* 装完回读清单：版本变了才算真的装上（pnpm minimumReleaseAge 可能静默暂缓）。
+       * 只用 pluginManager.listBundles —— pluginInventory 没有 listBundles 方法
+       * （只有 list()），之前先取 inventory 导致 guard 落到 reject，面板上的
+       * 「安装已发起，但回读版本失败」假阳性就是它。装完瞬间清单可能短暂
+       * 不可用，重试 3 次（间隔 1.5s）再下结论。 */
+      function finishOne(name, ok, why) {
+        var before = null;
+        for (var i = 0; i < rows.length; i++) { if (rows[i].name === name) { before = rows[i].version; break; } }
+        var pm = pickService(null, "remote.pluginManager");
+        function done() {
+          busyName = ""; busyReq = ""; cancelling = false;
+          emit();
+          pump();
+        }
+        function attempt(n) {
+          if (!pm || !pm.listBundles) {
+            setRow(name, ok ? { state: "unconfirmed", why: "安装已发起；清单服务不可用，未能回读版本" } : { state: "error", why: why || "更新失败" });
+            done();
+            return;
+          }
+          Promise.resolve(pm.listBundles()).then(function (r) {
+            var bundles = (r && r.ok && r.value) || [];
+            var ver = "";
+            for (var i = 0; i < bundles.length; i++) {
+              if (bundles[i].name === name) { ver = bundles[i].version != null ? String(bundles[i].version) : ""; break; }
+            }
+            if (!bundles.length && n < 3) { setTimeout(function () { attempt(n + 1); }, 1500); return; }
+            if (ver) {
+              if (before && ver === before) {
+                setRow(name, { state: "unchanged", why: "版本未变化：可能被 pnpm 发布时长策略暂缓，也可能检查时远端版本信息有误" });
+              } else {
+                setRow(name, { version: ver, state: "current", latest: ver, why: "" });
+              }
+            } else if (ok) {
+              setRow(name, { state: "unconfirmed", why: "安装已发起，但清单里没读到它；点击重查确认" });
+            } else {
+              setRow(name, { state: "error", why: why || "更新失败" });
+            }
+            done();
+          }).catch(function () {
+            if (n < 3) { setTimeout(function () { attempt(n + 1); }, 1500); return; }
+            setRow(name, ok ? { state: "unconfirmed", why: "安装已发起，但回读版本失败；点击重查确认" } : { state: "error", why: why || "更新失败" });
+            done();
+          });
+        }
+        attempt(0);
+      }
+      function requestCancel() {
+        if (!busyName || cancelling) { return; }
+        cancelling = true;
+        queue = [];
+        rows.forEach(function (r) { if (r.state === "queuing") { r.state = r.latest && cmpSemver(r.latest, r.version) > 0 ? "update" : "current"; } });
+        var pm = pickService(null, "remote.pluginManager");
+        try { if (pm && pm.cancelInstall && busyReq) { pm.cancelInstall(busyReq); } } catch (e) {}
+        setRow(busyName, { state: "error", why: "已请求取消" });
+        emit();
+      }
+
+      /* ---- 面板 UI：挂在 body 的 Shadow DOM（fixed 浮层不能放进 flex 工具栏）---- */
+      function panelWrap() {
+        var host = document.getElementById(PANEL_ID);
+        if (host && host.shadowRoot) { return host.shadowRoot.querySelector(".wrap"); }
+        if (host) { host.remove(); }
+        host = document.createElement("div");
+        host.id = PANEL_ID;
+        document.body.appendChild(host);
+        var sr = host.attachShadow({ mode: "open" });
+        sr.innerHTML = "<style>" +
+          ".wrap{position:fixed;top:56px;right:16px;z-index:2147483000;width:344px;display:flex;" +
+          "flex-direction:column;max-height:64vh;overflow:hidden;border-radius:12px;" +
+          "border:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.32));" +
+          "background:var(--dsw-alias-bg-base,#1b1d23);color:var(--dsw-alias-label-primary,#e8e9ec);" +
+          "box-shadow:0 10px 30px rgba(0,0,0,.34);" +
+          "font:13px/1.55 system-ui,-apple-system,\"Microsoft YaHei UI\",sans-serif}" +
+          ".wrap[hidden]{display:none}" +
+          ".hd{display:flex;align-items:center;gap:8px;padding:10px 12px;flex:0 0 auto;" +
+          "border-bottom:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.22));" +
+          "cursor:move;user-select:none;-webkit-user-select:none}" +
+          ".hd b{flex:1;font-size:13px;font-weight:600}" +
+          ".x{cursor:pointer;opacity:.55;font-size:17px;line-height:1;padding:0 3px}" +
+          ".x:hover{opacity:1}" +
+          ".rows{flex:1 1 auto;min-height:0;overflow:auto}" +
+          ".row{display:flex;align-items:center;gap:8px;padding:7px 12px;" +
+          "border-bottom:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.12))}" +
+          ".row:last-child{border-bottom:0}" +
+          ".nm{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}" +
+          ".ver{opacity:.6;font-size:12px;white-space:nowrap;font-variant-numeric:tabular-nums}" +
+          ".tag{font-size:11px;padding:1px 7px;border-radius:999px;white-space:nowrap;" +
+          "border:1px solid transparent;flex:0 0 auto}" +
+          ".tag.update{background:rgba(255,138,0,.16);color:#f0a35e;border-color:rgba(255,138,0,.32);cursor:pointer}" +
+          ".tag.current{background:rgba(62,207,142,.14);color:#4fbf8b;border-color:rgba(62,207,142,.28)}" +
+          ".tag.other{background:rgba(128,128,128,.14);opacity:.85}" +
+          ".tag.busy{opacity:.6}" +
+          ".tag.error{background:rgba(255,80,80,.14);color:#e07070;border-color:rgba(255,80,80,.28);cursor:pointer}" +
+          ".allbtn{cursor:pointer;font-size:12px;padding:2px 9px;border-radius:6px;flex:0 0 auto;" +
+          "border:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.4))}" +
+          ".allbtn:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(128,128,128,.14))}" +
+          ".allbtn[hidden]{display:none}" +
+          ".recheck{cursor:pointer;font-size:12px;padding:2px 9px;border-radius:6px;flex:0 0 auto;" +
+          "border:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.4));opacity:.85}" +
+          ".recheck:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(128,128,128,.14));opacity:1}" +
+          ".msg{padding:10px 12px;white-space:pre-wrap;word-break:break-word;opacity:.85}" +
+          "</style><div class=\"wrap\" hidden></div>";
+        var wrap = sr.querySelector(".wrap");
+
+        /* 拖拽（记 localStorage，重载回原位） */
+        try {
+          var saved = localStorage.getItem(POS_KEY);
+          if (saved) {
+            var a = saved.split(",");
+            if (isFinite(+a[0]) && isFinite(+a[1])) { wrap.style.left = a[0] + "px"; wrap.style.top = a[1] + "px"; wrap.style.right = "auto"; }
+          }
+        } catch (e) {}
+        sr.addEventListener("pointerdown", function (e) {
+          var t = e.target;
+          if (!t || !t.closest || !t.closest(".hd") || t.closest(".x") || t.closest(".allbtn")) { return; }
+          var r = wrap.getBoundingClientRect();
+          var offX = e.clientX - r.left, offY = e.clientY - r.top;
+          e.preventDefault();
+          function clamp(x, y, w, h) {
+            return { x: Math.min(Math.max(0, x), Math.max(0, window.innerWidth - w)),
+                     y: Math.min(Math.max(0, y), Math.max(0, window.innerHeight - h)) };
+          }
+          function onMove(ev) {
+            var w = wrap.getBoundingClientRect().width || 344, h = wrap.getBoundingClientRect().height || 220;
+            var p = clamp(ev.clientX - offX, ev.clientY - offY, w, h);
+            wrap.style.left = p.x + "px"; wrap.style.top = p.y + "px"; wrap.style.right = "auto";
+            try { localStorage.setItem(POS_KEY, p.x + "," + p.y); } catch (e2) {}
+          }
+          function onUp() {
+            window.removeEventListener("pointermove", onMove);
+            window.removeEventListener("pointerup", onUp);
+            window.removeEventListener("pointercancel", onUp);
+          }
+          window.addEventListener("pointermove", onMove);
+          window.addEventListener("pointerup", onUp);
+          window.addEventListener("pointercancel", onUp);
+        });
+
+        /* 点击外部收起（捕获段，按下即收） */
+        document.addEventListener("pointerdown", function (e) {
+          var w = document.getElementById(PANEL_ID);
+          if (w !== host) { return; }
+          var cur = host.shadowRoot.querySelector(".wrap");
+          if (!cur || cur.hidden) { return; }
+          if (host.contains(e.target)) { return; }
+          cur.hidden = true;
+        }, true);
+        document.addEventListener("keydown", function (e) {
+          if (e.key !== "Escape") { return; }
+          var cur = host.shadowRoot.querySelector(".wrap");
+          if (cur) { cur.hidden = true; }
+        });
+
+        /* 行内点击委托：有新版本 → 入队；更新中/等待 → 取消；失败 → 重试 */
+        wrap.addEventListener("click", function (e) {
+          var t = e.target;
+          if (!t || !t.classList) { return; }
+          if (t.classList.contains("x")) { wrap.hidden = true; return; }
+          if (t.classList.contains("recheck")) { if (!checking) { checkNow(); } return; }
+          if (t.classList.contains("reverify")) { if (!checking) { checkNow(); } return; }
+          if (t.classList.contains("allbtn")) {
+            rows.forEach(function (r) { if (r.state === "update" && queue.indexOf(r.name) < 0 && r.name !== busyName) { enqueue(r.name); } });
+            return;
+          }
+          if (t.classList.contains("act")) {
+            var nm = t.getAttribute("data-n");
+            if (nm) { enqueue(nm); }
+            return;
+          }
+          if (t.classList.contains("cancel")) { requestCancel(); return; }
+          if (t.classList.contains("retry")) {
+            var nm2 = t.getAttribute("data-n");
+            checkOne(nm2);
+          }
+        });
+
+        /* 状态 → 行渲染订阅 */
+        listeners.push(function () { paint(); });
+        return wrap;
+      }
+
+      function checkOne(name) {
+        for (var i = 0; i < rows.length; i++) {
+          if (rows[i].name === name) {
+            rows[i].state = "checking"; rows[i].why = "";
+            emit();
+            fetchLatest(name).then(function (v) {
+              var r = null;
+              for (var j = 0; j < rows.length; j++) { if (rows[j].name === name) { r = rows[j]; break; } }
+              if (!r) { return; }
+              r.latest = v || "";
+              r.state = v && cmpSemver(v, r.version) > 0 ? "update" : "current";
+              emit();
+            }).catch(function (e) {
+              setRow(name, e && e.notFound ? { state: "local", why: String(e.message) } : { state: "error", why: String(e && e.message || e) });
+            });
+            return;
+          }
+        }
+      }
+
+      var TAG_TEXT = {
+        checking: "比对中 …", current: "已是最新", update: "有新版本",
+        local: "本地链接", unknown: "未比对", error: "检查失败", queuing: "等待更新",
+        busy: "更新中 …", unchanged: "暂缓更新", unconfirmed: "已发起·未确认"
+      };
+      function tagHtml(r) {
+        var cls = "tag other", act = "", title = "";
+        if (r.state === "update") { cls = "tag update act"; act = " data-n=\"" + esc(r.name) + "\""; title = " title=\"点击更新到最新版\""; }
+        else if (r.state === "current") { cls = "tag current"; }
+        else if (r.state === "error") { cls = "tag error retry"; act = " data-n=\"" + esc(r.name) + "\""; title = " title=\"" + esc(r.why || "检查失败") + "（点击重查）\""; }
+        else if (r.state === "local") { title = " title=\"" + esc(r.src || r.why || "本地直装") + "；没有可比的 registry 版本\""; }
+        else if (r.state === "queuing" || r.state === "busy") { cls = "tag other cancel"; title = " title=\"点击取消" + (r.state === "busy" ? "本次更新" : "排队") + "\""; }
+        else if (r.state === "unchanged") { cls = "tag update act"; act = " data-n=\"" + esc(r.name) + "\""; title = " title=\"" + esc(r.why || "") + "（点击重试）\""; }
+        else if (r.state === "unconfirmed") { cls = "tag other reverify"; title = " title=\"" + esc(r.why || "") + "（点击重查）\""; }
+        return "<span class=\"" + cls + "\"" + act + title + ">" + esc(TAG_TEXT[r.state] || "未比对") + "</span>";
+      }
+      function paint() {
+        var wrap = panelWrap();
+        var upd = 0;
+        rows.forEach(function (r) { if (r.state === "update") { upd++; } });
+        var allBtn = upd ? "<span class=\"allbtn\">全部更新（" + upd + "）</span>" : "<span class=\"allbtn\" hidden></span>";
+        var body;
+        if (!rows.length) {
+          body = "<div class=\"msg\">" + (checking ? "正在读取插件清单…" : "点上方「重新检查」开始比对") + "</div>";
+        } else {
+          body = rows.map(function (r) {
+            var ver = r.latest && (r.state === "update" || r.state === "unchanged") ? r.version + " → " + r.latest : r.version;
+            return "<div class=\"row\">" +
+              "<span class=\"nm\" title=\"" + esc(r.name) + "\">" + esc(r.name) + "</span>" +
+              "<span class=\"ver\" title=\"" + esc(ver) + "\">" + esc(ver) + "</span>" +
+              tagHtml(r) + "</div>";
+          }).join("");
+        }
+        var html = "<div class=\"hd\"><b>插件更新 · " + (busyName ? "正在更新 " + esc(busyName) + " …" : (checking ? "检查中…" : (rows.length ? upd + " 个插件有新版本" : "插件更新检查"))) + "</b>" +
+          "<span class=\"recheck\" title=\"重新读取插件清单并比对 registry\">重新检查</span>" + allBtn +
+          "<span class=\"x\" title=\"关闭\">×</span></div><div class=\"rows\">" + body + "</div>";
+        if (wrap.innerHTML !== html) {
+          var keep = wrap.querySelector(".rows");
+          var st = keep ? keep.scrollTop : 0;
+          wrap.innerHTML = html;
+          var nk = wrap.querySelector(".rows");
+          if (nk && st) { nk.scrollTop = st; }
+        }
+        wrap.hidden = false;
+      }
+
+      /* ---- 入口按钮：挂会话头部 utilities 槽（0.2.0-rc.1 实测容器带
+         data-slot 属性；React 重渲染会抹掉手插节点，MutationObserver 补挂）---- */
+      function mountButton(openPanel) {
+        function mount() {
+          var slot = document.querySelector('[data-slot="conversation.session.header.utilities"]');
+          if (!slot || !slot.parentElement) { return false; }
+          if (document.getElementById(BTN_ID)) { return true; }
+          var host = document.createElement("span");
+          host.id = BTN_ID;
+          var root = host.attachShadow({ mode: "open" });
+          root.innerHTML = "<style>" +
+            "button{font:inherit;font-size:13px;height:26px;padding:0 10px;border-radius:6px;" +
+            "border:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.4));background:transparent;" +
+            "color:var(--dsw-alias-label-primary,inherit);cursor:pointer;white-space:nowrap;" +
+            "transition:background-color .13s,border-color .13s}" +
+            "button:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(128,128,128,.12))}" +
+            "</style><button type=\"button\" title=\"比对全部已装插件与 npm registry 的版本（不含 dsh 本体）\">插件更新</button>";
+          root.querySelector("button").addEventListener("click", openPanel);
+          slot.parentElement.insertBefore(host, slot);
+          return true;
+        }
+        mount();
+        try {
+          var mo = new MutationObserver(function () {
+            if (!document.getElementById(BTN_ID)) { mount(); }
+          });
+          mo.observe(document.documentElement, { childList: true, subtree: true });
+        } catch (e) {}
+        setInterval(function () { if (!document.getElementById(BTN_ID)) { mount(); } }, 2000);
+      }
+
+      mountButton(function () { paint(); if (!rows.length && !checking) { checkNow(); } });
+    }
+
+    /* ======================================================================
+     * 模块 4：动画修复（把 prefers-reduced-motion 强制成 no-preference）
+     *
+     * 背景：Windows「动画效果」关闭时 Chromium 对外报告 prefers-reduced-motion:
+     * reduce，dsh 前端 17 个包共 40 处 @media (prefers-reduced-motion: reduce)
+     * 规则把动画全关（圈圈不转、流光消失）。dsh-web-shell 用 CDP
+     * Emulation.setEmulatedMedia 修复，但桌面端默认没有调试端口，CDP 进不去。
+     *
+     * 页面内等价修法（无需调试端口，web/桌面通用）：
+     *  1) CSSOM 清除 —— 实测 dsh 的 CSS 全部经 <style> 标签注入（0 处
+     *     adoptedStyleSheets），同源样式表能从 document.styleSheets 遍历
+     *     cssRules；把 reduce 的 media 块整条删除后，基础动画声明（都在
+     *     非 media 规则里）立即生效 —— 效果与 CDP 覆盖等价。
+     *  2) matchMedia 包装 —— chat 包有 3 处 JS 门控（滚动平滑/跳转）读
+     *     matchMedia；包一层按 no-preference 应答，顺带覆盖未来新增门控。
+     *  CSS 分包是懒加载的，新 <style> 注入由 MutationObserver + 轮询兜底重扫；
+     *  换肤等对既有 style 节点的重写也靠轮询兜回来。
+     * ==================================================================== */
+    function installAnimationFix() {
+      if (window.__DSHUIW_ANIM__) { return; }
+      window.__DSHUIW_ANIM__ = true;
+      var REDUCE_RE = /prefers-reduced-motion\s*:\s*reduce/i;
+      var purged = 0;
+
+      /* 递归删 reduce media 块；owner 是持有 deleteRule 的一层（sheet 或外层规则） */
+      function purge(ruleList, owner) {
+        for (var i = ruleList.length - 1; i >= 0; i--) {
+          var r = null;
+          try { r = ruleList[i]; } catch (e) { continue; }
+          if (!r) { continue; }
+          if (r.media && REDUCE_RE.test(r.media.mediaText || "")) {
+            try { owner.deleteRule(i); purged++; } catch (e) {}
+            continue;
+          }
+          try { if (r.cssRules && r.cssRules.length) { purge(r.cssRules, r); } } catch (e) {}
+        }
+      }
+      function scanAll() {
+        var sheets = [];
+        try { sheets = Array.prototype.slice.call(document.styleSheets); } catch (e) {}
+        try { if (document.adoptedStyleSheets) { sheets = sheets.concat(Array.prototype.slice.call(document.adoptedStyleSheets)); } } catch (e) {}
+        for (var i = 0; i < sheets.length; i++) {
+          try {
+            var sh = sheets[i];
+            if (sh && sh.cssRules && sh.cssRules.length) { purge(sh.cssRules, sh); }
+          } catch (e) {}   // 跨域 <link> 读 cssRules 会抛，静默跳过
+        }
+        return purged;
+      }
+
+      var first = scanAll();
+      try { console.info("[dsh-ui-tweaks:" + BUILD + "] 动画修复：已清除 " + first + " 条 prefers-reduced-motion: reduce 规则"); } catch (e) {}
+
+      /* 懒加载分包/换肤重写样式 → 防抖重扫；2s 轮询兜底（纯内存枚举，开销可忽略） */
+      var timer = 0;
+      function schedule() {
+        if (timer) { return; }
+        timer = setTimeout(function () { timer = 0; scanAll(); }, 200);
+      }
+      try {
+        var mo = new MutationObserver(schedule);
+        mo.observe(document.head, { childList: true, subtree: true });
+      } catch (e) {}
+      setInterval(scanAll, 2000);
+
+      /* matchMedia 包装：一律按 no-preference 应答（覆盖 JS 门控）。
+         注意要在应用渲染前生效 —— 本插件 apply 在合成期执行，早于挂载。 */
+      try {
+        var nativeMM = window.matchMedia ? window.matchMedia.bind(window) : null;
+        if (nativeMM) {
+          window.matchMedia = function (q) {
+            var mql = nativeMM(q);
+            try {
+              var qs = String(q || "");
+              if (/prefers-reduced-motion/i.test(qs)) {
+                var fake = !/:\s*reduce/i.test(qs);   // reduce→false；no-preference/裸→true
+                Object.defineProperty(mql, "matches", { value: fake, configurable: true });
+              }
+            } catch (e) {}
+            return mql;
+          };
+        }
+      } catch (e) {}
+    }
+
+    function apply(ctx) {
+      try { window.__DSHUIW_BUILD__ = BUILD; } catch (e) {}
+      guard("tablefix", installTableWidthFix);
+      guard("scrollbar", installLeftScrollbar);
+      guard("updates", function () { installPluginUpdates(ctx); });
+      guard("anim", installAnimationFix);
+    }
+
+    module.exports = { name: "ui-tweaks", apply: apply, inject: ["remote", "remote.pluginManager", "remote.pluginInventory"] };
+    return module.exports;
+  }
+});

package/lib/index.js

@@ -0,0 +1,92 @@
+/**
+ * dsh-ui-tweaks host half.
+ *
+ * 挂一条 GET /api/ui-tweaks/local-plugins：返回当前 profile package.json
+ * dependencies 里声明为本地路径（link:/file:/git+/http）的包名清单。
+ * 浏览器半区的更新面板据此把这些插件标成「本地链接」、跳过 registry 比对
+ * —— listBundles 不透传安装来源，而「npm 上恰好也发布过」的本地包（如
+ * @nimoxie/dsh-model-organizer）在客户端侧没有任何别的办法认出来。
+ *
+ * 纯读操作：只读 profile 的 package.json，不改任何东西；仅回环访问放行。
+ */
+import { readdirSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+export const name = "ui-tweaks";
+export const inject = ["webServer"];
+
+const SELF = "@nimoxie/dsh-ui-tweaks";
+const LOCAL_SPEC_RE = /^(link:|file:|git[+:@]|github:|http)/;
+const LOOPBACK_RE = /^(127\.|::1$|::ffff:127\.)/;
+
+function readJson(p) {
+  try { return JSON.parse(readFileSync(p, "utf8")); } catch { return null; }
+}
+
+function hasUs(m) {
+  return !!(m && m.dsh && m.dsh.profile && Array.isArray(m.dsh.profile.bundles) && m.dsh.profile.bundles.includes(SELF));
+}
+
+function findProfileDir() {
+  // ① npm 直装：包物理位于 profile/node_modules 内，向上走必经 profile 根
+  //   （profile 根 package.json 的判据是 dsh.profile.bundles 且包含本插件）。
+  let dir = dirname(dirname(fileURLToPath(import.meta.url)));
+  for (let depth = 0; depth < 8; depth++) {
+    const m = readJson(join(dir, "package.json"));
+    if (hasUs(m)) { return dir; }
+    const parent = dirname(dir);
+    if (parent === dir) { break; }
+    dir = parent;
+  }
+  // ② link: 软链安装：Node 默认把 ESM 模块解析到真实路径，import.meta.url
+  //    指向 profile 外的仓库目录，①必然失败。退回扫描 profiles/*：
+  //    DSH_HOME 环境变量 → 用户主目录默认 .dsh（dsh 未设环境变量时的标准位置）。
+  //    多个 profile 都装了本插件时按 host 进程形态二选一
+  //    （桌面 host 跑在 ELECTRON_RUN_AS_NODE=1 的 Electron Node 下）。
+  const homes = [process.env.DSH_HOME, join(homedir(), ".dsh")].filter(Boolean);
+  let hits = [];
+  for (const home of homes) {
+    try {
+      for (const entry of readdirSync(join(home, "profiles"))) {
+        const dir2 = join(home, "profiles", entry);
+        if (hasUs(readJson(join(dir2, "package.json")))) { hits.push(dir2); }
+      }
+    } catch { /* 该 home 不存在或不可读，试下一个 */ }
+    if (hits.length) { break; }
+  }
+  if (hits.length === 0) { return null; }
+  if (hits.length === 1) { return hits[0]; }
+  const wanted = process.env.ELECTRON_RUN_AS_NODE === "1" ? "desktop" : "web";
+  return hits.find((d) => new RegExp(wanted + "$").test(d)) || hits[0];
+}
+
+export function apply(ctx) {
+  const route = {
+    kind: "exact",
+    path: "/api/ui-tweaks/local-plugins",
+    handler: (req, res) => {
+      const done = (code, body) => {
+        res.writeHead(code, { "content-type": "application/json; charset=utf-8", "cache-control": "no-store" });
+        res.end(body);
+      };
+      try {
+        const addr = String((req.socket && req.socket.remoteAddress) || "");
+        if (!LOOPBACK_RE.test(addr)) { done(403, JSON.stringify({ ok: false, code: "forbidden" })); return; }
+        if (req.method !== "GET") { done(405, JSON.stringify({ ok: false, code: "method not allowed" })); return; }
+        const dir = findProfileDir();
+        const manifest = dir ? readJson(join(dir, "package.json")) : null;
+        const deps = (manifest && manifest.dependencies) || {};
+        const local = Object.keys(deps).filter((n) => LOCAL_SPEC_RE.test(String(deps[n])));
+        done(200, JSON.stringify({ ok: true, local, profile: (manifest && manifest.name) || "" }));
+      } catch (e) {
+        done(500, JSON.stringify({ ok: false, code: String((e && e.message) || e) }));
+      }
+    }
+  };
+  ctx.effect(() => {
+    const dispose = ctx.webServer.register(route);
+    return () => { try { dispose(); } catch {} };
+  }, "ui-tweaks: local-plugins route");
+}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@nimoxie/dsh-ui-tweaks",
+  "version": "0.1.0",
+  "description": "dsh Web UI 微调合集：宽表格越界修复、对话区左侧自绘滚动条、插件更新检查面板（不含 dsh 本体）",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "DEVELOPING.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "ui",
+    "scrollbar",
+    "table",
+    "plugin-updates",
+    "reduced-motion"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "NimoXie",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NimoXie15/dsh-ui-tweaks.git"
+  },
+  "homepage": "https://github.com/NimoXie15/dsh-ui-tweaks#readme",
+  "bugs": {
+    "url": "https://github.com/NimoXie15/dsh-ui-tweaks/issues"
+  },
+  "dsh": {
+    "engines": {
+      "dsh": ">=0.2.0-rc.1"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-api-remotes"
+      ]
+    }
+  }
+}