从实际游戏工程出发，记录 Neo Geo Pocket／Color 的研究方法、汉化技术与可复现工具。
这里整理动态调试、文本与字库分析、图块和调色板调查、文本重定位、界面与存档验证， 以及模拟器对照和有声录制的经验，供研究者和 Agent 在新项目中参考。
方法来自《秋之回忆 Pure》和《无限轮回：Cure.》的实际工程。目前两款案例均为 NGPC； NGP 在仓库名中是平台系列统称。方法可供迁移参考，具体编码、地址、字体和资源格式仍需逐游戏确认。
| 你的目标 | 阅读入口 |
|---|---|
| 研究另一款游戏 | 新项目研究路线 → 工作流程 → 动态调试 |
| 查找遇到过的技术问题 | 实际问题、调查与可复用经验 |
| 设计验证与录制方案 | 验证的层级与有声录制 |
| 重建或继续 Pure | Pure 工程入口 → 已确认格式 → 状态与下一步 |
| 了解 Cure 经验 | Cure 案例 |
| 由 Agent 接手 | AGENTS.md，先按任务选择路线 |
| 内容 | 可以复用的部分 | 需要逐游戏确认的部分 |
|---|---|---|
| 动态调试 | 从画面追踪文本读取、绘制、字形和显存写入的方法 | 地址、调用约定、脚本状态与断点 |
| 文本与字库 | 分离文本和控制码、字形去重、最小修改与对照验证 | 编码、控制码、字形尺寸和位排列 |
| 图块与调色板 | 检查多图层、透明色、资源冲突和可见墨迹边界 | 图块分配、调色板占用和场景生命周期 |
| 补丁重建 | ngp_localization/patch.py 的基线哈希、原字节保护和输出哈希检查 |
补丁位置与内容；该工具仅支持等长写入 |
| 字形编解码 | ngp_localization/glyph12.py 的已验证实现可作格式分析案例 |
它是 Pure 的 12×12、18 字节格式，不是平台通用字库格式 |
| 验证与录制 | 分层取证、跨进程存档、双核心对照、帧数与 PCM 样本核对 | 输入序列、断言、核心接口和时间基 |
项目脚本保留在 projects/<game>/。已有工具和案例可运行，不代表新游戏可直接套用，
也不代表已经具备自动识别文本、通用解包或一键汉化能力。
| 案例 | 已有成果 | 当前公开工程范围 |
|---|---|---|
| 秋之回忆 Pure | 冻结菜单 / 开场构建、正文控制和 Flash 布局研究 | P06 构建入口、私有配置接口、文本 / 字形工具和合成测试 |
| 无限轮回：Cure. | 简体中文汉化定稿与正文重定位经验 | 案例说明和方法总结；完整重建工程尚未迁入 |
P06 适配器结合用户本地提示配置，可从日版原件重建已核对的冻结输出。历史构建依赖与回归记录保留，不要求使用者维护两套成品。 正文工具只读取外部私有输入，公开示例全部自造，不附带全文汉化数据或私人项目进度。 工程案例包括跨进程存档、可变长控制操作数、扩容后的 Flash 几何和验证边界， 见 正文重定位工程案例。构建成功不等于全剧情或显示验收通过。
需要 Python 3.11+。原版 ROM 请自行提供，仓库不会查找或下载替代版本。
python -m venv .venv
# 在你的终端激活 .venv 后：
python -m pip install -e ".[pure]"
python -m ngp_localization doctor --rom "/path/to/Memories Off - Pure (Japan).ngc"
python projects/pure/manage.py fonts
python projects/pure/manage.py build --rom "/path/to/Memories Off - Pure (Japan).ngc" --text-config /path/to/private-p06-text.jsonP06 需要使用者已有的私有提示配置；仓库只说明接口，不提供实际游戏字串。
配置结构见 工程案例，其中自造示例不能生成冻结版本。
上述 P06 命令输出在被 Git 忽略的 projects/pure/private/p06/，应得到：
Pure_P06.ngc：可直接启动的 ROM。P06_patch.json：从你自己的 ROM 本地生成的带校验补丁清单，不提交到 Git。
预期 ROM SHA-256：
12ac7406dbb255e20c682fa11c001ffa37cc626830f3b0310e2bb02554995fa7
省略 --version 默认构建 P06，仍必须提供 --text-config。历史 --version p05 仅供回归。
重建不需要 Node.js、MCP 服务或模拟器。运行验证时，按
环境说明 接入已有核心；不要为了 MCP 重新搭建已有环境。
python -m unittest discover -s tests -v
python tools/check_public_tree.pyCI 不需要商业 ROM，也不会运行游戏。它只检查公开工具、语法及公开文件边界。 实际游戏检查结果需要明确记录 ROM 哈希、核心版本、输入序列与截图。
自有代码和说明采用 MIT。字体及字形子集保留 OFL 与原组件许可，见 NOTICE.md。 不包含商业 ROM、原版资源、完整剧情、真实 BIOS、玩家存档、个人云盘链接或环境凭据。
制作署名：千岚之夏 · GitHub：Blueteemo