Other skills
Steam Achievement Localizer Skill
A Codex skill for safely localizing Steam achievement schema files, with full parsing, translation, and validation workflow.
GaBoron · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add GaBoron/steam-achievement-localizer-skillAbout this skill
简体中文 | English
Steam Achievement Localizer Skill
当前版本:v1.0.0
用于研究、翻译和验证 Steam UserGameStatsSchema_*.bin 成就文本的 Codex skill。它会无损解析 Binary KeyValues、把源文件中的全部语言放进同一份翻译表,并在可联网时要求补充在线资料,最终只修改指定语言字段。
与相关仓库的分工
- Steam 成就翻译库:保存社区翻译 BIN、索引和投稿流程。准备项目时,本 skill 会联网查询该库;若存在匹配条目,会校验并保存主版本作为参考。
- Steam 成就翻译安装器:负责扫描、预览、安装、备份和恢复;本 skill 生成供其使用的标准 BIN/ZIP。
- 本仓库:负责多语言语境研究、翻译草稿、无损写入、验证,以及生成兼容上述两个仓库的标准 BIN/ZIP。
安装
安装时以 Latest Release 的 steam-achievement-localizer.zip 为内容来源。AI 应下载该资产,并按压缩包内的目录结构完整安装:
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 资产包含:
steam-achievement-localizer/
├── SKILL.md
├── VERSION
├── LICENSE
├── agents/
│ └── openai.yaml
└── scripts/
├── steam_bkv_tool.py
└── steam_localizer/
└── *.py
安装后调用:
使用 $steam-achievement-localizer 翻译这个 Steam 成就 schema。
命令
使用以下运行时命令:
# 可选:查找本机 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。
文件布局
每个游戏和目标语言只使用一个项目目录:
localization/123456-schinese/
├── input/
│ └── UserGameStatsSchema_123456.bin
├── work/
│ ├── manifest.json
│ ├── sources.json
│ ├── translations.csv
│ └── references/
└── final/
├── UserGameStatsSchema_123456.bin