盗墓小说生成器

> 把「写一篇经得起推敲的盗墓探险小说」落成可验收的生产线：先立世界观与行规，再定人物与关系，再设计墓冢与机关链，然后拟分章大纲，最后才逐章落笔。
> 设定台账未过、人物关系未锁、墓冢机关未定，不写正文；大纲未获确认不动笔；正文未过自检不交稿。

本技能与「古典小说生成器」「悬疑小说生成器」「科幻小说生成器」并列，专供盗墓探险品类。它的核心差异只有一句话：盗墓的惊悚感来自「未知 + 规矩 + 代价」的三角——越是写实的器物、风水、行规，越能托起越离奇的墓下世界；含糊的机关、没来由的灵异、随意漂移的人设，一律不算通过。

零、铁律（任何情况下不可违反）

1. 模仿只仿笔法，不抄专名——只仿叙事节奏、语言气质、视角与信息释放方式；禁止沿用目标作者的专有人名（吴邪、张起灵、王胖子、胡八一、Shirley 杨、大金牙）、专有地名（七星鲁王宫、精绝古城、云顶天宫）、专有物件与具体情节结构。仿的是「味道」，不是「配方」。
2. 机关必须可破解、有逻辑——每处机关都要有触发条件、运作机理、破解之道（风水/技艺/器物/代价），不得用「突然塌了」「莫名其妙开了」式的机械降神收尾。
3. 灵异服从基调——写实 基调里灵异现象必须最终落到可解释的机理（机关、毒气、心理、光影）；灵异/惊悚 基调才允许真·超自然；基调未定按 悬疑 处理并标注 [推断]。
4. 人设三件套锁死——主角姓名、性格锚点、特长、身世四要素在 00-brief.md 定稿后即登记 99-ledger.md，后文只许引用、不许漂移；改名改设定须全稿同步。
5. 每章三要素不可省——每章必须有 ## 第N章 章名 标题、悬念开篇、与章末 <!-- HOOK: ... --> 钩子标记；缺任一项按不合格处理。
6. 行规即约束——倒斗门派规矩（如「人点烛，鬼吹灯」「鸡鸣灯灭不摸金」）既是风味，也是限制；引用时必须写清其代价与失效条件，不得只当口头禅。
7. 设定台账制——所有专名、墓名、地名、组织、术语、器物首次出现即登记 99-ledger.md；后文数值与称谓只许引用、不许另立。
8. 安全约束——不写可被直接复现的真实盗掘技术细节（具体爆破、真实未公开遗址的精确坐标、可复制的文物破坏手法）；把「怎么挖开」改成「挖开之后面对什么」。涉及真实文物/遗址须声明虚构。
9. 地域规范——中国香港、中国台湾、中国澳门按规范称谓；国家与地区称谓无歧义。
10. 文本净度——正文禁用本环境禁用的破折号「——」，不得混入无端外文碎片；连写必跑 scripts/check_text.py。

一、何时使用

出现下列任一情形即启用本技能：

• 点名盗墓品类或母题：「盗墓小说」「倒斗」「下斗」「摸金校尉」「古墓探险」「风水秘术」「墓中机关」
• 点名目标作家风格：「用南派三叔的笔法」「鬼吹灯那种风水博物味」「蔡骏式都市灵异」
• 要求输出盗墓设定档案：世界观行规、四大门派、风水黑话、古墓机关库、人物关系图
• 要求分章大纲与逐章正文，并保证人物/设定前后一致
• 要求对既有盗墓草稿做一致性体检（走 §八，可只查不改）

不适用：纯武侠/玄幻修仙（不走本技能，避免与「写实器物 + 行规约束」冲突）；纯历史考据文（可用，但去掉虚构探险线）。

二、参数采集（第一步，必做）

采集下列 9 项。用户未给出的项按默认值推断并标注 [推断]，不要反复追问——缺什么就替他做合理决定，写进卷头标注块。

tone 与 author 联动：灵异/惊悚 偏天下霸唱的志怪纵深或蔡骏都市灵异；悬疑/写实 偏南派三叔的第一人称密网。混融规则见 §四。

初始化项目脚手架（推荐中长篇用）：

python scripts/new_work.py --title "《书名》" --tone suspense \
  --hero-name "姓名" --hero-trait "性格" --hero-skill "特长" --hero-background "身世" \
  --era "现代" --author "南派三叔" --tomb "明代藩王地宫" --chapters 12 --words 3000 \
  --out ./my-tomb

生成 00-brief.md、01-worldbuilding.md、02-characters.md、03-tomb.md、04-outline.md、chapters/、99-ledger.md。

需要全新世界观素材时（用户要求「新黑话/新机关/新门派」「参考神话、野史、历史文学生成世界观」），追加 --source 或 --root：

python scripts/new_work.py --title "《书名》" --tone suspense \
  --hero-name "姓名" --hero-trait "性格" --hero-skill "特长" --hero-background "身世" \
  --era "现代" --author "南派三叔" --tomb "明代藩王地宫" \
  --source 神话 --lore-count 10 --out ./my-tomb
# 或指定母题：--root bazhen（八阵图）｜--root zhulong（烛龙·建木）｜--root shuihu（水浒绿林）……
# 列全部母题：python scripts/generate_lore.py --list-roots

该参数会额外写入 05-lore.md——围绕单一母题（神话/野史/历史文学/全球神话/全球野史/历史传记其一）程序化派生出的新风水黑话、新机关类型、新灵异图谱、新历代墓葬、新门派行规与代价，全部互不冲突、彼此呼应（详见 §1.5 与 scripts/generate_lore.py）。

需要全球环游 / 环球遗迹 / 古墓丽影·神秘海域风格时，追加 --setting global 与全球类来源：

# 全球环游 + 古墓丽影风格 + 全球神话母题
python scripts/new_work.py --title "《失落王陵》" --tone adventure \
  --hero-name "凌溯" --hero-trait "冷静自信、身手利落" --hero-skill "考古解谜" --hero-background "世家探险者" \
  --era "当代" --author "古墓丽影" --setting global \
  --source 全球神话 --lore-count 10 --out ./my-tomb
# 神秘海域风格：--author 神秘海域（会自动 global）
# 指定全球母题：--root osiris（奥西里斯）｜--root atlantis（亚特兰蒂斯）｜--root templar（圣殿骑士团）……

开启「系列续作模式」（从已完成作品续写，自动承袭人物/世界观/未收线索），追加 --prequel 并建议带上 --series-name／--book：

python scripts/continue_series.py \
  --prequel "淮水镇龙-无支祁秘葬.md" \        # 前作：脚手架目录 或 .md 手稿
  --title "《淮水镇龙：阙心归航》" \
  --series-name "淮水镇龙" --book 2 \
  --tone suspense --author "南派三叔" \
  --chapters 10 --words 4500 --out ./seq2
# 也可用 new_work.py 显式加 --prequel；continue_series.py 是其薄封装（强制 --prequel）

--prequel 会让 new_work.py 在生成脚手架后调用 series_tool.build_continuity()：从前作抽取人物（姓名/性格/特长/身世）、世界观（门派/术语）、未收线索，生成新项目 06-series.md（系列圣经），并以幂等标记回填 00-brief.md（系列信息）/ 01-worldbuilding.md（前作世界观延续）/ 02-characters.md（前作延续人物），保证续作与前作剧情连贯不漂移（详见 §五·阶段 0.5 系列续作衔接）。

三、盗墓创作硬约束

3.1 题材基调与灵异分档

3.2 机关设计四要点（强制）

每处墓中机关/险境必须给出：

1. 触发条件——什么会启动它（踩中地砖、抽走烛火、误读卦象、扰动水银、时辰错位）。
2. 运作机理——它靠什么生效（积沙积石自重、机弩蓄力、汞蒸气挥发、悬魂梯的视觉错构、镜像迷宫的光路）。
3. 可观测征兆——人物能在触发前/中读到什么（风声、尘落、灯焰异动、石刻移位、气味）。
4. 破解之道与代价——如何过（分金定穴的定位、黑驴蹄子镇尸、倒斗技艺、器物诱发的取舍），以及付出的代价（伤、失、时、信）。

禁止「机关自己就好了」「主角光环直接过」。机关越精巧，越要用行规与器物去解，越显专业。

3.3 古墓场景描写五感法

每处关键场景（墓道、耳室、主墓室、地宫、深渊）至少落到四感：

• 光：火折子/手电/烛焰在材质上的反射；黑暗的「触感」。
• 声：脚步回响、机括脆响、水声、风穿甬道、静到耳鸣。
• 气：霉土、朱砂、水银、腐木、尸蜡、陈香的混合气味；气压与闷塞。
• 触/温：石壁潮冷、青铜锈涩、地下河的刺骨、沙的流动。
• 视觉尺度：用人物/器物作尺度参照（火光半径、甬道容几人、棺椁尺度），让「宏大/压迫」可感而非形容词。

术语与器物查 references/tomb-mechanics.md（风水寻龙、倒斗黑话、机关类型、灵异图谱、历代墓葬特征）。

3.4 安全与版权护栏

• 不写可复现的真实盗掘技术细节；真实遗址/文物须声明虚构（附录 D）。
• 只仿笔法不抄专名（铁律 1）；灵感来自公开出版作品的通行叙事气质，不复制具体情节与人物。
• 不影射在世真实人物为负面原型；暴力与尸变可写惨烈，不渲染施虐快感、不写露骨性描写。

四、风格库速查（详见 references/author-style-library.md）

混融规则：主X辅Y 时，X 决定叙事节奏与语言气质（占 ~75%），Y 只影响信息释放方式与母题偏好（~25%）；禁止等量混合两种语言气质，那会写成四不像。写作前后各核对一次节奏契约。

五、工作流程（八阶段，第 8 阶段为导出）

阶段 0 · 定参。 确认 §二 的 9 项，产出 00-brief.md（或对话上方的「创作参数」区块）。有歧义时用一句简短提问（每轮最多问一组），用户不回应即按推断值推进。

阶段 0.5 · 系列续作衔接（可选）。 当用户要求「写系列续作 / 接着前作 / 第二部」，在 new_work.py/continue_series.py 加 --prequel <前作路径>：
- 前作可为脚手架目录（02-characters.md/01-worldbuilding.md/99-ledger.md）或单文件 .md 手稿（如《淮水镇龙：无支祁秘葬》）。
- 脚本调 series_tool.extract_prequel() 抽取：人物（H3 子标题 ### 姓名（外号）· 职能 与 - 姓名｜描述）、世界观（门派/术语，从 H3 含门派关键词子标题与段标题抽取）、未收线索（伏笔状态表/悬念清单 bullet，状态含待埋/未收/悬等）。
- 生成新项目 06-series.md（6.1 系列信息／6.2 延续人物表／6.3 世界观延续／6.4 前作未收线索承接表／6.5 连贯性约束铁律），并以 <!-- SERIES-CONTINUITY-START/END --> 幂等标记回填 00-brief.md（系列信息段）、01-worldbuilding.md（前作世界观延续段）、02-characters.md（前作延续人物段）。
- 之后正常走阶段 1~6，但人物与世界观起点已是「前作延续态」，续作须主动承接 06-series.md 的未收线索、不漂移人设、不与前作已回收伏笔矛盾。
- 仅探查抽取结果（不生成项目）：python scripts/series_tool.py extract --prequel <前作>。

阶段 1 · 立世界观与行规。 产出 01-worldbuilding.md：
- 选定倒斗门派（摸金/发丘/搬山/卸岭，或自创），写清其行规、禁忌、信物、专长与代价。
- 时代与地域底座（决定可用器物、风水流派、历史纵深）。
- 黑话词表与「做不到什么」（限制比能力更能体现真实感）。
- 博物/历史骨架（朝代墓葬特征、文物器型、断代常识）。

阶段 1.5 · 生成新世界观素材（可选强化）。 当用户要求「新世界观/新黑话/新机关/新门派」「参考神话·野史·历史文学·全球神话·全球野史·历史传记」时，运行 scripts/generate_lore.py（或在 new_work.py 加 --source/--root）产出 05-lore.md：
- 该文件围绕单一母题派生新素材，母题取自六类公开古籍/小说/传记/传说体系——神话（山海经、楚辞九歌、淮南子、搜神记、封神演义）、野史（酉阳杂俎、洛阳伽蓝记、拾遗记、万历野获编）、历史文学（史记游侠、唐传奇剑侠、三国演义八阵图、水浒传绿林）、全球神话（埃及奥西里斯、希腊米诺斯迷宫、北欧世界树、玛雅希巴尔巴、苏美尔吉尔伽美什）、全球野史（亚特兰蒂斯、圣殿骑士团、黄金国、香巴拉）、历史传记（克娄巴特拉、成吉思汗、马可·波罗、宾厄姆），共 26 个预置母题，可随机或指定。
- 输出含八节：① 新风水黑话（母题词×方法后缀组合，每次全新）、② 新机关类型（通用模板×母题词，自带触发/机理/征兆/破解+代价四要点）、③ 新灵异图谱（写实解释＋真·超自然双栏）、④ 新历代墓葬、⑤ 新门派行规与代价（信物/行规/专长/代价/禁忌）、⑥ 各国对应机关（可虚构）——按 --country 聚焦单一文明（如 --country 埃及），或留空出覆盖 13 个文明的全球总览；每条机关扎根该国考古/神话母题、可虚构演绎，便于全球环游时按站点取用差异化陷阱。⑦ 各国对应门派——与第七节一一对应，每个文明配一支守墓/寻宝势力（信物/行规/专长/代价/禁忌），同样按 --country 聚焦或全球总览；写作时一站一机关、一站一门派成套取用。
- 全球设定联动：当 setting=global（或风格为古墓丽影/神秘海域），05-lore.md 优先取全球类母题，其墓葬/门派即「海外遗迹/国际寻宝谱系」，与新 §1.6 全球行动底座共同撑起跨文明寻迹；神话母题按「可解的精巧机关/几何」处理（契合 tr/uc 的考古谜题气质）。
- 写作时把 05-lore.md 的专名、机关、门派当作合法设定源，首次出现即登记 99-ledger.md，后文只引用不另立（铁律 7）。
- 同 --seed 可复现；不指定则按书名+来源派生稳定种子。

python scripts/generate_lore.py --source 神话 --title "《书名》" --out ./my-tomb
python scripts/generate_lore.py --root bazhen --tone 写实 --count 10

阶段 2 · 立人物与关系。 产出 02-characters.md：
- 主角四要素（姓名/性格锚点/特长/身世）+ 团队（铁三角则另 2 人，写明职能互补：如「思路型＋武力/技术型＋情报/器物型」）。
- 对手/长辈/墓主残影等次要人物。
- 人物关系图（Mermaid + ASCII 备选）与「关系演变弧」。
- 每人写「说话方式」与「决策逻辑」，供后文一致性核对。

阶段 3 · 设计墓冢与机关链。 产出 03-tomb.md：
- 墓主背景、年代、地域、营造动机（与主角身世可形成呼应/伏笔）。
- 墓室结构序列（墓道→耳室→前室→主墓室→地宫→更深处），每层的功能与氛围。
- 机关链：按 §三·2 四要点逐处登记（触发/机理/征兆/破解+代价），并标注威胁升级曲线（环境→机关→活物→超自然→身世）。
- 灵异设定档（服从 §三·1 基调分档）。

阶段 4 · 拟分章大纲。 产出 04-outline.md，每章 3–6 行：章名、视角人物、核心事件、出现的机关/灵异/设定、章末钩子、伏笔登记。同时给出：
- 全篇结构模型（闯关递进／悬疑解谜／身世揭秘三线的交织比例）
- 信息释放表（哪章抛谜、哪章回收）
- 章数与字数配额（须与 chapters/words 对上）

阶段 5 · 落笔前自检。 大纲 ↔ 世界观 ↔ 人物 ↔ 墓冢 四方对照：每章是否有事发生、机关是否被使用、伏笔是否有回收位、参数是否与台账一致、每处灵异是否服从基调。未过不落笔。

阶段 6 · 逐章正文。 一次写一章，严格按 §六 输出格式（悬念开篇 → 递进冒险 → 机关/场景描写 → 悬念收尾 + <!-- HOOK -->）。写完立刻更新 99-ledger.md：新专名、新设定、用掉的伏笔、人物状态。长篇每批不超过两章，写完即落盘、即更新台账。

阶段 7 · 交稿自检、汇编与交付。 按 §七 逐条打勾；跑：

python scripts/consistency_lint.py ./my-tomb   # 结构：标题/钩子/台账/破折号/专名覆盖
python scripts/check_text.py ./my-tomb          # 字面：混字/混语/破折号
# 汇编全本（chapters/ 各章 → 单文件 manuscript.md；--with-frontmatter 一并汇入设定附录）
python scripts/assemble.py --input ./my-tomb --with-frontmatter
# 出 docx + pdf（导出前自检由上面的两个体检脚本承担）
python scripts/export.py --input ./my-tomb --format all --out ./my-tomb/dist

• 全本导出两种入参：① 目录模式 --input ./my-tomb（脚本自动按 chapters/第NN章.md 汇编）；② 单文件模式 --input ./my-tomb/manuscript.md（先把 assemble 产物交来）。两者都生成 《书名》.docx 与 《书名》.pdf，带封面、目次、分页。
• 系列署名：若属系列第 N 部，加 --series "系列名" --book N，封面会印「《系列名》第N部」、目次只收 第N章 级章回（不收正文前的设定附录小节），设定附录（--include-workfiles 或 assemble 的 --with-frontmatter）不进目次也不强制分页。
• 用 present_files 呈现 .docx 与 .pdf，并在回复中给出绝对路径。

阶段 8 · 一致性体检（可选，仅当 §八）。 用户说「检查/体检」时，对既有稿件跑一致性核查，输出《体检报告》与修改建议，不重写正文，除非用户要求。

六、输出格式契约

6.1 全篇交付结构（固定顺序）

【创作参数】题材基调 / 主辅风格 / 篇幅 / 时代背景 / 主角四要素 / 目标古墓
【卷头标注】其余推断项加 [推断]

一、世界观与行规设定
  1.1 倒斗门派与行规（信物/禁忌/代价）
  1.2 时代·地域底座
  1.3 黑话词表与「做不到什么」
  1.4 博物/历史骨架（朝代墓葬特征、断代常识）

二、人物与关系
  2.1 人物卡（主角四要素 + 团队 + 次要人物）
  2.2 人物关系图（Mermaid + ASCII）
  2.3 关系演变弧

三、墓冢与机关链
  3.1 墓主背景与营造动机
  3.2 墓室结构序列
  3.3 机关链（触发/机理/征兆/破解+代价）
  3.4 灵异设定档（服从基调分档）

四、分章大纲
  4.1 结构模型与三线交织
  4.2 章表（章名/视角/事件/机关·灵异·设定/钩子/伏笔）
  4.3 信息释放表

五、正文（按章输出，格式见 6.2）

附录 A 术语表（风水/黑话/器物，含首次出现章）
附录 B 设定台账索引（与 99-ledger.md 对应）
附录 C 虚构声明（真实文物/遗址的虚构处理）

6.2 单章格式

## 第N章 章名

（正文。不写提纲、不加方括号注记。开头即悬念，结尾留钩子。）

> 【机关·原理】……   /   > 【风水·注】……   （可选：专业注解，按基调密度）

<!-- HOOK: 类型 | 一句话钩子 | 指向伏笔/线索编号 -->

排版规则：
- 专业注解用 Markdown 引用块 > 呈现（盗墓笔法里的「行家注」），紧贴它支撑的叙事之后；基调偏写实时密度高，偏灵异时密度低。
- 数值（尺度、年代、距离）带单位或明确参照；朝代用公元/年号并注。
- 正文不出现「作者按」「这里解释一下」之类出戏插话；专业内容由人物对话、器物、铭文承载。
- 章末 <!-- HOOK --> 标记是给创作者看的，导出时剥离（读者版不该出现）。

6.3 语气与文笔要求

• 语言气质服从 author 契约（§四）；> 【…】 注解块用中性说明文体，与正文风格分离。
• 盗墓的「真实感」来自器物、风水、行规的具体，不是术语堆砌。术语密度以不阻碍阅读为上限。
• 第一人称（san/ba）要有「我」的声口与局限；第三人称（cai/wei/wu）要有可靠的限知视角。

七、质量检查清单（速查；详版见 references/qa-checklist.md）

A. 一致性（权重最高）
1. 主角四要素（姓名/性格/特长/身世）是否与 99-ledger.md 一致，有无漂移？
2. 人物关系图与正文行为是否对得上？关系演变是否有弧？
3. 专名（人物/地名/墓名/组织/术语/器物）是否与台账一致，有无漏登记或另立？
4. 伏笔是否在前文埋下、在后文回收？有无未回收的悬空钩子？
5. 墓冢机关链的「威胁升级曲线」是否贯穿全篇、章章有推进？

B. 结构
6. 每章是否有 ## 第N章 章名 标题？
7. 每章是否有章末 <!-- HOOK: ... --> 钩子？钩子是否真制造悬念（新威胁/新谜团/反转/视角切换）？
8. 每章是否有「悬念开篇」？开篇是否抛异常/谜团/危机？

C. 机关与场景
9. 每处机关是否给全 §三·2 四要点（触发/机理/征兆/破解+代价）？有无机械降神？
10. 关键场景是否落到 ≥3 种感官 + 尺度参照？「宏大/压迫」是否可感？
11. 灵异元素是否服从 §三·1 基调分档（写实必给理性解释）？

D. 风格
12. 主风格是否唯一并标注？混融比例是否守住 75/25？
13. 语言气质是否符合目标作家契约（抽查开篇/高潮/结尾各一段）？
14. 是否误用目标作者的专有人名/专名/情节结构（版权护栏）？

E. 合规与净度
15. 是否输出可复现的真实盗掘技术细节？（禁止）
16. 真实文物/遗址的虚构处理是否在附录 C 声明？
17. 是否出现破折号「——」或无端外文碎片？（禁止，连写必跑 check_text）

> 一票否决项：人设漂移（A1）、抄袭目标作者专名/情节（D14）、机械降神式机关（C9）、写实基调下无解释的灵异（C11）、章节缺标题或缺钩子（B6/B7）、破折号（E17）。

八、体检模式（对既有稿件）

用户说「检查／体检／看看设定有没有问题」时：

1. 读稿，抽取全部专名与人物状态，建临时台账。
2. python scripts/consistency_lint.py <项目目录> —— 结构：章节标题、章末钩子、台账对照、破折号、专名覆盖、字数。
3. python scripts/check_text.py <项目目录> —— 字面：混字/混语/破折号。
4. 人设专项复核：把主角与主要配角的性格锚点、特长、关系列出，逐章核对行为是否一致；任何「性格突变」「关系无端翻转」按 A1 定级（P0）。
5. 机关链专项复核：把墓冢机关链与正文逐章对照，检查是否「设而未用」「用而无解」「突然失效」；属布景的机关建议补代价或删。
6. 伏笔回收专项：列出全部 <!-- HOOK --> 与大纲伏笔，核对回收位；悬空钩子按 B8 提示。
7. 输出《一致性体检报告》：结论 → 一票否决项 → 分级问题表（P0 崩设定／P1 需改数值／P2 建议润色）→ 逐条修改建议。只给建议，不改稿，除非用户要求。

九、合规与安全

• 盗掘技术：不写可复现的真实盗掘细节（具体爆破参数、真实未公开遗址精确坐标、可复制的文物破坏手法）。把「怎么挖开」改成「挖开之后面对什么」；涉及真实文物/遗址时以「原理概述 + 已公开常识」为限，并在附录 C 声明虚构。
• 现实敏感：不写现实国家、民族、宗教的贬损性设定；国家与地区称谓遵循规范（中国香港、中国台湾、中国澳门）。
• 暴力与灵异：可写惨烈与尸变，但不渲染施虐快感、不写露骨性描写。
• 版权：只仿笔法不抄专名（铁律 1）；灵感来自公开出版作品的通行叙事气质，不复制具体情节与人物。
• 真实人物：引用真实历史人物/考古发现时不得诽谤性虚构；虚构与真实边界写清（附录 C）。

十、资源索引

• 使用说明.md —— 发布用用户指南（安装、快速开始、参数表、FAQ）
• assets/icon.svg —— 技能图标（矢量）
• references/author-style-library.md —— 盗墓名家风格库：南派三叔、天下霸唱 2 主位 + 蔡骏/尾鱼/乌贼扩展位，含风格签名、叙事节奏契约、语言气质、视角、母题偏好、模仿要点与慎用提示、句法样例、混融配方
• references/tomb-mechanics.md —— 古墓机关与风水黑话库（静态基准）：寻龙定穴、倒斗行规黑话、机关类型（流沙/悬魂梯/机弩/积沙积石/水银江河/镜像迷宫…）、灵异图谱（粽子分级/尸变/鬼打墙/阴兵）、历代墓葬特征、博物断代常识
• references/myth-history-seeds.md —— 新素材母题库说明（本土）：13 个预置母题的来源类别（神话/野史/历史文学）、公开古籍出处与可派生素材清单，指导 generate_lore.py 的取用
• references/global-lore-seeds.md —— 新素材母题库说明（全球）：13 个预置母题的来源类别（全球神话/全球野史/历史传记）、公开神话/传说/传记出处与可派生素材清单，配合 setting=global 支撑跨文明寻迹
• references/country-mechanisms.md —— 各国对应机关库说明：lore_seeds.py 中 COUNTRY_MECHANISMS 的设计意图与取用方式（13 个文明，各自扎根真实考古/神话母题、可虚构演绎、按文明差异化避免雷同），指导 generate_lore.py --country 产出 05-lore.md 第七节
• references/worldbuilding.md —— 盗墓世界观（静态四大门派）：摸金/发丘/搬山/卸岭详细设定、行规代价、信物、专长与短板、历史纵深写法；需要与 05-lore.md 的新门派共存时，明写二者关系避免冲突
• references/narrative-craft.md —— 叙事技法：悬念开篇、层层递进冒险、机关与场景五感描写、章末钩子四型、人物一致性、信息释放节奏
• references/qa-checklist.md —— 详版质量检查清单与常见病症对照表（含判断标准与修法）
• scripts/new_work.py —— 生成项目脚手架（00-brief / 01-worldbuilding / 02-characters / 03-tomb / 04-outline / chapters / 99-ledger）；加 --source/--root/--lore-count 时一并生成 05-lore.md；--setting global 启用全球环游（含 §1.6 全球行动底座、海外伙伴默认、tr/uc 风格自动 global）
• scripts/generate_lore.py —— 新世界观素材生成器：按 --source（神话/野史/历史文学/全球神话/全球野史/历史传记/all）或 --root（指定母题）程序化产出 05-lore.md（新黑话/机关/灵异/墓葬/门派）；--country（中国/埃及/希腊/玛雅/印加/波斯/日本/印度/高棉/复活节岛/北欧/美索不达米亚/凯尔特）聚焦第七节的「各国对应机关（可虚构）」，留空出全球总览；--list-roots 列母题，--seed 可复现
• scripts/lore_seeds.py —— generate_lore.py 的母题种子库（26 个 ROOT 的结构化数据，含公开古籍/神话/传说/传记出处与母题词/墓葬/门派）；另含 COUNTRY_MECHANISMS——13 个文明的「各国对应机关」数据（flavor/母题/可虚构 signature 机关），以及 COUNTRY_SECTS——同 13 文明一一对应的「各国对应门派」数据（信物/行规/专长/代价/禁忌），供 05-lore.md 第七、八节使用
• scripts/consistency_lint.py —— 一致性体检：章节标题、章末钩子、台账对照、破折号、专名覆盖、字数统计；有 FAIL 返回码 1
• scripts/check_text.py —— 文本净度检查：混字/混语/破折号（中文感知）
• scripts/export.py —— 导出 Word（.docx）与 PDF（函数体由 _novel-export-kit 底座下推、已内置，可独立分发；标注块为左竖线浅底古风样式）；--include-workfiles 附设定附录（含 05-lore.md）；--series/--book 写系列署名（封印「系列名 第N部」，目次只收章回）
• scripts/assemble.py —— 把脚手架 chapters/第NN章.md（或根目录 第NN章.md）汇成单文件 manuscript.md；--with-frontmatter 把 00~05 设定文件作为正文前「设定附录」汇入（首行 H1→H2，不进目次/不强制分页）；--title 缺省从 00-brief.md 抽首个《书名》；供 export.py 单文件模式直接消费
• scripts/split.py —— assemble.py 的反向操作：把单文件 manuscript.md 按 ## 切分拆回 chapters/第NN章.md（按出现顺序零填充编号）。凡是在 manuscript.md 里统一润色/扩写后、准备跑门禁前，必须先跑它做一次同步，否则 consistency_lint.py / check_text.py 体检的仍是旧稿（假绿）
• scripts/series_tool.py —— 系列续作核心：extract 子命令抽取前作（目录或 .md 手稿）的人物/世界观/未收线索并打印；build 子命令生成 06-series.md（系列圣经）并以幂等标记回填新项目 00/01/02，保证续作承袭前作设定不漂移
• scripts/continue_series.py —— 系列续作便捷入口：对 new_work.py 的薄封装，复用其全部参数并强制 --prequel，一键生成续作脚手架并自动衔接前作（人物/世界观/未收线索）
• scripts/pack.py —— 打包发布：python scripts/pack.py --out ./dist 产出 tomb-raider-novel-generator.zip。先调官方 quick_validate.py 体检，再按黑名单剔除 __pycache__/备份/临时文件，打成「顶层一个技能目录」的标准结构；--skill 可指向任意技能目录。本技能的自包含性由 export.py 内置底座函数体保证，搬走即可用

十一、导出 Word 与 PDF

定稿后（或用户直接要求「给我 Word/PDF」）执行：

# ① 目录模式：脚本自动按 chapters/第NN章.md 汇编并出 docx + pdf
python scripts/export.py --input ./my-tomb --title "《书名》" --author 作者名 --format all --out ./my-tomb/dist

# ② 单文件模式：先把 assemble.py 产物交给 export
python scripts/assemble.py --input ./my-tomb --with-frontmatter
python scripts/export.py --input ./my-tomb/manuscript.md --format all --out ./my-tomb/dist

# 系列第 N 部：封面印「《系列名》第N部」，目次只收章回
python scripts/export.py --input ./my-tomb --series "淮水镇龙" --book 2 --format all --out ./my-tomb/dist

# ③ 在 manuscript.md 里改完稿：必须先拆回 chapters/ 再体检
python scripts/split.py --input ./my-tomb/manuscript.md
python scripts/consistency_lint.py ./my-tomb
python scripts/check_text.py ./my-tomb
python scripts/export.py --input ./my-tomb/manuscript.md --format all --out ./my-tomb/dist

> 双向流水线（务必记住）：chapters/ 与 manuscript.md 是同一稿的两份形态。
> 左→右用 assemble.py，右→左用 split.py。门禁脚本只读 chapters/，
> 所以在 manuscript.md 里改过字之后不跑 split.py，体检结果反映的是旧内容。

两种入参（目录 / 单文件）都生成 《书名》.docx 与 《书名》.pdf，带封面、目次、分页；单文件模式适合「先汇编再统一导出」或把既有手稿一次性成书。建议中长篇走 assemble 汇编 → 单文件导出，便于把设定附录（--with-frontmatter）与正文一起成册。

稿件约定（写正文时即按此落盘，导出零返工）：

# 《书名》            → 封面书名
## 第N章 章名          → 章标题，自动另起一页并汇成目次
### 小节             → 小节标题（不进目次，不强制分页）
> 【机关·原理】…     → 专业注解，渲染为带左侧竖线的引用区
| 表格 |            → 器物/断代表
<!-- HOOK: ... -->   → 章末钩子，导出时剥离

> 注意：目次与强制分页仅针对 第N章 / 序章 / 引子 / 尾声 / 番外 / 外传 / 后记 / 附录 级标题；正文前的设定附录（--with-frontmatter 汇入的 00~05）为 ## 设定附录·… 分节标题，不进目次、不强制分页。

• Word：A4、宋体小四、首行缩进两字、行距 1.6；章标题楷体二号居中自动分页；专业注解仿宋缩进带左竖线古风棕底；页脚页码；自动插入「目　次」页。
• PDF：优先用本机 Chrome/Edge 无头打印，退路为 LibreOffice 转 docx，两者皆无则保留排版好的 HTML 并提示用户「打印 → 另存为 PDF」。任一环节失败都要如实告知用户，不得假装成功。
• 默认不含 00-/01-/02-/03-/04-/99- 工作文件（全是设定/大纲/台账）；要一起导加 --include-workfiles。
• 导出后用 present_files 呈现 .docx 与 .pdf，并在回复中给出绝对路径。