ToHeart（LVNS3 版）简体中文补丁版 —— 说明
================================================================

一、这是什么
----------------------------------------------------------------
这是给**已经装好日文原版**《To Heart》（LVNS3 引擎版，2003 年 Leaf）用的简体中文补丁。
它只包含"要换掉的文件"，**不含背景音乐音源**（那部分请用你自己的光盘镜像生成，见第四节）。

已经汉化：全部 7,943 条剧本正文、全部界面文字、中文字库、主角默认名字。

二、怎么装
----------------------------------------------------------------
  1. 先确认你已经装好日文原版，并且**能正常启动一次**（这样注册表与存档目录都已就位）。
  2. 把本压缩包里的**全部文件**解压到游戏的安装目录，
     覆盖提示选「是」。
        ★ 游戏安装目录 = 有 LVNS3.exe / LVNS3DAT.PAK 的那个文件夹。
        ★ 覆盖前建议先把整个游戏目录复制一份留底（想还原时直接拷回来）。
  3. 双击「启动游戏.bat」开始游戏。正文与界面应该已经是中文。
  4. 想要背景音乐：看第四节。

  覆盖后目录里应当多出这些文件：
      LVNS3.exe           中文界面 ＋ 免光盘的主程序
      LVNS3DAT.PAK        换掉了内嵌的日文字库（正文缺字就是因为它）
      LVNS3SCN.PAK        中文剧本
      LVNS3_01/02/05.KNJ  中文字库（「字体设置」页读的是这几份）
      winmm.dll           用音频文件代替光驱放 BGM 的代理（见「音频说明」）
      LVNS3.ALB           相册（出厂状态 = 空相册；若你已有进度**不要**覆盖它）
      LVNS3_*.SAV         存档的默认名字层；若你已有存档**不要**覆盖它们
      提取BGM.bat / extract_bgm.ps1        ← 就在游戏目录里，第四节要用
      请读我.txt                            ← 一页纸的速览

  ★ 还有一个 `额外文件\` 文件夹，里面是**可选**的东西，玩游戏不需要它们：
      额外文件\启动游戏.bat / 校验文件.bat / 校验清单_SHA256.txt
                          ← 想用的话，把这三个文件**拉到游戏目录**（与 LVNS3.exe 同级）；
                             `校验文件.bat` 也可以直接在 `额外文件\` 里双击
                             （它会自己去上一级目录校验整包）
      额外文件\AI生成的补丁版说明.txt      ← 就是这个文件（另有 `请读我.txt` 一页速览）
      额外文件\toolchain\                  ← 汉化用的脚本（研究/复核用，见第七节）

三、怎么确认装对了 / 没装坏
----------------------------------------------------------------
  * 双击「校验文件.bat」（在 `额外文件\` 里，或已拉到游戏目录）：显示 OK 说明本包的文件都完整、没被杀毒软件改动过。
  * 进游戏后看标题菜单是不是中文；随便进一段剧情看正文是不是中文。
  * 如果正文是中文但**缺字**（该有的字位置是空白），说明 LVNS3DAT.PAK 没有覆盖成功。

四、想要背景音乐（可选）
----------------------------------------------------------------
原版的 BGM 是**光盘上的 34 条 CD 音轨**，补丁包里没有（音源体积太大，而且属于原盘数据）。
本包附带一个我们自己写的提取程序，用**你自己的光盘镜像**生成：

  1. 双击「提取BGM.bat」；
  2. 把你的镜像文件拖到窗口里（或者提前放到同一个文件夹）。
     支持 .cue ＋ .bin/.img，也支持直接拖 .bin/.img/.mdf/.nrg（会自动扫描轨道）。
     ⛔ ISO（只有数据轨）里没有 CD 音轨，必须用抓轨软件按 **BIN + CUE（RAW）** 导出整张盘。
  3. 它会切出 34 个 WAV 放进 BGM 文件夹，并做一遍成品自检。
     ★ 需要约 **694 MB** 磁盘空间。

  这一步是可选的：不做也能正常玩，只是**没有背景音乐**。
  生成完直接运行 LVNS3.exe 即可（也可以用 `额外文件\` 里的「启动游戏.bat」）。

五、已知问题 / 常见故障
----------------------------------------------------------------
  * **双击没反应，或提示找不到 LVNS3DAT.PAK**
      ⇒ 当前目录不是游戏目录。请用「启动游戏.bat」启动。
  * **杀毒软件报毒 / SmartScreen 拦截**
      ⇒ 本包里的 LVNS3.exe 与 winmm.dll 都是**没有数字签名**的改版文件
        （前者是打过汉化补丁的主程序，后者是「用音频文件代替光驱放 BGM」的代理 DLL）。
        在程序目录里放一个与系统组件同名的 DLL 是杀毒软件的敏感行为，可能被**启发式误报**
        —— 这是这类汉化补丁的通病，不是文件真的有问题。
        可以先双击「校验文件.bat」核对文件与随包清单一致；确认无误后把游戏目录加进白名单。
  * **没有背景音乐**
      ⇒ 正常现象（本包不含音源）。按第四节生成 BGM 即可；
        或者挂上原版光盘玩（本版本会优先使用真光驱）。
  * **画面颜色不正常**
      ⇒ 老游戏，必要时右键 LVNS3.exe →「属性」→「兼容性」，试旧版 Windows 兼容模式。
  * **同一时刻只能开一个**（原版就有单实例限制）。

六、还原成日文原版
----------------------------------------------------------------
  用你装补丁前留的那份备份覆盖回来即可（所以第二节建议先复制一份整个游戏目录）。
  只装过补丁、没有留底的话，用原版安装盘重装一次。

七、附带的工具链代码
----------------------------------------------------------------
  本包 `额外文件\toolchain\` 文件夹里是我们做这次汉化时用到的脚本（重建与复核用），
  给想研究或复核的人参考，**玩游戏不需要它**，删掉不影响游戏。
  里面有说明文件。需要 Python 3.11（部分脚本还需要 numpy）。

八、致谢与免责
----------------------------------------------------------------
  * 本汉化由爱好者制作，**仅供学习交流，请勿用于任何商业用途**。
  * 游戏著作权属于原版权方（Leaf / AQUAPLUS）。请支持正版，并使用你自己合法持有的光盘。
  * 译文为机器翻译（Deepseek-V4.1-Flash）＋ 人工校对整理，难免有不到位的地方，欢迎反馈。
  * 使用本程序造成的一切后果由使用者自负。
