﻿SORACHA 简体中文汉化补丁 v5 — 使用说明
==================================

制作署名：
gemini4argon AI补丁 制作 b站小地a/贴吧赤彩 禁止商用/网赚盘！仅供日语学习使用，请在下载24小时内删除！

【先看这里】
这是汉化补丁，不是游戏本体。请先准备对应版本的日文原版游戏。
补丁内只有差分数据、安装/启动脚本、配套字体及字体代理配置；
没有 SORACHA.exe、原版资源包、影片、音乐或其他完整游戏文件。
安装时会读取你自己的日文原版文件，在本机重建汉化后的数据。

【安装：新用户按这四步】
1. 先退出游戏。建议自行备份游戏目录和存档。
2. 将压缩包里的全部文件解压到 SORACHA.exe 所在的文件夹。
   正确：安装补丁.bat 与 SORACHA.exe 在同一级。
   不要只解压几个文件，也不要再套一层文件夹。
3. 双击“安装补丁.bat”，等待提示“安装完成”。
   安装器会检查原版 SHA256、重建数据并校验输出，自动备份修改前的文件。
   它不会启动游戏，也不会强行关闭正在运行的游戏。
4. 双击“启动游戏.bat”进入游戏。
   请让启动器窗口留在后台，游戏退出后它会自动释放字体资源。

【进阶：补丁与游戏不在同一目录】
在补丁目录打开 PowerShell，执行：
  .\install.ps1 -GameDir 'D:\你的游戏目录'
以后使用游戏目录中的“启动游戏.bat”。
卸载也可以在补丁目录执行：
  .\install.ps1 -GameDir 'D:\你的游戏目录' -Uninstall

【已装过旧汉化补丁】
先关闭游戏，再照新用户步骤操作。
安装器会在游戏根目录、_backup_cn_release 和旧版 _backup_jp 目录中寻找
匹配的日文原版 arc2.nsa 与 nscript.dat。
如果旧备份缺失、损坏或属于不同版本，安装会停止，并保留现有文件。
这时请在完整的匹配日文原版目录安装，别手工改名文件冒充原版。
无需再次运行旧版“强制替换字体(管理员).bat”。

【v5 修订】
- 全文12,188条重新校验：原版控制序列、实际CP932字节边界、显示字符字形及窗口容量。
- 按章节区分A篇24字×4行、B篇28字×3行，教程和片尾另按其窗口核对。
- 修复B篇满洲段的一条长旁白在禁则换行时触及第四行的问题；在完整句末增加一次翻页。
- 只增加必要的分页控制，不删减译文，不改语音标签、剧情命令、选择目标或物理行号。
- 沿用v4等待/速度控制修复，以及v3连字符、音符修复和SORACHA CN4字体。
- 关闭游戏，将本包全部文件解压到游戏目录，重跑安装补丁.bat，再用启动游戏.bat。
- v1至v4可直接升级；只替换启动器不会更新正文。安装器由原版备份重建，不叠加旧差分。
- 保留原存档。若存档位于出错文字中间，先从更早存档或章节入口复测；旧档兼容性未获确认。
- 全章节解锁继续暂停；不修改存档，不由助手启动游戏。实际运行结果仍待玩家实测。

【补丁内容】
- 12,188 条中文文本，沿用本工作区的译文。
- 71 张保留下来的界面汉化图片。
- 标题菜单按钮保持日文原版；已删除的汉化图片不恢复。
- 配套 SORACHA CN4 借码位字体。
- 窗口标题在“天空上的玩具”后完整追加本说明顶部的制作署名。
  标题较长，系统可能按窗口宽度截断视觉显示，但脚本中保存了完整文字。

【字体设置做了什么】
旧 envdata 可能保存 MS Gothic，覆盖脚本中的默认字体。
安装器/启动器只将 envdata 的字体名称改为 SORACHA CN4，保留其他设置。
修改前会生成 envdata.before-cn-font.<编号>.bak。
如果首次安装没有 envdata，则不创建伪造设置文件；脚本默认字体为 SORACHA CN4。
启动器先注册本补丁的字体并核对 GDI 实际字体，再启动游戏。
不新增系统 FontSubstitutes、不改游戏 EXE、不要求管理员装全局字体。
version.dll 与 uif_config.json 沿用原补丁配置；本次未验证目标进程实际加载情况，
不将它们作为字体修正已生效的依据。

【卸载】
1. 退出游戏。
2. 双击“卸载补丁.bat”。
3. 安装器从 _backup_cn_release 恢复安装前的数据、字体配套文件及 envdata。
   安装前不存在的配套文件会移除。备份仍保留，便于核对。
   存档不在补丁修改列表中。
注意：若安装前就有旧汉化，卸载本次补丁会回到旧汉化状态，不一定回到日文。
恢复的是安装前的 envdata，因此安装后调整的音量/显示等设置也会随之回退。
旧版曾写入的全局字体替换不由本次卸载自动删除，避免误删已有系统配置。

【常见问题】
1. “找不到匹配的日文原版”
   版本或文件内容不匹配，或旧备份缺失。请使用对应日文原版重新安装。
   本补丁所需原版 SHA256：
   arc2.nsa / nscript.dat 的准确值见 patch-manifest.json 的 source_sha256。
2. “请先自行关闭游戏”
   正常退出游戏后再运行安装或卸载。
3. 正文仍有籤/塰/識等异体字
   先确认安装成功，再使用游戏目录中的“启动游戏.bat”，别只双击 EXE。
   保留启动器输出和正文截图供排查。本次离线字体校验通过，实际画面仍待确认。
4. PowerShell 提示脚本被阻止
   优先使用随包 BAT，它仅为本次 PowerShell 进程设置 ExecutionPolicy Bypass。
   若文件来自下载，先在压缩包属性中解除锁定后重新解压。
   企业管理策略仍可能限制脚本；保留报错文本供排查。
5. 窗口标题右半段看不到
   这是长标题可能出现的系统显示截断；完整署名已写入脚本，并非漏字。
6. 安装器报错或闪退
   BAT 会暂停显示结果。请记录完整报错，不要反复运行旧版管理员字体脚本。

【验证状态】
已完成原文writer字节往返、全部记录控制/双字节/字体/容量审计、仅一字节分页差异检查、
标题完整回读、原版差分回放SHA256、71图保持及日文标题按钮保留、ZIP白名单检查。
安装/升级/重装/卸载回归另在临时目录进行，假EXE不执行。游戏显示及实际崩溃消除待用户实测。

【启动报错诊断】
启动器会打印并保存日志至 %TEMP%\SORACHA-launch-日期时间.log。
若仍报错，请发完整日志和报错截图，不要只发最后一行。
仅检查、不启动游戏：在游戏目录PowerShell运行 .\启动游戏.ps1 -CheckOnly
CheckOnly会临时注册/释放字体，但不修改envdata、不创建游戏进程。
注意：仅报告某个脚本行号还不足以断定根因，保留完整错误内容供核对。
