@cloud411716/fancy-webnovel 1.0.46 → 2.2.0

package/plugins/fancy-story-builder/scripts/writing-rules.js

@@ -0,0 +1,167 @@
+/**
+ * writing-rules.js —— 写作原则与充分性闸门
+ *
+ * 同样来自旧版 skill（fancy-write/references/writing-principles.md），
+ * 原先是纯 markdown 规范，模型"读了要记住"、脚本"没法查"。
+ * 这里落成两种东西：
+ *   1. WRITING_PRINCIPLES —— 9 条原则，写进提示词供模型起草时套用；
+ *   2. COMMIT_GATES      —— 7 项闸门，写进提示词 + 校验器，做 commit 前的硬检查。
+ *
+ * 闸门与校验器的对应关系（哪些是脚本能判的、哪些要靠别的校验器）：
+ *   闸门 1 正文存在且够长     → writing-validate.js 的 WORD_COUNT / EMPTY_CHAPTER
+ *   闸门 2 上下文卡已生成     → 驱动内部状态，不落盘
+ *   闸门 3 blocking 校验通过   → deslop 检测器（ai-patterns.js）
+ *   闸门 4 AI 模式 0 blocking  → deslop 检测器（ai-patterns.js）
+ *   闸门 5 钩子符合 7/13 种   → writing-validate.js 的 HOOK_TYPE_INVALID
+ *   闸门 6 死人不再出场       → writing-validate.js 的 DEAD_CHARACTER_APPEARS
+ *   闸门 7 章节号连续         → 驱动内部状态
+ *
+ * 写清楚每条闸门归谁管，是为了避免"提示词说要过闸门，但没人查"。
+ */
+
+/**
+ * 9 条写作核心原则。起草时强制应用。
+ * 字段与旧 skill 的原文一一对应，不做删改（只把 markdown 列表拆成结构化数据）。
+ */
+export const WRITING_PRINCIPLES = [
+  {
+    id: 'scene_construction',
+    name: '场景构造法',
+    summary: '每个场景必须回答五个问题，缺一个就不是场景。',
+    // 不在这里重复定义五要素 —— 它的家是 references/写作指导/01-scene.md §2。
+    // 这里只做指针，避免同一份定义出现两处然后各自漂移
+    // （旧 skill 就是这么坏的：同一件事三份副本、互相不一致）。
+    ref: 'references/写作指导/01-scene.md §2 场景五要素',
+    elements: [
+      { id: 'place', name: '地点', desc: '在哪？有什么环境细节？' },
+      { id: 'cast', name: '人物', desc: '谁在场？各自想要什么？' },
+      { id: 'objective', name: '目标', desc: '本场景中，视角人物想要什么？' },
+      { id: 'resistance', name: '阻碍', desc: '什么阻止他？' },
+      { id: 'turn', name: '转折', desc: '场景结束时，处境/关系/认知发生了什么变化？' }
+    ]
+  },
+  {
+    id: 'character_choice_4d',
+    name: '人物选择 4 维',
+    summary: '角色做选择必须基于这四维，而不是"作者想让剧情走到哪"。',
+    elements: [
+      { id: 'wants', name: 'wants', desc: '欲望' },
+      { id: 'knows', name: 'knows', desc: '信息边界（角色此刻知道什么）' },
+      { id: 'fears', name: 'fears', desc: '恐惧' },
+      { id: 'can_afford', name: 'can_afford', desc: '代价承受力' }
+    ]
+  },
+  {
+    id: 'reveal_by_action',
+    name: '背景/设定通过动作揭示',
+    summary: '设定靠动作、证据、对话、感官细节露出来，不能用叙述替代场景。',
+    elements: [
+      { id: 'action', name: '动作', desc: '角色做了什么' },
+      { id: 'evidence', name: '证据', desc: '看到了什么实物' },
+      { id: 'dialogue', name: '对话', desc: '说了什么' },
+      { id: 'sensory', name: '感官细节', desc: '闻到什么、摸到什么' }
+    ]
+  },
+  {
+    id: 'every_paragraph_changes',
+    name: '每段必有变化',
+    summary: '每段至少改变一个维度，否则删掉。',
+    dimensions: ['conflict', 'evidence', 'emotion', 'relationship', 'knowledge', 'position', 'consequence']
+  },
+  {
+    id: 'controlled_release',
+    name: '信息释放受控',
+    summary: '回答一部分活跃疑问，深化其他疑问；不靠隐藏 POV 已知的事实造反转。',
+    rules: [
+      '回答部分活跃的读者疑问',
+      '用具体证据深化其他疑问',
+      '不要隐藏 POV 已知的事实来制造反转'
+    ]
+  },
+  {
+    id: 'keep_author_voice',
+    name: '保留用户声音',
+    summary: "强制应用作者意图的硬门禁和反套路，不能替作者改文风。"
+  },
+  {
+    id: 'non_mechanical_cliffhanger',
+    name: '章末非机械 cliffhanger',
+    summary: '章末要有实质变化或新的压力，不是套公式。',
+    rules: ['material change（实质变化）', 'fresh pressure（新的压力）', '不是机械公式']
+  },
+  {
+    id: 'no_plagiarism',
+    name: '不抄袭源材料',
+    summary: '参考资料只作技法参考，禁止复制段落/名字/组合。'
+  },
+  {
+    id: 'minimal_layer_repair',
+    name: '最小层修复',
+    summary: '重写从最小层开始，不整章替换。',
+    rules: ['改一段不改一章', '能删就不重写', '不整章替换']
+  }
+];
+
+/**
+ * 7 项充分性闸门 —— commit 一章前必须全过。
+ * checker 指明这条闸门归谁判（避免"提示词说要过，但没人查"）。
+ */
+export const COMMIT_GATES = [
+  {
+    id: 'body_exists',
+    name: '正文文件存在且够长',
+    checker: 'writing-validate.js',
+    detail: '正文存在、非空，字数达到本章目标（±20%）。'
+  },
+  {
+    id: 'context_card_ready',
+    name: '上下文卡已生成',
+    checker: '驱动内部',
+    detail: '本轮的细纲、前章尾、台账快照已经注入提示词。'
+  },
+  {
+    id: 'blocking_passed',
+    name: 'blocking 级校验已通过',
+    checker: 'deslop 检测器',
+    detail: 'ai-patterns.js 判出的 blocking 类目命中数为 0。'
+  },
+  {
+    id: 'ai_pattern_clean',
+    name: 'AI 模式扫描 0 blocking',
+    checker: 'deslop 检测器',
+    detail: '同上；advisory 类目只提示不阻断。'
+  },
+  {
+    id: 'hook_types_valid',
+    name: '章首/章尾钩子符合 7/13 种',
+    checker: 'writing-validate.js',
+    detail: 'hook_head_type ∈ 7 式章首引子；hook_tail_type ∈ 13 式章末钩子；且不得连续 3 章同一种。'
+  },
+  {
+    id: 'no_dead_character',
+    name: '死人不再出场',
+    checker: 'writing-validate.js',
+    detail: '已死亡角色再次出场，必须有 revival_event 说明。'
+  },
+  {
+    id: 'chapter_sequence',
+    name: '章节号连续',
+    checker: '驱动内部',
+    detail: '写第 N 章前，第 N-1 章必须已经 commit。'
+  }
+];
+
+/**
+ * 查某条闸门归谁管（给提示词/报告用）。
+ * @returns {object|null}
+ */
+export function gateById(id) {
+  return COMMIT_GATES.find((g) => g.id === id) || null;
+}
+
+/**
+ * 列出全部闸门 id（给提示词生成与守卫用例用）。
+ */
+export function commitGateIds() {
+  return COMMIT_GATES.map((g) => g.id);
+}