# 翻译规范

首页 · 安装指南 · Docker 部署 · 常见问题 · 贡献指南 · 翻译规范

--- ## 目录 - [术语表](#glossary) - [翻译原则](#principles) - [风格指南](#style-guide) - [常见问题](#faq) --- ## 术语表 保持以下术语的一致性: | 英文 | 中文 | |------|------| | Gateway | 网关 | | Workspace | 工作区 | | Channel | 频道 | | Skill | 技能 | | Agent | 代理 | | Token | 令牌 | | Onboarding | 初始化/引导 | | Credential | 凭证 | | Session | 会话 | | Config | 配置 | | Sandbox | 沙箱 |

回到顶部

--- ## 翻译原则 ### 1. 保持变量占位符 ```json // ✓ 正确 "`Gateway port: ${port}`": "`网关端口: ${port}`" // ✗ 错误 - 不要翻译变量 "`Gateway port: ${port}`": "`网关端口: ${端口}`" ``` ### 2. 保持代码结构 ```json // ✓ 正确 - 保持原有格式 "{ value: \"keep\", label: \"Use existing values\" }": "{ value: \"keep\", label: \"使用现有值\" }" // ✗ 错误 - 改变了结构 "label: \"Use existing values\"": "标签:\"使用现有值\"" ``` ### 3. 注意引号类型 源码中可能有不同类型的引号: - 直引号: `"` `'` - 弯引号: `"` `'` `'` 翻译配置中要精确匹配原文的引号类型。 ### 4. 保持技术术语 ```json // ✓ 正确 - 保留技术命令 "run `openclaw doctor`": "运行 `openclaw doctor`" // ✗ 错误 - 不要翻译命令 "run `openclaw doctor`": "运行 `开爪医生`" ```

回到顶部

--- ## 风格指南 ### 标点符号 - 使用中文标点(。,!?) - 冒号使用中文冒号(:) - 括号可用英文或中文,保持一致 ### 语气 - 保持友好但专业 - 适当保留原文的幽默感 - 错误提示要清晰明确 ### 长度 - 尽量保持与原文相近的长度 - UI 文本尤其注意不要过长

回到顶部

--- ## 常见问题 ### Q: 找不到要翻译的字符串? A: 可能是因为: 1. 字符串在源码中有特殊字符(如换行、转义) 2. 引号类型不匹配 3. 字符串被拆分在多行 ### Q: 翻译后验证失败? A: 检查: 1. JSON 格式是否正确 2. 转义字符是否正确(`\"` 表示引号) 3. 原文是否精确匹配源码

回到顶部