docs: wiki 三端联调V2结果 + 调试环境信息

- known-issues: 新增V2联调测试（17项通过 + 3项待处理 + SSE token修复）
- development: 新增完整调试环境文档（Windows/PostgreSQL/端口/账号/启动顺序）
- log: 追加V2联调记录

wiki/development.md

@@ -1,6 +1,6 @@
 ---
 title: 开发规范
-updated: 2026-04-14
+updated: 2026-04-15
 status: active
 tags: [development, conventions]
 ---
@@ -106,6 +106,89 @@ pnpm start:dev
 
 前提: Chrome 146+ + `chrome://flags/#enable-webmcp-testing`
 
+## 调试环境（Windows）
+
+> 新会话联调必读。ZCLAW 在 Windows 本地开发，不使用 Docker。
+
+### 环境要求
+
+| 依赖 | 说明 | 验证命令 |
+|------|------|----------|
+| PostgreSQL 18 | Windows 服务，端口 5432 | `powershell -c "Get-Service postgresql-x64-18"` |
+| Node.js + pnpm | 前端开发 | `pnpm --version` |
+| Rust nightly | 后端编译 | `cargo --version` |
+| Tauri CLI | 桌面端开发 | `pnpm tauri --version` |
+
+### 数据库
+
+```bash
+# 连接信息
+Host: localhost:5432
+Database: zclaw
+User: postgres
+Password: 123123
+
+# 完整 URL
+postgresql://postgres:123123@localhost:5432/zclaw
+```
+
+### SaaS 后端启动
+
+```bash
+# 设置环境变量（必须）
+export ZCLAW_SAAS_DEV=true
+export DB_PASSWORD=123123
+export ZCLAW_SAAS_JWT_SECRET="zclaw-dev-jwt-secret-for-testing-only-32chars"
+export ZCLAW_TOTP_ENCRYPTION_KEY="0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
+export ZCLAW_ADMIN_USERNAME="admin"
+export ZCLAW_ADMIN_PASSWORD="admin123"
+
+# 启动
+cargo run -p zclaw-saas
+
+# 验证（注意：health 端点是 /api/health，不是 /api/v1/health）
+curl http://localhost:8080/api/health
+```
+
+### 默认账号
+
+| 用途 | 用户名 | 密码 | 说明 |
+|------|--------|------|------|
+| 管理员 | admin | admin123 | super_admin 角色 |
+| SaaS 管理员 | admin | admin123 | Tauri 桌面端 + Admin V2 共用 |
+| Admin V2 | admin | admin123 | http://localhost:5173 |
+
+### 端口分配
+
+| 服务 | 端口 | URL |
+|------|------|-----|
+| SaaS 后端 | 8080 | http://localhost:8080 |
+| Admin V2 | 5173 | http://localhost:5173 |
+| 桌面端 Vite | 1420 | http://localhost:1420（Tauri 内嵌） |
+
+### 启动顺序
+
+1. 确保 PostgreSQL 运行（Windows 服务自动启动）
+2. 启动 SaaS 后端：`cargo run -p zclaw-saas`（需设置环境变量）
+3. 启动桌面端：`pnpm desktop` 或 `pnpm start:dev`
+4. Admin V2：桌面端启动后自动可用，或单独 `cd admin-v2 && pnpm dev`
+
+### 调试工具
+
+| 工具 | 用途 | 说明 |
+|------|------|------|
+| Tauri MCP | 桌面端内部状态 | `mcp__tauri-mcp__*` 系列工具 |
+| Chrome DevTools MCP | Admin V2 页面调试 | `mcp__chrome-devtools__*` 系列工具 |
+| WebMCP | 桌面端结构化调试 | 需 Chrome 146+，优先使用 |
+| curl | SaaS API 快速验证 | 注意 admin token 通过 `/api/v1/auth/login` 获取 |
+
+### 注意事项
+
+- **Health 端点**: `/api/health`（非 `/api/v1/health`）
+- **SaaS 登录**: `POST /api/v1/auth/login`，返回 `token` 字段
+- **模型 API Key**: Provider 需在 Admin V2 模型服务页配置并启用 Key，否则聊天 404
+- **中转任务清理**: Provider Key 禁用后，已创建的中转任务会卡在 "processing"
+
 ## Wiki 维护（收尾步骤）
 
 完成工作后，检查 wiki/ 是否需要更新：