@cloud411716/fancy-webnovel 2.2.0 → 3.0.0

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

@@ -0,0 +1,183 @@
+/**
+ * Database-native validation.
+ *
+ * The story graph's invariants are enforced in two places:
+ *   - `DEFINE EVENT` triggers in compile.js (hard write-time rules)
+ *   - `fn::fancy::validate($scope)` generated here (read-time checks and
+ *     quality warnings)
+ *
+ * Keeping validation in the database means every client (DSH, Hermes, the CLI,
+ * or a future MCP client) sees the same result; no client can skip a check by
+ * bypassing the JavaScript wrapper.
+ */
+
+export const SCHEMA_VERSION = 1;
+export const VALIDATION_VERSION = 1;
+
+export function validationDdl() {
+  return `DEFINE FUNCTION OVERWRITE fn::fancy::validate($scope: option<string>) {
+  // ---------------------------------------------------------------
+  // scope: '' = whole story, 'chapter:CH001' / 'foreshadow:FS001' = subtree
+  // ---------------------------------------------------------------
+  LET $sc = IF $scope = NONE { '' } ELSE { $scope };
+
+  // ---------------------------------------------------------------
+  // requirements: pending vs. hard requirement on a completed subject
+  // ---------------------------------------------------------------
+  LET $reqs = SELECT * FROM requirement WHERE story = story:main AND status = 'pending';
+  LET $req_rows = SELECT VALUE {
+    code: 'REQUIREMENT_PENDING',
+    severity: IF hard AND (SELECT VALUE status FROM type::record($this.subject))[0] = 'complete' { 'error' } ELSE { 'pending' },
+    scope: subject,
+    message: IF hard AND (SELECT VALUE status FROM type::record($this.subject))[0] = 'complete' { '已完成状态但还有必填待办：' + (label OR kind) } ELSE { '待办：' + (label OR kind) },
+    kind: kind,
+    due_chapter: due_chapter,
+    hard: hard
+  } FROM $reqs;
+
+  // ---------------------------------------------------------------
+  // chapter-level checks
+  // ---------------------------------------------------------------
+  LET $chapters = SELECT chapter_id, display_no, hook.type AS hook_type, hook.strength AS hook_strength, time.story_day AS story_day, time.flashback AS flashback, emotion.value AS emotion_value FROM chapter WHERE story = story:main ORDER BY display_no;
+
+  LET $hook_errors = SELECT VALUE {
+    code: 'HOOK_REPEAT',
+    severity: 'error',
+    scope: 'chapter:' + $this[2].chapter_id,
+    message: '第 ' + <string>$this[0].display_no + '/' + <string>$this[1].display_no + '/' + <string>$this[2].display_no + ' 章连续使用钩子「' + <string>$this[2].hook_type + '」',
+    hint: '换一种章尾钩子'
+  } FROM array::windows($chapters, 3)
+    WHERE $this[0].hook_type != NONE AND $this[0].hook_type = $this[1].hook_type AND $this[1].hook_type = $this[2].hook_type
+      AND ($sc = '' OR string::starts_with('chapter:' + $this[2].chapter_id, $sc));
+
+  LET $time_errors = SELECT VALUE {
+    code: 'TIME_REGRESSION',
+    severity: 'error',
+    scope: 'chapter:' + $this[1].chapter_id,
+    message: '第 ' + <string>$this[1].display_no + ' 章 story_day=' + <string>$this[1].story_day + ' 早于上一章 ' + <string>$this[0].story_day,
+    hint: '如果是闪回，写 time.flashback=true；否则调整时间'
+  } FROM array::windows($chapters, 2)
+    WHERE $this[0].story_day != NONE AND $this[1].story_day != NONE AND $this[1].story_day < $this[0].story_day AND $this[1].flashback != true
+      AND ($sc = '' OR string::starts_with('chapter:' + $this[1].chapter_id, $sc));
+
+  LET $emotion_warnings = SELECT VALUE {
+    code: 'EMOTION_FLAT',
+    severity: 'warning',
+    scope: 'chapter:' + $this[2].chapter_id,
+    message: '第 ' + <string>$this[0].display_no + '-' + <string>$this[2].display_no + ' 章情绪值连续接近'
+  } FROM array::windows($chapters, 3)
+    WHERE $this[0].emotion_value != NONE AND $this[1].emotion_value != NONE AND $this[2].emotion_value != NONE
+      AND math::max([$this[0].emotion_value, $this[1].emotion_value, $this[2].emotion_value]) - math::min([$this[0].emotion_value, $this[1].emotion_value, $this[2].emotion_value]) < 1
+      AND ($sc = '' OR string::starts_with('chapter:' + $this[2].chapter_id, $sc));
+
+  LET $weak_golden = SELECT VALUE chapter_id FROM chapter WHERE story = story:main AND display_no <= 3 AND (hook.strength != '强' OR hook.strength = NONE);
+  LET $golden_warnings = IF array::len($weak_golden) > 0 {
+    [{ code: 'GOLDEN_THREE_HOOK', severity: 'warning', scope: 'chapter:1-3', message: '黄金三章中有 ' + <string>array::len($weak_golden) + ' 章不是强钩子' }]
+  } ELSE { [] };
+
+  // ---------------------------------------------------------------
+  // foreshadow order / placement
+  // ---------------------------------------------------------------
+  LET $fs_groups = SELECT to_id, math::min(IF action = 'plant' THEN chapter_no ELSE 999999999 END) AS first_plant, math::min(IF action = 'reveal' THEN chapter_no ELSE 999999999 END) AS first_reveal FROM foreshadow_action WHERE story = story:main GROUP BY to_id;
+  LET $fs_errors = SELECT VALUE {
+    code: 'FORESHADOW_ORDER',
+    severity: 'error',
+    scope: 'foreshadow:' + <string>$this.to_id,
+    message: '伏笔 ' + <string>$this.to_id + ' 在第 ' + <string>$this.first_reveal + ' 章回收，但之前没有埋设'
+  } FROM $fs_groups WHERE $this.first_reveal < 999999999 AND ($this.first_plant >= 999999999 OR $this.first_reveal < $this.first_plant)
+    AND ($sc = '' OR string::starts_with('foreshadow:' + <string>$this.to_id, $sc));
+  LET $fs_pending = SELECT VALUE {
+    code: 'FORESHADOW_PLANT_MISSING',
+    severity: 'pending',
+    scope: 'foreshadow:' + <string>$this.to_id,
+    message: '伏笔 ' + <string>$this.to_id + ' 尚未埋设'
+  } FROM $fs_groups WHERE $this.first_plant >= 999999999
+    AND ($sc = '' OR string::starts_with('foreshadow:' + <string>$this.to_id, $sc));
+  LET $fs_unplaced = SELECT VALUE {
+    code: 'FORESHADOW_UNPLACED',
+    severity: 'pending',
+    scope: 'foreshadow:' + entity_id,
+    message: '伏笔「' + name + '」尚无任何章节动作'
+  } FROM foreshadow WHERE story = story:main AND entity_id NOT IN (SELECT VALUE to_id FROM foreshadow_action WHERE story = story:main)
+    AND ($sc = '' OR string::starts_with('foreshadow:' + entity_id, $sc));
+
+  // ---------------------------------------------------------------
+  // payoff order / placement
+  // ---------------------------------------------------------------
+  LET $pay_groups = SELECT to_id, math::min(IF action = 'setup' THEN chapter_no ELSE 999999999 END) AS first_setup, math::min(IF action = 'payoff' THEN chapter_no ELSE 999999999 END) AS first_payoff FROM payoff_action WHERE story = story:main GROUP BY to_id;
+  LET $pay_errors = SELECT VALUE {
+    code: 'PAYOFF_ORDER',
+    severity: 'error',
+    scope: 'payoff:' + <string>$this.to_id,
+    message: '爽点 ' + <string>$this.to_id + ' 的兑现章早于铺垫章'
+  } FROM $pay_groups WHERE $this.first_payoff < 999999999 AND $this.first_setup < 999999999 AND $this.first_payoff < $this.first_setup
+    AND ($sc = '' OR string::starts_with('payoff:' + <string>$this.to_id, $sc));
+  LET $pay_pending = SELECT VALUE {
+    code: 'PAYOFF_SETUP_MISSING',
+    severity: 'pending',
+    scope: 'payoff:' + <string>$this.to_id,
+    message: '爽点 ' + <string>$this.to_id + ' 尚未铺垫'
+  } FROM $pay_groups WHERE $this.first_payoff < 999999999 AND $this.first_setup >= 999999999
+    AND ($sc = '' OR string::starts_with('payoff:' + <string>$this.to_id, $sc));
+  LET $pay_unplaced = SELECT VALUE {
+    code: 'PAYOFF_UNPLACED',
+    severity: 'pending',
+    scope: 'payoff:' + entity_id,
+    message: '爽点「' + name + '」尚无章节动作'
+  } FROM payoff WHERE story = story:main AND entity_id NOT IN (SELECT VALUE to_id FROM payoff_action WHERE story = story:main)
+    AND ($sc = '' OR string::starts_with('payoff:' + entity_id, $sc));
+
+  // ---------------------------------------------------------------
+  // coverage warnings
+  // ---------------------------------------------------------------
+  LET $main_warnings = SELECT VALUE {
+    code: 'COVERAGE_MAIN',
+    severity: 'warning',
+    scope: 'line_node:' + node_id,
+    message: '主线节点 ' + node_id + ' 尚无章节落点'
+  } FROM line_node WHERE story = story:main AND node_id NOT IN (SELECT VALUE to_id FROM chapter_line_node WHERE story = story:main);
+  LET $conflict_warnings = SELECT VALUE {
+    code: 'COVERAGE_CONFLICT',
+    severity: 'warning',
+    scope: 'conflict:' + entity_id,
+    message: '冲突「' + name + '」尚无章节落点'
+  } FROM conflict WHERE story = story:main AND entity_id NOT IN (SELECT VALUE to_id FROM chapter_conflict WHERE story = story:main);
+
+  // ---------------------------------------------------------------
+  // outline quality warnings
+  // ---------------------------------------------------------------
+  LET $outline_warnings = SELECT VALUE {
+    code: IF array::len(->outline_scene) < 2 { 'OUTLINE_THIN_SCENES' } ELSE { 'OUTLINE_THIN_BEATS' },
+    severity: 'warning',
+    scope: 'outline:' + chapter_id,
+    message: IF array::len(->outline_scene) < 2 { chapter_id + ' 只有 ' + <string>array::len(->outline_scene) + ' 个场景；一般应有 2-4 个' } ELSE { chapter_id + ' 的 must_write 少于 3 条' }
+  } FROM outline WHERE story = story:main AND (array::len(->outline_scene) < 2 OR array::len(must_write) < 3);
+
+  // ---------------------------------------------------------------
+  // assemble
+  // ---------------------------------------------------------------
+  LET $errors = array::concat(
+    SELECT VALUE $this FROM $req_rows WHERE $this.severity = 'error' AND ($sc = '' OR string::starts_with($this.scope, $sc)),
+    $hook_errors,
+    $time_errors,
+    $fs_errors,
+    $pay_errors
+  );
+  LET $pending = array::concat(
+    SELECT VALUE $this FROM $req_rows WHERE $this.severity = 'pending' AND ($sc = '' OR string::starts_with($this.scope, $sc)),
+    $fs_pending,
+    $fs_unplaced,
+    $pay_pending,
+    $pay_unplaced
+  );
+  LET $warnings = array::concat(
+    $main_warnings,
+    $conflict_warnings,
+    $outline_warnings,
+    $emotion_warnings,
+    $golden_warnings
+  );
+
+  RETURN { errors: $errors, pending: $pending, warnings: $warnings };
+};`;
+}

package/plugins/fancy-story-builder/templates/v2/10-scale/scale-template.json

@@ -0,0 +1,144 @@
+{
+  "meta": {
+    "name": "scale-template",
+    "stage": "10-scale"
+  },
+  "capacity": {
+    "target_chapters": 300,
+    "target_words": 900000,
+    "avg_words_per_chapter": 3000,
+    "base_words_per_chapter": 2000,
+    "chapter_scale": 0.6667
+  },
+  "structure": {
+    "volume_count": 3,
+    "total_acts": 9,
+    "volumes": [
+      {
+        "volume_id": "V001",
+        "chapters": 100,
+        "ratio": 0.333333,
+        "act_count": 3,
+        "chapter_start": 1,
+        "chapter_end": 100,
+        "acts": [
+          {
+            "act_id": "A001",
+            "volume_id": "V001",
+            "act_index": 1,
+            "chapter_start": 1,
+            "chapter_end": 34,
+            "chapters": 34
+          }
+        ]
+      }
+    ],
+    "acts": []
+  },
+  "quotas": {
+    "characters": {
+      "protagonist": 1,
+      "core_supporting": 2,
+      "volume_supporting": 3,
+      "core_antagonist": 1,
+      "volume_antagonist": 3
+    },
+    "factions": 2,
+    "faction_relations": 1,
+    "locations": 3,
+    "items": {
+      "core": 2,
+      "branch": 2,
+      "symbolic": 1
+    },
+    "conflicts": {
+      "core": 1,
+      "phase": 1,
+      "branch": 2
+    },
+    "foreshadows": {
+      "small": 3,
+      "medium": 1,
+      "large": 1
+    },
+    "climaxes": {
+      "small": 5,
+      "medium": 1,
+      "large": 1
+    },
+    "pleasures": {
+      "small": 8,
+      "medium": 3,
+      "large": 1
+    },
+    "endings": 3,
+    "world_rules": {
+      "core": 1,
+      "information": 1,
+      "social": 1
+    },
+    "main_lines": 1,
+    "branches": 1,
+    "information_gaps": 20,
+    "relations": {
+      "character": 12,
+      "faction": 1,
+      "membership": 10
+    }
+  },
+  "rhythm_budget": {
+    "hooks": {
+      "min": 300,
+      "target": 330
+    },
+    "reveals": {
+      "min": 25,
+      "target": 37
+    },
+    "reversals": {
+      "min": 20,
+      "target": 30
+    },
+    "emotional_peaks": {
+      "min": 25,
+      "target": 37
+    },
+    "climax_chapters": 1,
+    "payoff_chapters": 4,
+    "golden_three": {
+      "hook_strength": "强",
+      "must_establish": [
+        "世界观入门",
+        "主角立住",
+        "核心冲突抛出"
+      ]
+    }
+  },
+  "distribution": {
+    "V001": {
+      "chapters": 100,
+      "volume_supporting": 1,
+      "volume_antagonist": 1,
+      "phase_conflicts": 1,
+      "foreshadows": {
+        "small": 1,
+        "medium": 1,
+        "large": 1
+      },
+      "climaxes": {
+        "small": 2,
+        "medium": 1,
+        "large": 1
+      },
+      "pleasures": {
+        "small": 3,
+        "medium": 1,
+        "large": 1
+      }
+    }
+  },
+  "formulas": {},
+  "constraints": {},
+  "formula_version": "2.1",
+  "genre_profile": "default"
+}

package/plugins/fancy-story-builder/templates/v2/20-macro/emotion-template.json

@@ -0,0 +1,15 @@
+{
+  "volumes": [
+    {
+      "volume_id": "V001",
+      "arc": "日常 → 不安 → 恐惧 → 反击",
+      "peaks": [
+        {
+          "act": "A001",
+          "intensity": 6,
+          "note": "第一次代价"
+        }
+      ]
+    }
+  ]
+}

package/plugins/fancy-story-builder/templates/v2/20-macro/endings-template.json

@@ -0,0 +1,16 @@
+{
+  "endings": [
+    {
+      "id": "E001",
+      "level": "全书级",
+      "type": "代价型圆满",
+      "direction": "结局方向",
+      "required_foreshadow_recovery": [
+        "FS001"
+      ],
+      "character_destinations": {
+        "ROLE-PROTAGONIST": "归宿"
+      }
+    }
+  ]
+}

package/plugins/fancy-story-builder/templates/v2/20-macro/lines-template.json

@@ -0,0 +1,28 @@
+{
+  "main_line": {
+    "id": "M001",
+    "name": "主线名",
+    "nodes": [
+      {
+        "id": "M001-01",
+        "volume": "V001",
+        "act": "A001",
+        "goal": "节点目标",
+        "turn": "节点转折"
+      }
+    ]
+  },
+  "branches": [
+    {
+      "id": "B001",
+      "name": "支线名",
+      "goal": "支线目标",
+      "start": "V001/A001",
+      "turning": "V002/A001",
+      "resolution": "V003/A003",
+      "interweaves": [
+        "M001-01"
+      ]
+    }
+  ]
+}

package/plugins/fancy-story-builder/templates/v2/20-macro/roles-template.json

@@ -0,0 +1,10 @@
+{
+  "roles": [
+    {
+      "role_id": "ROLE-PROTAGONIST",
+      "function": "主角",
+      "arc_question": "主角要回答的问题",
+      "macro_goal": "宏观目标"
+    }
+  ]
+}

package/plugins/fancy-story-builder/templates/v2/20-macro/story-template.json

@@ -0,0 +1,19 @@
+{
+  "core_question": "全书核心问题",
+  "core_conflict": "核心冲突",
+  "structure": {
+    "acts": [
+      {
+        "act_id": "A001",
+        "goal": "幕目标",
+        "turn": "转折",
+        "end_state": "结束状态"
+      }
+    ],
+    "turning_points": [],
+    "climax": "全书高潮",
+    "resolution": "收束方向"
+  },
+  "anti_tropes": [],
+  "promise": []
+}

package/plugins/fancy-story-builder/templates/v2/20-macro/volumes-template.json

@@ -0,0 +1,24 @@
+{
+  "volumes": [
+    {
+      "id": "V001",
+      "title": "卷名",
+      "chapter_start": 1,
+      "chapter_end": 100,
+      "goal": "卷目标",
+      "core_conflict": "核心冲突",
+      "emotional_arc": "情绪走向",
+      "ending_hook": "卷尾钩子",
+      "acts": [
+        {
+          "act_id": "A001",
+          "act_index": 1,
+          "chapter_start": 1,
+          "chapter_end": 34,
+          "goal": "幕目标",
+          "climax": "幕高潮"
+        }
+      ]
+    }
+  ]
+}

package/plugins/fancy-story-builder/templates/v2/20-macro/world-template.json

@@ -0,0 +1,24 @@
+{
+  "premise": "一句话世界前提",
+  "theme": [
+    "主题"
+  ],
+  "tone": "基调",
+  "world_rules": [
+    {
+      "id": "R001",
+      "name": "规则名",
+      "category": "核心",
+      "content": "规则内容",
+      "scope": "适用范围",
+      "exceptions": [],
+      "cost": "代价",
+      "impact": "影响"
+    }
+  ],
+  "power_system": {},
+  "social_order": {},
+  "taboos": [],
+  "core_imagery": [],
+  "reader_promise": []
+}

package/plugins/fancy-story-builder/templates/v2/30-cast/characters-template.json

@@ -0,0 +1,49 @@
+{
+  "characters": [
+    {
+      "id": "C001",
+      "role_slot": "ROLE-PROTAGONIST",
+      "name": "人物名",
+      "type": "主角",
+      "faction": "F001",
+      "description": "简介",
+      "goal": {
+        "short_term": "短期目标",
+        "medium_term": "中期目标",
+        "long_term": "长期目标"
+      },
+      "flaw": "缺陷",
+      "golden_finger": "金手指",
+      "information_state": {
+        "known": [
+          "已知"
+        ],
+        "unknown": [
+          "未知"
+        ],
+        "false_belief": [
+          "误信"
+        ]
+      },
+      "arc": {
+        "type": "发现型",
+        "stages": [
+          {
+            "name": "阶段名",
+            "question": "阶段问题",
+            "planned_change": "变化"
+          }
+        ]
+      },
+      "voice": {
+        "catchphrase": "口头禅",
+        "rhythm": "语言节奏"
+      },
+      "traits": [],
+      "exit": {
+        "type": "未退场",
+        "description": ""
+      }
+    }
+  ]
+}

package/plugins/fancy-story-builder/templates/v2/30-cast/climaxes-template.json

@@ -0,0 +1,14 @@
+{
+  "climaxes": [
+    {
+      "id": "CL001",
+      "name": "高潮名",
+      "type": "小",
+      "description": "简介",
+      "payoff": "兑现",
+      "participants": [
+        "C001"
+      ]
+    }
+  ]
+}

package/plugins/fancy-story-builder/templates/v2/30-cast/conflicts-template.json

@@ -0,0 +1,30 @@
+{
+  "conflicts": [
+    {
+      "id": "X001",
+      "name": "冲突名",
+      "type": "core",
+      "description": "简介",
+      "core_goal": "核心目标",
+      "stakes": "赌注",
+      "escalation_path": [
+        {
+          "node_type": "引入",
+          "description": "引入"
+        },
+        {
+          "node_type": "升级",
+          "description": "升级"
+        }
+      ],
+      "resolution_plan": {
+        "method": "解决方式",
+        "residual_impact": "残留影响"
+      },
+      "participants": [
+        "C001",
+        "F001"
+      ]
+    }
+  ]
+}

package/plugins/fancy-story-builder/templates/v2/30-cast/factions-template.json

@@ -0,0 +1,18 @@
+{
+  "factions": [
+    {
+      "id": "F001",
+      "name": "势力名",
+      "type": "组织",
+      "description": "简介",
+      "goal": "目标",
+      "resources": [
+        "资源"
+      ],
+      "territory": [
+        "地盘"
+      ],
+      "internal_conflict": "内部矛盾"
+    }
+  ]
+}

package/plugins/fancy-story-builder/templates/v2/30-cast/foreshadows-template.json

@@ -0,0 +1,29 @@
+{
+  "foreshadows": [
+    {
+      "id": "FS001",
+      "name": "伏笔名",
+      "type": "小",
+      "setup": "埋设",
+      "clues": [
+        "线索"
+      ],
+      "payoff_target": "回收目标",
+      "recovery_requirement": "结局前回收",
+      "red_herrings": [],
+      "scope": "book",
+      "initial_knowledge": [
+        {
+          "character": "C001",
+          "state": "partial",
+          "coverage": "partial",
+          "knowledge": "知道有这条线索，但不知道它指向什么",
+          "how": "witnessed",
+          "source_character": null,
+          "scene": "第一次见到线索的地点",
+          "evidence": "看到了具体异常"
+        }
+      ]
+    }
+  ]
+}

package/plugins/fancy-story-builder/templates/v2/30-cast/information-template.json

@@ -0,0 +1,29 @@
+{
+  "information_gaps": [
+    {
+      "id": "IG-X001-01",
+      "conflict": "X001",
+      "info_name": "谁知道什么",
+      "who_knows": [
+        "C002"
+      ],
+      "who_does_not_know": [
+        "C001"
+      ],
+      "resolution_method": "如何揭示",
+      "writing_ban": "解决前 C001 不得说出真相",
+      "initial_knowledge": [
+        {
+          "character": "C001",
+          "state": "unknown",
+          "coverage": "unknown",
+          "knowledge": "只知道传闻，不知道具体细节",
+          "how": "none",
+          "source_character": null,
+          "scene": "开篇之前",
+          "evidence": "没有任何可核对的证据"
+        }
+      ]
+    }
+  ]
+}

package/plugins/fancy-story-builder/templates/v2/30-cast/items-template.json

@@ -0,0 +1,13 @@
+{
+  "items": [
+    {
+      "id": "P001",
+      "name": "道具名",
+      "category": "core",
+      "description": "简介",
+      "function": "功能",
+      "owner": "C001",
+      "limit": "限制"
+    }
+  ]
+}

package/plugins/fancy-story-builder/templates/v2/30-cast/locations-template.json

@@ -0,0 +1,12 @@
+{
+  "locations": [
+    {
+      "id": "L001",
+      "name": "地点名",
+      "type": "场景",
+      "description": "简介",
+      "narrative_function": "叙事功能",
+      "rules": []
+    }
+  ]
+}