@cloud411716/fancy-webnovel 1.0.46 → 2.2.0

package/plugins/fancy-analyze/templates.js

@@ -0,0 +1,881 @@
+/**
+ * fancy-analyze templates — 通知模板 + 拆解指引
+ *
+ * 拆解指引（generateGuideMarkdown()）由 LLM 在拆解爆款小说时读取，
+ * 告诉它按"消费者"（fancy-bible / fancy-outline / fancy-write）拆解成多份 .md 文件。
+ *
+ * 拆解后的产物放在 对标/<书名>/ 下：
+ *   _summary.md
+ *   for_bible/{characters,relationships,world}.md
+ *   for_outline/{plot_structure,pacing,chapter_templates,foreshadow_patterns}.md
+ *   for_write/{voice,sentence_patterns}.md
+ *   for_write/phrase_bank/{action,psychology,environment,dialogue}.md
+ */
+
+export const CONSUMER_DIRS = {
+  bible: [
+    'characters.md',
+    'relationships.md',
+    'world.md',
+  ],
+  outline: [
+    'plot_structure.md',
+    'pacing.md',
+    'chapter_templates.md',
+    'foreshadow_patterns.md',
+  ],
+  write: [
+    'voice.md',
+    'sentence_patterns.md',
+    'phrase_bank/action.md',
+    'phrase_bank/psychology.md',
+    'phrase_bank/environment.md',
+    'phrase_bank/dialogue.md',
+  ],
+};
+
+/**
+ * 人类可读的字节数。
+ * @param {number} bytes - 字节数
+ * @returns {string} 例如 "8.0 KB"
+ */
+function humanBytes(bytes) {
+  if (!Number.isFinite(bytes) || bytes <= 0) return '0 B';
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+}
+
+/**
+ * 相对时间（"3 分钟前"）。未来时间按"刚刚"处理。
+ * @param {number} ms - 时间戳（毫秒）
+ * @param {number} now - 当前时间（毫秒）
+ * @returns {string} 例如 "1 分钟前"
+ */
+function humanAgo(ms, now) {
+  if (!Number.isFinite(ms) || ms <= 0) return '未知';
+  const diff = Math.max(0, now - ms);
+  const sec = Math.floor(diff / 1000);
+  if (sec < 60) return '刚刚';
+  const min = Math.floor(sec / 60);
+  if (min < 60) return `${min} 分钟前`;
+  const hour = Math.floor(min / 60);
+  if (hour < 24) return `${hour} 小时前`;
+  return `${Math.floor(hour / 24)} 天前`;
+}
+
+/**
+ * 渲染技法总结进度报告。
+ *
+ * 三态来自文件系统事实（见 summary-progress.js）：
+ *   已完成 = 头部「已总结章节」覆盖了该目录的全部源文件
+ *   进行中 = 有总结文件，但还有章节没登记进去
+ *   未开始 = 没有总结文件
+ *
+ * @param {object} progress - scanSummaryProgress 的结果
+ * @param {number} now - 当前时间（毫秒）
+ * @returns {string} 多行报告
+ */
+function renderSummaryStatus(progress, now) {
+  const lines = [];
+  const total = progress.total;
+  lines.push('📊 技法总结进度（对标/wiki）');
+  lines.push('');
+
+  const nameWidth = Math.max(4, ...progress.dirs.map((d) => d.name.length));
+  const pad = (name) => name + ' '.repeat(nameWidth - name.length);
+  const lineOf = (p) => {
+    const parts = [];
+    if (p.sourceCount > 0) {
+      parts.push(p.state === 'done'
+        ? `${p.sourceCount} 章全部已总结`
+        : `已总结 ${p.summarized.length}/${p.sourceCount} 章`);
+    }
+    parts.push(`${p.entries} 条技法`);
+    if (p.exists) {
+      parts.push(humanBytes(p.bytes));
+      parts.push(`${humanAgo(p.updatedAt, now)}更新`);
+    }
+    if (p.chapterSource === 'inferred') parts.push('章节清单由正文反推');
+    if (p.chapterSource === 'none' && p.sourceCount > 0) parts.push('无章节清单');
+    return `  · ${pad(p.name)}  ${parts.join(' · ')}`;
+  };
+
+  if (total === 0) {
+    lines.push('（对标/wiki 下没有技法目录）');
+    return lines.join('\n');
+  }
+
+  lines.push(`✅ 已完成 ${progress.done.length}/${total}`);
+  if (progress.done.length === 0) lines.push('  （无）');
+  for (const p of progress.done) lines.push(lineOf(p));
+
+  lines.push('');
+  lines.push(`⏳ 进行中 ${progress.running.length}/${total}`);
+  if (progress.running.length === 0) lines.push('  （无）');
+  for (const p of progress.running) lines.push(lineOf(p));
+
+  lines.push('');
+  lines.push(`⏸ 未开始 ${progress.pending.length}/${total}`);
+  if (progress.pending.length === 0) lines.push('  （无）');
+  for (const p of progress.pending) lines.push(lineOf(p));
+
+  if (progress.noInput.length > 0) {
+    lines.push('');
+    lines.push(`ℹ️ 无输入文件（不会被派发）：${progress.noInput.map((p) => p.name).join('、')}`);
+  }
+
+  const noList = progress.dirs.filter((p) => p.exists && p.chapterSource === 'none' && p.sourceCount > 0);
+  if (noList.length > 0) {
+    lines.push('');
+    lines.push(`⚠️ 既无头部「已总结章节」清单、也无法从正文反推：${noList.map((p) => p.name).join('、')}`);
+    lines.push('   这些目录按"全部章节未总结"处理，下次 summary 会重新派发它们。');
+  }
+
+  lines.push('');
+  lines.push('💡 /fancy-analyze summary 只派发"还有章节没总结"的目录；');
+  lines.push('   /fancy-analyze resummary [技法名] 强制重来（会把旧总结移入备份目录）。');
+  return lines.join('\n');
+}
+
+export const analyze = {
+  CONSUMER_DIRS,
+
+  notify({ type, bookName, bookNameClean, projectRoot, refDir, matches, err, missingFiles, queue, extraMessage, summary }) {
+    switch (type) {
+      case 'cancelled':
+        return '🚫 已取消';
+
+      case 'no_provider':
+        return '⚠️ 当前环境不支持交互式提问。请在 dsh-tui 中运行此命令，或确保 web UI 已正确加载交互组件。';
+
+      case 'no_project_root':
+        return '❌ 无法确定项目目录：' + (err || '会话未提供 cwd') + '。请在项目目录下运行该命令。';
+
+      case 'ask_failed':
+        return '❌ 提问失败：' + (err || '未知错误');
+
+      case 'not_initialized':
+        return '⚠️ 当前目录尚未初始化，请先运行 /fancy-bootstrap 进行初始化。';
+
+      case 'deployed_unreadable':
+        // .fancy-deployed 存在但读不了。报"未初始化"会把用户引到
+        // /fancy-bootstrap，而 bootstrap 在这个状态下多半也跑不通
+        // （文件已存在），等于白跑一趟。
+        return `❌ 状态文件 .fancy-deployed 无法读取（${err || '内容异常'}）。
+
+这不是"未初始化"，所以重跑 /fancy-bootstrap 没用。
+请检查该文件是否被手工改坏，或从版本库/备份恢复它。`;
+
+      case 'source_dir_missing':
+        return `❌ 参考资料/ 目录不存在：${refDir || ''}
+
+请按以下步骤准备：
+1. 创建 参考资料/ 目录
+2. 手动下载《${bookName}》，并拷贝到 参考资料/${bookName}.txt
+3. 重新运行 /fancy-analyze ${bookName}
+
+提示：文件名后缀不限（.txt / .md / .epub 都可以），书名匹配忽略后缀。`;
+
+      case 'source_missing': {
+        const matchList = (matches && matches.length > 0)
+          ? `\n\n参考资料/ 下已有的条目：\n${matches.map(m => `  - ${m}`).join('\n')}`
+          : '';
+        return `❌ 找不到《${bookName}》的参考资料${matchList}
+
+请按以下步骤准备：
+1. 手动下载《${bookName}》，并拷贝到当前项目的 参考资料/ 目录下
+2. 重新运行 /fancy-analyze ${bookName}
+
+提示：匹配书名时忽略后缀。`;
+      }
+
+      case 'source_ambiguous':
+        return `❌ 《${bookName}》在参考资料/ 下有多个匹配：\n${(matches || []).map(m => `  - ${m}`).join('\n')}\n\n请精确指定要拆解的文件名（带后缀）。`;
+
+      case 'write_failed':
+        return '❌ 拆解结果写入失败：' + (err || '未知错误');
+
+      case 'split_failed':
+        return '❌ 拆分来源文件失败：' + (err || '未知错误');
+
+      case 'llm_wiki_not_configured':
+        return '❌ llm_wiki 未配置。请在 .fancy-deployed 中配置 llm_wiki_url 和 llm_wiki_token';
+
+      case 'llm_wiki_failed':
+        return '❌ 调用 llm_wiki 失败：' + (err || '未知错误');
+
+      case 'ingest_failed':
+        // ingest 没提交成功 = llm_wiki 那边根本不会开始拆解。
+        // 之前这条错误被吞掉，命令照样报"✅ 正在后台拆解中"，
+        // 用户等半天什么也不会发生。现在必须说出来，并给出补救路径。
+        return `❌ 拆书文件已生成，但提交给 llm_wiki 失败：${err || '未知错误'}
+
+📁 文件已保留在：对标/raw/sources/${bookNameClean || '<书名>'}/
+
+💡 排障后可重试：
+  1. /fancy-analyze status   查看 ingest 队列与缺失情况
+  2. /fancy-analyze fix      重新提交缺失章节`;
+
+      case 'no_reference_id':
+        return '⚠️ 未设置 reference_id。请先运行 /fancy-analyze <书名> 初始化项目';
+
+      case 'status_query_failed':
+        return '❌ 查询 ingest 状态失败：' + (err || '未知错误');
+
+      case 'status_result': {
+        const lines = [];
+
+        if (missingFiles && missingFiles.length > 0) {
+          lines.push('⚠️ 当前仍有文件未拆解完成：');
+          for (const f of missingFiles) {
+            lines.push(`  - ${f}`);
+          }
+        }
+
+        if (queue) {
+          const states = [
+            { key: 'cancelled', label: '取消' },
+            { key: 'done', label: '完成' },
+            { key: 'failed', label: '失败' },
+            { key: 'pending', label: '等待' },
+            { key: 'processing', label: '处理中' },
+          ];
+          for (const s of states) {
+            if (queue[s.key] > 0) {
+              lines.push(`当前${s.label}状态的任务为 ${queue[s.key]} 个`);
+            }
+          }
+        }
+
+        // 有缺失报告时，不显示"完成"消息
+        if (extraMessage) {
+          const baseMsg = lines.length > 0 ? lines.join('\n') : '⚠️ ingest 队列状态正常，但检测到以下问题：';
+          return baseMsg + '\n' + extraMessage;
+        }
+
+        if (lines.length === 0) {
+          return '✅ 所有文件已 ingest 完成，队列空闲';
+        }
+
+        return lines.join('\n');
+      }
+
+      case 'summary_status':
+        return renderSummaryStatus(summary, Date.now());
+
+      case 'summary_dispatched': {
+        const tasks = summary?.tasks || [];
+        const lines = [];
+        lines.push('✅ 已派发技法总结任务');
+        lines.push('');
+        lines.push(`📋 本次派发 ${tasks.length} 个技法目录：`);
+        for (const task of tasks) {
+          const parts = [];
+          if (Number.isFinite(task.sourceCount)) parts.push(`共 ${task.sourceCount} 章`);
+          if (Number.isFinite(task.pendingCount)) parts.push(`还差 ${task.pendingCount} 章`);
+          lines.push(`  · ${task.name}${parts.length ? '   ' + parts.join(' · ') : ''}`);
+        }
+        if (summary?.skippedDone?.length) {
+          lines.push('');
+          lines.push(`✅ 已完成、未重复派发：${summary.skippedDone.join('、')}`);
+        }
+        if (summary?.skippedNoInput?.length) {
+          lines.push(`ℹ️ 无输入文件、未派发：${summary.skippedNoInput.join('、')}`);
+        }
+        lines.push('');
+        if (Number.isFinite(summary?.remainingChapters)) {
+          lines.push(`📚 全部待总结 **${summary.remainingChapters} 章**（提示词只给目录，章节由模型自己去目录里找）`);
+        }
+        lines.push('💡 模型正在后台写文件，用 /fancy-analyze summary-status 查真实进度。');
+        lines.push('⚠️ 本命令只代表"提示词已入队"，不代表模型已经写完。');
+        return lines.join('\n');
+      }
+
+      case 'summary_nothing_to_do': {
+        const lines = [];
+        lines.push('✅ 没有需要总结的章节');
+        if (summary?.done?.length) {
+          lines.push('');
+          lines.push(`已完成：${summary.done.join('、')}`);
+        }
+        if (summary?.skippedNoInput?.length) {
+          lines.push(`ℹ️ 无输入文件：${summary.skippedNoInput.join('、')}`);
+        }
+        lines.push('');
+        lines.push('💡 要强制重来：/fancy-analyze resummary [技法名]');
+        return lines.join('\n');
+      }
+
+      case 'summary_reset': {
+        const lines = [];
+        lines.push(`♻️ 已重置 ${summary?.reset?.length || 0} 个技法的总结`);
+        lines.push('');
+        for (const item of summary?.reset || []) {
+          lines.push(`  · ${item.name}   旧总结已备份到：${item.backup}`);
+        }
+        if (summary?.dispatched?.length) {
+          lines.push('');
+          lines.push(`♻️ 已重新派发：${summary.dispatched.length} 个目录`);
+        } else {
+          lines.push('');
+          lines.push('ℹ️ 没有可派发的目录（源文件为空），只做了重置。');
+        }
+        lines.push('');
+        lines.push('💡 用 /fancy-analyze summary-status 查进度。');
+        return lines.join('\n');
+      }
+
+      case 'done': {
+        // 书名统一用 bookNameClean（它才是真实文件名去后缀的结果，
+        // 也是对标/raw/sources/ 下的目录名）——
+        // 用 bookName 的话，调用处不传就会显示成《undefined》。
+        const doneBook = bookNameClean || bookName || '';
+        return `✅ 《${doneBook}》正在后台拆解中......
+
+📁 输出位置：${projectRoot}/对标/
+  ├── schema.md                ← LLM Wiki 项目配置
+  └── raw/sources/${bookNameClean}/  ← 拆书结果
+
+💡 可在 llm_wiki 中查看拆解进度和拆解结果,也可稍后执行 fancy-analyze status 查看进度`;
+      }
+
+      default:
+        return String(type);
+    }
+  },
+
+  askBookName() {
+    return {
+      id: 'analyze-book-name',
+      // 示例写进 question 文本 —— DSH 的 AskUserQuestionItem 没有
+      // placeholder 字段（契约字段只有 id / question / detail / header /
+      // options / multiSelect / intent），传了会被运行时静默忽略。
+      question: '📖 请输入要拆解的爆款小说书名：\n例如：诡秘之主',
+    };
+  },
+
+  /**
+   * 强制约束：每次拆解必须遵守的规则
+   */
+  generateMandatoryRules() {
+    return [
+      '**必须**忽略历史对话上下文和memory，不读之前的任务结果，重新进行分析。',
+      '拆解结果**必须**使用中文撰写。',
+      '如果目标文件不存在，则首先进行新建；如果目标文件已存在，则进行覆盖写入，忽略之前已写入的内容。',
+    ].join('\n\n');
+  },
+
+  /**
+   * 拆解指引：LLM 在拆解时读取这个 markdown
+   * 告诉它拆什么、怎么组织、每份文件的具体字段
+   */
+  generateGuideMarkdown({ projectRoot, bookName, splitDir, sourceLength }) {
+    return `# 《${bookName}》拆解任务指引
+
+## 0. 资料来源
+
+- 对标资料/素材原文（已拆分为多个章节片段）：\`${splitDir}\`（共约 ${sourceLength} 字符）
+- 请先读取该目录下的所有文件，了解全文内容
+
+## 1. 拆解目标
+
+将《${bookName}》按 **下游消费者** 组织成多份 markdown，存到：
+
+\`\`\`
+${projectRoot}/对标/${bookName}/
+├── _summary.md
+├── for_bible/
+├── for_outline/
+└── for_write/
+\`\`\`
+
+每个下游 plugin（fancy-bible / fancy-outline / fancy-write）只读自己 for_xxx/ 下的内容。
+
+## 2. 拆解步骤
+
+### Step 1: 通读全文
+1. 读取 拆书/ 目录下的所有文件
+2. 边读边记笔记：主角是谁、反派是谁、核心冲突是什么
+3. 记录关键章节号（章首/章末钩子、伏笔埋设、爽点位置）
+
+### Step 2: 写 _summary.md（最重要的浓缩）
+按以下结构：
+
+\`\`\`markdown
+# 《${bookName}》一句话核心卖点
+[一句话写清这本书为什么火、读者为什么追更]
+
+# 5 个最关键发现（每个下游 plugin 都先读这个）
+1. [主角人设原型 + 共情机制]
+2. [核心爽点链：是什么事件驱动读者追更]
+3. [反派设计：让读者恨得起来的反派是怎么写的]
+4. [节奏密码：该书爽点频率比业界模板高还是低]
+5. [可复用的"金手指/系统/设定"创意模式]
+
+# 该书的核心循环
+[读者每次点开下一章时会期待什么]
+\`\`\`
+
+### Step 3: 写 for_bible/characters.md（人物全谱）
+**关键：必须包含反派和次要角色**，不只是主角。
+
+\`\`\`markdown
+# 角色全谱分析
+
+## 主角
+- 原型分类：[无敌流/废柴逆袭/重生/签到/系统/...]
+- 8 项必填：
+  1. 姓名：
+  2. 类型/职业：
+  3. 年龄：
+  4. 性别：
+  5. 性格特点（多个）：
+  6. 背景故事：
+  7. 核心目标（短/中/长）：
+  8. 核心缺陷 / 金手指：
+- 读者代入感机制：[为什么读者会共情主角]
+
+## 反派
+### 主反派
+- 姓名 / 类型：
+- 核心动机：[一句话]
+- 与主角动机冲突点：[...]
+- "立体化"程度：[脸谱化 / 有成长弧 / 有隐藏过去]
+- 是否有隐藏动机：[Y/N，什么动机]
+
+### 次要反派（阶段性 BOSS）
+- [每个列：姓名、动机、与主角冲突点、出现章节范围]
+
+## 配角（≥ 3 个）
+| 姓名 | 类型 | 核心动机 | 对主角的作用 | 出场章节范围 |
+|---|---|---|---|---|
+| 师父 | 导师 | [...] | [...] | [...] |
+| ... |
+
+## 角色动机交织（最关键！）
+> 这一段是整个 characters.md 的核心：让 fancy-bible 能直接据此设计角色生态
+
+- 主角 ↔ 主反派：[冲突的动机点]
+- 主角 ↔ 配角 A：[...]
+- 配角 A ↔ 配角 B：[...]
+- 主反派 ↔ 配角 A：[...]
+- 反派 ↔ 次要反派：[等级关系]
+\`\`\`
+
+### Step 4: 写 for_bible/relationships.md
+
+\`\`\`markdown
+# 关系网分析
+
+## 核心关系表
+| A | B | 关系类型 | 信任度（0-10） | 关系演变（起点→转折→终态） |
+|---|---|---|---|---|
+| ... |
+
+## 关系类型清单
+列出本书用到的所有关系类型（导师/朋友/敌人/对手/竞争者/恋人/家人/盟友等）
+
+## 关系演变的关键事件
+每个核心关系都列出"转折点章节"
+\`\`\`
+
+### Step 5: 写 for_bible/world.md
+
+\`\`\`markdown
+# 世界观卖点
+
+## 该书世界观为什么吸引人
+[一句话核心卖点]
+
+## 设定易理解度
+- 新读者多久能上手（章数）：[...]
+- 信息释放节奏：[前期详细 / 后期慢慢展开]
+
+## 力量体系
+- 境界链：[...]
+- 力量获取方式：[...]
+- 平衡机制：[...]
+- 代价：[金手指有没有副作用]
+
+## 该书世界观的可扩展性
+[能写多长 / 续集空间]
+\`\`\`
+
+### Step 6: 写 for_outline/plot_structure.md
+
+\`\`\`markdown
+# 剧情结构分析
+
+## 主线
+- 一句话：
+- 阶段划分：[阶段1（第 X-Y 章）：..., 阶段2：..., 阶段3：..., 阶段4：...]
+- 该书主线与模板的差异：[为什么这样设计能火]
+
+## 副线（≥ 3 条）
+| 线 | 名称 | 起点 | 收束 | 主/副 | 与主线交织点 |
+|---|---|---|---|---|---|
+| L2 | [...] | [...] | [...] | 副 | [...] |
+| L3 | [...] | [...] | [...] | 副 | [...] |
+| L4 | [...] | [...] | [...] | 副 | [...] |
+
+## 多线交叉点
+| 章节 | L1 | L2 | L3 | L4 | 交叉类型（汇合/分裂/呼应） |
+|---|---|---|---|---|---|
+| [...] | ✓ | ✓ | - | - | [...] |
+\`\`\`
+
+### Step 7: 写 for_outline/pacing.md
+
+\`\`\`markdown
+# 节奏分析
+
+## 30/40/30 分布
+[该书每章铺垫/兑现/余波占比实际是多少]
+
+## 爽点频次（必须实际数据）
+- 总爽点数：
+- 平均章数/爽点：
+- 频次区间：[Ch X-Y 是密集爽点期，Ch M-N 是平稳过渡期]
+
+## 危机链
+| 序号 | 章节范围 | 危机类型 | 升级幅度 |
+|---|---|---|---|
+| 1 | [...] | [...] | [...] |
+| 2 | [...] | [...] | [...] |
+| ... |
+
+## 卷末高潮分布
+| 卷 | 章范围 | 高潮类型 | 与模板的差异 |
+|---|---|---|---|
+| 1 | [...] | [...] | [...] |
+\`\`\`
+
+### Step 8: 写 for_outline/chapter_templates.md
+
+\`\`\`markdown
+# 章首/章尾钩子实战分析
+
+## 章首钩子（7 种）的实际用法
+| 钩子类型 | 使用频次 | 该书的典型案例（章号 + 摘要） |
+|---|---|---|
+| 悬念对话引子 | [...] | Ch X：... |
+| 内心独白引子 | [...] | Ch Y：... |
+| 反差场景引子 | [...] | ... |
+| 未完成动作引子 | [...] | ... |
+| 意象伏笔引子 | [...] | ... |
+| 时间错位引子 | [...] | ... |
+| 物件细节引子 | [...] | ... |
+
+## 章尾钩子（13 种）的实际用法
+[同样列表]
+
+## 断章点技巧
+[该书在哪一句断章效果最好]
+\`\`\`
+
+### Step 9: 写 for_outline/foreshadow_patterns.md
+
+\`\`\`markdown
+# 伏笔实战分析
+
+## 信息差分布
+| 章节 | 读者知道 | 角色不知道 | 伏笔类型 |
+|---|---|---|---|
+| [...] | ✓ | - | [...] |
+
+## 该书的伏笔密度
+- 总伏笔：
+- 平均章数/伏笔：
+- 高频伏笔类型：[最常用的 3-5 种]
+
+## 期待感管理
+- 该书什么时候给读者"小兑现"：[...]
+- 什么时候给"大兑现"：[...]
+- 兑现节奏与模板的差异：[...]
+\`\`\`
+
+### Step 10: 写 for_write/voice.md
+
+\`\`\`markdown
+# 文风指纹
+
+## 句长分布
+- 平均句长：[字数]
+- 短句（<20 字）比例：[%]
+- 中句（20-50 字）比例：[%]
+- 长句（>50 字）比例：[%]
+- 典型长句：[从该书摘 3 个]
+
+## 长短句组合
+- 短-长-短模式：[...]
+- 段落平均句数：[...]
+
+## 标点节奏
+- 句号 : 逗号 : 问号 : 感叹号 = [比例]
+
+## 分段模式
+- 平均段长：[句数]
+- 长段（>5 句）出现频率：[...]
+- 单句成段频率：[...]
+
+## 对话 vs 叙述
+- 对话占比：[%]
+- 对话平均字数：[...]
+- 叙述段平均字数：[...]
+
+## 标志性修辞
+[列出该书反复用的 3-5 种修辞手法，各给一个例子]
+\`\`\`
+
+### Step 11: 写 for_write/sentence_patterns.md
+
+\`\`\`markdown
+# 标志性句式
+
+## 该书反复用的 5-10 种句式
+[每种句式：模板 + 该书典型例子 + 使用场景]
+
+## 长短句组合模式
+[列出该书的典型段落节奏模式]
+
+## 段落开头的偏好
+[该书喜欢怎么开段——时间/地点/对话/动作/感受/...]
+\`\`\`
+
+### Step 12: 写 for_write/phrase_bank/
+
+四个文件：
+- action.md：动作描写库（每种情绪/场景 5-10 种说法）
+- psychology.md：心理描写库
+- environment.md：环境描写库
+- dialogue.md：对话标签库
+
+每个文件结构：
+\`\`\`markdown
+# <情绪/场景> 描写库
+
+## 紧张
+- [...]
+- [...]
+
+## 愤怒
+- [...]
+
+## 喜悦
+- [...]
+\`\`\`
+
+## 3. 重要约束
+
+- 每份文件都必须有实际内容，不要只放标题
+- 每条结论必须引用具体章节号或场景
+- 反派/配角必须和主角一样详细，不能省
+- 角色动机必须能解释"为什么这么做"（不是"做了这个动作"）
+- 量化数据必须实际估算（不能写"很多"/"少"）
+- 每份文件不少于 200 字
+- 使用中文输出
+
+## 4. 完成检查
+
+写完所有文件后，检查每个文件存在且非空：
+- 对标/${bookName}/_summary.md（≥ 200 字）
+- 对标/${bookName}/for_bible/characters.md（≥ 500 字）
+- 对标/${bookName}/for_bible/relationships.md（≥ 200 字）
+- 对标/${bookName}/for_bible/world.md（≥ 200 字）
+- 对标/${bookName}/for_outline/plot_structure.md（≥ 200 字）
+- 对标/${bookName}/for_outline/pacing.md（≥ 200 字）
+- 对标/${bookName}/for_outline/chapter_templates.md（≥ 200 字）
+- 对标/${bookName}/for_outline/foreshadow_patterns.md（≥ 200 字）
+- 对标/${bookName}/for_write/voice.md（≥ 200 字）
+- 对标/${bookName}/for_write/sentence_patterns.md（≥ 200 字）
+- 对标/${bookName}/for_write/phrase_bank/action.md（≥ 10 条）
+- 对标/${bookName}/for_write/phrase_bank/psychology.md（≥ 10 条）
+- 对标/${bookName}/for_write/phrase_bank/environment.md（≥ 10 条）
+- 对标/${bookName}/for_write/phrase_bank/dialogue.md（≥ 10 条）
+`;
+  },
+
+  /**
+   * 生成技法总结提示词。
+   *
+   * ## 为什么按"章节"派发的判定权交给模型
+   *
+   * 插件算得出"还差哪些章节"，但**不能把章节名列进提示词**：
+   * 长篇几千章时，16 目录 × 200 章 = 3200 个文件名，中文文件名约 1 字 1 token，
+   * 光这一份清单就是 ~50K token 的静态提示词（实测 3200 章 → 71 KB，
+   * 16000 章 → 652 KB），而且它每一轮都跟着 agent 循环，占着上下文窗口不放。
+   *
+   * 所以提示词只给**目录**，并把"怎么判断哪些章节还没总结"写成明确步骤：
+   *   1. 读总结文件的**文件头**（两段 `---` 之间的 YAML）
+   *   2. 里面的 `已总结章节:` 就是已经总结过的章节名
+   *   3. 列出源文件目录下所有 `.md`（排除总结文件本身）
+   *   4. 差集 = 这次要总结的章节
+   *
+   * 提示词体积于是变成 O(目录数) —— 十几个目录就是十几行，
+   * 与小说多长**完全无关**。
+   *
+   * 插件仍然算得出"还差多少章"，但那个数字只用来**报给用户看**，
+   * 不进提示词。
+   *
+   * ## 为什么头部清单是唯一事实源
+   *
+   * 原来是把整个技法目录丢给模型，让它自己读全部文件、自己判断哪些总结过。
+   * 那是**软约束** —— 模型不保证真的跳过，于是重复执行 summary 会把
+   * 已总结的章节再读一遍、再追加一遍，文件越滚越胖。
+   *
+   * 现在头部记录「已总结章节」，模型每总结完一章就追加进去。
+   * 于是"重复执行 summary 不重复总结"变成**可验证的事实**，
+   * 而不是寄望模型自觉。
+   *
+   * @param {object} opts
+   * @param {Array<{name: string, sourceCount?: number, pendingCount?: number}>} opts.tasks
+   *   每个要处理的技法目录：name=目录名，sourceCount=该目录共多少章节文件，
+   *   pendingCount=按现有清单还差多少章（算不出来时省略）
+   * @param {number} [opts.remainingChapters] - 全部目录加起来还剩多少章（只用于给用户看）
+   * @returns {string} 提示词正文
+   */
+  generateSummarySystemPrompt({ tasks, remainingChapters }) {
+    const list = Array.isArray(tasks) ? tasks : [];
+    const taskBlocks = list.map((task) => {
+      const sourceCount = Number.isFinite(task.sourceCount) ? task.sourceCount : null;
+      const pendingCount = Number.isFinite(task.pendingCount) ? task.pendingCount : null;
+      const scale = [];
+      if (sourceCount !== null) scale.push(`共有 ${sourceCount} 个章节文件`);
+      if (pendingCount !== null) scale.push(`按现有清单还差 ${pendingCount} 章`);
+      const scaleLine = scale.length > 0 ? `- 规模：${scale.join(' · ')}\n` : '';
+      const dir = task.name;
+      return `#### 技法目录：${dir}
+
+- 源文件目录：\`对标/wiki/${dir}/\`
+- 总结文件：\`对标/wiki/${dir}/${dir}-总结.md\`
+${scaleLine}- **怎么找出这次要总结的章节**（每个目录都照这个流程走）：
+  1. 打开总结文件 \`对标/wiki/${dir}/${dir}-总结.md\`，**只看文件头**（开头两段 \`---\` 之间的 YAML），里面 \`已总结章节:\` 下列的就是**已经总结过**的章节名（章节名 = 源文件名去掉 \`.md\` 后缀）。总结文件还不存在时，这一步跳过（等于一张白纸）
+  2. 列出源文件目录 \`对标/wiki/${dir}/\` 下所有 \`.md\` 文件，**排除** \`${dir}-总结.md\` 本身
+  3. 第 2 步的清单减掉第 1 步的清单，**差集**就是这次要总结的章节
+  4. **不要把章节清单写进你的计划或正文** —— 边读边处理，读一个处理一个`;
+    }).join('\n\n');
+
+    const checkList = list.map((task) => `- \`对标/wiki/${task.name}/${task.name}-总结.md\``).join('\n');
+
+    const totalPending = Number.isFinite(remainingChapters) ? remainingChapters : null;
+    const scaleNote = totalPending !== null
+      ? `> 全部目录加起来，按现有清单还差 **${totalPending} 章**没总结。`
+      : '';
+
+    return `你是一位经验丰富、资历深厚、在小说领域有着独到见解并且逻辑思维缜密的小说技法分析师。
+
+## 核心铁律
+**每次调用都是全新流程**，不读取上下文，不读取之前的选择，不读 memory。
+**只处理下面明确列出的技法目录**，不要自行扩大范围。
+
+${scaleNote}
+> ⚠️ 本提示词**故意不列具体章节名** —— 一本长篇可能几千章，列出来会把提示词撑爆。
+> 哪些章节还没总结，由你按每个目录下方写的步骤**自己去目录里判断**。
+
+## ⚠️ 语言强制要求
+
+**所有输出内容必须是中文，包括：**
+- 文件名：使用中文
+- 标题：使用中文
+- 正文内容：所有文字描述必须使用中文
+- 表格内容：所有表格中的文字必须使用中文
+- YAML 元数据：**键和值都必须用中文**
+
+**禁止输出英文内容：**
+- ❌ 英文描述、英文分析
+- ❌ 英文 YAML 键
+- ❌ 英文 YAML 值
+- ❌ 中英混合
+
+## ⚠️ 占位符说明
+
+下方提示词中用 **\`[\`** 和 **\`]\`** 包裹的内容都是**占位符**，需要你根据读取到的文件内容进行推理和补充，不要直接输出占位符原文。
+
+## 任务
+
+请对下面每个技法目录里**尚未总结**的章节进行归纳、总结、提炼、挖掘、扩展，
+提炼出通用的、可复用的写作技法。
+
+### 本次要总结的技法目录
+
+${taskBlocks}
+
+### 操作要求
+
+**增量写入方式**：为避免超出上下文限制，请采用增量写入方式，每个目录处理流程如下：
+
+1. **按上述步骤算出这次要总结的章节**（读总结文件头 → 列源文件 → 求差集）
+2. **逐文件读取提炼**：依次读取算出来的每个文件（文件名去掉 \`.md\` 后缀即为章节名），边读边提炼，**每读完一个文件立即将提炼结果追加写入总结文件**（使用文件路径 \`对标/wiki/[目录名]/[目录名]-总结.md\`）
+3. **登记章节**：**每总结完一个章节，立刻把该章节名追加进总结文件头部的「已总结章节」列表**（见下方写入格式）。这是本次任务的关键产出 —— 插件靠它判断哪些章节已经总结过，下次执行时只派发剩下的
+4. **不要写章节清单**：不要把"待总结章节列表"整体写进计划、进度汇报或正文里（章节可能上千个，写出来会挤爆上下文）；只报"处理了 N 个"这类数字即可
+5. **做不完就停**：按你的上下文能力处理，做到快满时停下，剩下的**下次执行 summary 会继续**（已完成的章节已经登记，不会重复）
+6. **去重合并**：当多个文件提炼出相同技法时，在总结文件中合并，只保留一条
+7. **继续下一目录**：完成一个目录后，继续处理下一个目录
+
+### 写入格式
+
+**第一步：写入文件头（仅当文件不存在时）**
+
+每次追加写入前，先检查总结文件是否存在。如果不存在，则先写入以下内容：
+
+\`\`\`yaml
+---
+标题: [目录名]-总结
+标签: [总结, 目录名]
+已总结章节:
+  - [已总结的章节名，去掉 .md 后缀]
+---
+# [目录名]技法总结
+
+## 核心技法
+\`\`\`
+
+**第二步：追加技法内容（每次提炼后）**
+
+如果文件已存在，则在 \`## 核心技法\` 章节下追加以下内容：
+
+\`\`\`yaml
+### [提炼出的技法名称]
+- 来源章节：[来自哪些文件]
+- 核心要点：[技法的核心内容]
+- 使用场景：[在哪些情况下使用]
+- 应用方式：[如何应用]
+\`\`\`
+
+**第三步：登记已总结章节（每总结完一章立刻做）**
+
+在文件头部的 \`已总结章节:\` 列表下**追加**一行（不要覆盖已有条目，
+不要重复添加同一个章节名）：
+
+\`\`\`yaml
+已总结章节:
+  - [第1个章节名]
+  - [第2个章节名]
+\`\`\`
+
+章节名 = 源文件名去掉 \`.md\` 后缀（例如源文件 \`[书名]-[技法名]-第3章.md\`
+→ 章节名 \`[书名]-[技法名]-第3章\`）。
+
+## 闭环检查
+
+在完成所有目录的总结后，必须进行检查：
+
+**文件存在性检查**：确认以下每个目录下都存在总结文件：
+${checkList}
+
+如果发现某个目录下缺少总结文件，必须立即生成。
+
+**章节登记检查**：确认每个总结文件的 \`已总结章节:\` 列表包含了该目录下
+**你已经处理过的全部章节**。少登记一个，下次执行 summary 就会重复总结它。
+
+## ⚠️ 重要提醒
+
+- **去重原则**：如果多个章节使用了相同技法，只总结一次
+- **不越界**：只处理算出来的差集，不要顺手处理目录里其它章节
+- **格式要求**：每个总结文件必须包含 YAML 元数据
+- **内容要求**：总结内容必须是具体、可操作的写作技法，不是泛泛而谈的描述
+
+请开始执行总结任务，完成后输出总结报告。`;
+  },
+};