本地化指南
英语是 ThreadCells 公开文档、根 README 和产品声明的规范权威。翻译可以改善自然表达，但不得遗漏或虚构行为、削弱安全边界、更改限制或修改命令。
区域设置模型
发布区域设置为 en、ru、zh-CN、es、pt-BR、de 和 ja。规范英文 Markdown 保留在 docs/DOCS_MANIFEST.json 所命名的源文件中；由策略规定保留在仓库根目录的文档继续使用既有路径。每份非英文文档位于 docs/LOCALE/SLUG.md，并记录：
---
slug: overview
source: docs/OVERVIEW.md
source_sha256: sha256:EXACT_ENGLISH_SOURCE_HASH
---slug、清单顺序和导航成员资格在各区域设置间共享。不要创建第二个按区域设置划分的 Docs 清单或渲染器。
更新翻译
- 先更新并接受规范英文文档。
- 翻译每个声明和标题，不更改代码或标识符。
- 根据精确的规范源字节刷新
source_sha256。 - 运行
python3 scripts/validate_localizations.py。 - 构建网站，并在桌面、平板和移动宽度检查受影响路由。
验证器会拒绝缺失、过时、未知、重复或不匹配的已翻译 slug。受支持的区域设置不得在英文变更后悄然发布旧翻译。
添加区域设置
在 website/lib/locales.ts 中一次性添加该区域设置，提供其完整的落地页/UI 元数据，为每个清单 slug 添加一份翻译文档，添加其本地化 README，并扩展确定性的路由/浏览器检查。切换语言时保留相同的公开 slug。
添加未来的区域设置（如 fr 或 ko）应是有边界的内容变更。它不应要求另一个应用、清单或文档架构。
技术文本
除非规范英文源发生变化，否则请保持以下内容完全不变：
- 围栏代码块和 shell 命令；
- 内联代码标识符；
- API 路径、配置键、环境变量、原因代码、配置文件/提供商 ID、包名称和文件路径；
- 产品和提供商名称，例如 ThreadCells、Codex、Claude Code、Git、Git worktree 和 tmux；
- Markdown 链接目标和媒体路径。
自然地翻译这些值周围的说明。避免使开发者指南更难理解的生硬直译。
README 文件
README.md 是规范英文版本。每份本地化 README 都遵循相同的章节结构，链接到相同的证据，并以紧凑的七语言选择器开头。以粗体突出显示当前语言，并对其他六种语言使用仓库相对链接。
视觉验收
翻译不必具有完全相同的换行或章节高度。它们必须保持层级、可读排版、有效 CTA、媒体、表格、代码块、页眉/页脚行为，以及零水平溢出。尤其注意德语扩展、俄语换行、西班牙语和葡萄牙语导航，以及中文/日语换行。
仍需要一名能流畅阅读面向开发者内容的读者进行语义审查。通过 Markdown、哈希、路由和浏览器检查可证明结构新鲜度；并不能证明翻译质量。