@cloud411716/fancy-webnovel 1.0.46 → 3.0.0

package/plugins/fancy-import/prompts/01-import-prompt.md

@@ -0,0 +1,131 @@
+# 01 导入执行须知
+
+> 本文件是导入阶段的**产物契约**：从旧稿反推出什么文件、写成什么格式、什么会被拦下。
+> 导入的因果方向和正向四阶段相反：
+> **旧稿已经在那里了 → 你把它读成结构化产物**，而不是照配额从零造。
+>
+> 导入阶段由插件驱动：它扫目录、切章、算配额、跑校验器、把错误发回来。
+> **你不需要自己决定写哪些文件，也不需要自己跑校验脚本。**
+
+---
+
+## 〇、路径口径
+
+**项目根的绝对路径：`${projectRoot}`**
+
+本文件与每轮派活里出现的路径都相对于项目根，但**读文件、写文件一律用绝对路径**（`<项目根>/...`）——你的工作目录未必是项目根：用相对路径会读不到旧稿，也会把产物写到别的地方去，插件在项目根下找不到文件，只会回一句"文件没有生成"。
+
+---
+
+## 一、核心铁律
+
+> 1. **只反推，不创作**。旧稿里没有的人物、势力、地点、伏笔**不许新增**。
+>    你的任务是"把旧稿里已经有的东西整理成结构化数据"，
+>    不是"补全一部没写完的小说"。
+>    旧稿确实没写到的部分**留空**，由插件在报告里列成待补清单。
+>
+> 2. **不改旧稿正文**。正文由插件直接落盘（保留原标题），
+>    你只负责反推结构化产物。写了正文也算违反契约。
+>
+> 3. **不修改 `模板/` 和 `references/` 下的任何文件**。这两个目录是只读输入。
+>
+> 4. **只写本轮指定的文件**。本轮要写哪几个文件，驱动会在派活时列清楚。
+>    不要顺手多写，也不要改别的阶段的文件。
+>
+> 5. **引用的实体只能用 id 引用**（如 `C001`），不要在关系里写名字。
+
+---
+
+## 二、产物清单
+
+| 阶段 | 文件 | 落盘路径（绝对路径） |
+|---|---|---|
+| 骨架 | 实体.json | `${projectRoot}/设定/raw/sources/骨架/实体.json` |
+| 骨架 | 关系.json | `${projectRoot}/设定/raw/sources/骨架/关系.json` |
+| 骨架 | 层级.json | `${projectRoot}/设定/raw/sources/骨架/层级.json` |
+| 血肉 | 角色.json 等 8 个 | `${projectRoot}/设定/raw/sources/血肉/<名字>.json` |
+| 节奏 | 章节规划.json 等 4 个 | `${projectRoot}/设定/raw/sources/节奏/<名字>.json` |
+| 写作 | 4 个台账 | `${projectRoot}/设定/raw/sources/写作/台账/<名字>.json` |
+
+**`${projectRoot}/设定/raw/sources/骨架/框架.json` 由插件生成，不要写。**里面的 `quota` 是插件从旧稿实际规模
+反推出来的（推不出来的按公式补齐），你写的实体条数必须和它对得上。
+
+---
+
+## 三、怎么反推
+
+### 3.1 通用原则
+
+1. **先通读**：驱动会把旧稿的正文（或设定资料）摘要给你，先建立整体印象。
+2. **再归类**：把旧稿里出现过的东西按类型归到实体清单里。
+3. **只登记出现过的东西**：每个实体都要能在旧稿里找到出处
+   （角色有出场、势力有提及、地点有场景）。
+4. **拿不准就留空**：宁可少写一个，也别编一个。插件会把没写的列进待补清单。
+
+### 3.2 各阶段要点
+
+| 阶段 | 反推什么 | 注意 |
+|---|---|---|
+| 骨架 | 实体 / 关系 / 层级 | 只登记"出现过"的；层级里的卷要对应旧稿实际的卷 |
+| 血肉 | 每个实体"具体什么样" | 旧稿里写明的外貌/动机/口吻照抄；没写的留空字符串 |
+| 节奏 | 什么时间发生什么 | 章节号对应旧稿的实际章号；旧稿没写的章不要编 |
+| 台账 | 已发生的状态 | 章台账按 `ch` 一章一条；人物/伏笔/时间线照实记 |
+
+### 3.3 字段与枚举
+
+- 字段结构、id 规则、枚举取值：**以 `模板/` 下对应模板为准**
+  （`${projectRoot}/模板/骨架/实体模板.json` 等，**用绝对路径读**）。
+- 枚举词表（角色类型、冲突类型、伏笔类型…）：**以 `${projectRoot}/references/glossary.md` 为准**。
+  写错枚举值会被校验器拦下。
+
+---
+
+## 四、会被拦下的东西
+
+| 类别 | 错误码 | 说明 |
+|---|---|---|
+| 必填 | `REQUIRED` | 必填字段为空 |
+| 类型 | `TYPE` | 字段类型不对（该是数组写成了对象） |
+| id 规则 | `ID_FORMAT` / `ID_DUP` | id 不符合 `C001` / `F001` 这类格式，或 id 重复 |
+| 枚举 | `ENUM_INVALID` | 取值不在 glossary 的词表里 |
+| 引用 | `REF_UNKNOWN` | 关系里引用了不存在的 id |
+| 配额 | `QUOTA_MISMATCH` | 条数和 `框架.json` 里的 `quota` 对不上 |
+| 结构 | `DERIVATION_MISSING` | `${projectRoot}/设定/raw/sources/骨架/框架.json` 缺推导记录（**这个由插件生成，你不用管**） |
+| 内容 | `NAME_PLACEHOLDER` / `TEXT_PLACEHOLDER` / `TEXT_TOO_SHORT` / `TEXT_DUPLICATE` | 实体名是"主角1"这类标签、字段是"待补充"这类占位、字段太短、同质化 |
+| 没落盘 | `NO_OUTPUT` | **插件没等到你写文件**：多半是路径写歪了（用了相对路径），也可能是这一轮超时或被中断 |
+| 没落盘 | `READ` | 插件在项目根下没找到本轮要写的文件，或它不是合法 JSON |
+| 校验器 | `VALIDATOR_CRASH` | 校验脚本自己崩了——**不是你的产物有问题**，照原样再交一次即可 |
+
+**什么算这一轮通过**：插件跑完校验器，**没有回任何错误**就是通过。
+下一轮派活里如果带着「上一轮的校验错误」，就是没通过，按第五节处理。
+
+---
+
+## 五、收到校验错误后怎么改
+
+驱动会把校验错误原样发回来（`code` / `path` / `message` / `hint`）。按这个顺序处理：
+
+1. **只改错误指向的字段**。错误没提到的部分不要动。
+2. **按 `hint` 的方向改**，不要绕过。
+3. **不要为了通过校验而编造内容**。校验器拦下"实体名是占位名"时，正确做法是**删掉这个编出来的实体**，不是给它起个像样的名字。
+4. 改完**重新写整个文件**（产物是整份覆盖，不是打补丁）。
+
+**上面几类特殊错误码另说**：
+
+- `NO_OUTPUT` / `READ`（文件没落盘）→ **先确认你用的是绝对路径**
+  （派活里给的那条 `<项目根>/设定/raw/sources/...`），目录不存在就先建目录，然后把整个文件**重新写一遍**。
+  不要因为"内容我已经想好了"就跳过写文件——
+  没落盘 = 这一轮没做，下一次还会重来。
+- `VALIDATOR_CRASH`（校验器自己崩了）→ 不用改产物，原样重交一次。
+
+**同一轮最多试 3 次**（派活标题里写着"第 N 次尝试"）。
+第 3 次还没通过，插件会停在这一轮并写进导入报告；这时候**不要自己接着往下写别的阶段**，等插件告诉你下一步。
+
+**汇报格式**（每轮完成后给一段话）：
+
+```
+本轮完成：骨架（实体.json / 关系.json / 层级.json）
+- 实体 12 条：角色 5、冲突 3、势力 2、地点 2
+- 关系 18 条、层级 1 卷 3 主线 5 支线
+- 旧稿没写到的：地点的详细描述（已留空）
+```

package/plugins/fancy-import/templates.js

@@ -0,0 +1,58 @@
+/**
+ * fancy-import 插件的文案模板
+ */
+
+export const importTemplates = {
+  /**
+   * 通知文案。
+   * @param {Object} o
+   * @param {string} o.type
+   */
+  notify({ type, err, extra, chapters, files, rounds, failed }) {
+    switch (type) {
+      case 'help':
+        return `📥 旧稿导入 用法
+
+/fancy-import <旧稿目录或文件>  导入旧稿并自动切章
+/fancy-import                  默认读取项目内的 旧稿/ 目录
+/fancy-import help             显示本帮助
+
+作用：把旧稿导入到 设定/raw/sources/，并纳入 llm_wiki 项目。`;
+
+      case 'no_project_root':
+        return '❌ 无法确定项目目录：' + (err || '会话未提供当前工作目录') + '。请在项目目录下运行该命令。';
+
+      case 'not_initialized':
+        return '⚠️ 当前目录不属于已初始化的 fancy-webnovel 工作区。请先运行 /fancy-bootstrap 初始化工作区。';
+
+      case 'no_source':
+        return '❌ 旧稿导入失败：' + (err || '未知错误');
+
+      case 'no_source_arg':
+        return '⚠️ 请指定要导入的旧稿路径：\n'
+          + '/fancy-import <旧稿目录或文件>\n'
+          + '（目录中的 .txt / .md 文件会被扫描，正文与设定资料将自动归类。）';
+
+      case 'deploy_failed':
+        return '❌ 导入阶段文件部署失败：' + (err || '未知错误') + '。请检查磁盘空间和目录权限后重试。';
+
+      case 'setup_id_unavailable':
+        return '❌ 未能建立 llm-wiki 设定项目：' + (err || '未知原因') +
+          '\n导入产物必须位于「设定」目录下才会被纳管。请先按提示完成 llm-wiki 配置。';
+
+      case 'import_done':
+        return '✅ 导入完成：' + chapters + ' 章旧稿已转成 story-builder 格式，' +
+          (rounds || 0) + ' 轮反推的**单文件校验**都通过（跨文件一致性由骨架阶段的 `--all` 校验把关）。' +
+          '报告见 `导入报告/导入报告.md`。' +
+          (extra ? '\n\n' + extra : '');
+
+      case 'import_incomplete':
+        return '⚠️ 旧稿导入已完成，但有 ' + (failed || 0) + ' 轮反推未通过校验。' +
+          '**当前导入产物不完整**，待补清单见 `导入报告/导入报告.md`。' +
+          (extra ? '\n\n' + extra : '');
+
+      default:
+        return extra || '';
+    }
+  }
+};

package/plugins/fancy-material/exporter.js

@@ -0,0 +1,153 @@
+/**
+ * Material library Markdown export for atomic blocks.
+ *
+ * Every record is one small block (name + tags + genres + optional note), so
+ * the export is deliberately terse:
+ *
+ *   ## 命名
+ *   ### 地名（place_name）
+ *   #### 归墟
+ *   - **tags**：地名、海、尽头、仙侠
+ *   - **genres**：仙侠、通用
+ */
+
+import path from 'path';
+import { atomicWriteFile } from '#atomic-write';
+import { localIsoString } from '#workspace';
+import { connectMaterial } from '#material-db';
+import { KIND_GROUPS, KIND_LABELS } from './kinds.js';
+
+const KIND_ORDER = KIND_GROUPS.flatMap((group) => group.kinds);
+const GROUP_OF = new Map();
+for (const group of KIND_GROUPS) {
+  for (const kind of group.kinds) GROUP_OF.set(kind, group.title);
+}
+
+function text(value) {
+  return String(value == null ? '' : value).replace(/\r?\n/g, ' ').trim();
+}
+
+function heading(value) {
+  return text(value).replace(/\s+/g, ' ').trim() || '（未命名）';
+}
+
+function valueText(value) {
+  if (value === undefined || value === null || value === '') return '—';
+  if (Array.isArray(value)) {
+    return value.length ? value.map((item) => text(item)).join('、') : '—';
+  }
+  return text(value);
+}
+
+/**
+ * Render atomic materials as Markdown.
+ *
+ * @param {Array<object>} records
+ * @param {{workspace?: string, database?: string, exported_at?: string}} [meta]
+ * @returns {string}
+ */
+export function renderMaterialMarkdown(records, meta = {}) {
+  const list = Array.isArray(records) ? records : [];
+  const byKind = new Map();
+  for (const record of list) {
+    const kind = String(record && record.kind || 'unknown');
+    if (!byKind.has(kind)) byKind.set(kind, []);
+    byKind.get(kind).push(record);
+  }
+  for (const rows of byKind.values()) {
+    rows.sort((a, b) => String(a.name || '').localeCompare(String(b.name || ''), 'zh-CN'));
+  }
+
+  const lines = [];
+  lines.push('# 网文创作素材库');
+  lines.push('');
+  lines.push('> 导出时间：' + (meta.exported_at || localIsoString()));
+  if (meta.workspace) lines.push('> 工作区：' + meta.workspace);
+  if (meta.database) lines.push('> 数据库：' + meta.database);
+  lines.push('> 素材：' + list.length + ' 条 · 类型：' + byKind.size + ' 个');
+  lines.push('');
+
+  if (!list.length) {
+    lines.push('暂无素材。运行 `/fancy-material` 生成，或 `/fancy-material import <文件>` 导入。');
+    lines.push('');
+    return lines.join('\n');
+  }
+
+  lines.push('## 目录');
+  lines.push('');
+  for (const group of KIND_GROUPS) {
+    const rows = group.kinds.reduce((sum, kind) => sum + (byKind.get(kind)?.length || 0), 0);
+    if (!rows) continue;
+    lines.push(`- ${group.title}：${rows} 条`);
+  }
+  lines.push('');
+
+  for (const group of KIND_GROUPS) {
+    const groupRows = group.kinds.reduce((sum, kind) => sum + (byKind.get(kind)?.length || 0), 0);
+    if (!groupRows) continue;
+    lines.push('## ' + group.title);
+    lines.push('');
+    for (const kind of group.kinds) {
+      const rows = byKind.get(kind) || [];
+      if (!rows.length) continue;
+      lines.push(`### ${KIND_LABELS[kind] || kind}（${kind}）`);
+      lines.push('');
+      for (const record of rows) {
+        lines.push('#### ' + heading(record.name));
+        lines.push('');
+        lines.push('- **tags**：' + valueText(record.tags));
+        lines.push('- **genres**：' + valueText(record.genres));
+        if (record.source) lines.push('- **source**：' + text(record.source));
+        if (record.note) lines.push('- **note**：' + text(record.note));
+        lines.push('');
+      }
+    }
+  }
+
+  // Include any unknown kinds at the end rather than silently dropping them.
+  const unknown = [...byKind.keys()].filter((kind) => !KIND_ORDER.includes(kind));
+  if (unknown.length) {
+    lines.push('## 其他');
+    lines.push('');
+    for (const kind of unknown) {
+      lines.push(`### ${kind}`);
+      lines.push('');
+      for (const record of byKind.get(kind)) {
+        lines.push('#### ' + heading(record.name));
+        lines.push('');
+        lines.push('- **tags**：' + valueText(record.tags));
+        lines.push('- **genres**：' + valueText(record.genres));
+        if (record.source) lines.push('- **source**：' + text(record.source));
+        if (record.note) lines.push('- **note**：' + text(record.note));
+        lines.push('');
+      }
+    }
+  }
+
+  return lines.join('\n').replace(/\n{3,}/g, '\n\n').replace(/\n*$/, '\n');
+}
+
+/**
+ * Query the material DB and write `<workspace>/素材库.md`.
+ *
+ * @param {string} root workspace directory
+ * @returns {Promise<{file: string, count: number, kinds: number, database: string}>}
+ */
+export async function exportMaterials(root) {
+  const { db, database } = await connectMaterial(root);
+  try {
+    const rows = await db.query('SELECT kind, name, tags, genres, note, source FROM material ORDER BY kind, name;');
+    const records = Array.isArray(rows) && Array.isArray(rows[0]) ? rows[0] : [];
+    const file = path.join(path.resolve(root), '素材库.md');
+    const markdown = renderMaterialMarkdown(records, {
+      workspace: root,
+      database,
+      exported_at: localIsoString(),
+    });
+    atomicWriteFile(file, markdown, { mode: 0o644 });
+    const kinds = new Set(records.map((record) => record.kind).filter(Boolean));
+    return { file, count: records.length, kinds: kinds.size, database };
+  } finally {
+    try { await db.close(); } catch { /* ignore */ }
+  }
+}

package/plugins/fancy-material/genres.js

@@ -0,0 +1,256 @@
+/**
+ * Genre discovery for the material library.
+ *
+ * Two sources:
+ *   1. A topic_decision file: use the genres listed under its "选题方向" section.
+ *   2. Fanqie scan data: the `## <genre> — N 本` headings contain the most
+ *      complete genre list available in the workspace.
+ *
+ * If neither exists (for example when printing the prompt outside a workspace),
+ * fall back to the known Fanqie genre list. That keeps `prompt` usable as a
+ * standalone all-genres prompt.
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { workspacePaths } from '#workspace';
+
+export const FALLBACK_GENRES = [
+  '西方奇幻',
+  '东方仙侠',
+  '科幻末世',
+  '都市日常',
+  '都市修真',
+  '都市高武',
+  '历史古代',
+  '战神赘婿',
+  '都市种田',
+  '传统玄幻',
+  '历史脑洞',
+  '悬疑脑洞',
+  '都市脑洞',
+  '玄幻脑洞',
+  '悬疑灵异',
+  '抗战谍战',
+  '游戏体育',
+  '动漫衍生',
+  '男频衍生',
+  '古风世情',
+  '女频衍生',
+  '玄幻言情',
+  '种田',
+  '年代',
+  '现言脑洞',
+  '宫斗宅斗',
+  '古言脑洞',
+  '快穿',
+  '青春甜宠',
+  '星光璀璨',
+  '女频悬疑',
+  '职场婚恋',
+  '豪门总裁',
+  '民国言情',
+];
+
+function unique(values) {
+  const seen = new Set();
+  const out = [];
+  for (const value of values) {
+    const text = String(value || '').trim();
+    if (!text || seen.has(text)) continue;
+    seen.add(text);
+    out.push(text);
+  }
+  return out;
+}
+
+function cleanGenre(value) {
+  return String(value || '')
+    .replace(/\*\*/g, '')
+    .replace(/^[\s\-*|]+/, '')
+    .replace(/[\s\-*|]+$/, '')
+    .replace(/[（(].*?[）)]/g, '')
+    .trim();
+}
+
+function splitGenres(value) {
+  return unique(String(value || '')
+    .split(/[、，,/；;]/)
+    .map(cleanGenre)
+    .filter((item) => item && !['全部', '通用', '其他', '未知'].includes(item)));
+}
+
+/**
+ * List all topic_decision_*.md files in <workspace>/扫榜结果, newest first.
+ *
+ * The material command lets the user pick one when several reports exist;
+ * it never merges the genre lists of multiple reports.
+ *
+ * @param {string} root workspace directory
+ * @returns {string[]} absolute file paths
+ */
+export function listTopicDecisionFiles(root) {
+  const dir = workspacePaths(root).scan;
+  let names;
+  try {
+    names = fs.readdirSync(dir);
+  } catch {
+    return [];
+  }
+  return names
+    .filter((name) => /^topic_decision_.*\.md$/i.test(name))
+    .sort()
+    .reverse()
+    .map((name) => path.join(dir, name))
+    .filter((file) => {
+      try {
+        const stat = fs.lstatSync(file);
+        return stat.isFile() && !stat.isSymbolicLink();
+      } catch {
+        return false;
+      }
+    });
+}
+
+/**
+ * Find the latest topic_decision_*.md in <workspace>/扫榜结果.
+ *
+ * @param {string} root workspace directory
+ * @returns {string|null}
+ */
+export function latestTopicDecision(root) {
+  return listTopicDecisionFiles(root)[0] || null;
+}
+
+/**
+ * Extract genres from the "选题方向" section of a topic_decision report.
+ *
+ * Supports both the current markdown table (`方向 | 题材 | ...`) and simple
+ * bullet lines such as `- **题材**：仙侠、都市高武`.
+ *
+ * @param {string} text
+ * @returns {string[]}
+ */
+export function parseTopicDecisionGenres(text) {
+  const source = String(text || '');
+  const lines = source.split(/\r?\n/);
+  let start = -1;
+  for (let i = 0; i < lines.length; i += 1) {
+    if (/^##\s*(?:[一二三四五六七八九十]+、)?选题方向(?:建议)?\s*$/.test(lines[i].trim())) {
+      start = i;
+      break;
+    }
+  }
+  if (start === -1) return [];
+
+  let end = lines.length;
+  for (let i = start + 1; i < lines.length; i += 1) {
+    if (/^##\s+/.test(lines[i])) {
+      end = i;
+      break;
+    }
+  }
+  const section = lines.slice(start + 1, end);
+  const genres = [];
+
+  // Markdown table: find the header that contains 题材.
+  let header = null;
+  let genreIndex = -1;
+  for (const line of section) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith('|')) continue;
+    const cells = trimmed.split('|').slice(1, -1).map((cell) => cell.trim());
+    if (!cells.length) continue;
+    const idx = cells.findIndex((cell) => cell.replace(/\*\*/g, '').trim() === '题材');
+    if (idx !== -1) {
+      header = cells;
+      genreIndex = idx;
+      break;
+    }
+  }
+  if (header && genreIndex !== -1) {
+    let inBody = false;
+    for (const line of section) {
+      const trimmed = line.trim();
+      if (!trimmed.startsWith('|')) continue;
+      const cells = trimmed.split('|').slice(1, -1).map((cell) => cell.trim());
+      if (!inBody) {
+        if (cells.every((cell) => /^:?-{2,}:?$/.test(cell.replace(/\s/g, '')))) {
+          inBody = true;
+        }
+        continue;
+      }
+      if (cells.length <= genreIndex) continue;
+      genres.push(...splitGenres(cells[genreIndex]));
+    }
+  }
+
+  // Bullet fallback, including lines like `- **题材**：仙侠`.
+  for (const line of section) {
+    const match = line.match(/^\s*[-*]\s*(?:\*\*)?题材(?:\*\*)?\s*[：:]\s*(.+)$/);
+    if (match) genres.push(...splitGenres(match[1]));
+  }
+
+  return unique(genres);
+}
+
+/**
+ * Read the genre headings from Fanqie scan files.
+ *
+ * @param {string} root workspace directory
+ * @returns {string[]}
+ */
+export function parseFanqieGenres(root) {
+  const dir = workspacePaths(root).scan;
+  let names;
+  try {
+    names = fs.readdirSync(dir);
+  } catch {
+    return [...FALLBACK_GENRES];
+  }
+  const files = names
+    .filter((name) => /^番茄.*\.md$/i.test(name))
+    .sort();
+  const genres = [];
+  for (const name of files) {
+    let text;
+    try {
+      text = fs.readFileSync(path.join(dir, name), 'utf8');
+    } catch {
+      continue;
+    }
+    for (const line of text.split(/\r?\n/)) {
+      const match = line.match(/^##\s+(.+?)\s+—\s+\d+\s+本\s*$/);
+      if (match) genres.push(...splitGenres(match[1]));
+    }
+  }
+  return genres.length ? unique(genres) : [...FALLBACK_GENRES];
+}
+
+/**
+ * Resolve the genres for a generation run.
+ *
+ * @param {string} root workspace directory
+ * @param {{topicFile?: string|null}} [options] explicit report selected by the user
+ * @returns {{mode: 'topic_decision'|'all_genres', genres: string[], topicFile: string|null}}
+ */
+export function resolveMaterialGenres(root, options = {}) {
+  const topicFile = options.topicFile || latestTopicDecision(root);
+  if (topicFile) {
+    try {
+      const genres = parseTopicDecisionGenres(fs.readFileSync(topicFile, 'utf8'));
+      if (genres.length) return { mode: 'topic_decision', genres, topicFile };
+    } catch { /* fall through to all genres */ }
+  }
+  return { mode: 'all_genres', genres: parseFanqieGenres(root), topicFile: null };
+}
+
+/**
+ * All known genres, used by the `prompt` subcommand.
+ *
+ * @param {string|null} root
+ * @returns {string[]}
+ */
+export function allKnownGenres(root) {
+  return root ? parseFanqieGenres(root) : [...FALLBACK_GENRES];
+}