dsh-maoying 0.1.10 → 0.1.12

package/lib/client.js

@@ -32,7 +32,7 @@ window.__ModuleLoader__.load({
 
     var React = require("react");
     var h = React.createElement;
-    var useState = React.useState, useEffect = React.useEffect, useCallback = React.useCallback, useRef = React.useRef;
+    var useState = React.useState, useEffect = React.useEffect, useCallback = React.useCallback, useRef = React.useRef, useMemo = React.useMemo;
     // 复制一份导出面再补属性：不往共享模块对象上写东西（避免污染宿主里
     // 其他 ui-primitives 消费者）；后续片段看到的就是这份副本。
     var P = Object.assign({}, require("@deepseek-ai/dsh-client-ui-primitives"));
@@ -67,7 +67,7 @@ window.__ModuleLoader__.load({
     var TABS = [
       ["overview", "概览"], ["chapters", "章节"], ["characters", "角色"],
       ["foreshadows", "伏笔"], ["relations", "关系图"], ["timeline", "时间线"],
-      ["world", "设定"], ["index", "索引板"],
+      ["world", "设定"], ["index", "索引板"], ["settings", "小说设置"],
     ];
 
     // 角色徽章四色（role 是自由文本）：按关键词归 tone，命中即返。
@@ -478,6 +478,38 @@ window.__ModuleLoader__.load({
     }
     function Empty(props) { return h("div", { className: "myt-empty" }, props.text || "暂无数据"); }
 
+    // tab 内容错误边界：任何 tab / 阅读页渲染抛错都降级为卡内错误态（错误摘要
+    // + 重试按钮），不再把整个面板炸成白屏。错误边界只有 class 组件能做
+    // （getDerivedStateFromError / componentDidCatch），此处破例用 class。
+    class TabErrorBoundary extends React.Component {
+      constructor(props) {
+        super(props);
+        this.state = { err: null };
+        this.retry = this.retry.bind(this);
+      }
+      static getDerivedStateFromError(err) {
+        return { err: err }; // 渲染抛错 → 下一次 render 走降级分支
+      }
+      componentDidCatch(err) {
+        // 只记控制台：卡内已有降级 UI，toast 通道留给请求错误，不重复打扰。
+        if (typeof console !== "undefined" && console.warn) console.warn("maoying: 分区渲染出错:", err);
+      }
+      retry() {
+        this.setState({ err: null });
+        if (typeof this.props.onRetry === "function") this.props.onRetry(); // 顺手重拉快照，坏数据一并刷掉
+      }
+      render() {
+        var err = this.state.err;
+        if (!err) return this.props.children;
+        var msg = String((err && err.message) || err || "未知错误");
+        return h("div", { className: "myt-card" },
+          h("div", { className: "myt-cardHead" }, h("h3", { className: "myt-cardTitle" }, "该分区渲染出错")),
+          h("div", { className: "myt-muted", style: { overflowWrap: "anywhere" } }, "错误摘要：" + truncate(msg, 300)),
+          h("div", { className: "myt-heroMeta" },
+            h("button", { type: "button", className: "myt-btn", onClick: this.retry }, "重试")));
+      }
+    }
+
     // ── 页面骨架：顶栏（工作区下拉 + 刷新 + 关闭）+ tab 条 + 内容区 ─────────
     // 数据流：workspaces 一次拉取；state 跟随选中工作区；写操作 POST 成功后
     // 整份重拉 state（不乐观更新）。选择记 localStorage('maoying.workspace')。
@@ -490,7 +522,17 @@ window.__ModuleLoader__.load({
       var _ld = useState(true), loading = _ld[0], setLoading = _ld[1];
       var _se = useState(""), stateErr = _se[0], setStateErr = _se[1];
       var _tb = useState("overview"), tab = _tb[0], setTab = _tb[1];
-      var _pc = useState(null), pendingChapter = _pc[0], setPendingChapter = _pc[1];
+      // 章节阅读页（整页视图，替代原右侧抽屉）：null = 列表态。
+      var _rd = useState(null), readerFile = _rd[0], setReaderFile = _rd[1];
+      // 系统设置：字号档位持久化 + 面板整体缩放（portal 节点读同一 CSS 变量）。
+      var _sm = useState(false), showSettings = _sm[0], setShowSettings = _sm[1];
+      var _fs = useState(function () { return lsGet(FONT_SCALE_KEY) || "1"; }), fontScale = _fs[0], setFontScale = _fs[1];
+      useEffect(function () {
+        if (typeof document !== "undefined" && document.documentElement) {
+          document.documentElement.style.setProperty("--myt-zoom", fontScale);
+        }
+        lsSet(FONT_SCALE_KEY, fontScale);
+      }, [fontScale]);
 
       // 选中校正：记忆的工作区必须仍在列表且 hasNovel，否则落回首个 hasNovel。
       var effectiveWs = (function () {
@@ -523,21 +565,35 @@ window.__ModuleLoader__.load({
           setWorkspaces([]);
         });
       }, []);
+      var stateSeqRef = useRef(0); // state 请求序号：快速切工作区时丢弃过期响应
       var loadState = useCallback(function (root) {
+        var seq = ++stateSeqRef.current; // 先自增再发请求；早退分支也作废在途旧响应
         if (!root) { setSnap(null); setStateErr(""); setLoading(false); return; }
         setLoading(true);
         setStateErr("");
         return apiGet("state", { path: root }).then(function (d) {
+          if (seq !== stateSeqRef.current) return; // 过期响应：已有更新的请求在途，丢弃
           setSnap(d && d.ok ? d : null);
         }).catch(function (err) {
+          if (seq !== stateSeqRef.current) return;
           setSnap(null);
           setStateErr(err.message);
-        }).finally(function () { setLoading(false); });
+        }).finally(function () {
+          if (seq === stateSeqRef.current) setLoading(false); // 过期收尾不碰加载态
+        });
       }, []);
       var reload = useCallback(function () {
         return effectiveWs ? loadState(effectiveWs) : Promise.resolve();
       }, [effectiveWs, loadState]);
 
+      // 新版检测（模仿 dsh-paoding）：面板打开时拉一次（服务端有 1h 缓存），
+      // updateAvailable 才渲染徽章；失败静默，不打扰任何主流程。
+      var _ver = useState(null), ver = _ver[0], setVer = _ver[1];
+      useEffect(function () {
+        apiGet("update-check").then(function (d) {
+          if (d && d.current) setVer(d); // 常态也显示当前版本号；有新版再亮徽章
+        }).catch(function () {});
+      }, []);
       useEffect(function () { loadWorkspaces(); }, [loadWorkspaces]);
       useEffect(function () { loadState(effectiveWs); }, [effectiveWs, loadState]);
       // 校正后的选择回写记忆（首次打开 / 记忆失效时自动落位）。
@@ -552,7 +608,7 @@ window.__ModuleLoader__.load({
       }
       function gotoTab(next, chapterFile) {
         setTab(next);
-        if (next === "chapters") setPendingChapter(chapterFile || null);
+        setReaderFile(next === "chapters" && chapterFile ? chapterFile : null);
       }
 
       var novelWorkspaces = (workspaces || []).filter(function (w) { return w.hasNovel; });
@@ -578,20 +634,27 @@ window.__ModuleLoader__.load({
         });
       } else if (snap) {
         var tabProps = { snap: snap, reload: reload, wsPath: effectiveWs };
-        if (tab === "chapters") body = h(ChaptersTab, Object.assign({ initialFile: pendingChapter, onConsumeInitial: function () { setPendingChapter(null); } }, tabProps));
+        if (readerFile) body = h(ChapterReader, { file: readerFile, snap: snap, reload: reload, wsPath: effectiveWs, onBack: function () { setReaderFile(null); } });
+        else if (tab === "chapters") body = h(ChaptersTab, Object.assign({ onOpenChapter: function (f) { setReaderFile(f); } }, tabProps));
         else if (tab === "characters") body = h(CharactersTab, tabProps);
         else if (tab === "foreshadows") body = h(ForeshadowsTab, tabProps);
         else if (tab === "relations") body = h(RelationsTab, tabProps);
         else if (tab === "timeline") body = h(TimelineTab, tabProps);
         else if (tab === "world") body = h(WorldTab, tabProps);
         else if (tab === "index") body = h(IndexTab, tabProps);
+        else if (tab === "settings") body = h(SettingsTab, tabProps);
         else body = h(OverviewTab, Object.assign({ gotoTab: gotoTab }, tabProps));
       }
 
       return h("div", { className: "myt-shell" },
         h("header", { className: "myt-header" },
           h("div", null,
-            h("h1", { className: "myt-title" }, "毛颖创作台"),
+            h("h1", { className: "myt-title" }, "毛颖创作台",
+              ver && ver.current ? h("span", { className: "myt-verTag", title: "当前版本" }, ver.current) : null,
+              ver && ver.updateAvailable
+                ? h("a", { className: "myt-verBadge", href: ver.releaseUrl || "#", target: "_blank", rel: "noreferrer", title: "当前 " + ver.current + "，点击打开新版发布页" },
+                    "有新版 " + ver.latest + " ↗")
+                : null),
             h("p", { className: "myt-subtitle" }, "网文项目可视化与状态流转 · 只读正文，写状态")),
           h("div", { className: "myt-headActions" },
             workspaces && novelWorkspaces.length
@@ -602,9 +665,10 @@ window.__ModuleLoader__.load({
                        (w.hasNovel ? "" : "（无 novel）") + (w.name || w.path || "未命名"));
                    }))]
               : null,
+            h("button", { type: "button", className: "myt-btn myt-btnIcon", title: "系统设置", "aria-label": "系统设置", onClick: function () { setShowSettings(true); } }, ic("IconSettingsOutlineRegular", 14)),
             h("button", { type: "button", className: "myt-btn myt-btnIcon", title: "重新拉取", "aria-label": "重新拉取", disabled: loading, onClick: reload }, ic("IconRefreshOutlineRegular", 14)),
             h("button", { type: "button", className: "myt-closeBtn", "aria-label": "关闭创作台", title: "关闭", onClick: onClose }, h("span", { className: "myt-closeGlyph", "aria-hidden": "true" }, "×")))),
-        h("nav", { className: "myt-tabs", "aria-label": "创作台分区" },
+        readerFile ? null : h("nav", { className: "myt-tabs", "aria-label": "创作台分区" },
           TABS.map(function (t) {
             return h("button", {
               key: t[0], type: "button", className: "myt-tab", "data-active": tab === t[0] ? "true" : undefined,
@@ -614,7 +678,9 @@ window.__ModuleLoader__.load({
         h("div", { className: "myt-body" },
           h("div", { className: "myt-page" },
             snap && Array.isArray(snap.warnings) && snap.warnings.length ? WarningsStrip(snap.warnings) : null,
-            body)),
+            // 错误边界包住 tab 内容：key 随 tab / 阅读页变化重挂，切分区自动清错误态。
+            h(TabErrorBoundary, { key: readerFile ? "reader:" + readerFile : tab, onRetry: reload }, body))),
+        showSettings ? h(SettingsModal, { scale: fontScale, onPick: setFontScale, onClose: function () { setShowSettings(false); } }) : null,
         h(ToastHost));
     }
 
@@ -687,6 +753,287 @@ window.__ModuleLoader__.load({
             : h(Empty, { text: "chapters/ 目录还没有章节文件" })));
     }
 
+    // ── 轻量 Markdown 渲染（零依赖）：先整体 HTML 转义再施加 md 变换，杜绝
+    // 注入；支持标题/加粗/斜体/删除线/行内码/围栏码/引用/有序无序列表/分隔线/
+    // 链接/段落换行。供章纲、世界观条目等 md 阅读位使用，正文手稿仍走 pre。 ──
+    function escapeHtml(s) {
+      return String(s).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+    }
+    // 链接 scheme 白名单：仅放行 http/https 绝对地址与无 scheme 的相对路径 /
+    // 锚点 / //协议相对；javascript:/data:/vbscript: 等一律拒绝（调用方落纯文本）。
+    function isSafeLinkUrl(url) {
+      var m = String(url || "").match(/^([a-zA-Z][a-zA-Z0-9+.\-]*):/);
+      return !m || /^https?$/i.test(m[1]);
+    }
+    function inlineMd(s) {
+      // 行内码占位保护：先抽出 `code` 区间换成哨兵占位符，加粗/斜体/删除线/
+      // 链接不再命中码内文本（否则 `*x*` 会被二次加格式），最后回填。
+      // 哨兵用 NUL 控制符 + 固定前缀：正文已过 escapeHtml，不可能出现该序列。
+      var codes = [];
+      var out = String(s).replace(/`([^`]+)`/g, function (_m, code) {
+        codes.push("<code>" + code + "</code>");
+        return "\u0000MYTCODE" + (codes.length - 1) + "\u0000";
+      })
+        .replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>")
+        .replace(/__([^_]+)__/g, "<strong>$1</strong>")
+        .replace(/\*([^*\n]+)\*/g, "<em>$1</em>")
+        .replace(/~~([^~]+)~~/g, "<del>$1</del>")
+        .replace(/\[([^\]]+)\]\(([^)\s]+)\)/g, function (_m, txt, url) {
+          if (!isSafeLinkUrl(url)) return _m; // 白名单外：原样落纯文本，不生成 href
+          return '<a href="' + url + '" target="_blank" rel="noreferrer">' + txt + "</a>";
+        });
+      return out.replace(/\u0000MYTCODE(\d+)\u0000/g, function (_m, i) { return codes[Number(i)] || ""; });
+    }
+    function renderMd(src) {
+      var lines = escapeHtml(src).split(/\r?\n/);
+      var html = [];
+      var i = 0;
+      while (i < lines.length) {
+        var line = lines[i];
+        if (/^```/.test(line)) {
+          var code = [];
+          i++;
+          while (i < lines.length && !/^```/.test(lines[i])) { code.push(lines[i]); i++; }
+          i++; // 吃掉收尾 ```（缺失也吞到尾）
+          html.push('<pre class="myt-mdCode"><code>' + code.join("\n") + "</code></pre>");
+          continue;
+        }
+        if (/^\s*$/.test(line)) { i++; continue; }
+        var h2 = line.match(/^(#{1,6})\s+(.*)$/);
+        if (h2) {
+          var lv = h2[1].length;
+          html.push('<h' + lv + ' class="myt-mdH">' + inlineMd(h2[2]) + "</h" + lv + ">");
+          i++; continue;
+        }
+        if (/^ {0,3}(?:-{3,}|\*{3,}|_{3,})\s*$/.test(line)) { html.push('<hr class="myt-mdHr">'); i++; continue; }
+        if (/^\s*&gt;\s?/.test(line)) {
+          var quote = [];
+          while (i < lines.length && /^\s*&gt;\s?/.test(lines[i])) { quote.push(inlineMd(lines[i].replace(/^\s*&gt;\s?/, ""))); i++; }
+          html.push('<blockquote class="myt-mdQuote">' + quote.join("<br>") + "</blockquote>");
+          continue;
+        }
+        var ul = line.match(/^\s*[-*+]\s+(.*)$/);
+        if (ul) {
+          var items = [];
+          while (i < lines.length) {
+            var m1 = lines[i].match(/^\s*[-*+]\s+(.*)$/);
+            if (!m1) break;
+            items.push("<li>" + inlineMd(m1[1]) + "</li>");
+            i++;
+          }
+          html.push('<ul class="myt-mdList">' + items.join("") + "</ul>");
+          continue;
+        }
+        var ol = line.match(/^\s*\d+[.)]\s+(.*)$/);
+        if (ol) {
+          var oitems = [];
+          while (i < lines.length) {
+            var m2 = lines[i].match(/^\s*\d+[.)]\s+(.*)$/);
+            if (!m2) break;
+            oitems.push("<li>" + inlineMd(m2[1]) + "</li>");
+            i++;
+          }
+          html.push('<ol class="myt-mdList">' + oitems.join("") + "</ol>");
+          continue;
+        }
+        var para = [line];
+        i++;
+        while (i < lines.length && !/^\s*$/.test(lines[i]) && !/^```|^\s*&gt;|^\s*[-*+]\s|^\s*\d+[.)]\s|^#{1,6}\s/.test(lines[i])) {
+          para.push(lines[i]); i++;
+        }
+        html.push('<p class="myt-mdP">' + inlineMd(para.join("<br>")) + "</p>");
+      }
+      // 块间直接相连不补 "\n"：落点容器（.myt-outlineBody / .myt-worldDesc）是
+      // white-space:pre-wrap，块间再塞换行会渲染成额外空行 → 双倍间距；
+      // 块间距已由 .myt-md* 各自 margin 承担。
+      return html.join("");
+    }
+    function MdView(props) {
+      return h("div", {
+        className: "myt-md" + (props.className ? " " + props.className : ""),
+        dangerouslySetInnerHTML: { __html: renderMd(props.text || "") },
+      });
+    }
+
+    // ── 系统设置：字号五档（面板整体 zoom，抽屉/弹层 portal 节点同缩放）──────
+    var FONT_SCALE_KEY = "maoying.fontScale";
+    var FONT_SCALES = [["1", "默认（100%）"], ["1.2", "大（120%）"], ["1.5", "更大（150%）"], ["1.8", "超大（180%）"], ["2", "巨大（200%）"]];
+    function SettingsModal(props) {
+      var scale = props.scale;
+      var onPick = props.onPick;
+      var onClose = props.onClose;
+      return h(MaskPortal, {
+        className: "myt-settingsMask",
+        onMouseDown: function (e) { if (e.target === e.currentTarget) onClose(); },
+      },
+        h("div", { className: "myt-settings", role: "dialog", "aria-modal": "true", "aria-label": "系统设置" },
+          h("div", { className: "myt-settingsHead" },
+            h("h3", { className: "myt-settingsTitle" }, "系统设置"),
+            h("button", { type: "button", className: "myt-closeBtn", "aria-label": "关闭设置", onClick: onClose }, h("span", { className: "myt-closeGlyph", "aria-hidden": "true" }, "×"))),
+          h("div", { className: "myt-settingsBody" },
+            h("div", { className: "myt-settingsLabel" }, "字号"),
+            h("div", { className: "myt-setRow" }, FONT_SCALES.map(function (o) {
+              return h("button", {
+                key: o[0], type: "button", className: "myt-setOpt", "data-active": scale === o[0] ? "true" : undefined,
+                onClick: function () { onPick(o[0]); },
+              }, o[1]);
+            })),
+            h("div", { className: "myt-settingsHint" }, "按当前字号的百分比缩放整个创作台，立即生效并记忆。"))));
+    }
+
+    // ── 章节阅读页（整页视图，替代右侧抽屉）：返回按钮 + 章纲对照 + 正文 +
+    // 五维 + 状态流转。原抽屉是 position:fixed 侧弹层，在桌面端会被侧边栏
+    // 遮挡；整页视图天然在面板文档流内，无遮挡问题。 ──
+    function ChapterReader(props) {
+      var file = props.file;
+      var wsPath = props.wsPath;
+      var snap = props.snap;
+      var reload = props.reload;
+      var onBack = props.onBack;
+      var _d = useState(null), detail = _d[0], setDetail = _d[1]; // {loading, data, err}
+      var _b = useState(false), flowBusy = _b[0], setFlowBusy = _b[1];
+      var detailSeqRef = useRef(0); // chapter 请求序号：快速切章时丢弃过期响应
+      var loadDetail = useCallback(function (f) {
+        var seq = ++detailSeqRef.current;
+        if (!f) { setDetail(null); return; }
+        setDetail({ loading: true, data: null, err: "" });
+        apiGet("chapter", { path: wsPath, file: f }).then(function (d) {
+          if (seq !== detailSeqRef.current) return; // 过期响应：已在看另一章，丢弃
+          setDetail({ loading: false, data: d, err: "" });
+        }).catch(function (err) {
+          if (seq !== detailSeqRef.current) return;
+          setDetail({ loading: false, data: null, err: err.message });
+        });
+      }, [wsPath]);
+      useEffect(function () { loadDetail(file); }, [file, loadDetail]);
+      var ch = null;
+      var chapters = (snap && snap.chapters) || [];
+      for (var i = 0; i < chapters.length; i++) { if (chapters[i].file === file) { ch = chapters[i]; break; } }
+      function advance() {
+        if (!ch) return;
+        var idx = STATUS_FLOW.indexOf(ch.status);
+        var next = idx !== -1 && idx < STATUS_FLOW.length - 1 ? STATUS_FLOW[idx + 1] : null;
+        if (!next || flowBusy) return;
+        setFlowBusy(true);
+        apiPost("chapter-status", { path: wsPath, file: ch.file, status: next })
+          .then(function () { return reload(); })
+          .then(function () { return loadDetail(ch.file); })
+          .catch(function () {}).finally(function () { setFlowBusy(false); });
+      }
+      function copyChapterPath() {
+        copyText(chapterAbsPath(snap && snap.novelDir, file)).then(function (ok) {
+          if (ok) toast.ok("已复制章节文件路径");
+          else toast.warn("复制失败，请手动选择路径文本");
+        });
+      }
+      return h("div", { className: "myt-reader" },
+        h("div", { className: "myt-readerBar" },
+          h("button", { type: "button", className: "myt-btn", onClick: onBack, title: "返回章节列表" },
+            ic("IconChevronRightOutlineRegular", 13), "返回"),
+          h("h2", { className: "myt-readerTitle" }, ch ? chFullTitle(ch) : file),
+          ch ? statusBadge(ch.status) : null,
+          h("div", { className: "myt-readerBarActions" },
+            h("button", {
+              type: "button", className: "myt-btn myt-copyBtn",
+              title: "复制章节文件路径", "aria-label": "复制章节文件路径",
+              onClick: copyChapterPath,
+            }, ic("IconCopyOutlineRegular", 13), "复制路径"))),
+        h("div", { className: "myt-readerBody" },
+          !detail || detail.loading ? h("div", { className: "myt-stack" }, h("div", { className: "myt-skel myt-skelRow" }), h("div", { className: "myt-skel myt-skelRow", style: { width: "80%" } }), h("div", { className: "myt-skel myt-skelRow", style: { width: "64%" } }))
+            : detail.err ? h(ErrorStrip, { text: "正文读取失败：" + detail.err, onRetry: function () { loadDetail(file); } })
+              : [
+                  (function () {
+                    var ol = detail.data && detail.data.outline;
+                    return ol ? h(OutlinePanel, { key: "outline", outline: ol })
+                      : h("div", { key: "outline-none", className: "myt-outlineEmpty" }, "暂无章纲");
+                  })(),
+                  h("pre", { key: "body", className: "myt-chapterBody" }, (detail.data && detail.data.body) || "（空章节）"),
+                ],
+          ch ? h("div", { className: "myt-dimGrid" }, FIVE_DIMS.map(function (dim) {
+            return h("div", { key: dim[0], className: "myt-dim" },
+              h("div", { className: "myt-dimLabel" }, dim[1]),
+              h("div", { className: "myt-dimText" }, orDash(ch[dim[0]])));
+          })) : null),
+        ch ? h("div", { className: "myt-readerFoot" },
+          (function () {
+            var idx = STATUS_FLOW.indexOf(ch.status);
+            var next = idx !== -1 && idx < STATUS_FLOW.length - 1 ? STATUS_FLOW[idx + 1] : null;
+            if (!next) return h("span", { className: "myt-muted" }, "已定稿（终态）");
+            return [h("span", { className: "myt-muted", key: "t" }, "状态流转："),
+              h("button", { key: "b", type: "button", className: "myt-btn myt-btnPrimary", disabled: flowBusy, onClick: advance },
+                flowBusy ? "流转中…" : "推进到「" + STATUS_LABEL[next] + "」")];
+          })()) : null);
+    }
+
+    // ── 小说设置 tab：可视化 project.yml 平键并保存。mode/phase 走枚举
+    // 下拉，自由文本走输入框；保存走 project-save 路由（服务端校验 + 保
+    // 注释改写），成功后重拉快照让概览同步。 ──
+    function SettingsTab(props) {
+      var snap = props.snap;
+      var wsPath = props.wsPath;
+      var reload = props.reload;
+      var project = snap.project || {};
+      var _f = useState(function () {
+        return {
+          title: project.title || "", author: project.author || "", genre: project.genre || "",
+          length: project.length || "", language: project.language || "zh",
+          phase: PHASES.indexOf(project.phase) !== -1 ? project.phase : "idea",
+          mode: project.mode || "ai-draft",
+          description: project.description || "",
+        };
+      }), form = _f[0], setForm = _f[1];
+      var _b = useState(false), busy = _b[0], setBusy = _b[1];
+      var _e = useState(""), saveErr = _e[0], setSaveErr = _e[1];
+      function set(k, v) { setForm(Object.assign({}, form, (function () { var o = {}; o[k] = v; return o; })())); }
+      function save() {
+        if (busy) return;
+        if (!String(form.title || "").trim()) { setSaveErr("书名不能为空"); return; }
+        setBusy(true); setSaveErr("");
+        // 成败提示统一走 apiPost 的 toast 通道（这里不再另弹，避免双 toast）；
+        // 卡内 saveErr 只承担表单旁的错误态。
+        apiPost("project-save", { path: wsPath, values: form }).then(function () {
+          return reload();
+        }).catch(function (err) {
+          setSaveErr(err.message);
+        }).finally(function () { setBusy(false); });
+      }
+      function field(label, key, placeholder, textarea) {
+        var value = form[key] || "";
+        return h("label", { className: "myt-setField" },
+          h("span", { className: "myt-setFieldLabel" }, label),
+          textarea
+            ? h("textarea", { className: "myt-setInput myt-setArea", rows: 3, placeholder: placeholder, value: value,
+                onChange: function (e) { set(key, e.target.value); } })
+            : h("input", { type: "text", className: "myt-setInput", placeholder: placeholder, value: value,
+                onChange: function (e) { set(key, e.target.value); } }));
+      }
+      function picker(label, key, opts) {
+        var value = form[key] || "";
+        return h("label", { className: "myt-setField" },
+          h("span", { className: "myt-setFieldLabel" }, label),
+          h("select", { className: "myt-setInput myt-setSelect", value: value, onChange: function (e) { set(key, e.target.value); } },
+            opts.map(function (o) { return h("option", { key: o[0], value: o[0] }, o[1]); })));
+      }
+      return h("div", { className: "myt-stack" },
+        h("div", { className: "myt-card" },
+          h("div", { className: "myt-cardHead" },
+            h("h3", { className: "myt-cardTitle" }, "书稿元信息"),
+            h("span", { className: "myt-muted" }, "对应 novel/project.yml · 行尾注释会原样保留")),
+          h("div", { className: "myt-setGrid" },
+            field("书名", "title", "如：长夜余火"),
+            field("作者", "author", "笔名"),
+            field("题材", "genre", "如：东方玄幻 / 都市异能 / 历史架空"),
+            field("预期篇幅", "length", "如：约100万字 / 300章"),
+            picker("正文语言", "language", [["zh", "中文"], ["en", "English"], ["ja", "日本語"]]),
+            picker("工作流阶段", "phase", PHASES.map(function (p) { return [p, PHASE_LABEL[p] || p]; })),
+            picker("共创模式", "mode", [["ai-draft", "AI 代笔（AI 写正文）"], ["co-write", "逐章共创（按章指派谁写）"], ["author-draft", "作者亲笔（AI 只备料审稿）"]]),
+            field("一句话简介", "description", "写封面文案时可直接引用", true))),
+        saveErr ? h(ErrorStrip, { text: saveErr }) : null,
+        h("div", { className: "myt-setActions" },
+          h("button", { type: "button", className: "myt-btn myt-btnPrimary", disabled: busy, onClick: save },
+            busy ? "保存中…" : "保存设置")));
+    }
+
     // ── 章节 tab：状态筛选 pills + 表格 + 行抽屉（只读正文 + 五维 + 流转）────
     var FIVE_DIMS = [
       ["cognitive_frame", "认知框架"], ["emotional_anchor", "情感锚点"], ["world_texture", "世界质感"],
@@ -710,7 +1057,7 @@ window.__ModuleLoader__.load({
           typeof (outline && outline.words) === "number" ? h("span", { className: "myt-outlineWords" }, fmtNum(outline.words) + " 字") : null,
           h("span", { className: "myt-outlineChevron", "aria-hidden": "true" },
             ic(open ? "IconChevronDownOutlineRegular" : "IconChevronRightOutlineRegular", 14))),
-        open ? h("pre", { className: "myt-outlineBody" }, body) : null);
+        open ? h(MdView, { text: body, className: "myt-outlineBody" }) : null);
     }
     // 抽屉/弹层专用 Portal：面板容器挂在宿主会话中栏里，中栏的 transform/
     // overflow 会把 position:fixed 劫持成相对自身并连同裁剪——抽屉渲染了也
@@ -726,45 +1073,11 @@ window.__ModuleLoader__.load({
 
     function ChaptersTab(props) {
       var snap = props.snap;
-      var reload = props.reload;
-      var wsPath = props.wsPath;
+      var onOpen = props.onOpenChapter; // 行点击 → 整页阅读（PageShell.readerFile）
       var _f = useState("all"), filter = _f[0], setFilter = _f[1];
-      var _o = useState(null), openFile = _o[0], setOpenFile = _o[1];
-      var _d = useState(null), detail = _d[0], setDetail = _d[1]; // {loading, data, err}
-      var _b = useState(false), flowBusy = _b[0], setFlowBusy = _b[1];
-      // 概览「最近章节」点进来：initialFile 只消费一次（吃掉后回置空，防止
-      // 下次进 tab 时把旧抽屉又顶开）。
-      useEffect(function () {
-        if (props.initialFile) {
-          setOpenFile(props.initialFile);
-          if (typeof props.onConsumeInitial === "function") props.onConsumeInitial();
-        }
-      }, [props.initialFile]);
-      var loadDetail = useCallback(function (file) {
-        if (!file) { setDetail(null); return; }
-        setDetail({ loading: true, data: null, err: "" });
-        apiGet("chapter", { path: wsPath, file: file }).then(function (d) {
-          setDetail({ loading: false, data: d, err: "" });
-        }).catch(function (err) {
-          setDetail({ loading: false, data: null, err: err.message });
-        });
-      }, [wsPath]);
-      useEffect(function () { loadDetail(openFile); }, [openFile, loadDetail]);
-      function advance(ch) {
-        var idx = STATUS_FLOW.indexOf(ch.status);
-        var next = idx !== -1 && idx < STATUS_FLOW.length - 1 ? STATUS_FLOW[idx + 1] : null;
-        if (!next || flowBusy) return;
-        setFlowBusy(true);
-        apiPost("chapter-status", { path: wsPath, file: ch.file, status: next })
-          .then(function () { return reload(); })
-          .then(function () { if (openFile === ch.file) return loadDetail(ch.file); })
-          .catch(function () {}).finally(function () { setFlowBusy(false); });
-      }
       var chapters = snap.chapters || [];
       var rows = filter === "all" ? chapters : chapters.filter(function (c) { return c.status === filter; });
       var counts = snap.totals && snap.totals.byStatus ? snap.totals.byStatus : {};
-      var openCh = null;
-      for (var i = 0; i < chapters.length; i++) { if (chapters[i].file === openFile) { openCh = chapters[i]; break; } }
       // 「按单写作」（五期）：state.outlines 与 chapters 联交——有章纲且
       // status=pending 的章，按章纲（卷-章号）序列出，共创模式的主工作清单；
       // 空块（无待写章纲章）整块不渲染。孤儿章纲（chapter 无对应章节）联交
@@ -777,12 +1090,6 @@ window.__ModuleLoader__.load({
         var ch = ol && ol.chapter ? chapterByFile[ol.chapter] : null;
         if (ch && (ch.status || "pending") === "pending") writeOrder.push({ ch: ch, ol: ol });
       });
-      function copyChapterPath() {
-        copyText(chapterAbsPath(snap && snap.novelDir, openFile)).then(function (ok) {
-          if (ok) toast.ok("已复制章节文件路径");
-          else toast.warn("复制失败，请手动选择路径文本");
-        });
-      }
       return h("div", { className: "myt-stack" },
         writeOrder.length ? h("div", { className: "myt-card myt-writeOrder" },
           h("div", { className: "myt-cardHead" },
@@ -793,8 +1100,8 @@ window.__ModuleLoader__.load({
             var ol = item.ol;
             return h("button", {
               key: ch.file, type: "button", className: "myt-writeOrderRow",
-              title: "点击打开该章抽屉",
-              onClick: function () { setOpenFile(ch.file); },
+              title: "点击打开该章",
+              onClick: function () { onOpen(ch.file); },
             },
               h("span", { className: "myt-chPath" }, chWhere(ch) || ch.file),
               h("span", { className: "myt-chTitle" }, orDash(ch.title)),
@@ -818,55 +1125,14 @@ window.__ModuleLoader__.load({
             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.map(function (ch) {
-              return h("tr", { key: ch.file, onClick: function () { setOpenFile(ch.file); }, title: "点击查看正文" },
+              return h("tr", { key: ch.file, onClick: function () { onOpen(ch.file); }, title: "点击阅读正文" },
                 h("td", null, h("span", { className: "myt-chPath" }, chWhere(ch) || "—")),
                 h("td", null, h("span", { className: "myt-chTitle" }, orDash(ch.title))),
                 h("td", null, statusBadge(ch.status)),
                 h("td", null, h("span", { className: "myt-wordsCell" }, fmtNum(ch.words))),
                 h("td", null, h("div", { className: "myt-summaryCell myt-muted" }, orDash(ch.summary))));
             }))))
-          : (chapters.length ? h(Empty, { text: "该状态下没有章节" }) : h(Empty, { text: "chapters/ 目录还没有章节文件" })),
-        openFile ? h(MaskPortal, {
-          className: "myt-drawerMask",
-          onMouseDown: function (e) { if (e.target === e.currentTarget) setOpenFile(null); },
-        },
-          h("aside", { className: "myt-drawer", role: "dialog", "aria-modal": "true", "aria-label": "章节详情" },
-            h("div", { className: "myt-drawerHead" },
-              h("h2", { className: "myt-drawerTitle" }, openCh ? chFullTitle(openCh) : openFile),
-              h("div", { className: "myt-heroMeta" }, openCh ? statusBadge(openCh.status) : null,
-                h("button", {
-                  type: "button", className: "myt-btn myt-copyBtn",
-                  title: "复制章节文件路径", "aria-label": "复制章节文件路径",
-                  onClick: copyChapterPath,
-                }, ic("IconCopyOutlineRegular", 13), "复制路径"),
-                h("button", { type: "button", className: "myt-closeBtn", "aria-label": "关闭抽屉", onClick: function () { setOpenFile(null); } }, h("span", { className: "myt-closeGlyph", "aria-hidden": "true" }, "×")))),
-            h("div", { className: "myt-drawerBody" },
-              !detail || detail.loading ? h("div", { className: "myt-stack" }, h("div", { className: "myt-skel myt-skelRow" }), h("div", { className: "myt-skel myt-skelRow", style: { width: "80%" } }), h("div", { className: "myt-skel myt-skelRow", style: { width: "64%" } }))
-                : detail.err ? h(ErrorStrip, { text: "正文读取失败：" + detail.err, onRetry: function () { loadDetail(openFile); } })
-                  : [
-                      (function () {
-                        var ol = detail.data && detail.data.outline;
-                        // 有章纲：对照栏置顶（可折叠，默认展开）；无章纲：一行
-                        // 淡字提示——共创模式下这是「先要章纲」的信号。
-                        return ol ? h(OutlinePanel, { key: "outline", outline: ol })
-                          : h("div", { key: "outline-none", className: "myt-outlineEmpty" }, "暂无章纲");
-                      })(),
-                      h("pre", { key: "body", className: "myt-chapterBody" }, (detail.data && detail.data.body) || "（空章节）"),
-                    ],
-              openCh ? h("div", { className: "myt-dimGrid" }, FIVE_DIMS.map(function (dim) {
-                return h("div", { key: dim[0], className: "myt-dim" },
-                  h("div", { className: "myt-dimLabel" }, dim[1]),
-                  h("div", { className: "myt-dimText" }, orDash(openCh[dim[0]])));
-              })) : null),
-            openCh ? h("div", { className: "myt-drawerFoot" },
-              (function () {
-                var idx = STATUS_FLOW.indexOf(openCh.status);
-                var next = idx !== -1 && idx < STATUS_FLOW.length - 1 ? STATUS_FLOW[idx + 1] : null;
-                if (!next) return h("span", { className: "myt-muted" }, "已定稿（终态）");
-                return [h("span", { className: "myt-muted", key: "t" }, "状态流转："),
-                  h("button", { key: "b", type: "button", className: "myt-btn myt-btnPrimary", disabled: flowBusy, onClick: function () { advance(openCh); } },
-                    flowBusy ? "流转中…" : "推进到「" + STATUS_LABEL[next] + "」")];
-              })()) : null)) : null);
+          : (chapters.length ? h(Empty, { text: "该状态下没有章节" }) : h(Empty, { text: "chapters/ 目录还没有章节文件" })));
     }
 
     // ── 角色 tab：卡墙 + 全卡弹层 ───────────────────────────────────────────
@@ -940,20 +1206,28 @@ window.__ModuleLoader__.load({
             items.map(function (fs) {
               var next = FS_FLOW[col] || null;
               var busy = busyId === fs.id;
+              // status 行缺失（服务端要求每条恰一处 status，写必 409）：禁用流
+              // 转/弃用按钮，降级为只读展示并给提示，避免「可点但必失败」。
+              var noStatus = !fs.status;
+              var noWrite = !fs.id || noStatus;
+              var noWriteTip = !fs.id
+                ? "该条目缺 id，无法写状态"
+                : "该条目缺 status 行，服务端会拒绝流转（409）；请先在 foreshadows.yml 补上 status";
               var chRange = [fs.planted_chapter || "埋设章未标", fs.expected_resolve].filter(Boolean).join(" → ");
               return h("div", { key: fs.id || fs.title, className: "myt-fsCard" },
                 h("div", { className: "myt-fsTitle" },
                   priDot(fs.priority), h("span", null, orDash(fs.title) || orDash(fs.id)),
                   // 回填徽章（五期账本回填）：区别于写前规划条目，悬浮见来源。
-                  fs.source === "backfill" ? h("span", { className: "myt-backfillBadge", title: "从作者正文回填" }, "回填") : null),
+                  fs.source === "backfill" ? h("span", { className: "myt-backfillBadge", title: "从作者正文回填" }, "回填") : null,
+                  noStatus ? h("span", { className: "myt-fsNoStatus", title: noWriteTip }, "缺 status") : null),
                 h("div", { className: "myt-fsMeta" },
                   h("span", null, col === "resolved" && fs.resolved_chapter ? "回收于 " + fs.resolved_chapter : chRange),
                   fs.priority && fs.priority !== "normal" ? h("span", null, "优先级 " + (PRI_LABEL[fs.priority] || fs.priority)) : null),
                 fs.notes ? h("div", { className: "myt-fsNotes", title: fs.notes }, fs.notes) : null,
                 h("div", { className: "myt-fsActions" },
-                  next ? h("button", { type: "button", className: "myt-btn", disabled: busy || !fs.id, title: fs.id ? undefined : "该条目缺 id，无法写状态", onClick: function () { setStatus(fs, next); } }, busy ? "推进中…" : (col === "planted" ? "推进" : "回收")) : null,
+                  next ? h("button", { type: "button", className: "myt-btn", disabled: busy || noWrite, title: noWriteTip, onClick: function () { setStatus(fs, next); } }, busy ? "推进中…" : (col === "planted" ? "推进" : "回收")) : null,
                   col !== "resolved" && col !== "abandoned"
-                    ? h("button", { type: "button", className: "myt-btn myt-btnDanger", disabled: busy || !fs.id, onClick: function () { setStatus(fs, "abandoned"); } }, "弃用") : null));
+                    ? h("button", { type: "button", className: "myt-btn myt-btnDanger", disabled: busy || noWrite, title: noWriteTip, onClick: function () { setStatus(fs, "abandoned"); } }, "弃用") : null));
             }),
             items.length ? null : h("div", { className: "myt-muted" }, "空"));
         })) : h(Empty, { text: "foreshadows.yml 还没有伏笔条目" }));
@@ -985,7 +1259,10 @@ window.__ModuleLoader__.load({
       var world = snap.world || [];
       var science = snap.science || [];
       var research = snap.research || [];
-      var groups = {};
+      // 无原型容器：key 来自数据文件的自由文本（category），值为
+      // constructor/__proto__/toString 等时若用普通 {} 会命中 Object.prototype
+      // 真值 → TypeError → 整面板白屏；Object.create(null) 杜绝。
+      var groups = Object.create(null);
       world.forEach(function (w) {
         var key = w.category || "未分类";
         if (!groups[key]) groups[key] = [];
@@ -1003,7 +1280,7 @@ window.__ModuleLoader__.load({
                   h("div", { className: "myt-worldHead" },
                     h("span", { className: "myt-worldName" }, orDash(w.name)),
                     (w.tags || []).length ? h("span", { className: "myt-tagRow" }, w.tags.map(function (t, j) { return h("span", { key: j, className: "myt-tag" }, t); })) : null),
-                  w.description ? h("div", { className: "myt-worldDesc" }, w.description) : null);
+                  w.description ? h(MdView, { text: w.description, className: "myt-worldDesc" }) : null);
               }));
           })) : h(Empty, { text: "world/ 目录还没有设定条目" })),
         h("div", { className: "myt-card" },
@@ -1016,7 +1293,7 @@ window.__ModuleLoader__.load({
                 h("span", { className: "myt-worldName" }, orDash(s.name)),
                 h("span", { className: "myt-badge myt-sciTag", "data-label": label || "hypothesis", title: s.label && !label ? s.label : undefined },
                   label ? SCI_LABEL[label] : (s.label || "未标级"))),
-              s.description ? h("div", { className: "myt-worldDesc" }, s.description) : null,
+              s.description ? h(MdView, { text: s.description, className: "myt-worldDesc" }) : null,
               (s.references || []).length ? h("div", { className: "myt-refList" },
                 s.references.map(function (r, j) { return h("span", { key: j, className: "myt-refItem" }, "参考 " + (j + 1) + "：" + r); })) : null);
           })) : h(Empty, { text: "science/ 目录还没有科学设定" })),
@@ -1042,13 +1319,14 @@ window.__ModuleLoader__.load({
       }
       var clues = snap.clues || [];
       var memories = snap.memories || [];
-      var clueGroups = {};
+      // 无原型容器：kind/category 是数据文件自由文本，见 WorldTab 处说明。
+      var clueGroups = Object.create(null);
       clues.forEach(function (c) {
         var key = c.kind || "未分类";
         if (!clueGroups[key]) clueGroups[key] = [];
         clueGroups[key].push(c);
       });
-      var memGroups = {};
+      var memGroups = Object.create(null);
       memories.forEach(function (m) {
         var key = m.category || "未分类";
         if (!memGroups[key]) memGroups[key] = [];
@@ -1105,24 +1383,26 @@ window.__ModuleLoader__.load({
       var _tip = useState(null), tip = _tip[0], setTip = _tip[1]; // {x, y, text}
       var wrapRef = useRef(null);
       var canvasRef = useRef(null);
-      var simRef = useRef(null);
+      var tipRafRef = useRef(0); // hover 提示 rAF 句柄：卸载/换图时取消在途合帧
       // 数据准备：>30 角色只留 relations 相关节点；角色空时退化为关系端点名。
-      var graph = (function () {
-        var byName = {};
+      // useMemo 缓存：hover 提示等重渲染不再重复建图（原渲染体内 IIFE 每帧重建）。
+      // 容器用无原型对象：角色名/关系端点是数据文件自由文本，见 WorldTab 处说明。
+      var graph = useMemo(function () {
+        var byName = Object.create(null);
         chars.forEach(function (c) { if (c && c.name && !byName[c.name]) byName[c.name] = c; });
-        var deg = {};
+        var deg = Object.create(null);
         rels.forEach(function (r) { deg[r.a] = (deg[r.a] || 0) + 1; deg[r.b] = (deg[r.b] || 0) + 1; });
         var names = chars.length ? chars.map(function (c) { return c.name; }) : Object.keys(deg);
         var linked = names.filter(function (n) { return deg[n]; });
         var drawNames = names.length > 30 ? linked : names;
         var unlinked = names.filter(function (n) { return drawNames.indexOf(n) === -1; });
         var nodes = drawNames.map(function (n) { return { id: n, role: byName[n] ? byName[n].role : null, x: 0, y: 0, vx: 0, vy: 0, fixed: false }; });
-        var idx = {};
+        var idx = Object.create(null);
         nodes.forEach(function (nd, i) { idx[nd.id] = i; });
         var edges = rels.filter(function (r) { return idx[r.a] !== undefined && idx[r.b] !== undefined; })
           .map(function (r) { return { a: idx[r.a], b: idx[r.b], type: r.type || "", desc: r.description || "", w: edgeWidth(r.intensity) }; });
         return { nodes: nodes, edges: edges, unlinked: unlinked };
-      })();
+      }, [snap]); // chars/rels 均由 snap 派生，snap 不变则图不变
       useEffect(function () {
         var wrap = wrapRef.current;
         var canvas = canvasRef.current;
@@ -1130,8 +1410,7 @@ window.__ModuleLoader__.load({
         var ctx = canvas.getContext("2d");
         if (!ctx) return undefined;
         var dpr = (window.devicePixelRatio || 1) > 0 ? window.devicePixelRatio || 1 : 1;
-        var sim = { zoom: 1, drag: null, raf: 0, frame: 0, w: 0, h: 0, tokens: null, mx: -1, my: -1 };
-        simRef.current = sim;
+        var sim = { zoom: 1, drag: null, raf: 0, frame: 0, w: 0, h: 0, tokens: null };
         // 令牌缓存：每 30 帧重读 computed style，浅/深色切换约半秒内跟上。
         function readTokens() {
           var cs = getComputedStyle(document.body);
@@ -1282,18 +1561,23 @@ window.__ModuleLoader__.load({
         }
         function onMove(e) {
           var p = localXY(e);
-          sim.mx = p.x; sim.my = p.y;
           if (sim.drag) {
             var w = toWorld(p.x, p.y);
             sim.drag.node.x = w.x; sim.drag.node.y = w.y;
             return;
           }
-          var e2 = hitEdge(p.x, p.y);
-          if (e2) {
-            setTip({ x: p.x, y: p.y, text: (e2.type ? e2.type + "：" : "") + (e2.desc || "（无描述）") });
-          } else {
-            setTip(function (prev) { return prev ? null : prev; });
-          }
+          // hover 提示 rAF 节流：mousemove 高频触发，合帧后再命中检测 + setTip，
+          // 避免逐事件整 tab 重渲染（建图已 useMemo，这里再省掉无效重绘）。
+          if (tipRafRef.current) cancelAnimationFrame(tipRafRef.current);
+          tipRafRef.current = requestAnimationFrame(function () {
+            tipRafRef.current = 0;
+            var e2 = hitEdge(p.x, p.y);
+            if (e2) {
+              setTip({ x: p.x, y: p.y, text: (e2.type ? e2.type + "：" : "") + (e2.desc || "（无描述）") });
+            } else {
+              setTip(function (prev) { return prev ? null : prev; });
+            }
+          });
         }
         function onUp() { sim.drag = null; canvas.dataset.dragging = "false"; }
         function onWheel(e) {
@@ -1313,13 +1597,13 @@ window.__ModuleLoader__.load({
         canvas.addEventListener("dblclick", onDbl);
         return function () {
           cancelAnimationFrame(sim.raf);
+          if (tipRafRef.current) { cancelAnimationFrame(tipRafRef.current); tipRafRef.current = 0; }
           if (ro) ro.disconnect();
           canvas.removeEventListener("mousedown", onDown);
           window.removeEventListener("mousemove", onMove);
           window.removeEventListener("mouseup", onUp);
           canvas.removeEventListener("wheel", onWheel);
           canvas.removeEventListener("dblclick", onDbl);
-          simRef.current = null;
         };
       }, [snap]);
       if (!graph.nodes.length) return h(Empty, { text: "没有角色或关系数据，无法绘图" });