bf37acc681
- 迁移 000153: 新增 ai_feature_flags / ai_usage_daily / ai_suggestion_feedback 三张表, ai_tenant_configs 增加 billing_enabled 列, seed 12 个功能开关 + 2 个管理权限码 - 新增 FeatureFlagService: 5 分钟缓存 + DB 回退 + 即时更新 - VitalSignsTab 添加 AI 趋势分析按钮 (SSE 流式) - 新增 3 个 Entity (ai_feature_flags / ai_usage_daily / ai_suggestion_feedback) - AiState 扩展 feature_flags 字段 - 设计规格 + 讨论记录文档 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
6.5 KiB
6.5 KiB
AI 功能战略方向发散式探讨
日期: 2026-05-18 | 参与者: 用户 + Claude
背景
HMS 健康管理平台综合评分 6.8/10，功能完整度 87%，但六维度分析评价 AI 为"有弹药没上膛"——底层能力完整（3 Provider + SSE 分析 + Copilot 引擎 + Agent Phase 0），用户触达断裂（4 个 SSE 端点无 UI 入口、客服"小华"仅为简单问答）。
在 AI Agent Phase 0 刚完成之际，对 AI 功能的五个维度进行全面发散式探讨，确定战略方向。
讨论维度与决策
维度 1：产品定位 — 统一入口"AI 健康管家"
结论：统一入口"AI 健康管家"+ 分级沙箱隔离
- 前端统一为一个入口——用户感知是"问小华"
- 后端按角色创建隔离沙箱：患者沙箱、医护沙箱、管理沙箱
- 每个沙箱有独立的 Tool 白名单、数据范围、Prompt 策略
- 统一体验 ≠ 统一权限
数据安全机制（5 层防护）：
| 风险层 | 防护措施 |
|---|---|
| 跨患者 | Tool 自动注入当前用户 patient_id，LLM 无法伪造 |
| 跨租户 | session_id + tenant_id 双过滤，沿用现有中间件 |
| 跨角色 | ToolRegistry.get_allowed_tools(role) 硬过滤，非 Prompt 约束 |
| 越权 Tool | 后端按 role 限定可用 Tool 集合 |
| Prompt 注入 | 输出层关键词检测 + 输入层 sanitize |
三个角色沙箱定义：
- 患者沙箱：查自己体征/化验、科普知识、预约挂号。数据范围仅自己、输出脱敏。
- 医护沙箱：查所管患者、AI 分析、风险评分、文书辅助。数据范围本科室患者、含诊断信息。
- 管理沙箱：成本统计、用量趋势、效果分析、功能开关。数据范围本机构汇总、无个体数据。
维度 2：数据智能闭环 — 先打通最短路径
结论：先 A（AI→用户可见），同步设计 B 数据结构，C 远期愿景
- A（1-2 周）：Web 化验报告页"AI 解读"按钮 + 小程序体征页"AI 趋势分析"按钮。复用现有 SSE 端点，前端 3-5 天。
- B（2-4 周）：Copilot 每日扫描高风险患者 → 生成洞察 → 消息中心推送 → 患者"采纳/忽略/咨询医生"反馈 → 数据写入
ai_suggestion度量。 - C（3-6 个月）：洞察 → 行动 → 效果追踪 → 模型优化的完整飞轮。
维度 3：多角色 AI 体验 — 角色 Prompt 为基础设施
结论：A 必做，B 医护端最有价值，C 管理看板纳入第一阶段
- A（2-3 周）：system_prompt 根据 user_role 动态组装。患者版温和通俗带情绪安抚、医护版专业简洁引用数据来源、管理版汇总对比。Tool Registry 按角色过滤。
- B（3-5 周）：Web 后台右侧常驻 AI 侧边栏。查看患者档案时 AI 自动总结、随访页 AI 辅助生成小结。上下文感知的智能摘要，非对话模式。
- C：合并到 AI 管理看板（见维度 5 + 跨维度决策）。
维度 4：技术架构 — 云端部署 + pgvector RAG + 在线/本地语音
结论：纯云端部署，不调本地 LLM
| 能力 | 技术选型 |
|---|---|
| LLM 推理 | Claude / OpenAI（云端），Ollama 仅开发测试 |
| RAG 知识库 | pgvector 扩展 PostgreSQL + 在线 Embedding API（text-embedding-3-small） |
| 语音识别 | 在线：Whisper API / 讯飞；降级：Whisper.cpp (CPU) |
| 语音合成 | 在线：OpenAI TTS / 讯飞；降级：edge-tts (免费) |
RAG 架构：知识文档 → 在线 Embedding API → pgvector 存储 → 用户提问 → 同款 Embedding → pgvector 语义检索 → Top-K 注入 Agent 上下文。
语音方案：默认在线 API（质量好、延迟低），降级时 CPU 本地（零成本、可接受延迟）。
维度 5 + 跨维度：AI 用量付费 + 综合管理看板
结论：按机构（租户）颗粒度用量付费，管理看板与 AI 能力同步搭建
计费模式：
- 按机构月度 Token 用量阶梯计价
- 基础 AI（本地规则引擎、Copilot 风险评分）不消耗 Token
- 高级 AI（LLM 对话、化验解读、趋势分析）消耗 Token
- 机构管理员可设预算上限和预警线
管理看板模块：
| 模块 | 内容 |
|---|---|
| 用量总览 | 调用量趋势、按角色/功能分布、峰值均值 |
| 成本分析 | Token 消耗、按 Provider/功能类型、日/周/月、预算预警 |
| 效果追踪 | 分析完成率、建议采纳率、异常检出率、人工干预率 |
| 功能开关 | AI 分析（全局+按类型）、AI 聊天（全局+按角色）、AI 预警推送、RAG 知识检索、语音交互、Copilot 辅助 |
| 配置管理 | Provider 配置、配额管理、Prompt 模板管理、知识库管理、告警阈值 |
功能开关粒度： 全局开关 + 按子功能开关，支持关闭单个功能而保留其他。
实施优先级共识
| 阶段 | 内容 | 工期 |
|---|---|---|
| Phase 1A | 打通 AI→用户可见（Web 化验 AI 解读按钮 + 小程序体征趋势分析按钮） | 1-2 周 |
| Phase 1B | 角色分级 Prompt 策略 + Tool 权限沙箱 | 2-3 周 |
| Phase 1C | AI 管理看板（用量/成本/效果/开关） | 2-3 周 |
| Phase 1A/1B/1C 同步推进，1C 与 1A/1B 并行开发 | ||
| Phase 2A | 医护端 AI 助手面板（侧边栏 + 患者摘要 + 随访辅助） | 3-5 周 |
| Phase 2B | 洞察→推送→反馈闭环（Copilot 每日扫描 + 消息推送 + 采纳反馈） | 2-4 周 |
| Phase 3A | RAG 知识库（pgvector + Embedding API + 语义检索 Tool） | 3-5 周 |
| Phase 3B | 语音交互（在线为主 + CPU 降级） | 3-4 周 |
| 远期 | 主动关怀引擎飞轮、多 Agent 协作、领域微调 | 6-12 个月 |
与现有 Agent 计划的关系
本次讨论的方向在已有 AI Agent 突破口设计（docs/superpowers/specs/2026-05-18-ai-agent-breakthrough-design.md）基础上扩展：
- Agent Phase 1-3 的 Tool 扩展、会话持久化、行动类 Tool 按原计划推进
- 新增：角色沙箱机制、管理看板、AI→UI 触点打通、RAG 知识库
- 新增管理看板需要：
ai_feature_flags表（功能开关）、ai_usage_daily聚合表（用量统计） - 计费相关：
ai_billing_records表（Token 消耗记录）、ai_tenant_quotas扩展（月度预算）
待定事项
- Embedding API 选型（OpenAI text-embedding-3-small vs 国内智谱/阿里）
- 语音服务商选型（讯飞 vs 阿里 Paraformer vs Whisper API）
- 管理看板是独立页面还是嵌入现有设置中心
- AI 用量付费的阶梯定价具体方案