Update README.zh.md

Added research mode section with workflows and tools.

Author: deepelementlab

README.zh.md

@@ -29,6 +29,7 @@
   <a href="#快速开始">快速开始</a> •
   <a href="#为什么选择-clawcode">为什么选择 ClawCode</a> •
   <a href="#核心特性">核心特性</a> •
+  <a href="#研究模式">研究模式</a> •
   <a href="#文档">文档</a> •
   <a href="#贡献">贡献</a>
 </p>
@@ -94,6 +95,24 @@ ClawCode 内置 **ECAP**（经验胶囊）和 **TECAP**（团队经验胶囊）
 /clawteam --deep_loop "设计微服务架构"             # 收敛式迭代
 ```
 
+### 🔬 研究模式（`clawcode research`）
+
+多阶段调查研究工作流，支持工具支持的证据收集：
+
+| 工作流 | 用途 |
+|--------|------|
+| `deepresearch` | 模板驱动：计划 → 研究 → 验证 → 交付 |
+| `peerreview` | 带验证的批判性审查 |
+| `lit` | 文献综述 |
+| `audit` | 审查 URL/仓库/产物 |
+
+**研究工具：** `research_web_search`（Firecrawl/Tavily/Parallel）、`research_paper_search`（arXiv/Semantic Scholar）、`research_fetch_url`、`research_sandbox_exec`、`research_code_audit`。
+
+```bash
+clawcode research start "量子纠错" --workflow deepresearch -o ./outputs/qec
+clawcode research list-prompts  # 查看可用模板
+```
+
 ### 🔧 44 个内置工具
 
 | 类别 | 示例 |
@@ -103,6 +122,7 @@ ClawCode 内置 **ECAP**（经验胶囊）和 **TECAP**（团队经验胶囊）
 | 浏览器 | `browser_*`（×11 自动化工具） |
 | 代理 | 隔离的子代理生成 |
 | 集成 | MCP、Sourcegraph、桌面自动化 |
+| 研究 | `research_*`（网页、论文、审计） |
 
 
 ### 🔄 兼容 Claude Code
@@ -111,15 +131,49 @@ ClawCode 内置 **ECAP**（经验胶囊）和 **TECAP**（团队经验胶囊）
 
 ## 快速开始
 
+### 1. 安装
+
 ```bash
 cd clawcode
 python -m venv .venv
 .\.venv\Scripts\Activate.ps1   # Windows
 pip install -e ".[dev]"
-clawcode -c "/path/to/project"
 ```
 
-**前置要求：** Python >=3.12，至少一个 LLM 提供商的凭证。
+**前置要求：** Python >=3.12
+
+### 2. 配置
+
+在项目根目录创建 `.clawcode.json`：
+
+```json
+{
+  "providers": {
+    "openai": {
+      "api_key": "sk-...",
+      "disabled": false
+    }
+  },
+  "agents": {
+    "coder": {
+      "model": "gpt-4o",
+      "provider_key": "openai"
+    }
+  }
+}
+```
+
+或使用环境变量：
+```bash
+export CLAWCODE_OPENAI__API_KEY="sk-..."
+```
+
+### 3. 运行
+
+```bash
+clawcode -c "/path/to/project"         # 交互式 TUI
+clawcode -p "重构这个 API"              # 非交互式
+```
 
 ## 文档
 
@@ -131,6 +185,80 @@ clawcode -c "/path/to/project"
 | 斜杠命令参考 | [docs/slash-commands.md](docs/slash-commands.md) / [docs/slash-commands.zh.md](docs/slash-commands.zh.md) |
 | 配置指南 | [docs/clawcode-configuration.md](docs/clawcode-configuration.md) |
 | 性能与测试 | [docs/clawcode-performance.md](docs/clawcode-performance.md) / [docs/clawcode-performance.zh.md](docs/clawcode-performance.zh.md) |
+| 研究模式 | [docs/research_mode.md](docs/research_mode.md) |
+
+---
+
+## 研究模式
+
+ClawCode 包含独立的 **research** 子命令，用于多阶段调查研究工作流，支持工具支持的证据收集。
+
+### 工作流
+
+| 工作流 | 命令 | 描述 |
+|--------|------|------|
+| `deepresearch` | `clawcode research start "主题" -w deepresearch` | 4阶段模板：计划 → 研究 → 验证 → 交付 |
+| `peerreview` | `clawcode research start "主题" -w peerreview` | 批判性审查：审查 → 验证 → 交付 |
+| `lit` | `clawcode research start "主题" -w lit` | 文献综述 |
+| `audit` | `clawcode research audit <url>` | 审查 URL/仓库/产物 |
+| `compare` | `clawcode research start "主题" -w compare` | 并排对比 |
+
+### 研究工具
+
+- `research_web_search` — 网页搜索，支持 Firecrawl/Tavily/Parallel（DuckDuckGo 降级）
+- `research_paper_search` — arXiv + 可选 Semantic Scholar
+- `research_fetch_url` — 获取并提取页面内容
+- `research_sandbox_exec` — 在沙箱中执行 Shell
+- `research_code_audit` — 对比声明与仓库代码
+
+### 快速示例
+
+```bash
+# 带 Markdown 模板阶段的深度研究
+clawcode research start "量子纠错" --workflow deepresearch -o ./outputs/qec
+
+# 同行评审提案
+clawcode research start "评审：LLM 缩放定律" --workflow peerreview -o ./outputs/review
+
+# 审计仓库
+clawcode research audit https://github.com/example/repo -o ./outputs/audit
+
+# 列出可用模板
+clawcode research list-prompts
+
+# 验证配置而不调用 LLM
+clawcode research start "测试" --dry-run
+```
+
+### 配置
+
+在 `.clawcode.json` 中添加：
+
+```json
+{
+  "web": {
+    "backend": "firecrawl",
+    "firecrawl_api_key": "YOUR_KEY",
+    "tavily_api_key": "YOUR_KEY",
+    "parallel_api_key": ""
+  },
+  "research": {
+    "enabled": true,
+    "s2_api_key": "YOUR_SEMANTIC_SCHOLAR_KEY",
+    "subagents": { "max_concurrent": 3 }
+  }
+}
+```
+
+**可选的 API 密钥：**
+- [Firecrawl](https://firecrawl.dev) — 增强的网页搜索/提取
+- [Tavily](https://tavily.com) — 研究优化的搜索
+- [Parallel](https://parallel.ai) — 替代搜索后端
+- [Semantic Scholar](https://www.semanticscholar.org/product/api) — 论文更高限流
+
+无需 API 密钥时，研究功能将降级到 DuckDuckGo（网页）和 arXiv（论文，无需密钥）。
+
+---
 
 ## 测试结果