SuperAPI AI 工具集

lokalise-local-dev-loop

编程与开发

查看项目

更新于 10-15 23:27

技能介绍

用途:在本地搭建完整的 Lokalise 翻译开发闭环,覆盖源文案上传、翻译下载、自动同步与离线调试。

主要能力:

  1. 目录结构:src/locales 存放 en.json(基准语言)及各语言文件,index.ts 提供类型安全的导出与按需加载。
  2. CLI 脚本:i18n-push.sh 用 lokalise2 file upload 上传源文件(--replace-modified、--detect-icu-plurals、--poll 等);i18n-pull.sh 用 lokalise2 file download 下载全部翻译(--format json、--bundle-structure "%LANG_ISO%.json"、--unzip-to ./src/locales)。package.json 提供 i18n:push、i18n:pull、i18n:sync。
  3. 监听模式:i18n-watch.ts 用 node:fs 的 watch 监听 en.json,2 秒防抖后自动执行推送。
  4. 模拟翻译:i18n-mock.ts 生成 pseudo.json(伪本地化)与 xx-long.json(拉长文本),用于离线布局与溢出测试。
  5. 框架集成:React i18next 初始化与懒加载 changeLanguage;Vue i18n 的 createI18n 与 loadLocaleMessages。
  6. pre-commit 钩子:检测暂存的 locale 文件后自动拉取,若产生新变更则提示先提交,避免提交过期翻译。

前置条件:LOKALISE_API_TOKEN、LOKALISE_PROJECT_ID 环境变量,Node.js 18+ 与 npm/pnpm,已安装 lokalise2 CLI,Git。

限制与注意:资料未提供具体收费、价格或平台支持范围;速率限制 429 时可增大防抖超时,轮询超时可加 --poll-timeout 120;Lokalise 可能重排 JSON,建议 export_sort 设为 a_z 并统一格式。