Mdeical_Sur_Report/工程分析/需求分析-2026-04-19-02-26-05.md

需求分析 — 2026-04-19-02-26-05

1. 需求背景

为 ReportEditor 加入 AI 撰写功能，接入 Kimi-2.5 多模态模型，实现智能化的手术报告辅助撰写。参考 "参考-ReportEditor.tsx" 的设计范式，构建现代化的沉浸式 AI 对话 UI。

2. 需求拆解

• Task 1：TemplateManage 工具栏新增 "插入AI可编辑区域" 按钮，支持命名且不可重名
• Task 2：ReportEditor 工具栏同步新增同样的 AI 区域插入按钮
• Task 3：SystemSettings 完善 AI 接口集成，适配 Kimi-2.5 API（baseURL + apiKey）
• Task 4：ReportEditor 右侧新增 "AI撰写" Tab 面板，包含：
  • 类微信风格的聊天对话 UI（气泡、Loading 动画）
  • 定向区域锚定（下拉选择 ai-region）
  • "允许修改正文" 沙盒开关
  • 多模态输入：语音输入（Web Speech API）、视频关键帧选择、本地图片上传
  • 快捷指令胶囊（可添加/删除/编辑）
  • Diff 二次确认弹窗（左右对比、可编辑右侧、确认后注入）
  • 注入后视觉反馈（深蓝→淡蓝→透明渐变高亮）
• Task 5：AI 调用逻辑：Fetch API 调用 Kimi API，严格 JSON Schema 输出（reply + updatedHtml）

3. 影响范围

文件	修改类型	风险等级
src/types.ts	修改（扩展 SystemSettings）	低
src/pages/SystemSettings.tsx	修改（AI设置UI）	中
src/pages/TemplateManage.tsx	修改（工具栏+插入逻辑）	中
src/pages/ReportEditor.tsx	大规模修改（工具栏、状态、右侧面板、Diff弹窗、API调用）	高

4. 优先级

• P0：ReportEditor AI 面板核心功能（聊天、API调用、Diff确认）
• P1：TemplateManage / ReportEditor 工具栏 AI 区域插入
• P1：SystemSettings Kimi 接口配置
• P2：语音输入、快捷指令编辑等增强体验

5. 验收标准

• 可在 TemplateManage 中插入 ai-region 区域，重名时弹窗阻止
• 可在 ReportEditor 中插入 ai-region 区域
• SystemSettings 可配置 Kimi API Key 和 Base URL，保存后持久化
• ReportEditor 右侧有 "AI撰写" Tab，点击可展开聊天面板
• 可向 AI 发送文本+图片（关键帧/本地上传），AI 返回 JSON 结构化回复
• 勾选"允许修改正文"时，AI 返回的 HTML 会触发 Diff 弹窗，确认后才注入
• 不勾选"允许修改正文"时，AI 回复仅在聊天气泡中展示，不修改正文
• 注入后目标区域有视觉高亮反馈
• 重新部署后页面可正常访问，无构建错误