更新配置和聊天路由，添加会话中止与分叉功能

README.md

@@ -35,6 +35,22 @@ TJWaterAgent/
 6. 为 `.opencode/tools/dynamic_http_call.ts` 提供内部回调接口。
 7. 代理调用真实 TJWater 后端 API。
 
+当前 Agent API 的主入口：
+
+```text
+POST /api/v1/agent/chat/stream
+```
+
+该接口返回 SSE，事件包括：
+
+| event | 用途 |
+| --- | --- |
+| `progress` | 前端过程可视化，展示规划、工具调用和完成状态 |
+| `token` | 最终回答文本流 |
+| `tool_call` | 前端地图/面板/图表动作 |
+| `done` | 当前轮完成 |
+| `error` | 当前轮失败 |
+
 主要目录和文件：
 
 ```text
@@ -132,24 +148,122 @@ typescript
 
 这两组依赖不要混在一起：根目录负责服务运行，`.opencode` 负责 opencode 扩展资产的类型检查和运行依赖。
 
-## 部署安装
+## 启动与部署
 
 默认部署不需要全局安装 `opencode` CLI。服务会通过 `@opencode-ai/sdk` 的 embedded 模式启动 opencode server。
 
-推荐安装和启动流程：
+根目录的 npm scripts 已经封装 `.opencode` 依赖安装和类型检查，日常只需要在 `TJWaterAgent/` 根目录操作。
+
+### 本地开发
+
+```bash
+cd TJWaterAgent
+npm install
+npm run dev
+```
+
+`npm install` 会通过 `postinstall` 自动执行 `.opencode` 依赖安装；`npm run dev` 启动前会检查 `.opencode/tools` 的类型。
+
+开发模式支持热重载，以下文件变化会触发服务重启并重新拉起 embedded opencode：
+
+```text
+src/**
+.opencode/**
+opencode.json
+.local.env
+```
+
+因此修改 agent prompt、tools、skills、模型配置或本地环境变量后，不需要手动重启 `npm run dev`。
+
+本地开发可以在项目根目录的 `.local.env` 中配置环境变量：
+
+```bash
+DEEPSEEK_API_KEY=sk-xxx
+TJWATER_API_BASE_URL=http://127.0.0.1:8000
+```
+
+服务启动时会自动读取 `.local.env`，但系统环境变量优先级更高，适合在本机保存开发用 key。
+
+### 生产启动
 
 ```bash
 cd TJWaterAgent
 npm install
 npm run build
-
-cd .opencode
-npm install
-
-cd ..
 npm run start
 ```
 
+也可以使用一条命令完成构建并启动：
+
+```bash
+cd TJWaterAgent
+npm install
+npm run start:prod
+```
+
+### 常用脚本
+
+| 命令 | 作用 |
+| --- | --- |
+| `npm run dev` | 类型检查 `.opencode` tools 后，以 watch 模式启动服务，并监听 `src`、`.opencode`、`opencode.json`、`.local.env` |
+| `npm run build` | 构建服务并类型检查 `.opencode` tools |
+| `npm run start` | 启动已构建的 `dist/server.js` |
+| `npm run start:prod` | 先构建再启动 |
+| `npm run check` | 执行完整构建检查 |
+| `npm run install:opencode` | 手动安装 `.opencode` 依赖 |
+
+### 模型与 API 配置
+
+默认 Agent 模型为：
+
+```text
+deepseek/deepseek-v4-pro
+```
+
+涉及位置：
+
+```text
+opencode.json
+.opencode/agents/tjwater-assistant.md
+src/config.ts 的 OPENCODE_MODEL 默认值
+```
+
+如果需要临时覆盖模型，可以在启动时设置：
+
+```bash
+OPENCODE_MODEL=deepseek/deepseek-v4-pro npm run start
+```
+
+DeepSeek API key 不写入代码，部署时通过环境变量设置：
+
+```bash
+DEEPSEEK_API_KEY=sk-xxx npm run start
+```
+
+`opencode.json` 已配置从环境变量读取：
+
+```json
+{
+  "provider": {
+    "deepseek": {
+      "options": {
+        "apiKey": "{env:DEEPSEEK_API_KEY}"
+      }
+    }
+  }
+}
+```
+
+如果需要自定义 DeepSeek 兼容 API 地址，可以通过 opencode 的 provider 配置增加 `baseURL`，例如在部署环境使用 `OPENCODE_CONFIG_CONTENT` 覆盖：
+
+```bash
+OPENCODE_CONFIG_CONTENT='{"provider":{"deepseek":{"options":{"baseURL":"https://your-api.example.com/v1"}}}}' \
+DEEPSEEK_API_KEY=sk-xxx \
+npm run start
+```
+
+也可以使用 opencode 的 `/connect` 命令写入用户级凭据，但服务部署更推荐使用环境变量。
+
 如果需要连接外部独立运行的 opencode server，可以配置：
 
 ```bash