配置架构

​

顶级键

• locales
• buckets
• groups
• llm
• storage（用于sync为必填）
• cache（可选）

​

locales

• source（字符串，必填）
• targets（字符串数组，必需）
• fallbacks（对象，可选）

​

buckets

• 桶名称到存储桶定义的映射
• files 带有 from 和 to 模板

​

groups

• 组名到组定义的映射
• targets 数组
• buckets 数组

​

llm

• profiles profile 名称到 provider/model/prompt 的映射
• 用于上下文构建覆盖的可选context_memory对象，包含provider和model
• 支持的提供方： openai | azure_openai | anthropic | gemini | bedrock | lmstudio | groq | mistral | ollama
• rules 数组，包含 priority、group、profile

​

storage

• adapter: poeditor | lilt | lokalise | crowdin | phrase | smartling
• config：适配器特定字段

​

cache

• enabled 布尔值
• endpoint 字符串
• project_key_env 字符串
• timeout_seconds 整数

有关示例，请参见 i18n 配置。

​

CSV 工作流说明

在运行基于 CSV 的本地化流程时，请使用 buckets.*.files[].from 和 to 指向 .csv 文件。

• 按区域设置的文件通常在 [locale] 路径中使用 to。
• 共享 CSV 文件可以复用相同的 from 和 to 路径。

​

Fluent 工作流说明

使用 buckets.*.files[].from 和 to 指向用于 Mozilla Fluent 本地化流程的 .ftl 文件。

• 按语言环境的文件通常在 [locale] 路径中使用 to，例如 locales/[locale]/messages.ftl。
• 支持的条目包括消息、属性、多行值以及作为完整值表示的 select/plural 模式。
• 不支持 Fluent 术语，且解析会失败，而不会被重写。

​

Java 属性工作流说明

使用 buckets.*.files[].from 和 to 指向按区域设置划分的 .properties 资源包，例如 messages_{{source}}.properties -> messages_{{target}}.properties。