{"id":50416205,"url":"https://github.com/yexi-by/att-mz","last_synced_at":"2026-05-31T06:02:06.493Z","repository":{"id":355053505,"uuid":"1181195607","full_name":"yexi-by/att-mz","owner":"yexi-by","description":"Agent-first Chinese localization toolkit for RPG Maker MV/MZ, built for Codex and Claude Code workflows.","archived":false,"fork":false,"pushed_at":"2026-05-24T11:06:16.000Z","size":22147,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T13:08:00.609Z","etag":null,"topics":["agent","ai-translation","chinese-translation","claude-code","codex","game-localization","openai","rpg-maker","rpg-maker-mv","rpg-maker-mz","translation-tool"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yexi-by.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-13T21:16:29.000Z","updated_at":"2026-05-24T11:06:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/yexi-by/att-mz","commit_stats":null,"previous_names":["yexi-by/rpg-maker-tools","yexi-by/att-mz"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/yexi-by/att-mz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yexi-by%2Fatt-mz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yexi-by%2Fatt-mz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yexi-by%2Fatt-mz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yexi-by%2Fatt-mz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yexi-by","download_url":"https://codeload.github.com/yexi-by/att-mz/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yexi-by%2Fatt-mz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33720897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","ai-translation","chinese-translation","claude-code","codex","game-localization","openai","rpg-maker","rpg-maker-mv","rpg-maker-mz","translation-tool"],"created_at":"2026-05-31T06:02:01.354Z","updated_at":"2026-05-31T06:02:06.483Z","avatar_url":"https://github.com/yexi-by.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://readme-typing-svg.demolab.com?font=Noto+Sans+SC\u0026weight=700\u0026size=36\u0026duration=3000\u0026pause=1000\u0026color=58A6FF\u0026center=true\u0026vCenter=true\u0026width=600\u0026lines=A.T.T+MZ+%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B\" /\u003e\n    \u003cimg src=\"https://readme-typing-svg.demolab.com?font=Noto+Sans+SC\u0026weight=700\u0026size=36\u0026duration=3000\u0026pause=1000\u0026color=0969DA\u0026center=true\u0026vCenter=true\u0026width=600\u0026lines=A.T.T+MZ+%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B\" alt=\"A.T.T MZ 快速开始\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003cb\u003e一个命令行工具包，让 AI 帮你把 RPG Maker（RM）游戏翻译成中文。\u003c/b\u003e\u003c/p\u003e\n\n你不需要懂编程，也不需要自己判断游戏引擎或原文语言。告诉 AI 你的游戏在哪，它会先检查，再带你完成汉化。\n\n\u003e ⚠️ **目前仅支持 RPG Maker MV / MZ 游戏。** 后续支持 XP、VX Ace 等引擎在技术上很简单——只是作者暂时没有想玩的游戏。如果你有需求，去 [GitHub](https://github.com/yexi-by/att-mz) ⭐ 点个 Star 或提个 Issue，给作者一点更新的动力。\n\n## ✨ 工具优点\n\n| 功能 | 说明 |\n|---|---|\n| 🧵 高并发翻译 | 可配置的并发数量和请求速率，大批量文本也能快速跑完 |\n| ⚡ 大游戏更省等待 | 翻译、检查和写入这些耗时步骤都按大项目优化，文本很多也不用一直卡着 |\n| 💾 译文持久化缓存 | 中断后重新运行自动跳过已翻译内容，不重复工作，不重复花钱 |\n| 🔄 运行时去重 | 同一轮内出现多次的相同原文只翻译一次，结果自动复用到所有位置 |\n| 🛡️ 细粒度失败处理 | 翻译出错不会整批丢弃，单条失败不影响同批其他成功条目，重试、标记、分类逐级收窄 |\n| 🔧 全角引号自修复 | 模型可能把日文「」改写成中文\"\"或英文\"\"，工具会自动还原为源文标点字符 |\n| 📜 剧本化翻译上下文 | 按地图场景和角色对话组织翻译内容，模型看到的是带上下文的剧本而非散装文本 |\n| 📚 引擎级术语表 | 从游戏数据自动提取角色名、技能名等术语候选，Agent 填写后注入翻译流程，确保术语前后一致 |\n| 🔒 语义化占位符 | 游戏控制符在翻译时被替换为可读标记，模型只翻译文字不碰控制符，翻译后精确还原 |\n| ✏️ 自定义占位符 | 游戏自带的特殊标记可以由 Agent 分析后自行定义保护规则 |\n| ✅ 翻译格式检查 | 逐条检查漏翻、控制符破坏、源文残留、行宽超标等问题，生成可定位的质量报告 |\n| 🤖 Agent 自主分析工作流 | 插件参数、事件指令、Note 标签中哪些文本该翻译、哪些不该碰，全部由 Agent 自主判断并写成规则 |\n\n## 📋 你需要准备什么\n\n三样东西：\n\n1. 🤖 **一个能执行命令的现代 AI Agent** — 你的 AI 助手\n2. 📦 **A.T.T MZ 发行包** — 翻译工具\n3. 🔑 **一个大模型 API Key** — 翻译引擎的\"钥匙\"\n\n## 🤖 第一步：选一个 Agent\n\n需要能执行命令、读写文件、处理多步骤任务的 Agent。下面是一些选择：\n\n| Agent | 形式 | 说明 |\n|-------|------|------|\n| [Codex 桌面版](https://chatgpt.com/zh-Hans-CN/codex/) | 🖥️ 桌面应用 | 开箱即用 |\n| [VS Code](https://code.visualstudio.com/) + [Cline](https://github.com/cline/cline) / [Kilo](https://github.com/kilocode/kilo-code) 等 | 🧩 编辑器插件 | 适合已在用 VS Code 的人 |\n| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | ⌨️ 命令行 | Anthropic 官方 CLI Agent |\n| [Pi](https://github.com/earendil-works/pi) | ⌨️ 命令行 | 轻量终端 Agent |\n| [OpenClaw](https://github.com/openclaw/openclaw) | ⌨️ 命令行 | 开源跨平台个人 AI 助理 |\n| [Hermes](https://github.com/NousResearch/hermes-agent) | ⌨️ 命令行 | Nous Research 出品，支持子代理调度 |\n\n以上只是举例，选择你顺手的即可。如果 Agent 支持调用子代理，翻译流程会跑得更快，但不是必须。\n\n怎么算装好了？在对话框里输入\"你好\"，AI 回复你了就说明 OK。\n\n\u003e 💡 下面教程以 **Codex 桌面版** 为例。用其他 Agent 的话步骤完全一样——Agent 里都有开文件夹和对话框。\n\n## ⚙️ 第二步：下载 A.T.T MZ 并配置模型\n\n1. 打开 [GitHub Releases](https://github.com/yexi-by/att-mz/releases/latest)，下载 `att-mz-windows-x86_64.zip`（目前仅提供 Windows 版）\n2. 右键 zip → 全部解压缩 → 放到你方便找的位置\n3. 用记事本打开解压出来的 `setting.toml`，填模型配置：\n\n```toml\n[llm]\nbase_url = \"https://你的服务商地址/v1\"\napi_key = \"你的API Key\"\nmodel = \"模型名称\"\ntimeout = 600\n```\n\n4. 保存、关闭\n\n`base_url`、`api_key`、`model` 这三个值你的 API 服务商会提供。常用的服务商有阿里云百炼、DeepSeek、硅基流动、OpenRouter 等。不知道填什么的话，直接问你的 Agent：「我的 API 服务商是 xxx，帮我填好 A.T.T MZ 的模型配置」。\n\n\u003e 💡 如果你习惯用源码运行，看 [进阶教学与源码编译](docs/advanced-usage.md)。普通使用不需要。\n\n## 📂 第三步：用 Agent 打开你的游戏目录\n\n用 Agent 打开你的游戏目录。游戏目录是你要翻译的项目——里面有游戏数据、剧情文本、插件脚本。A.T.T MZ 是外部工具，以命令行方式被 Agent 调用。\n\n操作：在 Agent 中点击\"打开文件夹\"，选择你的游戏目录。\n\n## 🚀 第四步：告诉 Agent 你要汉化\n\n在对话框里输入：\n\n\u003e A.T.T MZ 在 `\u003cA.T.T MZ 目录\u003e`，用它的 Skill（`\u003cA.T.T MZ 目录\u003e\\skills\\att-mz\\SKILL.md`）把这个游戏汉化成中文。原文语言如果不确定，请先检查游戏文件再继续。\n\n如果你已经在 Agent 中安装了 att-mz Skill，Skill 路径可以省略：\n\n\u003e A.T.T MZ 在 `\u003cA.T.T MZ 目录\u003e`，用它的 Skill 把这个游戏汉化成中文。原文语言如果不确定，请先检查游戏文件再继续。\n\nAgent 收到任务后，会自己完成整个流程：\n\n- 🔍 识别游戏引擎（RPG Maker MV 或 MZ）\n- 🌐 判断原文语言（日文或英文）\n- 📝 注册游戏、导出文本、分析规则\n- 🤖 调用模型翻译正文\n- ✅ 检查翻译质量\n- 💾 确认没问题后把译文写进游戏文件\n\n过程中 Agent 会一步步向你报告进度。遇到需要确认的事情（比如要不要换游戏字体），它会主动问你。你只需要回答\"可以\"或\"不行\"。\n\n## 🎯 第五步：试玩 + 反馈\n\nAI 把译文写进游戏文件后，打开游戏实际玩一遍。如果发现：\n\n- 👀 有文字还是日文/英文（漏翻）\n- 💬 翻译不通顺或意思不对（误翻）\n- 📏 文字太长显示不全（显示问题）\n\n直接在 Agent 对话框里说：\n\n\u003e 游戏里 NPC \"老爷爷\" 说的话还是日文，帮我查一下\n\n\u003e 物品说明栏里的文字太长了，显示不全\n\nAgent 会定位问题、修复译文、重新写进游戏。试玩 → 反馈 → 修复，这个循环可以反复进行，直到你满意为止。\n\n## 💬 遇到问题了？\n\n**直接问 Agent。** 任何关于本项目的问题——配置报错、翻译卡住、游戏跑不起来——全部问它。Agent 读了项目说明和 Skill，比你自己翻 FAQ 快得多。\n\n打开对话框，直接问。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyexi-by%2Fatt-mz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyexi-by%2Fatt-mz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyexi-by%2Fatt-mz/lists"}