ark_story — 明日方舟剧情文本提取

• 从 Arknights 游戏数据中提取全部剧情文本。
• 按「剧情一览」结构输出为 .txt 文件，并生成按章节合并的「合集版」。
• 感谢彼方飞雪的前期整理以及格式参考。
• 感谢所有提供ArknightsGameResource的项目。

上游数据来源

需要 Arknights 游戏数据，如：ArknightsGameResource

gamedata/
├── excel/                          # 元数据 JSON
│   ├── story_review_table.json     # 场景名称/排序/路径
│   ├── zone_table.json             # 章节名称 + 主线补充实物文本
│   ├── roguelike_topic_table.json  # 集成战略挑战描述/月度小队名称
│   ├── handbook_info_table.json    # 干员档案
│   └── battle_equip_table.json     # 模组文本
├── character_table.json            # 干员名称
├── charword_table.json             # 干员语音
└── story/                          # 剧情文本 DSL
    ├── obt/                        # 主线/集成战略/生息演算/危机合约
    └── activities/                 # 支线/故事集/愚人节

详细的文件级映射和特殊处理说明见 原始资源对应表.md。

输出结构

output/
├── 剧情一览/
│   ├── 主线/           # 18 章
│   ├── 支线/           # 52 章
│   ├── 故事集/         # 21 章
│   ├── 干员密录/       # 377 密录
│   ├── 特殊/
│   │   ├── 00.四月辑录/
│   │   ├── 01.危机合约/
│   │   ├── 02.荷谟伊智境/
│   │   ├── 03.多维合作/
│   │   ├── 04.保全派驻/
│   │   ├── 05.卫戍协议/
│   │   ├── 06.集成战略/  (7 季 + 编录/月度小队/挑战)
│   │   ├── 07.生息演算/  (2 季)
│   │   └── 08.主线补充/  (4 章笔记)
│   └── 干员档案/       # 433 干员
└── 合集版/              # 按章节合并

使用方法

# 默认路径（见 config.py）
python extract_story.py

# 指定路径
python extract_story.py --data /path/to/gamedata --output /path/to/output

# 仅生成合集版（已有剧情一览时）
python scripts/collect.py --overview output/剧情一览 --output output/合集版

路径默认值在 config.py 中配置。

脚本说明

脚本	作用
extract_story.py	入口，协调完整提取流程（剧情 + 干员档案 + 合集版）
scripts/parser.py	剧情 DSL 解析器（[name]/[Dialog]/[Decision]/[Blocker]）
scripts/chapters.py	章节元数据加载（story_review_table / zone_table）
scripts/stories.py	主线/支线/故事集/干员密录提取
scripts/special.py	特殊内容提取（集成战略/生息演算/愚人节/危机合约等） + 映射表
scripts/archives.py	干员档案提取（档案/合同/模组/密录/语音）
scripts/collect.py	合集版生成，从剧情一览目录结构打包
scripts/dist.py	打包剧情一览和合集版为 zip 分发
config.py	数据目录和输出目录的默认路径配置

许可

本项目代码基于 AGPL-3.0 许可发布。

本项目所有静态资源（剧情文本、干员档案等）版权均属于 Arknights / 上海鹰角网络科技有限公司，仅用于学习与交流，如有侵权请联系删除。