使用 Agent 补译

Agent + MCP 适合希望在明确指令下补译、审校和验证翻译的团队。如果希望开发或构建期间自动调用模型，请使用 AI 翻译。

开始前，请先在目标 Vite 应用中完成 ai-i18n 接入，并运行一次完整 vite build。这样 Agent 才能读取当前应用的文案清单。

安装 Skills

推荐在项目根目录安装 ai-i18n 提供的 Skills：

npx skills add bosens-China/ai-i18n --skill use-ai-i18n-mcp integrate-ai-i18n -y

安装后，你可以直接让 Agent 执行以下任务：

“使用 integrate-ai-i18n 检查这个 Vite 应用的接入。”
“使用 use-ai-i18n-mcp 补齐缺失的英文翻译，不要覆盖已有译文。”

Skills 会引导 Agent 选择正确的 Vite 应用，并区分自动译文与人工审校结果。

给 Agent 的文档入口

Rspress Build 会在文档站根目录生成 llms.txt 和 llms-full.txt：

llms.txt 是带页面说明的精简索引。建议 Agent 先读它，再打开与当前框架或功能直接相关的 Markdown 页面。
llms-full.txt 包含完整文档正文，适合需要一次性导入整套资料的工具；日常编码任务不必默认加载，以免占用过多上下文。

Skills 只维护 Agent 的目标选择、默认决策、写入与授权边界、验证和错误恢复。安装、配置、API、框架示例与排障方法以本文档站为准，因此 Agent 遇到具体产品用法时应从 llms.txt 定位页面，而不是依赖 Skill 中复制的教程。

注册 MCP 服务器

ai-i18n 支持 Codex、Cursor、Claude Code 和 Antigravity。请在所使用的 AI 编码工具中注册 @ai-i18n/mcp。以下命令和配置以当前 alpha 版本为例。

Codex

在本机终端运行以下命令即可注册：

codex mcp add ai-i18n -- npx -y @ai-i18n/mcp@alpha

也可以在 ~/.codex/config.toml 或项目的 .codex/config.toml 中加入：

[mcp_servers.ai_i18n]
command = "npx"
args = ["-y", "@ai-i18n/mcp@alpha"]

也可以在 Codex 桌面端依次打开 Settings → MCP servers → Add server → STDIO，填写相同的 command 和 args。

Cursor

在项目的 .cursor/mcp.json 或全局 ~/.cursor/mcp.json 中加入：

{
  "mcpServers": {
    "ai-i18n": {
      "command": "npx",
      "args": ["-y", "@ai-i18n/mcp@alpha"]
    }
  }
}

Claude Code

claude mcp add --transport stdio --scope local ai-i18n -- npx -y @ai-i18n/mcp@alpha

Antigravity

在项目的 .agents/mcp_config.json 中加入以下内容。若希望所有项目共用，可改为全局 ~/.gemini/config/mcp_config.json：

{
  "mcpServers": {
    "ai-i18n": {
      "command": "npx",
      "args": ["-y", "@ai-i18n/mcp@alpha"]
    }
  }
}

在 Antigravity IDE 中，也可以从 Agent 面板的 MCP Servers → Manage MCP Servers → View raw config 打开同一份配置。当前 ai-i18n 未收录在 Antigravity MCP Store，因此需要添加自定义服务器配置。

Cursor 和 Antigravity 对自定义本地 STDIO 服务器均使用配置文件。它们的 MCP Store 一键安装仅适用于已收录的服务器；ai-i18n 收录前，请使用本页配置。

使用边界

Agent 补译默认保留已有译文。需要修改已确认的措辞时，请明确说明“审校”或“覆盖”。
人工审校结果优先于自动译文。Agent 应先展示建议措辞，得到确认后再写入。
在 monorepo 中，请说明目标应用名称或目录，避免 Agent 处理错误的 Vite 应用。
Agent 只在指定应用内处理翻译，不会自动扩展到仓库中的其他应用。
同一条文案在多个文件中复用时，Agent 只需翻译一次，并会汇报实际影响范围。
大型项目会自动分批处理；完成后，Agent 会再次检查剩余缺失项。
大型清单默认不携带逐文件出现明细；只有排查文件或汇报影响范围时，Agent 才会额外请求。
短文案缺少语境时，Agent 可以按需取得每个出现文件及行列位置，再读取附近源码；这些位置不会改变同一句文案跨文件共享一份翻译的规则。
带动态值的文案会校验全部编号占位符；缺少、多出或改变编号时，整批写入不会生效，Agent 会按返回的差异修正后重试。
同一文案出现互相矛盾的译文时，Agent 会请求确认，不会自行猜测。
Agent 工作期间不要并行手动修改同一份译文文件；完成后再进行人工审校。
普通补译和审校不会自动清理历史消息。只有你明确要求审查孤立消息时，Agent 才会在完整 Build 后列出当前源码不再引用的 Translation Memory；删除前会展示结果并再次请求确认。
清理孤立的自动译文不会联动删除人工审校结果。需要删除孤立人工值时，应单独提出并审查。
生成文件和提交规则见生成文件与 Git。

MCP 提供读取、补译和人工审校所需的工具。具体工具字段属于 Agent 接入契约，通常不需要由应用开发者手动调用。

使用 Agent 补译#

#安装 Skills

#给 Agent 的文档入口

#注册 MCP 服务器

#Codex

#Cursor

#Claude Code

#Antigravity

#推荐提示词

#使用边界