【Bug】explicit_genre_fallback 下 primary_genre 取了 fallback 行的子流派，导致无关题材桥段注入每章 writing_guidance

[PTAbabybearR]

问题概述

当调用方显式指定 genre、但 query 未命中任何路由行的关键词时，会走 explicit_genre_fallback。
此时生成的 MASTER_SETTING.route.primary_genre 变成了 fallback 行自己的子流派，而不是调用方指定的题材。

以「仙侠」为例：primary_genre 被写成 玄幻退婚流。
连带 base_context 注入了 TR-001「退婚三年之约」，而该条目的 inject_target 是
CHAPTER_BRIEF.writing_guidance —— 意味着此后每一章的写作指导里都会掺进退婚流桥段，
而作品本身与退婚流毫无关系。

影响范围

• Story System / CHAPTER_COMMIT
• Python CLI

触发命令或入口

python -X utf8 "<CLAUDE_PLUGIN_ROOT>/scripts/webnovel.py" --project-root "<PROJECT_ROOT>" story-system "仙侠" --persist

等价于 /webnovel-init 中选择「仙侠」题材后自动执行的路由。

复现步骤

1. 新建项目，题材选择「仙侠」（query 与 genre 均为「仙侠」，不含任何路由行关键词）
2. 执行上面的 story-system ... --persist
3. 查看 .story-system/MASTER_SETTING.json 的 route 段与 base_context

预期行为

primary_genre 应为调用方显式指定的 仙侠，与同一份输出里的 canonical_genre 一致；
base_context 不应注入与该题材无关的桥段条目。

实际行为

"route": {
  "primary_genre": "玄幻退婚流",
  "canonical_genre": "仙侠",
  "route_source": "explicit_genre_fallback",
  "genre_filter": "仙侠"
}

同一个 route 对象里两个字段互相矛盾。base_context 中出现 TR-001「退婚三年之约」。

根因定位

webnovel-writer/scripts/data_modules/story_system_engine.py:192

primary_genre = str(matched.get("题材/流派") or genre or "").strip()

在 fallback 路径下，matched 来自 _fallback_row_for_genre()（同文件 :349），
该函数返回第一个「适用题材」包含目标 genre 的行。

而 references/csv/题材与调性推理.csv 的第一行 GR-001 是：

编号	题材/流派	适用题材	canonical_genre	核心调性	节奏策略
GR-001	玄幻退婚流	玄幻|仙侠	玄幻	先压后爆	三章内必须有首次有效反打

因为「适用题材」含「仙侠」，所以任何 genre=仙侠 且未命中关键词的项目都会命中它，
拿到 玄幻退婚流 作为 primary_genre。同一行还一并带出了 core_tone 与 pacing_strategy。

值得注意的是：canonical_genre 在同一函数 :201-203 已经实现了「显式 genre 优先」的逻辑，
所以它的输出是正确的（仙侠）。primary_genre 只是漏掉了这一步，
这也说明「显式指定优先」本来就是既定设计意图。

为什么现有测试没有发现

test_story_system_falls_back_to_explicit_genre 的 fixture 中，
fallback 行的「题材/流派」恰好等于传入的 genre（都是「现言」），
因此「取行的流派」和「取调用方的 genre」两种实现都能通过，测试无法区分。

运行环境

• 操作系统：Windows 11
• Python 版本：3.12.10
• Claude Code 版本：最新
• 插件版本：6.2.1
• 安装范围：user

使用模型

deepseek-v4-pro 与 claude-opus（两个项目分别使用，与本问题无关——路由是纯 Python 逻辑）

相关文件或状态

• webnovel-writer/scripts/data_modules/story_system_engine.py:192、:349
• webnovel-writer/references/csv/题材与调性推理.csv（GR-001）
• 受影响产物：.story-system/MASTER_SETTING.json、.story-system/MASTER_SETTING.md

补充说明

在我本地两个独立的仙侠题材项目上均复现，输出完全一致（primary_genre / core_tone /
pacing_strategy 三个字段都相同），确认与具体作品内容无关。

inferred_genre_fallback 路径不应一并修改：那条路径下 genre 只是从自由文本猜出来的粗粒度类别，
fallback 行提供的子流派更具体，是有价值的。test_route_infers_canonical_genre_from_spaced_query
已经断言了这个行为（推断出「快穿」时保留行的「快穿任务」），应当保持。

我已准备好修复与回归测试，随后附 PR。

[PTAbabybearR]

补一组实测数据，并指出一处影响范围比 issue 正文更大的地方。

一、注入不只落在 MASTER_SETTING.base_context，还落进每章的运行时合同文件

跑带 --emit-runtime-contracts 的那条命令之后，.story-system/chapters/chapter_00X.json 里 dynamic_context 直接带上了 fallback 行的条目：

{
  "source_trace": [
    { "table": "题材与调性推理", "id": "GR-001", "reason": "explicit_genre_fallback" },
    { "table": "桥段套路", "id": "TR-001", "reason": null }
  ],
  "dynamic_context": [
    { "编号": "TR-001", "分类": "桥段", "关键词": "退婚流|三年之约|弃徒反击|莫欺少年穷" }
  ]
}

这跟 base_context 不是同一份：base_context 可以在下次路由时被覆盖，而合同文件是落盘的，会一直留在 chapters/ 下，直到有人手工去清。

二、更早生成的章，合同里也带着，而且一直没被发现

我们回头查了此前几章已经落盘的合同——每一章的 dynamic_context 里都有同一条 TR-001。

这些合同是下游 write / review 的输入，也就是说这个注入已经影响了此前每一章的写作指导，而没有任何东西会报错。

三、恢复类脚本通常覆盖不到这一层

如果项目自己写了恢复脚本（把 primary_genre 改回、把被清掉的项目约束补回），它多半只修 MASTER_SETTING.json 和 anti_patterns.json，不会去碰 chapters/*.json——我们这边就是这样，所以这一层漏了很久。

四、source_trace 可以直接当清理依据

好消息是定位很干净：受影响的条目在 source_trace 里都带着 reason: "explicit_genre_fallback"。

所以修复侧至少有两个可做的点：

1. 根因：explicit_genre_fallback 时，primary_genre 应取调用方显式指定的题材，而不是 fallback 行自己的子流派（issue 正文已说明）。
2. 兜底：既然 reason 已经标出来了，--emit-runtime-contracts 在写盘前可以把 reason == "explicit_genre_fallback" 的 dynamic_context 条目过滤掉，或者至少不要把它们写进 CHAPTER_BRIEF.writing_guidance——这样即使路由一时修不了，落盘的合同也是干净的。

环境

• Windows / Python 3.12
• 调用方显式指定题材，query 未命中路由行关键词
• 命令带 --persist --emit-runtime-contracts --format both