@cloud411716/fancy-webnovel 2.2.0 → 3.0.3

package/lib/topic-fields.js

@@ -0,0 +1,251 @@
+/**
+ * topic-fields.js —— 选题 JSON 的字段清单（**单一事实来源**）
+ *
+ * `_novel_topic_suggestion.json` 和 `_novel_topic.json` 共用这套字段：
+ *
+ *   1. fancy-topic 的探索提示词（字段清单 + JSON 模板）；
+ *   2. fancy-topic setup 的弹框（一个字段一个问题）；
+ *   3. 保存脚本 / 写盘脚本的必填校验；
+ *   4. fancy-story-builder 的任务输入快照与提示词渲染。
+ *
+ * 以前字段清单在提示词、templates.js、topic-schema.js、select-topic.js
+ * 各写一份，改一处就漂一处。现在只在这里定义，其它地方全部派生。
+ *
+ * 2026-10-30 重新设计：
+ *   - 原来的 `core_summary` 与方向设计里的「定位」合并为 `positioning`；
+ *   - 原来的 `direction_design` 大字符串拆成 11 个平级字段；
+ *   - 11 个字段的 id / label 来自 `lib/direction-labels.js`，与扫榜报告
+ *     的 11 项标签一一对应。
+ */
+import { DIRECTION_FIELDS } from '#direction-labels';
+
+/** 题材选项（弹框用；value 只用于旧版映射，DSH 回传 label） */
+export const GENRE_OPTIONS = [
+  { label: '玄幻', value: 'xianxia' },
+  { label: '都市', value: 'urban' },
+  { label: '言情', value: 'romance' },
+  { label: '悬疑', value: 'mystery' },
+  { label: '历史', value: 'history' },
+  { label: '科幻', value: 'scifi' },
+  { label: '仙侠', value: 'xianxia-cultivation' },
+  { label: '其他', value: 'other' },
+];
+
+/**
+ * 基础字段（非方向设计）。
+ *
+ * `prompt` 进探索提示词的字段清单，`sample` 进 JSON 模板；
+ * `placeholder` / `description` 只用于 setup 弹框标题。
+ */
+const BASE_FIELDS = [
+  {
+    id: 'book_name',
+    label: '书名',
+    kind: 'text',
+    required: true,
+    prompt: '根据榜单上同题材书籍的命名方式，给出契合本平台风格的书名',
+    placeholder: '例如：诡秘之主',
+    sample: '诡秘之主',
+  },
+  {
+    id: 'genre',
+    label: '题材',
+    kind: 'select',
+    required: true,
+    prompt: '根据榜单中的热门题材给出建议',
+    options: GENRE_OPTIONS,
+    sample: '玄幻',
+  },
+  {
+    id: 'target_words',
+    label: '目标字数',
+    kind: 'number',
+    required: true,
+    prompt: '正整数，例如 2000000',
+    placeholder: '例如：2000000',
+    sample: 2000000,
+  },
+  {
+    id: 'target_chapters',
+    label: '目标章数',
+    kind: 'number',
+    required: true,
+    prompt: '正整数，例如 600',
+    placeholder: '例如：600',
+    sample: 600,
+  },
+  {
+    id: 'direction_title',
+    label: '选题方向',
+    kind: 'text',
+    required: true,
+    prompt: '从扫榜报告的「六、选题方向建议」里挑一个方向，写方向标题本身，不要带「方向 N：」前缀',
+    placeholder: '例如：都市高武·国术证道',
+    description: '扫榜报告里选定的那个方向标题',
+    sample: '都市高武·国术证道',
+  },
+];
+
+/** 方向设计字段（11 项，顺序与扫榜报告一致） */
+const DESIGN_FIELDS = DIRECTION_FIELDS.map((f) => ({
+  id: f.id,
+  label: f.topicLabel || f.label,
+  kind: 'text',
+  required: true,
+  prompt: f.description,
+  description: f.description,
+  sample: f.sample,
+  minChars: 20,
+  scanLabel: f.label,
+}));
+
+const DESIGN_BY_ID = new Map(DESIGN_FIELDS.map(f => [f.id, f]));
+
+/**
+ * 完整字段顺序。
+ *
+ * 基础信息 → 选题方向 →「定位 / 核心冲突」→ 硬约束 → 其余方向设计。
+ * 顺序同时决定探索提示词的编号、setup 弹框的顺序和写盘参数顺序。
+ */
+export const TOPIC_FIELDS = [
+  ...BASE_FIELDS.slice(0, 4),          // 书名 / 题材 / 目标字数 / 目标章数
+  BASE_FIELDS.find(f => f.id === 'direction_title'),
+  DESIGN_BY_ID.get('positioning'),     // 一句话定位
+  {
+    id: 'core_conflict',
+    label: '核心冲突',
+    kind: 'text',
+    required: true,
+    prompt: '故事的主要矛盾，一句话写清',
+    placeholder: '故事的主要矛盾是什么',
+    sample: '传统武学与现代秩序的冲突',
+  },
+  {
+    id: 'hard_constraints',
+    label: '硬门禁',
+    kind: 'multiselect',
+    required: true,
+    prompt: '绝对不能违反的约束（可多值）',
+    description: '绝对不能违反的约束；可多选；如无约束，输入 "无"',
+    sample: ['不许烂尾'],
+  },
+  {
+    id: 'anti_tropes',
+    label: '反套路',
+    kind: 'multiselect',
+    required: true,
+    prompt: '必须避免的俗套（可多值）',
+    description: '必须避免的俗套；可多选；如无，输入 "无"',
+    sample: ['不许系统流'],
+  },
+  ...DESIGN_FIELDS.filter(f => f.id !== 'positioning'),
+];
+
+/** 必填字段 ID（顺序即写盘参数顺序） */
+export const TOPIC_REQUIRED_FIELDS = TOPIC_FIELDS.map(f => f.id);
+
+/** 方向设计字段 ID（11 项） */
+export const TOPIC_DESIGN_FIELD_IDS = DIRECTION_FIELDS.map(f => f.id);
+
+export const TOPIC_FIELD_BY_ID = new Map(TOPIC_FIELDS.map(f => [f.id, f]));
+
+export const TOPIC_TEXT_FIELDS = TOPIC_FIELDS
+  .filter(f => f.kind === 'text' || f.kind === 'select')
+  .map(f => f.id);
+
+export const TOPIC_ARRAY_FIELDS = TOPIC_FIELDS
+  .filter(f => f.kind === 'multiselect')
+  .map(f => f.id);
+
+export const TOPIC_NUMBER_FIELDS = TOPIC_FIELDS
+  .filter(f => f.kind === 'number')
+  .map(f => f.id);
+
+/** 字段中文名（错误消息 / 弹框 / 快照渲染共用） */
+export const TOPIC_FIELD_CN = Object.fromEntries(
+  TOPIC_FIELDS.map(f => [f.id, f.label])
+);
+
+/** 方向字段中文标签（含扫榜报告里的本名） */
+export const TOPIC_DESIGN_FIELD_CN = Object.fromEntries(
+  DIRECTION_FIELDS.map(f => [f.id, f.topicLabel || f.label])
+);
+
+/**
+ * 生成探索提示词里的字段清单。
+ *
+ * @returns {string}
+ */
+export function topicFieldListBlock() {
+  return TOPIC_FIELDS.map((f, i) => {
+    const tail = f.prompt ? ` — ${f.prompt}` : '';
+    return `${i + 1}. **${f.label}**（${f.id}）${tail}`;
+  }).join('\n');
+}
+
+/** JSON 字符串转义（模板里不能出现未转义的引号/换行） */
+function jsonString(v) {
+  return JSON.stringify(String(v));
+}
+
+/**
+ * 生成探索提示词里的输入 JSON 模板。
+ *
+ * 数值字段写 0，数组字段给一项示例，文本字段给 sample；
+ * 模型只需要把值替换成真实内容。
+ *
+ * @returns {string}
+ */
+export function topicJsonTemplateBlock() {
+  const lines = TOPIC_FIELDS.map((f) => {
+    let value;
+    if (f.kind === 'number') value = '0';
+    else if (f.kind === 'multiselect') value = `[${jsonString((f.sample || ['...'])[0])}]`;
+    else if (typeof f.sample === 'number') value = String(f.sample);
+    else value = jsonString(f.sample || `${f.label}示例`);
+    return `  ${jsonString(f.id)}: ${value}`;
+  });
+  return `{\n${lines.join(',\n')}\n}`;
+}
+
+/**
+ * 把旧版选题数据迁移成新字段。
+ *
+ * 兼容两类旧文件：
+ *   - 旧版 `core_summary` → `positioning`；
+ *   - 旧版 `direction_design`（11 行文本）→ 11 个平级字段。
+ *
+ * 新字段已经存在时以新字段为准，不覆盖。
+ *
+ * @param {object} data
+ * @returns {object}
+ */
+export function normalizeLegacyTopicData(data) {
+  if (!data || typeof data !== 'object' || Array.isArray(data)) return data;
+  const out = { ...data };
+
+  if (typeof out.direction_design === 'string' && out.direction_design.trim()) {
+    for (const field of DIRECTION_FIELDS) {
+      if (typeof out[field.id] === 'string' && out[field.id].trim()) continue;
+      const re = new RegExp(
+        '^\\s*(?:[-*+]\\s+)?\\*{0,2}'
+        + String(field.label).replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+        + '\\*{0,2}\\s*[:：]\\s*(.*)$',
+        'm'
+      );
+      const hit = re.exec(out.direction_design);
+      if (hit && hit[1].trim()) out[field.id] = hit[1].trim();
+    }
+  }
+
+  // 旧文件里 direction_design 的「定位」信息更完整，优先保留；
+  // 没有「定位」时才退回旧版 core_summary（一句话故事）。
+  if ((!out.positioning || !String(out.positioning).trim())
+    && typeof out.core_summary === 'string' && out.core_summary.trim()) {
+    out.positioning = out.core_summary;
+  }
+
+  delete out.direction_design;
+  delete out.core_summary;
+  return out;
+}

package/lib/topic-schema.js

@@ -0,0 +1,225 @@
+/**
+ * topic-schema.js —— `_novel_topic` / `_novel_topic_suggestion` 的字段契约
+ *
+ * 扫榜建议（`_novel_topic_suggestion.json`）和最终敲定（`_novel_topic.json`）
+ * 都必须过同一套校验：字段齐全、类型正确、目标字数/章数是正整数、
+ * 硬门禁/反套路是字符串数组、11 项方向设计齐全且每项有实质内容。
+ *
+ * 2026-10-30 起，原来的 `direction_design` 大字符串拆成 11 个平级字段；
+ * `core_summary` 与「定位」合并为 `positioning`。字段清单只在
+ * `lib/topic-fields.js` 定义一次，提示词、弹框、写盘脚本、story-builder
+ * 全部从那里派生。
+ */
+import { existsSync, statSync } from 'fs';
+import { isAbsolute, resolve } from 'path';
+import {
+  DIRECTION_FIELDS,
+} from '#direction-labels';
+import {
+  TOPIC_REQUIRED_FIELDS,
+  TOPIC_TEXT_FIELDS,
+  TOPIC_ARRAY_FIELDS,
+  TOPIC_NUMBER_FIELDS,
+  TOPIC_FIELD_BY_ID,
+  normalizeLegacyTopicData,
+} from '#topic-fields';
+
+/** 项目允许的平台（中文名；与 fancy-topic 的 PLATFORM_OPTIONS 一致） */
+export const TOPIC_PLATFORMS = ['番茄', '起点', '晋江', '七猫'];
+
+/** 目标章数上限（与 select-topic.js 的历史上限一致） */
+export const MAX_TARGET_CHAPTERS = 5000;
+
+/** 目标字数上限：避免把“亿”当成字数写进下游公式 */
+export const MAX_TARGET_WORDS = 100_000_000;
+
+/** 方向设计字段 ID（11 项） */
+export const DESIGN_FIELD_IDS = DIRECTION_FIELDS.map(f => f.id);
+
+const DESIGN_FIELD_ID_SET = new Set(DESIGN_FIELD_IDS);
+
+/** 常见占位值 —— 模型原样抄模板时必须被抓出来 */
+const PLACEHOLDER_VALUES = new Set([
+  '书名', '题材', '一句话故事', '核心冲突', '一句话定位',
+  '约束', '反套路', '方向名', '定位：…', '定位：...',
+  '…', '...',
+]);
+
+function isPlainObject(v) {
+  return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+
+function hasControlChars(s, allowNewline = false) {
+  const re = allowNewline ? /[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/ : /[\x00-\x1f\x7f]/;
+  return re.test(s);
+}
+
+function nonEmptyString(v) {
+  return typeof v === 'string' && v.trim().length > 0;
+}
+
+/**
+ * 把旧版选题数据迁移成新字段（供 fancy-topic / story-builder 读取旧文件）。
+ *
+ * @param {object} data
+ * @returns {object}
+ */
+export function normalizeTopicData(data) {
+  return normalizeLegacyTopicData(data);
+}
+
+/**
+ * 校验一份选题数据。
+ *
+ * 旧版 `_novel_topic.json`（含 `direction_design` / `core_summary`）会先
+ * 迁移成新字段再校验；写盘输出始终是新结构。
+ *
+ * @param {object} data
+ * @param {object} [opts]
+ * @param {string} [opts.expectedPlatform] 期望的平台中文名
+ * @param {string} [opts.projectRoot] 项目根（用于校验 source_decision_file 不越界）
+ * @param {boolean} [opts.requireSource] 是否要求 source_decision_file
+ * @param {number} [opts.minDesignChars] 方向设计每项最少汉字数（默认 20）
+ * @returns {{ok: boolean, errors: string[], warnings: string[], normalized: object|null}}
+ */
+export function validateTopicData(data, opts = {}) {
+  const errors = [];
+  const warnings = [];
+
+  if (!isPlainObject(data)) {
+    return { ok: false, errors: ['顶层必须是 JSON 对象'], warnings, normalized: null };
+  }
+
+  const d = normalizeLegacyTopicData(data);
+  const expectedPlatform = opts.expectedPlatform ? String(opts.expectedPlatform) : '';
+  const minDesignChars = Number.isInteger(opts.minDesignChars) ? opts.minDesignChars : 20;
+
+  // ── 必填 / 类型 ────────────────────────────────────────────────
+  for (const f of TOPIC_REQUIRED_FIELDS) {
+    if (!(f in d)) {
+      errors.push(`缺字段: ${f}`);
+      continue;
+    }
+    const v = d[f];
+    if (v === undefined || v === null || v === '') {
+      errors.push(`${f} 不能为空`);
+      continue;
+    }
+
+    if (TOPIC_NUMBER_FIELDS.includes(f)) {
+      if (!Number.isInteger(v) || v <= 0) {
+        errors.push(`${f} 必须是正整数（当前 ${JSON.stringify(v)}）`);
+      } else if (f === 'target_chapters' && v > MAX_TARGET_CHAPTERS) {
+        errors.push(`${f} 超过上限 ${MAX_TARGET_CHAPTERS}（当前 ${v}），请拆成多部书`);
+      } else if (f === 'target_words' && v > MAX_TARGET_WORDS) {
+        errors.push(`${f} 超过上限 ${MAX_TARGET_WORDS}（当前 ${v}）`);
+      }
+      continue;
+    }
+
+    if (TOPIC_ARRAY_FIELDS.includes(f)) {
+      if (!Array.isArray(v)) {
+        errors.push(`${f} 必须是字符串数组`);
+      } else if (v.length === 0) {
+        errors.push(`${f} 不能是空数组（没有就写 ["无"]）`);
+      } else {
+        v.forEach((item, i) => {
+          if (!nonEmptyString(item)) errors.push(`${f}[${i}] 必须是非空字符串`);
+          else if (hasControlChars(item)) errors.push(`${f}[${i}] 不能含换行/控制字符`);
+          else if (PLACEHOLDER_VALUES.has(item.trim())) {
+            errors.push(`${f}[${i}] 还是占位值「${item.trim()}」，必须替换成真实内容`);
+          }
+        });
+      }
+      continue;
+    }
+
+    if (TOPIC_TEXT_FIELDS.includes(f)) {
+      const field = TOPIC_FIELD_BY_ID.get(f);
+      const label = field ? field.label : f;
+      if (typeof v !== 'string') {
+        errors.push(`${f} 必须是字符串`);
+      } else if (!v.trim()) {
+        errors.push(`${f} 不能为空`);
+      } else if (hasControlChars(v, DESIGN_FIELD_ID_SET.has(f))) {
+        errors.push(`${f} 不能含换行/控制字符`);
+      } else if (PLACEHOLDER_VALUES.has(v.trim())) {
+        errors.push(`${f} 还是占位值「${v.trim()}」，必须替换成真实内容`);
+      } else if (f === 'direction_title' && /^方向\s*\d+\s*[:：]/.test(v.trim())) {
+        errors.push('direction_title 不要带「方向 N：」前缀，只写方向标题本身');
+      } else if (DESIGN_FIELD_ID_SET.has(f) && cjkCount(v) < minDesignChars) {
+        errors.push(`${label}（${f}）内容太短：当前 ${cjkCount(v)} 个汉字，要求 ≥ ${minDesignChars}`);
+      }
+    }
+  }
+
+  // ── 平台 ──────────────────────────────────────────────────────
+  const platform = d.platform;
+  if (platform === undefined || platform === null || platform === '') {
+    errors.push('缺字段: platform');
+  } else if (typeof platform !== 'string' || !TOPIC_PLATFORMS.includes(platform)) {
+    errors.push(`platform 必须是 ${TOPIC_PLATFORMS.join(' / ')} 之一（当前 ${JSON.stringify(platform)}）`);
+  } else if (expectedPlatform && platform !== expectedPlatform) {
+    errors.push(`platform 应为 ${expectedPlatform}，实际 ${platform}`);
+  }
+
+  // ── 方向设计 11 项：每项太短已在上面逐条点名 ────────────────────
+  for (const field of DIRECTION_FIELDS) {
+    if (typeof d[field.id] === 'string' && /…|\.\.\./.test(d[field.id])) {
+      warnings.push(`${field.topicLabel || field.label}里还出现省略号，确认不是模板占位符`);
+    }
+  }
+
+  // ── source_decision_file（可选，但给了就必须是真的文件） ────────
+  const source = d.source_decision_file;
+  if (source !== undefined && source !== null && source !== '') {
+    if (typeof source !== 'string' || !source.trim()) {
+      errors.push('source_decision_file 必须是非空字符串');
+    } else if (!isAbsolute(source)) {
+      errors.push('source_decision_file 必须是绝对路径');
+    } else {
+      let sourceOk = false;
+      try { sourceOk = existsSync(source) && statSync(source).isFile(); } catch { sourceOk = false; }
+      if (!sourceOk) {
+        errors.push(`source_decision_file 不存在或不是文件: ${source}`);
+      } else if (opts.projectRoot) {
+        const root = resolve(opts.projectRoot);
+        const target = resolve(source);
+        const rel = target.startsWith(root + '/') ? target.slice(root.length + 1) : '';
+        if (!rel || rel.startsWith('..')) {
+          errors.push('source_decision_file 必须位于项目根内');
+        }
+      }
+    }
+  } else if (opts.requireSource) {
+    errors.push('缺字段: source_decision_file');
+  }
+
+  // ── 归一化（只在通过时返回） ──────────────────────────────────
+  let normalized = null;
+  if (!errors.length) {
+    normalized = {};
+    for (const f of TOPIC_REQUIRED_FIELDS) {
+      const v = d[f];
+      normalized[f] = TOPIC_ARRAY_FIELDS.includes(f)
+        ? v.map(x => x.trim())
+        : (typeof v === 'string' ? v.trim() : v);
+    }
+    normalized.platform = platform;
+    if (source) normalized.source_decision_file = source;
+  }
+
+  return { ok: errors.length === 0, errors, warnings, normalized };
+}
+
+/** 数汉字（与 direction-labels 的口径一致） */
+function cjkCount(text) {
+  let n = 0;
+  for (const ch of String(text || '')) {
+    const c = ch.codePointAt(0);
+    if ((c >= 0x4e00 && c <= 0x9fff) || (c >= 0x3400 && c <= 0x4dbf)) n++;
+  }
+  return n;
+}
+
+export { TOPIC_REQUIRED_FIELDS };