Skip to content

README_EN.md

Latest commit

 

History

History
155 lines (109 loc) · 5.49 KB

README_EN.md

File metadata and controls

155 lines (109 loc) · 5.49 KB

OpenCode Chinese Translation Distribution

Release Platform Build Status License

中文文档

🚀 OpenCode Chinese Distribution | ⚡️ Daily Sync with Official | Automated Cross-Platform Builds (Win/Mac/Linux)

Overview

OpenCode Chinese Translation is a fully automated localization project for OpenCode. We've built a complete CI/CD pipeline using GitHub Actions that daily pulls the latest source code, applies Chinese translation patches, and builds installation packages for Windows, macOS, and Linux.

Key Features:

  • ⚡️ Daily Auto-Updates: Stay up-to-date with the latest official features.
  • 📦 Cross-Platform Support: Provides Windows, macOS (Apple Silicon), and Linux binaries.
  • 🚀 Zero-Dependency Installation: New Go-based CLI tool, no Node.js or Bun required.
  • 🔧 Complete Localization: Covers TUI, dialogs, and core workflows.

Quick Start

1. One-Line Installation (Recommended)

The new installation scripts download the Go-based CLI tool directly, requiring no runtime dependencies.

Windows (PowerShell)

powershell -c "irm https://cdn.jsdelivr.net/gh/1186258278/OpenCodeChineseTranslation@main/install.ps1 | iex"

Linux / macOS

curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenCodeChineseTranslation@main/install.sh | bash

2. Usage

After installation, run in your terminal:

opencode-cli

This launches the interactive menu.

3. Download Prebuilt Version (New in v8.1+)

If you already have opencode-cli installed, use the built-in download feature:

opencode-cli download

This automatically downloads the latest prebuilt Chinese version from GitHub Releases, no local compilation needed.

4. Manual Download

You can also visit the Releases page to download binaries directly.

Platform CLI Tool
Windows x64 opencode-cli-windows-amd64.exe
Windows ARM64 opencode-cli-windows-arm64.exe
macOS Apple Silicon opencode-cli-darwin-arm64
macOS Intel opencode-cli-darwin-amd64
Linux x64 opencode-cli-linux-amd64
Linux ARM64 opencode-cli-linux-arm64

Chinese OpenCode binaries are available as ZIP packages on the Releases page.

CLI Commands

The CLI tool (v8.6.0) provides comprehensive management capabilities:

Command Description
opencode-cli Launch interactive menu (default)
opencode-cli download Download prebuilt Chinese version (no build env required)
opencode-cli env-install One-click install build environment (Git/Node.js/Bun)
opencode-cli update Update OpenCode source code
opencode-cli apply Apply translation patches
opencode-cli verify Verify translation configuration
opencode-cli build Build OpenCode binary
opencode-cli deploy Deploy to system PATH
opencode-cli diagnose Diagnose and fix conflicts/issues
opencode-cli uninstall Uninstall and clean up all files
opencode-cli antigravity Configure Antigravity local AI proxy

Developer Guide

If you want to contribute, please refer to the Contributing Guide.

FAQ

Having issues? Run diagnose first!

opencode-cli diagnose --fix

Auto-detects and fixes version conflicts, missing dependencies, and PATH issues.

Q: Still shows English after install? Run opencode-cli diagnose to detect and clean up conflicting versions.

Q: Build failed?

opencode-cli env-install    # Install Git/Node/Bun
opencode-cli download       # Or download prebuilt (no build env needed)

Q: How to completely uninstall?

opencode-cli uninstall --all

Q: macOS "cannot verify developer"? Run opencode-cli diagnose --fix or manually: xattr -cr /path/to/opencode

Q: Where are files installed? Unified directory structure: ~/.opencode-i18n/

  • bin/ - CLI tool and Chinese OpenCode
  • opencode/ - OpenCode source code
  • build/ - Build output

Windows actual path: %USERPROFILE%\.opencode-i18n\

Q: Local development setup? Developers can customize paths via environment variables:

export OPENCODE_SOURCE_DIR=/path/to/opencode   # Source directory
export OPENCODE_BUILD_DIR=/path/to/bin         # Build output
export OPENCODE_PROJECT_DIR=/path/to/project   # Translation project

Or create opencode/ and bin/ folders in the project directory - CLI auto-detects them.

License

This project is open-sourced under the MIT License. The original OpenCode project is copyright Anomaly Company.