ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

replexica:基于 Lingo.dev 平台的开源本地化工程工具全景指南

replexica:基于 Lingo.dev 平台的开源本地化工程工具全景指南 replexica基于 Lingo.dev 平台的开源本地化工程工具全景指南【免费下载链接】replexicaOpen-source localization engineering tools. Connects to Lingo.dev localization engineering platform for consistent, quality translations.项目地址: https://gitcode.com/GitHub_Trending/re/replexicareplexica 是 Lingo.dev 生态的开源本地化工程工具集合核心思路是把翻译从一次性外包任务升级为可嵌入开发流程的工程能力CLI 一条命令本地化 JSON/YAML/Markdown/CSV/PO 等文件MCP 服务为 AI 编程助手提供框架级 i18n 知识GitHub Action 实现推送即翻译的持续本地化甚至可以在编译期直接生成本地化组件而无需任何 i18n 包装函数。读完本文你将掌握这套工具链的完整架构、各子工具的实战用法、配置项细节以及如何参与其中为项目贡献新语言。项目定位本地化工程Localization Engineering而非单纯翻译replexica 在 readme/fr.md 中的自我定位是开源本地化工程工具连接 Lingo.dev 本地化工程平台获得一致、高质量的翻译。与机器翻译一把梭不同这套体系强调有状态的本地化引擎localization engines引擎是你在 Lingo.dev 平台上创建的有状态翻译 API不只是无状态的模型调用每次请求都会持久化词汇表glossaries、品牌语气brand voice和按 locale 划分的指令官方研究显示这种检索增强式本地化retrieval-augmented localization可将术语错误降低 16.6%44.6%如果你不想依赖平台也可以自带 LLM详见下文 CLI 部分。也就是说术语表、语气规范这些品牌资产被固化进每次翻译请求多语言输出的一致性由基础设施保障而不是靠运气。快速上手四种工具的定位速查文档的 Quick Start 表给出了最直接的入口readme/fr.md工具作用快速命令Lingo React MCP为 React 应用提供 AI 辅助的 i18n 配置提示词Set up i18nLingo CLI本地化 JSON、YAML、markdown、CSV、PO 文件npx lingo.devlatest runLingo GitHub Action在 GitHub Actions 中实现持续本地化uses: lingodotdev/lingo.devmainLingo Compiler for React编译期本地化 React无需 i18n 包装函数withLingo()插件下面逐一展开每个工具的定位、用法与仓库证据。Lingo.dev MCP给 AI 助手的 React i18n 知识库在 React 应用中手工配置 i18n 极易出错——文档明确指出即使是 AI 编码助手也会幻觉出不存在的 API 并破坏路由。Lingo.dev MCP 的解法是给 AI 助手提供框架特定的 i18n 结构化知识覆盖 Next.js、React Router 和 TanStack Start 三类框架。兼容的 AI 客户端Claude Code、Cursor、GitHub Copilot Agents、Codex典型用法直接向助手发出Set up i18n指令让它基于 MCP 提供的正确 API 知识完成配置而不是凭训练记忆猜测仓库中有对应演示项目demo/new-compiler-vite-react-spa使用 TanStack Router见demo/new-compiler-vite-react-spa/src/routes/__root.tsxdemo/new-compiler-next16则是 Next.js App Router 示例可作为 MCP 配置产出物的参考。Lingo CLI一条命令完成多格式本地化CLI 是整个工具链中最常用的一环文档给出的最小可用流程只有两条命令npx lingo.devlatest init npx lingo.devlatest run核心机制lockfile 增量翻译CLI 的关键设计是锁文件lockfile机制它持续记录哪些内容已经本地化因此每次run只处理新增或变更的内容不会重复消耗 token、也不会覆盖已有的人工翻译成果。在仓库中packages/cli/demo/下每个格式示例目录都同时包含i18n.json与i18n.lock两个文件例如packages/cli/demo/json/、packages/cli/demo/po/、packages/cli/demo/csv/等直观展示了配置 锁定状态的配套关系。支持的文件格式文档承诺一次命令覆盖 JSON、YAML、markdown、CSV、PO 五种格式而从packages/cli/demo/的目录结构看实际内置的 loader 生态远不止这些还包括 Android XML、Flutter ARB、Xcode strings/xcstrings/stringsdict、XLIFF、HTML、MDX、Markdoc、EJS、Twig、PHP、properties、SRT、VTT、TypeScript、Vue 等数十种格式详见 packages/cli/demo基本覆盖了 Web、移动端与文档站的主流本地化载体。翻译引擎平台引擎或自带 LLM默认连接 Lingo.dev 平台上的本地化引擎即上文所述有状态引擎也可以自带 LLM文档列出的提供方包括 OpenAI、Anthropic、Google、Mistral、OpenRouter、Ollama。这一声明在 packages/cli/package.json 的依赖中得到了印证项目同时引用了ai-sdk/openai、ai-sdk/anthropic、ai-sdk/google、ai-sdk/mistral、openrouter/ai-sdk-provider、ollama-ai-provider-v2意味着六类模型提供方均可接入。CLI 命令全景从 CLI 入口文件 packages/cli/src/cli/index.ts 可以看到完整的命令体系命令职责init初始化项目 i18n 配置i18n与 i18n 配置相关的子命令auth/login/logout平台认证与会话管理show查看当前配置或状态config管理配置项lockfile管理锁文件cleanup清理翻译产物ci供 CI 环境使用的非交互式本地化status查看本地化进度状态run执行本地化purge清除本地化记录此外 CLI 支持-y, --no-interactive全局选项可在脚本与 CI 中完全禁用交互提示见 packages/cli/src/cli/index.ts。Node.js 版本要求为18见 packages/cli/package.json。CI/CD推送即翻译的持续本地化文档给出的 CI 场景是每次 push 触发本地化缺失的字符串在代码到达生产环境之前被补齐。支持 GitHub Actions、GitLab CI/CD 与 Bitbucket Pipelines。GitHub Action 最小配置uses: lingodotdev/lingo.devmain with: api-key: ${{ secrets.LINGODOTDEV_API_KEY }}全部输入参数来自 action.yml参数默认值说明versionlatestLingo.dev CLI 版本api-key空Lingo.dev 平台 API Keypull-requestfalse是否用变更创建 Pull Requestcommit-messagefeat: update translations via LingoDotDev提交信息pull-request-titlefeat: update translations via LingoDotDevPR 标题commit-author-nameLingo.devGit 提交作者名commit-author-emailsupportlingo.devGit 提交作者邮箱working-directory.工作目录process-own-commitsfalse是否处理本 Action 自己产生的提交parallelfalse是否启用并行模式从 action.yml 的 runs 段可以看到该 Action 本质上是把上述参数原样透传给npx lingo.devversion ci命令的薄封装composite action因此在本地完全可以用同一条ci命令复现相同行为便于调试。Lingo.dev API在代码里直接调用本地化引擎当本地化逻辑需要嵌入后端业务时可以直接从后端代码调用你的本地化引擎文档列出的核心能力包括同步与异步两种本地化模式webhook 交付异步任务完成后通过 webhook 回调通知按 locale 的故障隔离单个语言失败不会拖垮整体任务WebSocket 实时进度长任务可实时观测翻译进度。该 API 对应仓库中的 packages/sdkSDK 以独立包形式发布见 packages/sdk/package.json并在 CLI 内部以 workspace 依赖形式复用见 packages/cli/package.json 中的lingo.dev/_sdk。Lingo Compiler for React编译期本地化早期 Alpha这是最具颠覆性的实验特性在编译期完成 React 本地化彻底消灭 i18n 包装层。用普通英文文本编写组件编译器自动检测可翻译字符串在构建时生成各语言的本地化变体没有翻译 key、没有 JSON 文件、没有t()函数支持 Next.jsApp Router与 Vite React。仓库中的 packages/new-compiler 正是该编译器的实现其插件体系覆盖了 unplugin、webpack、vite 与 Next.js 自定义 loader见 packages/new-compiler/src/plugin而 packages/new-compiler/docs/TRANSLATION_ARCHITECTURE.md 详述了翻译架构。两个演示项目可直接对照体验Next.js 16 示例demo/new-compiler-next16含 Server/Client 组件拆分示例Vite React SPA 示例demo/new-compiler-vite-react-spa注意该特性处于Early alpha阶段适合评估与实验生产项目建议优先使用前文的 CLI MCP CI/CD 组合。参与贡献pnpm turborepo 单体仓库文档明确了贡献流程readme/fr.mdIssues报告 bug 或请求新功能Pull Requests提交修改——每个 PR 都必须附带 changesetpnpm new无版本变更的改动用pnpm new:empty提交前确保测试通过开发环境这是一个 pnpm turborepo 单体仓库安装依赖pnpm install运行测试pnpm test构建pnpm build仓库根部的 pnpm-workspace.yaml、turbo.json 与 package.json 印证了这一工程结构。项目自身的多语言实践i18n.json 与本地化文档replexica 的 README 本身就是项目工具链的活样本——它被翻译为 27 种语言存放在 readme/ 目录fr.md、ja.md、zh-Hans.md等。这一实践的配置依据是根目录的 i18n.json{ version: 1.10, locale: { source: en, targets: [ar, as-IN, bho, bn, de, es, fa, fr, gu-IN, he, hi, it, ja, ko, mr-IN, or-IN, pa-IN, pl, pt-BR, ru, si-LK, ta-IN, te-IN, tr, uk-UA, ur, zh-Hans] }, buckets: { mdx: { include: [readme/[locale].md] } }, $schema: https://lingo.dev/schema/i18n.json }要点解读locale.source为enlocale.targets列出全部目标语言语言码采用 BCP-47 格式如zh-Hans、pt-BR、as-INbuckets.mdx.include中的readme/[locale].md是模板化的文件通配[locale]会被替换为各语言码从而驱动 CLI 批量生成/更新各语言 README官方文档即由这套配置直接管理fr.md的生成与更新由根目录 i18n.lock 记录状态。新增一种语言的步骤在 i18n.json 的targets中加入符合 BCP-47 的语言码然后提交 PR 即可。小结何时选用哪个工具场景推荐工具本地开发一次性本地化多个格式文件CLInpx lingo.devlatest initrun让 AI 助手正确配置 React 项目 i18nLingo.dev MCPSet up i18n团队持续集成push 即翻译GitHub Action / GitLab CI / Bitbucket 集成后端代码内嵌本地化调用Lingo.dev API或仓库内 packages/sdk探索无 key、无t()的下一代本地化体验Lingo Compiler for ReactEarly alpha整体而言replexica 提供的不是单一的翻译工具而是一条从开发机 → CI 流水线 → 后端服务全覆盖的本地化工程链路CLI 处理内容、Action 自动化流程、API 服务化集成、MCP 辅助 AI、Compiler 探索未来形态而锁文件与有状态引擎则共同保障了增量、一致、可追溯的翻译质量。【免费下载链接】replexicaOpen-source localization engineering tools. Connects to Lingo.dev localization engineering platform for consistent, quality translations.项目地址: https://gitcode.com/GitHub_Trending/re/replexica创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表