docs(ssa): Complete intelligent dialogue and tool system architecture design

Architecture Design:
- Add intent recognition and dialogue architecture design (Intent Router + DataContext)
- Add tool system planning (4-layer 7-tool fusion solution: READ/INTERACT/THINK/ACT)
- Add 4-layer 7-tool implementation mechanism details (Conversation Layer LLM + Node.js orchestration)

Development Plan (v1.2):
- Create 6-phase development plan (134h/22 days) for intelligent dialogue system
- Add 8 architectural constraints (C1-C8): no Function Calling, Postgres-Only cache,
  streaming output, context guard, Zod dynamic validation
- Correct Session Blackboard to use CacheFactory (Postgres-Only, no Redis)

Status Updates:
- Update SSA module status: QPER complete + dialogue architecture design complete
- Update system-level status: add SSA architecture design milestone

Other:
- R tools minor fixes (chi_square, correlation, logistic_binary, mann_whitney, t_test_paired)
- Frontend AIA chat workspace style adjustment

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-02-22 10:05:14 +08:00
parent 11676f2840
commit bf10dec4c8
9 changed files with 3380 additions and 40 deletions

View File

@@ -1,13 +1,19 @@
# SSA智能统计分析模块 - 当前状态与开发指南
> **文档版本:** v2.1
> **文档版本:** v3.0
> **创建日期:** 2026-02-18
> **最后更新:** 2026-02-21
> **最后更新:** 2026-02-22
> **维护者:** 开发团队
> **当前状态:** 🎉 **QPER 主线闭环 + 集成测试通过 + 统一状态管理重构完成**
> **当前状态:** 🎉 **QPER 主线闭环 + 智能对话与工具体系架构设计完成**
> **文档目的:** 快速了解SSA模块状态为新AI助手提供上下文
>
> **最新进展2026-02-21 晚**
> **最新进展2026-02-22**
> - ✅ **智能对话与工具体系架构设计完成** — 四层七工具 + 对话层 LLM + 意图路由器
> - ✅ **开发计划 v1.2 定稿** — 6 Phase / 134h / 22 天(含 8 条架构约束 + Postgres-Only 缓存规范)
> - ✅ **3 份系统设计文档** — 意图识别架构、工具体系规划方案、四层七工具实现机制详解
> - ✅ **6 条架构审查建议已裁定** — 3 预警Function Calling 冲突、System Prompt 膨胀、流式输出)+ 3 盲区Postgres-Only 缓存、上下文守卫、Zod 动态校验)
>
> **此前进展2026-02-21**
> - ✅ **前后端集成测试** — 7 个 Bug 全部修复R 引擎防御、意图识别、前端状态)
> - ✅ **统一状态管理重构** — 消除 isWorkflowMode 双轨逻辑AnalysisRecord 成为唯一数据源
> - ✅ **多任务切换** — 点击不同卡片正确显示各自的分析计划和结果
@@ -22,12 +28,12 @@
| 项目 | 信息 |
|------|------|
| **模块名称** | SSA - 智能统计分析 (Smart Statistical Analysis) |
| **模块定位** | AI驱动的"白盒"统计分析系统 |
| **架构模式** | **QPER — Query → Planner → Execute → Reflection** |
| **模块定位** | AI驱动的"白盒"统计分析系统 → 升级为"数据感知的统计顾问" |
| **架构模式** | **QPER(执行层)** + **四层七工具 + 对话层 LLM智能对话层** |
| **前端状态模型** | **Unified Record Architecture — 一次分析 = 一个 Record = N 个 Steps** |
| **商业价值** | ⭐⭐⭐⭐⭐ 极高 |
| **目标用户** | 临床研究人员、生物统计师 |
| **开发状态** | 🎉 **QPER 主线闭环 + 集成测试通过Phase Deploy 待启动** |
| **开发状态** | 🎉 **QPER 主线闭环 + 智能对话架构设计完成Phase Deploy 待启动** |
### 核心目标
@@ -123,9 +129,14 @@ AnalysisRecord {
| **Phase P** | **决策表 + 流程模板** | **23h** | ✅ **已完成** | 2026-02-21 |
| **Phase R** | **LLM 论文级结论** | **22h** | ✅ **已完成** | 2026-02-21 |
| **集成测试** | **Bug 修复 + 统一状态管理重构** | **~4h** | ✅ **已完成** | 2026-02-21 |
| **架构设计** | **智能对话与工具体系架构设计** | **~8h** | ✅ **已完成** | 2026-02-22 |
| Phase Deploy | 工具补齐 + 部署上线 | 37h | 📋 待开始 | - |
| Phase Q+ | 人机协同增强 | 20h | 📋 待开始 | - |
| **QPER 透明化** | **Pipeline 可观测性增强** | TBD | 📋 待开始 | - |
| **Phase I** | **Session 黑板 + READ 层** | **30h** | 📋 待开始(吸收 Phase Q+ | - |
| **Phase II** | **对话层 LLM + 意图路由器 + 统一对话入口** | **35h** | 📋 待开始 | - |
| **Phase III** | **method_consult + ask_user 标准化** | **20h** | 📋 待开始 | - |
| **Phase IV** | **THINK + ACT 工具封装** | **21h** | 📋 待开始 | - |
| **Phase V** | **反思编排 + 高级特性** | **18h** | 📋 待开始 | - |
| **Phase VI** | **集成测试 + 可观测性** | **10h** | 📋 待开始 | - |
### 已完成核心功能
@@ -236,10 +247,14 @@ npx tsx scripts/seed-ssa-reflection-prompt.ts
| 文档 | 路径 |
|------|------|
| **QPER 开发计划(主线)** | `04-开发计划/10-QPER架构开发计划-智能化主线.md` |
| **🆕 智能对话与工具体系开发计划** | `04-开发计划/11-智能对话与工具体系开发计划.md` |
| **🆕 意图识别与对话架构设计** | `00-系统设计/SSA-Pro 意图识别与对话架构设计.md` |
| **🆕 工具体系规划方案(融合方案)** | `00-系统设计/SSA-Pro 工具体系规划方案(团队讨论稿).md` |
| **🆕 四层七工具实现机制详解** | `00-系统设计/SSA-Pro 四层七工具实现机制详解.md` |
| **QPER 开发总结** | `06-开发记录/SSA-QPER架构开发总结-2026-02-21.md` |
| **集成测试 Bug 修复** | `06-开发记录/2026-02-21-集成测试Bug修复与统一状态管理重构.md` |
| **智能化愿景设计** | `00-系统设计/SSA-Pro 理想状态与智能化愿景设计.md` |
| **PRD** | `00-系统设计/PRD SSA-Pro 严谨型智能统计分析模块.md` |
| **PRD** | `00-系统设计/PRA SSA-Pro 严谨型智能统计分析模块.md` |
| **架构设计 V4** | `00-系统设计/SSA-Pro 严谨型智能统计分析架构设计方案V4.md` |
---
@@ -248,23 +263,76 @@ npx tsx scripts/seed-ssa-reflection-prompt.ts
### 近期(优先级高)
1. **QPER 透明化Pipeline 可观测性)**
- Q 层:展示 LLM 解析结果goal、变量、置信度和降级原因
- P 层:展示决策表匹配过程和流程模板填充参数
- E 层:实时展示步骤输入参数 + R 返回摘要;开发模式显示 R 原始错误
- R 层:展示槽位注入内容和 Zod 校验状态
- 开发者面板:持久化 trace_log + LLM prompt/response 可查看
1. **Phase Deploy37h / 5.5 天)** — 补齐 R 工具 7→11 + 生产环境部署上线
2. **Phase Deploy37h** — 补齐 ANOVA / Fisher / Wilcoxon / 线性回归 + 复合工具 ST_BASELINE_TABLE + 部署上线
2. **Phase I — Session 黑板 + READ 层30h / 5 天)** — 已吸收 Phase Q+
- SessionBlackboardServiceCacheFactory / Postgres-Only 架构)
- `get_data_overview` + `get_variable_detail` 工具
- DataContext 前端展示 + 变量字典面板
- PICO 推断 + 用户确认流程
3. **Phase II — 对话层 LLM + 意图路由器 + 统一对话入口35h / 5.5 天)**
- ConversationService 核心(六段式 System Prompt 动态组装)
- IntentRouterService规则 + LLM 混合路由 + 上下文守卫)
- 统一对话 API `/api/ssa/chat`
- chat/explore 意图处理
### 中期
3. **Phase Q+20h**变量数据字典AI 先猜用户微调)+ 变量选择确认面板AI 推荐医生确认)
4. **前端 UI 细节打磨** — 执行计划格式美化、错误状态视觉增强
4. **Phase III20h**method_consult + ask_user 标准化
5. **Phase IV21h** — THINK + ACT 工具封装 + analyze 完整链路
6. **Phase V18h** — 反思编排 + discuss + feedback
### 后期
7. **Phase VI10h** — 集成测试 + 可观测性(含 QPER 透明化)
**详细计划:** `04-开发计划/11-智能对话与工具体系开发计划.md`v1.2,含 8 条架构约束 C1-C8
---
**文档版本:** v2.1
**最后更新:** 2026-02-21
**当前状态:** 🎉 QPER 主线闭环 + 集成测试通过 + 统一状态管理重构完成
**下一步:** QPER 透明化 → Phase Deploy 工具补齐 + 部署上线
## 🏗️ 智能对话架构概览(四层七工具 + 对话层 LLM
> **设计目标:** 从"统计分析执行器"升级为"数据感知的统计顾问"
```
用户消息
┌─ Intent Router ──────────────────────────────────────┐
│ 规则引擎优先 + LLM 兜底 + 上下文守卫§16.5
│ → chat / explore / consult / analyze / discuss / feedback │
└─────────────────────┬────────────────────────────────┘
┌─ Conversation Layer LLM ─────────────────────────────┐
│ 六段式 System Prompt + DataContext 注入 + 流式输出 │
│ Token 预算 ≤4000§16.2+ 禁止 Function Calling§16.1)│
└─────────────────────┬────────────────────────────────┘
┌─ 四层七工具 ─────────────────────────────────────────┐
│ READ: get_data_overview | get_variable_detail | method_consult │
│ INTERACT: ask_user │
│ THINK: analysis_plan │
│ ACT: run_step | write_report │
└─────────────────────┬────────────────────────────────┘
┌─ QPER 执行层(已有) ────────────────────────────────┐
│ Q → P → E → R四层降级体系不动
└──────────────────────────────────────────────────────┘
```
**关键架构约束(详见开发计划 §16-§17**
| # | 约束 |
|---|------|
| C1 | 对话层 LLM 禁止 Function Calling tools 参数 |
| C4 | Session 黑板使用 CacheFactoryPostgres-Only无 Redis |
| C5 | 数据依赖意图必须有上下文守卫 |
| C6 | LLM 枚举输出必须 Zod 动态校验 |
---
**文档版本:** v3.0
**最后更新:** 2026-02-22
**当前状态:** 🎉 QPER 主线闭环 + 智能对话与工具体系架构设计完成
**下一步:** Phase Deploy工具补齐→ Phase ISession 黑板 + READ 层)