Skip to content

Repository files navigation

SpaceSim Localizer

简体中文 · English · 下载最新版 · Steam 创意工坊

SpaceSim Localizer

面向 Steam App 4055380 的开源、可逆简体中文汉化工具。当前正式支持 SpaceSim Build 24640309

创意工坊页面用于订阅、收藏和查看更新;实际汉化程序及语言包仍从 GitHub Releases 下载。

玩家使用

小白推荐从 Releases 下载 SpaceSimLocalizer-win-x64.zip 并完整解压,其中已经包含程序和全部语言包。

也可以直接下载单独文件:

把程序和需要的 .sslpack 放进同一文件夹,运行 SpaceSimLocalizer.exe。 工具会自动检测 Steam 游戏目录;选择语言后应用即可,恢复时点击“恢复原版”。

简体中文包为稳定版。日语和法语包目前为预览版,欢迎玩家在 Issue 中提交术语和 语气修正。

v1.1 起,启动器采用紧凑的桌面工具界面,并将“总览”“语言包” “诊断与恢复”分区展示。默认页面只保留玩家最常用的一键操作,外部语言包、 扫描和恢复仍可在对应页面直接使用。语言包列表只显示语言名称,游戏状态统一为 “已汉化”“未汉化”或“不兼容”。右上角可在中文与 English 之间切换,选择会 保存在本机用户配置中。

程序为 .NET 8 自包含单文件,无需安装运行时。首次运行可能出现 Windows SmartScreen 提示;本项目暂未购买代码签名证书,请对照 Release 中的 SHA256SUMS.txt 校验文件。

安全设计

  • 每次都从带 SHA-256 校验的原版缓存生成,不叠加补丁。
  • EXE 译文写入独立 .l10n 节;schema v2 语言包只修改 exe-refs.json 中逐项验证的引用点。
  • 游戏运行、版本未知、引用指纹变化、磁盘写入或验证失败时拒绝替换。
  • 备份位于 %LOCALAPPDATA%\SpaceSimLocalizer\backups
  • AI 翻译只用于维护者初稿,密钥只进入 Windows Credential Manager。

汉化方式

语言包用 translation-methods.json 为每条文本标明处理方式:

  • asset-whole-text:预设说明和更新日志等完整文本文件;
  • asset-visible-json.sim 中明确可见的名称、标题和说明字段;
  • exe-source-ui-only:整个源字符串已确认只供界面使用;
  • exe-reference-scoped:同一英文还被内部逻辑使用,只重定向已审核的界面引用;
  • runtime-display-alias:枚举或存档值保持英文,仅准备独立的界面显示别名;
  • internal-unsupported:协议、脚本、枚举 ID 和内部错误,不应用翻译。

display-aliases.json 将显示译文与 storage_value 分离。例如界面显示“最小”, 但存档仍保存 Minimal。schema v3 通过两个带指纹验证的通用下拉框调用点处理求解器 和历史选项,不修改英文枚举数组或 .sim 数据。

多语言包

启动器会扫描程序目录和 packs 子目录中的全部 .sslpack,按清单中的 localedisplay_name、版本和发布渠道显示语言选择。新增语言无需修改 GUI: 复制语言包后重新检测即可;切换语言仍从同一份原版缓存重新生成游戏文件。

开发与发布

需要 .NET 8 SDK:

dotnet run --project tests\SpaceSimLocalizer.Tests -c Release
.\scripts\build-release.ps1

发布输出位于 artifacts,包括 GUI、CLI、正式 .sslpack、ZIP 和 SHA-256 清单。 CLI 命令见 SpaceSimLocalizer.Cli.exe --help

质量与安全验证数据由维护者通过 CLI 检查,不在玩家启动器中展示。维护中的测试包使用 .\scripts\build-release.ps1 -Prerelease

维护者可使用 deepseek-v4-flash 并行生成候选译文,再由多个独立请求投票复核; 只有一致通过且满足占位符、格式和字体规则的条目才能写回正式 PO。具体命令见 CONTRIBUTING.md。API 密钥只保存在 Windows Credential Manager。

翻译目录:

  • translations/zh-CN:完整审校目录,包含内部字符串,不可直接发布;
  • translations/zh-CN-safe-expanded:Build 24640309 正式安全语言包。

问题反馈请附上工具版本、SpaceSim Build ID、扫描输出和复现页面,不要上传游戏 EXE、 assets.data、Steam 凭据或 API 密钥。

License

Source code is licensed under MIT. Fonts and third-party components retain their own licenses; see THIRD_PARTY_NOTICES.md.

About

Safe reversible SpaceSim localizer | 简体中文 · 日本語 · Français

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages