docs: add pre-launch audit defect list and release readiness assessment
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
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
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
This commit is contained in:
109
docs/test-results/RELEASE_READINESS.md
Normal file
109
docs/test-results/RELEASE_READINESS.md
Normal file
@@ -0,0 +1,109 @@
|
||||
# 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 硬编码未修复(课堂功能不可用)
|
||||
Reference in New Issue
Block a user