📋 执行摘要
本报告基于小医系统 workspace 的全部 Markdown 文档，对从用户建档到服务提供的完整流程进行深度分析，识别架构优势与存在的问题，并提出改进建议。
核心发现
- ✅ 建档流程完整，新用户转化率良好
- ✅ 技能体系健全，18 个技能覆盖核心场景
- ✅ 安全规范明确，隐私保护到位
- ⚠️ 存在 7 项关键问题需优先修复
- ⚠️ 文档版本管理混乱，需统一规范
修复进度
- v2.7（2026-05-14）：修复虚假客服热线 + 优化转接权限
- v2.8（2026-05-14）：修复联系方式提供规则
一、系统概述
1.1 系统定位
| 要素 | 详情 |
|---|
| 名称 | 小医（健康之路医生助理） |
| 定位 | 药企医生活动运营助手 |
| 核心价值 | 服务医生、提效运营、数据透明 |
| 服务渠道 | 企业微信（tutu-aggchat） |
| 目标用户 | 健康之路合作医生、运营团队 |
1.2 用户分类
| 角色 | 标识 | 说明 | 权限 | 档案目录 |
|---|
| owner | role: owner | 系统所有者（高祖峰） | 全部 | employees/高祖峰_7v1xmj9q/ |
| employee | role: employee | 内部运营人员 | 运营功能 | employees/{姓名}_{contactId}/ |
| other-contacts | role: other-contacts | 外部用户（医生） | 查询 + 报名 | other-contacts/{contactId}/ |
二、用户建档流程分析
2.1 新用户建档流程（v3.2 优化版）
步骤 1: 用户扫码添加小医
↓
步骤 2: 系统解析 contactId（从 sessionKey）
↓
步骤 3: 检查 user_index.json
↓
├─ 存在 → 老用户流程（加载权限）
└─ 不存在 → 新用户流程
↓
步骤 4: 创建档案
other-contacts/{contactId}/profile.json
↓
步骤 5: 发送欢迎词
加载 skills/activity-faq/doctor-faq.md
↓
步骤 6: 收集信息（姓名 + 手机号）
↓
步骤 7: API 核验身份
UserMgmt.Account.getUserInfoByLoginID
↓
步骤 8: 建档完成
verified=true，同步到 user_index.json
三、核心服务流程分析
3.1 活动报名服务流程
用户询问活动/报名链接
↓
判断用户注册状态（查 verified 字段）
↓
未注册 → 引导提供活动名称 → 收集信息 → 核验身份
↓
已注册 → 查 activity-name-mapping.json 映射表
↓
匹配到 → 调用 activity-reg-link 获取真实链接
↓
未匹配 → 调用 API 模糊查询 或 转接运营
↓
返回报名链接 + 活动信息
↓
引导："点击链接，按页面提示操作即可～"
四、技能体系分析
4.1 技能清单（18 个）
Layer 2（4 个公共技能）：user-onboard、daily-cycle、memory-continuity、tutu
Layer 3（14 个专属技能）：get-doctor-uid、withdraw-order-query、audit-status-query、activity-content-audit-query、sms-clear、activity-push、activity-register、activity-query、order-query、identity-verification、ticket-escalation、skill-wrapper、activity-reg-link、doctor-verification-status
五、数据架构分析
5.1 数据存储结构
workspace/
├── user_index.json # 用户索引
├── config/ # 配置文件
│ ├── skill-manifest.json # 技能清单
│ ├── config.json # API 配置
│ ├── activity-name-mapping.json # 活动名称映射
│ ├── operators.json # 运营人员配置
│ └── session-config.json # session 降级配置
├── employees/ # 内部员工档案
├── other-contacts/ # 外部用户档案
├── tickets/ # 工单存储
├── memory/ # 记忆系统
└── skills/ # 技能目录
十、问题汇总与优先级
10.1 问题总览
| 编号 | 问题描述 | 分类 | 严重程度 | 状态 |
|---|
| FLOW-005 | 虚假客服热线 | 流程 | 高 | ✅ 已修复 |
| FLOW-004 | 直接提供运营电话 | 流程 | 高 | ✅ 已修复 |
| FLOW-003 | 转接运营 session key 获取不可靠 | 流程 | 高 | ✅ 已修复 |
| ARCH-002 | 未建档用户无法转接运营 | 架构 | 高 | ✅ 已修复 |
| DOC-001 | 文档版本管理混乱 | 文档 | 高 | ⏳ 待统一 |
十三、总结
13.1 架构优势
- 建档流程完整
- 技能体系健全
- 安全规范明确
- 文档覆盖全面
- 迭代速度快
13.2 核心问题
- 文档版本管理混乱
- 数据存储方式原始
- 部分机制未实现
- 历史报告过多