chore: 提交所有工作进度 — SaaS 后端增强、Admin UI、桌面端集成

包含大量 SaaS 平台改进、Admin 管理后台更新、桌面端集成完善、
文档同步、测试文件重构等内容。为 QA 测试准备干净工作树。

docs/features/00-architecture/01-communication-layer.md

@@ -3,8 +3,8 @@
 > **分类**: 架构层
 > **优先级**: P0 - 决定性
 > **成熟度**: L4 - 生产
-> **最后更新**: 2026-03-25
-> **验证状态**: ✅ 代码已验证
+> **最后更新**: 2026-03-28
+> **验证状态**: 代码已验证
 
 ---
 
@@ -12,7 +12,7 @@
 
 ### 1.1 基本信息
 
-通信层是 ZCLAW 前端与内部 ZCLAW Kernel 之间的核心桥梁，通过 Tauri 命令进行所有通信。
+通信层是 ZCLAW 前端与后端能力之间的核心桥梁，支持三种连接模式：本地 Kernel、Gateway WebSocket 和 SaaS Cloud。
 
 | 属性 | 值 |
 |------|-----|
@@ -20,10 +20,10 @@
 | 优先级 | P0 |
 | 成熟度 | L4 |
 | 依赖 | Tauri Runtime 2.x |
-| Tauri 命令数量 | **80+** |
-| Rust Crates | 8 个 (types, memory, runtime, kernel, skills, hands, protocols, pipeline) |
-| 前端代码量 | ~30,000 行 TypeScript/React |
-| 后端代码量 | ~15,000 行 Rust |
+| Tauri 命令数量 | **58+** (kernel 29 + pipeline 13 + viking 13 + llm 3) |
+| Rust Crates | 11 个 (types, memory, runtime, kernel, skills, hands, protocols, pipeline, growth, channels, saas) |
+| 连接模式 | 3 种 (Tauri Kernel / Gateway WebSocket / SaaS Cloud) |
+| SaaS API 路由 | 76+ (Axum + PostgreSQL) |
 
 ### 1.2 相关文件
 
@@ -73,14 +73,15 @@ ZCLAW 采用**内部 Kernel 架构**，所有核心能力都集成在 Tauri 桌
 └─────────────────────────────────────────────────────────────────┘
 ```
 
-### 2.2 双客户端模式
+### 2.2 三客户端模式
 
-系统支持两种客户端模式：
+系统支持三种连接模式：
 
 | 模式 | 客户端类 | 使用场景 |
 |------|---------|----------|
-| **内部 Kernel** | `KernelClient` | Tauri 桌面应用（默认） |
-| **外部 Gateway** | `GatewayClient` | 浏览器环境/开发调试 |
+| **Mode A: Tauri Kernel** | `KernelClient` | Tauri 桌面应用本地直连 LLM (默认) |
+| **Mode B: Gateway WebSocket** | `GatewayClient` | 浏览器环境/开发调试 |
+| **Mode C: SaaS Cloud** | `SaaSClient` | 云端中转，Key 池管理 |
 
 模式切换逻辑在 `connectionStore.ts` 中：
 
@@ -279,7 +280,8 @@ interface CustomModel {
 | zhipu | `https://open.bigmodel.cn/api/paas/v4` | OpenAI 兼容 |
 | openai | `https://api.openai.com/v1` | OpenAI |
 | anthropic | `https://api.anthropic.com` | Anthropic |
-| local | `http://localhost:11434/v1` | OpenAI 兼容 |
+| gemini | `https://generativelanguage.googleapis.com` | Gemini REST |
+| local | `http://localhost:11434/v1` | OpenAI 兼容 (Ollama/LM Studio/vLLM) |
 
 ---
 
@@ -313,12 +315,15 @@ try {
 
 ### 7.1 已实现功能
 
-- [x] 内部 Kernel 集成
-- [x] 多 LLM Provider 支持
+- [x] 内部 Kernel 集成 (Mode A)
+- [x] Gateway WebSocket 连接 (Mode B)
+- [x] SaaS Cloud 中转 (Mode C)
+- [x] 8 个 LLM Provider 支持 (含 Gemini)
 - [x] UI 模型配置
-- [x] 流式响应
+- [x] 流式响应 (Tauri 事件 stream:chunk + SSE)
 - [x] 连接状态管理
 - [x] 错误处理
+- [x] SaaS 30+ API 方法客户端
 
 ### 7.2 测试覆盖
 
@@ -332,13 +337,15 @@ try {
 
 ### 8.1 已完成
 - [x] 内部 Kernel 集成
-- [x] 多 LLM Provider 支持
-- [x] 流式响应（通过 Tauri 事件 `stream:chunk`）
+- [x] 多 LLM Provider 支持 (8 个)
+- [x] 流式响应 (Tauri 事件 `stream:chunk`)
+- [x] SaaS Cloud 模式
+- [x] Gemini Driver
 
-### 8.2 短期计划（1-2 周）
+### 8.2 短期计划
 - [ ] 优化流式响应性能
 
-### 8.3 中期计划（1-2 月）
+### 8.3 中期计划
 - [ ] 支持 Agent 持久化
 - [ ] 支持会话历史存储
 
@@ -360,4 +367,4 @@ try {
 
 ---
 
-**最后更新**: 2026-03-24
+**最后更新**: 2026-03-28