@cloud411716/fancy-webnovel 2.2.0 → 3.0.0

package/plugins/fancy-story-builder/storydb/definitions.js

@@ -0,0 +1,699 @@
+/**
+ * storydb schema definitions — the single source of truth.
+ *
+ * From this file the compiler generates:
+ *   - SurrealDB DDL
+ *   - tool JSON schemas / schema cards
+ *   - requirement rules
+ *   - export mappings
+ *
+ * Field types:
+ *   string | text | int | float | bool | datetime
+ *   array  | object | record | enum
+ */
+
+const S = (extra = {}) => ({ type: 'string', ...extra });
+const T = (extra = {}) => ({ type: 'text', ...extra });
+const I = (extra = {}) => ({ type: 'int', ...extra });
+const F = (extra = {}) => ({ type: 'float', ...extra });
+const B = (extra = {}) => ({ type: 'bool', ...extra });
+const D = (extra = {}) => ({ type: 'datetime', ...extra });
+const A = (extra = {}) => ({ type: 'array', ...extra });
+const O = (extra = {}) => ({ type: 'object', ...extra });
+const R = (table, extra = {}) => ({ type: 'record', table, ...extra });
+const E = (values, extra = {}) => ({ type: 'enum', values, ...extra });
+
+export const STATUS = ['seed', 'draft', 'complete', 'locked', 'archived'];
+
+export const ENTITIES = {
+  story: {
+    table: 'story',
+    id: 'main',
+    label: '故事',
+    fields: {
+      title: S({ required: true }),
+      genre: S(),
+      platform: S(),
+      target_chapters: I({ required: true }),
+      target_words: I({ required: true }),
+      avg_words_per_chapter: I(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  scale: {
+    table: 'scale',
+    label: '规模',
+    fields: {
+      capacity: O(),
+      structure: O(),
+      quotas: O(),
+      rhythm_budget: O(),
+      distribution: O(),
+      constraints: O(),
+      formulas: O(),
+      derivations: O(),
+      genre_profile: S(),
+      formula_version: S(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  volume: {
+    table: 'volume',
+    label: '卷',
+    fields: {
+      volume_id: S({ required: true }),
+      title: S(),
+      chapter_start: I({ required: true }),
+      chapter_end: I({ required: true }),
+      goal: T(),
+      core_conflict: T(),
+      emotional_arc: T(),
+      ending_hook: T(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  act: {
+    table: 'act',
+    label: '幕',
+    fields: {
+      act_id: S({ required: true }),
+      volume_id: S({ required: true }),
+      act_index: I({ required: true }),
+      chapter_start: I({ required: true }),
+      chapter_end: I({ required: true }),
+      goal: T(),
+      climax: T(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  world_doc: {
+    table: 'world_doc',
+    label: '世界观',
+    fields: {
+      premise: T(),
+      theme: A(),
+      tone: S(),
+      world_rules: A(),
+      power_system: T(),
+      social_order: T(),
+      taboos: A(),
+      core_imagery: A(),
+      reader_promise: T(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  story_doc: {
+    table: 'story_doc',
+    label: '故事',
+    fields: {
+      core_question: T(),
+      core_conflict: T(),
+      structure: O(),
+      anti_tropes: A(),
+      promise: T(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  line: {
+    table: 'line',
+    label: '线索',
+    fields: {
+      line_id: S({ required: true }),
+      kind: E(['main', 'branch'], { default: 'main' }),
+      name: S({ required: true }),
+      goal: T(),
+      start: S(),
+      turning: S(),
+      resolution: S(),
+      interweaves: A(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  line_node: {
+    table: 'line_node',
+    label: '线索节点',
+    fields: {
+      node_id: S({ required: true }),
+      line_id: S({ required: true }),
+      volume: S(),
+      act: S(),
+      goal: T(),
+      turn: T(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  ending: {
+    table: 'ending',
+    label: '结局',
+    fields: {
+      ending_id: S({ required: true }),
+      level: S(),
+      type: S(),
+      direction: T(),
+      required_foreshadow_recovery: A(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  role_slot: {
+    table: 'role_slot',
+    label: '角色功能位',
+    fields: {
+      role_id: S({ required: true }),
+      name: S({ required: true }),
+      slot_function: T(),
+      quota_key: S(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  emotion_doc: {
+    table: 'emotion_doc',
+    label: '情绪曲线',
+    fields: {
+      volumes: A(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  character: {
+    table: 'character',
+    label: '人物',
+    fields: {
+      role_slot: S(),
+      name: S({ required: true }),
+      type: E([
+        '主角', '核心配角', '贯穿级核心配角', '卷级配角', '卷级重要配角',
+        '核心反派', '贯穿级核心反派', '卷级反派',
+      ]),
+      faction: S(),
+      description: T(),
+      goal: O(),
+      flaw: T(),
+      golden_finger: T(),
+      information_state: O(),
+      arc: O(),
+      voice: O(),
+      traits: A(),
+      exit: O(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [
+      { kind: 'character_arc', hard: false, label: '角色弧光' },
+      { kind: 'character_voice', hard: false, label: '说话风格' },
+    ],
+  },
+
+  faction: {
+    table: 'faction',
+    label: '势力',
+    fields: {
+      name: S({ required: true }),
+      type: S(),
+      description: T(),
+      goal: T(),
+      resources: A(),
+      territory: A(),
+      internal_conflict: T(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  location: {
+    table: 'location',
+    label: '地点',
+    fields: {
+      name: S({ required: true }),
+      type: S(),
+      description: T(),
+      narrative_function: T(),
+      rules: A(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  item: {
+    table: 'item',
+    label: '道具',
+    fields: {
+      name: S({ required: true }),
+      category: E(['core', 'branch', 'symbolic', '核心', '支线', '象征']),
+      description: T(),
+      item_function: T(),
+      owner: S(),
+      limit: T(),
+      related_characters: A(),
+      related_conflicts: A(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  conflict: {
+    table: 'conflict',
+    label: '冲突',
+    fields: {
+      name: S({ required: true }),
+      type: E(['core', 'phase', 'branch', '核心', '阶段', '交织']),
+      description: T(),
+      core_goal: T(),
+      stakes: T(),
+      escalation_path: A(),
+      resolution_plan: O(),
+      participants: A(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  foreshadow: {
+    table: 'foreshadow',
+    label: '伏笔',
+    fields: {
+      name: S({ required: true }),
+      type: E(['small', 'medium', 'large', '小', '中', '大']),
+      setup: T(),
+      clues: A(),
+      payoff_target: S(),
+      recovery_requirement: T(),
+      red_herrings: A(),
+      scope: E(['book', 'volume', 'arc', 'chapter']),
+      initial_knowledge: A(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [
+      { kind: 'foreshadow_plant', hard: true, label: '埋设', due: 'chapter' },
+      { kind: 'foreshadow_progress', hard: false, label: '推进', due: 'chapter' },
+      { kind: 'foreshadow_reveal', hard: true, label: '回收/揭示', due: 'chapter' },
+    ],
+  },
+
+  payoff: {
+    table: 'payoff',
+    label: '爽点',
+    fields: {
+      name: S({ required: true }),
+      type: S(),
+      scale: E(['small', 'medium', 'large', '小', '中', '大']),
+      setup: T(),
+      payoff: T(),
+      emotional_effect: T(),
+      required_setup: A(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [
+      { kind: 'payoff_setup', hard: true, label: '铺垫' },
+      { kind: 'payoff_payoff', hard: true, label: '兑现' },
+    ],
+  },
+
+  climax: {
+    table: 'climax',
+    label: '高潮',
+    fields: {
+      name: S({ required: true }),
+      type: E(['small', 'medium', 'large', '小', '中', '大']),
+      description: T(),
+      payoff: S(),
+      participants: A(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  information: {
+    table: 'information',
+    label: '信息差',
+    fields: {
+      conflict: S(),
+      info_name: S({ required: true }),
+      who_knows: A(),
+      who_does_not_know: A(),
+      resolution_method: T(),
+      writing_ban: T(),
+      initial_knowledge: A(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  chapter: {
+    table: 'chapter',
+    label: '章节',
+    fields: {
+      chapter_id: S({ required: true }),
+      display_no: I({ required: true }),
+      title: S({ required: true }),
+      volume: S({ required: true }),
+      act: S({ required: true }),
+      pov: S(),
+      time: O(),
+      why: O(),
+      how: O(),
+      emotion: O(),
+      hook: O(),
+      word_target: I({ required: true }),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [
+      { kind: 'chapter_outline', hard: true, label: '细纲' },
+      { kind: 'chapter_draft', hard: true, label: '正文' },
+    ],
+  },
+
+  outline: {
+    table: 'outline',
+    label: '细纲',
+    fields: {
+      chapter_id: S({ required: true }),
+      number: I(),
+      title: S(),
+      volume: S(),
+      act: S(),
+      word_target: I(),
+      pov: O(),
+      time: O(),
+      why: O(),
+      continuity: O(),
+      coverage: O(),
+      must_write: A({ required: true, nonEmpty: true }),
+      must_not_write: A({ required: true, nonEmpty: true }),
+      ending: O(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [
+      { kind: 'outline_scenes', hard: true, label: '场景' },
+      { kind: 'outline_cast', hard: false, label: '出场人物' },
+    ],
+  },
+
+  scene: {
+    table: 'scene',
+    label: '场景',
+    fields: {
+      outline_id: S({ required: true }),
+      scene_order: I({ required: true }),
+      goal: T(),
+      obstacle: T(),
+      turn: T(),
+      outcome: T(),
+      location: S(),
+      cast: A(),
+      status: E(STATUS, { default: 'seed' }),
+    },
+    requirements: [],
+  },
+
+  chapter_text: {
+    table: 'chapter_text',
+    label: '正文',
+    fields: {
+      chapter_id: S({ required: true }),
+      display_no: I({ required: true }),
+      content: T({ required: true }),
+      word_count: I(),
+      status: E(['draft', 'final'], { default: 'draft' }),
+    },
+    requirements: [],
+  },
+
+  handoff: {
+    table: 'handoff',
+    label: '章末交接',
+    fields: {
+      chapter_id: S({ required: true }),
+      end_location: S(),
+      end_time: O(),
+      end_characters: A(),
+      open_threads: A(),
+      next_scene_hint: T(),
+      continuity_notes: T(),
+      status: E(['draft', 'final'], { default: 'draft' }),
+    },
+    requirements: [],
+  },
+
+  requirement: {
+    table: 'requirement',
+    label: '待办',
+    internal: true,
+    fields: {
+      kind: S({ required: true }),
+      subject: S({ required: true }),
+      status: E(['pending', 'filled', 'waived'], { default: 'pending' }),
+      hard: B({ default: true }),
+      due_chapter: I(),
+      filled_by: S(),
+      label: S(),
+    },
+    requirements: [],
+  },
+
+  change_set: {
+    table: 'change_set',
+    label: '写入事务',
+    internal: true,
+    fields: {
+      workflow: S(),
+      summary: T(),
+      status: E(['committed', 'rolled_back', 'superseded'], { default: 'committed' }),
+      parent: S(),
+    },
+    requirements: [],
+  },
+
+  decision: {
+    table: 'decision',
+    label: '设计决策',
+    internal: true,
+    fields: {
+      change_set: S({ required: true }),
+      scope: S(),
+      subject: S(),
+      text: T({ required: true }),
+      source: S(),
+      reference: S(),
+      reason: T(),
+      status: E(['active', 'superseded', 'rolled_back'], { default: 'active' }),
+      supersedes: S(),
+    },
+    requirements: [],
+  },
+
+  validation_issue: {
+    table: 'validation_issue',
+    label: '校验问题',
+    internal: true,
+    fields: {
+      change_set: S(),
+      scope: S(),
+      code: S({ required: true }),
+      severity: E(['error', 'warning', 'pending'], { default: 'warning' }),
+      message: T({ required: true }),
+      hint: T(),
+      status: E(['open', 'resolved', 'ignored'], { default: 'open' }),
+    },
+    requirements: [],
+  },
+};
+
+/**
+ * Graph edges. `fills` maps an edge action to a requirement kind:
+ *   fills: { actionValue: 'requirement_kind' }
+ */
+export const EDGES = {
+  has_volume: {
+    table: 'has_volume', in: 'story', out: 'volume', label: '故事→卷',
+    fields: {},
+  },
+  has_act: {
+    table: 'has_act', in: 'volume', out: 'act', label: '卷→幕',
+    fields: {},
+  },
+  has_chapter: {
+    table: 'has_chapter', in: 'act', out: 'chapter', label: '幕→章',
+    fields: {},
+  },
+  chapter_cast: {
+    table: 'chapter_cast', in: 'chapter', out: 'character', label: '章节出场',
+    fields: {
+      role: E(['pov', 'cast', 'mentioned'], { required: true }),
+    },
+  },
+  chapter_location: {
+    table: 'chapter_location', in: 'chapter', out: 'location', label: '章节地点',
+    fields: {},
+  },
+  chapter_line_node: {
+    table: 'chapter_line_node', in: 'chapter', out: 'line_node', label: '章节主线节点',
+    fields: {},
+  },
+  chapter_branch: {
+    table: 'chapter_branch', in: 'chapter', out: 'line', label: '章节支线',
+    fields: {},
+  },
+  chapter_conflict: {
+    table: 'chapter_conflict', in: 'chapter', out: 'conflict', label: '章节冲突',
+    fields: {},
+  },
+  chapter_climax: {
+    table: 'chapter_climax', in: 'chapter', out: 'climax', label: '章节高潮',
+    fields: {},
+  },
+  chapter_item: {
+    table: 'chapter_item', in: 'chapter', out: 'item', label: '章节道具',
+    fields: { role: S() },
+  },
+  relation: {
+    table: 'relation', in: 'character', out: 'character', label: '人物关系',
+    fields: {
+      kind: S({ required: true }),
+      initial_state: T(),
+      changes: A(),
+    },
+  },
+  faction_relation: {
+    table: 'faction_relation', in: 'faction', out: 'faction', label: '势力关系',
+    fields: {
+      kind: S({ required: true }),
+      initial_state: T(),
+      changes: A(),
+    },
+  },
+  membership: {
+    table: 'membership', in: 'character', out: 'faction', label: '成员关系',
+    fields: { role: S() },
+  },
+  conflict_participant: {
+    table: 'conflict_participant', in: 'conflict', out: 'character', label: '冲突参与者',
+    fields: {},
+  },
+  climax_participant: {
+    table: 'climax_participant', in: 'climax', out: 'character', label: '高潮参与者',
+    fields: {},
+  },
+  foreshadow_payoff: {
+    table: 'foreshadow_payoff', in: 'foreshadow', out: 'payoff', label: '伏笔→爽点',
+    fields: { relation: S() },
+  },
+  foreshadow_action: {
+    table: 'foreshadow_action', in: 'chapter', out: 'foreshadow', label: '伏笔动作',
+    fields: {
+      action: E(['plant', 'progress', 'reveal'], { required: true }),
+      chapter_no: I({ required: true }),
+      detail: T(),
+    },
+    fills: {
+      plant: 'foreshadow_plant',
+      progress: 'foreshadow_progress',
+      reveal: 'foreshadow_reveal',
+    },
+  },
+  payoff_action: {
+    table: 'payoff_action', in: 'chapter', out: 'payoff', label: '爽点动作',
+    fields: {
+      action: E(['setup', 'payoff'], { required: true }),
+      chapter_no: I({ required: true }),
+      detail: T(),
+    },
+    fills: {
+      setup: 'payoff_setup',
+      payoff: 'payoff_payoff',
+    },
+  },
+  info_action: {
+    table: 'info_action', in: 'chapter', out: 'information', label: '信息差动作',
+    fields: {
+      action: E(['created', 'progressed', 'resolved'], { required: true }),
+      chapter_no: I({ required: true }),
+      detail: T(),
+    },
+  },
+  ending_action: {
+    table: 'ending_action', in: 'chapter', out: 'ending', label: '结局动作',
+    fields: {
+      action: E(['close'], { required: true }),
+      chapter_no: I({ required: true }),
+      detail: T(),
+    },
+  },
+  outline_scene: {
+    table: 'outline_scene', in: 'outline', out: 'scene', label: '细纲→场景',
+    fields: { scene_order: I({ required: true }) },
+  },
+  outline_cast: {
+    table: 'outline_cast', in: 'outline', out: 'character', label: '细纲出场',
+    fields: { role: S() },
+  },
+  outline_location: {
+    table: 'outline_location', in: 'outline', out: 'location', label: '细纲地点',
+    fields: {},
+  },
+  outline_foreshadow: {
+    table: 'outline_foreshadow', in: 'outline', out: 'foreshadow', label: '细纲伏笔',
+    fields: { intent: S() },
+  },
+  scene_cast: {
+    table: 'scene_cast', in: 'scene', out: 'character', label: '场景人物',
+    fields: { role: S() },
+  },
+  scene_location: {
+    table: 'scene_location', in: 'scene', out: 'location', label: '场景地点',
+    fields: {},
+  },
+  scene_foreshadow: {
+    table: 'scene_foreshadow', in: 'scene', out: 'foreshadow', label: '场景伏笔',
+    fields: { action: E(['plant', 'progress', 'reveal']) },
+  },
+};
+
+/** Table name -> entity definition. */
+export const TABLE_TO_ENTITY = Object.fromEntries(
+  Object.entries(ENTITIES).map(([key, def]) => [def.table, { key, ...def }]),
+);
+
+/** Edge table -> edge definition. */
+export const TABLE_TO_EDGE = Object.fromEntries(
+  Object.entries(EDGES).map(([key, def]) => [def.table, { key, ...def }]),
+);
+
+export const HOOK_TYPES = [
+  // 章尾 13
+  '突然揭示', '紧急危机', '未完成动作', '身份反转', '两难抉择', '神秘物品',
+  '倒计时', '承诺/威胁', '离奇消失', '隐藏含义', '意象钩子', '回声钩子', '留白钩子',
+  // 章首 7
+  '悬念对话', '闪前碎片', '神秘独白', '反差场景', '意象预示',
+];
+
+export const EMOTION_PHASES = [
+  '平流', '蓄力', '调动', '紧张', '释放', '回暖', '转折', '压抑', '谷底', '沉重', '结算', '冷', '紧绷',
+];
+
+export function entityFor(table) {
+  return TABLE_TO_ENTITY[table] || null;
+}
+
+export function edgeFor(table) {
+  return TABLE_TO_EDGE[table] || null;
+}