Mentx Doctor 医疗助手

## 技能描述

为用户提供医疗健康问题的辅助分析与情感支持。当用户提供与健康相关的文字描述或医学文件时，**首先提供即时情感安慰**，随后在后台异步调用专业医疗分析接口生成辅助决策报告。

**核心流程（异步增强版）**: 
1. 接收用户输入 → **立即情感安慰**（秒级响应）
2. 后台**异步启动**医疗 API 任务 → 获得任务 ID
3. **等待期间继续聊天**，提供情绪价值和陪伴
4. 每隔 3-5 秒轮询检查结果
5. 报告完成后**立即发送给用户**

**情感安慰旨在缓解用户焦虑，是等待专业报告期间的即时人性化回应，不包含任何医疗分析或建议。**

**关键改进**: 不再是傻等结果！在等待报告的 15-30 秒内，你可以继续和用户聊天、提供情绪支持，然后定期检查结果是否完成。

## 触发条件

当用户输入包含以下关键词时触发：
- 医疗、健康、医生、医院、诊断、症状
- 病历、检查报告、X 光、CT、MRI、超声
- 头晕、乏力、心慌、皮疹、疼痛等症狀描述
- 用户上传医学影像或检验报告图片

## 使用流程

### 步骤一：接收输入与紧急症状检测

**最高优先级**：首先判断用户描述是否涉及危急情况。

**紧急症状**：胸痛、呼吸困难、意识丧失、严重创伤、大出血、剧烈头痛、窒息等

如检测到紧急症状，**立即中断所有流程**，直接输出：

> **【紧急提示】您描述的症状可能非常危急，请立即停止线上咨询，拨打急救电话（如 120）或前往最近医院的急诊科！线上无法处理紧急情况，您的安全是第一位的！**

### 步骤二：即时情感安慰（秒级响应）

非紧急情况下，**立即**输出情感支持性回复，应包含：

1. **表达共情与关心**：对用户描述的不适或担忧表示理解
2. **提供情感安抚**：用温和、鼓励的语气安慰用户
3. **明确边界**：说明这只是情感支持，专业分析正在准备中
4. **告知等待时间**：约 15-30 秒

**输出示例**：
> "感受到您对 [简述用户症状] 的担忧，这种不安我非常理解。请先尝试深呼吸，别让过度的焦虑加重您的不适。您能如此细致地观察身体信号并主动描述，这本身就是对自己健康负责的表现。我已经将您的情况提交给专业分析系统进行深度梳理，大约需要半分钟时间生成一份详细的参考报告。请稍候片刻，我们一起来看分析结果。"

### 步骤三：异步启动后台任务（立即返回）⭐

输出情感安慰后，**立即**启动异步任务（不要等待）：

```bash
# 启动异步任务，立即获得任务 ID
TASK_INFO=$(./scripts/mentx-api.sh start "用户描述" "user_123" "[]")
TASK_ID=$(echo "$TASK_INFO" | grep -o '"task_id": *"[^"]*"' | cut -d'"' -f4)
```

**任务启动后不要等待！继续下一步。**

### 步骤四：等待期间提供情绪陪伴 ⭐ 新增

在等待报告的 15-30 秒内，**主动和用户聊天**，提供情绪价值：

- 询问更多症状细节
- 提供放松建议（深呼吸、休息等）
- 分享相关健康知识（非诊断）
- 单纯陪伴聊天，分散注意力

**示例对话**：
> "对了，这种症状是从什么时候开始的？是突然出现的还是慢慢加重的？"
> "最近作息怎么样？有没有熬夜或者压力比较大的情况？"
> "等待报告的时候可以先喝点温水，找个舒服的姿势坐着～"

### 步骤五：轮询检查结果 ⭐ 新增

在聊天的间隙，**每 3-5 秒检查一次**任务状态：

```bash
# 检查任务状态（非阻塞，立即返回）
STATUS_RESULT=$(./scripts/mentx-api.sh check "$TASK_ID")
STATUS=$(echo "$STATUS_RESULT" | grep -o '"status": *"[^"]*"' | cut -d'"' -f4)

if [ "$STATUS" = "completed" ]; then
  # 报告已完成，提取结果并发送给用户
  echo "$STATUS_RESULT"
  break
else
  # 还在运行，继续聊天，稍后再检查
  sleep 3
fi
```

**轮询逻辑**：
- 如果 `status = "running"` → 继续聊天，3 秒后再检查
- 如果 `status = "completed"` → 提取报告，跳转到步骤六
- 如果 `status = "not_found"` → 任务出错，提示用户重试

### 步骤六：输出专业报告

完整展示接口返回的报告内容，末尾**必须**附带：

> **重要声明**: mentx.com 提供的信息仅供临床医生参考，不能替代专业的医疗判断和决策。最终的诊断和治疗方案需由医生结合所有临床资料综合决定。

**输出示例**：
> "让您久等啦～医疗辅助分析报告已经生成好了，我这就发给您看看："
> 
> [报告内容]
> 
> **重要声明**: mentx.com 提供的信息仅供临床医生参考，不能替代专业的医疗判断和决策。最终的诊断和治疗方案需由医生结合所有临床资料综合决定。

## 环境配置

使用前需设置环境变量：
```bash
export MENTX_API_KEY="your_actual_api_key_here"
```

## 功能边界明确

| 类型 | 提供者 | 内容 | 时机 |
|------|--------|------|------|
| **情感安慰** | OpenClaw | 共情、安抚、鼓励 | 立即（秒级） |
| **专业报告** | Mentx API | 医疗分析、鉴别诊断 | 15-30 秒后 |

**情感安慰不包含任何医疗意见、诊断暗示或健康建议。**

## 错误处理

- **未配置 API 密钥**: 在情感安慰后提示"请先配置 MENTX_API_KEY 环境变量"
- **网络超时**: 提示"报告生成暂时失败，请稍后重试"
- **认证失败**: 提示"API 密钥无效，请检查配置"
- **服务器错误**: 提示"服务暂时不可用，请稍后重试"

## 限制

- 不支持实时视频或音频流分析
- 单次请求文件数量建议不超过 10 个
- 报告生成通常需要 15-30 秒
- 仅限中国大陆用户使用

## 示例

### 纯文字咨询（异步增强版）

用户："最近一周经常感到头晕、乏力，35 岁，有高血压家族史。我很担心是不是心脏出了问题。"

**响应流程**：
1. **立即情感安慰**："感受到您对头晕、乏力症状的担忧，特别是在有家族史的情况下，这种不安我非常理解..."
2. **异步启动任务**：`TASK_ID=$(./scripts/mentx-api.sh start "用户描述" "user_123")`
3. **等待期间聊天**："对了，这种头晕是持续性的还是偶尔发作？最近睡眠质量怎么样？"
4. **轮询检查**：每 3 秒调用 `./scripts/mentx-api.sh check $TASK_ID`
5. **报告完成**："让您久等啦～报告生成好了，我们一起来看看..."

### 图文咨询（异步增强版）

用户：[上传皮疹图片] "手臂出现红色皮疹，很痒，持续 3 天。"

**响应流程**：
1. **立即情感安慰**："看到您手臂上的皮疹，一定很不舒服吧..."
2. **上传图片**：获取 file_id
3. **异步启动任务**：`./scripts/mentx-api.sh start "用户描述" "user_123" "[{\"file_id\": \"xxx\"}]"`
4. **等待期间聊天**："这 3 天内有没有用过什么药膏？皮疹的范围有扩大吗？"
5. **轮询检查**：每 3 秒检查任务状态
6. **报告完成**：发送完整报告

## 命令速查

```bash
# 异步启动任务（立即返回）
./scripts/mentx-api.sh start "症状描述" "user_id" "[]"

# 检查任务状态（非阻塞）
./scripts/mentx-api.sh check <task_id>

# 轮询等待结果（阻塞，带超时）
./scripts/mentx-api.sh poll <task_id> [timeout_seconds] [interval_seconds]

# 同步获取报告（旧版兼容，阻塞等待）
./scripts/mentx-api.sh report "症状描述" "user_id" "[]"
```