# translation

> 翻译文件管理。read: 读 CSV/PO 翻译条目(语言/键值对)。write: 写/创建 Godot 兼容 CSV 翻译表(key + 每语言一列;CSV→.translation 编译由编辑器导入完成)。register: 把 .translation/.po 注册进 project.godot(translations 数组,remove=true 反向移除)。

| 属性 | 值 |
|------|-----|
| 所属层 | headless |
| 安全级别 | guarded |
| 需要 Godot | 是 |
| 需要编辑器 | 否 |
| 只读 | 否 |
| 长耗时 | 否 |

## Actions

- `translation_read`
- `translation_write`
- `translation_register`

## Parameters

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `action` | enum (3 项) | ✓ | 操作类型 |
| `project_path` | string |  | Godot 项目目录路径（可选，默认使用 GODOT_PROJECT_PATH 环境变量或当前目录） |
| `path` | string |  | read/write: 翻译文件路径(res:// 相对,read 支持 .csv/.po,write 仅 .csv) |
| `languages` | array |  | write: 语言代码列表(如 [en, zh_CN],与 entries 键对应) |
| `entries` | object |  | write: {key: {语言: 文本}} 条目对象 |
| `paths` | array |  | register: 翻译资源路径列表(res:// 相对,支持 .translation/.po) |
| `remove` | boolean |  | register: true=从注册表移除(默认 false=注册) |
| `limit` | number |  | read: 条目返回上限(默认 200,防大文件撑爆上下文) |

## 风险分布

读 1 / 写 2

---
<!-- AUTO-GENERATED by scripts/gen-tool-docs.mjs from capability-matrix.json v0.32.21. DO NOT edit manually; re-run npm run gen:tool-docs after tool changes. -->