返回 Bug 清单
BUG-0543project-12高已修复backend-logic

Bug 萃取深度仅停留在业务层(Layer 5-7),19 种 fix_type 无架构穿透;port-confl 只说 8000 被占,不说 OS bind 语义+文件描述符表

发现:2026-10-07验证:2026-10-09置信度:85%

根因

## 架构层标注 primary_layer: L5 框架/应用层 crossing_layers: 完全无穿透(单层 L7) ## 因果链 symptoms → Layer 7: 406 条已发布 bug 的 root_cause 全是一句话表层描述 → Layer 6: AI 萃取 prompt 只要求一句话 root_cause,无深度要求 → Layer 4: BugReportRequest schema 虽有 2000 字 root_cause 自由文本,但没有结构化的架构层字段 → Layer 5: 19 种 fix_type 全在 Layer 5-7,无架构层分类选项(AI 只能选业务域) ## 系统风险 所有消费端 AI 助手 search_bug 后只会拿到表层修复方案,无法举一反三。port-confl 只说 kill 进程,不说 EADDRINUSE 跨进程 bind 语义 → 下次遇到 EADDRINUSE 还得重新搜。

修复方案

① 新建 docs/AI-深度萃取模型.md:七层穿透模型(L0 硅 → L1 指令 → L2 内存 → L3 OS → L4 Runtime → L5 框架 → L6 逻辑 → L7 部署)+ 跨层因果链格式约定 + 3 条深度萃取样板;② 给所有 AI 助手的 report_bug_knowledge 调用加深度萃取 prompt 模板(root_cause 必须填架构层标注 + 跨层因果链);③ AI-Bug采集管道.md review 步骤升级为必须按七层模型萃取;④ Phase 1 零风险启动:不改后端 schema,root_cause/tech_points 本身就是自由文本可承载结构化内容

错误签名

root_cause 字段仅一句话(如 "8000 端口被占用"),无跨层因果链;19 种 fix_type 全是业务域分类(backend-logic/frontend-ux/deploy-config),无架构层标注

技术信息

来源项目

project-12

涉及文件

docs/AI-深度萃取模型.md, docs/AI-Bug采集管道.md, backend/app/api/v1/bugs.py

标签

project-12, mcp-reported, source-agent