小说地图构建（novel-map-builder）

把小说里散落在章节、对话、旁白、设定集中的地理信息，整理成可校验、可地图化、可复用的世界地图数据。

本技能的核心不是「画一张好看的图」，而是先建立可验证的空间事实体系，再交给下游去渲染。地图好不好看是第二位，方位是否自洽、成因是否成立才是第一位。

一、适用场景与触发条件

应当使用

> 题材中立声明：《诡秘之主》示例与 guimi-map 实跑只是回归样本，不是模板。凡是只能从该作品反推出来的规则（如"灵界必须与现世重叠"），在文档中都标为可选或给出一般判据；不得把某个题材的设定当成普适地理规律。

不应当使用

• 只问某个地名「在哪一章出现」——这是检索任务，直接用 Grep/阅读。
• 只要求画一张插画风格地图——本技能可产出结构示意 SVG（render_map.py），但不做插画级美术；插画需求转绘图流程。
• 没有任何文本依据，要求「凭空生成一个世界」——可转入原创世界构建流程，但必须把产出标记为原创设定，不得伪装成作品事实。
• 纯文本校对、错别字/标点检查——属校对任务，本技能不处理。
• 只要剧情摘要、人物关系、时间线——不涉及空间结构，走摘要/梳理流程。
• 只想查「某地名出现在哪一章」——属检索任务，直接搜原文。

触发词

小说地图、世界观地图、世界地图构建、梳理小说地理、做世界观地图、整理设定集里的地点、给同人写地图、地理设定抽取、地形体系、位面结构、地图化、设定集地理、世界观梳理、worldbuilding、fiction map。

二、五条核心原则

1. 事实分层，永不混写。
   每条地理结论都要标注证据等级：
   - F1 原文事实：书中有明确描写或明确设定（可给章节/设定集位置）。
   - F2 读者共识：百科、设定整理、读者广泛接受的归纳，原文未必有一句直述。
   - F3 套路推断：基于类型惯例与文本线索的合理补全，必须显式标注，不得写成「原著设定」。
   没有 F3 会寸步难行（多数小说不会写「本大陆位于北纬 30 度」），但把 F3 当 F1 是这类任务最大的失败。

2. 先结构，后细节。
   先定「世界由几层构成、每层有哪些大区、大区之间怎么连通」，再填城市与遗迹。顺序颠倒会导致后期大量返工。

3. 成因必须可校验。
   任何「为什么这里是这样」的解释，都要写成可被反驳的因果链：驱动因子 → 作用介质 → 作用机制 → 可观测地貌 → 剧情功能，并用「校验点」作为第六槽位。链上每一环都要有支撑，不能只写「因为灵气浓郁」。

4. 地图是可计算的数据，不是形容词。
   每个节点要有层级、方位、邻接、所属区域、通行方式。用「极北」「东境」这类相对方位词时，必须能落到统一的坐标系里。

5. 宁缺勿造。
   原文没写、套路也推不出的，标 unknown 并列出「需补证问题」，不要用地名填空。编造一个好听的地名，比留一个空字段危害大得多。

三、方法论骨架：五层抽取模型

L5 成因层  ← 地质 / 气候 / 超自然规则 / 历史灾变 / 人为工程
   ↑ 解释
L4 地点层  ← 圣地·遗迹·禁地·核心城市·要塞·秘境·灾变中心（节点）
   ↑ 聚合
L3 结构层  ← 地块分布·气候带·资源带·势力疆域·交通线·边界与隔绝
   ↑ 归类
L2 地形层  ← 地形族与亚型（高山/荒漠/海域/深渊/浮空/地下/位面裂隙/废土…）
   ↑ 抽取
L1 文本层  ← 章节描写·人物行程·对话·设定集·地图插图·作者访谈

• L1 → L2：把「描写」翻译成「地形类型」，解决同义异名（「黑雾之地」= 污染型禁地）。
• L2 → L3：把地形拼成空间结构，回答「世界怎么组织」。
• L3 → L4：在结构中定位功能节点，回答「哪里重要、为什么重要」。
• L4 → L5：为地貌与地点补成因，回答「为什么会长成这样」。
• 反向校验：L5 的成因必须能解释 L2/L3/L4 的观测特征；解释不了就说明推断错了或原文矛盾。

> 编号说明：上面的 L1–L5 是抽取步骤的五个抽象层；map.json 里的图层是
> L0 位面 → L1 大陆 → L2 区域 → L3 地点 → L4 街区。两套编号含义不同，不要混用。

术语映射层（展示名可换，字段与枚举不变）

不同题材用词差异很大，但数据结构是同一套。map.json 的字段名与枚举值固定不变，只允许在 map.md 的展示名上做映射；自定义词汇写进可选的 meta.term_profile（自由文本，如 "科幻/银河系"）。

> 术语替换只影响可读性，不改变 node_type/terrain_type/evidence_level 的取值。本表覆盖不了的题材，用 T13（未归类）或 T14（星际空间/恒星系统，v1.4.0 新增）表达；仍归不了再用 node_type: unclassified，不要新造枚举。

四、工作流：快速路径与完整路径

A. 快速路径（3 步，首次使用 / 资料稀疏时）

快速路径允许：只有 1 个图层（L2 或 L3）、causes: []、scenic_spots: []、edges 少于节点数。必须做：在 meta.scope 里写 quick，让下游知道这是最小地图而非全量。

升级到完整路径的时机：需要解释「为什么长成这样」（成因链）、需要跨层/跨位面/跨星系、需要把图发给第三方评审。

B. 完整路径（第 0–10 步，共 11 步）

命令速查（在技能根目录下执行，PowerShell 用 ; 不用 &&）：

> 退出码非 0 时先读 [组号] 前缀定位规则（如 [B3] 层级越界、[D2] 证据缺依据），按 04 对应行修复后重跑，不得删规则绕过。

C. 资料稀疏时的降级（低置信度地图）

当作品只有零散地名、没有设定集、或地理描写几乎为零时，不要卡死，也不要编地名，按下面产出「低置信度地图」：

硬性要求：meta.scope 写明「低置信度」；map.md 开头声明「本图证据以 inference/unknown 为主，不可当作官方设定」；每个节点必须有 source 或 basis，写不出就进 unresolved[]。

D. 检查点（不得跳过）

E. 时间紧时的完整路径裁剪

只做 0 → 1 → 3 → 4 → 6 → 7 → 8 → 9：先给层级树 + 10~15 个关键节点 + 方位关系，成因只写最关键 3 条，打卡点可只留 2~3 个。不要跳过第 9 步——没有校验的地图数据，返工成本远高于补做。

五、事实分级与标注规范

四级证据（fact / consensus / inference / unknown）

标注三件套

1. 每个节点/边/成因都带 evidence_level。
2. 每条 F2/F3 结论附 basis（依据是什么：哪条描写、哪个类型惯例）。
3. 交付物开头放一张置信度总表：F1 多少条、F2 多少条、F3 多少条、unknown 多少条。

判定口诀

• 能在原文找到句子 → F1。
• 只能找到「大家都这么说」 → F2。
• 只有「这类小说一般都这样」 → F3。
• 三者都没有 → unknown，进未决清单。

六、输出物一览

> 标记模式语义（--markers）：scenic（默认）只画打卡点，编号 S1/A2/B3 按分级独立计数；all 额外给"没有打卡点的节点"画一个空心圈，圈旁标 n{序号}（序号按节点在 nodes[] 中的先后顺序、只对当前出图可见节点递增，仅作图内对照，不是坐标、也不是打卡点编号）；none 关闭全部标记。空心圈只说明该节点可锚定但暂无打卡内容，不要把它当成 B 级打卡点。

字段定义、坐标约定、图层分级、枚举值见 references/03-输出模板.md。

七、目录导航

八、输出骨架（精简版）

{
  "meta": { "map_id": "...", "work": "...", "scope": "...", "version": "...", "coord_system": "normalized_100" },
  "layers": [ { "layer_id": "L0", "name": "位面层", "parent": null } ],
  "regions": [ { "region_id": "...", "name": "...", "layer_id": "L1", "terrain_type": "...", "parent_region": null } ],
  "nodes": [ { "node_id": "...", "name": "...", "node_type": "capital|city|district|fortress|holy_site|ruin|forbidden_zone|secret_realm|catastrophe_center|hub|institution|landmark|unclassified",
               "region_id": "...", "layer_id": "...", "parent_node": null, "x": 42, "y": 18, "direction": "north",
               "function": "...", "evidence_level": "fact|consensus|inference|unknown", "basis": "..." } ],
  "edges": [ { "edge_id": "...", "from": "...", "to": "...", "edge_type": "road|sea_route|portal|border|tributary|conflict|overlap|route_unknown",
               "bidirectional": true, "cost_note": "...", "evidence_level": "..." } ],
  "causes": [ { "cause_id": "...", "target": "...", "category": "geological|climatic|supernatural|catastrophic|engineered",
                "chain": ["驱动因子", "作用介质", "作用机制", "可观测地貌", "剧情功能"], "evidence_level": "...", "check_points": ["..."] } ],
  "scenic_spots": [ { "spot_id": "...", "name": "...", "node_id": "...", "grade": "S|A|B",
                      "viewpoint": "...", "best_time": "...", "visual_features": "...", "sensory": "...",
                      "atmosphere": "...", "access": "...", "risks": "...", "narrative_role": "...",
                      "tags": ["..."], "evidence_level": "...", "basis": "...", "descriptive_inference": true } ],
  "unresolved": [ { "question": "...", "missing_evidence": "...", "where_to_look": "..." } ]
}

完整字段、枚举与约束见 references/03-输出模板.md。

九、常见失败模式（先看这五条）

失败处理与降级（识别 → 降级 → 留痕）

遇到下列情况按表格执行，不得静默跳过，也不得为了"跑通"删掉检查项：

十、快速调用示例

输入：用 novel-map-builder 梳理《诡秘之主》鲁恩王国及贝克兰德的地理结构，输出 JSON + 地图说明，重点解释贝克兰德雾霾与东区污染的成因。

输出要点：
1. 层级树：位面层（现实世界 / 灵界 / 灰雾之上）→ 大陆层（北大陆）→ 区域层（鲁恩王国、因蒂斯、费内波特…）→ 地点层（贝克兰德、廷根市、神弃之地…）。
2. 节点卡片：贝克兰德（首都 / 工业城邦）、东区（污染型下层区）、神弃之地（灾变中心 / 封印区）。
3. 打卡点：东区煤气灯街巷（S）、圣赛琳娜教堂穹顶（A）、拜亚姆港（A），标 descriptive_inference。
4. 成因链：工业革命 + 非凡特性聚集 + 教会管控 → 雾都气候与阶层空间分异 → 剧情功能（掩盖非凡事件、制造阶级压迫感）。
5. 证据等级：城市与方位 F1/F2；具体污染机制细节 F3 并标注。
6. 校验：方位一致、层级不越界、无编造地名、打卡点锚定有效。
7. 示意图：render_map.py 生成 SVG，带打卡点标记与分级图例。

十一、维护说明

• 新增案例：放入 references/cases/，按类型谱系分文件，不按作者或热度分。
• 修改分类学：同步更新 01 的编号与 03 的 terrain_type 枚举，避免字段漂移。
• 计数只维护一处：校验项总数真值在 map_lint.py 的 CHECK_GROUP_COUNTS，04 开头合计行由 check_consistency.py 比对；字段数真值在 SCENIC_REQUIRED，03 的字段表由同一脚本比对；SKILL.md 不再重复写具体数字，避免改一处漏三处。
• 脚本改动后，用 examples/ 下示例与真实 map.json 回归（应退出码 0），再人为构造反例（parent_node 缺失/成环、overlap 单向、成因链 4 段、打卡点无宿主节点）验证能报错。
• 生成示意图后至少人工检查 F1–F5：图例完整、证据色一致、标签不压盖、免责声明存在、标记避让与归属正确。
• 版本升级时在 SKILL.md frontmatter 更新 version，并在 00-调研来源与置信度.md 记录变更原因。
• 两个脚本各自独立运行（只用标准库、不互相 import），宁可保留少量重复也不拆共享模块：这样任一脚本可被单独复制到别的技能或项目里直接跑。重复逻辑的边界是「JSON 读取 + 证据计数」，其余不应复制。
• 计数一致性自检：改动枚举、检查项或字段表后，必须跑 python scripts/check_consistency.py（退出码 1 即说明文档与代码计数已经漂移）。真值来源只有两处：map_lint.py 的常量/检查项登记表，与 04 开头的合计行；其余文档只写引用方式。