# ZCLAW 待推进工作分析报告

> 基于 `docs/analysis/ZCLAW-DEEP-ANALYSIS.md` 文档的代码现状核实

---

## 一、已完成工作 ✅

文档中建议的部分工作已经完成：

| 任务 | 文档建议 | 当前状态 | 说明 |
|------|----------|----------|------|
| Store 架构迁移 | 拆分 gatewayStore.ts | ✅ 完成 | 14 组件已迁移，gatewayStore 变成 352 行 facade |
| gateway-client 模块化 | 拆分 65KB 文件 | ✅ 完成 | 已拆分为 api/auth/storage/types 4 模块 |
| viking-*.ts 清理 | 合并 5 文件 | ✅ 完成 | 已归档到 docs/archive/v1-viking-dead-code/ |
| E2E 测试框架 | 添加 Playwright | ✅ 完成 | 74+ 测试用例，覆盖 Gateway/Chat/Hands |
| Skill Market MVP | 技能市场 | ✅ 完成 | UI + Store + 发现引擎都已实现 |
| Tauri Rust 后端 | 基础能力 | ✅ 85-90% | OpenFang/OpenViking/浏览器/安全存储都已实现 |

---

## 二、仍需推进的工作 🔴

### 2.1 P0: 真实集成测试（最高优先级）

**问题：** 317 个单元测试通过不代表产品可用

| 验证项 | 当前状态 | 需要做的工作 |
|--------|----------|--------------|
| Gateway 连接 | Mock 测试通过 | 需要连接真实 OpenFang Kernel 验证 |
| 真实模型对话 | Mock 测试通过 | 需要配置 API Key 测试流式响应 |
| 飞书 Channel | 未验证 | OAuth → 消息收发 → Agent 处理 |
| Hands 触发流程 | Mock 测试通过 | 意图识别 → 审批 → 执行 → 结果 |
| 记忆持久化 | 代码存在 | 重启后验证记忆保留 |

**建议行动：**
1. 创建真实环境测试脚本 `scripts/real-integration-test.sh`
2. 编写集成测试清单文档
3. 逐项验证并记录结果

---

### 2.2 P1: Tauri 后端心跳机制

**问题：** 文档提到 `heartbeat_tick` 命令未实现

**当前状态：**
- `gateway-client.ts` 有前端心跳实现（ping/pong）
- Tauri Rust 后端没有独立的心跳 tick 命令

**评估：**
- 前端心跳已足够维持 WebSocket 连接
- Rust 后端心跳可能用于监控 OpenFang 进程健康
- 优先级可降低，但建议添加进程健康检查

---

### 2.3 P2: 配置格式统一

**问题：** TOML 和 JSON 混用

| 文件 | 格式 | 说明 |
|------|------|------|
| config.toml | TOML | 主配置 |
| chinese-providers.toml | TOML | 中文模型配置 |
| plugins/*/plugin.json | JSON | 插件配置 |

**建议：**
- 保持现状（TOML 用于用户配置，JSON 用于插件元数据）
- 或统一全部使用 TOML

---

### 2.4 P2: 低集成度组件验证

根据文档提到的组件：

| 组件 | 当前状态 | 需要验证 |
|------|----------|----------|
| HeartbeatConfig | ✅ 已集成 SettingsLayout | 功能是否正常 |
| CreateTriggerModal | ✅ 已迁移到 useHandStore | 功能是否正常 |
| PersonalitySelector | ❓ 需检查 | 是否已集成 |
| ScenarioTags | ❓ 需检查 | 是否已集成 |
| DevQALoop | ❓ 需检查 | 是否已集成 |

---

### 2.5 P3: 智能层迁移（长期）

**问题：** 前端 lib 承担了后端职责

以下文件在 `desktop/src/lib/` 中，但逻辑上应在后端：

| 文件 | 行数 | 功能 |
|------|------|------|
| agent-memory.ts | ~14KB | Agent 记忆 |
| agent-identity.ts | ~10KB | 身份演化 |
| reflection-engine.ts | ~21KB | 自我反思 |
| heartbeat-engine.ts | ~10KB | 心跳引擎 |
| context-compactor.ts | ~14KB | 上下文压缩 |
| agent-swarm.ts | ~16KB | Agent 蜂群 |
| vector-memory.ts | ~11KB | 向量记忆 |

**影响：**
- 关闭应用后，心跳/反思/主动学习停止
- 数据持久化依赖 localStorage
- 无法多端共享 Agent 状态

**建议：**
- 阶段性迁移到 Tauri Rust 后端
- 或作为 Gateway 插件实现

---

## 三、建议优先级

### 🔥 本周

1. **真实集成测试验证**
   - 连接真实 OpenFang Kernel
   - 配置中文模型 API Key
   - 验证基础对话流程

### 📌 短期（2周）

1. **完成低集成度组件验证**
2. **补充 Tauri 进程健康检查**
3. **更新文档反映当前状态**

### 🎯 中期（1-2月）

1. **智能层迁移规划**
   - 评估哪些模块必须迁移
   - 制定迁移计划
2. **飞书集成真实测试**

---

## 四、总结

**ZCLAW 项目已完成大部分架构优化工作**（Store 迁移、gateway-client 模块化、E2E 框架）。

**最关键的缺口是真实环境验证** —— 需要用真实的 OpenFang Kernel 和中文模型 API 验证完整数据流。

**智能层迁移是长期工作**，可以在产品验证稳定后再逐步推进。