dsh-workflow-map 0.3.2 → 0.3.5

package/client.js

@@ -198,7 +198,15 @@ window.__ModuleLoader__.load({
      // the three branch hues live on the ROOT, so the dashed branches and their round
      // icons share one palette with the rest of the panel (and one place to change it).
         "--wf-chain-read:#5b8cff;--wf-chain-edit:#e0a13a;--wf-chain-tool:#8f7bea;" +
+      // `--dsw-alias-bg-layer-1` and `-2` carry the SAME value in the host's light theme (both
+      // neutral-bluish-00, i.e. #fff), so a card filled with layer-2 is invisible on the page. Every
+      // raised surface in the panel therefore paints one translucent lift over that fill. The lift goes
+      // towards ink on a light page and towards white on a dark one; the host marks dark by putting
+      // `data-ds-dark-theme` on <body>, so the light values are the defaults and the dark block below
+      // only wins when that attribute is present.
+        "--wf-lift:rgba(15,23,42,.045);--wf-lift-2:rgba(15,23,42,.085);" +
         "font-family:ui-sans-serif,system-ui,-apple-system,'Segoe UI','Microsoft YaHei',sans-serif;font-size:12px;line-height:1.5}",
+      "body[data-ds-dark-theme] .wf-root{--wf-lift:rgba(255,255,255,.035);--wf-lift-2:rgba(255,255,255,.07)}",
 
      /* card: fills the main area; the header and the settings card keep their own height,
          the two-column body takes the rest. No drag grips: the column has no free edges.
@@ -224,6 +232,10 @@ window.__ModuleLoader__.load({
       ".wf-btn:hover{background:var(--dsw-alias-bg-layer-2,#2c3140);color:var(--dsw-alias-label-primary,#e9ecf3)}",
       ".wf-btn:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#5b8cff);outline-offset:1px}",
       ".wf-btn[data-active='true']{color:var(--dsw-alias-brand-primary,#5b8cff);border-color:var(--dsw-alias-brand-primary,#5b8cff)}",
+     // The refresh button's one-second acknowledgement. Width is pinned to the glyph's own
+     // box so swapping "↻" for "已刷新" cannot shift the header row underneath the pointer.
+      ".wf-btn-ok{color:var(--dsw-alias-state-success-primary,#3fb950);border-color:var(--dsw-alias-state-success-primary,#3fb950);" +
+        "width:auto;min-width:23px;padding:0 6px;font-size:11px}",
      // Hot injection is the one header action that injects text into the RUNNING turn, so it is the
      // one that must never be hunted for: a named, filled chip that keeps its name in Chinese.
      // User feedback: "too small, still have to open it first" - so it grows to 96x30 (the other two in the row stay
@@ -281,13 +293,14 @@ window.__ModuleLoader__.load({
      // `grid-area:1/1` is what makes the triangle and the card share the cell: without it the
      // auto-placement cursor would drop the card into row 2, below the triangle.
       ".wf-step-card{grid-area:1/1;display:flex;gap:8px;align-items:flex-start;width:100%;padding:7px 8px;border-radius:8px;text-align:left;" +
-        "font:inherit;color:inherit;cursor:pointer;border:1px solid transparent;" +
-        "background:var(--dsw-alias-bg-layer-2,#282d3a);border-left:3px solid transparent}",
+        "font:inherit;color:inherit;cursor:pointer;border:1px solid var(--dsw-alias-border-l2,rgba(255,255,255,.22));" +
+        "background:var(--dsw-alias-bg-layer-2,#282d3a);background-image:linear-gradient(var(--wf-lift),var(--wf-lift));" +
+        "border-left:3px solid transparent}",
       ".wf-step-card:hover{border-color:var(--dsw-alias-border-l2,rgba(255,255,255,.22));" +
-        "background:var(--dsw-alias-bg-layer-1,#232733)}",
+        "background:var(--dsw-alias-bg-layer-1,#232733);background-image:linear-gradient(var(--wf-lift-2),var(--wf-lift-2))}",
       ".wf-step-card:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#5b8cff);outline-offset:1px}",
       ".wf-step-card[data-selected='true']{border-color:var(--dsw-alias-brand-primary,#5b8cff);" +
-        "background:var(--dsw-alias-bg-layer-1,#232733)}",
+        "background:var(--dsw-alias-bg-layer-1,#232733);background-image:linear-gradient(var(--wf-lift-2),var(--wf-lift-2))}",
       ".wf-step-card[data-active='true']{border-left-color:var(--dsw-alias-brand-primary,#5b8cff)}",
       ".wf-step-ring{flex:0 0 auto;width:18px;height:18px;margin-top:1px;border-radius:50%;" +
         "display:inline-flex;align-items:center;justify-content:center;font-size:11px;line-height:1;" +
@@ -441,7 +454,7 @@ window.__ModuleLoader__.load({
       ".wf-branch-icon{flex:0 0 auto;width:" + WF_CHAIN_ICON + "px;height:" + WF_CHAIN_ICON + "px;padding:0;" +
         "border-radius:50%;display:inline-flex;align-items:center;justify-content:center;" +
         "font:inherit;font-size:11px;line-height:1;cursor:pointer;position:relative;" +
-        "background:var(--dsw-alias-bg-layer-2,#282d3a);color:var(--dsw-alias-label-secondary,#9aa3b2);" +
+        "background:var(--dsw-alias-bg-layer-2,#282d3a);background-image:linear-gradient(var(--wf-lift),var(--wf-lift));color:var(--dsw-alias-label-secondary,#9aa3b2);" +
         "border:1px solid var(--dsw-alias-border-l2,rgba(255,255,255,.28))}",
       ".wf-branch-icon:hover{color:var(--dsw-alias-label-primary,#e9ecf3)}",
       ".wf-branch-icon:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#5b8cff);outline-offset:2px}",
@@ -471,12 +484,14 @@ window.__ModuleLoader__.load({
      /* node card: icon · title · meta · status dot */
       ".wf-node{display:flex;gap:7px;align-items:flex-start;width:100%;padding:6px 8px;border-radius:8px;" +
         "text-align:left;font:inherit;color:inherit;cursor:pointer;" +
-        "background:var(--dsw-alias-bg-layer-2,#282d3a);border:1px solid transparent;" +
+        "background:var(--dsw-alias-bg-layer-2,#282d3a);background-image:linear-gradient(var(--wf-lift),var(--wf-lift));" +
+        "border:1px solid var(--dsw-alias-border-l2,rgba(255,255,255,.22));" +
         "border-left:3px solid var(--dsw-alias-border-l2,rgba(255,255,255,.2))}",
-      ".wf-node:hover{border-color:var(--dsw-alias-border-l2,rgba(255,255,255,.24));background:var(--dsw-alias-bg-layer-1,#232733)}",
+      ".wf-node:hover{border-color:var(--dsw-alias-border-l2,rgba(255,255,255,.24));" +
+        "background:var(--dsw-alias-bg-layer-1,#232733);background-image:linear-gradient(var(--wf-lift-2),var(--wf-lift-2))}",
       ".wf-node:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#5b8cff);outline-offset:1px}",
       ".wf-node[data-selected='true']{border-color:var(--dsw-alias-brand-primary,#5b8cff);" +
-        "background:var(--dsw-alias-bg-layer-1,#232733)}",
+        "background:var(--dsw-alias-bg-layer-1,#232733);background-image:linear-gradient(var(--wf-lift-2),var(--wf-lift-2))}",
       ".wf-node[data-selected='true'] .wf-node-title{font-weight:600}",
       ".wf-node[data-kind='tool']{border-left-color:var(--dsw-alias-brand-primary,#5b8cff)}",
       ".wf-node[data-kind='report']{border-left-color:var(--dsw-alias-state-success-primary,#45c07a)}",
@@ -1053,11 +1068,12 @@ window.__ModuleLoader__.load({
 
      /* ---- the unit card ---- */
       ".wf-unit-card{display:grid;grid-template-columns:auto auto minmax(0,1fr);align-items:flex-start;gap:8px;" +
-        "width:100%;padding:10px 12px;border-radius:10px;text-align:left;border:1px solid transparent;" +
-        "background:var(--dsw-alias-bg-layer-2,#282d3a);color:inherit;font:inherit;cursor:pointer;" +
+        "width:100%;padding:10px 12px;border-radius:10px;text-align:left;border:1px solid var(--dsw-alias-border-l2,rgba(255,255,255,.22));" +
+        "background:var(--dsw-alias-bg-layer-2,#282d3a);background-image:linear-gradient(var(--wf-lift),var(--wf-lift));" +
+        "color:inherit;font:inherit;cursor:pointer;" +
         "border-left:3px solid transparent;box-sizing:border-box}",
       ".wf-unit-card:hover{border-color:var(--dsw-alias-border-l2,rgba(255,255,255,.22));" +
-        "background:var(--dsw-alias-bg-layer-1,#232733)}",
+        "background:var(--dsw-alias-bg-layer-1,#232733);background-image:linear-gradient(var(--wf-lift-2),var(--wf-lift-2))}",
       ".wf-unit-card:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#5b8cff);outline-offset:1px}",
       ".wf-unit-card[data-selected='true']{border-color:var(--dsw-alias-brand-primary,#5b8cff)}",
       ".wf-unit-card[data-active='true']{border-left-color:var(--dsw-alias-brand-primary,#5b8cff)}",
@@ -1370,6 +1386,22 @@ window.__ModuleLoader__.load({
       return "/dsh-workflow/state?sessionId=" + encodeURIComponent(String(sessionId));
     }
 
+    /**
+     * May the poll loop re-arm after this result?
+     *
+     * A tick aborts the request it replaces, and an aborted request resolves as status -1.
+     * That is the ORDINARY path whenever a poll outlives its interval, so -1 must not end
+     * the loop: it only defers to the replacement that is already in the air. Returning
+     * false there is what keeps two loops from running; returning false for anything else
+     * (a real error, a 4xx) would stop the panel from ever updating again.
+     *
+     * Extracted from the hook so the rule is testable without a renderer.
+     */
+    function wfPollContinues(result, inflight) {
+      if (!result || result.status !== -1) return true;
+      return wfFinite(inflight) === null ? true : inflight <= 0;
+    }
+
     /**
      * One conditional GET. Never throws: every outcome is a value, so the loop can
      * always decide what to render and how long to wait.
@@ -1560,6 +1592,9 @@ window.__ModuleLoader__.load({
         }
       }
       return {
+     // A finished plan must not decide a card's status any more; the summary carries
+     // the flag so the status policy can stand down without re-reading the phase.
+        terminal: plan.terminal === true,
         statuses: plan.statuses && typeof plan.statuses === "object" ? plan.statuses : {},
         anchorSeqs: plan.anchorSeqs && typeof plan.anchorSeqs === "object" ? plan.anchorSeqs : {},
         skipped: Array.isArray(plan.skipped) ? plan.skipped.slice() : [],
@@ -2073,7 +2108,10 @@ window.__ModuleLoader__.load({
           errorText: typeof found.error === "string" ? found.error.slice(0, 200) : "",
           seq: wfFinite(found.seq),
           error: typeof found.error === "string" && found.error !== "",
-          result: typeof found.resultHead === "string" && found.resultHead !== "",
+          // The host's result boolean is the settled fact: a call that returned with an EMPTY body is
+          // settled. Falling back to resultHead alone marked such a call unsettled, so the panel kept
+          // it in the "calling right now" state and its dot pulsed after the call had already returned.
+          result: found.result === true || (typeof found.resultHead === "string" && found.resultHead !== ""),
           durationMs: wfFinite(found.durationMs),
           at: wfFinite(found.at),
         });
@@ -2554,7 +2592,17 @@ window.__ModuleLoader__.load({
      * working session as idle (which would make the curve and the frame look broken).
      */
     function wfSessionRunning(view, activeNodeId, nowMs) {
-      if (view && typeof view.running === "boolean") return view.running;
+      // The clock is the second witness. view.running is the turn flag, and a turn that never
+      // received its turn/end event (interrupt, crash, a compacted session) leaves it true forever.
+      // Once the last folded event is older than the idle window the session is not working,
+      // whatever the flag says.
+      if (view && typeof view.running === "boolean") {
+        if (view.running !== true) return false;
+        var flagAsOf = wfFinite(view.asOf);
+        var flagNow = wfFinite(nowMs);
+        if (flagAsOf !== null && flagAsOf > 0 && flagNow !== null && flagNow - flagAsOf >= WF_IDLE_AFTER_MS) return false;
+        return true;
+      }
       if (typeof activeNodeId === "string" && activeNodeId !== "") return true;
       var asOf = wfFinite(view && view.asOf);
       if (asOf === null || asOf <= 0) return false;
@@ -2653,7 +2701,7 @@ window.__ModuleLoader__.load({
      * "0 seconds ago" would be a fabricated number, which is exactly what this plugin
      * refuses to print.
      *
-     * (2026-10-26) · the projected REMAINING half is GONE by user request. It used to be shipped
+     * The projected REMAINING half is no longer part of this rail. It used to be shipped
      * by the host as a derived millisecond field (median of the finished steps, hard-bounded) and
      * rendered as "remaining ~N minutes"; the host no longer computes it and this rail no longer renders it.
      * One line, one fact, no consumer-less field — and a payload that still carries that field (an
@@ -3254,8 +3302,11 @@ window.__ModuleLoader__.load({
      */
     function wfDeriveStepStatus(row, plan, todoIndex, currentPlanIndex) {
       var planIndex = row && wfFinite(row.planIndex) !== null ? Math.round(row.planIndex) : null;
+     // A finished plan (completed / aborted) is history: its statuses and anchor
+     // cursor describe a turn that is over, so the todo table and the host decide.
+      var live = plan && plan.terminal !== true;
 
-      if (plan && planIndex !== null) {
+      if (live && planIndex !== null) {
      // 1. PAE's own statuses are the published truth.
         var label = wfHasKey(plan.statuses, String(planIndex)) ? plan.statuses[String(planIndex)] : null;
         var fromPae = wfCanonicalStatus(label);
@@ -7788,6 +7839,9 @@ window.__ModuleLoader__.load({
       "panel.planning.note": "计划尚未提交，提交后会显示分步。",
       "panel.collapse": "收起",
       "panel.expand": "展开",
+      "panel.refresh": "刷新",
+      "panel.refresh.hint": "立即重新读取这一步的状态（自动刷新每 0.8 秒一次，这里是不等它的手动兜底）",
+      "panel.refresh.done": "已刷新",
       "panel.settings": "设置",
       "panel.steps": "总任务分步",
       "panel.flow": "分步流程",
@@ -7998,6 +8052,9 @@ window.__ModuleLoader__.load({
       "panel.planning.note": "The plan has not been submitted yet; steps appear after it is.",
       "panel.collapse": "Collapse",
       "panel.expand": "Expand",
+      "panel.refresh": "Refresh",
+      "panel.refresh.hint": "Read this step's state again now (auto-refresh runs every 0.8 s; this is the manual fallback)",
+      "panel.refresh.done": "Refreshed",
       "panel.settings": "Settings",
       "panel.steps": "Task steps",
       "panel.flow": "Step flow",
@@ -8277,6 +8334,10 @@ window.__ModuleLoader__.load({
       });
       var snap = pair[0];
       var setSnap = pair[1];
+     // The running loop's own tick, so the header's refresh button can pull once on
+     // demand without waiting for the interval. A ref, not state: swapping the function
+     // must not re-render, and a click must never restart the effect.
+      var tickRef = React.useRef(null);
 
       React.useEffect(
         function () {
@@ -8289,6 +8350,9 @@ window.__ModuleLoader__.load({
           var timer = 0;
           var controller = null;
           var etag = "";
+     // How many requests are in the air. A replaced request resolves as -1 and must
+     // not re-arm while the newer one is still going, or two loops would run.
+          var inflight = 0;
 
           setSnap({ status: "loading", view: null, rev: null, error: "" });
 
@@ -8313,11 +8377,20 @@ window.__ModuleLoader__.load({
             }
             controller = typeof AbortController === "function" ? new AbortController() : null;
             var signal = controller ? controller.signal : undefined;
+            inflight += 1;
             wfPollOnce(window.fetch, wfPollUrl(sessionId), etag, signal).then(function (result) {
+              inflight -= 1;
               if (stopped) return;
-     // -1 = this request was aborted by a newer one (visibility change): the
-     // newer tick already owns the loop, so stay silent and do not re-arm.
-              if (result.status === -1) return;
+     // -1 = this request was aborted. A tick aborts the request it replaces, so this
+     // is the ORDINARY path on a slow link, not an exception: returning here without
+     // re-arming stopped the loop for good the first time a poll outlived its tick —
+     // the map then froze while the session kept working, which is the reported
+     // "the map does not update by itself". Only the deliberate stop (stopped) ends it.
+              if (result.status === -1) {
+     // A replaced request: re-arm only when no replacement is still in the air.
+                if (wfPollContinues(result, inflight)) schedule(delay);
+                return;
+              }
               if (result.status === 304) {
                 setSnap(function (prev) {
                   return prev.view ? { status: "live", view: prev.view, rev: prev.rev, error: "" } : prev;
@@ -8350,10 +8423,12 @@ window.__ModuleLoader__.load({
             tick();
           }
 
+          tickRef.current = tick;
           tick();
           document.addEventListener("visibilitychange", onVisibilityChange);
           return function () {
             stopped = true;
+            tickRef.current = null;
             window.clearTimeout(timer);
             if (controller && typeof controller.abort === "function") {
               try {
@@ -8368,7 +8443,18 @@ window.__ModuleLoader__.load({
         [sessionId]
       );
 
-      return snap;
+     // One object, not two returns: every caller already reads the snapshot field by field,
+     // so the refresh hook rides along without changing the shape they destructure.
+      return {
+        status: snap.status,
+        view: snap.view,
+        rev: snap.rev,
+        error: snap.error,
+        refresh: function () {
+          var pull = tickRef.current;
+          if (typeof pull === "function") pull();
+        },
+      };
     }
 
     /** The stylesheet lives exactly as long as the mount. */
@@ -8388,6 +8474,25 @@ window.__ModuleLoader__.load({
       }, []);
     }
 
+    /**
+     * Clear a "just happened" stamp after a moment, so the button returns to its own
+     * glyph. One timer, cleared on unmount and on a second click (the stamp changes).
+     */
+    function wfUseFlashClear(stamp, clear) {
+      React.useEffect(
+        function () {
+          if (!(stamp > 0)) return undefined;
+          var timer = window.setTimeout(function () {
+            clear();
+          }, 1200);
+          return function () {
+            window.clearTimeout(timer);
+          };
+        },
+        [stamp]
+      );
+    }
+
     /** Alt+W toggles the collapsed state; the listener is removed on unmount. */
     function wfUseAltW(updatePrefs) {
       React.useEffect(function () {
@@ -8780,6 +8885,15 @@ window.__ModuleLoader__.load({
       var prefs = prefsHandle.prefs;
       var updatePrefs = prefsHandle.update;
       var snap = wfUseSnap(sessionId);
+     // When the header's refresh was last clicked; drives the one-word acknowledgement
+     // that clears itself. Deliberately NOT the poll's own state: a click must not look
+     // like a data change.
+      var refreshedPair = React.useState(0);
+      var refreshed = refreshedPair[0];
+      var setRefreshed = refreshedPair[1];
+      wfUseFlashClear(refreshed, function () {
+        setRefreshed(0);
+      });
       var settingsPair = React.useState(false);
       var settingsOpen = settingsPair[0];
       var setSettingsOpen = settingsPair[1];
@@ -8878,6 +8992,13 @@ window.__ModuleLoader__.load({
         onToggleSettings: function () {
           setSettingsOpen(!settingsOpen);
         },
+     // The manual fallback: one pull, now, without waiting for the interval and without
+     // touching the loop. It reads the same endpoint with the same validator, so a click
+     // is a normal poll and never a second data path.
+        onRefresh: function () {
+          setRefreshed(Date.now());
+          if (typeof snap.refresh === "function") snap.refresh();
+        },
      // Clicking a main-flow unit: it becomes the SELECTED step (store.js builds its detail) and the
      // right page opens on it. It deliberately does not expand anything in place.
      // right page opens on it. It deliberately does not expand anything in place.
@@ -8956,6 +9077,7 @@ window.__ModuleLoader__.load({
 
       return wfRenderPanel(model, prefs, say, actions, {
         settingsOpen: settingsOpen,
+        refreshed: refreshed,
         status: snap.status,
         error: snap.error,
         rev: snap.rev,
@@ -8996,6 +9118,9 @@ window.__ModuleLoader__.load({
       var pendingCount = wfPendingInjectCount(model.injects);
       var extras = ui || {};
       var fire = actions || {};
+     // The refresh button's one-second acknowledgement, handed in by the component: the
+     // renderer stays pure, so a self-test can drive it with a fixed stamp.
+      var refreshed = wfFinite(extras.refreshed) === null ? 0 : extras.refreshed;
      // the two attributes the living layer needs. `motion` comes from the system's
      // prefers-reduced-motion preference (pulse.js), `idle` from the model's running flag.
      // Both live on .wf-root so the capsule is covered as well as the panel.
@@ -9095,6 +9220,24 @@ window.__ModuleLoader__.load({
         h(
           "div",
           { className: "wf-btns", key: "btns" },
+     // First in the row: it is the escape hatch when the automatic poll is not
+     // delivering, so it must not be the hard one to find.
+          h(
+            "button",
+            {
+              type: "button",
+              key: "refresh",
+              className: refreshed > 0 ? "wf-btn wf-btn-ok" : "wf-btn",
+              "data-dsh-workflow-map": "refresh",
+              "data-refreshed": refreshed > 0 ? "true" : undefined,
+              title: say("panel.refresh.hint"),
+              "aria-label": say("panel.refresh"),
+              onClick: function () {
+                wfFire(fire.onRefresh);
+              },
+            },
+            refreshed > 0 ? say("panel.refresh.done") : "↻"
+          ),
           h(
             "button",
             {
@@ -9565,6 +9708,7 @@ window.__ModuleLoader__.load({
       sessionIdFromSnapshot: wfSessionIdFromSnapshot,
       pollUrl: wfPollUrl,
       pollOnce: wfPollOnce,
+      pollContinues: wfPollContinues,
       parsePrefs: wfParsePrefs,
       sanitizePrefs: wfSanitizePrefs,
       applyPrefsPatch: wfApplyPrefsPatch,

package/cordis.patch.yml

@@ -1,8 +1,8 @@
 # dsh-workflow-map — bundle 挂载声明
 #
-# 本文件只做一件事：把这个包的宿主半插入 DSH 的插件行。
-# 浏览器半不需要单独声明 —— 它由 package.json 的 `dsh.client`（platform: web）指向
-# 本包的 ./client，所以这里没有 client 行。
+# 作用：把这个包的宿主半插入 DSH 的插件行。
+# 浏览器半不由本文件声明 —— package.json 的 `dsh.client`（platform: web）指向本包的
+# ./client，因此这里没有 client 行。
 #
 # id 在整个 profile 的 patch 层里必须唯一。
 

package/docs/OPEN-SOURCE-GUIDE.md

@@ -23,8 +23,8 @@
 | `locale/` / `icon.svg` | 词典与图标 |
 | `tools/` | 自测、探针、浏览器量测（**不随 npm 包发布**，进 Git） |
 
-**发布前必改**：`package.json` 里三处 `YOUR_GITHUB_USERNAME`（`repository.url`、`homepage`、`bugs.url`）
-替换成真实用户名。
+**发布前核对**：`package.json` 里 `repository.url`、`homepage`、`bugs.url` 三处必须指向真实的 GitHub 用户名与仓库名；
+仓库改名或 fork 后要同步改这三处。
 
 ---
 
@@ -36,7 +36,7 @@
 
 在 <https://github.com/new> 建一个**空**仓库，仓库名与 `package.json` 的 `name` 一致。
 
-⚠️ **不要**勾选 "Add a README / .gitignore / license"——本地已有，勾选会导致首次推送冲突。
+⚠️ **不要**勾选 "Add a README / .gitignore / license"：本地已有，勾选会导致首次推送冲突。
 
 ### 2.2 初始化并推送
 
@@ -87,8 +87,8 @@ pnpm pack --dry-run
 
 - 第一行为 `package: dsh-workflow-map@<版本>`；
 - 含 `client.js`、`lib/`、`src/`、`index.js`、`cordis.patch.yml`、`locale/*.json`、`icon.svg`、
-  `README.md`、`CHANGELOG.md`、`LICENSE`、`docs/OPEN-SOURCE-GUIDE.md`；
-- **不含** `tools/`、`evidence/`、`*.bak*`、任何个人文档。
+  `README.md`、`CHANGELOG.md`、`LICENSE`、`docs/OPEN-SOURCE-GUIDE.md`、`docs/host-compatibility.md`；
+- **不含** `tools/`、`evidence/`、`*.bak*` 与本地草稿。
 
 `files[]` 是白名单：以**文件**（而非目录）列出，能避免整目录被连带发布。
 
@@ -168,7 +168,7 @@ node tools/probe-route.mjs            # 真实 HTTP 路由
 node tools/probe-steer.mjs            # 注入 / 撤回通道
 ```
 
-合计 **1507 条离线断言**。也可一条命令：
+合计 **1533 条离线断言**。也可一条命令：
 
 ```bash
 npm test
@@ -196,7 +196,7 @@ pwsh -File tools/measure-settings.ps1  # 设置卡与导出
 pwsh -File tools/measure-main.ps1      # 单页几何与交互
 ```
 
-合计 **308 条浏览器量测**。
+合计 **323 条浏览器量测**（0.3.4 起 `measure-main` 另含 15 条浅色/深色主题对比检查）。
 
 > `tools/retired/` 里是量「已移除界面」的历史脚本，**不属于验证链**，不期望通过。
 
@@ -248,7 +248,7 @@ dsh-workflow-map/
 ├─ client.js             生成物，禁止手改
 ├─ cordis.patch.yml      挂载声明
 ├─ locale/{zh,en}.json   词典
-├─ docs/                 本文件
+├─ docs/                 发布指南与宿主兼容性核验
 ├─ tools/                自测 · 探针 · 浏览器量测
 ├─ CHANGELOG.md
 ├─ LICENSE (MIT)