feat(docs): add advanced OpenCode configuration guide

Add three new sections under the OpenCode chapter in modern-cli:
- Advanced model & API configuration (opencode.json)
- MCP server setup for OpenCode
- Tips, AGENTS.md, and troubleshooting

Both zh-cn and en versions.

docs/zh-cn/stage-2/backend/modern-cli/index.md

@@ -615,6 +615,122 @@ Prometheus (claude-opus-4-7 / kimi-k2.6 / glm-5.1) 是你的战略规划师。
 
 了解完这些, 你就可以使用装好 Oh-My-OpenAgent 插件之后的 OpenCode 来完成编码任务了。
 
+#### 配置模型与 API（进阶）
+
+通过 `/connect` 可以在聊天界面中快速接入模型，但如果你需要更精细的控制——比如为不同任务指定不同模型、配置多个 API Provider 备用——就可以直接编辑 OpenCode 的配置文件 `opencode.json`。
+
+这个文件位于 `~/.config/opencode/opencode.json`（Windows 路径：`C:\Users\你的用户名\.config\opencode\opencode.json`），首次启动 OpenCode 时会自动生成。
+
+以下是一个接入百炼平台（阿里云）Qwen 模型的配置示例：
+
+```json
+{
+  "model": "bailian-coding-plan/qwen3.5-plus",
+  "small_model": "bailian-coding-plan/qwen3.5-plus",
+  "provider": {
+    "bailian-coding-plan": {
+      "options": {
+        "apiKey": "sk-你的API密钥"
+      }
+    }
+  }
+}
+```
+
+> 💡 `model` 字段的格式为 `提供商/模型名称`。你可以在对应平台注册并获取 API Key 后，替换上面的 `apiKey` 值。
+
+如果你想同时配置多个模型，可以在配置中指定不同任务分类：
+
+```json
+{
+  "model": "bailian-coding-plan/qwen3.5-plus",
+  "categories": {
+    "visual-engineering": {
+      "model": "bailian-coding-plan/qwen3.5-plus",
+      "description": "前端、UI/UX、设计、样式"
+    },
+    "ultrabrain": {
+      "model": "bailian-coding-plan/qwen3-coder-next",
+      "description": "复杂逻辑、算法、架构决策"
+    },
+    "quick": {
+      "model": "opencode-go/minimax-m2.5",
+      "description": "简单修改、拼写修复"
+    }
+  }
+}
+```
+
+这样，OpenCode 就会根据任务类型自动选择最合适的模型：简单修改用快模型节省成本，复杂架构问题用更强模型保证质量。
+
+#### 使用 MCP 服务器扩展 OpenCode
+
+MCP（Model Context Protocol）是一个开放协议，让 AI 编程工具可以调用外部工具——比如操作浏览器、搜索网络、分析图片等。OpenCode 原生支持 MCP，配置方式和 Claude Code 类似。
+
+在 `opencode.json` 的 `mcp` 字段中添加服务器配置：
+
+```json
+{
+  "mcp": {
+    "chrome-devtools": {
+      "type": "local",
+      "command": ["npx", "-y", "chrome-devtools-mcp@latest"]
+    },
+    "zai-mcp-server": {
+      "type": "local",
+      "command": ["npx", "-y", "@z_ai/mcp-server"]
+    }
+  }
+}
+```
+
+配置完成后重启 OpenCode，AI 就能在对话中自动调用这些工具——比如帮你打开浏览器截图、分析 UI 设计图、搜索网页信息等。
+
+> 🎯 **实用场景**：当你需要 AI 帮你分析一个网页的布局问题时，配上 chrome-devtools MCP，直接说「帮我打开这个页面，看看为什么按钮位置不对」，AI 就能自动打开浏览器、截图、分析并给出修复建议。
+
+#### 日常使用技巧与常见问题
+
+**使用 AGENTS.md 指导 AI 行为**
+
+在项目根目录创建 `AGENTS.md` 文件，可以告诉 OpenCode 你的项目约定和偏好。AI 每次启动时会自动读取这个文件：
+
+```markdown
+## 项目约定
+- 使用 TypeScript 严格模式
+- API 响应必须符合 JSON Schema
+- 错误处理使用自定义 Error 子类
+
+## 开发流程
+1. 修改前先理解现有代码
+2. 小步提交，每次提交一个逻辑单元
+3. 完成后运行 npm test 验证
+
+## 禁止事项
+- 不要使用 any 类型
+- 不要删除测试文件
+```
+
+**并行探索代码库**
+
+当你不熟悉一个项目时，可以让 OpenCode 同时搜索多个方面：
+
+> 帮我同时做这几件事：
+> 1. 搜索项目中所有处理 HTTP 请求的地方
+> 2. 找出数据库相关的代码
+> 3. 列出项目的目录结构和各模块职责
+
+OpenCode 会并行执行这些探索任务，一次性给你完整的代码库地图。
+
+**常见问题**
+
+| 问题 | 解决方法 |
+|------|---------|
+| `opencode` 命令找不到 | npm 全局目录不在 PATH 中。在终端执行：`[Environment]::SetEnvironmentVariable("Path", "$env:Path;$env:USERPROFILE\AppData\Roaming\npm", "User")` 后重启终端 |
+| AI 响应很慢 | 简单任务使用 quick 分类（自动路由到快模型）；对话历史太长时可以开新会话 |
+| API 调用失败 | 检查 API Key 是否正确、模型名称拼写是否准确（provider/model-name 格式）、账户余额是否充足 |
+| 技能（Skills）不生效 | 确认 SKILL.md 文件格式正确（需要 YAML frontmatter），且 description 字段准确描述了触发条件 |
+| 对话上下文太长 | 开启新会话，或在 AGENTS.md 中定义关键约定让新会话也能继承 |
+
 ## CLI AI 编程工具的更多用法
 
 ### 用 AI 写需求文档：学会“具体化需求”