novel-writer-cli 0.3.0 → 0.5.0

package/templates/ai-sentence-patterns.json

@@ -0,0 +1,167 @@
+{
+  "version": "1.0.0",
+  "description": "结构级 AI 句式模式定义 -- 依赖 LLM 语义理解识别，无法正则匹配。供 ChapterWriter（生成时避免）、StyleRefiner（后处理检测替换）、QualityJudge（评分扣分）消费。",
+  "last_updated": "2026-03-06",
+  "patterns": [
+    {
+      "id": "SP-01",
+      "name": "解释型旁白句",
+      "severity": "high",
+      "per_chapter_max": 0,
+      "description": "作者替人物翻译潜台词，用旁白显式解释角色的言外之意或行为动机。读者本可从动作、对话、上下文自行推断的信息，被作者替读者'翻译'了一遍。",
+      "examples": {
+        "bad": [
+          "她知道他是在用这种方式表达关心。",
+          "他这么做，其实是想让她安心。",
+          "这句话的言外之意是，他已经不打算回来了。"
+        ],
+        "good": [
+          "她没接话，把围巾往他脖子上绕了一圈。",
+          "他把药放在桌上，转身就走，门带得很轻。",
+          "她盯着那把钥匙看了很久，最后塞进了抽屉最深处。"
+        ]
+      },
+      "replacement_strategy": "删除解释性旁白，改为动作、表情、停顿或对话暗示，让读者自行推断。"
+    },
+    {
+      "id": "SP-02",
+      "name": "模板转折句",
+      "severity": "high",
+      "per_chapter_max": 0,
+      "description": "机械性的'先负后正'或'先正后负'平衡句式，用固定模板连接两个对立面。常见标志词：'听上去……可……'、'看似……实则……'、'虽然……但……'（非自然口语转折）。",
+      "examples": {
+        "bad": [
+          "听上去是在安慰，可语气里透着一股子不耐烦。",
+          "看似平静的表面下，实则暗流涌动。",
+          "话虽然说得轻松，但谁都看得出他在强撑。"
+        ],
+        "good": [
+          "\u201c没事。\u201d他说。手指却在桌下攥得指节发白。",
+          "他笑了一声，笑声没到眼睛。",
+          "她拍了拍他的肩，力气大得像是要把什么东西拍碎。"
+        ]
+      },
+      "replacement_strategy": "拆掉对称句式，用前后两个独立动作/细节的并置制造张力，让读者自己感受矛盾。"
+    },
+    {
+      "id": "SP-03",
+      "name": "抽象判词句",
+      "severity": "medium",
+      "per_chapter_max": 2,
+      "description": "用抽象概念词代替具体画面，给读者一个'标签'而非一个'场景'。常见形式：'那股XX劲'、'一种XX的感觉'、'某种XX的气质'。",
+      "examples": {
+        "bad": [
+          "他身上有一股不怒自威的劲儿。",
+          "空气里弥漫着一种紧张的感觉。",
+          "她散发着某种让人不敢靠近的气质。"
+        ],
+        "good": [
+          "他往那一站，周围说话的人声音就自动矮了半截。",
+          "没人动筷子，菜凉了也没人敢先夹。",
+          "路过的人看她一眼就绕道，连问路的都没有。"
+        ]
+      },
+      "replacement_strategy": "把抽象标签翻译成可观察的具体动作、反应或细节，让读者通过画面得出结论。"
+    },
+    {
+      "id": "SP-04",
+      "name": "管理/项目腔",
+      "severity": "medium",
+      "per_chapter_max": 2,
+      "description": "PRD/汇报/管理文档的用语和句式侵入小说叙事。角色对话或旁白中出现'可被执行'、'核心诉求'、'关键节点'、'从根本上'等非文学用语。",
+      "examples": {
+        "bad": [
+          "这个计划的核心诉求是在三天内完成撤离。",
+          "他意识到，自己正处于一个关键的转折节点。",
+          "从根本上来说，这件事是可以被解决的。"
+        ],
+        "good": [
+          "三天，把人全撤出去。他在纸上画了条线。",
+          "再往前走一步，就回不了头了。",
+          "能办。他把烟掐灭，就是麻烦点。"
+        ]
+      },
+      "replacement_strategy": "用角色会说的口语、动作或具体场景替换管理术语，让语言回到叙事语域。"
+    },
+    {
+      "id": "SP-05",
+      "name": "重复解释",
+      "severity": "high",
+      "per_chapter_max": 0,
+      "description": "前句已经通过动作/对话暗示了某个信息，后句又用旁白显式重述同一信息。造成信息冗余和'读者智商被低估'的感觉。",
+      "examples": {
+        "bad": [
+          "他猛地站起来，椅子向后滑出半米。他显然被这个消息激怒了。",
+          "\u201c滚。\u201d她把门摔上。她不想再见到他。",
+          "他的手在发抖。他害怕了。"
+        ],
+        "good": [
+          "他猛地站起来，椅子向后滑出半米。",
+          "\u201c滚。\u201d门框震了一下。",
+          "他把手插进口袋里，掌心全是汗。"
+        ]
+      },
+      "replacement_strategy": "删除重复解释的后句，信任读者的理解能力。如果担心暗示不够明确，强化前句的动作/细节而非追加旁白。"
+    },
+    {
+      "id": "SP-06",
+      "name": "因果说明句",
+      "severity": "medium",
+      "per_chapter_max": 2,
+      "description": "用显式因果连接词串联前后文，把本该隐含在叙事节奏中的因果关系写成论文式推理链。常见标志词：'毕竟'、'之所以……是因为'、'正因如此'。",
+      "examples": {
+        "bad": [
+          "他没有追上去。毕竟，再追下去也没有意义了。",
+          "她之所以不肯开口，是因为她知道一旦说了就收不回来。",
+          "正因如此，他选择了沉默。"
+        ],
+        "good": [
+          "他停在原地，看着她的背影消失在拐角。脚底像生了根。",
+          "她咬着嘴唇，把要说的话又咽了回去。有些话一出口就是刀。",
+          "他什么也没说。沉默比什么都好用。"
+        ]
+      },
+      "replacement_strategy": "删除因果连接词，用动作/画面/节奏暗示因果关系，让逻辑藏在叙事里而非显式陈述。"
+    },
+    {
+      "id": "SP-07",
+      "name": "情绪标签句",
+      "severity": "high",
+      "per_chapter_max": 0,
+      "description": "直接给角色的情绪贴标签（'感到愤怒'、'心中涌起悲伤'），而非通过身体反应、动作、语气或环境映射来展示情绪。与 ai-blacklist 的 emotion_cliche 类别互补：黑名单抓固定短语，本模式抓'感到/涌起/充满+情绪名词'的句式结构。",
+      "examples": {
+        "bad": [
+          "她感到一阵愤怒涌上心头。",
+          "他心中充满了悲伤和无奈。",
+          "一种深深的恐惧笼罩着他。"
+        ],
+        "good": [
+          "她把筷子往桌上一拍，碗里的汤溅出来也没管。",
+          "他坐在床边，鞋子穿了一半就不动了，盯着地板上那道裂缝。",
+          "后背的汗还没干，他已经开始往回跑了。"
+        ]
+      },
+      "replacement_strategy": "用 Show Don't Tell：身体反应（手抖/冒汗/喉咙发紧）、动作（摔东西/转身就走）、语气变化（声音变冷/说话断断续续）代替直接命名情绪。"
+    },
+    {
+      "id": "SP-08",
+      "name": "全知评论句",
+      "severity": "medium",
+      "per_chapter_max": 2,
+      "description": "叙述者跳出当前 POV，以上帝视角做评论或预告。在限定视角叙事中尤其违和。常见形式：'他不知道的是'、'注定不会平静'、'如果他知道接下来会发生什么'。",
+      "examples": {
+        "bad": [
+          "他不知道的是，这将是他最后一次见到她。",
+          "这个夜晚注定不会平静。",
+          "如果她知道接下来会发生什么，一定不会走进那扇门。"
+        ],
+        "good": [
+          "他冲她挥了挥手，转身走进雨里。",
+          "夜风把窗户吹得啪啪响，她起身去关，看见院子里的灯灭了。",
+          "她推开门的时候，鞋底踩到了什么黏糊糊的东西。"
+        ]
+      },
+      "replacement_strategy": "删除全知评论，回到 POV 角色的感知范围内叙事。用细节和氛围暗示'有事要发生'，而不是直接告诉读者。"
+    }
+  ]
+}

package/templates/genre-excitement-map.json

@@ -0,0 +1,48 @@
+{
+  "schema_version": 1,
+  "description": "题材差异化的黄金三章爽点分配建议：按 brief.md 的题材字段匹配 genre key，仅作为 PlotArchitect 的默认参考。",
+  "genres": {
+    "xuanhuan": {
+      "chapters": {
+        "1": "setup",
+        "2": "power_up",
+        "3": "face_slap"
+      }
+    },
+    "dushi": {
+      "chapters": {
+        "1": "setup",
+        "2": "reversal",
+        "3": "face_slap"
+      }
+    },
+    "scifi": {
+      "chapters": {
+        "1": "reveal",
+        "2": "setup",
+        "3": "cliffhanger"
+      }
+    },
+    "history": {
+      "chapters": {
+        "1": "setup",
+        "2": "reveal",
+        "3": "reversal"
+      }
+    },
+    "suspense": {
+      "chapters": {
+        "1": "reveal",
+        "2": "setup",
+        "3": "cliffhanger"
+      }
+    },
+    "romance": {
+      "chapters": {
+        "1": "setup",
+        "2": "reveal",
+        "3": "reversal"
+      }
+    }
+  }
+}

package/templates/genre-golden-standards.json

@@ -0,0 +1,80 @@
+{
+  "schema_version": 1,
+  "description": "题材特定的黄金三章评审标准：仅在 chapter 1-3 且 brief.md 的题材字段匹配时注入 QualityJudge。",
+  "genres": {
+    "xuanhuan": {
+      "focus_dimensions": ["immersion", "foreshadowing"],
+      "criteria": [
+        "前三章要让世界观/力量体系有明显存在感，不能只有空泛名词堆叠。",
+        "升级、资源、境界或代价机制至少要出现一次可感知展示。"
+      ],
+      "minimum_thresholds": {
+        "immersion": 3.5
+      }
+    },
+    "dushi": {
+      "focus_dimensions": ["pacing", "hook_strength"],
+      "criteria": [
+        "都市开篇要尽快建立身份反差、社会张力或现实压迫。",
+        "前三章应给出足够快的逆转/立威预期，避免纯背景介绍。"
+      ],
+      "minimum_thresholds": {
+        "pacing": 3.5
+      }
+    },
+    "scifi": {
+      "focus_dimensions": ["plot_logic", "immersion"],
+      "criteria": [
+        "设定揭示必须兼顾可信度与可理解性，避免只抛概念不落地。",
+        "科技/规则说明要与情节推进绑定，不能牺牲逻辑一致性。"
+      ],
+      "minimum_thresholds": {
+        "plot_logic": 3.5,
+        "immersion": 3.5
+      }
+    },
+    "history": {
+      "focus_dimensions": ["plot_logic", "immersion"],
+      "criteria": [
+        "时代氛围、礼制或历史 plausibility 要稳定成立。",
+        "人物处境与时代约束之间需要有可验证的因果关系。"
+      ],
+      "minimum_thresholds": {
+        "plot_logic": 3.5
+      }
+    },
+    "suspense": {
+      "focus_dimensions": ["plot_logic", "hook_strength"],
+      "criteria": [
+        "线索铺设、误导和悬念升级必须逻辑自洽，不能靠强行藏信息。",
+        "前三章至少建立一个会驱动读者追更的核心疑问。"
+      ],
+      "minimum_thresholds": {
+        "plot_logic": 4.0
+      }
+    },
+    "romance": {
+      "focus_dimensions": ["character", "style_naturalness", "emotional_impact"],
+      "criteria": [
+        "人物性格与关系张力要通过动作、对白和情绪反应落地，不能只靠旁白概括。",
+        "CP 化学反应、情绪钩子或关系预期必须在前三章站住。"
+      ],
+      "minimum_thresholds": {
+        "character": 4.0,
+        "style_naturalness": 3.5
+      }
+    }
+  },
+  "invalid_combinations": [
+    {
+      "genre": "romance",
+      "platform": "qidian",
+      "warning": "起点以男频为主，言情题材建议优先考虑晋江或番茄；若坚持选择起点，请尽早补强主线承诺与差异点。"
+    },
+    {
+      "genre": "xuanhuan",
+      "platform": "jinjiang",
+      "warning": "晋江以女频为主，玄幻题材建议优先考虑起点或番茄；若坚持选择晋江，请提前明确关系张力与情绪卖点。"
+    }
+  ]
+}

package/templates/genre-weight-profiles.json

@@ -29,6 +29,21 @@
     "slice_of_life": "slice_of_life:v1"
   },
 
+  "platform_multipliers": {
+    "fanqie": {
+      "hook_strength": 1.5,
+      "pacing": 1.3
+    },
+    "qidian": {
+      "immersion": 1.3
+    },
+    "jinjiang": {
+      "character": 1.3,
+      "style_naturalness": 1.3,
+      "emotional_impact": 1.2
+    }
+  },
+
   "profiles": {
     "plot:v1": {
       "drive_type": "plot",

package/templates/golden-chapter-gates.json

@@ -0,0 +1,230 @@
+{
+  "schema_version": 1,
+  "description": "黄金三章平台硬门控模板：仅适用于 chapter 1-3；平台查找使用 canonical platform id。",
+  "platforms": {
+    "fanqie": {
+      "chapters": {
+        "1": {
+          "gates": [
+            {
+              "id": "protagonist_within_200_words",
+              "requirement": "主角必须在前 200 字内出场（行动、台词或明确 POV 均可）。",
+              "evaluation_hint": "若前 200 字内只有背景铺陈或旁白，没有主角存在感，则判 fail。",
+              "threshold": { "metric": "protagonist_first_appearance_word_index", "operator": "<=", "value": 200 }
+            },
+            {
+              "id": "conflict_present",
+              "requirement": "本章必须至少出现 1 个明确冲突点（危机、对抗、目标受阻三者之一）。",
+              "evaluation_hint": "若整章只有信息介绍或氛围铺陈，没有显性阻力或冲突推进，则判 fail。"
+            },
+            {
+              "id": "hook_present",
+              "requirement": "章末必须有明确钩子，不能以平铺收尾。",
+              "evaluation_hint": "若结尾为总结、回望或纯收束，没有未解问题/威胁/反转/下一目标承诺，则判 fail."
+            },
+            {
+              "id": "excitement_type_allowed",
+              "requirement": "爽点类型需落在 reversal / face_slap / power_up 之一。",
+              "evaluation_hint": "结合章节主冲突与高潮段，判断核心爽点类型是否匹配番茄偏好。",
+              "allowed_values": ["reversal", "face_slap", "power_up"]
+            }
+          ],
+          "notes": ["优先快起冲突、快给反馈，设置描写要嵌在行动里。"]
+        },
+        "2": {
+          "gates": [
+            {
+              "id": "conflict_present",
+              "requirement": "本章必须至少出现 1 个明确冲突点（危机、对抗、目标受阻三者之一）。",
+              "evaluation_hint": "若整章只有信息介绍或氛围铺陈，没有显性阻力或冲突推进，则判 fail。"
+            },
+            {
+              "id": "hook_present",
+              "requirement": "章末必须有明确钩子，不能以平铺收尾。",
+              "evaluation_hint": "若结尾为总结、回望或纯收束，没有未解问题/威胁/反转/下一目标承诺，则判 fail."
+            },
+            {
+              "id": "excitement_type_allowed",
+              "requirement": "爽点类型需落在 reversal / face_slap / power_up 之一。",
+              "evaluation_hint": "结合章节主冲突与高潮段，判断核心爽点类型是否匹配番茄偏好。",
+              "allowed_values": ["reversal", "face_slap", "power_up"]
+            }
+          ],
+          "notes": ["第二章要拉高追读预期，避免单纯补设定。"]
+        },
+        "3": {
+          "gates": [
+            {
+              "id": "conflict_present",
+              "requirement": "本章必须至少出现 1 个明确冲突点（危机、对抗、目标受阻三者之一）。",
+              "evaluation_hint": "若整章只有信息介绍或氛围铺陈，没有显性阻力或冲突推进，则判 fail。"
+            },
+            {
+              "id": "hook_present",
+              "requirement": "章末必须有明确钩子，不能以平铺收尾。",
+              "evaluation_hint": "若结尾为总结、回望或纯收束，没有未解问题/威胁/反转/下一目标承诺，则判 fail."
+            },
+            {
+              "id": "excitement_type_allowed",
+              "requirement": "爽点类型需落在 reversal / face_slap / power_up 之一。",
+              "evaluation_hint": "结合章节主冲突与高潮段，判断核心爽点类型是否匹配番茄偏好。",
+              "allowed_values": ["reversal", "face_slap", "power_up"]
+            }
+          ],
+          "notes": ["第三章要把留存预期打牢，至少形成一个清晰的短期爽点承诺。"]
+        }
+      }
+    },
+    "qidian": {
+      "chapters": {
+        "1": {
+          "gates": [
+            {
+              "id": "system_or_world_present",
+              "requirement": "系统线索或世界观关键差异必须被建立。",
+              "evaluation_hint": "若第一章仍无法判断核心设定、世界规则或系统入口，判 fail。"
+            },
+            {
+              "id": "immersion_min_score",
+              "requirement": "immersion 评分必须 >= 3.5。",
+              "evaluation_hint": "若画面、氛围、世界规则体验感不足，且难以形成代入，则判 fail。",
+              "threshold": { "metric": "scores.immersion.score", "operator": ">=", "value": 3.5 }
+            }
+          ],
+          "notes": ["开篇允许较多设定，但必须服务于代入与悬念。"]
+        },
+        "2": {
+          "gates": [
+            {
+              "id": "system_or_world_present",
+              "requirement": "系统线索或世界观关键差异必须持续推进。",
+              "evaluation_hint": "若第二章对核心设定没有新增抓手，判 fail。"
+            },
+            {
+              "id": "immersion_min_score",
+              "requirement": "immersion 评分必须 >= 3.5。",
+              "evaluation_hint": "若画面、氛围、世界规则体验感不足，且难以形成代入，则判 fail。",
+              "threshold": { "metric": "scores.immersion.score", "operator": ">=", "value": 3.5 }
+            }
+          ],
+          "notes": ["第二章继续加深世界可信度，而不是只讲概念。"]
+        },
+        "3": {
+          "gates": [
+            {
+              "id": "system_or_world_present",
+              "requirement": "系统线索或世界观关键差异必须持续推进。",
+              "evaluation_hint": "若第三章后读者仍抓不到作品的独特规则，判 fail。"
+            },
+            {
+              "id": "immersion_min_score",
+              "requirement": "immersion 评分必须 >= 3.5。",
+              "evaluation_hint": "若画面、氛围、世界规则体验感不足，且难以形成代入，则判 fail。",
+              "threshold": { "metric": "scores.immersion.score", "operator": ">=", "value": 3.5 }
+            }
+          ],
+          "notes": ["第三章要让读者对世界与主线有继续探索的动力。"]
+        }
+      }
+    },
+    "jinjiang": {
+      "chapters": {
+        "1": {
+          "gates": [
+            {
+              "id": "personality_through_behavior",
+              "requirement": "主要角色个性必须通过动作、对话、反应体现，不能只靠旁白直述。",
+              "evaluation_hint": "若个性结论只存在于解说句，没有行为证据支撑，则判 fail。"
+            },
+            {
+              "id": "cp_appears",
+              "requirement": "CP（主感情对手或核心关系对象）必须在前三章早期出现，本章优先建立存在感。",
+              "evaluation_hint": "若第一章完全没有 CP 本人、名字、互动或强关联线索，则判 fail。"
+            },
+            {
+              "id": "emotional_tone_established",
+              "requirement": "情感基调必须清晰建立（拉扯、暧昧、压迫、治愈等至少一种）。",
+              "evaluation_hint": "若读者无法感知情感走向，只剩事件流水账，则判 fail。"
+            },
+            {
+              "id": "style_naturalness_min_score",
+              "requirement": "style_naturalness 评分必须 >= 3.5。",
+              "evaluation_hint": "若文风生硬、腔调重、人物情绪不贴身，则判 fail。",
+              "threshold": { "metric": "scores.style_naturalness.score", "operator": ">=", "value": 3.5 }
+            }
+          ],
+          "notes": ["晋江开篇重人物化学反应与情绪落点，不要把吸引力全押在外部设定。"]
+        },
+        "2": {
+          "gates": [
+            {
+              "id": "personality_through_behavior",
+              "requirement": "主要角色个性必须通过动作、对话、反应体现，不能只靠旁白直述。",
+              "evaluation_hint": "若个性结论只存在于解说句，没有行为证据支撑，则判 fail。"
+            },
+            {
+              "id": "cp_appears",
+              "requirement": "CP 必须在第二章前后形成可感知互动或强关联线索。",
+              "evaluation_hint": "若第二章仍没有 CP 本人、互动或强关系推进，则判 fail。"
+            },
+            {
+              "id": "emotional_tone_established",
+              "requirement": "情感基调必须清晰建立（拉扯、暧昧、压迫、治愈等至少一种）。",
+              "evaluation_hint": "若读者无法感知情感走向，只剩事件流水账，则判 fail。"
+            },
+            {
+              "id": "style_naturalness_min_score",
+              "requirement": "style_naturalness 评分必须 >= 3.5。",
+              "evaluation_hint": "若文风生硬、腔调重、人物情绪不贴身，则判 fail。",
+              "threshold": { "metric": "scores.style_naturalness.score", "operator": ">=", "value": 3.5 }
+            }
+          ],
+          "notes": ["第二章要让关系张力继续升温，而不是只做剧情搬运。"]
+        },
+        "3": {
+          "gates": [
+            {
+              "id": "personality_through_behavior",
+              "requirement": "主要角色个性必须通过动作、对话、反应体现，不能只靠旁白直述。",
+              "evaluation_hint": "若个性结论只存在于解说句，没有行为证据支撑，则判 fail。"
+            },
+            {
+              "id": "cp_appears",
+              "requirement": "CP 必须在第三章前建立稳定存在感。",
+              "evaluation_hint": "若第三章后感情主轴仍无明确关系对象或对象存在感极弱，则判 fail。"
+            },
+            {
+              "id": "emotional_tone_established",
+              "requirement": "情感基调必须清晰建立（拉扯、暧昧、压迫、治愈等至少一种）。",
+              "evaluation_hint": "若读者无法感知情感走向，只剩事件流水账，则判 fail。"
+            },
+            {
+              "id": "style_naturalness_min_score",
+              "requirement": "style_naturalness 评分必须 >= 3.5。",
+              "evaluation_hint": "若文风生硬、腔调重、人物情绪不贴身，则判 fail。",
+              "threshold": { "metric": "scores.style_naturalness.score", "operator": ">=", "value": 3.5 }
+            }
+          ],
+          "notes": ["第三章要让关系方向和情绪回报预期都站住。"]
+        }
+      }
+    }
+  },
+  "invalid_combinations": [
+    {
+      "genre": "slow_burn_literary",
+      "platform": "fanqie",
+      "warning": "番茄对慢热纯文学开篇容忍度较低，需尽快补足冲突与爽点反馈。"
+    },
+    {
+      "genre": "male_power_fantasy",
+      "platform": "jinjiang",
+      "warning": "晋江对单线男性爽文天然不占优势，建议提前明确关系张力与情绪卖点。"
+    },
+    {
+      "genre": "pure_romance_slice_of_life",
+      "platform": "qidian",
+      "warning": "起点对纯日常恋爱开篇要求更强的世界差异点或主线承诺，需防止留存不足。"
+    }
+  ]
+}

package/templates/novel-ask/example.question.json

@@ -5,12 +5,13 @@
     {
       "id": "platform",
       "header": "Platform",
-      "question": "Choose your target platform.",
+      "question": "Choose your target platform. Legacy \"tomato\" remains accepted for existing projects.",
       "kind": "single_choice",
       "required": true,
       "options": [
         { "label": "qidian", "description": "Qidian / 起点中文网" },
-        { "label": "tomato", "description": "Tomato / 番茄小说" }
+        { "label": "fanqie", "description": "Fanqie / 番茄小说" },
+        { "label": "jinjiang", "description": "Jinjiang / 晋江文学城" }
       ],
       "default": "qidian"
     },