> ## Documentation Index > Fetch the complete documentation index at: https://hyperlocalise.dev/llms.txt > Use this file to discover all available pages before exploring further. # 运行 > 从已配置的源文件中规划并执行本地翻译生成。 ## 用法 ```bash theme={null} hyperlocalise run [--config ] [--group ] [--bucket ] [--file ] [--locale ] [--dry-run] [--workers ] [--output ] [--experimental-context-memory] [--context-memory-scope ] [--context-memory-max-chars ] ``` ## 行为 1. 加载并验证配置， 2. 从组和桶中规划任务， 3. 跳过已在`.hyperlocalise.lock.json`中的任务， 4. 执行剩余任务， 5. 将已成功的任务持久化以锁定状态。对于锁文件字段、生命周期和重置指南，请参阅 [锁文件约定](/reference/lockfile-contract)。 ## 支持的本地文件格式 `run` 可以读取带有以下扩展名的源文件和目标文件： * `.json` * `.jsonc` * `.yaml` 和 `.yml` * `.js`、`.jsx`、`.mjs`、`.cjs`、`.ts`、`.tsx`、`.mts`和`.cts` * `.arb` * `.xlf`、`.xlif`和`.xliff` * `.po` * `.html` * `.liquid` * `.md` * `.mdx` * `.strings` * `.stringsdict` * `.xcstrings` * `.csv` * `.php` * `.ftl` * Android XML `strings.xml` 文件位于 `**/res/values*/strings.xml` * `.xml` 和 `.resx` 用于通用 XML 区域设置文件 * `.properties` 对于 JSON（`.json`），`run` 支持： * 标准嵌套键值 JSON 对象 * 当根严格匹配时的 FormatJS 消息 JSON： `{"[id]": {"defaultMessage": "[message]", "description": "[description]"}}` 在 FormatJS 模式下，仅翻译 `defaultMessage`。键（消息 ID）、`description` 以及其他非消息元数据都会被保留。对于 JavaScript 和 TypeScript 区域设置模块（`.js`、`.jsx`、`.mjs`、`.cjs`、`.ts`、`.tsx`、`.mts`、`.cts`），`run` 支持静态区域设置对象导出： * `export default { ... }` * `export const messages = { ... }` * `module.exports = { ... }` * `const messages = { ... }; export default messages` 嵌套对象会被展平为点分隔的键，字符串数组使用方括号索引，而严格的 FormatJS 风格条目只翻译 `defaultMessage`，同时保留 `description` 元数据。注释、导入、导出语法以及 `as const` 会在写入时保留。动态值、计算属性键、展开属性、多个导出的 locale 对象，以及包含 `${...}` 插值的模板字面量会导致解析器错误，而不是被重写。当现有的 JS/TS 目标模块与源具有相同的键集合时，`run` 会写入目标模板，因此会保留译者注释和现有的模块布局。如果源键集合发生变化，`run` 会回退到源模板，以避免合并不匹配的对象形状。对于 YAML/YML（`.yaml`、`.yml`），`run` 支持带有字符串叶节点的映射形状区域设置文件。嵌套映射会变成带点的键，序列会变成 `[index]` 键，而写回会在尽可能保留键顺序/注释的同时重写现有的字符串叶节点。映射键不能包含 `.`、`[` 或 `]`，因为这些字符保留用于扁平化路径。诸如数字、布尔值、null、时间戳、锚点和别名等非字符串标量叶节点会被拒绝，以避免静默损坏。对于 Markdown 和 MDX（`.md`、`.mdx`），`run` 会翻译提取出的散文内容，并保留不可翻译的结构：对于 HTML（`.html`），`run` 会翻译块级元素中的文本内容： * `