From 2a6315e615630fb497da73f212993415da138ca3 Mon Sep 17 00:00:00 2001 From: admin Date: Mon, 14 Sep 2026 15:10:10 +0800 Subject: [PATCH] =?UTF-8?q?docs(extension):=20=E6=B5=8B=E8=AF=95=E6=8A=A5?= =?UTF-8?q?=E5=91=8A=E2=80=94=E2=80=94TL=20=E6=8E=A5=E7=AE=A1=E6=B5=8B?= =?UTF-8?q?=E8=AF=95=E5=BE=AA=E7=8E=AF,B1-B4=20=E7=BC=BA=E9=99=B7=E4=BF=AE?= =?UTF-8?q?=E5=A4=8D,=E5=85=A8=E9=87=8F=E6=B5=8B=E8=AF=95=E7=BB=BF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- docs/extension_test_report.md | 36 +++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 docs/extension_test_report.md diff --git a/docs/extension_test_report.md b/docs/extension_test_report.md new file mode 100644 index 0000000..dedcbd3 --- /dev/null +++ b/docs/extension_test_report.md @@ -0,0 +1,36 @@ +# 扩展分析测试报告(2026-09-14,TL 接管版) + +## 背景 + +测试 agent 因 API 余额错误(402)在「UI 全量 373 全绿 + 开始探测 18 用例真实执行环境」处中断。TL 接管完成剩余测试循环:发现并修复 3 个缺陷,全量测试转绿。 + +## 缺陷清单(TL 测试循环发现,已全部修复,commit 812decf) + +| # | 严重度 | 位置 | 根因 | 修复 | +|---|---|---|---|---| +| B1 | 高 | conftest.py Settings 缺 extensions_dir | 测试扩展落仓库默认目录 bioflow_data/extensions,跨测试污染,list 排序断言失败 | 两处 Settings 补 tmp 隔离 + 清污染目录 | +| B2 | 高 | extensions.py inject_real_executor | store.executor 默认 None,直接 .inject_real 崩溃 | 惰性创建适配器实例再注入 | +| B3 | 高 | extensions.py ExtensionExecutor.execute 分派 | 旧契约 execute(spec) 与新契约 run(request) 混用,真实执行器被传错入参 | 按方法存在性分派:execute→旧契约、run→新契约+结果归一化 | +| B4 | 中 | routers/bioflow.py chat_stream | 扩展意图两层判定未接入对话入口,前端引导卡收不到帧 | 接入:create→extension_upload、run→extension_candidates(单命中 high_confidence)、create_ambiguous→引导帧;异常不回退生信主链 | + +## 测试账(全部通过) + +- **后端 bioflow_service:324/324**(Dev-A 71 + Dev-B 38 + 既有 226,含修复后全量) +- **内核:15/15**(run_extension.py 容器入口 unittest) +- **前端 r3debug:122/122**(Dev-C 33 扩展用例 + 既有;8 卡 mount、14 类事件映射幂等/乱序/终态、sendExtension 流、意图词典) +- **前端主套件:373/373**(零回归) +- **真实 docker 冒烟 SMOKE_OK**:上传→规则版转换(LLM 无 key 自动降级)→ 容器执行(plantai-env-biolabx-bioinfo 镜像)→ 输出契约校验 → 结果归一化,exit 0 + result.txt +- **npm run build 通过** + +## 18 用例真实执行验证:环境受限,留待 176 部署(计划 P3) + +- 18 用例的 Python 依赖全景已盘点:01-13 依赖 pandas/panfamily,14-18 依赖 Biopython,另需 OrthoFinder/HMMER/DIAMOND 等外部工具。 +- 这些依赖在 **176 的 8 个 bioflow 镜像**中(bioflow-gf 等);175 现有镜像(plantai-env-biolabx-*)均不含 pandas/panfamily/Biopython。 +- 真实容器执行 18 用例需 176 部署后进行(届时 runtime_image 直接映射 bioflow-gf 等)。 + +## 未覆盖项与遗留 + +1. 18 用例真实容器执行(环境依赖,留待 176 部署后 P3 验收)。 +2. 运行事件刷新后 resubscribe(Dev-C 预留挂钩点,后端 run events 已返回快照帧)。 +3. 运行卡输出下载按钮(待产物下载端点确定)。 +4. AI 修复循环的镜像重建链路(extension_image.py 已实现,175 无真实构建验证)。