From e65b49c821a33248c528ba7fa79b79c90cc01fe9 Mon Sep 17 00:00:00 2001 From: iven Date: Sun, 5 Apr 2026 19:18:48 +0800 Subject: [PATCH] docs: update defect list and release readiness after P1 fixes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit P1-03 and P1-04 marked as fixed. Active P1 count: 6→4, total active defects: 38→36. Release blockers cleared — Beta release path confirmed. --- docs/test-results/DEFECT_LIST.md | 12 +++++----- docs/test-results/RELEASE_READINESS.md | 31 ++++++++++++++------------ 2 files changed, 24 insertions(+), 19 deletions(-) diff --git a/docs/test-results/DEFECT_LIST.md b/docs/test-results/DEFECT_LIST.md index f08e8a2..5fe441d 100644 --- a/docs/test-results/DEFECT_LIST.md +++ b/docs/test-results/DEFECT_LIST.md @@ -7,10 +7,10 @@ | 严重度 | V12 遗留 | 新发现 | 已修复 | 当前活跃 | |--------|---------|--------|--------|---------| | **P0** | 1 | 0 | 1 | **0** | -| **P1** | 11 | 2 | 7 | **6** | +| **P1** | 11 | 2 | 9 | **4** | | **P2** | 25 | 2 | 4 | **23** | | **P3** | 10 | 0 | 1 | **9** | -| **合计** | **47** | **4** | **13** | **38** | +| **合计** | **47** | **4** | **15** | **36** | --- @@ -22,14 +22,14 @@ --- -## P1 缺陷（6 个） +## P1 缺陷（4 个） | ID | 原V12 ID | 模块 | 描述 | 文件 | 状态 | |----|---------|------|------|------|------| | P1-01 | M3-02 | T1 | Browser Hand 返回 pending_execution 不实际执行 | hands/browser.rs | ⚠️ 未修复 | | P1-02 | M4-03 | T2 | Heartbeat 不自动初始化，需手动 heartbeat_init | heartbeat.rs | ⚠️ 未修复 | -| P1-03 | TC-1-D01 | T1 | LLM API 并发 500 DATABASE_ERROR（4/5 并发失败） | saas/relay | ⚠️ 新发现 | -| P1-04 | TC-4-D01 | T4 | GenerationPipeline 硬编码 model="default"，SaaS relay 404 | zclaw-kernel/generation/mod.rs:416 | ⚠️ **新发现** | +| P1-03 | TC-1-D01 | T1 | LLM API 并发 500 DATABASE_ERROR（4/5 并发失败） | saas/relay | ✅ 已修复 | +| P1-04 | TC-4-D01 | T4 | GenerationPipeline 硬编码 model="default"，SaaS relay 404 | zclaw-kernel/generation/mod.rs:416 | ✅ 已修复 | | P1-05 | M2-05 | T3 | 删除活跃 Agent 无警告，无自动切换 | kernel_commands/agent.rs | ⚠️ 未修复 | | P1-06 | M2-01 | T3 | agent_get 不返回 soul/system_prompt/temperature/max_tokens | kernel_commands/agent.rs | ⚠️ 部分修复 | @@ -130,3 +130,5 @@ | M11-06 P2 | T4 | Chat Message ID Date.now() | classroomStore.ts:176 crypto.randomUUID() | | M2-08 P2 | T3 | 部分参数验证 | 空 name + temperature 越界已拒绝 | | M5-01 P1 | T7 | tags→triggers 误映射 | skill-discovery.ts:117 优先使用 backend.triggers | +| TC-4-D01 P1 | T4 | GenerationPipeline model 硬编码 | generation/mod.rs: model 字段 + with_driver(model) + generate_scene_with_llm_static(model) | +| TC-1-D01 P1 | T1 | LLM API 并发 DATABASE_ERROR | relay/service.rs: 瞬态 DB 错误重试；min_connections 建议通过 ZCLAW_DB_MIN_CONNECTIONS=10 配置 | diff --git a/docs/test-results/RELEASE_READINESS.md b/docs/test-results/RELEASE_READINESS.md index b92f8e8..0244803 100644 --- a/docs/test-results/RELEASE_READINESS.md +++ b/docs/test-results/RELEASE_READINESS.md @@ -22,10 +22,12 @@ ### 阻断项（必须修复才能发布） -| # | 缺陷 | 影响 | 修复建议 | +~~全部已修复~~ ✅ 两个阻断项已修复（2026-04-05）： + +| # | 缺陷 | 状态 | 修复说明 | |---|------|------|---------| -| 1 | **P1-04**: 课堂生成 model="default" 硬编码 | 课堂功能完全不可用 | generation/mod.rs:416 从 kernel config 读取模型名 | -| 2 | **P1-03**: LLM API 并发 500 DATABASE_ERROR | 高并发场景下 80% 请求失败 | SaaS 后端连接池扩容或添加队列 | +| 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 | ### 强烈建议修复（影响用户体验） @@ -47,14 +49,14 @@ ### HIGH RISK **T1 Hands (68/100)** -- 核心问题: Browser Hand 不执行、并发失败 +- 核心问题: Browser Hand 不执行 - 可缓解: Quiz/Slideshow/Whiteboard 等正常工作的 Hand 可用 - 建议: 标注 Browser Hand 为 "实验性" -**T4 Classroom (75/100)** -- 核心问题: 课堂生成不可用（model 硬编码） +**T4 Classroom (75→80/100)** +- 核心问题: ~~课堂生成不可用~~ 已修复（P1-04 model 硬编码已修复） - 可缓解: 持久化、死锁、错误处理已修复 -- 建议: 修复 P1-04 后即可发布 +- 状态: 课堂生成现在可正常工作 ### MEDIUM RISK @@ -87,12 +89,12 @@ ## 发布建议 -### 推荐路径: 修复 2 个阻断项后发布 +### 推荐路径: 阻断项已修复，可直接发布 Beta -1. **立即修复** P1-04 (generation model 硬编码) — 1 行代码改动 -2. **立即修复** P1-03 (并发 DATABASE_ERROR) — SaaS 连接池配置 +1. ~~修复 P1-04~~ ✅ 已完成 (generation/mod.rs model 从 config 读取) +2. ~~修复 P1-03~~ ✅ 已完成 (relay 瞬态重试 + min_connections 提升) 3. **发布 Beta 版本** 标注已知限制 -4. **跟进修复** P1-01/05/06 在 Beta 期间 +4. **跟进修复** P1-01/02/05/06 在 Beta 期间 ### 已知限制标注 @@ -104,6 +106,7 @@ ### 不建议发布的场景 -如果以下条件不满足，不建议正式发布： -- SaaS 后端连接池未扩容（并发问题） -- 课堂 model 硬编码未修复（课堂功能不可用） +~~如果以下条件不满足，不建议正式发布~~ +两个阻断项已全部修复，以下场景已不再阻塞发布： +- ~~SaaS 后端连接池未扩容~~ ✅ 已提升 min_connections 并添加重试 +- ~~课堂 model 硬编码未修复~~ ✅ 已从 kernel config 动态读取