OpenCode 中文汉化版

中文 | English

中文文档

项目简介

OpenCode 是由 Anomaly Company 开发的开源 AI 编程代理，提供终端界面 (TUI)、桌面应用和 IDE 扩展等多种使用方式。

OpenCode 中文汉化版是对 OpenCode 项目的本地化改造，通过模块化汉化配置和自动化脚本实现完整中文化，降低国内用户使用门槛。

核心功能：

• 🤖 AI 辅助编程 - 解释代码、添加功能、重构修改
• 📋 Plan 模式 - 先规划后实施，支持图片参考和迭代讨论
• ↩️ 撤销/重做 - /undo 和 /redo 命令轻松回退
• 🔗 对话分享 - 生成链接与团队协作
• 🔌 多模型支持 - 兼容各类 LLM 提供商

本项目解决的问题：

🚀 快速开始

步骤 1：安装 Codes 管理工具

Codes 是本项目的开发环境管理工具，安装后获得全局命令：

# Linux/macOS (推荐使用 Gitee 镜像)
curl -fsSL https://gitee.com/QtCodeCreators/OpenCodeChineseTranslation/raw/main/scripts/install.sh | bash

# Windows PowerShell
irm https://gitee.com/QtCodeCreators/OpenCodeChineseTranslation/raw/main/scripts/install.ps1 | iex

安装完成后重启终端，即可使用 codes 命令。

步骤 2：环境诊断

codes doctor

步骤 3：安装缺失组件

codes install

🛠️ Codes 命令参考

Codes 是开发环境智能管理工具，提供一键安装、版本管理、环境诊断等功能。

基础命令

支持的组件

菜单选项

╔═══════════════════════════════════════════════╗
║           Codes - 开发环境管理工具               ║
╠═══════════════════════════════════════════════╣
║  [1] 环境诊断       - 检查所有工具状态           ║
║  [2] 安装组件       - 安装缺失的工具             ║
║  [3] 升级组件       - 升级已安装的工具             ║
║  [4] Node 管理     - 切换 Node.js 版本          ║
║  [5] Claude Code   - 安装 Claude Code          ║
║  [6] OpenCode      - 安装 OpenCode 汉化版       ║
║  [7] 汉化管理工具   - 安装汉化脚本                ║
║  [8] 智谱助手      - 启动 coding-helper        ║
║  [9] 环境变量       - 显示/导出环境变量            ║
║  [p] 永久配置      - 一键写入环境变量             ║
║  [u] 检查更新      - 检查 Codes 新版本          ║
║  [U] 更新 Codes    - 自动更新到最新版            ║
║  [0] 退出                                        ║
╚═══════════════════════════════════════════════╝

📦 OpenCode 安装部署

重要：本项目使用相对路径设计，可放置在任意目录运行。

方式一：使用 Codes 安装（推荐）

# 1. 安装 Codes (如果还没安装)
curl -fsSL https://gitee.com/QtCodeCreators/OpenCodeChineseTranslation/raw/main/scripts/install.sh | bash

# 2. 克隆本仓库
git clone https://gitee.com/QtCodeCreators/OpenCodeChineseTranslation.git
cd OpenCodeChineseTranslation

# 3. 使用 Codes 一键初始化
codes opencode
codes i18n

方式二：手动克隆

# 克隆本仓库
git clone https://gitee.com/QtCodeCreators/OpenCodeChineseTranslation.git
cd OpenCodeChineseTranslation

# 首次运行会自动初始化
.\scripts\opencode\opencode.ps1

🎯 OpenCode 使用方法

一键汉化+部署

.\scripts\opencode\opencode.ps1
# 选择 [1] 一键汉化+部署

主菜单

📂 项目结构

OpenCodeChineseTranslation/
├── scripts/                 # 管理脚本目录
│   ├── install.sh           # Codes 一键安装脚本
│   └── codes/               # Codes 核心脚本
│       ├── codes.sh         # Linux/macOS 版本
│       └── README.md        # Codes 详细文档
├── scripts/opencode/        # OpenCode 汉化脚本
│   ├── opencode.ps1         # 主脚本 (4700+ 行)
│   └── init.ps1             # 自动初始化脚本
├── opencode-i18n/           # 汉化配置目录
│   ├── config.json          # 主配置文件
│   ├── dialogs/             # 对话框汉化
│   ├── routes/              # 路由汉化
│   ├── components/          # 组件汉化
│   └── common/              # 通用汉化
├── opencode-zh-CN/          # OpenCode 源码 (自动克隆)
└── docs/                    # 项目文档

🔧 常见问题

📊 汉化范围

🤝 贡献指南

欢迎贡献代码和翻译！

1. 修复翻译错误：提交 PR 修改 opencode-i18n/ 下的 JSON 文件
2. 新增汉化模块：在对应目录添加新的 JSON 文件并更新 config.json
3. 脚本优化：提交 PR 修改 scripts/opencode/opencode.ps1
4. Codes 优化：提交 PR 修改 scripts/codes/codes.sh

📄 许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

OpenCode 原项目采用 MIT 许可证，版权归 Anomaly Company 所有。

🔗 相关链接

English Documentation

Project Overview

OpenCode is an open-source AI coding agent developed by Anomaly Company, providing TUI, desktop app, and IDE extensions.

OpenCode Chinese Translation is a localized version with complete Chinese translation through modular configuration and automated scripts.

Key Features:

• 🤖 AI-assisted coding - Explain, add features, refactor
• 📋 Plan mode - Plan first, execute later
• ↩️ Undo/Redo - Easy rollback with /undo and /redo
• 🔗 Share conversations - Generate links for collaboration
• 🔌 Multi-model support - Compatible with various LLM providers

Quick Start

Step 1: Install Codes

Codes is the development environment manager for this project:

# Linux/macOS (Gitee mirror recommended)
curl -fsSL https://gitee.com/QtCodeCreators/OpenCodeChineseTranslation/raw/main/scripts/install.sh | bash

# Windows PowerShell
irm https://gitee.com/QtCodeCreators/OpenCodeChineseTranslation/raw/main/scripts/install.ps1 | iex

Restart your terminal after installation.

Step 2: Environment Check

codes doctor

Step 3: Install Missing Components

codes install

Codes Commands

OpenCode Installation

# Clone repository
git clone https://gitee.com/QtCodeCreators/OpenCodeChineseTranslation.git
cd OpenCodeChineseTranslation

# Run the script
./scripts/opencode/opencode.ps1  # Windows

License

This project is licensed under MIT. See LICENSE for details.

OpenCode original project is also MIT licensed, copyright by Anomaly Company.

Links