GaBoron/steam-achievement-translation-installer

# Steam 成就翻译安装器 一款面向 Windows 10/11 的 Steam 成就翻译管理工具。它可以自动找到本机游戏，从社区翻译库选择合适版本，并安全完成安装、状态检查与恢复。 [](https://github.com/GaBoron/steam-achievement-translation-installer/releases/latest) [](#系统要求) [](LICENSE) ## 下载与安装 请从 [GitHub Releases](https://github.com/GaBoron/steam-achievement-translation-installer/releases/latest) 下载。 下载 `SATLInstaller-Setup-v0.6.1.exe`，运行安装程序，之后从开始菜单打开。 项目只维护安装版，不再发布便携版。 直接覆盖安装新版即可；安装程序会在复制新文件前清理旧版遗留的运行组件。 本项目暂未提供代码签名。Windows SmartScreen 可能首次显示安全提醒；请核对下载来源和 Release 中的 SHA-256 后再运行。 ## 三步开始使用 1. 打开软件，等待它扫描本机 Steam 游戏。 2. 勾选需要翻译的游戏，确认翻译版本。 3. 点击“安装所选”，逐页检查每个游戏即将写入的 BIN 成就表格，再确认执行。 “已管理”页面会显示 SATL 管理的游戏、当前状态和已安装版本。需要撤销时可恢复安装前文件；如果文件之后被其他程序修改，软件会先拒绝普通恢复，只有在你明确确认后才执行强制恢复并归档当前文件。 ## 主要功能 - 自动检测 Steam 目录和本机成就缓存。 - 搜索、批量选择并安装社区翻译。 - 单个或批量安装、恢复前均显示确认弹窗；每页展示一个游戏的 BIN 成就表格，默认显示简体中文，并可切换该 BIN 实际包含的其他语言。 - 支持同一游戏的多个翻译版本。 - 显示已安装版本、正常、缺失或被修改等状态。 - 安装前备份，支持普通恢复和确认后的强制恢复。 - 在线刷新翻译目录，也可使用离线缓存。 - 浅色、深色和跟随系统主题。 - 普通、详尽与临时 Debug 日志，支持保留期限和日志目录管理；日志页只显示最新文件并自动定位到最新内容。 - 记住主窗口上次的大小和位置；首次启动以 1280×720 在屏幕中央显示。 - 从 GitHub Releases 检查新版本，在软件内显示发布说明、下载并校验安装程序，然后打开安装界面。 - 为尚未收录的游戏导出符合仓库要求的原始 schema ZIP，并直达翻译请愿或翻译贡献表单。 - 支持 `Ctrl+A` 全选、`Ctrl+Shift+A` 清除选择、`Shift+左键` 连续选择、`Ctrl+F` 聚焦搜索和 `F5` 刷新。 翻译数据来自 [Steam 成就翻译库](https://github.com/GaBoron/steam-achievement-translation-library)。安装器不会编辑翻译内容，也不会把你的 Steam 文件上传到网络。 ## 翻译请愿 搜索页的“未找到游戏？”按钮会打开翻译库入口： 1. 从 Steam 商店地址中找到 `/app/` 后的数字，并填入 Steam App ID。 2. 点击“导出”，选择保存位置。软件会自动查找原始 `UserGameStatsSchema_.bin`，并生成只含该文件的同名 ZIP。 3. 使用弹窗底部的主按钮“提交翻译请愿”打开翻译库表单，填写游戏名、商店地址和目标语言，再上传刚导出的 ZIP；已完成翻译的投稿入口位于弹窗正文中的“贡献翻译”按钮。 如果你已经完成翻译，请点击“贡献翻译”。投稿文件必须命名为 `UserGameStatsSchema_.zip`，并完整包含表单中声明语言的成就名称和说明。提交前先在翻译库索引中搜索 App ID：未收录游戏使用“提交 Steam 成就翻译”，已收录游戏使用“更新已有 Steam 成就翻译”。翻译库会自动检查 ZIP 结构、Binary KeyValues 字节级 roundtrip、成就 ID 唯一性和语言覆盖。 导出过程不会修改 Steam 文件；写入采用临时文件、内容校验和原子替换，失败时不会留下不完整 ZIP。如果没有找到原始文件，请先启动对应游戏并让 Steam 读取一次成就。 ## 更新检查 - 有新版本时弹出更新窗口，正文显示该 Release 的发布说明，并提供“下载并安装”和“取消”。 - 下载完成后必须通过 Release 中 `SHA256SUMS.txt` 的 SHA-256 校验；随后软件打开安装界面并关闭旧窗口。 - 没有新版本时显示当前已是最新版。 - 不会在后台静默下载；只有用户点击“下载并安装”后才会下载和启动安装程序。 如果无法访问 GitHub，更新检查失败不会影响扫描、安装或恢复功能。 ## 数据与日志 默认数据目录： %LOCALAPPDATA%\SteamAchievementTranslationInstaller\ 这里会保存设置、窗口位置、目录缓存、安装状态、备份、恢复归档和可选运行日志。日志不记录成就文件正文。日志页始终读取最新的一个日志文件并自动滚动到末尾。你可以在设置中关闭日志、调整保留时间，并选择记录级别： - “普通”记录操作结果与错误。 - “详尽”额外记录 CLI 事件。 - “Debug”用于复现软件问题，会逐步记录操作参数、CLI 原始事件、耗时、标准错误和完整异常。它可能包含本机目录、Steam 路径、App ID、游戏名等诊断信息，也会增加日志体积并带来轻微性能开销。 ## 系统要求 - Windows 10 版本 2004（Build 19041）或更高版本，推荐 Windows 11。 - x64 处理器。 - 已安装 Steam；使用离线缓存时可暂时不联网。 发布包包含所需的 .NET、Windows App SDK 与 Python 官方嵌入式运行文件，无需另外安装运行库。 ## 常见问题 ### 没有扫描到游戏 先启动 Steam 和对应游戏一次，让 Steam 生成成就缓存；也可以在设置中手动选择 Steam 目录，然后重新扫描。 ### 安装后翻译消失 Steam 或游戏更新可能重新生成成就缓存。重新扫描后再次安装即可；如果翻译库条目已经过期，请前往翻译库报告。 ### 为什么恢复被拒绝 目标文件在安装后被修改。为避免覆盖其他程序或 Steam 的新数据，普通恢复会停止。确认文件确实可以替换后，再使用带二次确认的强制恢复。 ## 相关项目 - [Steam 成就翻译库](https://github.com/GaBoron/steam-achievement-translation-library)：查找和提交社区翻译数据。 - [Steam Achievement Localizer Skill](https://github.com/GaBoron/steam-achievement-localizer-skill)：使用 Codex 辅助制作与审核翻译。 - [SteamAchievementLocalizer](https://github.com/PanVena/SteamAchievementLocalizer)：本地可视化翻译编辑器。 ## 开发与构建 普通用户不需要执行本节。 开发环境需要 Windows 10/11 x64、Python 3.13、.NET 10 SDK、WinUI 3 工具链和 Inno Setup 6。 python -m venv .venv .\.venv\Scripts\pip.exe install -e ".[dev]" powershell -ExecutionPolicy Bypass -File .\scripts\build.ps1 构建结果位于 `dist\release\`：安装版 EXE 和 `SHA256SUMS.txt`。 ## 许可证 程序代码采用 [MIT License](LICENSE)。第三方组件和翻译数据的权利说明见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。

标签：Steam, 本地化, 桌面软件, 游戏工具, 系统备份, 逆向工具