i18n 文件替换
replace_fileReplaces hardcoded text in source files with i18n resource keys via the i18n platform API, returning generated keys and optional machine translations.
Instructions
调用 i18n 平台(https://i18n.codeini.com)文件替换 API,将普通代码文件转换为支持多语言的代码文件。返回替换后的 content、生成的 generatedKeys 与 keyCount。需配置环境变量 I18N_API_KEY(平台 API Key)。 必须提供 configJson 或 profileName 之一。 提供 translateTo(目标语言数组,如 ["en"])且带 resourceSet 时,替换后会把每个 key 机翻到目标语言并一并写入资源库(返回 translatedCount)。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | 要替换的文件完整内容 | |
| fileName | Yes | 被替换文件的名称,用于生成 key(如 Home.vue;带目录前缀如 pages/member/list.vue 时 key 会包含目录信息) | |
| configJson | No | 替换配置 JSON(I18nReplaceConfigDto,与 profileName 二选一,优先级更高) | |
| profileName | No | 平台上已保存的配置名(与 configJson 二选一) | |
| resourceSet | No | 非空时将生成的 key 写入该资源集(写入平台数据库,LocaleId=zh) | |
| translateTo | No | 配合 resourceSet 使用:写入源语言(zh)后,把每个生成的 key 机翻到这些目标语言(如 ["en"] 或 ["en","ja"]),译文以相同 id 写入同一资源集。需同时提供 resourceSet | |
| resourceSetByDir | No | 为 true 且提供了 resourceSet 时,实际资源集为 <resourceSet>.<fileName 的第一级目录>(与 CLI --resource-set-by-dir 一致,如 portal.member);fileName 无目录前缀时退化为 resourceSet 本身 | |
| translateProvider | No | 机翻提供方(缺省用平台默认提供方,可用环境变量 I18N_TRANSLATE_PROVIDER) |