Files
zclaw_openfang/docs/test-results/RELEASE_READINESS.md
iven a458e3f7d8
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Rust Check (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled
docs: add pre-launch audit defect list and release readiness assessment
DEFECT_LIST.md: 38 active defects (0 P0, 6 P1, 23 P2, 9 P3)
- 13 V12 issues confirmed fixed
- 4 new issues discovered during testing

RELEASE_READINESS.md: Overall health 73→79 (+6)
- 2 blocking items: classroom model hardcode + LLM API concurrency
- T5-T8 modules at 78-91/100 (low risk)
- Recommended: fix 2 blockers then release as Beta
2026-04-05 18:52:39 +08:00

3.5 KiB
Raw Blame History

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 -

发布就绪判定

阻断项(必须修复才能发布)

# 缺陷 影响 修复建议
1 P1-04: 课堂生成 model="default" 硬编码 课堂功能完全不可用 generation/mod.rs:416 从 kernel config 读取模型名
2 P1-03: LLM API 并发 500 DATABASE_ERROR 高并发场景下 80% 请求失败 SaaS 后端连接池扩容或添加队列

强烈建议修复(影响用户体验)

# 缺陷 影响
3 P1-01: Browser Hand 不实际执行 自主浏览能力不可用
4 P1-05: 删除活跃 Agent 无警告 用户可能误删唯一 Agent
5 P1-06: agent_get 不返回完整配置 Agent 管理功能不完整

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

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

模块风险评估

HIGH RISK

T1 Hands (68/100)

  • 核心问题: Browser Hand 不执行、并发失败
  • 可缓解: Quiz/Slideshow/Whiteboard 等正常工作的 Hand 可用
  • 建议: 标注 Browser Hand 为 "实验性"

T4 Classroom (75/100)

  • 核心问题: 课堂生成不可用model 硬编码)
  • 可缓解: 持久化、死锁、错误处理已修复
  • 建议: 修复 P1-04 后即可发布

MEDIUM RISK

T2 Intelligence (74/100)

  • 核心问题: Heartbeat 不自动启动
  • 可缓解: 手动 init 可用

T3 Agent (73/100)

  • 核心问题: agent_get 字段不全、删除无警告
  • 可缓解: CRUD 基本工作

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 用例执行13 已修复6 P1 未修复
端到端 (T9-T12) ⏭️ Phase 3/4待执行

发布建议

推荐路径: 修复 2 个阻断项后发布

  1. 立即修复 P1-04 (generation model 硬编码) — 1 行代码改动
  2. 立即修复 P1-03 (并发 DATABASE_ERROR) — SaaS 连接池配置
  3. 发布 Beta 版本 标注已知限制
  4. 跟进修复 P1-01/05/06 在 Beta 期间

已知限制标注

发布时应在 release notes 中注明:

  • Browser Hand 为实验性功能
  • 课堂生成需要正确的模型配置
  • Agent 删除前请手动确认
  • Python 技能在 Windows 需手动配置 python3 命令

不建议发布的场景

如果以下条件不满足,不建议正式发布:

  • SaaS 后端连接池未扩容(并发问题)
  • 课堂 model 硬编码未修复(课堂功能不可用)