OpenCode 中文支持指南

在 Issue #8122↗ 中，许多用户询问是否有“汉化系统”或如何让 OpenCode 更好地支持中文。

本文将详细说明 OpenCode目前的中文支持情况，包括界面汉化和 AI 交互语言的配置。

# 1. 界面汉化 (GUI/TUI)#

现状：目前 OpenCode 的终端用户界面（TUI）、命令行提示（CLI）以及菜单选项暂无官方的中文语言包。所有的系统级交互文本（如 /help、菜单选项、错误提示）均为英文。

未来计划：多语言界面支持（i18n）已列入开发计划，但目前优先级较低（P3）。这意味着在短期内，官方版本仍将保持英文界面。

建议：

如果你对某个英文命令不熟悉，可以随时询问 AI（例如：“/connect 命令是做什么的？”），AI 会用中文为你解释。
参考 OpenCode 中文文档↗ 获取所有命令和功能的详细中文说明。

# 2. 设置 AI 回复语言#

虽然界面是英文的，但你可以完全控制 AI 助手（Sisyphus/OpenCode Agent）使用什么语言与你交流。

## 方法一：全局记忆设置（推荐）#

这是最有效的方法。OpenCode 拥有一个持久化的记忆系统。你可以直接告诉它你的偏好，它会在所有项目和会话中记住这一点。

在 OpenCode 终端中运行：

bash
/memory set preference.language "Chinese"

或者直接用自然语言告诉它：

"Please always respond in Simplified Chinese, regardless of the user interface language."

设置成功后，即使你用英文提问，AI 也会默认尝试用中文回复，或者遵循你的特定语言习惯。

## 方法二：全局配置文件#

你可以在全局配置文件 ~/.config/opencode/opencode.json 中添加通用指令：

json
1{
2  "$schema": "https://opencode.ai/config.json",
3  "instructions": [
4    "请始终使用简体中文进行回复，除非我明确要求使用其他语言。",
5    "涉及编程术语时，请保留英文原文并（在必要时）提供中文解释。"
6  ]
7}

## 方法三：项目级配置 (AGENTS.md)#

如果你希望在特定项目中让 AI 遵循特定的语言规范（例如：提交信息必须用中文，或者必须用英文），可以在项目根目录创建 AGENTS.md 文件：

markdown
1<!-- AGENTS.md -->
2# 项目语言规范
3
4- **日常交流**：使用简体中文。
5- **代码注释**：使用英文。
6- **Git Commit**：使用中文，格式遵循 "feat: 新增功能"。

OpenCode 会自动读取并遵循这些规则。

# 3. 中文文档资源#

为了弥补界面未汉化的不足，我们维护了完整的中文文档站：

官方中文站: https://opencode.cn↗
GitHub 仓库: anomalyco/opencode↗

如果你有兴趣通过社区力量推进界面汉化，欢迎关注 GitHub 仓库的贡献指南。