@nimoxie/dsh-ui-tweaks 0.1.7 → 0.2.0

package/lib/client.js

@@ -14,7 +14,7 @@ window.__ModuleLoader__.load({
     const module = { exports: {} };
     const exports = module.exports;
 
-    const BUILD = "0.1.7";
+    const BUILD = "0.2.0";
 
     /* 每个模块的注册各套一层 guard：失败只记 warn（座位/模块失败模式是「静默消失」，
        必须主动吭声；但不能让一个模块的异常打断同文件里其它模块的 apply）。 */
@@ -390,6 +390,19 @@ window.__ModuleLoader__.load({
       var BTN_ID = "dshuiw-updates-btn-host";
       var RBTN_ID = "dshuiw-restart-btn-host";
       var PANEL_ID = "dshuiw-updates-panel-host";
+      /* 用户是否主动收起了面板。paint() 只负责重画，**不负责把面板弹出来** ——
+         否则后台一有动静（装完一个包、冷静期到点自动重查、超时兜底）就会把用户
+         刚收起来的面板又弹回来。显示只由「打开」路径决定，隐藏只由「收起」路径决定。 */
+      var panelClosed = false;
+      /* 弹窗里的控件都是自绘 span（渲染结构与 CSS 都不动），键盘得自己接：
+         可点的补 role=button/tabindex=0（KBD），Enter/Space 派发一次 click，
+         走同一套点击委托，行为与鼠标完全一致。 */
+      var KBD = ' role="button" tabindex="0"';
+      /* 焦点环用官方自己的令牌（app 里有 237 条 :focus-visible，主题变量就是
+         --dsw-focus-ring-*），与原生控件的焦点样式同色同宽，不自造灰色。
+         三处使用点：两个 shadow 样式 + 页面级那两枚按钮。 */
+      var FOCUS_RING = "outline:var(--dsw-focus-ring-width,2px) solid " +
+        "var(--dsw-focus-ring-color,var(--dsw-alias-state-business-primary,rgba(120,170,255,.9)));outline-offset:2px";
 
       /* ---- semver 比较（rc 比数字/字母、正式版 > 预发布版；字符串比会把
          rc.9 判成大于 rc.10，必须自己实现）---- */
@@ -738,6 +751,7 @@ window.__ModuleLoader__.load({
          **先问会话有没有在跑** —— 没有在跑的会话就直接执行，不打扰人；有才弹中断提示。
          宿主形态决定重启怎么做（shell / relaunch / manual），文案按形态给。 */
       var RST_PANEL_ID = 'dshuiw-restart-panel-host';
+      var scrimShown = false; // 蒙皮是否正盖在页面上（键盘滚动锁的开关）
       var rstStage = '';     // '' | checking | auto | confirm | busy | done | error
       var rstMode = '';      // relaunch | shell | manual
       var rstNote = '';
@@ -826,6 +840,7 @@ window.__ModuleLoader__.load({
           '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}' +
           '.rwrap[hidden]{display:none}' +
+          '[role="button"]:focus-visible{' + FOCUS_RING + '}' +
           '.rt{font-weight:600;margin-bottom:6px}' +
           '.rb{font-size:12px;line-height:1.5;opacity:.85;white-space:pre-wrap;word-break:break-word}' +
           '.rl{margin:6px 0 0 10px;font-size:12px;opacity:.9}' +
@@ -840,7 +855,7 @@ window.__ModuleLoader__.load({
           '.rscrim{position:fixed;top:0;left:0;right:0;bottom:0;z-index:2147483000;cursor:progress;' +
           'background:rgba(8,10,14,.5);backdrop-filter:blur(1.5px);-webkit-backdrop-filter:blur(1.5px)}' +
           '.rscrim[hidden]{display:none}' +
-          '</style><div class="rscrim" hidden></div><div class="rwrap" hidden></div>';
+          '</style><div class="rscrim" hidden></div><div class="rwrap" role="dialog" aria-modal="true" aria-label="重启 dsh" hidden></div>';
         var scrim = sr.querySelector('.rscrim');
         try {
           scrim.addEventListener('wheel', function (e) { e.preventDefault(); }, { passive: false });
@@ -852,7 +867,7 @@ window.__ModuleLoader__.load({
           if (!t || !t.classList) { return; }
           if (t.classList.contains('rgo')) { restartGo(); return; }
           if (t.classList.contains('rretry')) { restartOpen(); return; }
-          if (t.classList.contains('rcancel') || t.classList.contains('rdismiss')) { restartClose(); return; }
+          if (t.classList.contains('rcancel') || t.classList.contains('rdismiss')) { restartClose(true); return; }
         });
         /* 点外部/Esc 收起；点自己那枚按钮不算外部（交给按钮做开关） */
         document.addEventListener('pointerdown', function (e) {
@@ -865,18 +880,46 @@ window.__ModuleLoader__.load({
         document.addEventListener('keydown', function (e) {
           if (e.key !== 'Escape' || rstStage === 'busy') { return; }
           var cur = host.shadowRoot.querySelector('.rwrap');
-          if (cur && !cur.hidden) { restartClose(); }
+          if (cur && !cur.hidden) { restartClose(true); }
         });
+        /* 蒙皮期间页面已 inert，但键盘仍可能滚动后面的文档（PageDown/空格/方向键）：
+           在捕获段拦掉纯滚动键。焦点在弹窗里时 e.target 会被重定向成宿主，那时不拦 ——
+           弹窗该能自己滚，按钮也该能用空格触发。 */
+        document.addEventListener('keydown', function (e) {
+          if (!scrimShown) { return; }
+          var hostEl = document.getElementById(RST_PANEL_ID);
+          if (hostEl && (e.target === hostEl || hostEl.contains(e.target))) { return; }
+          var k = e.key;
+          if (k === 'PageDown' || k === 'PageUp' || k === 'ArrowDown' || k === 'ArrowUp' ||
+              k === 'Home' || k === 'End' || k === ' ' || k === 'Spacebar') {
+            e.preventDefault();
+          }
+        }, true);
+        wireKeyActivation(wrap);
         return wrap;
       }
 
       /* ---- 蒙皮：确认重启后把整页蒙住（客户端此时已不可用，界面元素不该还能点）---- */
+      /* 蒙皮只挡指针。键盘仍能 Tab 到后面的元素并回车激活，所以同时把 body 的其它
+         子树整块 inert 掉（Chromium 102+ 支持；弹窗自己的宿主除外）。关掉时如实还原。 */
+      function setPageInert(on) {
+        try {
+          var kids = document.body.children;
+          for (var i = 0; i < kids.length; i++) {
+            var el = kids[i];
+            if (!el || el.id === RST_PANEL_ID) { continue; }
+            if (on) { el.setAttribute("inert", ""); } else { el.removeAttribute("inert"); }
+          }
+        } catch (e) {}
+      }
       function showScrim(on) {
         try {
           rstWrap();   // 确保阴影根在（隐藏的弹窗也没关系）
           var host = document.getElementById(RST_PANEL_ID);
           var s = host && host.shadowRoot ? host.shadowRoot.querySelector('.rscrim') : null;
           if (s) { s.hidden = !on; }
+          scrimShown = !!on;
+          setPageInert(on);
         } catch (e) {}
       }
       var rstKillTimer = 0;
@@ -899,7 +942,7 @@ window.__ModuleLoader__.load({
 
       function rstRender() {
         var wrap = rstWrap();
-        function btn(cls, label) { return '<span class="rbtn ' + cls + '">' + label + '</span>'; }
+        function btn(cls, label) { return '<span class="rbtn ' + cls + '"' + KBD + '>' + label + '</span>'; }
         var title = '重启 dsh';
         var body = '';
         var actions = '';
@@ -939,14 +982,25 @@ window.__ModuleLoader__.load({
         if (wrap.innerHTML !== html) { wrap.innerHTML = html; }
         wrap.hidden = false;
         placeNear(rstBtn, wrap, RST_WIDTH, 180);
+        /* 键盘：确认/失败/收尾态把焦点交给主按钮；弹窗里已经有焦点就不抢 */
+        if (rstStage === 'confirm' || rstStage === 'error' || rstStage === 'done') {
+          try {
+            var hostEl = document.getElementById(RST_PANEL_ID);
+            var inside = hostEl && hostEl.shadowRoot ? hostEl.shadowRoot.activeElement : null;
+            var primary = wrap.querySelector('.rgo, .rretry, .rdismiss, .rcancel');
+            if (primary && !inside) { primary.focus(); }
+          } catch (e) {}
+        }
       }
 
-      function restartClose() {
+      function restartClose(refocus) {
         showScrim(false);
         clearKillTimer();
         var wrap = rstWrap();
         wrap.hidden = true;
         rstStage = ''; rstNote = ''; rstActive = null; rstNames = [];
+        /* 键盘：收起后把焦点还给「立即重启」。点外部收起的传 false */
+        if (refocus) { try { if (rstBtn && document.contains(rstBtn)) { rstBtn.focus(); } } catch (e) {} }
       }
 
       /* 打开：并行读「重启方案」与「在跑的会话」，两者都回来再决定 */
@@ -1049,7 +1103,7 @@ window.__ModuleLoader__.load({
         var stage = forceStage[name] || "";
         var ver = r.latest || r.version;
         function btn(cls, label) {
-          return "<span class=\"fbtn " + cls + "\" data-n=\"" + esc(name) + "\">" + label + "</span>";
+          return "<span class=\"fbtn " + cls + "\" data-n=\"" + esc(name) + "\"" + KBD + ">" + label + "</span>";
         }
         if (stage === "checking") { return "<div class=\"force\"><div class=\"fn\">正在预检…</div></div>"; }
         if (stage === "writing") { return "<div class=\"force\"><div class=\"fn\">正在写入豁免表…</div></div>"; }
@@ -1589,7 +1643,26 @@ window.__ModuleLoader__.load({
          来源：触发它的那枚按钮。按钮被页面布局推走（滚动、窗口尺寸变化、插件页重排）
          时弹窗跟着走，不会有"拖到哪就钉在哪、之后再也不跟"的状态。 */
       var PANEL_GAP = 6, PANEL_MARGIN = 8;
+      /* 兜底宽度：只在弹窗还没渲染、量不到布局时用 */
       var PANEL_WIDTH = 344, RST_WIDTH = 330;
+      /* 量真实外框。调用方传的 width 只是 CSS 里的**内容宽**，而两个弹窗的盒模型并不一样：
+         Shadow DOM 里拿不到官方全局的 box-sizing 复位，.rwrap 是 content-box 且带 12px
+         padding → 实宽比常量多 26px，右缘会比按钮多探出 26px（.wrap 没有 padding，
+         只多 2px 边框，所以看着是对齐的）。竖直方向同理：maxHeight 约束的是内容盒，
+         不扣掉 padding+border，弹窗就会比算出来的空间高出 26px。两边都用实测值。 */
+      function measuredBox(wrap, fallbackWidth) {
+        /* 宽度用 getBoundingClientRect：和锚点矩形同一个坐标系，页面若带缩放也不会串 */
+        var width = 0;
+        try { width = wrap.getBoundingClientRect().width; } catch (e) {}
+        if (!width) { width = wrap.offsetWidth || fallbackWidth; }
+        var extraY = 0;
+        try {
+          var cs = window.getComputedStyle(wrap);
+          var n = function (v) { var f = parseFloat(v); return isFinite(f) ? f : 0; };
+          extraY = n(cs.paddingTop) + n(cs.paddingBottom) + n(cs.borderTopWidth) + n(cs.borderBottomWidth);
+        } catch (e) {}
+        return { width: width, extraY: extraY };
+      }
       function placeNear(anchor, wrap, width, minHeight) {
         try {
           if (!wrap || wrap.hidden) { return; }
@@ -1597,14 +1670,20 @@ window.__ModuleLoader__.load({
           var r = null;
           if (anchor && anchor.getBoundingClientRect) { r = anchor.getBoundingClientRect(); }
           if (!r || (!r.width && !r.height)) { r = { right: vw - 16, top: 56, bottom: 56 }; }   // 按钮还没挂上：退回右上角
-          var left = Math.max(PANEL_MARGIN, Math.min(vw - width - PANEL_MARGIN, r.right - width));
-          var height = wrap.offsetHeight || minHeight || 200;
+          var box = measuredBox(wrap, width);
+          var outer = box.width;
+          var left = Math.max(PANEL_MARGIN, Math.min(vw - outer - PANEL_MARGIN, r.right - outer));
+          /* scrollHeight 是未被 maxHeight 夹过的自然高度：反复重排时判据不会漂 */
+          var height = wrap.scrollHeight || wrap.offsetHeight || minHeight || 200;
           var below = vh - r.bottom - PANEL_GAP - PANEL_MARGIN;
           var above = r.top - PANEL_GAP - PANEL_MARGIN;
           /* 优先放下方；下方放不下（或不如上方宽裕）就翻到上方 */
           var useBelow = below >= Math.min(height, minHeight || 200) || below >= above;
-          var room = Math.max(120, useBelow ? below : above);
-          wrap.style.maxHeight = room + 'px';
+          /* 不再把 room 强行抬到 120：按钮贴着视口上下边时那会突破边距，
+             让弹窗（连同底部的「重启 dsh / 取消」）跑到视口外面去。
+             真正的下限交给下面 maxHeight 的 60。 */
+          var room = useBelow ? below : above;
+          wrap.style.maxHeight = Math.max(60, room - box.extraY) + 'px';
           wrap.style.left = left + 'px';
           wrap.style.right = 'auto';
           wrap.style.top = (useBelow
@@ -1612,6 +1691,24 @@ window.__ModuleLoader__.load({
             : Math.max(PANEL_MARGIN, r.top - PANEL_GAP - Math.min(height, room))) + 'px';
         } catch (e) {}
       }
+      function wireKeyActivation(wrap) {
+        wrap.addEventListener("keydown", function (e) {
+          if (e.key !== "Enter" && e.key !== " " && e.key !== "Spacebar") { return; }
+          var t = e.target;
+          if (!t || !t.getAttribute || t.getAttribute("role") !== "button") { return; }
+          e.preventDefault();   // Space 默认会滚动页面
+          try { t.click(); } catch (e2) {}
+        });
+      }
+      /* 收起更新面板：置位 + 隐藏，状态不动（后台的安装/检查继续跑） */
+      function closePanel(refocus) {
+        panelClosed = true;
+        var w = liveWrap(PANEL_ID, ".wrap");
+        if (w) { w.hidden = true; }
+        /* 键盘：收起后把焦点还给触发它的那枚按钮。点外部收起的传 false ——
+           焦点已经跟着用户点的地方去了，不该抢回来。 */
+        if (refocus) { try { var b = document.getElementById(BTN_ID); if (b) { b.focus(); } } catch (e) {} }
+      }
       /* 已经建出来且开着的弹窗；重排时不要顺手把它们创建出来 */
       function liveWrap(hostId, sel) {
         var host = document.getElementById(hostId);
@@ -1635,7 +1732,17 @@ window.__ModuleLoader__.load({
       }
       try {
         window.addEventListener('resize', relayoutPanels);
-        window.addEventListener('scroll', relayoutPanels, true);
+        /* 面板自己内部滚动（.rows）不影响按钮位置，不必重排；用 composedPath 认出来 */
+        window.addEventListener('scroll', function (e) {
+          if (e && typeof e.composedPath === 'function') {
+            var path = e.composedPath();
+            for (var i = 0; i < path.length; i++) {
+              var n = path[i];
+              if (n && n.id && (n.id === PANEL_ID || n.id === RST_PANEL_ID)) { return; }
+            }
+          }
+          relayoutPanels();
+        }, true);
       } catch (e) {}
 
       /* ---- 面板 UI：挂在 body 的 Shadow DOM（fixed 浮层不能放进 flex 工具栏）---- */
@@ -1655,6 +1762,7 @@ window.__ModuleLoader__.load({
           "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}" +
+          "[role=\"button\"]:focus-visible{" + FOCUS_RING + "}" +
           ".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));" +
           "user-select:none;-webkit-user-select:none}" +
@@ -1712,7 +1820,7 @@ window.__ModuleLoader__.load({
           "border-bottom:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.18))}" +
           ".foot{padding:8px 12px;font-size:11px;line-height:1.5;opacity:.6;" +
           "border-top:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.12))}" +
-          "</style><div class=\"wrap\" hidden></div>";
+          "</style><div class=\"wrap\" role=\"dialog\" aria-label=\"插件更新\" tabindex=\"-1\" hidden></div>";
         var wrap = sr.querySelector(".wrap");
 
         /* 不可拖动：位置完全由 placeNear() 决定（见文件上方的「弹窗定位」）。
@@ -1726,19 +1834,21 @@ window.__ModuleLoader__.load({
           var cur = host.shadowRoot.querySelector(".wrap");
           if (!cur || cur.hidden) { return; }
           if (host.contains(e.target)) { return; }
-          cur.hidden = true;
+          var chkBtn = document.getElementById(BTN_ID);
+          if (chkBtn && (chkBtn === e.target || chkBtn.contains(e.target))) { return; }
+          closePanel();
         }, true);
         document.addEventListener("keydown", function (e) {
           if (e.key !== "Escape") { return; }
           var cur = host.shadowRoot.querySelector(".wrap");
-          if (cur) { cur.hidden = true; }
+          if (cur && !cur.hidden) { closePanel(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("x")) { closePanel(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")) {
@@ -1783,6 +1893,8 @@ window.__ModuleLoader__.load({
           }
         });
 
+        wireKeyActivation(wrap);
+
         /* 状态 → 行渲染订阅 */
         listeners.push(function () { paint(); });
         return wrap;
@@ -1835,12 +1947,19 @@ window.__ModuleLoader__.load({
         else if (r.state === "fail") { cls = "tag error act clickable"; act = " data-n=\"" + esc(r.name) + "\""; title = " title=\"" + esc(r.why || "更新失败") + "（点击重试）\""; }
         else if (r.state === "unchanged") { cls = "tag update act clickable"; act = " data-n=\"" + esc(r.name) + "\""; title = " title=\"" + esc(r.why || "") + "（点击重试）\""; }
         else if (r.state === "unconfirmed") { cls = "tag other reverify clickable"; title = " title=\"" + esc(r.why || "") + "（点击重查）\""; }
-        return "<span class=\"" + cls + "\"" + act + title + ">" + esc(TAG_TEXT[r.state] || "未比对") + "</span>";
-      }
-      /* ---- 「Auto review」访问模式提示（只提示，不改任何设置）--------------------
-         DSH 0.2.0-rc.2 的已知缺陷：访问模式为 auto 的会话会让 permissionPresets 服务在
-         热重载（装/更新插件就会触发）时构造失败 —— 表现是装插件报一长串错、助手侧也随之
-         一连串报错，且要重启客户端才恢复。这里只读当前是否有这种会话，用来提醒用户先切走。
+        return "<span class=\"" + cls + "\"" + act + title + (cls.indexOf("clickable") >= 0 ? KBD : "") + ">" + esc(TAG_TEXT[r.state] || "未比对") + "</span>";
+      }
+      /* ---- 「自动审查」访问模式提示（只提示，不改任何设置）--------------------
+         两件事都跟这个模式有关，所以合成一条提醒：
+         ① DSH 0.2.0-rc.2 的已知缺陷：访问模式为 auto 的会话会让 permissionPresets 服务在
+            热重载（装/更新插件就会触发）时构造失败 —— 表现是装插件报一长串错、助手侧也随之
+            一连串报错，且要重启客户端才恢复。
+         ② 该模式对每次工具调用还有一道「调用前审查」，审查服务不可用或限流时这次调用会被
+            直接拒绝、工具体不执行（文案形如 Auto review of tool "…" failed）。
+         0.2.1-rc.2 复核（2026-10-18）：预设标识仍是 AUTO_PRESET = "auto"（界面改叫
+         「自动审查」，判定串 currentValue === "auto" 不受影响）；旧缺陷的 throw 仍在，
+         但 auto-review 集成新增了卸载时的会话迁移（先把 auto 会话改成 danger-full-access
+         再退出），触发窗口已收窄。这里只读当前是否有这种会话，用来提醒用户先切走。
          读法同官方权限面板：sessions 列表 → binding(id).session → permissions 投影。
          拿不到服务/投影（老版本 dsh、会话未驻留）就返回 false，宁可不提示也不误报。 */
       function hasAutoReviewSession() {
@@ -1865,7 +1984,7 @@ window.__ModuleLoader__.load({
       }
       function accessModeBar() {
         if (!hasAutoReviewSession()) { return ""; }
-        return "<div class=\"warn\">⚠ 有会话正在用「Auto review」访问模式：这个模式下装/更新插件有时会失败，并且助手这边会开始一连串报错，要重启客户端才能恢复。建议先把该会话切换成「工作区内修改」，装完再切回「Auto review」。</div>";
+        return "<div class=\"warn\">⚠ 有会话正在用「自动审查」（Auto review）访问模式：这个模式下装/更新插件有时会失败，助手这边也会跟着一连串报错，要重启客户端才能恢复；该模式下每次工具调用还会先过一遍审查，审查服务不可用或限流时，这次调用会被直接拒绝、不执行。建议先把该会话切换成「工作区内修改」，装完再切回「自动审查」。</div>";
       }
 
       function paint() {
@@ -1879,7 +1998,7 @@ window.__ModuleLoader__.load({
             (isDesktop ? "重启客户端后生效" : "重启 dsh 服务并刷新页面后生效") + "</div>";
         }
         rows.forEach(function (r) { if (r.state === "update") { upd++; } });
-        var allBtn = upd ? "<span class=\"allbtn\">全部更新（" + upd + "）</span>" : "<span class=\"allbtn\" hidden></span>";
+        var allBtn = upd ? "<span class=\"allbtn\"" + KBD + ">全部更新（" + upd + "）</span>" : "<span class=\"allbtn\" hidden></span>";
         var body;
         if (!rows.length) {
           body = "<div class=\"msg\">" + (checking ? "正在读取插件清单…" : "点上方「重新检查」开始比对") + "</div>";
@@ -1903,8 +2022,8 @@ window.__ModuleLoader__.load({
           }).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>" + restartBar() + accessModeBar() + "<div class=\"rows\">" + body + "</div>" +
+          "<span class=\"recheck\"" + KBD + " title=\"重新读取插件清单并比对 registry\">重新检查</span>" + allBtn +
+          "<span class=\"x\"" + KBD + " title=\"关闭\" aria-label=\"关闭\">×</span></div>" + restartBar() + accessModeBar() + "<div class=\"rows\">" + body + "</div>" +
           /* 面板脚注：把「只查第三方」这条口径写在明处（plugin-manager 同款一句） */
           "<div class=\"foot\">只检查第三方插件；官方 @deepseek-ai/ 包随 DSH 本体升级。</div>";
         if (wrap.innerHTML !== html) {
@@ -1914,9 +2033,12 @@ window.__ModuleLoader__.load({
           var nk = wrap.querySelector(".rows");
           if (nk && st) { nk.scrollTop = st; }
         }
-        wrap.hidden = false;
-        /* 位置只有一个来源：那枚「检查更新」按钮（不可拖动） */
-        placeNear(document.getElementById(BTN_ID), wrap, PANEL_WIDTH, 220);
+        /* 收起状态下只更新内容，不把它弹回来 —— 显示由「打开」路径负责 */
+        if (!panelClosed) {
+          wrap.hidden = false;
+          /* 位置只有一个来源：那枚「检查更新」按钮（不可拖动） */
+          placeNear(document.getElementById(BTN_ID), wrap, PANEL_WIDTH, 220);
+        }
       }
 
       /* ---- 列表级按钮：挂官方插件页「已安装」标题那一行的右侧 -----------------
@@ -1940,6 +2062,9 @@ window.__ModuleLoader__.load({
           'color:var(--dsw-alias-label-primary,inherit);background:transparent;white-space:nowrap}' +
           '#' + BOX_ID + ' button:hover:enabled{background:var(--dsw-alias-interactive-bg-hover,rgba(128,128,128,.14))}' +
           '#' + BOX_ID + ' button:disabled{cursor:default;opacity:.55}' +
+          /* 焦点环：这两枚是页面里自绘的 <button>，官方全局样式不会替它们画焦点，
+             键盘用户 Tab 过来时看不见落点（面板内部同样有一条，见两处 shadow 样式） */
+          '#' + BOX_ID + ' button:focus-visible{' + FOCUS_RING + '}' +
           /* 「立即重启」用危险色：它是本插件里唯一会动进程、会打断进行中任务的按钮 */
           '#' + RBTN_ID + '{color:var(--dsw-alias-label-danger,#e07070);box-shadow:inset 0 0 0 1px rgba(255,80,80,.5)}' +
           '#' + RBTN_ID + ':hover:enabled{background:rgba(255,80,80,.12)}';
@@ -1987,7 +2112,7 @@ window.__ModuleLoader__.load({
       }
 
       mountButton(
-        function () { paint(); if (!rows.length && !checking) { checkNow(); } },
+        function () { panelClosed = false; paint(); if (!rows.length && !checking) { checkNow(); } },
         function () { onRestartClick(); }
       );
     }
@@ -2077,12 +2202,305 @@ window.__ModuleLoader__.load({
       } catch (e) {}
     }
 
+    /* ======================================================================
+     * 模块 5：回合尾「本回合改动」补位卡（0.2.0 起）
+     *
+     * 缺陷（0.2.1-rc.2 实测）：官方回合尾卡读的是 workspaceChanges 服务，摘要与
+     * 对比只在内存 + 系统临时目录里活着，Session 一释放就 404，卡片变成一句
+     * 「这轮改动的内容已不可用」。但每次文件工具调用都把前后全文写在工具结果事件的
+     * meta.diffs: [{path, oldText, newText}] 里，**随会话日志永久保存** —— 客户端画
+     * 工具卡 diff 用的就是它（dsh-client-ui-tool 的 appliedDiffs）。所以本模块
+     * **不新增任何持久化**：用 uiConversation 的 Turn Definition 把一回合内这些
+     * meta.diffs 聚合起来，注册到 conversation.chat.turnTail（官方声明的 list 槽位，
+     * 已有 deliverables / plan / schedule 三家），并且**只在官方卡已经失效时才补位**。
+     *
+     * 边界（README 同步）：
+     *   - 只覆盖**文件工具**的改动；pwsh / npm 等造成的改动进不来（只有官方卡含）。
+     *   - 嵌套调用（run_code 里的 edit）走 tool/ptc-dispatch 事件，该事件没有 turn 字段，
+     *     用 rootCallId → turn 的映射（来自 tool/call）挂回回合。
+     *   - 探测结果只缓存在本次连接内（connection/reset 清空）。官方自己永久缓存 missing，
+     *     那会在宿主恢复后留下双份卡。
+     * ====================================================================== */
+    var REACT = null;
+    try { REACT = require("react"); } catch (e) { REACT = null; }
+
+    var CHANGES_KIND = "ui-tweaks-changes";
+    var SUMMARY_ROUTE = "api/changes.summary";   /* 文档相对，勿加前导斜杠（同官方 CHANGED_FILES_ROUTE） */
+    var DIFF_ROW_LIMIT = 400;                    /* 单个文件最多画多少行 diff */
+    var LCS_LINE_LIMIT = 1200;                   /* 超过就退化为「全删 + 全增」，避免 DP 吃内存 */
+    var probeCache = {};                         /* sessionId:seq -> "ok" | "missing" */
+    var rootTurn = {};                           /* rootCallId -> turn（ptc 事件没有 turn） */
+
+    function splitLines(text) {
+      var s = text == null ? "" : String(text);
+      if (s === "") { return []; }
+      if (s.charAt(s.length - 1) === "\n") { s = s.slice(0, -1); }
+      return s.split("\n");
+    }
+    function naiveRows(a, b) {
+      var rows = [], i;
+      for (i = 0; i < a.length; i++) { rows.push({ k: "-", t: a[i] }); }
+      for (i = 0; i < b.length; i++) { rows.push({ k: "+", t: b[i] }); }
+      return rows;
+    }
+    /* 行级 LCS diff；超限或异常一律退化为「全删+全增」，绝不抛。 */
+    function diffRows(oldText, newText) {
+      var a = splitLines(oldText), b = splitLines(newText);
+      if (a.length > LCS_LINE_LIMIT || b.length > LCS_LINE_LIMIT) { return naiveRows(a, b); }
+      var n = a.length, m = b.length, w = m + 1;
+      var dp;
+      try { dp = new Int32Array((n + 1) * w); } catch (e) { return naiveRows(a, b); }
+      for (var i = n - 1; i >= 0; i--) {
+        for (var j = m - 1; j >= 0; j--) {
+          dp[i * w + j] = a[i] === b[j]
+            ? dp[(i + 1) * w + (j + 1)] + 1
+            : Math.max(dp[(i + 1) * w + j], dp[i * w + (j + 1)]);
+        }
+      }
+      var rows = [], x = 0, y = 0;
+      while (x < n && y < m) {
+        if (a[x] === b[y]) { rows.push({ k: " ", t: a[x] }); x++; y++; }
+        else if (dp[(x + 1) * w + y] >= dp[x * w + (y + 1)]) { rows.push({ k: "-", t: a[x] }); x++; }
+        else { rows.push({ k: "+", t: b[y] }); y++; }
+      }
+      while (x < n) { rows.push({ k: "-", t: a[x] }); x++; }
+      while (y < m) { rows.push({ k: "+", t: b[y] }); y++; }
+      return rows;
+    }
+    function countRows(rows) {
+      var added = 0, deleted = 0;
+      for (var i = 0; i < rows.length; i++) {
+        if (rows[i].k === "+") { added++; } else if (rows[i].k === "-") { deleted++; }
+      }
+      return { added: added, deleted: deleted };
+    }
+    /* 同一文件在回合内被改多次时按 old→new 链折成一份净变化；链断返回 null（分段显示）。 */
+    function foldParts(parts) {
+      if (!parts || parts.length === 0) { return null; }
+      var before = parts[0][0] == null ? "" : String(parts[0][0]);
+      var after = parts[0][1] == null ? "" : String(parts[0][1]);
+      for (var i = 1; i < parts.length; i++) {
+        var o = parts[i][0];
+        if (o != null && String(o) !== after) { return null; }
+        if (parts[i][1] != null) { after = String(parts[i][1]); }
+      }
+      return { before: before, after: after };
+    }
+    function countParts(parts) {
+      var added = 0, deleted = 0;
+      for (var i = 0; i < parts.length; i++) {
+        var c = countRows(diffRows(parts[i][0], parts[i][1]));
+        added += c.added; deleted += c.deleted;
+      }
+      return { added: added, deleted: deleted };
+    }
+    function metaDiffs(data) {
+      if (!data || typeof data !== "object") { return null; }
+      var meta = data.meta;
+      if (!meta || typeof meta !== "object") { return null; }
+      var list = meta.diffs;
+      if (!Array.isArray(list) || list.length === 0) { return null; }
+      var out = [];
+      for (var i = 0; i < list.length; i++) {
+        var d = list[i];
+        if (d && typeof d.path === "string" && d.path) { out.push(d); }
+      }
+      return out.length > 0 ? out : null;
+    }
+    function mergeDiff(files, diff) {
+      var path = String(diff.path);
+      var part = [diff.oldText == null ? null : String(diff.oldText), diff.newText == null ? "" : String(diff.newText)];
+      for (var i = 0; i < files.length; i++) {
+        if (files[i].path === path) {
+          var copy = files.slice();
+          copy[i] = { path: path, parts: files[i].parts.concat([part]) };
+          return copy;
+        }
+      }
+      return files.concat([{ path: path, parts: [part] }]);
+    }
+    function changesDefinition() {
+      return {
+        kind: CHANGES_KIND,
+        match: function (event) {
+          var d = (event && event.data) || {};
+          if (event.type === "turn/start") {
+            return d.turn === undefined ? null : { id: String(d.turn), role: "start" };
+          }
+          if (event.type === "tool/call") {
+            if (d.callId !== undefined && d.turn !== undefined) { rootTurn[String(d.callId)] = d.turn; }
+            return d.turn === undefined ? null : { id: String(d.turn), role: "update" };
+          }
+          if (event.type === "workspace/changes") {
+            return d.turn === undefined ? null : { id: String(d.turn), role: "update" };
+          }
+          if (event.type === "tool/result") {
+            return (d.turn !== undefined && metaDiffs(d)) ? { id: String(d.turn), role: "update" } : null;
+          }
+          if (event.type === "tool/ptc-dispatch") {
+            if (!metaDiffs(d)) { return null; }
+            var turn = rootTurn[String(d.rootCallId)];
+            return turn === undefined ? null : { id: String(turn), role: "update" };
+          }
+          return null;
+        },
+        start: function () { return { seq: null, files: [] }; },
+        update: function (context, match) {
+          var prev = (context && context.state) || context || { seq: null, files: [] };
+          var next = { seq: prev.seq == null ? null : prev.seq, files: prev.files || [] };
+          var event = match && match.event;
+          if (!event) { return next; }
+          if (event.type === "workspace/changes") { return { seq: event.seq, files: next.files }; }
+          var list = metaDiffs(event.data || {});
+          if (!list) { return next; }
+          var files = next.files;
+          for (var i = 0; i < list.length; i++) { files = mergeDiff(files, list[i]); }
+          return { seq: next.seq, files: files };
+        }
+      };
+    }
+    function shortPath(p) {
+      var s = String(p);
+      return s.length > 64 ? "…" + s.slice(s.length - 63) : s;
+    }
+    function changesCard(props) {
+      var owner = props || {};
+      var state = null;
+      try {
+        if (owner.turn && owner.turn.data && typeof owner.turn.data.get === "function") {
+          state = owner.turn.data.get(CHANGES_KIND);
+        }
+      } catch (e) { state = null; }
+      var sessionId = owner.sessionId;
+      var seq = state && state.seq != null ? state.seq : null;
+      var key = (sessionId && seq != null) ? String(sessionId) + ":" + String(seq) : null;
+      var cached = key && probeCache[key] ? probeCache[key] : null;
+      var probeState = REACT.useState(cached || "pending");
+      var probe = probeState[0], setProbe = probeState[1];
+      var expState = REACT.useState(false);
+      var expanded = expState[0], setExpanded = expState[1];
+      REACT.useEffect(function () {
+        if (!key || cached) { return undefined; }
+        var cancelled = false;
+        try {
+          fetch(SUMMARY_ROUTE + "?" + new URLSearchParams({ sessionId: String(sessionId), seq: String(seq) }),
+            { cache: "no-store", credentials: "same-origin" }).then(function (res) {
+            if (cancelled) { return; }
+            var v = res.status === 200 ? "ok" : (res.status === 404 ? "missing" : "error");
+            if (v !== "error" && probeCache[key] === undefined) { probeCache[key] = v; }
+            setProbe(v);
+          }).catch(function () {});
+        } catch (e) {}
+        return function () { cancelled = true; };
+      }, [key, cached]);
+      /* 只在「官方已失效」时才补位：ok / pending / error 一律不画，避免出现双份卡。 */
+      if (!state || !state.files || state.files.length === 0 || seq == null || probe !== "missing") { return null; }
+
+      var files = state.files, totals = { added: 0, deleted: 0 }, prepared = [], i, j;
+      for (i = 0; i < files.length; i++) {
+        var net = foldParts(files[i].parts);
+        var rows = (expanded && net !== null) ? diffRows(net.before, net.after) : null;
+        var counted = net !== null ? countRows(diffRows(net.before, net.after)) : countParts(files[i].parts);
+        totals.added += counted.added; totals.deleted += counted.deleted;
+        prepared.push({ path: files[i].path, parts: files[i].parts, added: counted.added, deleted: counted.deleted, rows: rows });
+      }
+
+      var mono = "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";
+      var dim = { opacity: 0.6, fontSize: 11 };
+      var add = { color: "#3fb950" };
+      var del = { color: "#f85149" };
+      var children = [];
+      children.push(REACT.createElement("div", {
+        key: "head",
+        style: { display: "flex", alignItems: "center", gap: 8, cursor: "pointer", userSelect: "none" },
+        onClick: function () { setExpanded(!expanded); }
+      },
+        REACT.createElement("span", { style: { fontWeight: 600 } }, "本回合改动"),
+        REACT.createElement("span", { style: dim }, files.length + " 个文件"),
+        REACT.createElement("span", { style: add }, "+" + totals.added),
+        REACT.createElement("span", { style: del }, "−" + totals.deleted),
+        REACT.createElement("span", { style: { marginLeft: "auto", opacity: 0.6, fontSize: 11 } }, expanded ? "收起" : "展开")
+      ));
+      children.push(REACT.createElement("div", { key: "note", style: { opacity: 0.5, fontSize: 11, marginTop: 2 } },
+        "（据会话日志重建 · 仅文件工具的改动）"));
+      if (expanded) {
+        for (i = 0; i < prepared.length; i++) {
+          var f = prepared[i];
+          var block = [];
+          block.push(REACT.createElement("div", {
+            key: "p", style: { display: "flex", alignItems: "center", gap: 6, marginTop: 6 }
+          },
+            REACT.createElement("span", { style: { overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap", fontFamily: mono }, title: f.path }, shortPath(f.path)),
+            REACT.createElement("span", { style: add }, "+" + f.added),
+            REACT.createElement("span", { style: del }, "−" + f.deleted)
+          ));
+          if (f.rows) {
+            var shown = f.rows.length > DIFF_ROW_LIMIT ? f.rows.slice(0, DIFF_ROW_LIMIT) : f.rows;
+            for (j = 0; j < shown.length; j++) {
+              block.push(REACT.createElement("div", {
+                key: "r" + j,
+                style: { fontFamily: mono, fontSize: 11, whiteSpace: "pre-wrap", wordBreak: "break-all",
+                  color: shown[j].k === "+" ? "#3fb950" : (shown[j].k === "-" ? "#f85149" : "inherit"),
+                  opacity: shown[j].k === " " ? 0.7 : 1 }
+              }, (shown[j].k === " " ? "  " : shown[j].k + " ") + shown[j].t));
+            }
+            if (f.rows.length > DIFF_ROW_LIMIT) {
+              block.push(REACT.createElement("div", { key: "more", style: dim }, "…还有 " + (f.rows.length - DIFF_ROW_LIMIT) + " 行"));
+            }
+          } else {
+            for (j = 0; j < f.parts.length; j++) {
+              block.push(REACT.createElement("div", { key: "seg" + j, style: { opacity: 0.6, fontSize: 11, marginTop: 4 } },
+                "第 " + (j + 1) + " 段改动（与前一段不衔接，分段显示）"));
+              var prows = diffRows(f.parts[j][0], f.parts[j][1]);
+              var pshown = prows.length > DIFF_ROW_LIMIT ? prows.slice(0, DIFF_ROW_LIMIT) : prows;
+              for (var r2 = 0; r2 < pshown.length; r2++) {
+                block.push(REACT.createElement("div", {
+                  key: "pr" + j + "_" + r2,
+                  style: { fontFamily: mono, fontSize: 11, whiteSpace: "pre-wrap", wordBreak: "break-all",
+                    color: pshown[r2].k === "+" ? "#3fb950" : (pshown[r2].k === "-" ? "#f85149" : "inherit"),
+                    opacity: pshown[r2].k === " " ? 0.7 : 1 }
+                }, (pshown[r2].k === " " ? "  " : pshown[r2].k + " ") + pshown[r2].t));
+              }
+            }
+          }
+          children.push(REACT.createElement("div", { key: "f" + i }, block));
+        }
+      }
+      return REACT.createElement("div", {
+        style: { marginTop: 8, border: "1px solid var(--dsw-alias-border-neutral-secondary, rgba(128,128,128,0.25))",
+          borderRadius: 8, padding: "8px 10px", fontSize: 12 }
+      }, children);
+    }
+    function installChangesCard(scope, ctx) {
+      if (!REACT) { throw new Error("ui-tweaks: require(\"react\") 不可用，跳过改动补位卡"); }
+      var s = scope || ctx || {};
+      var conv = s.uiConversation || (ctx && ctx.uiConversation) || null;
+      var slots = s.slots || (ctx && ctx.slots) || null;
+      if (!conv || !conv.events || typeof conv.events.register !== "function") {
+        throw new Error("ui-tweaks: uiConversation.events 不可用");
+      }
+      if (!slots || typeof slots.register !== "function" || typeof slots.inject !== "function") {
+        throw new Error("ui-tweaks: slots 服务不可用");
+      }
+      conv.events.register(changesDefinition());
+      slots.inject("conversation.chat.turnTail", function () {
+        return slots.register({
+          name: "conversation.chat.turnTail",
+          id: CHANGES_KIND,
+          order: 30,
+          inject: function (sessionId) { return { sessionId: sessionId }; }
+        }, changesCard);
+      });
+      try { ctx.on("connection/reset", function () { probeCache = {}; rootTurn = {}; }); } 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);
+      guard("changes", function () { ctx.inject(["uiConversation", "slots"], function (s) { installChangesCard(s, ctx); }); });
     }
 
     module.exports = { name: "ui-tweaks", apply: apply, inject: ["remote", "remote.pluginManager", "remote.pluginInventory"] };