@cloud411716/fancy-webnovel 2.2.0 → 3.0.3

package/plugins/fancy-analyze/summary-progress.js

@@ -24,13 +24,14 @@
  * 所以**头部要记章节清单**，而且它就是唯一事实源：
  *
  *     ---
- *     标题: 节奏韵律-总结
- *     标签: [总结, 节奏韵律]
  *     已总结章节:
  *       - 全球高武-节奏韵律-第1章
  *       - 全球高武-节奏韵律-第2章
  *     ---
  *
+ * 头部**只有这一个键** —— 早先还写过「标题:」「标签:」，但整个插件里
+ * 没有任何代码读它们，是死字段（详见 append-summary-chapter.js）。
+ *
  * 由此：
  *   · 待总结章节 = 源文件清单 − 头部已总结章节
  *   · 派活时**只给目录**，章节由模型自己去目录里比对（几千章时列名字会撑爆提示词）
@@ -59,6 +60,39 @@ export const SUMMARY_FRONTMATTER_KEY = '已总结章节';
 /** llm_wiki 的摄入产物目录，不是技法目录。 */
 export const EXCLUDED_WIKI_DIRS = ['来源', '来源摘要'];
 
+/**
+ * 跨章节实体页目录：这些目录也要做 summary，但总结单位是“实体页”，
+ * 不是“章节”。提示词会读取每个实体页的 `## 可复用设计规则` 和
+ * `## 风险与反例`，提炼跨实体、跨章节的设计原则。
+ */
+export const ENTITY_SCOPED_DIRS = [
+  '人物关系设计',
+  '势力结构',
+  '世界观设计',
+  '冲突设计',
+  '主线支线结构',
+  '分卷节奏',
+  '伏笔布局',
+  '角色弧光设计',
+];
+
+/**
+ * 旧版按章结构页目录。它们与新版实体页**不是同一种东西**：
+ *   · 伏笔回收（按章）→ 伏笔布局（按伏笔实体）
+ *   · 世界观构建 / 世界观规则设计（按章）→ 世界观设计（按规则/体系实体）
+ *   · 角色弧光（按章）→ 角色弧光设计（按角色实体）
+ *
+ * 不能自动迁移，也不能把它们当实体页检查 —— 否则每章一个页面会被误判成
+ * “同一个实体有多个页面”。这里只负责让它们不参与 summary 派发，并在
+ * status / summary-status 里提示重新 ingest。
+ */
+export const LEGACY_STRUCTURE_DIRS = [
+  '伏笔回收',
+  '世界观构建',
+  '世界观规则设计',
+  '角色弧光',
+];
+
 /** 进度状态。 */
 export const SUMMARY_STATE = {
   DONE: 'done',
@@ -140,7 +174,7 @@ export function parseSummarizedChapters(frontmatter) {
  * 把「已总结章节」的名字对齐到源文件标识。
  *
  * 模型写章节名的格式很不统一（实测）：
- *   - `全球高武-伏笔回收-第3章`          精确
+ *   - `全球高武-场景转换-第3章`          精确
  *   - `[全球高武-世界观构建-第2章, 第3章]`  带方括号 + 简写
  *   - `第7章`                            裸章号
  *
@@ -219,7 +253,7 @@ export function alignChapterIds(names, sourceFiles) {
 export function inferSummarizedChapters(text, knownIds) {
   if (typeof text !== 'string' || text.length === 0) return { chapters: [], unmatched: [] };
   const raw = [];
-  for (const match of text.matchAll(/^\s*-\s*来源章节\s*[:：]\s*(.+)$/gm)) {
+  for (const match of text.matchAll(/^\s*-\s*来源(?:章节|实体|页面)\s*[:：]\s*(.+)$/gm)) {
     // "来源章节：甲-第1章、甲-第2章" → 拆开
     for (const part of String(match[1]).split(/[、,，;；]/)) {
       const v = part.trim();
@@ -232,7 +266,7 @@ export function inferSummarizedChapters(text, knownIds) {
 /**
  * 取出章节标识里的章号。
  *
- * 章节标识长这样：`全球高武-伏笔回收-第10章`。
+ * 章节标识长这样：`全球高武-场景转换-第10章`。
  * 章号是稳定语义（技法名可能被打错字，章号不会），所以排序靠它。
  *
  * @param {string} id - 章节标识
@@ -286,6 +320,28 @@ export function listTechDirs(wikiRoot) {
   return dirs.sort((a, b) => a.localeCompare(b, 'zh-Hans-CN'));
 }
 
+/**
+ * 返回需要做 summary 的目录：按章技法目录 + 跨章节实体目录。
+ * 旧版按章结构目录仍排除（它们等待迁移，不参与新 summary）。
+ */
+export function listSummaryDirs(wikiRoot) {
+  return listTechDirs(wikiRoot).filter(
+    (name) => !LEGACY_STRUCTURE_DIRS.includes(name));
+}
+
+function countEntityPages(wikiRoot, dirName) {
+  try {
+    const files = fs.readdirSync(path.join(wikiRoot, dirName), { withFileTypes: true });
+    return files.filter((file) =>
+      file.isFile() &&
+      file.name.endsWith('.md') &&
+      !file.name.endsWith('-总结.md')
+    ).length;
+  } catch {
+    return 0;
+  }
+}
+
 /**
  * 读一个技法目录的进度。
  *
@@ -323,6 +379,8 @@ export function readDirProgress(wikiRoot, dirName) {
 
   const progress = {
     name: dirName,
+    /** chapter = 按章技法；entity = 跨章节实体页。 */
+    scope: ENTITY_SCOPED_DIRS.includes(dirName) ? 'entity' : 'chapter',
     summaryPath,
     sourceFiles,
     sourceCount: sourceFiles.length,
@@ -398,15 +456,21 @@ export function readDirProgress(wikiRoot, dirName) {
  * 扫描全部技法目录的进度。
  *
  * @param {string} wikiRoot - 对标/wiki 的绝对路径
- * @returns {{dirs: object[], done: object[], running: object[], pending: object[], noInput: object[], total: number}}
+ * @returns {{dirs: object[], legacyDirs: object[], done: object[], running: object[], pending: object[], noInput: object[], total: number}}
  */
 export function scanSummaryProgress(wikiRoot) {
-  const dirs = listTechDirs(wikiRoot)
+  const allDirs = listTechDirs(wikiRoot);
+  const legacyDirs = allDirs
+    .filter((name) => LEGACY_STRUCTURE_DIRS.includes(name))
+    .map((name) => ({ name, pageCount: countEntityPages(wikiRoot, name) }));
+  const dirs = allDirs
+    .filter((name) => !LEGACY_STRUCTURE_DIRS.includes(name))
     .map((name) => readDirProgress(wikiRoot, name))
     .filter((p) => p !== null);
 
   return {
     dirs,
+    legacyDirs,
     done: dirs.filter((p) => p.state === SUMMARY_STATE.DONE),
     running: dirs.filter((p) => p.state === SUMMARY_STATE.RUNNING),
     pending: dirs.filter((p) => p.state === SUMMARY_STATE.PENDING),