dsh-plugin-update 0.5.5 → 0.5.6

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 格式为 Keep-a-Changelog 子集：`Added/Fixed/Changed` 必写，`Deprecated/Removed/Security` 有则透传，`Unreleased` 面板忽略，禁止 git-log 直倒。面板缺日志时中性提示，不挡安装。
 
+## [0.5.6] - 2026-10-06
+
+### Added
+- 弹窗分栏滚动、更新日志折叠与动效体系；双语防倒退门禁四道检查（文案源／快照／契约／零 draft）与自测（#56）。
+
+### Fixed
+- 用户路径抛错锁存非瞬态化（#58）：查／装动作的传输抛错改为非瞬态锁存（安装抛错码为 install-failed，不再冒充查失败），轮询不再洗掉；抛错原文脱敏后进复制摘要；安装内补查失败精确归因到查阶段；轮询抛错仍瞬态自愈。
+
 ## [0.5.5] - 2026-10-06
 
 ### Added

package/dist/panel-batch.js

@@ -383,6 +383,8 @@ const UPDATE_BATCH_PANEL_CSS = [
   ".dsh-upd-bdetail{margin:2px 0 10px;overflow:visible}",
   ".dsh-upd .dsh-upd-bdetail .dsh-upd{max-width:none}",
   ".dsh-upd-overlay .dsh-upd-bdetail .dsh-upd{max-height:none;overflow:visible}",
+  ".dsh-upd-overlay .dsh-upd-bdetail .dsh-upd-body{overflow:visible}",
+  ".dsh-upd-overlay .dsh-upd-bdetail .dsh-upd-body .dsh-upd-chap-head{position:static}",
   "@media (prefers-color-scheme: dark){.dsh-upd-batch-title i{color:var(--dsh-upd-focus,#93c5fd)}}",
   "@media (prefers-reduced-motion: reduce){.dsh-upd-batch *{transition:none !important;animation:none !important}}"
 ].join(String.fromCharCode(10));

package/dist/panel.d.ts

@@ -18,7 +18,7 @@ export type UpdatePanelCall = (phoneName: string, args: Record<string, unknown>)
 /** 复制文本的出口：不传即尝试浏览器剪贴板，都没有则只留“已生成、请手动复制”提示。 */
 export type UpdatePanelCopyText = (text: string) => void | Promise<void>;
 /** 面板可点的动作（与 HTML 里 data-action 一一对应，测试走同一条路）。 */
-export type UpdatePanelActionKind = 'check' | 'install' | 'skip' | 'reset-skip' | 'copy-manual' | 'copy-diag' | 'toggle-queue' | 'restart-hint' | 'close-view' | 'dismiss-failure';
+export type UpdatePanelActionKind = 'check' | 'install' | 'skip' | 'reset-skip' | 'copy-manual' | 'copy-diag' | 'toggle-queue' | 'toggle-changelog' | 'restart-hint' | 'close-view' | 'dismiss-failure';
 export interface UpdatePanelOptions {
     /** 插件标识：必填，与宿主侧 createHostUpdate 传的 pluginId 一致。 */
     pluginId: string;
@@ -86,6 +86,8 @@ export interface UpdatePanelController {
     setTheme(theme: UpdatePanelTheme): Promise<void>;
     /** 切换排队可见性（重查一次，位置口径不变）。 */
     setShowOthers(show: boolean): Promise<void>;
+    /** 收起/展开更新日志（纯视图态，不调电话；轮询与换肤不丢）。 */
+    setChangelogCollapsed(collapsed: boolean): Promise<void>;
     /**
      * 换一版更新日志后重绘（#23：宿主侧备好新文本后调用；传 null/空串即回中性提示）。
      * 只换日志节，安装门控只跟快照，一字不动。
@@ -258,6 +260,11 @@ export interface PanelRenderInput extends PanelViewInput {
      * 只读渲染下五章内容、进度条、「已跳过」提示一字不减，只是没有动作按钮。
      */
     actions?: 'default' | 'none';
+    /**
+     * 更新日志折叠（仅挂载态内部用：用户点了 02 章标题行的收起/展开）。
+     * 缺省即展开（安全日志必显、可查找；只读渲染下恒展开）。
+     */
+    changelogCollapsed?: boolean;
 }
 /** 内核渲染用的失败引用（只读快照：证据仍在锁存里，这里只传展示键）。 */
 export interface PanelFailureRef {

package/dist/panel.js

@@ -528,7 +528,15 @@ const UPDATE_PANEL_CSS = [
   ".dsh-upd-changelog-more-note{font-size:12px;opacity:.7;margin:2px 0 4px}",
   ".dsh-upd-changelog-neutral{color:inherit;opacity:.8}",
   ".dsh-upd-overlay{position:fixed;inset:0;background:rgba(0,0,0,.35);display:flex;align-items:center;justify-content:center;z-index:9999}",
-  ".dsh-upd-overlay .dsh-upd{background:var(--dsh-upd-bg,#ffffff);max-height:85vh;overflow:auto}",
+  ".dsh-upd-overlay .dsh-upd{background:var(--dsh-upd-bg,#ffffff);max-height:85vh;display:flex;flex-direction:column;overflow:hidden}",
+  // —— 弹窗分栏滚动：头（抬头/档案头/横幅/版本条）与尾固定，只有 01–05 章节区滚动 ——
+  ".dsh-upd-body{min-height:0}",
+  ".dsh-upd-overlay .dsh-upd-body{flex:1 1 auto;overflow-y:auto;overscroll-behavior:contain;scrollbar-width:thin;scrollbar-color:var(--dsh-upd-line,#e5e7eb) transparent}",
+  ".dsh-upd-overlay .dsh-upd-body::-webkit-scrollbar{width:8px}",
+  ".dsh-upd-overlay .dsh-upd-body::-webkit-scrollbar-thumb{background:var(--dsh-upd-line,#e5e7eb);border-radius:4px}",
+  ".dsh-upd-overlay .dsh-upd-body::-webkit-scrollbar-track{background:transparent}",
+  // —— 章节标题磁吸：滚动时节标题贴顶（纯 CSS sticky；背景跟随主题，D5 另覆）——
+  ".dsh-upd-overlay .dsh-upd-body .dsh-upd-chap-head{position:sticky;top:0;z-index:1;background:var(--dsh-upd-bg,#ffffff);padding-top:2px}",
   // —— 档案头 / 版本条 / 章节 / 进度条 / 跳过行（原型 :208-245 的新结构，默认主题给最小可用样式）——
   ".dsh-upd-head{display:flex;gap:12px;align-items:baseline;flex-wrap:wrap}",
   // 卷宗抬头「插件更新 / 更新档案 卷」：D5 档案卷才画，默认（最小）主题不画。
@@ -582,11 +590,18 @@ const UPDATE_PANEL_CSS = [
   ".dsh-upd button:active:not(:disabled){transform:translateY(1px)}",
   '.dsh-upd button[aria-busy="true"]{cursor:wait;animation:dsh-upd-pulse 1s ease-in-out infinite}',
   "@keyframes dsh-upd-pulse{0%,100%{opacity:1}50%{opacity:.55}}",
+  // —— 状态横幅淡入 + 日志折叠格动画（纯 CSS；重绘只发生在真变时；reduced-motion 下静止）——
+  ".dsh-upd-banner{animation:dsh-upd-fadein .22s ease}",
+  "@keyframes dsh-upd-fadein{from{opacity:.35;transform:translateY(2px)}}",
+  ".dsh-upd-changelog-foldbox{display:grid;grid-template-rows:1fr;opacity:1;transition:grid-template-rows .22s ease,opacity .18s ease}",
+  ".dsh-upd-changelog-foldbox-inner{min-height:0;overflow:hidden}",
+  '.dsh-upd-changelog-foldbox[data-open="0"]{grid-template-rows:0fr;opacity:0}',
   // 在途转圈：纯 CSS ::after，不加 DOM 节点（内核 DOM 冻结）；转的是边框缺口，不是 emoji。
   '.dsh-upd button[aria-busy="true"]::after{content:"";display:inline-block;width:11px;height:11px;margin-left:8px;vertical-align:-1px;',
   "border:2px solid currentColor;border-top-color:transparent;border-radius:50%;animation:dsh-upd-spin .8s linear infinite}",
   "@keyframes dsh-upd-spin{to{transform:rotate(360deg)}}",
-  '@media (prefers-reduced-motion: reduce){.dsh-upd button{transition:none}.dsh-upd button:active:not(:disabled){transform:none}.dsh-upd button[aria-busy="true"]{animation:none}.dsh-upd-skv{animation:none}}',
+  '@media (prefers-reduced-motion: reduce){.dsh-upd button{transition:none}.dsh-upd button:active:not(:disabled){transform:none}.dsh-upd button[aria-busy="true"]{animation:none}.dsh-upd-skv{animation:none}.dsh-upd-banner{animation:none}.dsh-upd-changelog-foldbox{transition:none}}',
+  "@media (forced-colors: active){.dsh-upd-overlay .dsh-upd-body .dsh-upd-chap-head{background:Canvas}}",
   "@media (prefers-color-scheme: dark){.dsh-upd{--dsh-upd-fg:#e5e7eb;--dsh-upd-bg:#111827;--dsh-upd-line:#374151;",
   "--dsh-upd-btn:#1f2937;--dsh-upd-soft:#1f2937;--dsh-upd-primary:#3b82f6;--dsh-upd-focus:#93c5fd;",
   // 横幅深色覆盖：底色用低透明度同色系（不是浅色原值），边线提亮，保证「深底浅字」可读。
@@ -650,6 +665,9 @@ const UPDATE_PANEL_D5_CSS = [
   '.dsh-upd[data-theme="archive"] .dsh-upd-qn{font-family:var(--d5-mono);font-size:11.5px;color:var(--d5-muted)}',
   '.dsh-upd[data-theme="archive"] .dsh-upd-qseq{color:var(--d5-muted)}',
   '.dsh-upd[data-theme="archive"] .dsh-upd-chap-note{color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-body .dsh-upd-chap-head{background:var(--d5-card)}',
+  '.dsh-upd-overlay .dsh-upd[data-theme="archive"] .dsh-upd-body{scrollbar-color:var(--d5-line-strong) transparent}',
+  '.dsh-upd-overlay .dsh-upd[data-theme="archive"] .dsh-upd-body::-webkit-scrollbar-thumb{background:var(--d5-line-strong)}',
   // —— 小印章（原型 :215 `.sealmini`：30px、旋转 -5°、一字）——
   // 待重启横幅一律不画印章：那一档的标记是左侧手绘 SVG（原型 :446 的 .mark 只有 SVG）。
   '.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="loading"]::before,.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="idle"]::before,',
@@ -805,9 +823,11 @@ function renderUpdatePanelKernel(input, view) {
       `<div class="dsh-upd-skipline"><span class="dsh-upd-tag">\u5DF2\u8DF3\u8FC7 ${escapeHtml(snapshot.latestVersion)}</span>\u70B9\u300C\u6062\u590D\u300D\u53EF\u64A4\u9500\uFF0C\u4E4B\u540E\u8FD9\u4E00\u7248\u8FD8\u4F1A\u518D\u63D0\u9192\u3002</div>`
     );
   }
-  parts.push(chapterOf(1, actions.join("")));
+  const chapters = [];
+  chapters.push(chapterOf(1, actions.join("")));
   {
     let inner = "";
+    let hasLog = false;
     if (snapshot && snapshot.latestVersion) {
       try {
         const mdText = typeof changelogMarkdown === "string" ? changelogMarkdown : "";
@@ -837,9 +857,11 @@ function renderUpdatePanelKernel(input, view) {
         } catch {
           yankedBanner = "";
         }
-        inner = `<div class="dsh-upd-changelog-wrap"><div>${escapeHtml(rangeTitle)}</div>${yankedBanner}
+        const logOpen = input.changelogCollapsed !== true;
+        inner = `<div class="dsh-upd-changelog-wrap"><div>${escapeHtml(rangeTitle)}</div><div class="dsh-upd-changelog-foldbox" data-open="${logOpen ? "1" : "0"}"><div class="dsh-upd-changelog-foldbox-inner">${yankedBanner}
 ${changelogHTML}
-</div>`;
+</div></div></div>`;
+        hasLog = Array.isArray(ranged) && ranged.length > 0;
       } catch {
         inner = "";
       }
@@ -849,7 +871,9 @@ ${changelogHTML}
         snapshot && snapshot.latestVersion ? "\u65E5\u5FD7\u8BFB\u4E0D\u51FA\u6765\uFF0C\u5B89\u88C5\u4E0D\u53D7\u5F71\u54CD\u3002" : "\u8FD8\u6CA1\u67E5\u5230\u65B0\u7248\uFF1B\u67E5\u5230\u540E\u518D\u663E\u793A\u65E5\u5FD7\u3002"
       )}</div></div>`;
     }
-    parts.push(chapterOf(2, inner));
+    const logCollapsed = input.changelogCollapsed === true;
+    const logNote = showActions && hasLog ? `<span class="dsh-upd-chap-note"><button type="button" data-action="toggle-changelog" title="\u5C55\u5F00\u6216\u6536\u8D77\u66F4\u65B0\u65E5\u5FD7">${logCollapsed ? "\u5C55\u5F00\u66F4\u65B0\u65E5\u5FD7" : "\u6536\u8D77\u66F4\u65B0\u65E5\u5FD7"}</button></span>` : "";
+    chapters.push(chapterOf(2, inner, logNote));
   }
   {
     const queued = !!queue && (queue.busy || queue.waiting.length > 0);
@@ -876,9 +900,9 @@ ${changelogHTML}
         );
       }
       const note = showActions ? `<span class="dsh-upd-chap-note"><button type="button" data-action="toggle-queue">${reveal ? "\u9690\u85CF\u4ED6\u4EBA\u660E\u7EC6" : "\u663E\u793A\u5176\u4ED6\u63D2\u4EF6"}</button></span>` : "";
-      parts.push(chapterOf(3, `<div class="dsh-upd-queue">${rows.join("")}</div>`, note));
+      chapters.push(chapterOf(3, `<div class="dsh-upd-queue">${rows.join("")}</div>`, note));
     } else {
-      parts.push(
+      chapters.push(
         chapterOf(
           3,
           `<div class="dsh-upd-queue"><div class="dsh-upd-changelog-neutral">${escapeHtml(
@@ -930,14 +954,15 @@ ${changelogHTML}
       }
     }
     if (copyNotice) errLines.push(`<div class="dsh-upd-copy" role="status">${escapeHtml(copyNotice)}</div>`);
-    parts.push(chapterOf(4, errLines.join("")));
+    chapters.push(chapterOf(4, errLines.join("")));
   }
-  parts.push(
+  chapters.push(
     chapterOf(
       5,
       view.showManual && manual ? `<div class="dsh-upd-manual"><div>\u624B\u5DE5\u515C\u5E95\u547D\u4EE4\uFF08\u590D\u5236\u6574\u884C\u6267\u884C\uFF09\uFF1A</div><code>${escapeHtml(manual)}</code></div>` : `<div class="dsh-upd-manual"><div class="dsh-upd-changelog-neutral">\u5F53\u524D\u6CA1\u6709\u53EF\u7528\u7684\u624B\u5DE5\u547D\u4EE4\uFF08\u8BA4\u4E0D\u51FA\u4F7F\u7528\u8303\u56F4\u6216\u5C5E\u6E90\u7801\u5B89\u88C5\u65F6\u4E0D\u7ED9\uFF09\u3002</div></div>`
     )
   );
+  parts.push('<div class="dsh-upd-body">' + chapters.join("\n") + "</div>");
   if (showActions && mode === "dialog") {
     parts.push(
       `<div class="dsh-upd-footer"><span class="dsh-upd-foot-note">\u5173\u95ED\u4E0D\u5F71\u54CD\u66F4\u65B0\uFF0C\u53EF\u968F\u65F6\u56DE\u6765\u67E5\u770B</span><button type="button" data-action="close-view" title="\u5173\u95ED\u7A97\u53E3\uFF0C\u66F4\u65B0\u4E0D\u53D7\u5F71\u54CD">\u5173\u95ED</button></div>`
@@ -1056,6 +1081,7 @@ function mountUpdatePanel(container, options) {
   }
   let theme = normalizePanelTheme(options.theme ?? "default");
   let showOthers = options.showOthers === true;
+  let changelogCollapsed = false;
   const call = options.call;
   const onRestartRequested = options.onRestartRequested;
   const onCloseRequested = typeof options.onCloseRequested === "function" ? options.onCloseRequested : null;
@@ -1158,6 +1184,38 @@ function mountUpdatePanel(container, options) {
       atMs: latchNow()
     };
   }
+  function thrownDetail(err) {
+    try {
+      const raw = err instanceof Error ? err.message : typeof err === "string" ? err : null;
+      if (typeof raw !== "string") return null;
+      const t = raw.trim();
+      if (!t) return null;
+      if (/^[a-z][a-z-]*$/.test(t) && t.length <= 32) return null;
+      return redactForCopy(t) || null;
+    } catch {
+      return null;
+    }
+  }
+  function userThrowLatch(source, err) {
+    const env = currentEnvPair();
+    return {
+      code: source === "install" ? "install-failed" : "check-failed",
+      kind: null,
+      detail: thrownDetail(err),
+      diag: null,
+      requestId: source === "install" ? requestId : null,
+      checkId: source === "install" ? receipt?.checkId ?? null : null,
+      runningVersion: snapshot?.runningVersion ?? null,
+      installedVersion: snapshot?.installedVersion ?? null,
+      latestVersion: snapshot?.latestVersion ?? null,
+      hostKind: env.hostKind,
+      profileName: env.profileName,
+      source,
+      volatile: false,
+      jobId: null,
+      atMs: latchNow()
+    };
+  }
   function volatileLatch(source) {
     const env = currentEnvPair();
     return {
@@ -1244,6 +1302,7 @@ function mountUpdatePanel(container, options) {
       changelogMarkdown,
       mode,
       showOthers,
+      changelogCollapsed,
       pluginId,
       copyNotice,
       theme,
@@ -1404,9 +1463,9 @@ function mountUpdatePanel(container, options) {
           if (!mounted) return;
           applyStatusReply(reply, "check");
           changelogFailedAt.clear();
-        } catch {
+        } catch (err) {
           if (!mounted) return;
-          setLatch(volatileLatch("check"));
+          setLatch(userThrowLatch("check", err));
         } finally {
           busyAct = null;
           if (copyNotice === "\u6B63\u5728\u67E5\u65B0\u7248\u2026") copyNotice = null;
@@ -1422,9 +1481,16 @@ function mountUpdatePanel(container, options) {
         render();
         try {
           if (!receipt) {
-            const checked = await call(phoneNames.updateCheck, queueArgs());
-            if (!mounted) return;
-            applyStatusReply(checked, "check");
+            try {
+              const checked = await call(phoneNames.updateCheck, queueArgs());
+              if (!mounted) return;
+              applyStatusReply(checked, "check");
+            } catch (err) {
+              if (!mounted) return;
+              setLatch(userThrowLatch("check", err));
+              render();
+              return;
+            }
           }
           if (!mounted) return;
           if (!receipt) {
@@ -1457,9 +1523,9 @@ function mountUpdatePanel(container, options) {
           });
           if (!mounted) return;
           applyStatusReply(reply, "install");
-        } catch {
+        } catch (err) {
           if (!mounted) return;
-          setLatch(volatileLatch("install"));
+          setLatch(userThrowLatch("install", err));
         } finally {
           busyAct = null;
           if (copyNotice === "\u6B63\u5728\u5B89\u88C5\u2026") copyNotice = null;
@@ -1567,6 +1633,11 @@ function mountUpdatePanel(container, options) {
         await refresh();
         return;
       }
+      case "toggle-changelog": {
+        changelogCollapsed = !changelogCollapsed;
+        render();
+        return;
+      }
       // 「重启宿主」：宿主没有重启自己的电话，所以只做入口——
       // 调用方给了 onRestartRequested 就交给它；没给就如实说“请手动重启”，不假装。
       case "restart-hint": {
@@ -1607,6 +1678,10 @@ function mountUpdatePanel(container, options) {
     showOthers = show === true;
     await refresh();
   }
+  async function setChangelogCollapsed(collapsed) {
+    changelogCollapsed = collapsed === true;
+    render();
+  }
   function onClick(ev) {
     try {
       const t = ev;
@@ -1683,7 +1758,7 @@ function mountUpdatePanel(container, options) {
     } catch {
     }
   })();
-  return { refresh, act, setMode, setTheme, setShowOthers, setChangelogMarkdown, unmount };
+  return { refresh, act, setMode, setTheme, setShowOthers, setChangelogCollapsed, setChangelogMarkdown, unmount };
 }
 import { buildPhoneNames as buildPhoneNames2 } from "./config.js";
 import { buildChangelogPhoneName as buildChangelogPhoneName2 } from "./config.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-update",
-  "version": "0.5.5",
+  "version": "0.5.6",
   "description": "可复用的更新系统装成的 npm 包：任何 DSH 插件照文档能集成检查更新等功能（地图 #579）",
   "license": "MIT",
   "author": "王辰浩",
@@ -65,7 +65,9 @@
     "build": "node build.mjs",
     "prepack": "npm run build",
     "pretest": "npm run build",
-    "test": "node --test tests/*.test.mjs"
+    "test": "node --test tests/*.test.mjs",
+    "gate:bilingual": "node scripts/bilingual-gate.mjs",
+    "gate:bilingual:release": "node scripts/bilingual-gate.mjs --release"
   },
   "devDependencies": {
     "esbuild": "^0.28.2",