glot

本地服务

github.com开发工具01 周前更新

代码仓库访问官网

关于 glot

glot 是面向编码 Agent 的应用本地化工具，通过确定性校验确保翻译符合占位符、术语、复数和界面宽度规则。它提供命令行流程，并可向 Agent 提供带上下文的字符串和受校验的新增工具。

主要功能

01检测 i18n 技术栈并初始化配置
02将硬编码界面文本改为键
03仅翻译新增或变更内容
04校验占位符、复数和术语
05按界面字体测量并限制宽度
06锁定文件避免覆盖手动编辑

适用场景

01为应用新增法语和德语翻译
02将界面硬编码文本迁移为 i18n 键
03检查目录中的占位符与复数规则
04让 Agent 按界面上下文添加字符串

MCP 相关

glot mcp 向 Claude Code、Cursor 或 Codex 提供字符串键、文件位置、界面角色和术语表，并开放经同一校验器处理的新增工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "mattjeff-glot": {
      "command": "npx",
      "args": [
        "-y",
        "glot-i18n"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}

启动命令npx -y glot-i18n

需要配置的环境变量

ANTHROPIC_API_KEY密钥LLM key used by the translate tool (or OPENAI_API_KEY, per glot.toml). Not needed for context, check or add.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmglot-i18n0.4.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

glot

你的编码 Agent 可为应用本地化。确定性代码可确保目录中不会出现损坏或过长的内容。

glot translate 拒绝了缺少 few/many 的波兰语复数形式、源文本中不存在的 {nom} 占位符，以及宽达 276px、无法放进 120px 按钮的德语标签，然后写入修正后的重试结果

_{真实的 glot translate 二进制程序。LLM 首次尝试时被设定为翻错三条字符串；每次拒绝和提示都由 glot 发出。你可以复现此过程，也可以用真实模型重试：docs/launch/record/refusal.sh。}

npx glot-i18n init        # detect your i18n stack, write glot.toml + rules for your coding agent
npx glot-i18n i18nize     # hardcoded UI strings -> keys, components rewritten (next-intl, react-i18next)
npx glot-i18n translate   # translate only the delta; invalid output is refused, retried, never written

也可以通过一个幂等步骤完成所有操作：npx glot-i18n localize --yes --targets fr,de（如有需要则先 init → i18nize → translate → check）。

保证

每次 LLM 输出、glot set、叠加层以及 CI（glot check）都会通过代码进行检查。被拒绝的字符串会连同确切原因发回模型（重试 2 次，然后使用备用模型）；若仍未通过，则不会写入任何内容。


占位符	`{name}`、`{{name}}`、标签：与源文本的集合完全相同，不会凭空添加，也不会翻译。解析 ICU、i18next 和 MessageFormat 2 语法。
CLDR 复数	目标区域设置所需的每种类别（`pl`：one、few、many、other；`ar`：六种）。
术语表	仓库中的 `glossary.toml`：必需和禁用的译法，以及禁止翻译的术语。
像素宽度	`glot measure` 会记录运行中应用里每个键对应的框和字体；翻译会使用该字体进行字形塑形，超宽时会被拒绝。`glot fit` 会缩短已经溢出的内容。
锁定文件	`glot.lock` 会对源文本和目标文本进行哈希：只翻译差异，未经 `--force` 不会覆盖手动编辑的内容。
面向 Agent 的 MCP	`glot mcp` 会向 Claude Code、Cursor 或 Codex 提供键、使用位置（文件:行号、UI 角色）、术语表，以及通过同一验证器添加字符串的工具。