DragonHD
4.0 KiB
教程汉化交付说明
当前结果（2026-09-20）
用户已确认完整教程及字体修正“没有问题”。本次验收来自用户实机反馈；自动化检查覆盖字节、编码、排版与回滚，不替代实机操作。
- 教程全部 57 处标题、消息正文、任务说明使用 42 条中文映射。
- 范围包括开场、镜头、飞行、高度、攻击、蓄力、吐息、进食、法术、速度控制和结束提示。
- 开场及后续新增页面使用居中短句；此前已验收的镜头说明保留原有格式。
- 句号在 12×12 字格中下移 3 像素，边界由
(2,5,6,9)变为(2,8,6,12)；字宽和其他字符不变。 - 按钮中文与快捷键不再重叠，选项页标题按实际文字宽度居中。
- 原事件、按键绑定、资源路径、等待与判定条件保持原字节。
教程构建
在仓库根目录使用 Python。将路径换为本机位置，Tutorial.original.dsc 必须是保留的原版英文脚本，而非已经汉化的文件。
python tools/script_text.py --source "C:/DragonWork/Tutorial.original.dsc" --mapping tools/tutorial_cn.json --out "C:/DragonWork/build/Tutorial.dsc" --allow-alignment-changes
python tools/verify_tutorial_step1.py modified "C:/DragonWork/Tutorial.original.dsc" "C:/DragonWork/build/Tutorial.dsc"
工具同时生成 Tutorial.manifest.json。验证器沿用早期文件名，目前检查的是完整教程。
| 文件 | SHA256 |
|---|---|
| 原版英文输入 | bd959758223b976ffac35b4ef7d94661f62060c1134316eddb559772d544e02c |
| 完整中文输出 | 720b7fce23b80405d6c8af2a1302ed95c085a072d8c8ecbae49b9db2cb32b8e3 |
默认严格保留控制符；--allow-alignment-changes 仅允许替换同一位置的对齐/缩进控制符，换行顺序及数量仍受检查。原版施法正文两处未转义的 "F" 采用专门识别，不扩大到一般表达式。百分数文字 0% is 与实际格式占位符分别处理。
验证
字体排版测试需要 unicorn，位图测试需要 Pillow；排版测试默认读取已修补的本机游戏程序，路径可通过 tools/test_cjk_layout.py 的 DEFAULT_EXE 统一调整。
$tests = @('test_script_text.py', 'test_tutorial_intro.py', 'test_tutorial_flight.py', 'test_tutorial_complete.py', 'test_cjk_layout.py', 'test_cjk_titles.py', 'test_full_stop.py')
foreach ($test in $tests) {
python "tools/$test"
if ($LASTEXITCODE -ne 0) { throw "Test failed: $test" }
}
最新运行：39 项通过。完整教程校验输出 MODIFIED: all 57 display literals translated; all other bytes unchanged; PASS。新页面在 360/400/480 像素宽度下检查行首标点、中心坐标和总高度。所有中文字符均核对存在于已生成的 GB2312 字库中。
安装与恢复
本次本机安装已经完成；以下步骤用于以后重建。游戏退出后，先备份当前 Data/Scripts/English/Tutorial.dsc，再用生成的同名文件替换。保持已有 CJK 程序补丁、字库及字体表。
恢复教程只需把该次备份复制回相同位置，核对 SHA256；不需要重装字体或重建程序。本次已在独立副本执行恢复，字节与备份一致。最后一批的备份是 E:/DragonHD/backup_game/tutorial-complete-20260920/Tutorial.dsc，内容为已验收的前五组汉化版本。
句号修正通过 tools/fix_full_stop.py --source <原字库.TGA> --cells <cells.json> --out <新字库.TGA> 生成。部署须同步更新松散字库和 Textures.res 的 UI\Overhead\Shrift_gb_Germany.TGA 条目；保留并恢复这两个文件的成对备份。tools/build_cjk.py 已包含相同修正，重新生成字库时不会丢失。
不要为单独更新教程重新执行 install_cjk.py install：它会重建并部署整套程序/字体/字符串文件。
下一阶段
教程已经验收。后续主线汉化或高清素材试作按独立批次推进，尚未在本次启动。历史试作记录见 DEVLOG.md，其中早期“待验收”状态以本说明和最终验收条目为准。