# Stella Sora 国际服简体中文社区启动器

本启动器保留国际服账号、区服、登录 SDK 与官方 CDN，仅补充同版本国服客户端中的简体中文剧情、大厅人物对话气泡和中文字体资源。

## 使用方法

1. 先用 Yostar 官方国际服启动器安装游戏，并完成启动器更新。
2. 完整解压本 ZIP；不要直接在压缩包中运行。
3. 从系统托盘退出官方启动器，然后运行 `StellaSora_EN_Gamelauncher.exe`。
4. Windows 显示 UAC 提示时允许管理员权限。
5. 点击“开始游戏”。首次运行会下载、校验并安装与当前游戏资源严格匹配的汉化包。

启动器会自动读取官方安装记录并扫描各磁盘常用的 Yostar 安装目录。只有仍未识别时才需要手动选择一次。

## 当前验证范围

- 国际服客户端版本：`1.13.0`
- 国际服局内资源版本：`1.13.1.127`（资源清单 `2607301222`）
- 简中剧情：同版本国服官方 `_cn` 脚本，共 502 个文件
- 大厅人物对话：国服官方 `BubbleData`
- 字体修正：将启动与加载界面的 `MiSansLatin` 引用改为客户端已有的完整 `MiSans`
- 启动器版本：`1.9.1-starcn.9`
- 汉化资源版本：`2026.07.31.2`

## 官方更新保护

`StellaSora_Data\data.unity3d` 和 `Persistent_Store\Tables\data.arcx` 只在游戏运行期间临时切换为汉化缓存，游戏退出后恢复官方原件。

启动器还会在切换前校验官方局内资源元数据：

1. 指纹一致时才加载汉化资源。
2. 检测到官方局内更新时，本次自动使用官方文件启动，不加载汉化，避免增量补丁校验失败。
3. 完成官方局内更新后，如果对应汉化资源尚未发布，仍可用官方文件启动游戏。
4. 社区发布匹配资源后，启动器会自动下载新资源，并把旧官方备份移入可恢复的历史目录。
5. 每次点击“开始游戏”前都会先恢复官方文件，避免游戏刚退出时发生启动器校验竞态。

因此无需为了汉化资源反复执行官方启动器的“快速修复”。

## 更新地址

- 汉化资源清单：`https://lyricqv.xyz/stella-cn/manifest-v4.json`
- 启动器更新清单：`https://lyricqv.xyz/stella-launcher/update/manifest.json`

启动器只会安装通过 ZIP 大小、ZIP SHA-256 和逐文件 SHA-256 校验的资源。启动器自更新同样会先下载、校验并备份当前文件，失败时保留回滚数据。

## 备份与还原

- `.starcn\installed.json`：已安装资源版本和校验值
- `.starcn\originals\...`：当前受管理官方文件的备份
- `.starcn\patched\...`：已校验的汉化运行时缓存
- `.starcn\stale\...`：跨版本迁移时保留的旧官方文件与旧资源
- `*.starcn-runtime-original`：仅在游戏运行时存在的官方原件旁路文件
- `.starcn\restored\...`：运行还原脚本后移出的社区资源

退出游戏后运行 `Restore_English.ps1` 可移除社区覆盖并恢复纯官方状态。脚本采用可恢复移动，不会永久删除汉化资源。

## 安全范围

本项目不修改 ACE、游戏 EXE、`GameAssembly.dll`、账号、区服、支付配置或国际服网络端点。

本项目与 Yostar、Stargazer 无隶属关系。游戏、启动器及相关资源版权归原权利人所有；公开分发和使用前，请自行确认当地法律、游戏用户协议及社区规则。
