feat(ssa): Agent channel UX optimization (Solution B) + Plan-and-Execute architecture design

SSA Agent channel improvements (12 code files, +931/-203 lines):
- Solution B: left/right separation of concerns (gaze guiding + state mutex + time-travel)
- JWT token refresh mechanism (ensureFreshToken) to fix HTTP 401 during pipeline
- Code truncation fix: LLM maxTokens 4000->8000 + CSS max-height 60vh
- Retry streaming code generation with generateCodeStream()
- R Docker structured errors: 20+ pattern matching + format_agent_error + line extraction
- Prompt iron rules: strict output format in CoderAgent System Prompt
- parseCode robustness: XML/Markdown/inference 3-tier matching + length validation
- consoleOutput type defense: handle both array and scalar from R Docker unboxedJSON
- Agent progress bar sync: derive phase from agentExecution.status
- Export report / view code buttons restored for Agent mode
- ExecutingProgress component: real-time timer + dynamic tips + step pulse animation

Architecture design (3 review reports):
- Plan-and-Execute step-by-step execution architecture approved
- Code accumulation strategy (R Docker stays stateless)
- 5 engineering guardrails: XML tags, AST pre-check, defensive prompts, high-fidelity schema, error classification circuit breaker

Docs: update SSA module status v4.1, system status v6.7, deployment changelist
Made-with: Cursor

docs/00-系统总体设计/00-系统当前状态与开发指南.md

@@ -1,10 +1,12 @@
 # AIclinicalresearch 系统当前状态与开发指南
 
-> **文档版本：** v6.6  
+> **文档版本：** v6.7  
 > **创建日期：** 2025-11-28  
 > **维护者：** 开发团队  
-> **最后更新：** 2026-03-01  
+> **最后更新：** 2026-03-07  
 > **🎉 重大里程碑：**  
+> - **🆕 2026-03-07：SSA Agent 通道体验优化 + Plan-and-Execute 架构设计完成！** 方案 B 左右职责分离 + 10 项 Bug 修复（JWT 刷新/代码截断/重试流式/R Docker 结构化错误/进度同步/导出按钮）+ 分步执行架构评审通过（代码累加策略 + 5 项工程护栏）
+> - **🆕 2026-03-05：RVW V3.0 智能审稿 + ASL Deep Research 历史 + 系统稳定性增强！** RVW LLM 数据核查 + 临床评估维度 + 并行 Skill 故障隔离 + ASL 研究历史/删除 + DeepSearch S3 升级
 > - **🆕 2026-03-01：IIT 业务端 GCP 报表 + AI 时间线增强 + 多项 Bug 修复！** 4 张 GCP 标准报表（筛选入选/完整性/质疑跟踪/方案偏离）+ AI 工作流水详情展开 + 一键全量质控 + dimension_code/时区/通过率/D1 数据源修复
 > - **🆕 2026-02-27：旧版系统集成完成！** Token 注入自动登录 + Wrapper Bridge 架构 + Storage Access API + iframe 嵌入（研究管理 + 统计分析工具 126 个） + CSS 注入样式定制 + 本地 E2E 验证通过
 > - **🆕 2026-02-27：数据库文档体系 + 部署文档体系 + Prisma Schema 对齐完成！** 6 篇数据库核心文档 + 部署文档归档整理 + 统一操作手册 + 数据库开发规范 v3.0 + Cursor Rule 自动提醒 + Schema 类型漂移修正
@@ -33,7 +35,11 @@
 > - **2026-01-24：Protocol Agent 框架完成！** 可复用Agent框架+5阶段对话流程  
 > - **2026-01-22：OSS 存储集成完成！** 阿里云 OSS 正式接入平台基础层  
 >  
-> **🆕 最新进展（旧版系统集成 + 数据库文档体系 2026-02-27）：**  
+> **🆕 最新进展（SSA Agent 体验优化 + RVW V3.0 2026-03-07）：**  
+> - ✅ **🆕 SSA Agent 通道体验优化（12 文件, +931/-203 行）** — 方案 B 左右职责分离 + JWT 刷新 + 代码截断修复 + 重试流式生成 + R Docker 结构化错误（20+ 模式）+ Prompt 铁律 + 进度同步 + 导出按钮恢复 + ExecutingProgress 动态 UI
+> - ✅ **🆕 Plan-and-Execute 分步执行架构设计完成** — 代码累加策略 + 5 项工程护栏（XML 标签/AST 预检/防御性 Prompt/高保真 Schema/错误分类短路）+ 3 份架构评审报告
+> - ✅ **🆕 RVW V3.0 智能审稿** — LLM 数据核查 + 临床专业评估维度 + 并行 Skill 故障隔离（partial_completed）+ error_details JSONB
+> - ✅ **🆕 ASL Deep Research 历史 + DeepSearch S3** — 研究历史列表/删除 + getTask 鉴权修复 + Unifuncs S3 升级（中文数据源）
 > - ✅ **🆕 IIT 业务端 GCP 报表 + Bug 修复** — 4 张 GCP 标准报表（D1/D2/D3D4/D6）+ AI Timeline 详情展开 + 一键全量质控 + 6 项关键 Bug 修复
 > - ✅ **🆕 旧版系统集成** — Token 注入自动登录 + Wrapper Bridge（Cookie 设置 + CSS 注入）+ Storage Access API + 本地 E2E 全部通过
 > - ✅ **🆕 数据库文档体系建立** — 6 篇核心文档（架构总览/迁移历史/环境对照/技术债务/种子数据/PG扩展），位于 `docs/01-平台基础层/07-数据库/`
@@ -84,7 +90,7 @@
 | **ASL** | AI智能文献 | 文献筛选、Deep Research、全文智能提取、SR图表、Meta分析 | ⭐⭐⭐⭐⭐ | 🎉 **V2.0 核心完成（90%）+ 🆕工具4+5完成** - SSE流式+瀑布流UI+HITL+Word导出+散装派发+PRISMA流程图+Meta分析引擎(R Docker) | **P0** |
 | **DC** | 数据清洗整理 | ETL + 医学NER（百万行级数据） | ⭐⭐⭐⭐⭐ | ✅ **Tool B完成 + Tool C 99%（异步架构+性能优化-99%+多指标转换+7大功能）** | **P0** |
 | **IIT** | IIT Manager Agent | CRA Agent - LLM Tool Use + 自驱动质控 + 统一驾驶舱 | ⭐⭐⭐⭐⭐ | 🎉 **V3.1完成 + GCP报表 + Bug修复！** 质控引擎升级 + 4张GCP业务报表 + AI时间线增强 + 一键全量质控 | **P1-2** |
-| **SSA** | 智能统计分析 | **QPER架构** + 四层七工具 + 对话层LLM + 意图路由器 | ⭐⭐⭐⭐⭐ | 🎉 **Phase I-IV 开发完成** — QPER闭环 + Session黑板 + 意图路由 + 对话LLM + 方法咨询 + 对话驱动分析，E2E 107/107 | **P1** |
+| **SSA** | 智能统计分析 | **QPER架构 + 双通道（QPER + LLM Agent）** + 四层七工具 + 对话层LLM | ⭐⭐⭐⭐⭐ | 🎉 **双通道架构 + Agent 体验优化完成** — QPER闭环 + Agent代码生成通道 + 方案B左右职责分离 + 10项Bug修复 + Plan-and-Execute架构设计，E2E全通过 | **P1** |
 | **ST** | 统计分析工具 | 126 个轻量化统计工具（旧系统 iframe 嵌入） | ⭐⭐⭐⭐ | ✅ **旧系统集成完成** — Token 注入 + Wrapper Bridge + E2E 验证通过 | P2 |
 | **RVW** | 稿件审查系统 | 方法学评估 + 🆕数据侦探（L1/L2/L2.5验证）+ Skills架构 + Word导出 | ⭐⭐⭐⭐ | 🚀 **V2.0 Week3完成（85%）** - 统计验证扩展+负号归一化+文件格式提示+用户体验优化 | P1 |
 | **ADMIN** | 运营管理端 | Prompt管理、租户管理、用户管理、运营监控、系统知识库 | ⭐⭐⭐⭐⭐ | 🎉 **Phase 4.6完成（88%）** - Prompt知识库集成+动态注入 | **P0** |
@@ -254,12 +260,32 @@
 - ✅ **QPER 集成**：对话层直接调用 plan → execute → report，analysis_plan SSE 事件传输
 - ✅ **团队审查 12 条反馈全部落地**：Phase II H1-H4、Phase III H1-H3+P1、Phase IV H1-H3+B1-B2
 
-**下一步**：Phase VI（集成测试 + 可观测性 10h）→ 交付试用 → 按需补做 Phase V
+**下一步**：Phase 5A-5C（Plan-and-Execute 分步执行）→ Phase V-B（反思编排）→ Phase VI（集成测试 + 可观测性）
 
 **相关文档**：
 - 开发计划：`docs/03-业务模块/SSA-智能统计分析/04-开发计划/11-智能对话与工具体系开发计划.md`
 - 模块状态：`docs/03-业务模块/SSA-智能统计分析/00-模块当前状态与开发指南.md`
 - 系统设计：`docs/03-业务模块/SSA-智能统计分析/00-系统设计/SSA-Pro 四层七工具实现机制详解.md`
+- 架构评审：`docs/03-业务模块/SSA-智能统计分析/07-统计专家配置/架构委员会审查报告：分步执行架构.md`
+
+#### ✅ SSA Agent 通道体验优化 + Plan-and-Execute 架构设计（2026-03-07）
+
+**Agent 通道体验优化完成（12 文件, +931/-203 行）：**
+
+| 修复项 | 问题 | 解决方案 |
+|--------|------|---------|
+| 方案 B 左右职责分离 | 左侧对话与右侧工作区信息打架 | 左侧仅输出视线牵引提示，右侧承载全部交互；双屏状态互斥同步 + 历史穿梭 |
+| JWT Token 刷新 | Agent 管线执行期间 Token 过期导致 401 | 前端 `ensureFreshToken()` 在 API 调用前检查并刷新 |
+| 代码截断 | R 代码展示不完整 | LLM maxTokens 4000→8000 + CSS 优化 |
+| 重试流式生成 | 重试时无代码展示 | 后端改用 `generateCodeStream()` + 前端状态管理优化 |
+| R Docker 结构化错误 | 错误信息 LLM 无法理解 | 20+ 模式匹配 + 行号提取 + 错误分类 + 修复建议（`format_agent_error`） |
+| Prompt 铁律 | LLM 在代码块内输出自然语言 | CoderAgent System Prompt 严格输出格式规则 + `parseCode()` 三级匹配 |
+| 进度条/按钮缺失 | Agent 模式下进度/导出按钮不工作 | 从 `agentExecution.status` 派生 phase + `reportBlocks` 判断 hasResults |
+
+**Plan-and-Execute 分步执行架构设计完成：**
+- ✅ 三份架构评估报告审查通过
+- ✅ 策略：代码累加（R Docker 保持无状态，每步累加前序成功代码）
+- ✅ 5 项工程护栏：XML 标签提取 + AST 预检 + 防御性 Prompt + 高保真 Schema + 错误分类短路
 
 #### ✅ SSA QPER 四层架构全部完成（2026-02-21）