简体中文 | [English](README_EN.md)

# Steam Achievement Localizer Skill

当前版本：`v1.0.0`

用于研究、翻译和验证 Steam `UserGameStatsSchema_*.bin` 成就文本的 Codex skill。它会无损解析 Binary KeyValues、把源文件中的全部语言放进同一份翻译表，并在可联网时要求补充在线资料，最终只修改指定语言字段。

## 与相关仓库的分工

- [Steam 成就翻译库](https://github.com/GaBoron/steam-achievement-translation-library)：保存社区翻译 BIN、索引和投稿流程。准备项目时，本 skill 会联网查询该库；若存在匹配条目，会校验并保存主版本作为参考。 - [Steam 成就翻译安装器](https://github.com/GaBoron/steam-achievement-translation-installer)：负责扫描、预览、安装、备份和恢复；本 skill 生成供其使用的标准 BIN/ZIP。 - 本仓库：负责多语言语境研究、翻译草稿、无损写入、验证，以及生成兼容上述两个仓库的标准 BIN/ZIP。

## 安装

安装时以 [Latest Release](https://github.com/GaBoron/steam-achievement-localizer-skill/releases/latest) 的 `steam-achievement-localizer.zip` 为内容来源。AI 应下载该资产，并按压缩包内的目录结构完整安装：

```text Install $steam-achievement-localizer from the latest GitHub Release asset at https://github.com/GaBoron/steam-achievement-localizer-skill/releases/latest. Use only the files contained in steam-achievement-localizer.zip and preserve its directory structure. ```

Release 资产包含：

```text steam-achievement-localizer/ ├── SKILL.md ├── VERSION ├── LICENSE ├── agents/ │ └── openai.yaml └── scripts/ ├── steam_bkv_tool.py └── steam_localizer/ └── *.py ```

安装后调用：

```text 使用 $steam-achievement-localizer 翻译这个 Steam 成就 schema。 ```

## 命令

使用以下运行时命令：

```powershell # 可选：查找本机 schema python <skill>\scripts\steam_bkv_tool.py find-schema --app-id 123456

# 创建集中式翻译项目，并默认联网查询翻译库 python <skill>\scripts\steam_bkv_tool.py prepare ` --schema "C:\path\UserGameStatsSchema_123456.bin" ` --target-language schinese

# 完成研究和翻译后生成最终文件 python <skill>\scripts\steam_bkv_tool.py apply ` --workspace "localization\123456-schinese" ```

只有确实无法联网或用户明确禁止联网时才给 `prepare` 添加 `--offline`。

## 文件布局

每个游戏和目标语言只使用一个项目目录：

```text localization/123456-schinese/ ├── input/ │ └── UserGameStatsSchema_123456.bin ├── work/ │ ├── manifest.json │ ├── sources.json │ ├── translations.csv │ └── references/ └── final/ ├── UserGameStatsSchema_123456.bin