面向 Unity 游戏本地化的可移植 Codex skills 仓库。
在 Codex 中输入:
从 https://github.com/timeance/unity-text-locator.git 拉取并安装 unity-text-locator 和 ainiee-translate,同时安装依赖;如果本机没有 Git,请改用 ZIP 下载。
仓库地址:timeance/unity-text-locator.git。无 Git 时也可直接下载 ZIP 压缩包。
由 Codex 提取并翻译游戏文本:
汉化游戏:<游戏目录>。用 $unity-text-locator Full-Automatic 串联 $ainiee-translate;先确认样稿,再完成回写、字体和运行时验证。允许子代理。
完全无人值守时,把“先确认样稿”替换为“采用模式 C,不中途确认”。
由 Codex 提取文本,译文在外部完成:
提取游戏文本:<游戏目录>。用 $unity-text-locator Semi-Automatic 生成原文 CSV 和 manifest;等待我提供 *_translation.csv 后,再校验、回写、处理字体并做运行时验证。
将所需 skill 复制到 Codex skills 目录:
$repo = "path\to\unity-text-locator"
$codexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $HOME ".codex" }
$skills = Join-Path $codexHome "skills"
Copy-Item (Join-Path $repo "unity-text-locator") $skills -Recurse -Force
Copy-Item (Join-Path $repo "ainiee-translate") $skills -Recurse -Force使用全自动翻译前,另行准备 ainiee-translate 的 Python 环境:
py -3.12 -m venv "$HOME\.venvs\ainiee-translate"
& "$HOME\.venvs\ainiee-translate\Scripts\python.exe" -m pip install -r "$repo\ainiee-translate\requirements.txt"Unity 扫描、写回和字体检查还需要安装 Unity 运行依赖:
py -3.12 -m pip install -r "$repo\unity-text-locator\requirements.txt"unity-text-locator:识别 Unity 文本布局,提取和校验单列 CSV,安全写回 Unity 资源,并诊断 TextMeshPro 字体问题。ainiee-translate:在 coding agent 内执行 AiNiee 风格的术语表、分批翻译、校验和导出流程。
扫描 Unity 结构和运行时
→ 提取按项目命名的单列原文 CSV
→ 外部翻译,或转换为 AiNiee cache 交给 agent 翻译
→ 校验行数、占位符、标签和源文件哈希
→ dry-run 写回
→ 应用写回并保留回滚备份
→ 检查 TMP 字体包并做最小界面 canary
→ 运行时巡查和补丁打包
详细流程由 skill 根据游戏实际结构选择;不要假设所有 Unity 游戏使用相同的资源布局。
仓库不捆绑或指定默认字体二进制。字体必须由使用者合法取得,并针对目标游戏验证:
python unity-text-locator\scripts\inspect_tmp_font_bundle.py path\to\font.bundle --translation-root path\to\translation-output检查结果应同时关注:
- 字体包内部名称、TMP FontAsset 身份和字形覆盖;
- 字体包构建 Unity 版本与目标游戏版本是否兼容;
- 方框来自真正缺字,还是 atlas、material 或采样不兼容;
- 游戏是 Mono 还是 IL2CPP,运行时 fallback 能否安全使用。
不要仅凭“中文覆盖率高”就全局替换。先在单一字体、单一界面做 runtime canary;对话框正常而菜单出现碎框时,优先检查 atlas 与材质兼容,而不是继续堆叠 fallback 字体。
字体替换说明见 font-asset-replacement.md。
- 不提交游戏文件、翻译产物、备份、日志、报告、凭证或机器专用路径。
- 不提交字体二进制;
.gitignore默认排除常见字体格式和本地缓存。 - 不写死用户名、盘符、Unity 项目 PathID、项目哈希或系统安装位置。
- Mono fallback 需要目标游戏可加载兼容程序集;IL2CPP 不应套用 Mono 注入方案。
- GitHub Releases 用于版本说明,不用于重新分发来源或授权不明确的字体。
本仓库使用 GNU AGPL-3.0-only。
ainiee-translate/scripts/ainiee_translate/_vendor/ 包含来自 NEKOparapa/AiNiee 的适配代码;来源与修改说明见 NOTICE 及 vendored notice。