Game Localizer

简体中文 | English

Game Localizer 是一套面向游戏文本的本地化流水线，而不是单纯的机器翻译工具。它把资源扫描、翻译记忆、模型辅助翻译、质量检查、人工修订、制品构建和发布收敛到同一套可追踪流程中。

项目于 2026 年 8 月正式开源，但这套工作流并非从开源当月才开始形成，而是源于对《坦克世界》（Mir Tankov）俄服中文本地化的多年持续维护，并将多次真实游戏版本更新中验证过的实践抽象为可复用框架。相关汉化资源与发布元数据继续独立维护在 tanki-i18n-metadata，以便将可自由复用的框架代码与游戏特定内容、发布数据保持边界清晰。

Game Localizer 不把完整资源文件转换成 TM。不同格式由 ResourceAdapter 投影成统一的 TranslationUnit 工作单元，TM 只持久化翻译知识与治理状态；最终仍由对应 Adapter 基于原始资源结构回写译文。详细边界见核心架构与 Adapter 契约。

项目状态

Game Localizer 当前是持续开发中的 pre-1.0 开源项目。仓库已具备跨平台 CI、自动化回归测试、完整 Git 历史密钥扫描、双语文档、示例项目，以及围绕 release / publish 的 QualityGate 与显式人工授权边界。

下一阶段设计按 M8：质量工程、受控智能与客户端产品化组织。M8 不是新的本地化内核：质量工程、可选的 Controlled Intelligence 与 Tauri 产品化是可独立验证的路线。

• 参与贡献
• 安全策略
• 变更记录
• Issue 跟踪

主要能力

• 支持 Gettext PO/MO、ParaTranz JSON 和 Paradox YAML。
• 使用稳定坐标和源文指纹管理 SQLite 翻译记忆。
• 支持 OpenAI-compatible 翻译模型、并发、限流和 tokenizer。
• 提供占位符、术语、源语言残留、过滤与规范化检查。
• 支持可审计的人工修订、失败恢复和增量重建。
• 构建 preview 与经过 QualityGate 的 release 制品。
• 发布到本地目录、GitHub Release、Cloudflare R2 和阿里云 OSS。

文档

完整使用说明已统一到文档站，README 只保留项目入口，避免两套文档内容漂移。

• 在线文档站
• 仓库内文档首页
• 核心架构与 Adapter 契约
• 首次安装
• 使用指南
• project.yaml 配置参考
• TM 与 SQLite

最短启动路径

需要 Python 3.10 或更高版本。Windows PowerShell：

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[all]"
localizer dashboard projects/example/project.yaml --host 127.0.0.1 --port 8080

然后访问 http://127.0.0.1:8080。项目配置、凭据、CLI 工作流、TM 迁移和发布说明以文档站为准。

开发

python -X utf8 -m unittest discover -s tests

文档站使用开源的 Material for MkDocs。本地预览：

python -m pip install -e ".[docs]"
mkdocs serve

当前边界

• 社区平台工作流目前只有配置模型和离线同步组件，尚无在线 API 客户端。
• Web 面板面向本机观测和单人定点修订，不是多人协作审批平台。
• 远端发布需要相应可选依赖与环境凭据；只有显式声明凭据轮换事件时才启用治理拦截。
• M8：质量工程、受控智能与客户端产品化目前是设计提案，各 track 不要求全部实现。

许可证

本项目以自由软件形式按 GNU General Public License v3.0 或任何后续版本发布（SPDX：GPL-3.0-or-later）。第三方依赖和外部资源遵循各自的许可证；完整条款以 LICENSE 为准。