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:
@@ -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 Deploy(37h / 5.5 天)** — 补齐 R 工具 7→11 + 生产环境部署上线
|
||||
|
||||
2. **Phase Deploy(37h)** — 补齐 ANOVA / Fisher / Wilcoxon / 线性回归 + 复合工具 ST_BASELINE_TABLE + 部署上线
|
||||
2. **Phase I — Session 黑板 + READ 层(30h / 5 天)** — 已吸收 Phase Q+
|
||||
- SessionBlackboardService(CacheFactory / 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 III(20h)** — method_consult + ask_user 标准化
|
||||
5. **Phase IV(21h)** — THINK + ACT 工具封装 + analyze 完整链路
|
||||
6. **Phase V(18h)** — 反思编排 + discuss + feedback
|
||||
|
||||
### 后期
|
||||
|
||||
7. **Phase VI(10h)** — 集成测试 + 可观测性(含 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 黑板使用 CacheFactory(Postgres-Only,无 Redis) |
|
||||
| C5 | 数据依赖意图必须有上下文守卫 |
|
||||
| C6 | LLM 枚举输出必须 Zod 动态校验 |
|
||||
|
||||
---
|
||||
|
||||
**文档版本:** v3.0
|
||||
**最后更新:** 2026-02-22
|
||||
**当前状态:** 🎉 QPER 主线闭环 + 智能对话与工具体系架构设计完成
|
||||
**下一步:** Phase Deploy(工具补齐)→ Phase I(Session 黑板 + READ 层)
|
||||
|
||||
Reference in New Issue
Block a user