zclaw_openfang/docs/test-results/RELEASE_READINESS.md

ZCLAW 发布就绪评估

评估日期: 2026-04-05 | 基于: T1-T8 功能审计（8 个模块）

总体评分

模块	V12 基线	本次评分	变化	状态
T1 Hands 自主能力	58	68	+10	⚠️ 可用
T2 智能层	61	74	+13	✅ 良好
T3 Agent 分身	67	73	+6	✅ 良好
T4 课堂系统	70	75	+5	⚠️ 受阻
T5 Pipeline 工作流	72	78	+6	✅ 良好
T6 SaaS 桌面集成	85	89	+4	✅ 良好
T7 技能生态	85	87	+2	✅ 良好
T8 智能对话	91	91	0	✅ 优秀
加权平均	73	79	+6	-

---

发布就绪判定

阻断项（必须修复才能发布）

全部已修复 ✅ 两个阻断项已修复（2026-04-05）：

#	缺陷	状态	修复说明
1	P1-04: 课堂生成 model="default" 硬编码	✅ 已修复	generation/mod.rs 添加 model 字段，从 kernel config 读取
2	P1-03: LLM API 并发 500 DATABASE_ERROR	✅ 已修复	relay/service.rs 瞬态 DB 错误重试 + min_connections 5→10

强烈建议修复（影响用户体验） — ✅ 全部已处理

#	缺陷	状态	说明
3	P1-01: Browser Hand 不实际执行	🔬 实验性	需 Fantoccini 桥接，标注为实验性功能
4	P1-02: Heartbeat 不自动初始化	✅ 已修复	lifecycle.rs kernel_init 自动初始化并启动
5	P1-05: 删除活跃 Agent 无警告	✅ 已修复	CloneManager 差异化警告 + 自动切换
6	P1-06: agent_get 不返回完整配置	✅ 已修复	AgentInfo 补全 soul/system_prompt/temperature/max_tokens

可接受已知问题（P2/P3，可带缺陷发布）

• 23 个 P2 问题（大部分为边界条件、参数验证、API 一致性）
• 9 个 P3 问题（UI 细节、日志、配置边缘情况）

---

模块风险评估

HIGH RISK

T1 Hands (68/100)

• 核心问题: Browser Hand 为实验性（需 Fantoccini 桥接）
• 可缓解: Quiz/Slideshow/Whiteboard 等正常工作的 Hand 可用
• 状态: 已标注为实验性功能

T4 Classroom (75→80/100)

• 核心问题: 课堂生成不可用 ✅ 已修复（P1-04 model 硬编码已修复）
• 可缓解: 持久化、死锁、错误处理已修复
• 状态: 课堂生成现在可正常工作

MEDIUM RISK → ✅ 已降级

T2 Intelligence (74→80/100)

• 核心问题: Heartbeat 不自动启动 ✅ 已修复（lifecycle.rs 自动初始化）
• 状态: Heartbeat 随 kernel_init 自动启动

T3 Agent (73→80/100)

• 核心问题: agent_get 字段不全、删除无警告 ✅ 已修复
• 状态: agent_get 返回完整配置 + 删除时差异化警告与自动切换

LOW RISK

T5-T8 (78-91/100)

• 核心功能正常，P2/P3 问题不影响主要用户流程

---

测试覆盖

类型	结果
Rust cargo test	✅ 511/511 全部通过（10 crates, 0 failures）
Desktop vitest	⚠️ 174/185 通过（11 失败在 chatStore 重构同步）
Admin vitest	⚠️ 36/71 通过（29 失败在 mock/API 依赖）
功能审计 (T1-T8)	✅ 51 用例执行，19 已修复，P1 全部处理
端到端 (T9-T12)	⏭️ Phase 3/4，待执行

---

发布建议

推荐路径: 所有 P1 已修复/处理，可直接发布 Beta

1. 修复 P1-04 ✅ 已完成 (generation/mod.rs model 从 config 读取)
2. 修复 P1-03 ✅ 已完成 (relay 瞬态重试 + min_connections 提升)
3. 修复 P1-02 ✅ 已完成 (lifecycle.rs 自动初始化 heartbeat)
4. 修复 P1-05 ✅ 已完成 (CloneManager 差异化警告 + 自动切换)
5. 修复 P1-06 ✅ 已完成 (AgentInfo 补全 soul/system_prompt/temperature/max_tokens)
6. P1-01 Browser Hand 🔬 标注为实验性（需 Fantoccini 桥接）
7. 发布 Beta 版本 标注已知限制

已知限制标注

发布时应在 release notes 中注明：

• Browser Hand 为实验性功能（需 Fantoccini WebDriver 桥接）
• 课堂生成需要正确的模型配置
• Python 技能在 Windows 需手动配置 python3 命令
• 23 个 P2 + 9 个 P3 已知问题（不影响主要用户流程）

不建议发布的场景

如果以下条件不满足，不建议正式发布 两个阻断项已全部修复，以下场景已不再阻塞发布：

• SaaS 后端连接池未扩容 ✅ 已提升 min_connections 并添加重试
• 课堂 model 硬编码未修复 ✅ 已从 kernel config 动态读取