N0zoM1z0/touhou-solver-th08

# 东方 Project 求解器 这是一个用于原版游戏 TH08 的控制与逆向工程研究工作区。当前的目标是通过物理验证的 Sakuya/Remilia Lunatic Route-2 NMNB，随后是 Extra。 这不是 TH08 的便携式重新实现。该求解器负责感知和控制已发布的 Windows 游戏，同时 native-root replay 和 fail-closed short-prefix 模型提供了更快、受控的迭代。 ## 开始 阅读： 1. [`AGENTS.md`](AGENTS.md) — 代码库与研究契约； 2. [`GOAL.MD`](GOAL.MD) — 主要的物理完成目标； 3. [`START_HERE.md`](START_HERE.md) — 当前的检查点和下一个实验； 4. [`STRATEGY.md`](STRATEGY.md) — 行动权限账本； 5. [`notes/review/TH08_LUNATIC_NMNB_RESEARCH_TASKBOOK.md`](notes/review/TH08_LUNATIC_NMNB_RESEARCH_TASKBOOK.md) — 闭环研究流程。 完整的时间顺序研究日志仍然保留。其他已废弃的历史记录被有意从活跃树中移除；参见 [`ARCHIVE_INDEX.md`](ARCHIVE_INDEX.md) 和 Git 标签 `pre-workspace-prune-20260731`。 ## 当前架构 - `scripts/th08_live_dodge_agent.py` — 实时编排入口。 - `scripts/th08_live/` — 感知、策略、规划传递、trace 和 issue 流。 - `scripts/touhou_control/` — 可复用的规划/控制基元。 - `scripts/th08_runtime/` — TH08 native 布局、快照和探针。 - `scripts/analysis/` — 针对性的差异分析/报告工具。 - `scripts/tools/` — 显式构建以及 native 捕获/搜索入口。 - `native/` — native 解码、危险检测、可行性以及本地 reducer 后端。 - `tests/` — 确定性针对性测试和检查点门控。 - `artifacts/` — 精简的保留证据；原始捕获文件依然被忽略。 推广的物理策略是在 native 感知/解码、布尔可行性、基线本地归约、损失前续偏好以及新的 issue 时证书下的硬性不使用 Bomb 的稳健生存。 native 快照风洞可以从一个 canonical root 分支出原始的 TH08，并且已经找到了一个精确的 H=32 无命中见证。当前的离线战斗/资源模型涵盖了普通射击、敌人受伤/击败、物品拾取、Power 以及强制事件，但它没有实时的计分权威。 ## 研究原则 进展意味着在 native 生存、canonical 首次命中、循环物理命中数或 NMNB 完成度方面获得受控的提升。更多的代码、测试、报告或解码字段只有在能够解除该循环的阻塞时才有用。 使用： `root -> exact repeat -> native branches -> first mismatch -> one general fix -> native confirmation -> focused physical falsifier` 在取得实质性的综合收益后，运行一次全新的完整 Lunatic 路线。不要对单一关卡过拟合，也不要从不同 RNG 的总数据中推断因果关系。 ## 快速验证 ``` PYTHONPATH=scripts python3 -m unittest discover -s tests -p 'test_*.py' ``` native 构建： ``` python3 scripts/tools/build_native_planner.py --target linux python3 scripts/tools/build_native_planner.py --target windows ``` 物理启动仅限用户授权： ``` run_th08_practice_agent.bat --stage 5 run_th08_full_route_agent.bat ``` 有关确切的 Windows UNC 测试加载器、当前证据和操作限制，请参见 [`START_HERE.md`](START_HERE.md)。 ## 许可证 仓库源代码和文档使用 [MIT License](LICENSE)。游戏资产、名称和商标未在此获得许可；参见 [NOTICE.md](NOTICE.md)。 此独立项目与 Team Shanghai Alice 无关。

标签：Python, 云资产清单, 控制系统, 无后门, 机器人学, 游戏自动化, 端点可见性, 逆向工具, 逆向工程