OpenCode 是由 Anomaly Company 开发的开源 AI 编程代理。 本项目提供完整的中文本地化，通过 AI 辅助翻译和质量检查实现高质量汉化。
基于 @QinTian 的汉化项目 进行改进。
由于 OpenCode 官方更新频繁，每次都会新增文件，手动翻译太累了！
于是花了半天时间搞了个自动化方案：
- ✅ AI 自动检测新文本并翻译
- ✅ AI 审查防止翻译错误导致源文件报错
- ✅ 支持增量翻译，只翻译 git 变更文件
- ✅ 质量检查 + 自动修复
- ✅ 覆盖率报告 + AI 智能总结
- ✅ Nightly 自动构建：每小时检测官方更新，自动构建 5 个平台版本
- ✅ 汉化变更追踪：自动检测新增汉化文件，生成详细更新日志
现在不怕官方更新了，AI 会自动搞定翻译！
| 功能 | 说明 |
|---|---|
| 一键汉化 | opencodenpm full 自动完成同步→翻译→编译→部署全流程 |
| Nightly 自动构建 | 每小时检测官方更新，≥5 个新 commit 时自动构建发布 5 个平台版本 |
| 同步工具 | 菜单选项"🔄 同步工具"，一键更新汉化工具到最新版本 |
| AI 自动翻译 | 官方更新后自动检测新文本，调用 AI 翻译 |
| 增量翻译 | opencodenpm apply --incremental，仅翻译 git 变更文件 |
| 质量检查 | opencodenpm check --quality，语法检查 + AI 语义审查 |
| 自动修复 | 发现语法问题时 AI 自动修复 |
| 汉化变更追踪 | 自动检测和记录汉化文件变更，生成详细的更新日志 |
- ⏰ 每小时检测：自动检测官方 dev 分支更新
- 🎯 智能触发：累计 ≥5 个新 commit 时自动构建
- 📦 多平台支持：自动构建 5 个平台版本（Windows/macOS/Linux）
- 🔢 版本自动化：汉化版本号自动递增（+0.1）
- 📊 变更追踪：自动检测和记录汉化文件变更
- 📝 文档同步：自动更新 CHANGELOG 和 README
- 🚀 一键下载：Nightly Release 持续更新
- 一键更新：菜单新增"🔄 同步工具"选项
- 自动检测汉化工具有更新版本
- 一键执行
git pull和npm install，更新完成后提示重新运行工具
- AI 总结合并：AI 总结不再单独开框，合并到执行总结框内最后，界面更简洁
- 输出顺序优化：覆盖率报告 → 执行总结（含 AI 总结）→ 完成提示，流程更自然
- 模型信息对齐：AI 总结中"指定模型"使用统一格式，信息对齐
- 智能换行：只在标点符号后断行，避免中文断字
- 用户体验：AI 语义质量检查添加可选确认（Yes/No），节省 API 消耗
- 静默模式支持：deployer.js 添加 silent 参数，支持后台静默部署
- 交互式菜单：系统环境、运行状态、项目信息一目了然
- 输出风格统一：全面匹配 @clack/prompts 视觉风格
- 跨平台支持：Node.js CLI 替代 PowerShell，macOS/Linux/Windows 通用
| 主界面 | 命令菜单 |
|---|---|
 |
 |
| 交互式菜单 | 覆盖率 + AI 总结 |
|---|---|
 |
 |
| 步骤 1-4 | 步骤 4-5 | 步骤 5-7 |
|---|---|---|
 |
 |
 |
| 部署完成 |
|---|
 |
如果你这台电脑什么都没有安装，环境也不会，那么我建议你直接下载安装。一键启动。 启动后，可以用内置免费的 AI，然后让 AI 进行环境安装。
每小时自动检测官方更新，累计 ≥5 个新 commit 时自动构建发布。
前往 Nightly Release 下载最新构建：
| 平台 | 文件 |
|---|---|
| Windows x64 | opencode-zh-CN-nightly-windows-x64.zip |
| macOS Apple Silicon | opencode-zh-CN-nightly-darwin-arm64.zip |
| macOS Intel | opencode-zh-CN-nightly-darwin-x64.zip |
| Linux x64 | opencode-zh-CN-nightly-linux-x64.zip |
| Linux ARM64 | opencode-zh-CN-nightly-linux-arm64.zip |
⚠️ 注意：Nightly 版本为自动构建，可能包含未经充分测试的功能。
前往 Releases 下载稳定版本：
| 平台 | 文件 |
|---|---|
| macOS (Apple Silicon) | opencode-darwin-arm64.tar.gz |
| macOS (Intel) | opencode-darwin-x64.tar.gz |
| Linux (x64) | opencode-linux-x64.tar.gz |
| Windows (x64) | opencode-windows-x64.zip |
# macOS/Linux 安装
tar -xzf opencode-<platform>.tar.gz
sudo mv opencode-<platform>/bin/opencode /usr/local/bin/# 1. 克隆项目
git clone https://github.com/xiaolajiaoyyds/OpenCodeChineseTranslation.git
cd OpenCodeChineseTranslation
# 2. 安装依赖
cd scripts && npm install && npm link
# 3. 运行汉化（交互式菜单）
opencodenpm
# 4. 或一键汉化
opencodenpm full- 452 条翻译，覆盖率 100%
- 对话框：32 文件 / 177 条
- 组件：12 文件 / 158 条
- 路由：6 文件 / 70 条
- 通用：3 文件 / 42 条
- 上下文：1 文件 / 1 条
创建 .env 文件（支持任何 OpenAI 兼容 API）：
OPENAI_API_KEY=your-api-key
OPENAI_API_BASE=http://127.0.0.1:8045/v1
OPENAI_MODEL=claude-sonnet-4-20250514使用 Antigravity Tools 本地反代，支持 Claude、GPT、Gemini 等多种模型。
| 命令 | 说明 |
|---|---|
opencodenpm |
交互式菜单（推荐） |
opencodenpm full |
一键汉化（同步→翻译→编译→部署） |
opencodenpm sync |
同步官方源码 |
opencodenpm apply |
应用汉化 |
opencodenpm apply --incremental |
增量翻译（只翻译 git 变更） |
opencodenpm check --quality |
质量检查（语法 + AI 审查） |
opencodenpm build |
编译构建 |
opencodenpm deploy |
部署到系统 |
配置文件位置：
~/.config/opencode/所有配置文件保存在用户根目录，更新项目不会丢失配置。
| 文件 | 作用 | 示例 |
|---|---|---|
AGENTS.md |
AI 助手身份定义 | docs/AGENTS.example.md |
global-rules.md |
开发规范与工具指南 | docs/global-rules.example.md |
oh-my-opencode.json |
插件配置 | docs/oh-my-opencode.example.json |
opencode.json |
OpenCode 主配置 | docs/opencode.example.json |
Q: 配置文件会不会丢失？
不会！所有配置文件保存在用户根目录 ~/.config/ 下，更新项目不会影响配置。
# 建议定期备份
cp -r ~/.config/opencode ~/backup-opencode-configQ: 官方更新后如何同步？
opencodenpm sync # 同步官方源码
opencodenpm apply --incremental # 增量翻译
opencodenpm build && opencodenpm deployQ: 发现翻译错误怎么办？
- 手动修改
opencode-i18n/下的语言包文件 - 运行
opencodenpm check --quality检查质量 - 提交 PR 到项目仓库
OpenCodeChineseTranslation/
├── .github/workflows/ # GitHub Actions 自动构建
├── scripts/ # 管理工具
│ ├── core/ # 核心模块（translator.js, i18n.js, menu.js）
│ └── commands/ # CLI 命令
├── opencode-i18n/ # 语言包（452 条翻译）
│ ├── dialogs/ # 对话框（32 文件 / 177 条）
│ ├── components/ # 组件（12 文件 / 158 条）
│ ├── routes/ # 路由（6 文件 / 70 条）
│ ├── common/ # 通用（3 文件 / 42 条）
│ └── contexts/ # 上下文（1 文件 / 1 条）
└── opencode-zh-CN/ # OpenCode 源码（自动克隆）
🌙 Nightly 自动构建系统
- 🚀 新增每小时自动检测官方更新的 Nightly 工作流
- 📦 自动构建 5 个平台版本（Windows/macOS/Linux）
- 🔢 汉化版本号自动递增管理
- 📊 自动检测和记录汉化文件变更
- 📝 自动更新 CHANGELOG 和 README 文档
- 🌙 Nightly Release 持续更新
同步工具 + 自动修复
- 🔄 菜单新增"🔄 同步工具"选项，一键更新汉化工具到最新版本
- 🩹 编译失败时自动检测汉化配置版本问题并尝试自动修复
- 📝 添加常见问题解答文档，覆盖编译错误排查指南
- 🎨 AI 总结合并到执行总结框内，界面更简洁
TUI 视觉体验全面升级
- ✨ 统一 TUI 输出系统（连接线青色、徽章
●、日志整洁） - 🌠 Knight Rider 流星动画（14 格粉色渐变尾巴）
- 🎨 AI 总结格式化（
▸青色、【】黄色高亮） - 📝 智能换行（只在标点后断行）
- 🔧 GitHub Actions 自动构建多平台版本
- 🚀 初始版本发布
- AI 自动翻译 + 增量翻译
- 质量检查 + 自动修复
- 覆盖率报告 + AI 智能总结
- 跨平台支持（macOS/Linux/Windows）
问题现象：
error: Could not resolve: "./dialog-session - 重命名"
error: Unexpected token, expected ","
原因： 使用了旧版本或有问题的汉化配置文件。
✨ 自动修复（v1.1.31+）：
从 v1.1.31-zh 开始，工具会自动检测这类错误并尝试修复：
◇ 编译构建
● 进程退出，代码: 1
error: Could not resolve: "./dialog-session - 重命名"
⚠️ 检测到汉化配置版本问题，尝试自动修复...
├─ 恢复官方源码
├─ 更新汉化配置
├─ 重新应用汉化
✓ 自动更新完成
✓ 已更新到最新版本，重新编译...
✓ 编译成功
手动修复方案：
# 1. 更新到最新版本
cd OpenCodeChineseTranslation
git pull origin main
# 2. 恢复官方源码纯净状态
cd opencode-zh-CN/packages/opencode
git checkout -- .
# 3. 重新执行汉化
cd ../../../
node scripts/bin/opencodenpm sync
node scripts/bin/opencodenpm full预防措施：
- 定期执行
git pull origin main更新汉化工具 - 不要手动修改
opencode-i18n/目录中的配置文件 - 使用
sync命令确保源码和汉化同步
# 查看当前版本
opencodenpm --version
# 检查是否有更新
cd OpenCodeChineseTranslation
git log --oneline -1如果本地版本低于 v1.1.31-zh，请立即更新。
- 项目地址: https://github.com/xiaolajiaoyyds/OpenCodeChineseTranslation
- OpenCode 官方: https://github.com/anomalyco/opencode
- Antigravity Tools: https://agtools.cc
- 原汉化项目: QinTian 的帖子
- Oh-My-OpenCode: https://github.com/code-yeongyu/oh-my-opencode
MIT License | OpenCode 原项目版权归 Anomaly Company 所有
本汉化项目基于 1186258278 和 @QinTian 的工作进行维护和改进。
感谢所有贡献者和使用者的支持！
有问题欢迎在 Issues 留言~
在报告问题前，建议先备份配置文件！