docs: 更新12-重构记录状态看板 - P1-2/P1-4/P1-7部分代码完成待部署 + 待部署清单

docs/10-项目管理/任务说明书/任务说明书-87-P0-3-快捷申请空白气泡修复.md

@@ -1,6 +1,8 @@
-# 任务说明书 — P0-3 快捷申请按钮空白气泡修复
+# 任务说明书 — P0-3 快捷申请按钮空白气泡修复【已标记误报】
 
-> **版本**: v1.0 | **日期**: 2026-07-17
+> **版本**: v1.1 | **日期**: 2026-07-17
+>
+> ⚠️ **误报声明（2026-07-18）**：经核实 `InputBox.vue` 是孤儿组件（`ChatPanel.vue:96` 实际使用 `InputBar.vue`），"快捷申请按钮"在当前产品中不存在，`showApprovalCard` 无人调用，本任务前提不成立。**已保留**：`GET /approval/all-categories-card` 端点（无害，可作未来功能备用）。**待清理**：InputBox.vue、showApprovalCard 列入批次 4 死代码。InputBar.vue 是否需要快捷申请入口属新产品决策，不在本次重构范围。
 
 ---
 
@@ -10,6 +12,7 @@
 |------|------|
 | **任务名称** | P0-3 InputBox 快捷申请按钮空白气泡修复（新 all-categories-card 端点） |
 | **任务ID** | #87 |
+| **状态** | ⚠️ 误报（前提不成立，端点已保留备用） |
 | **优先级** | 🔴 P0 |
 | **类型** | Bug修复 |
 | **状态** | 待开始 |

docs/12-重构记录/01-问题验证清单.md

@@ -24,7 +24,7 @@
 
 | # | 问题 | 证据 | 现状 |
 |---|------|------|------|
-| F1 | showApprovalCard 空白气泡（P0） | `stores/conversation.ts:900-917` 构造 `extra_data={approval_type:'',confidence:0}`，但 MessageBubble 要求 `action.card_data` | 待 P0-3 |
+| F1 | ~~showApprovalCard 空白气泡（P0）~~ **误报** | `stores/conversation.ts:900-917` 构造空 extra_data。**但 InputBox.vue 是孤儿组件（ChatPanel.vue:96 实际用 InputBar.vue），showApprovalCard 无人调用，此 bug 在用户界面不存在**。all-categories-card 端点保留备用，InputBox+showApprovalCard 列入批次4死代码 | ⚠️ 误报，批次4清理 |
 | F2 | RecommendCard invokeApproval 崩溃（P0） | `RecommendCard.vue:178` 调用未定义函数（grep 确认无定义/导入/emit） | 待 P0-4 |
 | F3 | WS new_message 白名单丢字段（P0） | `stores/conversation.ts:395-429` 只取 7 字段；后端 `messages.py:278` 已下发全量 | 待 P0-5 |
 | F4 | WS 3 种死路由 | `useH5WebSocket.ts:392/477/489`（ai_reply_chunk/pending_close_request/quiz_diagnostic_answer），后端零产出 | 待 P1-5 |

docs/12-重构记录/README.md

@@ -39,15 +39,38 @@ docs/12-重构记录/
 | — | v3.0 后端 ApprovalMatcher + 前端纯渲染 | — | ✅ 已完成 | 2026-07-17 |
 | — | v3.1 Dify 无 action 降级 + message_content bug 修复 | — | ✅ 已完成 | 2026-07-17 |
 | 批次 0 | 文档速修 4 项 + 本目录归档 | — | ✅ 已完成 | 2026-07-17 |
-| 批次 1 | P0-1 workers=2→1 | #78 | ⬜ 待开始 | — |
+| 批次 1 | P0-1 workers=2→1 | #78 | ✅ 已完成（预防性，服务器已是1） | 2026-07-17 |
-| 批次 1 | P0-2 DIFY_NATIVE_* 生产配置 | #79 | ⬜ 待开始 | — |
+| 批次 1 | P0-2 DIFY_NATIVE_* 生产配置 | #79 | ✅ 已完成（变量已注入容器） | 2026-07-17 |
-| 批次 1 | P0-3 快捷申请空白气泡修复 | #87 | ⬜ 待开始 | — |
+| 批次 1 | P0-3 快捷申请空白气泡修复 | #87 | ⚠️ 误报（InputBox 孤儿组件，端点保留备用） | 2026-07-17 |
-| 批次 1 | P0-4 RecommendCard invokeApproval 修复 | #88 | ⬜ 待开始 | — |
+| 批次 1 | P0-4 RecommendCard invokeApproval 修复 | #88 | ✅ 已完成（v16） | 2026-07-17 |
-| 批次 1 | P0-5 WS new_message 全字段透传 | #89 | ⬜ 待开始 | — |
+| 批次 1 | P0-5 WS new_message 全字段透传 | #89 | ✅ 已完成（v16） | 2026-07-17 |
-| 批次 1 | P0-6 超时预算切分 | #90 | ⬜ 待开始 | — |
+| 批次 1 | P0-6 超时预算切分 | #90 | ✅ 已完成（native/proxy 各12s，变量已注入） | 2026-07-18 |
-| 批次 2 | P1 基础（单例/统一调用点/Matcher/配置治理） | #84 | ⬜ 待开始 | — |
+| 批次 2 | P1-1 AIService/AIHandler 真单例 | #84 | ✅ 已完成 | 2026-07-18 |
+| 批次 2 | P1-2 统一 Dify 调用点（删 detect-intent 死链路） | #84 | ✅ 代码完成，待部署（堡垒机已关，明天部署） | 2026-07-18 |
+| 批次 2 | P1-4 Matcher 死分支+失败兜底全量卡片 | #84 | ✅ 代码完成（含 18 模板字段补全，7 项测试通过），待部署 | 2026-07-18 |
+| 批次 2 | P1-7(部分) 3 个潜伏 bug 修复 | #84 | ✅ 代码完成（app_root/Scheduler拼写/logger），待部署 | 2026-07-18 |
+| 批次 2 | P1-7(剩余) APP_ENV 传递+Redis 密码轮换 | #84 | ⬜ 待开始（需停机窗口，低峰期执行） | — |
+| 批次 2 | P1-6 recommend 死逻辑清理 | #84 | ⬜ 待开始 | — |
 | 批次 3 | P1 核心（编排层管线化 + WS 路由清理） | #85 | ⬜ 待开始 | — |
-| 批次 4 | P2（死代码/triage 删除/测试） | #86 | ⬜ 待开始 | — |
+| 批次 4 | P2（死代码/triage 删除/测试） | #86 | 🔵 部分提前（InputBox/MessageItem 孤儿组件已删） | — |
+
+### 待部署清单（堡垒机恢复后一次性部署）
+
+**后端 5 个文件**（上传到 `/opt/wecom-it-desk/app/`，注意挂载路径陷阱）：
+1. `backend/app/api/approval.py`（P1-2 删死链路 + P1-4 补 18 模板字段）
+2. `backend/app/api/byod.py`（P1-2 删 detect-intent 端点）
+3. `backend/app/services/routing_service.py`（P1-2 共享 client）
+4. `backend/app/services/approval_matcher.py`（P1-4 死分支+兜底）
+5. `backend/app/dependencies/__init__.py`（P1-2 lifespan 关 routing client）
+6. `backend/app/tasks/h5_ai_task.py`（P1-4 日志调整）
+7. `backend/app/main.py` + `config.py` + `tasks/scheduler.py`（P1-7 三 bug）
+
+**前端**：`pnpm build` → `h5-dist-v17.tar.gz`（P1-2 死 API + 孤儿组件清理）
+
+**部署后验证**：
+- `docker compose restart backend` 后无 ImportError
+- 发"VPN账号申请"验证审批卡片正常（Matcher 兜底路径）
+- 坐席端发图片/文件验证 WS 透传正常
 
 ## 四、关键上下文（新会话必读）