@mingmaple/dsh-handover 0.9.22 → 1.0.0

package/src/client.js

@@ -1,995 +1,1029 @@
-/**
- * dsh-handover 浏览器半：在「设置 → 交接」注册一个只读状态页。
- * 手工构建的 DSH client bundle（不用 JSX/打包器）：只 require react，
- * 数据来自宿主侧注册的 GET /dsh-handover/status.json（只读、不唤醒任何会话）。
- *
- * 改了这个文件要重建 dist 并在 DSH 里重新激活插件（client bundle 不热更）。
- */
-window.__ModuleLoader__.load({
-  id: '@mingmaple/dsh-handover',
-  factory: (require) => {
-    var module = { exports: {} };
-    var exports = module.exports;
-    Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-
-    const React = require("react");
-    const h = React.createElement;
-    /** 参与槽位注册的服务；connection＝DSH 认证的 /api 载体（设置页取数的主通道）。 */
-    const inject = ["slots", "connection"];
-    let connection = null;
-
-    /** 数据接口候选：绝对路径优先，再退相对（页面挂在子路径时仍能取到）。 */
-    const ENDPOINTS = ["/dsh-handover/status.json", "dsh-handover/status.json"];
-
-    const CSS_TAG_ID = "@mingmaple/dsh-handover/SettingsSection.css";
-    const CSS = [
-      ".dshh-root{display:flex;flex-direction:column;gap:14px;max-width:860px;color:var(--dsw-alias-label-primary);font-size:13px;line-height:1.55}",
-      ".dshh-head{display:flex;align-items:center;gap:10px;flex-wrap:wrap}",
-      ".dshh-title{margin:0;font-size:16px;font-weight:600}",
-      ".dshh-muted{color:var(--dsw-alias-label-tertiary)}",
-      ".dshh-btn{font:inherit;cursor:pointer;background:0 0;color:var(--dsw-alias-label-primary);border:.5px solid var(--dsw-alias-border-l2);border-radius:6px;padding:3px 10px}",
-      ".dshh-btn:disabled{opacity:.5;cursor:default}",
-      ".dshh-card{border:.5px solid var(--dsw-alias-border-l2);border-radius:8px;padding:10px 12px;display:flex;flex-direction:column;gap:8px}",
-      ".dshh-cardTitle{margin:0;font-weight:600;font-size:13px}",
-      ".dshh-grid{display:grid;grid-template-columns:auto 1fr;gap:4px 14px}",
-      ".dshh-k{color:var(--dsw-alias-label-tertiary)}",
-      ".dshh-table{width:100%;border-collapse:collapse;table-layout:fixed}",
-      ".dshh-table th,.dshh-table td{text-align:left;padding:3px 6px;border-bottom:.5px solid var(--dsw-alias-border-l2);font-size:12px;white-space:normal;overflow-wrap:anywhere;vertical-align:middle}",
-      ".dshh-table th{white-space:nowrap;font-weight:600}",
-      ".dshh-num{white-space:nowrap}",
-      ".dshh-foot{display:flex;align-items:center;gap:8px;flex-wrap:wrap;margin-top:6px}",
-      ".dshh-pick{display:flex;align-items:center;gap:6px;flex-wrap:wrap}",
-      ".dshh-inputSm{font:inherit;font-size:12px;padding:2px 6px;border:.5px solid var(--dsw-alias-border-l2);border-radius:6px;background:0 0;color:var(--dsw-alias-label-primary);box-sizing:border-box;width:100%}",
-      ".dshh-ok{color:var(--dsw-alias-state-business-primary,#1a7f37)}",
-      ".dshh-bad{color:var(--dsw-alias-state-error-primary,#c62828)}",
-      ".dshh-warn{color:var(--dsw-alias-state-warning-primary,#b26a00)}",
-      ".dshh-list{margin:0;padding-left:18px}",
-      ".dshh-sub{margin:6px 0 2px;font-weight:600;color:var(--dsw-alias-label-primary)}",
-      ".dshh-sum{cursor:pointer;color:var(--dsw-alias-label-tertiary);font-size:12px}",
-      ".dshh-wrap td{white-space:normal}",
-      ".dshh-input{font:inherit;width:100%;box-sizing:border-box;padding:5px 8px;border:.5px solid var(--dsw-alias-border-l2);border-radius:6px;background:0 0;color:var(--dsw-alias-label-primary)}",
-      ".dshh-row{display:flex;gap:8px;align-items:center;flex-wrap:wrap;margin-top:2px}",
-      ".dshh-textarea{font:inherit;width:100%;box-sizing:border-box;padding:6px 8px;border:.5px solid var(--dsw-alias-border-l2);border-radius:6px;background:0 0;color:var(--dsw-alias-label-primary);resize:vertical}",
-      ".dshh-code{font-family:ui-monospace,Consolas,monospace;font-size:12px}",
-    ].join("");
-
-    /** 注入样式（按 tagId 去重，插件重复激活时不会堆叠）。 */
-    function installCss() {
-      if (typeof document === "undefined") return;
-      if (document.querySelector('style[data-plugin-css="' + CSS_TAG_ID + '"]') !== null) return;
-      const tag = document.createElement("style");
-      tag.dataset.plugin = "@mingmaple/dsh-handover";
-      tag.dataset.pluginCss = CSS_TAG_ID;
-      tag.textContent = CSS;
-      document.head.appendChild(tag);
-    }
-
-    /** 带超时的 fetch（旧通道回退用；没有超时就会永远「读取中」）。 */
-    async function fetchWithTimeout(url, opts, ms) {
-      const ac = new AbortController();
-      const timer = setTimeout(() => ac.abort(), ms || 8000);
-      try {
-        return await fetch(url, Object.assign({ signal: ac.signal }, opts || {}));
-      } finally {
-        clearTimeout(timer);
-      }
-    }
-
-    /** 依次尝试候选地址取状态；全失败时抛出带全部原因的错。 */
-    async function fetchStatus() {
-      const reasons = [];
-      for (const url of ENDPOINTS) {
-        try {
-          const res = await fetchWithTimeout(url, { cache: "no-store", headers: { accept: "application/json" } }, 30000);
-          if (!res.ok) { reasons.push(url + " → HTTP " + res.status); continue; }
-          return await res.json();
-        } catch (e) {
-          reasons.push(url + " → " + (e && e.message ? e.message : String(e)));
-        }
-      }
-      throw new Error(reasons.join("；") || "无法取得状态");
-    }
-
-    /** 通道诊断（显示于页面；出现异常时可直接定位，无需推测）。 */
-    const diag = { lastError: "" };
-
-    /** 页面级快照缓存：设置页切走再切回时先渲染旧读数，再后台刷新（不出现「正在读取」）。 */
-    const state = { last: null };
-
-    /** 读数时间保留完整值（含年份与时区），与页头一致。 */
-    function shortTime(s) {
-      return String(s || "");
-    }
-
-    /** 会话短号：去掉 session- 前缀，留前 8 位。 */
-    function shortSid(s) {
-      return String(s || "").replace(/^session-/, "").slice(0, 8);
-    }
-
-    /**
-     * 可折叠表格：先显示 pageSize 行，点击「再展开」继续追加 pageSize 行。
-     * 列宽由 widths 百分比给定（表头固定、不横向滚动）。
-     */
-    function Folded(props) {
-      const rows = props.rows || [];
-      const size = props.pageSize || 5;
-      const [shown, setShown] = React.useState(size);
-      const visible = rows.slice(0, shown);
-      const rest = rows.length - visible.length;
-      const more = rest > 0
-        ? h("button", { className: "dshh-btn", type: "button", onClick: () => setShown(shown + size) }, "再展开 " + Math.min(size, rest) + " 个")
-        : null;
-      const fold = shown > size
-        ? h("button", { className: "dshh-btn", type: "button", onClick: () => setShown(size) }, "收起")
-        : null;
-      return h(React.Fragment, null,
-        h("table", { className: "dshh-table" },
-          h("colgroup", null, (props.widths || []).map((w, i) => h("col", { key: i, style: { width: w } }))),
-          h("thead", null, h("tr", null, (props.cols || []).map((c, i) => h("th", { key: i }, c)))),
-          h("tbody", null, visible.map((r, i) => props.render(r, i)))),
-        rows.length > size
-          ? h("div", { className: "dshh-foot" },
-            h("span", { className: "dshh-muted" }, "共 " + rows.length + " 个，已显示 " + visible.length + " 个"),
-            more, fold)
-          : null);
-    }
-
-    function carrierKind() {
-      const conn = connection;
-      if (!conn) return "无 connection";
-      if (!conn.rpc) return "无 connection.rpc";
-      if (typeof conn.rpc.call !== "function") return "无 rpc.call";
-      return "可用（参数 " + (conn.rpc.call.length || "?") + "）";
-    }
-
-    /** 与超时竞速：宿主 rpc.call 不理会 AbortSignal，仅中止请求无法结束等待，页面会停在「读取中」。 */
-    function raceTimeout(promise, ms, label) {
-      return new Promise((resolve, reject) => {
-        const timer = setTimeout(() => reject(new Error(label + " 超时 " + ms + " ms")), ms);
-        Promise.resolve(promise).then(
-          (v) => { clearTimeout(timer); resolve(v); },
-          (e) => { clearTimeout(timer); reject(e); },
-        );
-      });
-    }
-
-    /** 主通道：DSH 认证的 /api 载体（宿主 registerRpcCarrier 注册）。 */
-    async function rpc(method, payload, ms) {
-      const conn = connection;
-      // 必须保留 this=connection.rpc：宿主用 this 拼目标，换成别的对象会得到
-      // "[object Object]/api" 并报 invalid RPC target。
-      const rpcObj = conn && conn.rpc && typeof conn.rpc.call === "function" ? conn.rpc : null;
-      if (!rpcObj) throw new Error("宿主没有 connection.rpc（载体=" + carrierKind() + "）");
-      // 不用 AbortController 主动中止：宿主处理可能超过 8 秒，只做与超时竞速，
-      // 让请求在宿主侧自然完成，慢一点也能拿到结果。
-      const ac = new AbortController();
-      const limit = ms || 30000;
-      const t0 = Date.now();
-      try {
-        // 签名（与 dsh-im 一致）：connection.rpc.call(target, endpoint, call, signal)，且 this 必须是 connection.rpc。
-        let r;
-        try {
-          r = await raceTimeout(
-            rpcObj.call("/api", "dsh-handover", { method: method, payload: payload || {} }, ac.signal),
-            limit + 500,
-            "载体",
-          );
-        } catch (e) {
-          if (!/invalid RPC target/i.test(String(e && e.message ? e.message : e))) throw e;
-          // 退一步：有的宿主把 target 预置在 rpc 上，只收 (endpoint, call, signal)
-          r = await raceTimeout(
-            rpcObj.call("dsh-handover", { method: method, payload: payload || {} }, ac.signal),
-            limit + 500,
-            "载体",
-          );
-        }
-        if (!r || r.ok !== true) {
-          const err = (r && r.error) || {};
-          throw new Error(String(err.message || "载体返回失败"));
-        }
-        return r.value;
-      } catch (e) {
-        diag.lastError = "载体：" + String(e && e.message ? e.message : e) + "（耗时 " + (Date.now() - t0) + " ms）";
-        throw e;
-      }
-    }
-
-    /** 写操作：先载体，失败再退 HTTP；成功统一补 ok:true，失败抛错。 */
-    async function post(method, payload, ms) {
-      try {
-        const v = await rpc(method, payload, ms || 20000);
-        return Object.assign({ ok: true }, v && typeof v === "object" ? v : { value: v });
-      } catch (e1) {
-        try {
-          const b = await postJson("/dsh-handover/" + method, payload);
-          return Object.assign({ ok: true }, b && typeof b === "object" ? b : { value: b });
-        } catch (e2) {
-          throw new Error(String(e1 && e1.message ? e1.message : e1) + "（HTTP 回退也失败：" + String(e2 && e2.message ? e2.message : e2) + "）");
-        }
-      }
-    }
-
-    /** POST JSON：同样先绝对路径再相对路径。 */
-    async function postJson(pathname, payload) {
-      const reasons = [];
-      for (const base of ["", "."]) {
-        const url = base + pathname;
-        try {
-          const res = await fetchWithTimeout(url, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(payload || {}) }, 15000);
-          let body = null;
-          try { body = await res.json(); } catch (e) { body = null; }
-          if (body) return body;
-          reasons.push(url + " → HTTP " + res.status);
-        } catch (e) {
-          reasons.push(url + " → " + (e && e.message ? e.message : String(e)));
-        }
-      }
-      throw new Error(reasons.join("；"));
-    }
-
-    function card(title, children) {
-      return h("section", { className: "dshh-card" }, h("h3", { className: "dshh-cardTitle" }, title), children);
-    }
-
-    function kv(rows) {
-      const kids = [];
-      rows.forEach((r, i) => {
-        kids.push(h("div", { className: "dshh-k", key: "k" + i }, r[0]));
-        kids.push(h("div", { key: "v" + i }, r[1]));
-      });
-      return h("div", { className: "dshh-grid" }, kids);
-    }
-
-    function verdict(el, ok) {
-      return h("span", { className: ok ? "dshh-ok" : "dshh-bad" }, el);
-    }
-
-    function fmtBytes(n) {
-      const v = Number(n) || 0;
-      if (v >= 1024 * 1024 * 1024) return (v / (1024 * 1024 * 1024)).toFixed(2) + " GB";
-      if (v >= 1024 * 1024) return (v / (1024 * 1024)).toFixed(1) + " MB";
-      if (v >= 1024) return (v / 1024).toFixed(1) + " KB";
-      return v + " B";
-    }
-
-    /** 设置页正身：只读，一个刷新按钮。 */
-    function HandoverSection() {
-      // 首屏直接用上一次的读数（切走再切回不再出现「正在读取」），后台再刷新。
-      const [data, setData] = React.useState(state.last);
-      const [err, setErr] = React.useState("");
-      const [busy, setBusy] = React.useState(false);
-      // 首次安装向导
-      const [parent, setParent] = React.useState("");
-      const [created, setCreated] = React.useState("");
-      const [setupMsg, setSetupMsg] = React.useState("");
-      const [setupBad, setSetupBad] = React.useState(false);
-      const [deployInfo, setDeployInfo] = React.useState(null);
-      const [globalMsg, setGlobalMsg] = React.useState("");
-      const [globalBad, setGlobalBad] = React.useState(false);
-      const [working, setWorking] = React.useState(false);
-      // 全局前置提示词
-      const [extra, setExtra] = React.useState("");
-      const [extraMsg, setExtraMsg] = React.useState("");
-      const [extraBad, setExtraBad] = React.useState(false);
-      const [channel, setChannel] = React.useState("");
-      // 迁移：探针 / 复制 / 状态
-      const [mvTo, setMvTo] = React.useState("");
-      const [mvBusy, setMvBusy] = React.useState(false);
-      const [mvMsg, setMvMsg] = React.useState("");
-      const [mvBad, setMvBad] = React.useState(false);
-      const [mvProbe, setMvProbe] = React.useState(null);
-      const [mvStatus, setMvStatus] = React.useState(null);
-      // 删除旧备份的确认词。
-      const [delWord, setDelWord] = React.useState("");
-
-      const load = React.useCallback(() => {
-        if (state.last) setData(state.last);
-        setBusy(true);
-        setErr("");
-        (async () => {
-          let d = null;
-          let via = "";
-          try {
-            d = await rpc("status", {}, 30000);
-            via = "载体（/api）";
-          } catch (e1) {
-            try {
-              d = await fetchStatus();
-              via = "HTTP 回退";
-            } catch (e2) {
-              const msg = "载体（" + carrierKind() + "）：" + String(e1 && e1.message ? e1.message : e1)
-                + "；HTTP 回退：" + String(e2 && e2.message ? e2.message : e2);
-              diag.lastError = msg;
-              setErr(msg);
-              setBusy(false);
-              return;
-            }
-          }
-          state.last = d;
-          setData(d);
-          setChannel(via);
-          setExtra(typeof d.extraPrompt === "string" ? d.extraPrompt : "");
-          try { setMvStatus(await rpc("move.status", {}, 8000)); } catch (e) { setMvStatus(null); }
-          setBusy(false);
-        })();
-      }, []);
-
-      const buildTree = React.useCallback(() => {
-        setWorking(true); setSetupBad(false); setSetupMsg("");
-        post("setup", { parent: parent }, 120000)
-          .then((r) => {
-            if (r && r.ok) {
-              setCreated(r.root || "");
-              setSetupMsg("已建立：目录 " + (r.created || []).length + " 个、文件 " + (r.written || []).length + " 个。下一步：注册为工作区。");
-            } else {
-              setSetupBad(true);
-              setSetupMsg((r && r.error) || "建立失败");
-            }
-          })
-          .catch((e) => { setSetupBad(true); setSetupMsg("请求未完成：" + (e && e.message ? e.message : String(e))); })
-          .then(() => setWorking(false));
-      }, [parent]);
-
-      const registerWs = React.useCallback(() => {
-        if (!created) return;
-        setWorking(true); setSetupBad(false); setSetupMsg("");
-        post("register", { path: created, title: "全局" }, 20000)
-          .then((r) => {
-            if (r && r.ok) setSetupMsg("已注册工作区：" + (r.title || "全局") + "（" + (r.id || "?") + "）。点击「刷新」后可继续。");
-            else { setSetupBad(true); setSetupMsg(((r && r.error) || "注册失败") + (r && r.hint ? "；" + r.hint : "")); }
-          })
-          .catch((e) => { setSetupBad(true); setSetupMsg("请求未完成：" + (e && e.message ? e.message : String(e))); })
-          .then(() => setWorking(false));
-      }, [created]);
-
-      // 一键部署：建文件体系、注册「全局」工作区、建「全局」会话，一次做完。
-      const deployAll = React.useCallback(() => {
-        setWorking(true); setDeployInfo(null); setSetupBad(false); setSetupMsg("");
-        post("deploy", { parent: parent }, 180000)
-          .then((r) => {
-            if (!r || !r.ok) {
-              setSetupBad(true);
-              setSetupMsg((r && r.error) || "部署失败");
-              return;
-            }
-            const parts = [];
-            parts.push("文件体系：" + r.root);
-            if (r.workspace) parts.push("工作区：「" + r.workspace.title + "」（" + r.workspace.path + "）");
-            else if (r.workspaceError) parts.push("工作区未注册：" + r.workspaceError);
-            if (r.sessionId) parts.push("全局会话：" + r.sessionId + "。在左侧「" + (r.workspace ? r.workspace.title : "全局") + "」工作区打开它即可开始。");
-            else if (r.sessionError) parts.push("会话未创建：" + r.sessionError);
-            setCreated(r.root || "");
-            setDeployInfo({ text: parts.join("；"), bad: false });
-            load();
-          })
-          .catch((e) => { setSetupBad(true); setSetupMsg("请求未完成：" + (e && e.message ? e.message : String(e))); })
-          .then(() => setWorking(false));
-      }, [parent, load]);
-
-      // 工作区已接入但没有全局会话时，补建一个。
-      const makeGlobalSession = React.useCallback(() => {
-        setWorking(true); setGlobalBad(false); setGlobalMsg("");
-        post("global-session", {}, 60000)
-          .then((r) => {
-            if (r && r.ok) {
-              setGlobalMsg("已创建全局会话 " + r.sessionId + "，在左侧工作区打开它即可开始。");
-              load();
-            } else {
-              setGlobalBad(true);
-              setGlobalMsg((r && r.error) || "创建失败");
-            }
-          })
-          .catch((e) => { setGlobalBad(true); setGlobalMsg("请求未完成：" + (e && e.message ? e.message : String(e))); })
-          .then(() => setWorking(false));
-      }, [load]);
-
-      const saveExtra = React.useCallback(() => {
-        setWorking(true); setExtraBad(false); setExtraMsg("");
-        post("extra-prompt", { text: extra }, 20000)
-          .then((r) => {
-            if (r && r.ok) {
-              if (r.unchanged) setExtraMsg(r.note || "内容未变，已跳过写入。");
-              else setExtraMsg((r.chars ? "已保存，共 " + r.chars + " 字符。" : "已清空，不再注册提示段。") + (r.cacheNote ? " " + r.cacheNote : ""));
-            }
-            else { setExtraBad(true); setExtraMsg((r && r.error) || "保存失败"); }
-          })
-          .catch((e) => { setExtraBad(true); setExtraMsg("请求未完成：" + (e && e.message ? e.message : String(e))); })
-          .then(() => setWorking(false));
-      }, [extra]);
-
-      // 会话角色
-      const [roleSel, setRoleSel] = React.useState({});
-      const [roleStage, setRoleStage] = React.useState({});
-      const [roleMsg, setRoleMsg] = React.useState("");
-      const [roleBad, setRoleBad] = React.useState(false);
-
-      const setRoleValue = React.useCallback((sid, patch) => {
-        setRoleSel((prev) => {
-          const next = Object.assign({}, prev || {});
-          next[sid] = Object.assign({}, next[sid] || {}, patch);
-          return next;
-        });
-        // 改了角色就回到第一步，按钮重新显示「设置角色」。
-        setRoleStage((prev) => {
-          const next = Object.assign({}, prev || {});
-          next[sid] = "";
-          return next;
-        });
-      }, []);
-
-      const submitRole = React.useCallback((sid, role, project, task, wake) => {
-        setWorking(true); setRoleBad(false); setRoleMsg("");
-        post("role", { session_id: sid, role: role, project: project, task: task, wake: wake }, 30000)
-          .then((r) => {
-            if (r && r.ok) {
-              const liveText = r.live ? "已在当前会话生效" : "自下一轮起生效";
-              const sendText = wake
-                ? (r.delivered ? "整理指令已送达，该会话将被唤醒一轮" : ("整理指令未送达" + (r.error ? "：" + r.error : "")))
-                : "";
-              setRoleMsg("角色已设为" + (r.role || role) + "，" + liveText + (sendText ? "；" + sendText : "。"));
-              setRoleStage((prev) => {
-                const next = Object.assign({}, prev || {});
-                next[sid] = wake ? "notified" : "set";
-                return next;
-              });
-              load();
-            } else {
-              setRoleBad(true);
-              setRoleMsg((r && r.error) || "设置失败");
-            }
-          })
-          .catch((e) => { setRoleBad(true); setRoleMsg("请求未完成：" + (e && e.message ? e.message : String(e))); })
-          .then(() => setWorking(false));
-      }, [load]);
-
-      // 迁移：探针 → 复制并校验 → 状态 → 清旧备份
-      const refreshMove = React.useCallback(() => {
-        rpc("move.status", {}, 10000).then((st) => setMvStatus(st)).catch(() => {});
-      }, []);
-
-      const callMove = React.useCallback((method, payload, ms) => {
-        setMvBusy(true); setMvBad(false); setMvMsg("");
-        return rpc(method, payload, ms || 20000)
-          .then((v) => v)
-          .catch((e) => { setMvBad(true); setMvMsg(String(e && e.message ? e.message : e)); throw e; })
-          .then((v) => v, () => null)
-          .then((v) => { setMvBusy(false); return v; });
-      }, []);
-
-      const doProbe = React.useCallback(() => {
-        callMove("move.probe", { to: mvTo }, 90000).then((p) => {
-          if (!p) return;
-          setMvProbe(p);
-          setMvBad(!p.ok);
-          setMvMsg(p.ok ? "预检通过，可以开始复制。" : "预检未通过，原因见下。");
-        });
-      }, [mvTo, callMove]);
-
-      const doCopy = React.useCallback(() => {
-        callMove("move.start", { to: mvTo }, 900000).then((r) => {
-          if (!r) return;
-          setMvBad(false);
-          setMvMsg("复制与校验通过：共 " + r.report.files + " 个文件、" + fmtBytes(r.report.bytes) + "。切换脚本已生成。");
-          refreshMove();
-        });
-      }, [mvTo, callMove, refreshMove]);
-
-      const doSwitch = React.useCallback(() => {
-        callMove("move.switch", {}, 30000).then((r) => {
-          if (!r) return;
-          setMvBad(false);
-          setMvMsg(r.already
-            ? "已处于切换完成状态（原路径为链接），无需再次切换。"
-            : "已就绪：完全退出 DSH 后约 1 秒完成切换，等待 10 秒再打开。日志：" + (r.log || ""));
-          refreshMove();
-        });
-      }, [callMove, refreshMove]);
-
-      // 压缩授权：只有用户在此授权，压缩才排得进；模型不能自批。
-      const [csSid, setCsSid] = React.useState("");
-      const [csMsg, setCsMsg] = React.useState("");
-      const doGrant = React.useCallback((kind) => {
-        setWorking(true); setCsMsg("");
-        post("consent.grant", { session_id: csSid, kind: kind === "succeed" ? "succeed" : "compact" }, 15000)
-          .then((r) => {
-            if (r && r.ok) { setCsMsg("已授权会话 " + r.sessionId + "：5 分钟内可" + (r.kind === "succeed" ? "换任" : "压缩") + "一次，用后失效。"); load(); }
-            else setCsMsg("授权未完成：" + ((r && r.error) || "原因未知"));
-          })
-          .catch((e) => setCsMsg("请求未完成：" + (e && e.message ? e.message : String(e))))
-          .then(() => setWorking(false));
-      }, [csSid, load]);
-      const doGrantSid = React.useCallback((sid, kind) => {
-        setWorking(true); setCsMsg("");
-        post("consent.grant", { session_id: sid, kind: kind === "succeed" ? "succeed" : "compact" }, 15000)
-          .then((r) => {
-            if (r && r.ok) { setCsMsg("已授权会话 " + r.sessionId + "：5 分钟内可" + (r.kind === "succeed" ? "换任" : "压缩") + "一次，用后失效。"); load(); }
-            else setCsMsg("授权未完成：" + ((r && r.error) || "原因未知"));
-          })
-          .catch((e) => setCsMsg("请求未完成：" + (e && e.message ? e.message : String(e))))
-          .then(() => setWorking(false));
-      }, [load]);
-
-      const doRevoke = React.useCallback((sid, kind) => {
-        setWorking(true); setCsMsg("");
-        post("consent.revoke", { session_id: sid, kind: kind === "succeed" ? "succeed" : "compact" }, 15000)
-          .then(() => { setCsMsg("已撤销 " + sid + " 的" + (kind === "succeed" ? "换任" : "压缩") + "授权。"); load(); })
-          .catch(() => { /* 撤销失败不影响别的 */ })
-          .then(() => setWorking(false));
-      }, [load]);
-
-      const doRetarget = React.useCallback(() => {
-        callMove("move.retarget-stage", {}, 20000).then((r) => {
-          if (!r) return;
-          if (r.already) { setMvMsg("DSH 登记已在新位置，无需修改登记。"); return; }
-          setMvBad(false);
-          setMvMsg("已就绪：DSH 退出后改写登记，每份先备份，重启后生效。日志：" + ((r.script && r.script.log) || ""));
-          refreshMove();
-        });
-      }, [callMove, refreshMove]);
-
-      const doRepair = React.useCallback(() => {
-        callMove("move.repair", {}, 20000).then((r) => {
-          if (!r) return;
-          setMvBad(false);
-          setMvMsg(r.already ? "原路径已经是链接，无需重建。" : "已重建链接：" + r.src + " 现指向 " + r.dst + "（未改动任何文件）");
-          refreshMove();
-        });
-      }, [callMove, refreshMove]);
-
-      const doCleanup = React.useCallback(() => {
-        if (String(delWord || "").trim() !== "删除") {
-          setMvBad(true);
-          setMvMsg("确认词不正确。输入「删除」后重试。");
-          return;
-        }
-        callMove("move.cleanup", { confirm: true }, 180000).then((r) => {
-          if (!r) return;
-          setMvBad(false);
-          setDelWord("");
-          setMvMsg(r.note + ((r.removed || []).length ? "：" + r.removed.join("、") : ""));
-          refreshMove();
-        });
-      }, [delWord, callMove, refreshMove]);
-
-      // 有缓存时先出一帧旧读数，再拉新数据；没有缓存才等一次。
-      React.useEffect(() => { installCss(); load(); }, []);
-
-      const head = h("div", { className: "dshh-head" },
-        h("h2", { className: "dshh-title" }, "dsh-handover"),
-        h("button", { className: "dshh-btn", onClick: load, disabled: busy, type: "button" }, busy ? (data ? "正在刷新" : "正在读取") : "刷新"),
-        diag.lastError ? h("span", { className: "dshh-bad" }, "读取失败（通道 " + (channel || carrierKind()) + "）：" + diag.lastError.slice(0, 90)) : null,
-        data ? h("span", { className: "dshh-muted" }, "读数时间 " + data.generatedAt) : null);
-
-      if (err && !data) {
-        return h("div", { className: "dshh-root" }, head,
-          h("div", { className: "dshh-bad" }, "无法取得状态：" + err),
-          h("div", { className: "dshh-muted" }, "插件刚安装时，确认已在配置中启用并重启 DSH。"));
-      }
-      if (!data) {
-        return h("div", { className: "dshh-root" }, head, h("div", { className: "dshh-muted" }, "正在读取状态数据。"));
-      }
-
-      const p = data.plugin || {};
-      const ws = data.workspace || {};
-      const gate = data.gate;
-      const ho = data.handover;
-      const ss = data.sessions;
-      const allSessions = (data.sessions && Array.isArray(data.sessions.all)) ? data.sessions.all : [];
-      const byActivity = allSessions.slice().sort((a, b) => String(b.seen || "").localeCompare(String(a.seen || "")));
-
-      // 排序原则：高频操作在前，只读数据居中，说明文字在后。
-      const sections = [];
-
-      // 一、首次安装与全局会话：未接入时给一键部署；已接入但还没有全局会话时给补建入口。
-      const setup = data.setup;
-      const notReady = !ws || ws.found === false;
-      const globalCount = Number(data.globalSessions || 0);
-      if (deployInfo) {
-        sections.push(card("部署结果", h("div", { className: deployInfo.bad ? "dshh-bad" : "dshh-ok" }, deployInfo.text)));
-      }
-      if (notReady) {
-        const msg = setupMsg ? h("div", { className: setupBad ? "dshh-bad" : "dshh-ok" }, setupMsg) : null;
-        const steps = (setup && setup.steps) || [];
-        const notes = Array.isArray(data.notes) ? data.notes : [];
-        sections.push(card("首次安装",
-          h("div", null,
-            h("div", { className: "dshh-muted" }, "本页与工具已可用；接入工作区后显示闸门、交接体检与会话水位。"),
-            h("ol", { className: "dshh-list" }, steps.map((s, i) => h("li", { key: i }, s))),
-            notes.length ? h("ul", { className: "dshh-list" }, notes.map((n, i) => h("li", { key: i }, n))) : null,
-            h("input", {
-              className: "dshh-input",
-              type: "text",
-              value: parent,
-              placeholder: "填写绝对路径：全局根 _Workspace 将建在该目录下",
-              onChange: (e) => setParent(e.target.value),
-            }),
-            h("div", { className: "dshh-row" },
-              h("button", { className: "dshh-btn", type: "button", disabled: working || !parent, onClick: deployAll }, working ? "正在部署" : "一键部署"),
-              h("button", { className: "dshh-btn", type: "button", disabled: working || !parent, onClick: buildTree }, working ? "正在建立" : "仅建立文件体系"),
-              created ? h("button", { className: "dshh-btn", type: "button", disabled: working, onClick: registerWs }, "注册为工作区") : null),
-            created ? h("div", { className: "dshh-code" }, created) : null,
-            msg)));
-      } else if (globalCount === 0) {
-        sections.push(card("全局会话",
-          h("div", null,
-            h("div", { className: "dshh-muted" }, "工作区已接入，尚无「全局」会话。点击下方按钮新建，插件会将其登记为全局角色。"),
-            h("div", { className: "dshh-muted" }, "全局根：" + (ws.root || "")),
-            h("div", { className: "dshh-row" },
-              h("button", { className: "dshh-btn", type: "button", disabled: working, onClick: makeGlobalSession }, working ? "正在创建" : "创建全局会话")),
-            globalMsg ? h("div", { className: globalBad ? "dshh-bad" : "dshh-ok" }, globalMsg) : null)));
-      }
-
-      // 二、授权：唯一合法的「用户同意」入口，置顶；只列在任会话，超过 5 个折叠。
-      const consentRows = (Array.isArray(data.consent) ? data.consent : []).filter((r) => r.onduty !== false);
-      const dutyRows = byActivity.filter((r) => r.onduty !== false);
-      const grantRow = (kind) => (r, i) => h("tr", { key: i },
-        h("td", null, r.title || "（无标题）"),
-        h("td", { className: "dshh-code dshh-num" }, shortSid(r.sid)),
-        h("td", null, h("button", {
-          className: "dshh-btn",
-          type: "button",
-          disabled: working,
-          title: r.sid,
-          onClick: () => doGrantSid(r.sid, kind),
-        }, kind === "succeed" ? "授权换任" : "授权压缩")));
-      const grantTable = (kind) => h(Folded, {
-        rows: dutyRows,
-        pageSize: 5,
-        cols: ["会话", "短号", "操作"],
-        widths: ["58%", "12%", "30%"],
-        render: grantRow(kind),
-      });
-      const authKids = [];
-      if (dutyRows.length) {
-        authKids.push(h("div", { className: "dshh-muted" }, "点击「授权压缩」后，该会话 5 分钟内可压缩一次，用后失效；也可在会话中发送 /allow-compact。"));
-        authKids.push(grantTable("compact"));
-        authKids.push(h("div", { className: "dshh-muted" }, "换任同样须授权：点击「授权换任」后 5 分钟内可换任一次；也可在会话中发送 /allow-succeed。"));
-        authKids.push(grantTable("succeed"));
-      } else {
-        authKids.push(h("div", { className: "dshh-muted" }, "暂无可点选的在任会话；可在下方直接填会话 id 授权。"));
-      }
-      authKids.push(h("div", { className: "dshh-row" },
-        h("input", {
-          className: "dshh-inputSm",
-          type: "text",
-          value: csSid,
-          placeholder: "或填写会话 id 或 8 位短号",
-          onChange: (e) => setCsSid(e.target.value),
-        }),
-        h("button", { className: "dshh-btn", type: "button", disabled: working || !csSid, onClick: () => doGrant("compact") }, working ? "正在授权" : "授权压缩"),
-        h("button", { className: "dshh-btn", type: "button", disabled: working || !csSid, onClick: () => doGrant("succeed") }, "授权换任")));
-      if (consentRows.length) {
-        authKids.push(h("div", { className: "dshh-ok" }, "有授权"));
-        authKids.push(h("table", { className: "dshh-table" },
-          h("colgroup", null, h("col", { style: { width: "62%" } }), h("col", { style: { width: "18%" } }), h("col", { style: { width: "20%" } })),
-          h("thead", null, h("tr", null, h("th", null, "已授权会话"), h("th", null, "剩余"), h("th", null, "操作"))),
-          h("tbody", null, consentRows.map((r, i) => h("tr", { key: i },
-            h("td", { className: "dshh-code", title: r.sessionId }, shortSid(r.sessionId) + (r.kind === "succeed" ? " · 换任" : " · 压缩")),
-            h("td", { className: "dshh-num" }, Math.round((r.leftMs || 0) / 1000) + " 秒"),
-            h("td", null, h("button", { className: "dshh-btn", type: "button", disabled: working, onClick: () => doRevoke(r.sessionId, r.kind) }, "撤销")))))));
-      }
-      if (csMsg) authKids.push(h("div", { className: "dshh-ok" }, csMsg));
-      sections.push(card("授权", h("div", null, authKids)));
-
-      // 三、移动全局根目录：常态折叠为一行状态。
-      {
-        const st = mvStatus;
-        const phaseLabel = {
-          none: "尚无迁移记录",
-          verified: "已复制并校验，待切换",
-          switched: "已切换，原路径为链接",
-          "switched+cleaned": "已切换，旧备份已删除",
-          partial: "校验有差异，需重新复制",
-        };
-        // 旧备份是否保留不影响使用，因此不计入「需要处理」；需要处理的只有会妨碍使用的情形。
-        const hasOlds = !!(st && st.phase === "switched" && (st.olds || []).length);
-        const attention = !!(st && (st.linkBroken || st.srcExists === false || st.phase === "verified" || st.phase === "partial" || (st.retarget && st.retarget.needed)));
-        const stateText = st
-          ? "状态：" + (phaseLabel[st.phase] || st.phase) + (st.dst ? "（" + st.dst + "）" : "") + (hasOlds ? "；旧备份保留，不影响使用" : "")
-          : "正在读取迁移状态";
-        const kids = [];
-        kids.push(h("div", { className: "dshh-muted" }, "切换只改名与建链接，不改动文件内容。"));
-        if (st && st.phase && st.phase.indexOf("switched") === 0) {
-          kids.push(h("div", { className: "dshh-muted" }, "原路径为指向新位置的链接；若已删除，可用「重建链接」恢复。"));
-        }
-        if (st && (st.srcExists === false || st.linkBroken)) {
-          kids.push(h("div", { className: "dshh-bad" }, st.linkBroken
-            ? "链接指向的新位置不存在：" + (st.dst || "") + "。应先确认真实数据位置；本页不改动文件。"
-            : "原路径不存在（可能已被删除）：" + (st.src || "") + "。数据仍在 " + (st.dst || "") + "。"));
-          if (st.canRepair) {
-            kids.push(h("div", { className: "dshh-row" },
-              h("button", { className: "dshh-btn", type: "button", disabled: mvBusy, onClick: doRepair }, "重建链接")));
-          }
-        }
-        if (st && st.phase === "verified" && st.script) {
-          kids.push(h("div", { className: "dshh-sub" }, "切换步骤"));
-          kids.push(h("ol", { className: "dshh-list" },
-            h("li", null, "点击「准备切换」，助手进入待命状态。"),
-            h("li", null, "完全退出 DSH，含托盘与后台进程。"),
-            h("li", null, "退出后自动执行，约 50 毫秒。"),
-            h("li", null, "等待 10 秒后再打开 DSH。"),
-            h("li", null, "回到本页，状态应为「已切换，原路径为链接」。")));
-          kids.push(h("div", { className: "dshh-row" },
-            h("button", { className: "dshh-btn", type: "button", disabled: mvBusy, onClick: doSwitch }, mvBusy ? "正在准备" : "准备切换（退出 DSH 后自动完成）")));
-          kids.push(h("div", { className: "dshh-muted" }, "助手未运行时手工执行：" + ((st.script && st.script.helper) || "")));
-        }
-        if (st && st.retarget && st.retarget.needed) {
-          kids.push(h("div", { className: "dshh-warn" }, "DSH 登记仍指向旧路径：" + st.retarget.total + " 处，涉及 " + st.retarget.files.length + " 个文件。"));
-          kids.push(h("div", { className: "dshh-muted" }, "退出 DSH 时改写，每份先备份；重启后生效。"));
-          kids.push(h("div", { className: "dshh-row" },
-            h("button", { className: "dshh-btn", type: "button", disabled: mvBusy, onClick: doRetarget }, "把登记迁到新位置（退出 DSH 后生效）")));
-          for (const rf of (st.retarget.files || [])) {
-            kids.push(h("div", { className: "dshh-code dshh-muted" }, rf.path + "  ×" + rf.count));
-          }
-        }
-        if (st && st.retarget && st.retarget.needed === false) {
-          kids.push(h("div", { className: "dshh-ok" }, "DSH 登记已指向新位置：" + (st.dst || "") + "。"));
-        }
-        if (hasOlds) {
-          kids.push(h("div", { className: "dshh-muted" }, "旧备份：" + st.olds.map((o) => o.path + "（" + fmtBytes(o.bytes) + "）").join("、") + "。保留不影响使用；删除后无法恢复。"));
-          kids.push(h("div", { className: "dshh-row" },
-            h("input", {
-              className: "dshh-inputSm",
-              type: "text",
-              value: delWord,
-              placeholder: "输入「删除」以确认",
-              onChange: (e) => setDelWord(e.target.value),
-            }),
-            h("button", { className: "dshh-btn", type: "button", disabled: mvBusy || delWord.trim() !== "删除", onClick: doCleanup }, "删除旧备份（不可撤销）")));
-        }
-        kids.push(h("div", { className: "dshh-row" },
-          h("input", {
-            className: "dshh-input",
-            type: "text",
-            value: mvTo,
-            placeholder: "新根目录的绝对路径",
-            onChange: (e) => setMvTo(e.target.value),
-          })));
-        kids.push(h("div", { className: "dshh-row" },
-          h("button", { className: "dshh-btn", type: "button", disabled: mvBusy || !mvTo, onClick: doProbe }, mvBusy ? "正在预检" : "预检"),
-          h("button", { className: "dshh-btn", type: "button", disabled: mvBusy || !mvTo, onClick: doCopy }, "复制并校验"),
-          h("button", { className: "dshh-btn", type: "button", disabled: mvBusy, onClick: refreshMove }, "刷新状态")));
-        if (mvProbe) {
-          kids.push(kv([
-            ["源", h("span", { className: "dshh-code" }, mvProbe.src)],
-            ["目标", h("span", { className: "dshh-code" }, mvProbe.dst)],
-            ["总大小", mvProbe.files + " 文件 · " + fmtBytes(mvProbe.bytes)],
-            ["目标盘可用", mvProbe.freeBytes === null || mvProbe.freeBytes === undefined ? "?" : fmtBytes(mvProbe.freeBytes)],
-            ["结论", mvProbe.ok ? verdict("通过", true) : verdict("不通过", false)],
-          ]));
-          for (const w of (mvProbe.warnings || [])) kids.push(h("div", { className: "dshh-warn" }, "注意：" + w));
-          for (const x of (mvProbe.problems || [])) kids.push(h("div", { className: "dshh-bad" }, "未通过：" + x));
-        }
-        if (mvMsg) kids.push(h("div", { className: mvBad ? "dshh-bad" : "dshh-ok" }, mvMsg));
-        sections.push(card("移动全局根目录",
-          h("div", null,
-            h("details", null,
-              h("summary", { className: "dshh-sum" }, (attention ? "需要处理：" : "") + stateText),
-              h("div", { className: "dshh-wrap" }, kids)))));
-      }
-
-      // 四、会话角色：按 DSH 工作区分组，默认全部折叠；组内按全局、项目、杂项、普通排列。
-      const ROLE_ORDER = { global: 0, project: 1, misc: 2, plain: 3 };
-      const byRole = byActivity.slice().sort((a, b) => {
-        const ra = ROLE_ORDER[a.role] === undefined ? 9 : ROLE_ORDER[a.role];
-        const rb = ROLE_ORDER[b.role] === undefined ? 9 : ROLE_ORDER[b.role];
-        return ra !== rb ? ra - rb : String(b.seen || "").localeCompare(String(a.seen || ""));
-      });
-      const wsList = (ss && Array.isArray(ss.workspaces)) ? ss.workspaces : [];
-      const roleGroups = [];
-      const claimed = {};
-      for (const w of wsList) {
-        const rows = byRole.filter((r) => r.wsKey === w.key);
-        claimed[w.key] = true;
-        if (rows.length) roleGroups.push({ key: w.key, title: w.title || w.path || "工作区", path: w.path || "", rows });
-      }
-      const restRows = byRole.filter((r) => !claimed[r.wsKey]);
-      if (restRows.length) roleGroups.push({ key: "", title: "未归属工作区", path: "", rows: restRows });
-      const roleRow = (r, i) => {
-        const draft = (roleSel && roleSel[r.sid]) || {};
-        const role = draft.role !== undefined ? draft.role : (r.role || "plain");
-        const project = draft.project !== undefined ? draft.project : (r.project || "");
-        const task = draft.task !== undefined ? draft.task : (r.task || "");
-        const wide = role === "project" || role === "misc";
-        const stage = (roleStage && roleStage[r.sid]) || "";
-        const action = stage === "notified"
-          ? h("button", { className: "dshh-btn", type: "button", disabled: true }, "已通知")
-          : stage === "set"
-            ? h("button", { className: "dshh-btn", type: "button", disabled: working, onClick: () => submitRole(r.sid, role, project, task, true) }, "通知该会话")
-            : h("button", { className: "dshh-btn", type: "button", disabled: working, onClick: () => submitRole(r.sid, role, project, task, false) }, "设置角色");
-        return h("tr", { key: i },
-          h("td", null, r.title || "（无标题）"),
-          h("td", { className: "dshh-code dshh-num" }, shortSid(r.sid)),
-          h("td", { className: "dshh-num" }, r.pct === null || r.pct === undefined ? "?" : r.pct.toFixed(1) + "%"),
-          h("td", null, h("select", {
-            className: "dshh-inputSm",
-            value: role,
-            onChange: (e) => setRoleValue(r.sid, { role: e.target.value }),
-          },
-            h("option", { value: "global" }, "全局"),
-            h("option", { value: "project" }, "项目"),
-            h("option", { value: "misc" }, "杂项"),
-            h("option", { value: "plain" }, "普通"))),
-          h("td", null, wide ? h("input", {
-            className: "dshh-inputSm",
-            type: "text",
-            value: role === "project" ? project : task,
-            placeholder: role === "project" ? "填写项目名" : "填写任务名",
-            onChange: (e) => setRoleValue(r.sid, role === "project" ? { project: e.target.value } : { task: e.target.value }),
-          }) : h("span", { className: "dshh-muted" }, "不需填写")),
-          h("td", null, h("div", { className: "dshh-pick" }, action)));
-      };
-      sections.push(card("会话角色",
-        h("div", null,
-          roleGroups.length
-            ? roleGroups.map((g, gi) => h("details", { key: gi },
-              h("summary", { className: "dshh-sum" }, g.title + "（" + g.rows.length + " 个会话）"),
-              h("div", { className: "dshh-wrap" },
-                g.path ? h("div", { className: "dshh-muted dshh-code" }, g.path) : null,
-                h(Folded, {
-                  rows: g.rows,
-                  pageSize: 5,
-                  cols: ["会话", "短号", "水位", "角色", "项目或任务名", "操作"],
-                  widths: ["30%", "9%", "7%", "12%", "20%", "22%"],
-                  render: roleRow,
-                }))))
-            : h("div", { className: "dshh-muted" }, "暂无可设置角色的会话。空白会话不列出。"),
-          roleMsg ? h("div", { className: roleBad ? "dshh-bad" : "dshh-ok" }, roleMsg) : null)));
-
-      // 五、全局前置提示词：默认折叠，只显示已保存字数。
-      sections.push(card("全局前置提示词",
-        h("div", null,
-          h("div", { className: "dshh-muted" }, "只注入你填写的内容，不含插件约束；对全部会话生效，留空保存即不注册提示段。"),
-          h("details", null,
-            h("summary", { className: "dshh-sum" }, "已保存 " + (extra ? extra.length : 0) + " 字符，点击编辑"),
-            h("textarea", {
-              className: "dshh-textarea",
-              rows: 6,
-              value: extra,
-              placeholder: "例如：一律用中文；改动前说明改动范围；简单任务不必拆分。",
-              onChange: (e) => setExtra(e.target.value),
-            }),
-            h("div", { className: "dshh-row" },
-              h("button", { className: "dshh-btn", type: "button", disabled: working, onClick: saveExtra }, working ? "正在保存" : "保存"),
-              h("span", { className: "dshh-muted" }, extra.length + " 字符")),
-            extraMsg ? h("div", { className: extraBad ? "dshh-bad" : "dshh-ok" }, extraMsg) : null))));
-
-      // 六、会话水位：只读数据区从这里开始；只列在任会话（全局、项目、杂项各一行）。
-      if (ss) {
-        const byRecent = (ss.rows || []).filter((r) => r.onduty !== false).slice().sort((a, b) => String(b.seen || "").localeCompare(String(a.seen || "")));
-        const waterRow = (r, i) => h("tr", { key: i },
-          h("td", null, r.dutyName || r.dutyKey || r.title || r.project || "（无名）"),
-          h("td", { className: "dshh-code dshh-num" }, shortSid(r.sid)),
-          h("td", null, r.dutyKind || r.roleLabel || ""),
-          h("td", { className: "dshh-num" }, r.pct === null || r.pct === undefined ? "?" : r.pct.toFixed(1) + "%"),
-          h("td", null, r.state),
-          h("td", null, r.active ? "活跃" : "沉默"),
-          h("td", { className: "dshh-muted dshh-num" }, shortTime(r.seen)));
-        sections.push(card("会话水位",
-          h("div", null,
-            h("div", { className: "dshh-muted" }, ss.verdict + "。活跃线 " + ss.cutoff + "，回溯 " + ss.silentHours + " 小时。"),
-            (ss.notify || []).length
-              ? h("div", null, "本轮需通知：" + ss.notify.map((r) => (r.name || r.key || "") + "（" + shortSid(r.sid) + "）").join("、"))
-              : h("div", { className: "dshh-muted" }, "本轮无需通知。"),
-            byRecent.length
-              ? h(Folded, {
-                rows: byRecent,
-                pageSize: 5,
-                cols: ["会话", "短号", "类别", "水位", "状态", "活跃", "最后活动"],
-                widths: ["20%", "11%", "7%", "8%", "8%", "7%", "31%"],
-                render: waterRow,
-              })
-              : h("div", { className: "dshh-muted" }, "暂无可显示的在任会话。"))));
-      }
-
-      // 七、通用约束条闸门
-      if (gate) {
-        const rows = (gate.libraries || []).map((r, i) => h("tr", { key: i },
-          h("td", null, r.name),
-          h("td", null, r.titleOk ? "通过" : "缺"),
-          h("td", null, (r.lines - r.missing) + "/" + r.lines),
-          h("td", null, r.waterOk ? "通过" : "缺"),
-          h("td", null, verdict(r.ok ? "通过" : "未通过", r.ok))));
-        sections.push(card("通用约束条闸门",
-          gate.error
-            ? h("div", { className: "dshh-bad" }, gate.error)
-            : h("div", null,
-              h("div", { className: "dshh-muted" }, gate.total + " 个库，正文 " + gate.bodyLines + " 行；" + gate.verdict),
-              h("table", { className: "dshh-table" },
-                h("thead", null, h("tr", null,
-                  h("th", null, "库"), h("th", null, "标题"), h("th", null, "正文"), h("th", null, "水位自查"), h("th", null, "结论"))),
-                h("tbody", null, rows)))));
-      }
-
-      // 八、交接文档体检：全局一行，项目与杂项同一张表；问题列只留问题本身。
-      if (ho) {
-        const cleanReason = (x) => String(x || "").replace(/（[^）]*）/g, "").replace(/\s+/g, " ").trim();
-        const rows = (ho.projects || []).map((r) => Object.assign({}, r, { kind: "项目" }))
-          .concat((ho.misc || []).map((r) => Object.assign({}, r, { kind: "杂项" })));
-        const prows = rows.map((r, i) => h("tr", { key: i },
-          h("td", null, r.kind),
-          h("td", null, r.name),
-          h("td", null, r.verdict === "通过" ? verdict("通过", true) : (r.verdict === "缺节" || r.verdict === "读不到" || r.verdict === "未找到") ? h("span", { className: "dshh-warn" }, r.verdict) : verdict(r.verdict, false)),
-          h("td", null, (r.reasons || []).map(cleanReason).filter(Boolean).join("；"))));
-        sections.push(card("交接文档体检",
-          h("div", null,
-            h("div", null, "全局 Global_Handover.md：", ho.global.verdict === "通过" ? verdict("通过", true) : verdict(ho.global.verdict, false),
-              (ho.global.reasons || []).length ? h("span", { className: "dshh-muted" }, (ho.global.reasons || []).map(cleanReason).filter(Boolean).join("；")) : null),
-            prows.length
-              ? h("table", { className: "dshh-table" },
-                h("thead", null, h("tr", null, h("th", null, "类别"), h("th", null, "名称"), h("th", null, "结论"), h("th", null, "问题"))),
-                h("tbody", null, prows))
-              : h("div", { className: "dshh-muted" }, "暂无已登记的项目或杂项。"))));
-      }
-
-      // 九、插件信息
-      sections.push(card("插件", kv([
-        ["名称", h("span", { className: "dshh-code" }, p.name + "@" + p.version)],
-        ["工具数", String(p.tools)],
-        ["压缩调度器", p.scheduler],
-        ["注入项", (p.inject || []).join("、")],
-        ["初始化", (p.initErrors && p.initErrors.length) ? h("span", { className: "dshh-bad" }, p.initErrors.join("；")) : verdict("正常", true)],
-        ["工作区", ws.found ? h("span", { className: "dshh-code" }, ws.root) : verdict("未接入（未找到 _Control_Center）", false)],
-      ])));
-
-      // 十、最近一次会话间通信判定：只有存在判定时才出现。
-      const g = data.guardLast;
-      if (g) {
-        sections.push(card("最近一次会话间通信判定", kv([
-          ["结论", g.allow ? verdict("允许", true) : verdict("拒绝", false)],
-          ["依据", g.source + (g.title ? "；会话标题 " + g.title : "")],
-          ["会话", h("span", { className: "dshh-code" }, g.sid || "-")],
-        ])));
-      }
-
-      // 末、工具明细与使用说明：参考性质，放最后，默认折叠。
-      const gd = data.guide;
-      if (gd) {
-        const sit = (gd.situations || []).map((r, i) => h("tr", { key: i },
-          h("td", null, r.when),
-          h("td", null, r.say),
-          h("td", { className: "dshh-muted" }, r.what)));
-        const groups = (gd.groups || []).map((gr, i) => h("div", { key: i },
-          h("div", { className: "dshh-sub" }, gr.title),
-          h("table", { className: "dshh-table" }, h("tbody", null, (gr.tools || []).map((t, j) => h("tr", { key: j },
-            h("td", { className: "dshh-code" }, t[0]),
-            h("td", { className: "dshh-muted" }, t[1])))))));
-        const toolCount = (gd.groups || []).reduce((a, gr) => a + ((gr.tools || []).length), 0);
-        if (toolCount) {
-          sections.push(card("工具明细",
-            h("details", null,
-              h("summary", { className: "dshh-sum" }, "共 " + toolCount + " 个工具，点击展开"),
-              h("div", { className: "dshh-wrap" }, groups))));
-        }
-        sections.push(card("使用说明",
-          h("details", null,
-            h("summary", { className: "dshh-sum" }, "交互方式、常见请求与约定"),
-            h("div", { className: "dshh-wrap" },
-              (gd.intro || []).map((t, i) => h("div", { key: i }, t)),
-              h("div", { className: "dshh-sub" }, "常见请求与对应动作"),
-              h("table", { className: "dshh-table" },
-                h("thead", null, h("tr", null, h("th", null, "时机"), h("th", null, "可以这样说"), h("th", null, "插件会执行的动作"))),
-                h("tbody", null, sit)),
-              h("div", { className: "dshh-sub" }, "约定"),
-              h("ul", { className: "dshh-list" }, (gd.rules || []).map((t, i) => h("li", { key: i }, t)))))));
-      }
-
-      return h("div", { className: "dshh-root" }, head, sections);
-    }
-
-    /** 把只读状态页注册进设置导航。 */
-    function apply(ctx) {
-      try { connection = (ctx && ctx.connection) || null; } catch (e) { connection = null; }
-      ctx.slots.inject("settings.section", () => ctx.slots.register({
-        name: "settings.section",
-        id: "handover",
-        order: 100,
-        label: "dsh-handover",
-      }, HandoverSection));
-    }
-
-    exports.apply = apply;
-    exports.inject = inject;
-    return module.exports;
-  },
+/**
+ * dsh-handover 浏览器侧：在「设置 → 交接」注册只读状态页。
+ * 手工构建的 DSH client bundle（不使用 JSX 与打包器）：只 require react，
+ * 数据取自宿主侧注册的 GET /dsh-handover/status.json（只读，不唤醒任何会话）。
+ *
+ * 修改本文件后须重建 dist，并在 DSH 中重新激活插件（client bundle 不热更新）。
+ */
+window.__ModuleLoader__.load({
+  id: '@mingmaple/dsh-handover',
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+    Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+
+    const React = require("react");
+    const h = React.createElement;
+    /** 参与槽位注册的服务；connection 为 DSH 认证的 /api 载体（设置页取数的主通道）。 */
+    const inject = ["slots", "connection"];
+    let connection = null;
+
+    /** 数据接口候选：优先绝对路径，其次相对路径（页面挂在子路径时仍可读取）。 */
+    const ENDPOINTS = ["/dsh-handover/status.json", "dsh-handover/status.json"];
+
+    const CSS_TAG_ID = "@mingmaple/dsh-handover/SettingsSection.css";
+    const CSS = [
+      ".dshh-root{display:flex;flex-direction:column;gap:14px;max-width:860px;color:var(--dsw-alias-label-primary);font-size:13px;line-height:1.55}",
+      ".dshh-head{display:flex;align-items:center;gap:10px;flex-wrap:wrap}",
+      ".dshh-title{margin:0;font-size:16px;font-weight:600}",
+      ".dshh-muted{color:var(--dsw-alias-label-tertiary)}",
+      ".dshh-btn{font:inherit;cursor:pointer;background:0 0;color:var(--dsw-alias-label-primary);border:.5px solid var(--dsw-alias-border-l2);border-radius:6px;padding:3px 10px}",
+      ".dshh-btn:disabled{opacity:.5;cursor:default}",
+      ".dshh-card{border:.5px solid var(--dsw-alias-border-l2);border-radius:8px;padding:10px 12px;display:flex;flex-direction:column;gap:8px}",
+      ".dshh-cardTitle{margin:0;font-weight:600;font-size:13px}",
+      ".dshh-grid{display:grid;grid-template-columns:auto 1fr;gap:4px 14px}",
+      ".dshh-k{color:var(--dsw-alias-label-tertiary)}",
+      ".dshh-table{width:100%;border-collapse:collapse;table-layout:fixed}",
+      ".dshh-table th,.dshh-table td{text-align:left;padding:3px 6px;border-bottom:.5px solid var(--dsw-alias-border-l2);font-size:12px;white-space:normal;overflow-wrap:anywhere;vertical-align:middle}",
+      ".dshh-table th{white-space:nowrap;font-weight:600}",
+      ".dshh-num{white-space:nowrap}",
+      ".dshh-foot{display:flex;align-items:center;gap:8px;flex-wrap:wrap;margin-top:6px}",
+      ".dshh-pick{display:flex;align-items:center;gap:6px;flex-wrap:wrap}",
+      ".dshh-inputSm{font:inherit;font-size:12px;padding:2px 6px;border:.5px solid var(--dsw-alias-border-l2);border-radius:6px;background:0 0;color:var(--dsw-alias-label-primary);box-sizing:border-box;width:100%}",
+      ".dshh-ok{color:var(--dsw-alias-state-business-primary,#1a7f37)}",
+      ".dshh-bad{color:var(--dsw-alias-state-error-primary,#c62828)}",
+      ".dshh-warn{color:var(--dsw-alias-state-warning-primary,#b26a00)}",
+      ".dshh-list{margin:0;padding-left:18px}",
+      ".dshh-sub{margin:6px 0 2px;font-weight:600;color:var(--dsw-alias-label-primary)}",
+      ".dshh-sum{cursor:pointer;color:var(--dsw-alias-label-tertiary);font-size:12px}",
+      ".dshh-wrap td{white-space:normal}",
+      ".dshh-input{font:inherit;width:100%;box-sizing:border-box;padding:5px 8px;border:.5px solid var(--dsw-alias-border-l2);border-radius:6px;background:0 0;color:var(--dsw-alias-label-primary)}",
+      ".dshh-row{display:flex;gap:8px;align-items:center;flex-wrap:wrap;margin-top:2px}",
+      ".dshh-textarea{font:inherit;width:100%;box-sizing:border-box;padding:6px 8px;border:.5px solid var(--dsw-alias-border-l2);border-radius:6px;background:0 0;color:var(--dsw-alias-label-primary);resize:vertical}",
+      ".dshh-code{font-family:ui-monospace,Consolas,monospace;font-size:12px}",
+    ].join("");
+
+    /** 注入样式（按 tagId 去重，插件重复激活时不会堆叠）。 */
+    function installCss() {
+      if (typeof document === "undefined") return;
+      if (document.querySelector('style[data-plugin-css="' + CSS_TAG_ID + '"]') !== null) return;
+      const tag = document.createElement("style");
+      tag.dataset.plugin = "@mingmaple/dsh-handover";
+      tag.dataset.pluginCss = CSS_TAG_ID;
+      tag.textContent = CSS;
+      document.head.appendChild(tag);
+    }
+
+    /** 带超时的 fetch（旧通道回退用；无超时则会一直停在「读取中」）。 */
+    async function fetchWithTimeout(url, opts, ms) {
+      const ac = new AbortController();
+      const timer = setTimeout(() => ac.abort(), ms || 8000);
+      try {
+        return await fetch(url, Object.assign({ signal: ac.signal }, opts || {}));
+      } finally {
+        clearTimeout(timer);
+      }
+    }
+
+    /** 依次尝试候选地址读取状态；全部失败时抛出含全部原因的错。 */
+    async function fetchStatus() {
+      const reasons = [];
+      for (const url of ENDPOINTS) {
+        try {
+          const res = await fetchWithTimeout(url, { cache: "no-store", headers: { accept: "application/json" } }, 30000);
+          if (!res.ok) { reasons.push(url + " → HTTP " + res.status); continue; }
+          return await res.json();
+        } catch (e) {
+          reasons.push(url + " → " + (e && e.message ? e.message : String(e)));
+        }
+      }
+      throw new Error(reasons.join("；") || "无法取得状态");
+    }
+
+    /** 通道诊断（显示于页面；出现异常时可直接定位，无须推测）。 */
+    const diag = { lastError: "" };
+
+    /** 页面级快照缓存：设置页切走再切回时先渲染旧读数，随后后台刷新，不出现「正在读取」。 */
+    const state = { last: null };
+
+    /** 读数时间保留完整值（含年份与时区），与页头一致。 */
+    function shortTime(s) {
+      return String(s || "");
+    }
+
+    /** 会话短号：去掉 session- 前缀，留前 8 位。 */
+    function shortSid(s) {
+      return String(s || "").replace(/^session-/, "").slice(0, 8);
+    }
+
+    /**
+     * 可折叠表格：先显示 pageSize 行，点击「再展开」继续追加 pageSize 行。
+     * 列宽由 widths 百分比给定（表头固定，不横向滚动）。
+     */
+    function Folded(props) {
+      const rows = props.rows || [];
+      const size = props.pageSize || 5;
+      const [shown, setShown] = React.useState(size);
+      const visible = rows.slice(0, shown);
+      const rest = rows.length - visible.length;
+      const more = rest > 0
+        ? h("button", { className: "dshh-btn", type: "button", onClick: () => setShown(shown + size) }, "再展开 " + Math.min(size, rest) + " 个")
+        : null;
+      const fold = shown > size
+        ? h("button", { className: "dshh-btn", type: "button", onClick: () => setShown(size) }, "收起")
+        : null;
+      return h(React.Fragment, null,
+        h("table", { className: "dshh-table" },
+          h("colgroup", null, (props.widths || []).map((w, i) => h("col", { key: i, style: { width: w } }))),
+          h("thead", null, h("tr", null, (props.cols || []).map((c, i) => h("th", { key: i }, c)))),
+          h("tbody", null, visible.map((r, i) => props.render(r, i)))),
+        rows.length > size
+          ? h("div", { className: "dshh-foot" },
+            h("span", { className: "dshh-muted" }, "共 " + rows.length + " 个，已显示 " + visible.length + " 个"),
+            more, fold)
+          : null);
+    }
+
+    function carrierKind() {
+      const conn = connection;
+      if (!conn) return "无 connection";
+      if (!conn.rpc) return "无 connection.rpc";
+      if (typeof conn.rpc.call !== "function") return "无 rpc.call";
+      return "可用（参数 " + (conn.rpc.call.length || "?") + "）";
+    }
+
+    /** 与超时竞速：宿主 rpc.call 不理会 AbortSignal，仅中止请求无法结束等待，页面会停在「读取中」。 */
+    function raceTimeout(promise, ms, label) {
+      return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(label + " 超时 " + ms + " ms")), ms);
+        Promise.resolve(promise).then(
+          (v) => { clearTimeout(timer); resolve(v); },
+          (e) => { clearTimeout(timer); reject(e); },
+        );
+      });
+    }
+
+    /** 主通道：DSH 认证的 /api 载体（由宿主 registerRpcCarrier 注册）。 */
+    async function rpc(method, payload, ms) {
+      const conn = connection;
+      // 必须保留 this=connection.rpc：宿主用 this 拼接目标，换成其他对象会得到
+      // "[object Object]/api" 并报 invalid RPC target。
+      const rpcObj = conn && conn.rpc && typeof conn.rpc.call === "function" ? conn.rpc : null;
+      if (!rpcObj) throw new Error("宿主没有 connection.rpc（载体=" + carrierKind() + "）");
+      // 不主动中止请求：宿主处理可能超过 8 秒，此处仅与超时竞速，
+      // 请求在宿主侧自然完成，耗时较长也能取得结果。
+      const ac = new AbortController();
+      const limit = ms || 30000;
+      const t0 = Date.now();
+      try {
+        // 调用签名（与 dsh-im 一致）：connection.rpc.call(target, endpoint, call, signal)。
+        // this 须为 connection.rpc。
+        let r;
+        try {
+          r = await raceTimeout(
+            rpcObj.call("/api", "dsh-handover", { method: method, payload: payload || {} }, ac.signal),
+            limit + 500,
+            "载体",
+          );
+        } catch (e) {
+          if (!/invalid RPC target/i.test(String(e && e.message ? e.message : e))) throw e;
+          // 回退处理：部分宿主将 target 预置在 rpc 上，只接受 (endpoint, call, signal)
+          r = await raceTimeout(
+            rpcObj.call("dsh-handover", { method: method, payload: payload || {} }, ac.signal),
+            limit + 500,
+            "载体",
+          );
+        }
+        if (!r || r.ok !== true) {
+          const err = (r && r.error) || {};
+          throw new Error(String(err.message || "载体返回失败"));
+        }
+        return r.value;
+      } catch (e) {
+        diag.lastError = "载体：" + String(e && e.message ? e.message : e) + "（耗时 " + (Date.now() - t0) + " ms）";
+        throw e;
+      }
+    }
+
+    /** 写操作：先走载体，失败再回退 HTTP；成功统一补 ok:true，失败抛错。 */
+    async function post(method, payload, ms) {
+      try {
+        const v = await rpc(method, payload, ms || 20000);
+        return Object.assign({ ok: true }, v && typeof v === "object" ? v : { value: v });
+      } catch (e1) {
+        try {
+          const b = await postJson("/dsh-handover/" + method, payload);
+          return Object.assign({ ok: true }, b && typeof b === "object" ? b : { value: b });
+        } catch (e2) {
+          throw new Error(String(e1 && e1.message ? e1.message : e1) + "（HTTP 回退也失败：" + String(e2 && e2.message ? e2.message : e2) + "）");
+        }
+      }
+    }
+
+    /** POST JSON：同样先绝对路径、后相对路径。 */
+    async function postJson(pathname, payload) {
+      const reasons = [];
+      for (const base of ["", "."]) {
+        const url = base + pathname;
+        try {
+          const res = await fetchWithTimeout(url, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(payload || {}) }, 15000);
+          let body = null;
+          try { body = await res.json(); } catch (e) { body = null; }
+          if (body) return body;
+          reasons.push(url + " → HTTP " + res.status);
+        } catch (e) {
+          reasons.push(url + " → " + (e && e.message ? e.message : String(e)));
+        }
+      }
+      throw new Error(reasons.join("；"));
+    }
+
+    function card(title, children) {
+      return h("section", { className: "dshh-card" }, h("h3", { className: "dshh-cardTitle" }, title), children);
+    }
+
+    function kv(rows) {
+      const kids = [];
+      rows.forEach((r, i) => {
+        kids.push(h("div", { className: "dshh-k", key: "k" + i }, r[0]));
+        kids.push(h("div", { key: "v" + i }, r[1]));
+      });
+      return h("div", { className: "dshh-grid" }, kids);
+    }
+
+    function verdict(el, ok) {
+      return h("span", { className: ok ? "dshh-ok" : "dshh-bad" }, el);
+    }
+
+    function fmtBytes(n) {
+      const v = Number(n) || 0;
+      if (v >= 1024 * 1024 * 1024) return (v / (1024 * 1024 * 1024)).toFixed(2) + " GB";
+      if (v >= 1024 * 1024) return (v / (1024 * 1024)).toFixed(1) + " MB";
+      if (v >= 1024) return (v / 1024).toFixed(1) + " KB";
+      return v + " B";
+    }
+
+    /** 设置页主体：只读，仅一个刷新按钮。 */
+    function HandoverSection() {
+      // 首屏直接使用上一次的读数（切走再切回不再出现「正在读取」），随后后台刷新。
+      const [data, setData] = React.useState(state.last);
+      const [err, setErr] = React.useState("");
+      const [busy, setBusy] = React.useState(false);
+      // 首次安装向导
+      const [parent, setParent] = React.useState("");
+      const [created, setCreated] = React.useState("");
+      const [setupMsg, setSetupMsg] = React.useState("");
+      const [setupBad, setSetupBad] = React.useState(false);
+      const [deployInfo, setDeployInfo] = React.useState(null);
+      const [globalMsg, setGlobalMsg] = React.useState("");
+      const [globalBad, setGlobalBad] = React.useState(false);
+      const [working, setWorking] = React.useState(false);
+      // 全局前置提示词
+      const [extra, setExtra] = React.useState("");
+      const [extraMsg, setExtraMsg] = React.useState("");
+      const [extraBad, setExtraBad] = React.useState(false);
+      const [channel, setChannel] = React.useState("");
+      // 迁移：预检、复制、状态
+      const [mvTo, setMvTo] = React.useState("");
+      const [mvBusy, setMvBusy] = React.useState(false);
+      const [mvMsg, setMvMsg] = React.useState("");
+      const [mvBad, setMvBad] = React.useState(false);
+      const [mvProbe, setMvProbe] = React.useState(null);
+      const [mvStatus, setMvStatus] = React.useState(null);
+      // 删除旧备份的确认词。
+      const [delWord, setDelWord] = React.useState("");
+
+      const load = React.useCallback(() => {
+        if (state.last) setData(state.last);
+        setBusy(true);
+        setErr("");
+        (async () => {
+          let d = null;
+          let via = "";
+          try {
+            d = await rpc("status", {}, 30000);
+            via = "载体（/api）";
+          } catch (e1) {
+            try {
+              d = await fetchStatus();
+              via = "HTTP 回退";
+            } catch (e2) {
+              const msg = "载体（" + carrierKind() + "）：" + String(e1 && e1.message ? e1.message : e1)
+                + "；HTTP 回退：" + String(e2 && e2.message ? e2.message : e2);
+              diag.lastError = msg;
+              setErr(msg);
+              setBusy(false);
+              return;
+            }
+          }
+          state.last = d;
+          setData(d);
+          setChannel(via);
+          setExtra(typeof d.extraPrompt === "string" ? d.extraPrompt : "");
+          try { setMvStatus(await rpc("move.status", {}, 8000)); } catch (e) { setMvStatus(null); }
+          setBusy(false);
+        })();
+      }, []);
+
+      const buildTree = React.useCallback(() => {
+        setWorking(true); setSetupBad(false); setSetupMsg("");
+        post("setup", { parent: parent }, 120000)
+          .then((r) => {
+            if (r && r.ok) {
+              setCreated(r.root || "");
+              setSetupMsg("已建立：目录 " + (r.created || []).length + " 个、文件 " + (r.written || []).length + " 个。下一步：注册为工作区。");
+            } else {
+              setSetupBad(true);
+              setSetupMsg((r && r.error) || "建立失败");
+            }
+          })
+          .catch((e) => { setSetupBad(true); setSetupMsg("请求未完成：" + (e && e.message ? e.message : String(e))); })
+          .then(() => setWorking(false));
+      }, [parent]);
+
+      const registerWs = React.useCallback(() => {
+        if (!created) return;
+        setWorking(true); setSetupBad(false); setSetupMsg("");
+        post("register", { path: created, title: "全局" }, 20000)
+          .then((r) => {
+            if (r && r.ok) setSetupMsg("已注册工作区：" + (r.title || "全局") + "（" + (r.id || "?") + "）。点击「刷新」后可继续。");
+            else { setSetupBad(true); setSetupMsg(((r && r.error) || "注册失败") + (r && r.hint ? "；" + r.hint : "")); }
+          })
+          .catch((e) => { setSetupBad(true); setSetupMsg("请求未完成：" + (e && e.message ? e.message : String(e))); })
+          .then(() => setWorking(false));
+      }, [created]);
+
+      // 一键部署：建立文件体系、注册「全局」工作区、创建「全局」会话，一次完成。
+      const deployAll = React.useCallback(() => {
+        setWorking(true); setDeployInfo(null); setSetupBad(false); setSetupMsg("");
+        post("deploy", { parent: parent }, 180000)
+          .then((r) => {
+            if (!r || !r.ok) {
+              setSetupBad(true);
+              setSetupMsg((r && r.error) || "部署失败");
+              return;
+            }
+            const parts = [];
+            parts.push("文件体系：" + r.root);
+            if (r.workspace) parts.push("工作区：「" + r.workspace.title + "」（" + r.workspace.path + "）");
+            else if (r.workspaceError) parts.push("工作区未注册：" + r.workspaceError);
+            if (r.sessionId) parts.push("全局会话：" + r.sessionId + "。在左侧「" + (r.workspace ? r.workspace.title : "全局") + "」工作区打开它即可开始。");
+            else if (r.sessionError) parts.push("会话未创建：" + r.sessionError);
+            setCreated(r.root || "");
+            setDeployInfo({ text: parts.join("；"), bad: false });
+            load();
+          })
+          .catch((e) => { setSetupBad(true); setSetupMsg("请求未完成：" + (e && e.message ? e.message : String(e))); })
+          .then(() => setWorking(false));
+      }, [parent, load]);
+
+      // 工作区已接入但尚无全局会话时，补建一个。
+      const makeGlobalSession = React.useCallback(() => {
+        setWorking(true); setGlobalBad(false); setGlobalMsg("");
+        post("global-session", {}, 60000)
+          .then((r) => {
+            if (r && r.ok) {
+              setGlobalMsg("已创建全局会话 " + r.sessionId + "，在左侧工作区打开它即可开始。");
+              load();
+            } else {
+              setGlobalBad(true);
+              setGlobalMsg((r && r.error) || "创建失败");
+            }
+          })
+          .catch((e) => { setGlobalBad(true); setGlobalMsg("请求未完成：" + (e && e.message ? e.message : String(e))); })
+          .then(() => setWorking(false));
+      }, [load]);
+
+      const saveExtra = React.useCallback(() => {
+        setWorking(true); setExtraBad(false); setExtraMsg("");
+        post("extra-prompt", { text: extra }, 20000)
+          .then((r) => {
+            if (r && r.ok) {
+              if (r.unchanged) setExtraMsg(r.note || "内容未变，已跳过写入。");
+              else setExtraMsg((r.chars ? "已保存，共 " + r.chars + " 字符。" : "已清空，不再注册提示段。") + (r.cacheNote ? " " + r.cacheNote : ""));
+            }
+            else { setExtraBad(true); setExtraMsg((r && r.error) || "保存失败"); }
+          })
+          .catch((e) => { setExtraBad(true); setExtraMsg("请求未完成：" + (e && e.message ? e.message : String(e))); })
+          .then(() => setWorking(false));
+      }, [extra]);
+
+      // 会话角色
+      const [roleSel, setRoleSel] = React.useState({});
+      const [roleStage, setRoleStage] = React.useState({});
+      const [roleMigrate, setRoleMigrate] = React.useState({});
+      const [roleMsg, setRoleMsg] = React.useState("");
+      const [roleBad, setRoleBad] = React.useState(false);
+
+      const setRoleValue = React.useCallback((sid, patch) => {
+        setRoleSel((prev) => {
+          const next = Object.assign({}, prev || {});
+          next[sid] = Object.assign({}, next[sid] || {}, patch);
+          return next;
+        });
+        // 修改角色后回到第一步，按钮重新显示「设置角色」。
+        setRoleStage((prev) => {
+          const next = Object.assign({}, prev || {});
+          next[sid] = "";
+          return next;
+        });
+      }, []);
+
+      const submitRole = React.useCallback((sid, role, project, task, wake) => {
+        const migrate = (roleMigrate && roleMigrate[sid]) || "auto";
+        setWorking(true); setRoleBad(false); setRoleMsg("");
+        post("role", { session_id: sid, role: role, project: project, task: task, wake: wake, migrate: migrate }, 30000)
+          .then((r) => {
+            if (r && r.ok) {
+              const liveText = r.live ? "已在当前会话生效" : "自下一轮起生效";
+              const sendText = wake
+                ? (r.delivered ? "首轮指令已送达，该会话将被唤醒一轮" : ("首轮指令未送达" + (r.error ? "：" + r.error : "")))
+                : "";
+              const migrateText = r.migrated ? "；身份互转方式 " + r.migrated + "：" + (r.migrationSummary || "") : "";
+              setRoleMsg("角色已设为" + (r.role || role) + "，" + liveText + migrateText + (sendText ? "；" + sendText : "。"));
+              setRoleStage((prev) => {
+                const next = Object.assign({}, prev || {});
+                next[sid] = wake ? "notified" : "set";
+                return next;
+              });
+              load();
+            } else {
+              setRoleBad(true);
+              setRoleMsg((r && r.error) || "设置失败");
+            }
+          })
+          .catch((e) => { setRoleBad(true); setRoleMsg("请求未完成：" + (e && e.message ? e.message : String(e))); })
+          .then(() => setWorking(false));
+      }, [load, roleMigrate]);
+
+      // 迁移：探针 → 复制并校验 → 状态 → 清旧备份
+      const refreshMove = React.useCallback(() => {
+        rpc("move.status", {}, 10000).then((st) => setMvStatus(st)).catch(() => {});
+      }, []);
+
+      const callMove = React.useCallback((method, payload, ms) => {
+        setMvBusy(true); setMvBad(false); setMvMsg("");
+        return rpc(method, payload, ms || 20000)
+          .then((v) => v)
+          .catch((e) => { setMvBad(true); setMvMsg(String(e && e.message ? e.message : e)); throw e; })
+          .then((v) => v, () => null)
+          .then((v) => { setMvBusy(false); return v; });
+      }, []);
+
+      const doProbe = React.useCallback(() => {
+        callMove("move.probe", { to: mvTo }, 90000).then((p) => {
+          if (!p) return;
+          setMvProbe(p);
+          setMvBad(!p.ok);
+          setMvMsg(p.ok ? "预检通过，可开始复制。" : "预检未通过，原因见下。");
+        });
+      }, [mvTo, callMove]);
+
+      const doCopy = React.useCallback(() => {
+        callMove("move.start", { to: mvTo }, 900000).then((r) => {
+          if (!r) return;
+          setMvBad(false);
+          setMvMsg("复制与校验通过：共 " + r.report.files + " 个文件、" + fmtBytes(r.report.bytes) + "。切换脚本已生成。");
+          refreshMove();
+        });
+      }, [mvTo, callMove, refreshMove]);
+
+      const doSwitch = React.useCallback(() => {
+        callMove("move.switch", {}, 30000).then((r) => {
+          if (!r) return;
+          setMvBad(false);
+          setMvMsg(r.already
+            ? "已处于切换完成状态（原路径为链接），无需再次切换。"
+            : "已就绪：完全退出 DSH 后约 1 秒完成切换，等待 10 秒再打开。日志：" + (r.log || ""));
+          refreshMove();
+        });
+      }, [callMove, refreshMove]);
+
+      // 压缩授权：仅在用户于此授权后，压缩才可排入；模型不得自行批准。
+      const [csSid, setCsSid] = React.useState("");
+      const [csMsg, setCsMsg] = React.useState("");
+      const doGrant = React.useCallback((kind) => {
+        setWorking(true); setCsMsg("");
+        post("consent.grant", { session_id: csSid, kind: kind === "succeed" ? "succeed" : "compact" }, 15000)
+          .then((r) => {
+            if (r && r.ok) { setCsMsg("已授权会话 " + r.sessionId + "：5 分钟内可" + (r.kind === "succeed" ? "换任" : "压缩") + "一次，用后失效。"); load(); }
+            else setCsMsg("授权未完成：" + ((r && r.error) || "原因未知"));
+          })
+          .catch((e) => setCsMsg("请求未完成：" + (e && e.message ? e.message : String(e))))
+          .then(() => setWorking(false));
+      }, [csSid, load]);
+      const doGrantSid = React.useCallback((sid, kind) => {
+        setWorking(true); setCsMsg("");
+        post("consent.grant", { session_id: sid, kind: kind === "succeed" ? "succeed" : "compact" }, 15000)
+          .then((r) => {
+            if (r && r.ok) { setCsMsg("已授权会话 " + r.sessionId + "：5 分钟内可" + (r.kind === "succeed" ? "换任" : "压缩") + "一次，用后失效。"); load(); }
+            else setCsMsg("授权未完成：" + ((r && r.error) || "原因未知"));
+          })
+          .catch((e) => setCsMsg("请求未完成：" + (e && e.message ? e.message : String(e))))
+          .then(() => setWorking(false));
+      }, [load]);
+
+      const doRevoke = React.useCallback((sid, kind) => {
+        setWorking(true); setCsMsg("");
+        post("consent.revoke", { session_id: sid, kind: kind === "succeed" ? "succeed" : "compact" }, 15000)
+          .then(() => { setCsMsg("已撤销 " + sid + " 的" + (kind === "succeed" ? "换任" : "压缩") + "授权。"); load(); })
+          .catch(() => { /* 撤销失败不影响其他操作 */ })
+          .then(() => setWorking(false));
+      }, [load]);
+
+      const doRetarget = React.useCallback(() => {
+        callMove("move.retarget-stage", {}, 20000).then((r) => {
+          if (!r) return;
+          if (r.already) { setMvMsg("DSH 登记已在新位置，无需修改登记。"); return; }
+          setMvBad(false);
+          setMvMsg("已就绪：DSH 退出后改写登记，每份先备份，重启后生效。日志：" + ((r.script && r.script.log) || ""));
+          refreshMove();
+        });
+      }, [callMove, refreshMove]);
+
+      const doRepair = React.useCallback(() => {
+        callMove("move.repair", {}, 20000).then((r) => {
+          if (!r) return;
+          setMvBad(false);
+          setMvMsg(r.already ? "原路径已经是链接，无需重建。" : "已重建链接：" + r.src + " 现指向 " + r.dst + "（未改动任何文件）。");
+          refreshMove();
+        });
+      }, [callMove, refreshMove]);
+
+      const doCleanup = React.useCallback(() => {
+        if (String(delWord || "").trim() !== "删除") {
+          setMvBad(true);
+          setMvMsg("确认词不正确。输入「删除」后重试。");
+          return;
+        }
+        callMove("move.cleanup", { confirm: true }, 180000).then((r) => {
+          if (!r) return;
+          setMvBad(false);
+          setDelWord("");
+          setMvMsg(r.note + ((r.removed || []).length ? "：" + r.removed.join("、") : ""));
+          refreshMove();
+        });
+      }, [delWord, callMove, refreshMove]);
+
+      // 有缓存时先渲染一帧旧读数，再拉取新数据；无缓存时才等待一次。
+      React.useEffect(() => { installCss(); load(); }, []);
+
+      const head = h("div", { className: "dshh-head" },
+        h("h2", { className: "dshh-title" }, "dsh-handover"),
+        h("button", { className: "dshh-btn", onClick: load, disabled: busy, type: "button" }, busy ? (data ? "正在刷新" : "正在读取") : "刷新"),
+        diag.lastError ? h("span", { className: "dshh-bad" }, "读取失败（通道 " + (channel || carrierKind()) + "）：" + diag.lastError.slice(0, 90)) : null,
+        data ? h("span", { className: "dshh-muted" }, "读数时间 " + data.generatedAt) : null);
+
+      if (err && !data) {
+        return h("div", { className: "dshh-root" }, head,
+          h("div", { className: "dshh-bad" }, "无法取得状态：" + err),
+          h("div", { className: "dshh-muted" }, "插件刚安装时，确认已在配置中启用并重启 DSH。"));
+      }
+      if (!data) {
+        return h("div", { className: "dshh-root" }, head, h("div", { className: "dshh-muted" }, "正在读取状态数据。"));
+      }
+
+      const p = data.plugin || {};
+      const ws = data.workspace || {};
+      const gate = data.gate;
+      const ho = data.handover;
+      const ss = data.sessions;
+      const allSessions = (data.sessions && Array.isArray(data.sessions.all)) ? data.sessions.all : [];
+      const byActivity = allSessions.slice().sort((a, b) => String(b.seen || "").localeCompare(String(a.seen || "")));
+
+      // 排序原则：高频操作在前，只读数据居中，说明文字在后。
+      const sections = [];
+
+      // 一、首次安装与全局会话：未接入时提供一键部署；已接入但尚无全局会话时提供补建入口。
+      const setup = data.setup;
+      const notReady = !ws || ws.found === false;
+      const globalCount = Number(data.globalSessions || 0);
+      if (deployInfo) {
+        sections.push(card("部署结果", h("div", { className: deployInfo.bad ? "dshh-bad" : "dshh-ok" }, deployInfo.text)));
+      }
+      if (notReady) {
+        const msg = setupMsg ? h("div", { className: setupBad ? "dshh-bad" : "dshh-ok" }, setupMsg) : null;
+        const steps = (setup && setup.steps) || [];
+        const notes = Array.isArray(data.notes) ? data.notes : [];
+        sections.push(card("首次安装",
+          h("div", null,
+            h("div", { className: "dshh-muted" }, "本页与工具已可用；接入工作区后显示闸门、交接体检与会话水位。"),
+            h("ol", { className: "dshh-list" }, steps.map((s, i) => h("li", { key: i }, s))),
+            notes.length ? h("ul", { className: "dshh-list" }, notes.map((n, i) => h("li", { key: i }, n))) : null,
+            h("input", {
+              className: "dshh-input",
+              type: "text",
+              value: parent,
+              placeholder: "填写绝对路径：全局根 _Workspace 将建立在该目录下",
+              onChange: (e) => setParent(e.target.value),
+            }),
+            h("div", { className: "dshh-row" },
+              h("button", { className: "dshh-btn", type: "button", disabled: working || !parent, onClick: deployAll }, working ? "正在部署" : "一键部署"),
+              h("button", { className: "dshh-btn", type: "button", disabled: working || !parent, onClick: buildTree }, working ? "正在建立" : "仅建立文件体系"),
+              created ? h("button", { className: "dshh-btn", type: "button", disabled: working, onClick: registerWs }, "注册为工作区") : null),
+            created ? h("div", { className: "dshh-code" }, created) : null,
+            msg)));
+      } else if (globalCount === 0) {
+        sections.push(card("全局会话",
+          h("div", null,
+            h("div", { className: "dshh-muted" }, "工作区已接入，尚无「全局」会话。点击下方按钮新建，插件会将其登记为全局角色。"),
+            h("div", { className: "dshh-muted" }, "全局根：" + (ws.root || "")),
+            h("div", { className: "dshh-row" },
+              h("button", { className: "dshh-btn", type: "button", disabled: working, onClick: makeGlobalSession }, working ? "正在创建" : "创建全局会话")),
+            globalMsg ? h("div", { className: globalBad ? "dshh-bad" : "dshh-ok" }, globalMsg) : null)));
+      }
+
+      // 二、授权：唯一合法的「用户同意」入口，置顶；只列在任会话，超过 5 个折叠。
+      const consentRows = (Array.isArray(data.consent) ? data.consent : []).filter((r) => r.onduty !== false);
+      const dutyRows = byActivity.filter((r) => r.onduty !== false);
+      const grantRow = (kind) => (r, i) => h("tr", { key: i },
+        h("td", null, r.title || "（无标题）"),
+        h("td", { className: "dshh-code dshh-num" }, shortSid(r.sid)),
+        h("td", null, h("button", {
+          className: "dshh-btn",
+          type: "button",
+          disabled: working,
+          title: r.sid,
+          onClick: () => doGrantSid(r.sid, kind),
+        }, kind === "succeed" ? "授权换任" : "授权压缩")));
+      const grantTable = (kind) => h(Folded, {
+        rows: dutyRows,
+        pageSize: 5,
+        cols: ["会话", "短号", "操作"],
+        widths: ["58%", "12%", "30%"],
+        render: grantRow(kind),
+      });
+      const authKids = [];
+      if (dutyRows.length) {
+        authKids.push(h("div", { className: "dshh-muted" }, "点击「授权压缩」后，该会话 5 分钟内可压缩一次，用后失效；也可在会话中发送 /allow-compact。"));
+        authKids.push(grantTable("compact"));
+        authKids.push(h("div", { className: "dshh-muted" }, "换任亦须授权：点击「授权换任」后 5 分钟内可换任一次；也可在会话中发送 /allow-succeed。"));
+        authKids.push(grantTable("succeed"));
+      } else {
+        authKids.push(h("div", { className: "dshh-muted" }, "暂无可选的在任会话；可在下方直接填写会话 id 授权。"));
+      }
+      authKids.push(h("div", { className: "dshh-row" },
+        h("input", {
+          className: "dshh-inputSm",
+          type: "text",
+          value: csSid,
+          placeholder: "也可填写会话 id 或 8 位短号",
+          onChange: (e) => setCsSid(e.target.value),
+        }),
+        h("button", { className: "dshh-btn", type: "button", disabled: working || !csSid, onClick: () => doGrant("compact") }, working ? "正在授权" : "授权压缩"),
+        h("button", { className: "dshh-btn", type: "button", disabled: working || !csSid, onClick: () => doGrant("succeed") }, "授权换任")));
+      if (consentRows.length) {
+        authKids.push(h("div", { className: "dshh-ok" }, "有授权"));
+        authKids.push(h("table", { className: "dshh-table" },
+          h("colgroup", null, h("col", { style: { width: "62%" } }), h("col", { style: { width: "18%" } }), h("col", { style: { width: "20%" } })),
+          h("thead", null, h("tr", null, h("th", null, "已授权会话"), h("th", null, "剩余"), h("th", null, "操作"))),
+          h("tbody", null, consentRows.map((r, i) => h("tr", { key: i },
+            h("td", { className: "dshh-code", title: r.sessionId }, shortSid(r.sessionId) + (r.kind === "succeed" ? " · 换任" : " · 压缩")),
+            h("td", { className: "dshh-num" }, Math.round((r.leftMs || 0) / 1000) + " 秒"),
+            h("td", null, h("button", { className: "dshh-btn", type: "button", disabled: working, onClick: () => doRevoke(r.sessionId, r.kind) }, "撤销")))))));
+      }
+      if (csMsg) authKids.push(h("div", { className: "dshh-ok" }, csMsg));
+      sections.push(card("授权", h("div", null, authKids)));
+
+      // 三、移动全局根目录：常态折叠为一行状态。
+      {
+        const st = mvStatus;
+        const phaseLabel = {
+          none: "尚无迁移记录",
+          verified: "已复制并校验，待切换",
+          switched: "已切换，原路径为链接",
+          "switched+cleaned": "已切换，旧备份已删除",
+          partial: "校验有差异，需重新复制",
+        };
+        // 旧备份是否保留不影响使用，因此不计入「需要处理」；需要处理的只有会妨碍使用的情形。
+        const hasOlds = !!(st && st.phase === "switched" && (st.olds || []).length);
+        const attention = !!(st && (st.linkBroken || st.srcExists === false || st.phase === "verified" || st.phase === "partial" || (st.retarget && st.retarget.needed)));
+        const stateText = st
+          ? "状态：" + (phaseLabel[st.phase] || st.phase) + (st.dst ? "（" + st.dst + "）" : "") + (hasOlds ? "；旧备份保留，不影响使用" : "")
+          : "正在读取迁移状态";
+        const kids = [];
+        kids.push(h("div", { className: "dshh-muted" }, "切换只改名并建立链接，不改动文件内容。"));
+        if (st && st.phase && st.phase.indexOf("switched") === 0) {
+          kids.push(h("div", { className: "dshh-muted" }, "原路径为指向新位置的链接；若已删除，可用「重建链接」恢复。"));
+        }
+        if (st && (st.srcExists === false || st.linkBroken)) {
+          kids.push(h("div", { className: "dshh-bad" }, st.linkBroken
+            ? "链接指向的新位置不存在：" + (st.dst || "") + "。应先确认真实数据位置；本页不改动文件。"
+            : "原路径不存在（可能已被删除）：" + (st.src || "") + "。数据仍在 " + (st.dst || "") + "。"));
+          if (st.canRepair) {
+            kids.push(h("div", { className: "dshh-row" },
+              h("button", { className: "dshh-btn", type: "button", disabled: mvBusy, onClick: doRepair }, "重建链接")));
+          }
+        }
+        if (st && st.phase === "verified" && st.script) {
+          kids.push(h("div", { className: "dshh-sub" }, "切换步骤"));
+          kids.push(h("ol", { className: "dshh-list" },
+            h("li", null, "点击「准备切换」，助手进入待命状态。"),
+            h("li", null, "完全退出 DSH，含托盘与后台进程。"),
+            h("li", null, "退出后自动执行，约 50 毫秒。"),
+            h("li", null, "等待 10 秒后再打开 DSH。"),
+            h("li", null, "回到本页，状态应为「已切换，原路径为链接」。")));
+          kids.push(h("div", { className: "dshh-row" },
+            h("button", { className: "dshh-btn", type: "button", disabled: mvBusy, onClick: doSwitch }, mvBusy ? "正在准备" : "准备切换（退出 DSH 后自动完成）")));
+          kids.push(h("div", { className: "dshh-muted" }, "助手未运行时手工执行：" + ((st.script && st.script.helper) || "")));
+        }
+        if (st && st.retarget && st.retarget.needed) {
+          kids.push(h("div", { className: "dshh-warn" }, "DSH 登记仍指向旧路径：" + st.retarget.total + " 处，涉及 " + st.retarget.files.length + " 个文件。"));
+          kids.push(h("div", { className: "dshh-muted" }, "退出 DSH 时改写，每份先备份；重启后生效。"));
+          kids.push(h("div", { className: "dshh-row" },
+            h("button", { className: "dshh-btn", type: "button", disabled: mvBusy, onClick: doRetarget }, "把登记迁到新位置（退出 DSH 后生效）")));
+          for (const rf of (st.retarget.files || [])) {
+            kids.push(h("div", { className: "dshh-code dshh-muted" }, rf.path + "  ×" + rf.count));
+          }
+        }
+        if (st && st.retarget && st.retarget.needed === false) {
+          kids.push(h("div", { className: "dshh-ok" }, "DSH 登记已指向新位置：" + (st.dst || "") + "。"));
+        }
+        if (hasOlds) {
+          kids.push(h("div", { className: "dshh-muted" }, "旧备份：" + st.olds.map((o) => o.path + "（" + fmtBytes(o.bytes) + "）").join("、") + "。保留不影响使用；删除后无法恢复。"));
+          kids.push(h("div", { className: "dshh-row" },
+            h("input", {
+              className: "dshh-inputSm",
+              type: "text",
+              value: delWord,
+              placeholder: "输入「删除」以确认",
+              onChange: (e) => setDelWord(e.target.value),
+            }),
+            h("button", { className: "dshh-btn", type: "button", disabled: mvBusy || delWord.trim() !== "删除", onClick: doCleanup }, "删除旧备份（不可撤销）")));
+        }
+        kids.push(h("div", { className: "dshh-row" },
+          h("input", {
+            className: "dshh-input",
+            type: "text",
+            value: mvTo,
+            placeholder: "新根目录的绝对路径",
+            onChange: (e) => setMvTo(e.target.value),
+          })));
+        kids.push(h("div", { className: "dshh-row" },
+          h("button", { className: "dshh-btn", type: "button", disabled: mvBusy || !mvTo, onClick: doProbe }, mvBusy ? "正在预检" : "预检"),
+          h("button", { className: "dshh-btn", type: "button", disabled: mvBusy || !mvTo, onClick: doCopy }, "复制并校验"),
+          h("button", { className: "dshh-btn", type: "button", disabled: mvBusy, onClick: refreshMove }, "刷新状态")));
+        if (mvProbe) {
+          kids.push(kv([
+            ["源", h("span", { className: "dshh-code" }, mvProbe.src)],
+            ["目标", h("span", { className: "dshh-code" }, mvProbe.dst)],
+            ["总大小", mvProbe.files + " 文件 · " + fmtBytes(mvProbe.bytes)],
+            ["目标盘可用", mvProbe.freeBytes === null || mvProbe.freeBytes === undefined ? "?" : fmtBytes(mvProbe.freeBytes)],
+            ["结论", mvProbe.ok ? verdict("通过", true) : verdict("不通过", false)],
+          ]));
+          for (const w of (mvProbe.warnings || [])) kids.push(h("div", { className: "dshh-warn" }, "注意：" + w));
+          for (const x of (mvProbe.problems || [])) kids.push(h("div", { className: "dshh-bad" }, "未通过：" + x));
+        }
+        if (mvMsg) kids.push(h("div", { className: mvBad ? "dshh-bad" : "dshh-ok" }, mvMsg));
+        sections.push(card("移动全局根目录",
+          h("div", null,
+            h("details", null,
+              h("summary", { className: "dshh-sum" }, (attention ? "需要处理：" : "") + stateText),
+              h("div", { className: "dshh-wrap" }, kids)))));
+      }
+
+      // 四、会话角色：按 DSH 工作区分组，默认全部折叠；组内会话按时间倒序（与 DSH 侧栏一致）。
+      // 分组顺序取 status payload 的 workspaces（即 workspace.json 的 workspaceIds 权威展示顺序）。
+      const timeDesc = (a, b) => {
+        const am = Number(a.mtime);
+        const bm = Number(b.mtime);
+        if (Number.isFinite(am) && Number.isFinite(bm) && am !== bm) return bm - am;
+        const s = String(b.seen || '').localeCompare(String(a.seen || ''));
+        if (s !== 0) return s;
+        return String(a.sid || '').localeCompare(String(b.sid || ''));
+      };
+      const byTime = byActivity.slice().sort(timeDesc);
+      const wsList = (ss && Array.isArray(ss.workspaces)) ? ss.workspaces : [];
+      const roleGroups = [];
+      const claimed = {};
+      for (const w of wsList) {
+        const rows = byTime.filter((r) => r.wsKey === w.key);
+        claimed[w.key] = true;
+        if (rows.length) roleGroups.push({ key: w.key, title: w.title || w.path || '工作区', path: w.path || '', rows });
+      }
+      const restRows = byTime.filter((r) => !claimed[r.wsKey]);
+      if (restRows.length) roleGroups.push({ key: "", title: "未分组", path: "", rows: restRows });
+      const roleRow = (r, i) => {
+        const draft = (roleSel && roleSel[r.sid]) || {};
+        const role = draft.role !== undefined ? draft.role : (r.role || "plain");
+        const project = draft.project !== undefined ? draft.project : (r.project || "");
+        const task = draft.task !== undefined ? draft.task : (r.task || "");
+        const wide = role === "project" || role === "misc";
+        const stage = (roleStage && roleStage[r.sid]) || "";
+        // 已有在任全局会话时不再提供「全局」选项；当前即为全局的会话仍显示，避免看不出当前状态。
+        const canGlobal = Number(data.globalSessions || 0) === 0 || r.role === "global";
+        const convert = (r.role === "project" || r.role === "misc") && wide && role !== r.role;
+        const action = stage === "notified"
+          ? h("button", { className: "dshh-btn", type: "button", disabled: true }, "已通知")
+          : stage === "set"
+            ? h("button", { className: "dshh-btn", type: "button", disabled: working, onClick: () => submitRole(r.sid, role, project, task, true) }, "通知该会话")
+            : stage === "confirm"
+              ? h("button", { className: "dshh-btn", type: "button", disabled: working, onClick: () => submitRole(r.sid, role, project, task, false) }, "确认设置")
+              : h("button", {
+                className: "dshh-btn",
+                type: "button",
+                disabled: working,
+                onClick: () => {
+                  setRoleStage((prev) => {
+                    const next = Object.assign({}, prev || {});
+                    next[r.sid] = "confirm";
+                    return next;
+                  });
+                  setRoleBad(false);
+                  setRoleMsg("请确认角色与名称，再点击「确认设置」。项目与杂项互转时，默认先快照再移动。");
+                },
+              }, "设置角色");
+        return h("tr", { key: i },
+          h("td", null, r.title || "（无标题）"),
+          h("td", { className: "dshh-code dshh-num" }, shortSid(r.sid)),
+          h("td", { className: "dshh-num" }, r.pct === null || r.pct === undefined ? "?" : r.pct.toFixed(1) + "%"),
+          h("td", null, h("select", {
+            className: "dshh-inputSm",
+            value: role,
+            onChange: (e) => setRoleValue(r.sid, { role: e.target.value }),
+          },
+            canGlobal ? h("option", { value: "global" }, "全局") : null,
+            h("option", { value: "project" }, "项目"),
+            h("option", { value: "misc" }, "杂项"),
+            h("option", { value: "plain" }, "普通"))),
+          h("td", null, wide ? h("div", null,
+            h("input", {
+              className: "dshh-inputSm",
+              type: "text",
+              value: role === "project" ? project : task,
+              placeholder: role === "project" ? "填写项目名" : "填写任务名",
+              onChange: (e) => setRoleValue(r.sid, role === "project" ? { project: e.target.value } : { task: e.target.value }),
+            }),
+            convert ? h("select", {
+              className: "dshh-inputSm",
+              value: (roleMigrate && roleMigrate[r.sid]) || "auto",
+              onChange: (e) => setRoleMigrate((prev) => Object.assign({}, prev || {}, { [r.sid]: e.target.value })),
+            },
+              h("option", { value: "auto" }, "先快照再移动"),
+              h("option", { value: "direct" }, "直接建新体系")) : null) : h("span", { className: "dshh-muted" }, "不需填写")),
+          h("td", null, h("div", { className: "dshh-pick" }, action)));
+      };
+      sections.push(card("会话角色",
+        h("div", null,
+          roleGroups.length
+            ? roleGroups.map((g, gi) => h("details", { key: gi },
+              h("summary", { className: "dshh-sum" }, g.title + "（" + g.rows.length + " 个会话）"),
+              h("div", { className: "dshh-wrap" },
+                g.path ? h("div", { className: "dshh-muted dshh-code" }, g.path) : null,
+                h(Folded, {
+                  rows: g.rows,
+                  pageSize: 5,
+                  cols: ["会话", "短号", "水位", "角色", "项目或任务名", "操作"],
+                  widths: ["30%", "9%", "7%", "12%", "20%", "22%"],
+                  render: roleRow,
+                }))))
+            : h("div", { className: "dshh-muted" }, "暂无可设置角色的会话。空白会话不列出。"),
+          roleMsg ? h("div", { className: roleBad ? "dshh-bad" : "dshh-ok" }, roleMsg) : null)));
+
+      // 五、全局前置提示词：默认折叠，只显示已保存字数。
+      sections.push(card("全局前置提示词",
+        h("div", null,
+          h("div", { className: "dshh-muted" }, "只注入你填写的内容，不含插件约束；对全部会话生效，留空保存即不注册提示段。"),
+          h("details", null,
+            h("summary", { className: "dshh-sum" }, "已保存 " + (extra ? extra.length : 0) + " 字符，点击编辑"),
+            h("textarea", {
+              className: "dshh-textarea",
+              rows: 6,
+              value: extra,
+              placeholder: "例如：一律用中文；改动前说明改动范围；简单任务不必拆分。",
+              onChange: (e) => setExtra(e.target.value),
+            }),
+            h("div", { className: "dshh-row" },
+              h("button", { className: "dshh-btn", type: "button", disabled: working, onClick: saveExtra }, working ? "正在保存" : "保存"),
+              h("span", { className: "dshh-muted" }, extra.length + " 字符")),
+            extraMsg ? h("div", { className: extraBad ? "dshh-bad" : "dshh-ok" }, extraMsg) : null))));
+
+      // 六、会话水位：只读数据区从这里开始；只列在任会话（全局、项目、杂项各一行）。
+      if (ss) {
+        const byRecent = (ss.rows || []).filter((r) => r.onduty !== false).slice().sort((a, b) => String(b.seen || "").localeCompare(String(a.seen || "")));
+        const waterRow = (r, i) => h("tr", { key: i },
+          h("td", null, r.dutyName || r.dutyKey || r.title || r.project || "（无名）"),
+          h("td", { className: "dshh-code dshh-num" }, shortSid(r.sid)),
+          h("td", null, r.dutyKind || r.roleLabel || ""),
+          h("td", { className: "dshh-num" }, r.pct === null || r.pct === undefined ? "?" : r.pct.toFixed(1) + "%"),
+          h("td", null, r.state),
+          h("td", null, r.active ? "活跃" : "沉默"),
+          h("td", { className: "dshh-muted dshh-num" }, shortTime(r.seen)));
+        sections.push(card("会话水位",
+          h("div", null,
+            h("div", { className: "dshh-muted" }, ss.verdict + "。活跃线 " + ss.cutoff + "，回溯 " + ss.silentHours + " 小时。"),
+            (ss.notify || []).length
+              ? h("div", null, "本轮需通知：" + ss.notify.map((r) => (r.name || r.key || "") + "（" + shortSid(r.sid) + "）").join("、"))
+              : h("div", { className: "dshh-muted" }, "本轮无需通知。"),
+            byRecent.length
+              ? h(Folded, {
+                rows: byRecent,
+                pageSize: 5,
+                cols: ["会话", "短号", "类别", "水位", "状态", "活跃", "最后活动"],
+                widths: ["20%", "11%", "7%", "8%", "8%", "7%", "31%"],
+                render: waterRow,
+              })
+              : h("div", { className: "dshh-muted" }, "暂无可显示的在任会话。"))));
+      }
+
+      // 七、通用约束条闸门
+      if (gate) {
+        const rows = (gate.libraries || []).map((r, i) => h("tr", { key: i },
+          h("td", null, r.name),
+          h("td", null, r.titleOk ? "通过" : "缺"),
+          h("td", null, (r.lines - r.missing) + "/" + r.lines),
+          h("td", null, r.waterOk ? "通过" : "缺"),
+          h("td", null, verdict(r.ok ? "通过" : "未通过", r.ok))));
+        sections.push(card("通用约束条闸门",
+          gate.error
+            ? h("div", { className: "dshh-bad" }, gate.error)
+            : h("div", null,
+              h("div", { className: "dshh-muted" }, gate.total + " 个库，正文 " + gate.bodyLines + " 行；" + gate.verdict),
+              h("table", { className: "dshh-table" },
+                h("thead", null, h("tr", null,
+                  h("th", null, "库"), h("th", null, "标题"), h("th", null, "正文"), h("th", null, "水位自查"), h("th", null, "结论"))),
+                h("tbody", null, rows)))));
+      }
+
+      // 八、交接文档体检：全局一行，项目与杂项同一张表；问题列只留问题本身。
+      if (ho) {
+        const cleanReason = (x) => String(x || "").replace(/（[^）]*）/g, "").replace(/\s+/g, " ").trim();
+        const rows = (ho.projects || []).map((r) => Object.assign({}, r, { kind: "项目" }))
+          .concat((ho.misc || []).map((r) => Object.assign({}, r, { kind: "杂项" })));
+        const prows = rows.map((r, i) => h("tr", { key: i },
+          h("td", null, r.kind),
+          h("td", null, r.name),
+          h("td", null, r.verdict === "通过" ? verdict("通过", true) : (r.verdict === "缺节" || r.verdict === "读不到" || r.verdict === "未找到") ? h("span", { className: "dshh-warn" }, r.verdict) : verdict(r.verdict, false)),
+          h("td", null, (r.reasons || []).map(cleanReason).filter(Boolean).join("；"))));
+        sections.push(card("交接文档体检",
+          h("div", null,
+            h("div", null, "全局 Global_Handover.md：", ho.global.verdict === "通过" ? verdict("通过", true) : verdict(ho.global.verdict, false),
+              (ho.global.reasons || []).length ? h("span", { className: "dshh-muted" }, (ho.global.reasons || []).map(cleanReason).filter(Boolean).join("；")) : null),
+            prows.length
+              ? h("table", { className: "dshh-table" },
+                h("thead", null, h("tr", null, h("th", null, "类别"), h("th", null, "名称"), h("th", null, "结论"), h("th", null, "问题"))),
+                h("tbody", null, prows))
+              : h("div", { className: "dshh-muted" }, "暂无已登记的项目或杂项。"))));
+      }
+
+      // 九、插件信息
+      sections.push(card("插件", kv([
+        ["名称", h("span", { className: "dshh-code" }, p.name + "@" + p.version)],
+        ["工具数", String(p.tools)],
+        ["压缩调度器", p.scheduler],
+        ["注入项", (p.inject || []).join("、")],
+        ["初始化", (p.initErrors && p.initErrors.length) ? h("span", { className: "dshh-bad" }, p.initErrors.join("；")) : verdict("正常", true)],
+        ["工作区", ws.found ? h("span", { className: "dshh-code" }, ws.root) : verdict("未接入（未找到 _Control_Center）", false)],
+      ])));
+
+      // 十、最近一次会话间通信判定：只有存在判定时才出现。
+      const g = data.guardLast;
+      if (g) {
+        sections.push(card("最近一次会话间通信判定", kv([
+          ["结论", g.allow ? verdict("允许", true) : verdict("拒绝", false)],
+          ["依据", g.source + (g.title ? "；会话标题 " + g.title : "")],
+          ["会话", h("span", { className: "dshh-code" }, g.sid || "-")],
+        ])));
+      }
+
+      // 末、工具明细与使用说明：参考性质，放最后，默认折叠。
+      const gd = data.guide;
+      if (gd) {
+        const sit = (gd.situations || []).map((r, i) => h("tr", { key: i },
+          h("td", null, r.when),
+          h("td", null, r.say),
+          h("td", { className: "dshh-muted" }, r.what)));
+        const groups = (gd.groups || []).map((gr, i) => h("div", { key: i },
+          h("div", { className: "dshh-sub" }, gr.title),
+          h("table", { className: "dshh-table" }, h("tbody", null, (gr.tools || []).map((t, j) => h("tr", { key: j },
+            h("td", { className: "dshh-code" }, t[0]),
+            h("td", { className: "dshh-muted" }, t[1])))))));
+        const toolCount = (gd.groups || []).reduce((a, gr) => a + ((gr.tools || []).length), 0);
+        if (toolCount) {
+          sections.push(card("工具明细",
+            h("details", null,
+              h("summary", { className: "dshh-sum" }, "共 " + toolCount + " 个工具，点击展开"),
+              h("div", { className: "dshh-wrap" }, groups))));
+        }
+        sections.push(card("使用说明",
+          h("details", null,
+            h("summary", { className: "dshh-sum" }, "交互方式、常见请求与约定"),
+            h("div", { className: "dshh-wrap" },
+              (gd.intro || []).map((t, i) => h("div", { key: i }, t)),
+              h("div", { className: "dshh-sub" }, "常见请求与对应动作"),
+              h("table", { className: "dshh-table" },
+                h("thead", null, h("tr", null, h("th", null, "时机"), h("th", null, "可以这样说"), h("th", null, "插件会执行的动作"))),
+                h("tbody", null, sit)),
+              h("div", { className: "dshh-sub" }, "约定"),
+              h("ul", { className: "dshh-list" }, (gd.rules || []).map((t, i) => h("li", { key: i }, t)))))));
+      }
+
+      return h("div", { className: "dshh-root" }, head, sections);
+    }
+
+    /** 把只读状态页注册进设置导航。 */
+    function apply(ctx) {
+      try { connection = (ctx && ctx.connection) || null; } catch (e) { connection = null; }
+      ctx.slots.inject("settings.section", () => ctx.slots.register({
+        name: "settings.section",
+        id: "handover",
+        order: 100,
+        label: "dsh-handover",
+      }, HandoverSection));
+    }
+
+    exports.apply = apply;
+    exports.inject = inject;
+    return module.exports;
+  },
 });