@cloud411716/fancy-webnovel 1.0.46 → 3.0.0

package/plugins/fancy-story-builder/scripts/upstream-query.js

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+/**
+ * upstream-query.js —— 上游数据按需查询（只读）
+ *
+ * 用途：摘要（summarizeStage）给出的是"全量 id + 名称"总览，
+ *       但逐章细纲、单个角色档案这类明细体量大，无法塞进 prompt。
+ *       本脚本让 Agent 按需精确取出单条/单章，避免"为了看一条而读整个文件"。
+ *
+ * 用法（在项目根目录下执行）：
+ *   node references/upstream-query.js --stage=节奏 --file=章节细纲 --ch=12
+ *   node references/upstream-query.js --stage=节奏 --file=章节规划 --ch=12
+ *   node references/upstream-query.js --stage=血肉 --file=角色 --id=C001
+ *   node references/upstream-query.js --stage=骨架 --file=实体 --id=FS042
+ *   node references/upstream-query.js --stage=骨架 --file=实体 --ids=FS042,FS043
+ *   node references/upstream-query.js --stage=节奏 --file=章节细纲 --list
+ *
+ * 输出：stdout 为 JSON
+ *   { "status": 0, "stage": "节奏", "file": "章节细纲", "matched": 1, "items": [ ... ] }
+ *   status: 0=命中 1=未命中 2=参数/读取错误
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// 各阶段的文件名白名单（防止路径穿越）
+const STAGE_FILES = {
+  骨架: ['框架', '实体', '关系', '层级'],
+  血肉: ['角色', '其他实体', '冲突', '势力', '剧情', '地点', '结局', '世界观规则', '关键道具'],
+  节奏: ['章节规划', '时序映射', '节奏参数', '章节细纲'],
+};
+
+function emit(status, payload) {
+  process.stdout.write(JSON.stringify(payload, null, 2) + '\n');
+  process.exitCode = status;
+}
+
+function parseArgs(argv) {
+  const args = {};
+  for (const a of argv.slice(2)) {
+    const m = a.match(/^--([\w-]+)(?:=(.*))?$/);
+    if (m) args[m[1]] = m[2] === undefined ? true : m[2];
+  }
+  return args;
+}
+
+/**
+ * 找项目根：向上找带 `.fancy-deployed` 标记的目录。
+ *
+ * 旧实现是 `path.join(__dirname, '..', ...)` —— 部署后 __dirname 是
+ * `<项目根>/references`，`..` 正好是项目根；但从插件目录直接跑
+ * （开发/测试/模型手动 node plugins/.../upstream-query.js）时，
+ * `..` 是**插件根**，会指向 plugins/fancy-story-builder/设定/...，
+ * 报"文件不存在"。
+ *
+ * @returns {string|null} 项目根；找不到返回 null
+ */
+function findProjectRoot(startDir) {
+  let dir = startDir;
+  for (let i = 0; i < 8; i++) {
+    try {
+      if (fs.existsSync(path.join(dir, '.fancy-deployed'))) return dir;
+    } catch {
+      // 读不到就继续往上
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+
+/** 阶段目录：<项目根>/设定/raw/sources/<阶段> */
+function stageDirOf(stage, projectRoot) {
+  // 显式指定的项目根优先；否则向上找 .fancy-deployed；都没有就退回旧行为
+  const root = projectRoot || findProjectRoot(__dirname) || path.join(__dirname, '..');
+  return path.join(root, '设定', 'raw', 'sources', stage);
+}
+
+function readJson(p) {
+  try {
+    return { data: JSON.parse(fs.readFileSync(p, 'utf-8')) };
+  } catch (e) {
+    return { error: e.message };
+  }
+}
+
+/** 在 JSON 里找出所有"数组型字段"，并把每个元素当作一条记录 */
+function collectRecords(data) {
+  const records = [];
+  if (!data || typeof data !== 'object' || Array.isArray(data)) return records;
+  for (const [key, val] of Object.entries(data)) {
+    if (!Array.isArray(val)) continue;
+    for (const it of val) {
+      if (it && typeof it === 'object') records.push({ group: key, item: it });
+    }
+  }
+  return records;
+}
+
+/** 记录的身份：id 或 ch（与摘要规则一致） */
+function recordId(item) {
+  if (item.id !== undefined && item.id !== null && item.id !== '') return String(item.id);
+  if (item.ch !== undefined && item.ch !== null) return String(item.ch);
+  return '';
+}
+
+function main() {
+  const args = parseArgs(process.argv);
+
+  const stage = args.stage;
+  const file = args.file;
+  // --project-root 显式指定项目根（没指定就向上找 .fancy-deployed）
+  const projectRoot = typeof args['project-root'] === 'string' ? args['project-root'] : null;
+
+  if (!stage || !STAGE_FILES[stage]) {
+    emit(2, {
+      status: 2,
+      error: `--stage 必须是 ${Object.keys(STAGE_FILES).join(' / ')} 之一`,
+      available_stages: Object.keys(STAGE_FILES),
+    });
+    return;
+  }
+  if (!file || !STAGE_FILES[stage].includes(file)) {
+    emit(2, {
+      status: 2,
+      error: `--file 必须是 ${stage} 阶段的 ${STAGE_FILES[stage].join(' / ')} 之一`,
+      available_files: STAGE_FILES[stage],
+    });
+    return;
+  }
+
+  const filePath = path.join(stageDirOf(stage, projectRoot), file + '.json');
+  if (!fs.existsSync(filePath)) {
+    emit(2, { status: 2, error: `文件不存在: ${filePath}`, hint: '请先完成该阶段' });
+    return;
+  }
+  const r = readJson(filePath);
+  if (r.error) {
+    emit(2, { status: 2, error: 'JSON 解析失败: ' + r.error, path: filePath });
+    return;
+  }
+
+  const records = collectRecords(r.data);
+
+  // --list：列出该文件里所有记录的分组与身份
+  if (args.list) {
+    const groups = {};
+    for (const rec of records) {
+      if (!groups[rec.group]) groups[rec.group] = [];
+      groups[rec.group].push(recordId(rec.item));
+    }
+    emit(0, { status: 0, stage, file, path: filePath, groups });
+    return;
+  }
+
+  const want = [];
+  if (args.ch !== undefined) want.push(String(args.ch));
+  if (args.id !== undefined) want.push(String(args.id));
+  if (args.ids !== undefined) {
+    for (const s of String(args.ids).split(',')) if (s.trim()) want.push(s.trim());
+  }
+
+  if (want.length === 0) {
+    emit(2, {
+      status: 2,
+      error: '需要 --ch / --id / --ids 之一，或用 --list 查看可用记录',
+      hint: '例如: --ch=12 或 --id=C001 或 --ids=FS042,FS043',
+    });
+    return;
+  }
+
+  const wantSet = new Set(want);
+  const matched = records.filter(rec => wantSet.has(recordId(rec.item)));
+
+  if (matched.length === 0) {
+    emit(1, {
+      status: 1,
+      stage, file, path: filePath,
+      matched: 0,
+      wanted: want,
+      items: [],
+      hint: '未找到匹配的记录。可用 --list 查看该文件的全部记录分组',
+    });
+    return;
+  }
+
+  emit(0, {
+    status: 0,
+    stage, file, path: filePath,
+    matched: matched.length,
+    items: matched.map(rec => rec.item),
+    groups: matched.map(rec => rec.group),
+  });
+}
+
+main();

package/plugins/fancy-story-builder/scripts/v2/baseline.js

@@ -0,0 +1,112 @@
+/**
+ * v2/baseline.js —— 00-baseline：固化选题、参考与公式版本。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import {
+  SCHEMA_VERSION,
+  ensureDir,
+  fileExists,
+  nowIso,
+  readJson,
+  stageDir,
+  writeJsonAtomic,
+} from './core.js';
+
+const INPUT_FIELDS = [
+  'book_name', 'genre', 'platform', 'positioning', 'one_line_pitch', 'target_chapters', 'target_words',
+  'core_conflict', 'reader_value', 'golden_finger', 'core_setting', 'selling_points',
+  'hard_constraints', 'anti_tropes', 'protagonist', 'world_setting',
+];
+
+export function buildBaselinePayload(topicData, formulasDoc, genreProfilesDoc) {
+  const topic = topicData || {};
+  const input = {
+    schema_version: SCHEMA_VERSION,
+    book_name: topic.book_name || topic.title || '未命名',
+    genre: topic.genre || '',
+    positioning: topic.positioning || '',
+    one_line_pitch: topic.one_line_pitch || '',
+    target_chapters: Number(topic.target_chapters) || 0,
+    target_words: Number(topic.target_words) || 0,
+    core_conflict: topic.core_conflict || '',
+    reader_value: topic.reader_value || '',
+    golden_finger: topic.golden_finger || '',
+    core_setting: topic.core_setting || '',
+    selling_points: Array.isArray(topic.selling_points) ? topic.selling_points : [],
+    hard_constraints: Array.isArray(topic.hard_constraints) ? topic.hard_constraints : [],
+    anti_tropes: Array.isArray(topic.anti_tropes) ? topic.anti_tropes : [],
+    protagonist: topic.protagonist || '',
+    world_setting: topic.world_setting || '',
+    created_at: nowIso(),
+  };
+  // 只保留已定义字段，避免把 undefined 写进 JSON
+  for (const key of Object.keys(input)) {
+    if (input[key] === undefined) delete input[key];
+  }
+  return {
+    input,
+    references: {
+      schema_version: SCHEMA_VERSION,
+      references: Array.isArray(topic.references) ? topic.references : [],
+      benchmark: topic.benchmark || null,
+      note: '对标与参考决策。没有时保持空数组。',
+    },
+    formulas: {
+      _meta: {
+        schema_version: SCHEMA_VERSION,
+        source: 'quantity-formulas',
+        version: '2026-11-06',
+        read_only: true,
+      },
+      ...formulasDoc,
+    },
+    genreProfiles: genreProfilesDoc || null,
+  };
+}
+
+/**
+ * 确保 00-baseline 存在。已存在时不覆盖，除非 opts.force=true。
+ */
+export function ensureBaseline(projectRoot, topicData, formulasDoc, opts = {}) {
+  const dir = stageDir(projectRoot, '00-baseline');
+  ensureDir(dir);
+  const payload = buildBaselinePayload(topicData, formulasDoc, opts.genreProfilesDoc);
+  const files = ['input.json', 'references.json', 'formulas.json'];
+  if (payload.genreProfiles) files.push('genre-profiles.json');
+  const forceFiles = new Set(opts.forceFiles || []);
+  const written = [];
+  const pairs = {
+    'input.json': payload.input,
+    'references.json': payload.references,
+    'formulas.json': payload.formulas,
+    'genre-profiles.json': payload.genreProfiles,
+  };
+  for (const file of files) {
+    const target = path.join(dir, file);
+    if (!opts.force && !forceFiles.has(file) && fileExists(target)) continue;
+    writeJsonAtomic(target, pairs[file]);
+    written.push(file);
+  }
+  return { ok: true, dir, written };
+}
+
+export function loadBaseline(projectRoot) {
+  const dir = stageDir(projectRoot, '00-baseline');
+  return {
+    input: readJson(path.join(dir, 'input.json'), null),
+    references: readJson(path.join(dir, 'references.json'), null),
+    formulas: readJson(path.join(dir, 'formulas.json'), null),
+  };
+}
+
+export function loadFormulasDoc(projectRoot, fallbackPath) {
+  // references/ 是插件每次阶段启动时刷新的副本；优先它，避免旧项目一直用
+  // 00-baseline 里冻结的老公式。
+  const deployed = readJson(path.join(projectRoot, 'references', 'formulas-skeleton.json'), null);
+  if (deployed && deployed.formulas) return deployed;
+  const local = loadBaseline(projectRoot).formulas;
+  if (local && local.formulas) return local;
+  if (fallbackPath && fs.existsSync(fallbackPath)) return readJson(fallbackPath, null);
+  return null;
+}