dsh-maoying 0.1.16 → 0.1.18

package/lib/client.js

@@ -53,14 +53,17 @@ window.__ModuleLoader__.load({
     var CSS_KEY = "maoying-creator/base";
     var WS_STORAGE_KEY = "maoying.workspace";
     var API_TIMEOUT_MS = 60000;
-    // 一键升级单独放宽：服务端 pnpm add 超时上限 180s，统一 60s 会先掐断，
-    // 故 self-update 请求走 200s（留 20s 余量），其余请求仍用 API_TIMEOUT_MS。
-    var SELF_UPDATE_TIMEOUT_MS = 200000;
+    // 一键升级单独放宽：服务端 profile pnpm add 超时上限 180s + 全局 npm i -g
+    // 独立 120s（顺带更新全局 maoying CLI），统一 60s 会先掐断，故 self-update
+    // 请求走 340s（300s + 40s 余量），其余请求仍用 API_TIMEOUT_MS。
+    var SELF_UPDATE_TIMEOUT_MS = 340000;
 
     var STATUS_FLOW = ["pending", "writing", "review", "accepted"];
     var FS_ORDER = ["planted", "progressing", "resolved", "abandoned"];
     var FS_FLOW = { planted: "progressing", progressing: "resolved" };
     var PHASES = ["idea", "setting", "outline", "writing", "review", "consistency", "export"];
+    // 共创模式三态（key → mode.* / modeShort.* 词典后缀）：概览书稿卡展示用。
+    var MODES = [["ai-draft", "aiDraft"], ["co-write", "coWrite"], ["author-draft", "authorDraft"]];
     // clue.* 词典键是小驼峰，数据里的 kind 按契约（templates/novel/README.md、
     // docs/spec.md）是 clue|red-herring|deduction|question——此前键表误按
     // snake_case + inference 写，红鲱鱼/推理两组永远查不中、只能裸显英文原值。
@@ -283,7 +286,10 @@ window.__ModuleLoader__.load({
         return toast.subscribe(function () { setItems(toast.snapshot()); });
       }, []);
       if (!items.length) return null;
-      return h("div", { className: "myt-toastHost", "aria-live": "polite" },
+      // portal 到 body：与弹层同坐标系。中栏 transform/overflow 会把 fixed 劫持
+      // 成相对中栏定位，锚区变量（视口坐标）在此会被二次偏移；挂 body 后
+      // fixed 恒等于视口，--myt-anchor-* 直接可用（base.css 按锚区居中）。
+      return h(MaskPortal, { className: "myt-toastHost", "aria-live": "polite" },
         items.map(function (it) {
           return h("div", {
             key: it.id,
@@ -571,6 +577,66 @@ window.__ModuleLoader__.load({
         lsSet(FONT_SCALE_KEY, fontScale);
       }, [fontScale]);
 
+      // 弹层锚区：弹层 portal 到 body 后 position:fixed 以全窗为居中基准，
+      // 宿主右侧边栏一开，中栏变窄左移，弹窗仍按全窗居中，右半被侧边栏盖住。
+      // 这里持续测量面板容器（data-dsh-maoying-view）的视口矩形写进 CSS 变量，
+      // 弹层/Toast 改按锚区居中（base.css）；测量不到时移除变量回落全窗，行
+      // 为与旧版一致。宿主侧边栏开合会改中栏宽度，ResizeObserver + resize 双
+      // 通道跟随，rAF 合帧防抖。
+      // 两组变量：--myt-anchor-* 视觉 px（Toast 未 zoom，直接用）；--myt-mask-*
+      // 已除以面板 zoom 的 CSS px（mask 带 zoom，fixed 内 px 会被放大，须预
+      // 除——JS 算好，避开 calc(px / var()) 的老 Chromium 兼容雷）。zoom 每次
+      // 现读 computed style，字号换档自动跟随，无需额外依赖。
+      useEffect(function () {
+        if (typeof document === "undefined" || typeof window === "undefined") return undefined;
+        var docEl = document.documentElement;
+        if (!docEl || !docEl.style) return undefined;
+        var ALL_VARS = [
+          "--myt-anchor-left", "--myt-anchor-width", "--myt-anchor-bottom",
+          "--myt-mask-top", "--myt-mask-right", "--myt-mask-bottom", "--myt-mask-left",
+        ];
+        var clear = function () {
+          ALL_VARS.forEach(function (v) { docEl.style.removeProperty(v); });
+        };
+        var px = function (n) { return (Math.round(n * 100) / 100) + "px"; };
+        var apply = function () {
+          raf = 0;
+          var el = document.querySelector("[data-dsh-maoying-view]");
+          if (!el || !el.isConnected) { clear(); return; }
+          var r = el.getBoundingClientRect();
+          if (!r || r.width < 2 || r.height < 2) { clear(); return; } // display:none 等异常态不锚定
+          docEl.style.setProperty("--myt-anchor-left", px(r.left));
+          docEl.style.setProperty("--myt-anchor-width", px(r.width));
+          docEl.style.setProperty("--myt-anchor-bottom", px(Math.max(0, window.innerHeight - r.bottom)));
+          var zoom = 1;
+          try {
+            var cs = window.getComputedStyle(el);
+            var pz = cs && cs.zoom ? parseFloat(cs.zoom) : NaN;
+            if (pz > 0) zoom = pz;
+          } catch (err) { /* 老宿主无 computed zoom：按 1 处理 */ }
+          docEl.style.setProperty("--myt-mask-top", px(r.top / zoom));
+          docEl.style.setProperty("--myt-mask-right", px(Math.max(0, window.innerWidth - r.right) / zoom));
+          docEl.style.setProperty("--myt-mask-bottom", px(Math.max(0, window.innerHeight - r.bottom) / zoom));
+          docEl.style.setProperty("--myt-mask-left", px(r.left / zoom));
+        };
+        var raf = 0;
+        var schedule = function () {
+          if (raf) return;
+          raf = window.requestAnimationFrame(apply);
+        };
+        apply();
+        window.addEventListener("resize", schedule);
+        var ro = typeof ResizeObserver === "function" ? new ResizeObserver(schedule) : null;
+        var el = document.querySelector("[data-dsh-maoying-view]");
+        if (ro && el) ro.observe(el);
+        return function () {
+          if (raf) window.cancelAnimationFrame(raf);
+          window.removeEventListener("resize", schedule);
+          if (ro) ro.disconnect();
+          clear();
+        };
+      }, []);
+
       // 选中校正：记忆的工作区必须仍在列表且 hasNovel，否则落回首个 hasNovel。
       var effectiveWs = (function () {
         if (!workspaces) return "";
@@ -633,24 +699,48 @@ window.__ModuleLoader__.load({
       }, []);
       // 一键升级状态机：""（可点）→ "installing"（安装中，按钮禁用）→
       // "installed"（已装完待重启，按钮永久禁用、新版徽章收起）。可预期失败
-      // （dev-link / pnpm-missing / pnpm 出错）回落 "" 允许重试。
+      // （dev-link / pnpm-missing / pnpm 出错）回落 "" 允许重试；服务端短路
+      // up-to-date（本地已不落后线上）也回落 ""，按钮恢复可点、不进 installed 态。
+      // 全局 maoying CLI 顺带更新结果（服务端 globalCli 字段）拼成 toast 第二句
+      // （\n 换行，配合 base.css myt-toastText 的 pre-line 显示）：
+      //   - ok 且真更新了（from → to）：「全局 maoying CLI a → b」；
+      //   - skipped 'missing'（用户没装全局 CLI）/ 'same'（已同版）：不提，零噪音；
+      //   - ok:false：如实报「全局 CLI 更新失败：{error}」，不改动主文案的成功语义
+      //     （profile 已装好，重启照常生效）。
+      function globalCliNote(d) {
+        var g = d && d.globalCli;
+        if (!g) return "";
+        if (g.ok) {
+          if (g.skipped) return "";
+          return "\n" + tf("toast.selfUpdate.globalOk", { from: g.from || "?", to: g.to || "?" });
+        }
+        return "\n" + tf("toast.selfUpdate.globalFail", { error: g.error || tt("common.unknownErr") });
+      }
       var _up = useState(""), upState = _up[0], setUpState = _up[1];
       function runSelfUpdate() {
         if (upState !== "") return;
         setUpState("installing");
         // 不走 apiPost：成功提示要带新版本号、失败按 kind 分流文案，且超时
-        // 单独放宽（服务端 pnpm 最长 180s，统一 60s 会先掐断，见常量处注释）。
+        // 单独放宽（服务端 profile pnpm 最长 180s + 全局 npm 独立 120s，统一
+        // 60s 会先掐断，见常量处注释）。
         maoyingApi("self-update", {}, SELF_UPDATE_TIMEOUT_MS).then(function (d) {
-          if (d && d.ok) {
+          if (d && d.ok && d.kind === "up-to-date") {
+            // 短路：profile 没装任何东西，但全局 CLI 仍可能要跟进（globalCliNote
+            // 拼第二句）；按钮恢复可点；版本徽章留给 update-check 自行收敛。
+            setUpState("");
+            toast.ok(tf("toast.selfUpdate.upToDate", { ver: (d && d.from) || "?" }) + globalCliNote(d));
+          } else if (d && d.ok) {
             setUpState("installed");
             // 硬约束照实说：装完只是磁盘换新，运行中的进程仍是旧代码。
-            toast.ok(tf("toast.selfUpdate.ok", { ver: (d && d.to) || "?" }));
+            toast.ok(tf("toast.selfUpdate.ok", { ver: (d && d.to) || "?" }) + globalCliNote(d));
           } else if (d && d.kind === "dev-link") {
             setUpState("");
             toast.warn(tt("toast.selfUpdate.devLink"));
           } else if (d && d.kind === "pnpm-missing") {
+            // 服务端 message 已带可操作出路（corepack enable / 手动命令），直显不截断；
+            // 拿不到 message 才回落本地通用文案。
             setUpState("");
-            toast.warn(tt("toast.selfUpdate.pnpmMissing"));
+            toast.err(tf("toast.prefix", { msg: (d && d.error) || tt("toast.selfUpdate.pnpmMissing") }));
           } else {
             setUpState("");
             toast.err(tf("toast.prefix", { msg: (d && d.error) || tt("common.unknownErr") }));
@@ -817,6 +907,9 @@ window.__ModuleLoader__.load({
       var _b = useState(false), phaseBusy = _b[0], setPhaseBusy = _b[1];
       var phaseIdx = PHASES.indexOf(project.phase);
       var nextPhase = phaseIdx !== -1 && phaseIdx < PHASES.length - 1 ? PHASES[phaseIdx + 1] : null;
+      // 共创模式徽章：快照 mode 缺失（老项目无该键）或越枚举时不显示。
+      var modeEntry = null;
+      for (var mi = 0; mi < MODES.length; mi++) { if (MODES[mi][0] === project.mode) { modeEntry = MODES[mi]; break; } }
       // 静态体检黄条：仅 found 时拉 check 路由（未初始化没有可查的东西）。
       // 工作区切换与每次 reload 都换新 snap → effect 重跑即重查；请求序号防
       // 过期响应（快速切工作区时在途旧响应不得落进新工作区的黄条）。
@@ -839,6 +932,7 @@ window.__ModuleLoader__.load({
         apiPost("phase", { path: props.wsPath, phase: nextPhase }).then(reload).catch(function () {}).finally(function () { setPhaseBusy(false); });
       }
       var recent = (snap.chapters || []).slice().sort(function (a, b) { return (b.num || 0) - (a.num || 0); }).slice(0, 5);
+      var volumes = snap.volumes || [];
       return h("div", { className: "myt-stack" },
         checkProblems && checkProblems.length ? CheckStrip(checkProblems) : null,
         editing
@@ -856,6 +950,10 @@ window.__ModuleLoader__.load({
                 h("h2", { className: "myt-heroTitle", key: "title" }, orDash(project.title)),
                 h("div", { className: "myt-heroMeta", key: "phase" },
                   phasePill(project.phase),
+                  modeEntry ? [
+                    h("span", { className: "myt-muted", key: "modeLabel" }, tt("novel.fMode")),
+                    h("span", { className: "myt-badge", key: "modeBadge", title: tt("mode." + modeEntry[1]) }, tt("modeShort." + modeEntry[1])),
+                  ] : null,
                   nextPhase ? h("button", { type: "button", className: "myt-btn", disabled: phaseBusy, onClick: advancePhase, title: tf("phase.advanceTitle", { next: tt("phase." + nextPhase) }) }, phaseBusy ? tt("phase.advancing") : tt("phase.advance")) : h("span", { className: "myt-muted" }, project.phase ? tt("phase.final") : null)),
                 project.description ? h("p", { className: "myt-heroDesc", key: "desc" }, project.description) : null,
               ]),
@@ -877,6 +975,16 @@ window.__ModuleLoader__.load({
           h("div", { className: "myt-heroMeta" }, STATUS_FLOW.map(function (s) {
             return h("span", { key: s, className: "myt-muted" }, tt("status." + s) + " " + (byStatus[s] || 0));
           }))),
+        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("div", { className: "myt-stack" }, volumes.map(function (v, i) {
+            return h("div", { key: v.id || i, className: "myt-worldGroup" },
+              h("div", { className: "myt-listHead" },
+                h("span", { className: "myt-worldName" }, (v.id ? v.id + " · " : "") + orDash(v.title)),
+                v.chapters ? h("span", { className: "myt-tag" }, v.chapters) : null),
+              v.summary ? h("div", { className: "myt-worldDesc" }, v.summary) : null);
+          }))) : null,
         h("div", { className: "myt-card" },
           h("div", { className: "myt-cardHead" }, h("h3", { className: "myt-cardTitle" }, tt("overview.recent"))),
           recent.length
@@ -1010,6 +1118,8 @@ window.__ModuleLoader__.load({
         "header.upgradeTitle": "用 pnpm 安装 npm 最新版（最长约 3 分钟），装完需重启 DeepSeek 生效",
         "header.upgradedTitle": "已安装新版，重启 DeepSeek 后生效",
         "toast.selfUpdate.ok": "已安装 {ver}，重启 DeepSeek 后生效",
+        "toast.selfUpdate.upToDate": "已是最新版（{ver}）",
+        "toast.selfUpdate.globalOk": "全局 maoying CLI {from} → {to}", "toast.selfUpdate.globalFail": "全局 CLI 更新失败：{error}",
         "toast.selfUpdate.devLink": "开发目录安装，请 git pull 更新", "toast.selfUpdate.pnpmMissing": "未找到 pnpm，请手动安装",
         "header.workspace": "工作区", "header.wsAria": "选择工作区", "header.noNovel": "（无 novel）", "header.untitled": "未命名",
         "header.settings": "系统设置", "header.refresh": "重新拉取", "header.closeAria": "关闭创作台", "header.closeTitle": "关闭",
@@ -1060,6 +1170,7 @@ window.__ModuleLoader__.load({
         "char.modalAria": "角色详情", "char.closeAria": "关闭角色卡", "char.markers": "标记", "char.file": "文件",
         "overview.author": "作者：{name}", "overview.totalWords": "总字数（CJK）", "overview.totalChapters": "章节总数",
         "overview.characters": "角色数", "overview.openForeshadows": "未回收伏笔", "overview.statusDist": "章节状态分布", "overview.recent": "最近章节",
+        "overview.volumes": "分卷规划",
         "overview.edit": "编辑", "overview.editTip": "编辑书稿元信息",
         "chapters.empty": "chapters/ 目录还没有章节文件", "chapters.writeQueue": "按单写作", "chapters.rowTip": "点击打开该章",
         "chapters.outlineWords": "章纲 {n} 字", "chapters.all": "全部", "chapters.thVolume": "卷 · 章", "chapters.thTitle": "标题",
@@ -1080,6 +1191,7 @@ window.__ModuleLoader__.load({
         "novel.lengthPh": "如：约100万字 / 300章", "novel.fLanguage": "正文语言", "novel.fPhase": "工作流阶段", "novel.fMode": "共创模式",
         "novel.fDesc": "一句话简介", "novel.descPh": "写封面文案时可直接引用", "novel.titleRequired": "书名不能为空",
         "mode.aiDraft": "AI 代笔（AI 写正文）", "mode.coWrite": "逐章共创（按章指派谁写）", "mode.authorDraft": "作者亲笔（AI 只备料审稿）",
+        "modeShort.aiDraft": "AI 代笔", "modeShort.coWrite": "逐章共创", "modeShort.authorDraft": "作者亲笔",
         "novel.saving": "保存中…", "novel.save": "保存设置", "novel.cancel": "取消",
         "settings.title": "系统设置", "settings.closeAria": "关闭设置", "settings.language": "语言",
         "settings.languageHint": "界面文字随语言选项切换，立即生效并记忆。", "settings.fontScale": "字号",
@@ -1095,6 +1207,8 @@ window.__ModuleLoader__.load({
         "header.upgradeTitle": "Install the latest npm release with pnpm (up to ~3 min); takes effect after restarting DeepSeek",
         "header.upgradedTitle": "New version installed — takes effect after restarting DeepSeek",
         "toast.selfUpdate.ok": "Installed {ver} — takes effect after restarting DeepSeek",
+        "toast.selfUpdate.upToDate": "Already up to date ({ver})",
+        "toast.selfUpdate.globalOk": "Global maoying CLI {from} → {to}", "toast.selfUpdate.globalFail": "Global CLI update failed: {error}",
         "toast.selfUpdate.devLink": "Installed from a dev directory — update with git pull", "toast.selfUpdate.pnpmMissing": "pnpm not found — install it manually",
         "header.workspace": "Workspace", "header.wsAria": "Select workspace", "header.noNovel": "(no novel)", "header.untitled": "Untitled",
         "header.settings": "Settings", "header.refresh": "Refresh", "header.closeAria": "Close Maoying Studio", "header.closeTitle": "Close",
@@ -1145,6 +1259,7 @@ window.__ModuleLoader__.load({
         "char.modalAria": "Character details", "char.closeAria": "Close character card", "char.markers": "Tags", "char.file": "File",
         "overview.author": "Author: {name}", "overview.totalWords": "Total characters (CJK)", "overview.totalChapters": "Chapters",
         "overview.characters": "Characters", "overview.openForeshadows": "Unresolved foreshadowing", "overview.statusDist": "Chapter status breakdown", "overview.recent": "Recent chapters",
+        "overview.volumes": "Volume plan",
         "overview.edit": "Edit", "overview.editTip": "Edit manuscript metadata",
         "chapters.empty": "No chapter files in chapters/ yet", "chapters.writeQueue": "Writing Queue", "chapters.rowTip": "Click to open this chapter",
         "chapters.outlineWords": "Outline {n} chars", "chapters.all": "All", "chapters.thVolume": "Vol · Ch", "chapters.thTitle": "Title",
@@ -1165,6 +1280,7 @@ window.__ModuleLoader__.load({
         "novel.lengthPh": "e.g. ~1M characters / 300 chapters", "novel.fLanguage": "Text language", "novel.fPhase": "Workflow phase", "novel.fMode": "Co-writing mode",
         "novel.fDesc": "One-line synopsis", "novel.descPh": "Can be quoted directly in cover copy", "novel.titleRequired": "Title is required",
         "mode.aiDraft": "AI ghostwriting (AI drafts the prose)", "mode.coWrite": "Chapter-by-chapter co-writing (assign a writer per chapter)", "mode.authorDraft": "Author writes (AI only preps and reviews)",
+        "modeShort.aiDraft": "AI draft", "modeShort.coWrite": "Co-write", "modeShort.authorDraft": "Author writes",
         "novel.saving": "Saving…", "novel.save": "Save", "novel.cancel": "Cancel",
         "settings.title": "Settings", "settings.closeAria": "Close settings", "settings.language": "Language",
         "settings.languageHint": "UI text follows the language option; it applies immediately and is remembered.", "settings.fontScale": "Font size",
@@ -1774,8 +1890,13 @@ window.__ModuleLoader__.load({
         research.length ? h("div", { className: "myt-card" },
           h("div", { className: "myt-cardHead" }, h("h3", { className: "myt-cardTitle" }, tt("world.research")),
             h("span", { className: "myt-boardCount" }, research.length)),
-          h("div", { className: "myt-tagRow" }, research.map(function (r, i) {
-            return h("span", { key: r.file || i, className: "myt-tag", title: r.file || "" }, orDash(r.topic) || r.file);
+          h("div", { className: "myt-stack" }, research.map(function (r, i) {
+            return h("div", { key: r.file || i, className: "myt-worldGroup" },
+              h("div", { className: "myt-listHead" },
+                h("span", { className: "myt-worldName", title: r.file || "" }, orDash(r.topic) || r.file)),
+              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);
           }))) : null);
     }
 

package/lib/novel-parse.mjs

@@ -709,6 +709,9 @@ const FORESHADOW_STATUSES = ['planted', 'progressing', 'resolved', 'abandoned']
 /** project.yml 的共创模式枚举（五期 §9.1）。 */
 const PROJECT_MODES = ['ai-draft', 'co-write', 'author-draft']
 
+/** 七阶段工作流枚举（与 project.yml 的 phase 键一致，顺序即推进序）。 */
+export const PROJECT_PHASES = ['idea', 'setting', 'outline', 'writing', 'review', 'consistency', 'export']
+
 /**
  * 章节 frontmatter 的 volume 规范形态：v + 两位卷号。面板从章纲建章
  * （panel-core 的 createChapterFromOutline）与本文件 check / collectChapters
@@ -947,7 +950,10 @@ export function checkProject(novelDir) {
     }
   }
 
-  // —— project.yml：mode 枚举 ——
+  // —— project.yml：mode/phase 枚举 + 阶段就绪判据 ——
+  // 判据与 docs/spec.md §2 同源：phase 到 outline 及之后（setting 已过），核心设定件
+  // 必须在案——缺了说明写作流程被硬闯，报 error 提示回上一阶段补齐。
+  // phase 键缺失（无 project.yml 或旧文件）不查——stats 已提示「未设置」，此处不重复计账。
   const projectRaw = parseFlatYamlArray(readTextOrNull(path.join(novelDir, 'project.yml')))
   if (projectRaw !== null && !Array.isArray(projectRaw)) {
     const mode = projectRaw.mode
@@ -955,6 +961,32 @@ export function checkProject(novelDir) {
       push('error', 'project.yml', `mode 越枚举：${mode}（合法值 ${PROJECT_MODES.join('|')}）`)
     }
   }
+  const phase = projectRaw !== null && !Array.isArray(projectRaw) ? projectRaw.phase : undefined
+  if (typeof phase === 'string' && phase !== '') {
+    if (!PROJECT_PHASES.includes(phase)) {
+      push('error', 'project.yml', `phase 越枚举：${phase}（合法值 ${PROJECT_PHASES.join('|')}）`)
+    } else if (PROJECT_PHASES.indexOf(phase) >= PROJECT_PHASES.indexOf('outline')) {
+      if (!cards.some((c) => c.meta.role === 'protagonist')) {
+        push('error', 'characters/', 'phase 已过 setting 但 characters/ 缺 role: protagonist 主角卡（setting → outline 判据：核心角色卡须落盘）')
+      }
+      if (!cards.some((c) => c.meta.role === 'antagonist')) {
+        push('error', 'characters/', 'phase 已过 setting 但 characters/ 缺 role: antagonist 核心反派卡（setting → outline 判据：核心角色卡须落盘）')
+      }
+      const hasWorldLore =
+        listMdFiles(path.join(novelDir, 'world')).length > 0 || listMdFiles(path.join(novelDir, 'science')).length > 0
+      if (!hasWorldLore) {
+        push('error', 'world/', 'phase 已过 setting 但 world/ 与 science/ 均无条目（setting → outline 判据：世界观核心条目须落盘）')
+      }
+      if (readYamlArray(novelDir, 'volumes.yml').length === 0) {
+        push('error', 'volumes.yml', 'phase 已过 setting 但 volumes.yml 为空或缺失（setting → outline 判据：分卷规划须在案）')
+      }
+      // 关系网判据（六期补）：两张及以上角色卡时 relations.yml 不得为空——
+      // 空关系网意味着设定阶段漏登关系，关系图与大纲师的戏剧权重都无从谈起。
+      if (cards.length >= 2 && readYamlArray(novelDir, 'relations.yml').length === 0) {
+        push('error', 'relations.yml', 'phase 已过 setting 但 relations.yml 为空（setting → outline 判据：两张及以上角色卡时关系网须登记）')
+      }
+    }
+  }
 
   const summary = {
     chapters: chapterFiles.length,

package/lib/panel-core.mjs

@@ -553,9 +553,18 @@ export function parseStateSnapshot(novelDir, options = {}) {
     references: strArray(meta.references),
   }))
 
-  const research = collectMdEntities(dir, 'research', yamlLib, warnings).map(({ file, meta }) => ({
+  const research = collectMdEntities(dir, 'research', yamlLib, warnings).map(({ file, meta, body }) => ({
     file,
     topic: strOrNull(meta.topic),
+    sources: strArray(meta.sources),
+    description: typeof body === 'string' ? body.trim() : '',
+  }))
+
+  const volumes = collectArrayYml(dir, 'volumes.yml', yamlLib, warnings).map((v) => ({
+    id: strOrNull(v.id),
+    title: strOrNull(v.title),
+    summary: strOrNull(v.summary),
+    chapters: strOrNull(v.chapters),
   }))
 
   const outlines = collectOutlines(dir, warnings)
@@ -581,6 +590,7 @@ export function parseStateSnapshot(novelDir, options = {}) {
     timeline,
     memories,
     clues,
+    volumes,
     world,
     science,
     research,