dsh-maoying 0.1.19 → 0.1.20

package/lib/client.js

@@ -246,6 +246,9 @@ window.__ModuleLoader__.load({
       if (path === "style-save") return tt("toast.styleSaved");
       if (path === "chapter-save") return tt("toast.chapterSaved");
       if (path === "outline-save") return tt("toast.outlineSaved");
+      if (path === "file-save") return tf("toast.fileSaved", { rel: (d && d.rel) || "" });
+      if (path === "file-create") return tf("toast.fileCreated", { rel: (d && d.rel) || "" });
+      if (path === "file-delete") return tf("toast.fileDeleted", { rel: (d && d.rel) || "" });
       return tt("toast.success");
     }
 
@@ -545,8 +548,8 @@ window.__ModuleLoader__.load({
     }
 
     // ── 页面骨架：顶栏（工作区下拉 + 刷新 + 关闭）+ tab 条 + 内容区 ─────────
-    // 数据流：workspaces 每次打开面板都重拉（懒挂载下关闭不卸载，见下方
-    // activate 监听）；state 跟随选中工作区；写操作 POST 成功后
+    // 数据流：workspaces 与 state 每次打开面板都重拉（懒挂载下关闭不卸载，
+    // 见下方 activate 监听）；state 另跟随选中工作区；写操作 POST 成功后
     // 整份重拉 state（不乐观更新）。选择记 localStorage('maoying.workspace')。
     function PageShell(props) {
       var onClose = props.onClose;
@@ -559,6 +562,8 @@ window.__ModuleLoader__.load({
       var _tb = useState("overview"), tab = _tb[0], setTab = _tb[1];
       // 章节阅读页（整页视图，替代原右侧抽屉）：null = 列表态。
       var _rd = useState(null), readerFile = _rd[0], setReaderFile = _rd[1];
+      // 面板重开序号：每次 activate 广播自增，透传 ChapterReader 驱动本章重拉。
+      var _rs = useState(0), reopenSeq = _rs[0], setReopenSeq = _rs[1];
       // 系统设置：字号档位持久化 + 面板整体缩放（portal 节点读同一 CSS 变量）。
       var _sm = useState(false), showSettings = _sm[0], setShowSettings = _sm[1];
       var _fs = useState(function () {
@@ -754,20 +759,27 @@ window.__ModuleLoader__.load({
         });
       }
       useEffect(function () { loadWorkspaces(); }, [loadWorkspaces]);
-      // 每次打开面板都重拉工作区列表：懒挂载下关闭只是摘掉 active 属性，
-      // 组件不卸载，上面的 mount effect 整个页面生命周期只跑一次，期间外部
-      // （CLI / 其他面板）新建或删除的工作区在重开时看不见。mountPanel 每次
-      // 打开都会广播 dsh-panel-activate（source: "maoying"），借它触发重拉；
-      // 首次打开的广播早于本组件挂载（render 异步调度），收不到也无妨——
-      // mount effect 已覆盖首拉。其余面板的同名广播按 source 过滤掉。
+      // 每次打开面板都重拉工作区列表与整份 state 快照：懒挂载下关闭只是摘掉
+      // active 属性，组件不卸载，上面的 mount effect 整个页面生命周期只跑一
+      // 次，期间外部（CLI / agent / 其他面板）新建/删除的工作区、改动的小说
+      // 内容在重开时看不见——state 原本只跟 effectiveWs 走，同工作区重开不
+      // 会重拉，用户得手点右上角刷新。mountPanel 每次打开都会广播
+      // dsh-panel-activate（source: "maoying"），借它触发三重重拉：workspaces、
+      // state 快照、阅读页本章（reopenSeq 自增）；首次打开的广播早于本组件挂
+      // 载（render 异步调度），收不到也无妨——mount effect 已覆盖首拉。其余
+      // 面板的同名广播按 source 过滤掉。重拉不动编辑中的草稿：loadState 本就
+      // 不碰草稿，阅读页走 silent 刷新（见 ChapterReader）。
       useEffect(function () {
         var onActivate = function (event) {
           var source = event && event.detail && event.detail.source;
-          if (source === "maoying") loadWorkspaces();
+          if (source !== "maoying") return;
+          loadWorkspaces();
+          reload(); // 重开即最新小说内容，不必手点右上角刷新
+          setReopenSeq(function (n) { return n + 1; });
         };
         document.addEventListener(ACTIVATE_EVENT, onActivate);
         return function () { document.removeEventListener(ACTIVATE_EVENT, onActivate); };
-      }, [loadWorkspaces]);
+      }, [loadWorkspaces, reload]);
       useEffect(function () { loadState(effectiveWs); }, [effectiveWs, loadState]);
       // 校正后的选择回写记忆（首次打开 / 记忆失效时自动落位）。
       useEffect(function () {
@@ -807,7 +819,7 @@ window.__ModuleLoader__.load({
         });
       } else if (snap) {
         var tabProps = { snap: snap, reload: reload, wsPath: effectiveWs };
-        if (readerFile) body = h(ChapterReader, { file: readerFile, snap: snap, reload: reload, wsPath: effectiveWs, onBack: function () { setReaderFile(null); } });
+        if (readerFile) body = h(ChapterReader, { file: readerFile, snap: snap, reload: reload, wsPath: effectiveWs, refreshSeq: reopenSeq, 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);
@@ -906,6 +918,8 @@ window.__ModuleLoader__.load({
       var project = snap.project || {};
       // 编辑态：true 时 hero 卡切换为书稿元信息表单（ProjectMetaForm）。
       var _ed = useState(false), editing = _ed[0], setEditing = _ed[1];
+      // 分卷规划账源文件直达（0.1.20 写面）：volumes.yml 整文件可编辑。
+      var _src = useState(null), srcRel = _src[0], setSrcRel = _src[1];
       var totals = snap.totals || {};
       var byStatus = totals.byStatus || {};
       var _b = useState(false), phaseBusy = _b[0], setPhaseBusy = _b[1];
@@ -981,7 +995,8 @@ window.__ModuleLoader__.load({
           }))),
         volumes.length ? h("div", { className: "myt-card" },
           h("div", { className: "myt-cardHead" }, h("h3", { className: "myt-cardTitle" }, tt("overview.volumes")),
-            h("span", { className: "myt-boardCount" }, volumes.length)),
+            h("span", { className: "myt-boardCount" }, volumes.length),
+            srcEditBtn("volumes.yml", function () { setSrcRel("volumes.yml"); })),
           h("div", { className: "myt-stack" }, volumes.map(function (v, i) {
             return h("div", { key: v.id || i, className: "myt-worldGroup" },
               h("div", { className: "myt-listHead" },
@@ -999,7 +1014,8 @@ window.__ModuleLoader__.load({
                   h("span", { className: "myt-chPath" }, chWhere(ch)),
                   h("span", { className: "myt-wordsCell" }, tf("common.charCount", { n: fmtNum(ch.words) })));
               }))
-            : h(Empty, { text: tt("chapters.empty") })));
+             : h(Empty, { text: tt("chapters.empty") })),
+        srcRel ? h(SourceEditorModal, { title: tt("src.editSource"), rel: srcRel, wsPath: wsPath, onClose: function () { setSrcRel(null); }, onSaved: reload }) : null);
     }
 
     // ── 轻量 Markdown 渲染（零依赖）：先整体 HTML 转义再施加 md 变换，杜绝
@@ -1146,6 +1162,20 @@ window.__ModuleLoader__.load({
         "toast.prefix": "毛颖创作台：{msg}", "toast.success": "操作成功", "toast.indexRebuilt": "索引已重建（{n} 章）",
         "toast.chapterStatus": "章节状态已更新", "toast.chapterCreated": "已从章纲建章「{title}」（待写）", "toast.foreshadowStatus": "伏笔状态已更新", "toast.phaseAdvanced": "阶段已推进到「{phase}」",
         "toast.styleSaved": "写作风格已保存", "toast.chapterSaved": "章节正文已保存", "toast.outlineSaved": "章纲已保存",
+        "src.modalAria": "源文件编辑", "src.closeAria": "关闭源文件编辑",
+        "src.editSource": "编辑源文件", "src.editSourceTip": "编辑源文件：{rel}",
+        "src.deleteFile": "删除文件", "src.deleteTip": "删除文件：{rel}",
+        "src.loading": "源文件加载中…", "src.loadFailed": "源文件读取失败：{msg}",
+        "src.editHint": "直接编辑文件全文；保存时做结构校验（账本 yml 须解析为条目数组、md 实体卡须带 frontmatter 围栏），语义问题交给保存后的静态体检。",
+        "src.conflictReloaded": "文件已被外部修改，草稿已丢弃，已放回磁盘最新内容。",
+        "src.slugLabel": "文件名 slug", "src.slugPh": "如 lin-waner（小写字母/数字与 -）", "src.slugInvalid": "slug 只接受小写字母/数字与 -，且以字母或数字开头",
+        "src.createHint": "内容已按模板预填，可修改后再创建。", "src.create": "创建", "src.creating": "创建中…",
+        "src.confirmTitle": "确认删除", "src.confirmText": "即将删除 {rel}。此操作不可逆——后悔靠 git 回滚；删除后静态体检会把指向它的悬空引用（伏笔/时间线/关系等）标为问题。",
+        "src.confirmDelete": "确认删除", "src.deleting": "删除中…",
+        "toast.fileSaved": "已保存 {rel}", "toast.fileCreated": "已创建 {rel}", "toast.fileDeleted": "已删除 {rel}",
+        "reader.createOutline": "新建章纲", "reader.deleteChapter": "删除章节",
+        "outline.deleteBtn": "删除章纲",
+        "char.createBtn": "新建角色", "world.createBtn": "新建设定", "world.createScienceBtn": "新建科学设定",
         "api.notJson": "响应不是 JSON（HTTP {code}）", "api.timeout": "请求超时（{s} 秒）",
         "status.pending": "待写", "status.writing": "写作中", "status.review": "审校中", "status.accepted": "已定稿", "status.rawSuffix": "（{raw}）",
         "phase.idea": "立意", "phase.setting": "设定", "phase.outline": "大纲", "phase.writing": "写作", "phase.review": "审校",
@@ -1168,7 +1198,7 @@ window.__ModuleLoader__.load({
         "timeline.empty": "timeline.yml 还没有时间线条目", "timeline.importance": "重要度 {n}", "timeline.linkedChapter": "关联章节：{ch}",
         "world.title": "世界观条目", "world.empty": "world/ 目录还没有设定条目", "world.science": "科学设定",
         "world.scienceEmpty": "science/ 目录还没有科学设定", "world.research": "资料检索", "world.ref": "参考 {n}：{r}",
-        "world.researchEmpty": "research/ 目录还没有考据资料", "world.subTabsAria": "设定分区",
+        "world.researchEmpty": "research/ 目录还没有考据资料", "world.subTabsAria": "设定分区", "world.catTabsAria": "世界观分类",
         "relations.title": "角色关系图", "relations.counts": "{n} 节点 · {m} 关系",
         "relations.help": "拖节点固定位置 · 滚轮或 ＋/－ 按钮缩放 · 双击复位 · 悬停边看关系描述 · 右上角按钮全屏",
         "relations.unlinkedTitle": "未入图角色（无关系边）", "relations.noData": "没有角色或关系数据，无法绘图",
@@ -1246,6 +1276,20 @@ window.__ModuleLoader__.load({
         "toast.prefix": "Maoying Studio: {msg}", "toast.success": "Success", "toast.indexRebuilt": "Index rebuilt ({n} chapters)",
         "toast.chapterStatus": "Chapter status updated", "toast.chapterCreated": "Created chapter \"{title}\" from the outline (pending)", "toast.foreshadowStatus": "Foreshadowing status updated", "toast.phaseAdvanced": "Phase advanced to {phase}",
         "toast.styleSaved": "Style baseline saved", "toast.chapterSaved": "Chapter text saved", "toast.outlineSaved": "Outline saved",
+        "src.modalAria": "Source file editor", "src.closeAria": "Close source editor",
+        "src.editSource": "Edit source file", "src.editSourceTip": "Edit source file: {rel}",
+        "src.deleteFile": "Delete file", "src.deleteTip": "Delete file: {rel}",
+        "src.loading": "Loading source file…", "src.loadFailed": "Failed to load source file: {msg}",
+        "src.editHint": "Edit the whole file; saving runs structural validation (ledger yml must parse as an entry array, md entity cards must carry frontmatter fences) — semantics are left to the static check after saving.",
+        "src.conflictReloaded": "The file was changed externally; your draft was dropped and the latest on-disk content has been restored.",
+        "src.slugLabel": "File slug", "src.slugPh": "e.g. lin-waner (lowercase letters/digits and -)", "src.slugInvalid": "Slug accepts lowercase letters/digits and - only, starting with a letter or digit",
+        "src.createHint": "Pre-filled from the template — adjust it, then create.", "src.create": "Create", "src.creating": "Creating…",
+        "src.confirmTitle": "Confirm delete", "src.confirmText": "About to delete {rel}. This is irreversible — recovery is via git rollback; afterwards the static check will flag dangling references to it (foreshadows / timeline / relations etc.).",
+        "src.confirmDelete": "Delete", "src.deleting": "Deleting…",
+        "toast.fileSaved": "Saved {rel}", "toast.fileCreated": "Created {rel}", "toast.fileDeleted": "Deleted {rel}",
+        "reader.createOutline": "Create outline", "reader.deleteChapter": "Delete chapter",
+        "outline.deleteBtn": "Delete outline",
+        "char.createBtn": "New character", "world.createBtn": "New world entry", "world.createScienceBtn": "New science entry",
         "api.notJson": "Response is not JSON (HTTP {code})", "api.timeout": "Request timed out ({s} s)",
         "status.pending": "Pending", "status.writing": "Writing", "status.review": "Review", "status.accepted": "Accepted", "status.rawSuffix": "({raw})",
         "phase.idea": "Idea", "phase.setting": "Setting", "phase.outline": "Outline", "phase.writing": "Writing", "phase.review": "Review",
@@ -1268,7 +1312,7 @@ window.__ModuleLoader__.load({
         "timeline.empty": "No entries in timeline.yml yet", "timeline.importance": "Importance {n}", "timeline.linkedChapter": "Related chapter: {ch}",
         "world.title": "Worldbuilding entries", "world.empty": "No worldbuilding entries in world/ yet", "world.science": "Science settings",
         "world.scienceEmpty": "No science entries in science/ yet", "world.research": "Research", "world.ref": "Ref {n}: {r}",
-        "world.researchEmpty": "No research notes in research/ yet", "world.subTabsAria": "Worldbuilding sections",
+        "world.researchEmpty": "No research notes in research/ yet", "world.subTabsAria": "Worldbuilding sections", "world.catTabsAria": "Worldbuilding categories",
         "relations.title": "Character relations", "relations.counts": "{n} nodes · {m} relations",
         "relations.help": "Drag a node to pin it · scroll or the ＋/－ buttons to zoom · double-click to reset · hover an edge for its description · top-right button for full screen",
         "relations.unlinkedTitle": "Unlinked characters (no relation edges)", "relations.noData": "No character or relation data to draw",
@@ -1370,6 +1414,7 @@ window.__ModuleLoader__.load({
       var wsPath = props.wsPath;
       var snap = props.snap;
       var reload = props.reload;
+      var reopenSeq = props.refreshSeq || 0; // 面板重开序号（PageShell 广播自增）
       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];
@@ -1388,6 +1433,21 @@ window.__ModuleLoader__.load({
       // （只在保存冲突路径置位；顶栏刷新、状态流转等其他重拉不动正在编辑的草稿）。
       var bodyResetRef = useRef(false);
       var olResetRef = useRef(false);
+      // 0.1.20 写面：新建章纲（无章纲态）/ 删除章节 / 删除章纲（各带确认弹层）。
+      var stem = file.replace(/\.md$/i, "");
+      var stemOk = /^v\d+-c\d+$/.test(stem); // 章纲 rel 挂钩 vXX-cXXX stem，不合规范不亮按钮
+      var _co = useState(false), coBusy = _co[0], setCoBusy = _co[1];
+      var _dc = useState(false), delChapterOpen = _dc[0], setDelChapterOpen = _dc[1];
+      var _do = useState(false), delOutlineOpen = _do[0], setDelOutlineOpen = _do[1];
+      function createOutline() {
+        if (coBusy || !stemOk) return;
+        setCoBusy(true);
+        // 骨架照 spec 六件章纲的其中五件预填（章尾钩子独立成节，留给写的人
+        // 展开成 `## 钩子`）；服务端只验形状，成败提示走 toast 通道。
+        apiPost("file-create", { path: wsPath, rel: "outlines/" + stem + ".md", text: outlineTemplateOf(ch, stem) })
+          .then(function () { return reload().then(function () { return loadDetail(file); }); })
+          .catch(function () {}).finally(function () { setCoBusy(false); });
+      }
       var loadDetail = useCallback(function (f, opts) {
         var seq = ++detailSeqRef.current;
         if (!f) { setDetail(null); return; }
@@ -1404,6 +1464,12 @@ window.__ModuleLoader__.load({
         });
       }, [wsPath]);
       useEffect(function () { loadDetail(file); }, [file, loadDetail]);
+      // 面板重开（reopenSeq 递增）：重拉本章让磁盘最新内容即时可见。编辑中
+      // 走 silent——不闪骨架、不打断 textarea，draft 只在 409 冲突重置路径才
+      // 动（上方注释的纪律不变）；阅读态非 silent，换血后照常渲染新正文。
+      useEffect(function () {
+        if (reopenSeq > 0) loadDetail(file, { silent: editing });
+      }, [reopenSeq]);
       // 切章必须退出编辑态并清草稿：草稿属于「那一章的那一次编辑」，跨章带过
       // 去会把 A 章的文字存进 B 章文件。
       useEffect(function () {
@@ -1510,15 +1576,31 @@ window.__ModuleLoader__.load({
               type: "button", className: "myt-btn myt-copyBtn",
               title: tt("reader.copyPathTip"), "aria-label": tt("reader.copyPathTip"),
               onClick: copyChapterPath,
-            }, ic("IconCopyOutlineRegular", 13), tt("reader.copyPath")))),
+            }, ic("IconCopyOutlineRegular", 13), tt("reader.copyPath")),
+            // 删除章节（0.1.20 写面）：服务端不做二次确认，弹层在下方强制；
+            // 删除成功 → 重拉快照 + 退出阅读页回列表（章节已不存在）。
+            h("button", {
+              type: "button", className: "myt-btn myt-btnDanger",
+              title: tt("reader.deleteChapter"), "aria-label": tt("reader.deleteChapter"),
+              onClick: function () { setDelChapterOpen(true); },
+            }, tt("reader.deleteChapter")))),
         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: tf("reader.loadFailed", { msg: detail.err }), onRetry: function () { loadDetail(file); } })
               : [
                   (function () {
                     var ol = detail.data && detail.data.outline;
-                    return ol ? h(OutlinePanel, { key: "outline", outline: ol, editor: outlineEditor() })
-                      : h("div", { key: "outline-none", className: "myt-outlineEmpty" }, tt("reader.noOutline"));
+                    return ol ? h(OutlinePanel, { key: "outline", outline: ol, editor: outlineEditor(), onDelete: stemOk ? function () { setDelOutlineOpen(true); } : null })
+                      : [
+                          h("div", { key: "outline-none", className: "myt-outlineEmpty" }, tt("reader.noOutline")),
+                          // 新建章纲（0.1.20 写面）：outlines/<stem>.md 原不存在才走到
+                          // 这里；预填五件内容骨架，建好即重拉详情点亮章纲对照栏。
+                          stemOk ? h("button", {
+                            key: "outline-create", type: "button", className: "myt-btn",
+                            disabled: coBusy, title: tt("reader.createOutline"), "aria-label": tt("reader.createOutline"),
+                            onClick: createOutline,
+                          }, coBusy ? tt("src.creating") : tt("reader.createOutline")) : null,
+                        ];
                   })(),
                   editing
                     ? h("div", { key: "body", className: "myt-bodyEdit" },
@@ -1546,7 +1628,29 @@ window.__ModuleLoader__.load({
             return [h("span", { className: "myt-muted", key: "t" }, tt("reader.statusFlow")),
               h("button", { key: "b", type: "button", className: "myt-btn myt-btnPrimary", disabled: flowBusy, onClick: advance },
                 flowBusy ? tt("reader.flowing") : tf("reader.advanceTo", { next: tt("status." + next) }))];
-          })()) : null);
+          })()) : null,
+        delChapterOpen ? h(ConfirmModal, {
+          title: tt("reader.deleteChapter"),
+          text: tf("src.confirmText", { rel: "chapters/" + file }),
+          onCancel: function () { setDelChapterOpen(false); },
+          onConfirm: function () {
+            return apiPost("file-delete", { path: wsPath, rel: "chapters/" + file }).then(function () {
+              setDelChapterOpen(false);
+              return reload().then(onBack); // 章已删：重拉快照后退出阅读页回列表
+            });
+          },
+        }) : null,
+        delOutlineOpen ? h(ConfirmModal, {
+          title: tt("outline.deleteBtn"),
+          text: tf("src.confirmText", { rel: "outlines/" + stem + ".md" }),
+          onCancel: function () { setDelOutlineOpen(false); },
+          onConfirm: function () {
+            return apiPost("file-delete", { path: wsPath, rel: "outlines/" + stem + ".md" }).then(function () {
+              setDelOutlineOpen(false);
+              return reload().then(function () { return loadDetail(file); }); // 章纲栏熄灭、空态亮出
+            });
+          },
+        }) : null);
     }
 
     // ── 书稿元信息编辑表单（概览「编辑」按钮展开）：可视化 project.yml 平
@@ -1698,6 +1802,13 @@ window.__ModuleLoader__.load({
             onClick: function (e) { e.stopPropagation(); ed.start(); },
             onKeyDown: function (e) { if (e.key === "Enter" || e.key === " ") { e.preventDefault(); e.stopPropagation(); ed.start(); } },
           }, ic("IconEditOutlineRegular", 12), tt("reader.edit")) : null,
+          // 删除章纲（0.1.20 写面）：同 head-span 形态；确认弹层由 ChapterReader 渲染。
+          props.onDelete && ed !== null && !ed.active ? h("span", {
+            className: "myt-outlineEditBtn myt-outlineDelBtn", role: "button", tabIndex: 0,
+            title: tt("outline.deleteBtn"), "aria-label": tt("outline.deleteBtn"),
+            onClick: function (e) { e.stopPropagation(); props.onDelete(); },
+            onKeyDown: function (e) { if (e.key === "Enter" || e.key === " ") { e.preventDefault(); e.stopPropagation(); props.onDelete(); } },
+          }, tt("outline.deleteBtn")) : null,
           h("span", { className: "myt-outlineChevron", "aria-hidden": "true" },
             ic(open ? "IconChevronDownOutlineRegular" : "IconChevronRightOutlineRegular", 14))),
         open ? (ed !== null && ed.active
@@ -1764,6 +1875,171 @@ window.__ModuleLoader__.load({
                 : h(MdView, { text: (detail.data && detail.data.body) || tt("outline.empty"), className: "myt-outlineBody" }))));
     }
 
+    // ── 受管文件通用弹层三件套（0.1.20「全量可编辑写面」）────────────────────
+    // 新建实体卡的预填模板（服务端只验形状，内容由客户端模板兜底——spec 各
+    // 文件的最小骨架；数据文件按约定中文书写，不随界面语言切换）。
+    var MANAGED_SLUG_RE = /^[a-z0-9][a-z0-9-]*$/; // 与服务端 managedRelCheck 同一条正则
+    var TPL_CHARACTER = "---\nname: \nrole: supporting\n---\n\n";
+    var TPL_WORLD = "---\ncategory: 地点\n---\n\n";
+    var TPL_SCIENCE = "---\nlabel: known\n---\n\n";
+    function outlineTemplateOf(ch, stem) {
+      var num = ch && ch.num ? ch.num : ((stem.match(/c(\d+)/i) || [])[1] || "?");
+      var title = ch && ch.title ? " " + ch.title : "";
+      return "# 第" + num + "章" + title + " 章纲\n\n- 本章目标：\n- 节拍：\n- 出场角色：\n- 需埋/需收伏笔：\n- 与前章接口：\n";
+    }
+    // 各 tab 复用的「编辑源文件 / 删除文件」小按钮：title 点名文件路径，
+    // 删除走红色按钮（确认弹层由调用方持 state 渲染）。
+    function srcEditBtn(rel, onOpen) {
+      return h("button", {
+        type: "button", className: "myt-btn",
+        title: tf("src.editSourceTip", { rel: rel }), "aria-label": tf("src.editSourceTip", { rel: rel }),
+        onClick: onOpen,
+      }, ic("IconEditOutlineRegular", 13), tt("src.editSource"));
+    }
+    function srcDeleteBtn(rel, onAsk) {
+      return h("button", {
+        type: "button", className: "myt-btn myt-btnDanger",
+        title: tf("src.deleteTip", { rel: rel }), "aria-label": tf("src.deleteTip", { rel: rel }),
+        onClick: onAsk,
+      }, tt("src.deleteFile"));
+    }
+    // 编辑既有受管文件全文。打开即 GET file-source（请求序号防快速开关时的
+    // 过期响应，对照 ChapterReader）；保存 POST file-save 带 base_hash 基线，
+    // 409 = 编辑期间文件被外部改过——照 ChapterReader 纪律：草稿丢弃、重拉
+    // 磁盘真值放回编辑器，别让用户在过期基线上盲改。成功后关弹层并触发调用
+    // 方 reload（快照重算），成败提示走 apiPost 的 toast 通道。
+    function SourceEditorModal(props) {
+      var title = props.title;
+      var rel = props.rel;
+      var wsPath = props.wsPath;
+      var onClose = props.onClose;
+      var onSaved = props.onSaved;
+      var _d = useState(null), detail = _d[0], setDetail = _d[1]; // { data, err }
+      var _dr = useState(""), draft = _dr[0], setDraft = _dr[1];
+      var _b = useState(false), busy = _b[0], setBusy = _b[1];
+      var _e = useState(""), err = _e[0], setErr = _e[1];
+      var seqRef = useRef(0);
+      var load = useCallback(function () {
+        var seq = ++seqRef.current;
+        setDetail(null); setErr("");
+        apiGet("file-source", { path: wsPath, rel: rel }).then(function (d) {
+          if (seq !== seqRef.current) return;
+          setDetail({ data: d, err: "" });
+          setDraft(d && typeof d.text === "string" ? d.text : "");
+        }).catch(function (e2) {
+          if (seq !== seqRef.current) return;
+          setDetail({ data: null, err: e2 && e2.message ? e2.message : tt("common.unknownErr") });
+        });
+      }, [wsPath, rel]);
+      useEffect(function () { load(); }, [load]);
+      function save() {
+        if (busy || !detail || !detail.data) return;
+        setBusy(true); setErr("");
+        apiPost("file-save", { path: wsPath, rel: rel, text: draft, base_hash: detail.data.hash }).then(function () {
+          onClose();
+          if (onSaved) onSaved();
+        }).catch(function (e2) {
+          if (e2 && e2.status === 409) { setErr(tt("src.conflictReloaded")); load(); }
+          else setErr(e2 && e2.message ? e2.message : tt("common.unknownErr"));
+        }).finally(function () { setBusy(false); });
+      }
+      return h(MaskPortal, {
+          className: "myt-modalMask",
+          onMouseDown: function (e) { if (e.target === e.currentTarget && !busy) onClose(); },
+        },
+        h("div", { className: "myt-modalCard myt-srcCard", role: "dialog", "aria-modal": "true", "aria-label": tt("src.modalAria") },
+          h("div", { className: "myt-modalHead" },
+            h("h2", { className: "myt-modalTitle" }, title),
+            h("button", { type: "button", className: "myt-closeBtn", "aria-label": tt("src.closeAria"), onClick: onClose }, h("span", { className: "myt-closeGlyph", "aria-hidden": "true" }, "×"))),
+          h("div", { className: "myt-modalBody" },
+            h("div", { className: "myt-srcRel" }, rel),
+            h("div", { className: "myt-muted myt-srcHint" }, tt("src.editHint")),
+            !detail ? h("div", { className: "myt-muted" }, tt("src.loading"))
+              : detail.err ? h(ErrorStrip, { text: tf("src.loadFailed", { msg: detail.err }), onRetry: load })
+                : [
+                    h("textarea", { key: "a", className: "myt-setInput myt-setArea myt-srcArea", rows: 16, spellCheck: false,
+                      value: draft, onChange: function (e) { setDraft(e.target.value); } }),
+                    err ? h(ErrorStrip, { key: "e", text: err }) : null,
+                    h("div", { key: "s", className: "myt-setActions" },
+                      h("button", { type: "button", className: "myt-btn", disabled: busy, onClick: onClose }, tt("novel.cancel")),
+                      h("button", { type: "button", className: "myt-btn myt-btnPrimary", disabled: busy, onClick: save }, busy ? tt("novel.saving") : tt("novel.save"))),
+                  ])));
+    }
+    // 新建受管 md 实体卡（角色/设定/科学设定共用）：slug 客户端预校（与服务
+    // 端同一条正则，错在敲键时就报），内容按模板预填可改；失败（409 已存在等）
+    // 留在弹层内报错，草稿不丢——建卡是低频操作，丢一遍模板重填太伤。
+    function CreateFileModal(props) {
+      var title = props.title;
+      var dir = props.dir;
+      var template = props.template;
+      var wsPath = props.wsPath;
+      var onClose = props.onClose;
+      var onSaved = props.onSaved;
+      var _s = useState(""), slug = _s[0], setSlug = _s[1];
+      var _t = useState(template), text = _t[0], setText = _t[1];
+      var _b = useState(false), busy = _b[0], setBusy = _b[1];
+      var _e = useState(""), err = _e[0], setErr = _e[1];
+      var slugOk = MANAGED_SLUG_RE.test(slug);
+      function create() {
+        if (busy) return;
+        if (!slugOk) { setErr(tt("src.slugInvalid")); return; }
+        setBusy(true); setErr("");
+        apiPost("file-create", { path: wsPath, rel: dir + "/" + slug + ".md", text: text }).then(function () {
+          onClose();
+          if (onSaved) onSaved();
+        }).catch(function (e2) { setErr(e2 && e2.message ? e2.message : tt("common.unknownErr")); })
+          .finally(function () { setBusy(false); });
+      }
+      return h(MaskPortal, {
+          className: "myt-modalMask",
+          onMouseDown: function (e) { if (e.target === e.currentTarget && !busy) onClose(); },
+        },
+        h("div", { className: "myt-modalCard", role: "dialog", "aria-modal": "true", "aria-label": title },
+          h("div", { className: "myt-modalHead" },
+            h("h2", { className: "myt-modalTitle" }, title),
+            h("button", { type: "button", className: "myt-closeBtn", "aria-label": tt("src.closeAria"), onClick: onClose }, h("span", { className: "myt-closeGlyph", "aria-hidden": "true" }, "×"))),
+          h("div", { className: "myt-modalBody" },
+            h("label", { className: "myt-setField" },
+              h("span", { className: "myt-setFieldLabel" }, tt("src.slugLabel")),
+              h("input", { type: "text", className: "myt-setInput", placeholder: tt("src.slugPh"), value: slug, spellCheck: false,
+                onChange: function (e) { setSlug(e.target.value); setErr(""); } })),
+            h("div", { className: "myt-muted myt-srcHint" }, tt("src.createHint")),
+            h("textarea", { className: "myt-setInput myt-setArea myt-srcArea", rows: 10, spellCheck: false,
+              value: text, onChange: function (e) { setText(e.target.value); } }),
+            err ? h(ErrorStrip, { text: err }) : null,
+            h("div", { className: "myt-setActions" },
+              h("button", { type: "button", className: "myt-btn", disabled: busy, onClick: onClose }, tt("novel.cancel")),
+              h("button", { type: "button", className: "myt-btn myt-btnPrimary", disabled: busy || slug === "", onClick: create }, busy ? tt("src.creating") : tt("src.create"))))));
+    }
+    // 删除二次确认（服务端不做二次确认，UI 层强制——删除不可逆，文案点名后
+    // 悔靠 git、check 会标孤儿引用）。onConfirm 返回 promise，在途禁双击；
+    // 成败提示走 apiPost 的 toast 通道。
+    function ConfirmModal(props) {
+      var title = props.title;
+      var text = props.text;
+      var onCancel = props.onCancel;
+      var onConfirm = props.onConfirm;
+      var _b = useState(false), busy = _b[0], setBusy = _b[1];
+      function confirm() {
+        if (busy) return;
+        setBusy(true);
+        Promise.resolve(onConfirm()).catch(function () {}).finally(function () { setBusy(false); });
+      }
+      return h(MaskPortal, {
+          className: "myt-modalMask",
+          onMouseDown: function (e) { if (e.target === e.currentTarget && !busy) onCancel(); },
+        },
+        h("div", { className: "myt-modalCard myt-confirmCard", role: "alertdialog", "aria-modal": "true", "aria-label": title },
+          h("div", { className: "myt-modalHead" },
+            h("h2", { className: "myt-modalTitle" }, title),
+            h("button", { type: "button", className: "myt-closeBtn", "aria-label": tt("src.closeAria"), disabled: busy, onClick: onCancel }, h("span", { className: "myt-closeGlyph", "aria-hidden": "true" }, "×"))),
+          h("div", { className: "myt-modalBody" },
+            h("div", { className: "myt-confirmText" }, text),
+            h("div", { className: "myt-setActions" },
+              h("button", { type: "button", className: "myt-btn", disabled: busy, onClick: onCancel }, tt("novel.cancel")),
+              h("button", { type: "button", className: "myt-btn myt-btnDanger", disabled: busy, onClick: confirm }, busy ? tt("src.deleting") : tt("src.confirmDelete"))))));
+    }
+
     function ChaptersTab(props) {
       var snap = props.snap;
       var wsPath = props.wsPath;
@@ -1885,10 +2161,20 @@ window.__ModuleLoader__.load({
     ];
     function CharactersTab(props) {
       var characters = props.snap.characters || [];
+      var wsPath = props.wsPath;
+      var reload = props.reload;
       var _m = useState(null), modalFile = _m[0], setModalFile = _m[1];
+      // 受管文件三态：编辑 rel / 新建弹层开关 / 删除确认 rel（0.1.20 写面）。
+      var _src = useState(null), srcRel = _src[0], setSrcRel = _src[1];
+      var _new = useState(false), createOpen = _new[0], setCreateOpen = _new[1];
+      var _del = useState(null), delRel = _del[0], setDelRel = _del[1];
       var modal = null;
       for (var i = 0; i < characters.length; i++) { if (characters[i].file === modalFile) { modal = characters[i]; break; } }
       return h("div", { className: "myt-stack" },
+        h("div", { className: "myt-cardHead" },
+          h("h3", { className: "myt-cardTitle" }, tt("tabs.characters")),
+          h("span", { className: "myt-boardCount" }, characters.length),
+          h("button", { type: "button", className: "myt-btn", onClick: function () { setCreateOpen(true); } }, tt("char.createBtn"))),
         characters.length ? h("div", { className: "myt-charWall" }, characters.map(function (c) {
           return h("button", { key: c.file, type: "button", className: "myt-card myt-charCard", onClick: function () { setModalFile(c.file); } },
             h("div", { className: "myt-charHead" },
@@ -1923,7 +2209,27 @@ window.__ModuleLoader__.load({
                     : "—")),
               h("div", { className: "myt-kvRow" },
                 h("span", { className: "myt-kvKey" }, tt("char.file")),
-                h("span", { className: "myt-kvVal" }, modal.file || "—"))))) : null);
+                h("span", { className: "myt-kvVal" }, modal.file || "—")),
+              // 源文件直达（0.1.20 写面）：rel 由快照 basename 拼目录前缀。
+              h("div", { className: "myt-setActions" },
+                h("button", { type: "button", className: "myt-btn", onClick: function () { setSrcRel("characters/" + modal.file); } },
+                  ic("IconEditOutlineRegular", 13), tt("src.editSource")),
+                h("button", { type: "button", className: "myt-btn myt-btnDanger", onClick: function () { setDelRel("characters/" + modal.file); } },
+                  tt("src.deleteFile")))))) : null,
+        srcRel ? h(SourceEditorModal, { title: tt("src.editSource"), rel: srcRel, wsPath: wsPath, onClose: function () { setSrcRel(null); }, onSaved: reload }) : null,
+        createOpen ? h(CreateFileModal, { title: tt("char.createBtn"), dir: "characters", template: TPL_CHARACTER, wsPath: wsPath, onClose: function () { setCreateOpen(false); }, onSaved: reload }) : null,
+        delRel ? h(ConfirmModal, {
+          title: tf("src.deleteTip", { rel: delRel }),
+          text: tf("src.confirmText", { rel: delRel }),
+          onCancel: function () { setDelRel(null); },
+          onConfirm: function () {
+            return apiPost("file-delete", { path: wsPath, rel: delRel }).then(function () {
+              setDelRel(null);
+              if (modalFile && "characters/" + modalFile === delRel) setModalFile(null); // 删的是打开中的卡：详情弹层一并收
+              return reload();
+            });
+          },
+        }) : null);
     }
 
     // ── 伏笔 tab：四列看板（列头计数 + 推进按钮 + priority 色点）────────────
@@ -1939,7 +2245,12 @@ window.__ModuleLoader__.load({
           .then(reload).catch(function () {}).finally(function () { setBusyId(null); });
       }
       var list = snap.foreshadows || [];
+      // 伏笔台账源文件直达（0.1.20 写面）：foreshadows.yml 整文件可编辑。
+      var _src = useState(null), srcRel = _src[0], setSrcRel = _src[1];
       return h("div", { className: "myt-stack" },
+        h("div", { className: "myt-cardHead" },
+          h("h3", { className: "myt-cardTitle" }, tt("tabs.foreshadows")),
+          srcEditBtn("foreshadows.yml", function () { setSrcRel("foreshadows.yml"); })),
         list.length ? h("div", { className: "myt-board" }, FS_ORDER.map(function (col) {
           var items = list.filter(function (f) { return (f.status || "planted") === col; });
           return h("div", { key: col, className: "myt-boardCol" },
@@ -1973,17 +2284,33 @@ window.__ModuleLoader__.load({
                     ? h("button", { type: "button", className: "myt-btn myt-btnDanger", disabled: busy || noWrite, title: noWriteTip, onClick: function () { setStatus(fs, "abandoned"); } }, tt("foreshadow.abandon")) : null));
             }),
             items.length ? null : h("div", { className: "myt-muted" }, tt("foreshadow.colEmpty")));
-        })) : h(Empty, { text: tt("foreshadow.empty") }));
+        })) : h(Empty, { text: tt("foreshadow.empty") }),
+        srcRel ? h(SourceEditorModal, { title: tt("src.editSource"), rel: srcRel, wsPath: wsPath, onClose: function () { setSrcRel(null); }, onSaved: reload }) : null);
     }
 
     // ── 时间线 tab：垂直轴 + importance 点位（1-5 → 大小/深浅）──────────────
     function TimelineTab(props) {
       var items = (props.snap.timeline || []).slice();
+      var wsPath = props.wsPath;
+      var reload = props.reload;
+      // 时间线账本源文件直达（0.1.20 写面）：空态也保留入口——账本空不等于
+      // 不可编辑，恰恰是第一条要从这里写进去。
+      var _src = useState(null), srcRel = _src[0], setSrcRel = _src[1];
+      var head = h("div", { className: "myt-cardHead" },
+        h("h3", { className: "myt-cardTitle" }, tt("tabs.timeline")),
+        srcEditBtn("timeline.yml", function () { setSrcRel("timeline.yml"); }));
       if (items.length) {
         items.sort(function (a, b) { return String(a.year || "").localeCompare(String(b.year || ""), "zh-CN", { numeric: true }); });
       }
-      if (!items.length) return h(Empty, { text: tt("timeline.empty") });
-      return h("div", { className: "myt-card" },
+      if (!items.length) {
+        return h("div", { className: "myt-stack" },
+          head,
+          h(Empty, { text: tt("timeline.empty") }),
+          srcRel ? h(SourceEditorModal, { title: tt("src.editSource"), rel: srcRel, wsPath: wsPath, onClose: function () { setSrcRel(null); }, onSaved: reload }) : null);
+      }
+      return h("div", { className: "myt-stack" },
+        head,
+        h("div", { className: "myt-card" },
         h("div", { className: "myt-timeline" }, items.map(function (t, i) {
           var imp = Math.min(5, Math.max(1, typeof t.importance === "number" ? t.importance : 3));
           return h("div", { key: i, className: "myt-tlRow" },
@@ -1993,7 +2320,8 @@ window.__ModuleLoader__.load({
               h("div", { className: "myt-tlTitle" }, orDash(t.title)),
               t.description ? h("div", { className: "myt-tlDesc" }, t.description) : null,
               t.chapter ? h("div", { className: "myt-tlChapter" }, tf("timeline.linkedChapter", { ch: t.chapter })) : null));
-        })));
+        }))),
+        srcRel ? h(SourceEditorModal, { title: tt("src.editSource"), rel: srcRel, wsPath: wsPath, onClose: function () { setSrcRel(null); }, onSaved: reload }) : null);
     }
 
     // ── 设定 tab：world 按 category 分组 + science 三色标签 ─────────────────
@@ -2141,9 +2469,16 @@ window.__ModuleLoader__.load({
 
     function WorldTab(props) {
       var snap = props.snap;
+      var wsPath = props.wsPath;
+      var reload = props.reload;
       var world = snap.world || [];
       var science = snap.science || [];
       var research = snap.research || [];
+      // 受管文件三态：编辑 rel / 新建分区（world|science）/ 删除确认 rel。
+      // research 是调研笔记目录，v1 无面板入口（快照有卡，写面暂不开放）。
+      var _src = useState(null), srcRel = _src[0], setSrcRel = _src[1];
+      var _new = useState(null), createDir = _new[0], setCreateDir = _new[1];
+      var _del = useState(null), delRel = _del[0], setDelRel = _del[1];
       // 无原型容器：key 来自数据文件的自由文本（category），值为
       // constructor/__proto__/toString 等时若用普通 {} 会命中 Object.prototype
       // 真值 → TypeError → 整面板白屏；Object.create(null) 杜绝。
@@ -2158,11 +2493,16 @@ window.__ModuleLoader__.load({
       // state 存在本组件（切走再切回不丢；卡头 h3 随卡一起只画激活分区）。
       // research 空时原实现整卡隐藏，现 tab 恒在、空态走 world.researchEmpty。
       var _st = useState("world"), subTab = _st[0], setSubTab = _st[1];
+      // world 分区内的二级分类 tab：state 只存用户上次的偏好，快照重拉后该
+      // 分类可能已不存在（条目被删/改名），此时回落第一个分类；null = 首选
+      // 第一个。单分类时不出 tab 条、直接平铺。
+      var _cat = useState(null), catPref = _cat[0], setCatPref = _cat[1];
       var subDefs = [
         ["world", tt("world.title"), world.length],
         ["science", tt("world.science"), science.length],
         ["research", tt("world.research"), research.length],
       ];
+      var activeCat = catPref !== null && groupKeys.indexOf(catPref) !== -1 ? catPref : groupKeys[0];
       return h("div", { className: "myt-stack" },
         h("nav", { className: "myt-subTabs", "aria-label": tt("world.subTabsAria") },
           subDefs.map(function (s) {
@@ -2172,21 +2512,32 @@ window.__ModuleLoader__.load({
             }, s[1], h("span", { className: "myt-boardCount" }, String(s[2])));
           })),
         subTab === "world" ? h("div", { className: "myt-card" },
-          h("div", { className: "myt-cardHead" }, h("h3", { className: "myt-cardTitle" }, tt("world.title"))),
-          groupKeys.length ? h("div", { className: "myt-stack" }, groupKeys.map(function (key) {
-            return h("div", { key: key, className: "myt-worldGroup" },
-              h("div", { className: "myt-listHead" }, key, h("span", { className: "myt-boardCount" }, groups[key].length)),
-              groups[key].map(function (w, i) {
-                return h("div", { key: w.file || i, className: "myt-worldItem" },
-                  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(MdView, { text: w.description, className: "myt-worldDesc" }) : null);
-              }));
+          h("div", { className: "myt-cardHead" },
+            h("h3", { className: "myt-cardTitle" }, tt("world.title")),
+            h("button", { type: "button", className: "myt-btn", onClick: function () { setCreateDir("world"); } }, tt("world.createBtn"))),
+          // 多分类：二级子 tab 条（分类名 + 条目计数），分组头不再需要——tab
+          // 已承载分类名与计数；单分类/无分类不出 tab 条直接平铺。
+          groupKeys.length > 1 ? h("nav", { className: "myt-subTabs myt-subTabsInner", "aria-label": tt("world.catTabsAria") },
+            groupKeys.map(function (key) {
+              return h("button", {
+                key: key, type: "button", className: "myt-subTab", "data-active": activeCat === key ? "true" : undefined,
+                onClick: function () { setCatPref(key); },
+              }, key, h("span", { className: "myt-boardCount" }, String(groups[key].length)));
+            })) : null,
+          groupKeys.length ? h("div", { className: "myt-stack" }, groups[activeCat].map(function (w, i) {
+            return h("div", { key: w.file || i, className: "myt-worldItem" },
+              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(MdView, { text: w.description, className: "myt-worldDesc" }) : null,
+              h("div", { className: "myt-itemActions" },
+                srcEditBtn("world/" + w.file, function () { setSrcRel("world/" + w.file); }),
+                srcDeleteBtn("world/" + w.file, function () { setDelRel("world/" + w.file); })));
           })) : h(Empty, { text: tt("world.empty") })) : null,
         subTab === "science" ? h("div", { className: "myt-card" },
           h("div", { className: "myt-cardHead" }, h("h3", { className: "myt-cardTitle" }, tt("world.science")),
-            h("span", { className: "myt-boardCount" }, science.length)),
+            h("span", { className: "myt-boardCount" }, science.length),
+            h("button", { type: "button", className: "myt-btn", onClick: function () { setCreateDir("science"); } }, tt("world.createScienceBtn"))),
           science.length ? h("div", { className: "myt-stack" }, science.map(function (s, i) {
             var label = ["known", "extrapolation", "hypothesis"].indexOf(s.label) !== -1 ? s.label : null;
             return h("div", { key: s.file || i, className: "myt-worldItem" },
@@ -2196,7 +2547,10 @@ window.__ModuleLoader__.load({
                   label ? tt("sci." + label) : (s.label || tt("world.unlabeled")))),
               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" }, tf("world.ref", { n: j + 1, r: r })); })) : null);
+                s.references.map(function (r, j) { return h("span", { key: j, className: "myt-refItem" }, tf("world.ref", { n: j + 1, r: r })); })) : null,
+              h("div", { className: "myt-itemActions" },
+                srcEditBtn("science/" + s.file, function () { setSrcRel("science/" + s.file); }),
+                srcDeleteBtn("science/" + s.file, function () { setDelRel("science/" + s.file); })));
           })) : h(Empty, { text: tt("world.scienceEmpty") })) : null,
         subTab === "research" ? h("div", { className: "myt-card" },
           h("div", { className: "myt-cardHead" }, h("h3", { className: "myt-cardTitle" }, tt("world.research")),
@@ -2208,7 +2562,25 @@ window.__ModuleLoader__.load({
               r.description ? h(MdView, { text: r.description, className: "myt-worldDesc" }) : null,
               (r.sources || []).length ? h("div", { className: "myt-refList" },
                 r.sources.map(function (s, j) { return h("span", { key: j, className: "myt-refItem", title: s }, tf("world.ref", { n: j + 1, r: s })); })) : null);
-          })) : h(Empty, { text: tt("world.researchEmpty") })) : null);
+          })) : h(Empty, { text: tt("world.researchEmpty") })) : null,
+        srcRel ? h(SourceEditorModal, { title: tt("src.editSource"), rel: srcRel, wsPath: wsPath, onClose: function () { setSrcRel(null); }, onSaved: reload }) : null,
+        createDir ? h(CreateFileModal, {
+          title: createDir === "science" ? tt("world.createScienceBtn") : tt("world.createBtn"),
+          dir: createDir,
+          template: createDir === "science" ? TPL_SCIENCE : TPL_WORLD,
+          wsPath: wsPath, onClose: function () { setCreateDir(null); }, onSaved: reload,
+        }) : null,
+        delRel ? h(ConfirmModal, {
+          title: tf("src.deleteTip", { rel: delRel }),
+          text: tf("src.confirmText", { rel: delRel }),
+          onCancel: function () { setDelRel(null); },
+          onConfirm: function () {
+            return apiPost("file-delete", { path: wsPath, rel: delRel }).then(function () {
+              setDelRel(null);
+              return reload();
+            });
+          },
+        }) : null);
     }
 
     // ── 索引板 tab：clues 按 kind 分组（resolved 划线）+ memories 按 category
@@ -2239,6 +2611,8 @@ window.__ModuleLoader__.load({
         memGroups[key].push(m);
       });
       function groupKey(a, b) { return a.localeCompare(b, "zh-CN"); }
+      // 两本索引账源文件直达（0.1.20 写面）：clue-board.yml / memories.yml。
+      var _src = useState(null), srcRel = _src[0], setSrcRel = _src[1];
       return h("div", { className: "myt-stack" },
         h("div", { className: "myt-cardHead" },
           h("h3", { className: "myt-cardTitle" }, tt("index.title")),
@@ -2246,7 +2620,8 @@ window.__ModuleLoader__.load({
             rebuildBusy ? tt("index.rebuilding") : tt("index.rebuild"))),
         h("div", { className: "myt-indexCols" },
           h("div", { className: "myt-card" },
-            h("div", { className: "myt-cardHead" }, h("h3", { className: "myt-cardTitle" }, tt("index.clueBoard")), h("span", { className: "myt-boardCount" }, clues.length)),
+            h("div", { className: "myt-cardHead" }, h("h3", { className: "myt-cardTitle" }, tt("index.clueBoard")), h("span", { className: "myt-boardCount" }, clues.length),
+              srcEditBtn("clue-board.yml", function () { setSrcRel("clue-board.yml"); })),
             clues.length ? Object.keys(clueGroups).sort(groupKey).map(function (kind) {
               var ck = CLUE_KIND_KEYS[kind];
               var label = ck ? tt("clue." + ck) : kind;
@@ -2259,7 +2634,8 @@ window.__ModuleLoader__.load({
                 }));
             }) : h(Empty, { text: tt("index.clueEmpty") })),
           h("div", { className: "myt-card" },
-            h("div", { className: "myt-cardHead" }, h("h3", { className: "myt-cardTitle" }, tt("index.memBoard")), h("span", { className: "myt-boardCount" }, memories.length)),
+            h("div", { className: "myt-cardHead" }, h("h3", { className: "myt-cardTitle" }, tt("index.memBoard")), h("span", { className: "myt-boardCount" }, memories.length),
+              srcEditBtn("memories.yml", function () { setSrcRel("memories.yml"); })),
             memories.length ? Object.keys(memGroups).sort(groupKey).map(function (cat) {
               var isPromise = /promise|承诺/i.test(cat);
               return h("div", { key: cat, className: "myt-worldGroup" },
@@ -2271,13 +2647,18 @@ window.__ModuleLoader__.load({
                     h("span", { className: "myt-clueText" }, orDash(m.content)),
                     m.source_chapter ? h("span", { className: "myt-memChapter" }, m.source_chapter) : null);
                 }));
-            }) : h(Empty, { text: tt("index.memEmpty") }))));
+            }) : h(Empty, { text: tt("index.memEmpty") }))),
+        srcRel ? h(SourceEditorModal, { title: tt("src.editSource"), rel: srcRel, wsPath: wsPath, onClose: function () { setSrcRel(null); }, onSaved: reload }) : null);
     }
 
-    // ── 关系图 tab：canvas 力导向（斥力 + 弹簧 + 中心引力，rAF 循环）─────────
-    // 节点固定 18px、名字 label 下方；边宽 = intensity 1-5 → 1-4px（缺省 3），
-    // type 标在边中点、hover 显示 description；拖拽固定、滚轮缩放、双击复位；
-    // 角色多于 30 个时只画 relations 相关节点，其余进「未入图」。
+    // ── 关系图 tab：canvas 力导向（斥力 + 弹簧 + 中心引力 + 硬碰撞分离，rAF 循环）─
+    // 节点固定 18px、名字 label 下方，最小间距 62 位置级互推保证静止帧不压叠；
+    // 边为二次曲线（绕开途中节点、重复边互相分开），type 标在曲线 t=0.5 点、
+    // hover 显示 description（命中检测按曲线几何采样）；拖拽固定、滚轮缩放、
+    // 双击复位；角色多于 30 个时只画 relations 相关节点，其余进「未入图」。
+    // 关系图节点角色配色：主角红 / 配角蓝 / 反派黑 / 龙套黄（用户指定四色）；
+    // 越枚举/缺省 role 一律并入龙套黄（查表 miss 落 minor），全节点恒有色。
+    var NODE_ROLE_COLORS = { protagonist: "#f53f3f", supporting: "#165dff", antagonist: "#1d2129", minor: "#fadc19" };
     function edgeWidth(intensity) {
       var n = typeof intensity === "number" && isFinite(intensity) ? Math.round(intensity) : 3;
       n = Math.min(5, Math.max(1, n));
@@ -2285,6 +2666,10 @@ window.__ModuleLoader__.load({
     }
     function RelationsTab(props) {
       var snap = props.snap;
+      var wsPath = props.wsPath;
+      var reload = props.reload;
+      // 关系账本源文件直达（0.1.20 写面）：relations.yml 整文件可编辑。
+      var _src = useState(null), srcRel = _src[0], setSrcRel = _src[1];
       var chars = snap.characters || [];
       var rels = (snap.relations || []).filter(function (r) { return r && r.a && r.b && r.a !== r.b; });
       var _tip = useState(null), tip = _tip[0], setTip = _tip[1]; // {x, y, text}
@@ -2311,6 +2696,14 @@ window.__ModuleLoader__.load({
         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) }; });
+        // 同一对节点的重复边编号：dup = 按 (a,b) 无序对分组后的组内序号（0 起）。
+        // draw 的 edgeCtrl 按 dup 放大曲线偏移并交替朝向，重复边互相分开不重合。
+        var dupCount = Object.create(null);
+        edges.forEach(function (e) {
+          var key = Math.min(e.a, e.b) + "-" + Math.max(e.a, e.b);
+          e.dup = dupCount[key] || 0;
+          dupCount[key] = e.dup + 1;
+        });
         return { nodes: nodes, edges: edges, unlinked: unlinked };
       }, [snap]); // chars/rels 均由 snap 派生，snap 不变则图不变
       useEffect(function () {
@@ -2352,7 +2745,50 @@ window.__ModuleLoader__.load({
           nd.vx = nd.vy = 0;
         });
         function toWorld(sx, sy) { return { x: (sx - sim.w / 2) / sim.zoom, y: (sy - sim.h / 2) / sim.zoom }; }
-        function toScreen(x, y) { return { x: sim.w / 2 + x * sim.zoom, y: sim.h / 2 + y * sim.zoom }; }
+        // 每条边的二次贝塞尔控制点：bow 大小随边长缩放、钳 [12,28] 世界像素；
+        // side ∈ {-1,+1} 曲线朝向（挂边对象上帧间保留，做迟滞防抖）；同一对
+        // 节点的重复边按 dup 序号放大偏移并交替朝向，互相分开不重合。
+        function edgeCtrl(e) {
+          var a = graph.nodes[e.a], b = graph.nodes[e.b];
+          var dx = b.x - a.x, dy = b.y - a.y;
+          var len = Math.sqrt(dx * dx + dy * dy) || 1;
+          var ux = -dy / len, uy = dx / len; // 单位法向
+          var mag = Math.min(28, Math.max(12, len * 0.1));
+          var k = e.dup || 0;
+          var m = mag * (1 + 0.6 * k);
+          var side = (e.side || 1) * (k % 2 ? -1 : 1);
+          return { cx: (a.x + b.x) / 2 + ux * m * side, cy: (a.y + b.y) / 2 + uy * m * side };
+        }
+        // 曲线（A、C、B 三点二次贝塞尔）采样 9 个点到各无关节点（跳过两端）
+        // 的最小距离：值越大说明这一侧越空旷。
+        function clearance(e, cx, cy) {
+          var a = graph.nodes[e.a], b = graph.nodes[e.b];
+          var best = 999;
+          for (var t = 1; t <= 9; t++) {
+            var tt = t / 10, it = 1 - tt;
+            var px = it * it * a.x + 2 * it * tt * cx + tt * tt * b.x;
+            var py = it * it * a.y + 2 * it * tt * cy + tt * tt * b.y;
+            for (var ni = 0; ni < graph.nodes.length; ni++) {
+              if (ni === e.a || ni === e.b) continue;
+              var nd = graph.nodes[ni];
+              var ddx = px - nd.x, ddy = py - nd.y;
+              var d = Math.sqrt(ddx * ddx + ddy * ddy);
+              if (d < best) best = d;
+            }
+          }
+          return best;
+        }
+        // 朝向迟滞更新：算当前侧与取反侧的 clearance，只有另一侧明显更空
+        // （+12 世界像素）才翻转——力导向抖动时曲线不左右闪。
+        function updateSide(e) {
+          var side = e.side || 1;
+          var c1 = edgeCtrl(e);
+          var cur = clearance(e, c1.cx, c1.cy);
+          e.side = -side;
+          var c2 = edgeCtrl(e);
+          var alt = clearance(e, c2.cx, c2.cy);
+          if (alt <= cur + 12) e.side = side; // 另一侧不明显更空：保持原朝向
+        }
         function hitNode(sx, sy) {
           var p = toWorld(sx, sy);
           for (var i = graph.nodes.length - 1; i >= 0; i--) {
@@ -2366,13 +2802,23 @@ window.__ModuleLoader__.load({
           var p = toWorld(sx, sy);
           var best = null, bestD = 10;
           graph.edges.forEach(function (e) {
+            // 命中跟曲线走：二次贝塞尔采样 9 段（10 点含两端），点到各线段
+            // 距离取最小；edgeCtrl 与 draw 同源（side 存边对象上，天然一致）。
             var a = graph.nodes[e.a], b = graph.nodes[e.b];
-            var ax = a.x, ay = a.y, bx = b.x - a.x, by = b.y - a.y;
-            var len2 = bx * bx + by * by || 1;
-            var t = Math.min(1, Math.max(0, ((p.x - ax) * bx + (p.y - ay) * by) / len2));
-            var dx = p.x - (ax + bx * t), dy = p.y - (ay + by * t);
-            var d = Math.sqrt(dx * dx + dy * dy);
-            if (d < bestD) { bestD = d; best = e; }
+            var c = edgeCtrl(e);
+            var qx = a.x, qy = a.y; // 上一采样点，首点 = 端点 A
+            for (var k = 1; k <= 9; k++) {
+              var tt = k / 9, it = 1 - tt;
+              var nx = it * it * a.x + 2 * it * tt * c.cx + tt * tt * b.x;
+              var ny = it * it * a.y + 2 * it * tt * c.cy + tt * tt * b.y;
+              var segx = nx - qx, segy = ny - qy;
+              var len2 = segx * segx + segy * segy || 1;
+              var u = Math.min(1, Math.max(0, ((p.x - qx) * segx + (p.y - qy) * segy) / len2));
+              var dx = p.x - (qx + segx * u), dy = p.y - (qy + segy * u);
+              var d = Math.sqrt(dx * dx + dy * dy);
+              if (d < bestD) { bestD = d; best = e; }
+              qx = nx; qy = ny;
+            }
           });
           return best;
         }
@@ -2394,7 +2840,7 @@ window.__ModuleLoader__.load({
             var a = nodes[e.a], b = nodes[e.b];
             var dx = b.x - a.x, dy = b.y - a.y;
             var d = Math.sqrt(dx * dx + dy * dy) || 1;
-            var f = (d - 120) * 0.02; // 弹簧，rest 120
+            var f = (d - 130) * 0.02; // 弹簧，rest 130（原 120，多留缝隙配合硬碰撞分离）
             var fx = (dx / d) * f, fy = (dy / d) * f;
             a.vx += fx; a.vy += fy; b.vx -= fx; b.vy -= fy;
           });
@@ -2406,6 +2852,33 @@ window.__ModuleLoader__.load({
             nd.x += Math.max(-8, Math.min(8, nd.vx));
             nd.y += Math.max(-8, Math.min(8, nd.vy));
           });
+          // 硬碰撞分离：力式斥力有上限（f 封顶 4），拥挤时节点仍会压叠；这里在
+          // 速度积分之后按最小间距 62（两节点半径 18×2 + 名字 label 纵向净空）
+          // 做位置级互推，保证静止帧节点（含下方 label）不重叠。固定节点
+          // （fixed 或正在拖拽）不动、推对方，双固定跳过；位移不写回速度——
+          // 纯位置修正，靠阻尼自然收敛，不与力导向抢劲。两轮 pass 处理推挤
+          // 连锁（A 推开 B 后 B 又压到 C）。
+          var MIN_DIST = 62;
+          for (var pass = 0; pass < 2; pass++) {
+            for (var ci = 0; ci < n; ci++) {
+              for (var cj = ci + 1; cj < n; cj++) {
+                var na = nodes[ci], nb = nodes[cj];
+                var cdx = nb.x - na.x, cdy = nb.y - na.y;
+                var cd2 = cdx * cdx + cdy * cdy;
+                if (cd2 >= MIN_DIST * MIN_DIST) continue;
+                var cd = Math.sqrt(cd2);
+                if (cd < 0.01) { cdx = 1; cdy = 0; cd = 1; } // 完全重合：任意方向分开
+                var push = (MIN_DIST - cd) / cd; // 归一化差向量：差多少补多少
+                var aFixed = na.fixed || na === (sim.drag && sim.drag.node);
+                var bFixed = nb.fixed || nb === (sim.drag && sim.drag.node);
+                if (aFixed && bFixed) continue;
+                var mA = aFixed ? 0 : (bFixed ? 1 : 0.5); // 固定方不动，另一方全担
+                var mB = bFixed ? 0 : (aFixed ? 1 : 0.5);
+                na.x -= cdx * push * mA; na.y -= cdy * push * mA;
+                nb.x += cdx * push * mB; nb.y += cdy * push * mB;
+              }
+            }
+          }
         }
         function draw() {
           if (sim.frame % 30 === 0 || !sim.tokens) sim.tokens = readTokens();
@@ -2417,29 +2890,30 @@ window.__ModuleLoader__.load({
           ctx.scale(sim.zoom, sim.zoom);
           graph.edges.forEach(function (e) {
             var a = graph.nodes[e.a], b = graph.nodes[e.b];
+            updateSide(e); // 朝向迟滞：另一侧明显更空才翻，防抖（详见 updateSide）
+            var c = edgeCtrl(e);
             ctx.strokeStyle = tk.line;
             ctx.globalAlpha = 0.8;
             ctx.lineWidth = e.w;
-            ctx.beginPath(); ctx.moveTo(a.x, a.y); ctx.lineTo(b.x, b.y); ctx.stroke();
+            ctx.beginPath(); ctx.moveTo(a.x, a.y); ctx.quadraticCurveTo(c.cx, c.cy, b.x, b.y); ctx.stroke();
             if (e.type && sim.zoom >= 0.7) {
               ctx.globalAlpha = 1;
               ctx.fillStyle = tk.faint;
               ctx.font = "10px sans-serif";
               ctx.textAlign = "center";
-              ctx.fillText(e.type, (a.x + b.x) / 2, (a.y + b.y) / 2 - 3);
+              // type 标在曲线 t=0.5 点（二次贝塞尔中点），与曲线本体一致
+              ctx.fillText(e.type, 0.25 * a.x + 0.5 * c.cx + 0.25 * b.x, 0.25 * a.y + 0.5 * c.cy + 0.25 * b.y - 3);
             }
           });
           ctx.globalAlpha = 1;
           graph.nodes.forEach(function (nd) {
-            var s = toScreen(nd.x, nd.y);
             var r = 18; // 世界坐标画：半径随 zoom 缩放
+            var rc = NODE_ROLE_COLORS[nd.role] || NODE_ROLE_COLORS.minor;
             ctx.beginPath();
             ctx.arc(nd.x, nd.y, r, 0, Math.PI * 2);
-            ctx.fillStyle = nd.fixed ? tk.accent : tk.card;
-            ctx.globalAlpha = nd.fixed ? 0.25 : 1;
+            ctx.fillStyle = rc;
             ctx.fill();
-            ctx.globalAlpha = 1;
-            ctx.lineWidth = 1.5;
+            ctx.lineWidth = nd.fixed ? 3 : 1.5; // 固定态=加粗 accent 描边（全节点恒有色后的唯一固定指示）
             ctx.strokeStyle = tk.accent;
             ctx.stroke();
             ctx.fillStyle = tk.label;
@@ -2559,12 +3033,20 @@ window.__ModuleLoader__.load({
           }
         } catch (e) { /* 全屏 API 个别浏览器仍有策略性拒绝，静默 */ }
       }
-      if (!graph.nodes.length) return h(Empty, { text: tt("relations.noData") });
+      if (!graph.nodes.length) {
+        return h("div", { className: "myt-stack" },
+          h("div", { className: "myt-cardHead" },
+            h("h3", { className: "myt-cardTitle" }, tt("relations.title")),
+            srcEditBtn("relations.yml", function () { setSrcRel("relations.yml"); })),
+          h(Empty, { text: tt("relations.noData") }),
+          srcRel ? h(SourceEditorModal, { title: tt("src.editSource"), rel: srcRel, wsPath: wsPath, onClose: function () { setSrcRel(null); }, onSaved: reload }) : null);
+      }
       return h("div", { className: "myt-stack" },
         h("div", { className: "myt-card" },
           h("div", { className: "myt-cardHead" },
             h("h3", { className: "myt-cardTitle" }, tt("relations.title")),
-            h("span", { className: "myt-muted" }, tf("relations.counts", { n: graph.nodes.length, m: graph.edges.length }))),
+            h("span", { className: "myt-muted" }, tf("relations.counts", { n: graph.nodes.length, m: graph.edges.length })),
+            srcEditBtn("relations.yml", function () { setSrcRel("relations.yml"); })),
           h("div", { className: "myt-graphWrap", ref: wrapRef },
             h("canvas", { className: "myt-graphCanvas", ref: canvasRef, "data-dragging": "false" }),
             tip ? h("div", { className: "myt-graphTip", style: { left: Math.min(tip.x + 12, 320) + "px", top: Math.max(tip.y - 34, 4) + "px" } }, tip.text) : null,
@@ -2572,12 +3054,19 @@ window.__ModuleLoader__.load({
               h("button", { type: "button", className: "myt-graphTool", title: tt("relations.zoomOut"), "aria-label": tt("relations.zoomOut"), onClick: function () { if (zoomApiRef.current) zoomApiRef.current.zoomBy(1 / 1.25); } }, "－"),
               h("button", { type: "button", className: "myt-graphTool", title: tt("relations.zoomIn"), "aria-label": tt("relations.zoomIn"), onClick: function () { if (zoomApiRef.current) zoomApiRef.current.zoomBy(1.25); } }, "＋"),
               canFs ? h("button", { type: "button", className: "myt-graphTool myt-graphToolText", title: isFs ? tt("relations.exitFs") : tt("relations.fs"), "aria-label": isFs ? tt("relations.exitFs") : tt("relations.fs"), onClick: toggleFs }, isFs ? tt("relations.exitFs") : tt("relations.fs")) : null)),
-          h("div", { className: "myt-graphFoot" }, tt("relations.help"))),
+          h("div", { className: "myt-graphFoot" },
+            tt("relations.help"),
+            h("span", { className: "myt-graphLegend" },
+              h("span", { className: "myt-legendItem" }, h("span", { className: "myt-legendDot", "data-role": "protagonist" }), tt("role.protagonist")),
+              h("span", { className: "myt-legendItem" }, h("span", { className: "myt-legendDot", "data-role": "supporting" }), tt("role.supporting")),
+              h("span", { className: "myt-legendItem" }, h("span", { className: "myt-legendDot", "data-role": "antagonist" }), tt("role.antagonist")),
+              h("span", { className: "myt-legendItem" }, h("span", { className: "myt-legendDot", "data-role": "minor" }), tt("role.minor"))))),
         graph.unlinked.length ? h("div", { className: "myt-card" },
           h("div", { className: "myt-cardHead" }, h("h3", { className: "myt-cardTitle" }, tt("relations.unlinkedTitle"))),
           h("div", { className: "myt-unlinked" }, graph.unlinked.map(function (n, i) {
             return h("span", { key: n || i, className: "myt-unlinkedTag" }, n);
-          }))) : null);
+          }))) : null,
+        srcRel ? h(SourceEditorModal, { title: tt("src.editSource"), rel: srcRel, wsPath: wsPath, onClose: function () { setSrcRel(null); }, onSaved: reload }) : null);
     }
 
     // ── cordis client 插件入口 ──────────────────────────────────────────────