Crowdin
自动的本地化语境

将语境收集委派给 AI 智能体

只需一条命令,便可将 Cursor、GitHub Copilot 或 Claude Code 连接到 Crowdin。您的智能体会从您的代码库中收集语境,把准确的字符串描述同步回 Crowdin——无需手动输入,无需自定义脚本。

刚刚来到 Crowdin?免费开始
已经有 Crowdin 项目?
npx skills add crowdin/skills
阅读文档

您的译员正在猜测,而且一看便知

源字符串译文(de)语境
editor.toolbar.postPostBeitrag? Veröffentlichen?缺失
task.actions.runRunAusführen? Laufen?缺失
profile.form.nameNameName? Benennen?缺失
  • 像“Post”和“Run”这样的 UI 短字符串,在译员缺少语境的情况下,翻译就会频繁出错。
  • 猜测会导致按钮翻译错误、布局破损、QA 审阅周期缓慢。
  • 手动编写描述或维护提取脚本难以扩展规模。

有更好的办法:将语境收集委派给 AI。

已经待在您 IDE 里的 AI 智能体,对您的代码库有完全的访问权限。借助 Crowdin Skills 和 Crowdin CLI,它能在 AST 层面读取您的组件,准确把握每个键渲染于何处,写出精确的描述文字,然后推送到 Crowdin——全过程自主完成。

  • 您的代码始终属于您——读取代码的是您自己的智能体,而它本就拥有对代码的访问权限。

  • 只有提取出来的语境描述会到达 Crowdin。

  • 收集过程在您已有的智能体计划上本地运行,唯一的成本是您的智能体消耗的 token。

从零语境到全覆盖,两步完成

没有要配置的大量选项,没有要维护的繁杂脚本。只需要您的终端、您的智能体、Crowdin 的命令行界面,还有一个安放字符串的 Crowdin 账号。

  1. 为您的智能体装备上 Crowdin Skills

    在您的项目根目录运行一条命令:

    npx skills add crowdin/skills

    这一步会安装两项技能,教会您的 AI 智能体所需的一切:

    • crowdin-context-cli – 如何使用语境命令(context downloadcontext upload)和读写 Crowdin 的行分隔 JSONL 格式。
    • context-extraction – 良好语境的工程规则:哪些字符串需要多加注意(有歧义的短单词、标签、按钮),如何写出简明的 1–3 句话来描述清楚 UI 元素的位置。

    支持您已在使用的智能体

    • Claude Code
    • Cursor
    • OpenAI Codex
    • Gemini CLI
    • GitHub Copilot
    • Windsurf
    • Cline
    • OpenCode

    以及其他支持 Agent Skills 格式的智能体。

  2. 给出一条提示词,让智能体处理整个生命周期。

    您不必手动运行命令行界面,只需给智能体提供如下提示词:

    请使用 Crowdin CLI 下载缺少语境的字符串,根据代码库给出这些字符串的准确 UI 位置描述,利用这些描述来增强字符串的语境,然后将增强过的语境上传回 Crowdin。

    幕后,智能体就会:

    crowdin context download --status empty

    它只将缺少描述的字符串提取到一个本地的 crowdin-context.jsonl 中,然后就会在 AST 层面逐组件分析您的源代码,以确定每个键实际渲染的位置,并为每个键撰写 1–3 句话的位置描述。

    所有的描述都会先存储在本地文件中,可在上传到 Crowdin 前审核或编辑。

    crowdin context upload

    经过增强的语境,立刻就会出现在您的 Crowdin 项目中——每位译员、每个 AI 翻译引擎都能从翻译下一条字符串开始就看到这些信息。

    自此,您的字符串已为 Crowdin 的 AI 本地化流水线准备就绪:

    AI 自动翻译查看进度控制 token 支出在线审查crowdin download

    UI 有了大更新?随时重新运行同样的提示词,您的智能体便能刷新描述,让语境永远不过时。

精准语境,无额外成本

在您的终端审查语境健康度

通过一条命令,全面了解项目的准备情况:

往命令里追加 --by-file,精准找出仍需关注的目录或特性模块。

在 CLI 文档中探索所有上下文命令
crowdin context status

$ crowdin context status

Context Status for Project "App Workspace" (ID: 78910)

Total strings:       3484
With AI context:     2850 (81.80%)
Without AI context:   634 (18.20%)
With manual context:    0 (0.00%)

无需手动输入语境

您的智能体能为成千上万的键编写和维护描述,您只需负责推出功能。告别电子表格,告别注释会议。

终结问答循环

译员询问之前,就能够看到每个字符串的位置。减少解释工单,减少布局错误。

为 AI 翻译引擎提供其无法猜测的内容

AI 无法仅凭“Run”推断其使用意图。代码级的语境是将 AI 翻译错误降至最低的最快方式。

更改了您的 UI?您可安全重置。抹掉 AI 生成的描述,保留人工撰写的注释:

crowdin context reset --all

所有语境都将在编辑器中呈现

您的智能体上传的每一条描述,都会出现在 Crowdin 编辑器中,紧挨着它所解释的字符串。翻译您产品的人类和 AI,都由相同的上下文指导。

  • 对人类: 译员翻译时,可以看到描述和准确的 UI 位置。消除猜测,消除来回沟通。

  • 对 AI: 无论使用哪一条自动翻译提示词,AI 引擎都能得到相同的描述。

探索编辑器
Crowdin 编辑器显示字符串语境和实时预览

马上开始,自动化您的本地化语境

只需给您的智能体装载一次 Crowdin Skills,之后每一次发布新版本,译员和 AI 引擎都能获得所需的语境信息。