整理 opencode 接入方式，embedded 和 client 模式

README.md

@@ -150,7 +150,12 @@ typescript
 
 ## 启动与部署
 
-默认部署不需要全局安装 `opencode` CLI。服务会通过 `@opencode-ai/sdk` 的 embedded 模式启动 opencode server。
+支持两种 opencode 接入方式：
+
+1. Embedded 模式：服务通过 `@opencode-ai/sdk` 调用 `createOpencode`，启动本地 `opencode` CLI 子进程并自动创建 client。
+2. Client 模式：服务通过 `createOpencodeClient` 直接连接一个已经存在的 opencode server。
+
+因此，只有 Embedded 模式要求运行环境已安装 `opencode` CLI；Client 模式不依赖本地 CLI。
 
 根目录的 Bun scripts 已经封装 `.opencode` 依赖安装和类型检查，日常只需要在 `TJWaterAgent/` 根目录操作。
 
@@ -175,9 +180,21 @@ opencode.json
 
 因此修改 agent prompt、tools、skills、模型配置或本地环境变量后，不需要手动重启 `bun run dev`。
 
-本地开发可以在项目根目录的 `.local.env` 中配置环境变量：
+本地开发可以在项目根目录的 `.local.env` 中配置环境变量。
+
+Embedded 模式示例：
 
 ```bash
+OPENCODE_MODE=embedded
+DEEPSEEK_API_KEY=sk-xxx
+TJWATER_API_BASE_URL=http://127.0.0.1:8000
+```
+
+Client 模式示例：
+
+```bash
+OPENCODE_MODE=client
+OPENCODE_CLIENT_BASE_URL=http://127.0.0.1:4096
 DEEPSEEK_API_KEY=sk-xxx
 TJWATER_API_BASE_URL=http://127.0.0.1:8000
 ```
@@ -287,8 +304,10 @@ bun run start
 如果需要连接外部独立运行的 opencode server，可以配置：
 
 ```bash
-OPENCODE_BASE_URL=http://127.0.0.1:4096
+OPENCODE_MODE=client
+OPENCODE_CLIENT_BASE_URL=http://127.0.0.1:4096
 ```
 
 配置后，`TJWaterAgent` 会连接该外部 opencode server，而不是自行启动 embedded opencode server。
->>>>>>> 414247d (新增 skills、README，指定  opencode 的启动行为)
+
+兼容说明：历史环境变量 `OPENCODE_BASE_URL` 仍可使用，但建议迁移为 `OPENCODE_CLIENT_BASE_URL`，并显式设置 `OPENCODE_MODE=client`。