# 小医问题汇总清单

**时间范围：** 2026-04-20 ~ 2026-04-28  
**整理时间：** 2026-04-28 14:35  
**整理人：** 小医

---

## 📊 总体统计

| 统计项 | 数值 |
|--------|------|
| **问题总数** | 26 个 |
| **已解决** | 22 个（84.6%） |
| **待处理** | 2 个（7.7%） |
| **今日新增** | 2 个（活动查询流程优化） |

---

## 📅 按日期分布

| 日期 | 问题数 | 主要内容 |
|------|--------|---------|
| 2026-04-20 | 3 | 提现查询、验证码、会话启动 |
| 2026-04-21 | 1 | API 超时 |
| 2026-04-22 | 2 | 活动查询、技能清单 |
| 2026-04-23 | 2 | 手机号绑定、用户统计 |
| 2026-04-24 | 4 | 医道微光链接、报名流程、审核查询、身份核验 |
| 2026-04-27 | 7 | 签名验证、URL 双斜杠、渠道激活等 |
| 2026-04-28 | 7 | 活动查询流程优化、欢迎词优化 |

---

## 🔴 严重问题（2 个）

### #H001 提现查询 API 参数错误

**发现时间：** 2026-04-20 08:07  
**严重级别：** 🔴 严重  
**状态：** ✅ 已解决

**问题描述：**  
提现查询接口使用错误的参数名 `DOCTORUID`，导致查询失败。

**处理方式：**
```bash
# 修改 withdraw-order-query 技能
# 使用 UserID 而非 DOCTORUID

# 步骤 1：获取 UserID
python3 skills/get-doctor-uid/scripts/get_doctor_uid.py --phone 15318816068 --json

# 步骤 2：查询提现（使用 UserID）
python3 skills/withdraw-order-query/scripts/query_withdraw_orders.py --user-id "0015CF936BEE45EF8842396530674EFB"
```

**涉及 API：** `DoctorIncomeUI.DoctorCashApi.queryUserWithdrawList`

---

### #H009 医道微光报名链接查询失败

**发现时间：** 2026-04-24 15:17  
**严重级别：** 🔴 严重  
**状态：** ✅ 已解决（2026-04-27）

**问题描述：**  
调用 `getPartnerRegistrUrl` 接口查询"医道微光"报名链接，返回"api 参数缺失或 api 参数值格式错误"。

**根本原因：**  
签名计算顺序错误

**处理方式：**
```python
# 修复 api_client.py 签名顺序
# ❌ 错误：先添加 appId，再签名
# ✅ 正确：先签名，后添加 appId

sign_params['timestamp'] = timestamp
sign = create_sign(self.app_id, self.secret, sign_params)  # 先签名
sign_params['appId'] = self.app_id
sign_params['sign'] = sign
```

**修复文件：** `/home/admin/.openclaw/workspace/skills/api_client.py`

---

## ⚠️ 高优先级问题（5 个）

### #H002 验证码收不到

**发现时间：** 2026-04-20 16:41  
**状态：** ✅ 已解决

**处理方式：**
```bash
# 清空短信发送次数
python3 skills/sms-clear/scripts/clear_sms.py --phone 18059139520

# 或直接调用 API 发送测试验证码
python3 skills/api_client.py call UserMgmt.Account.getYzm {...}
```

---

### #H007 手机号绑定问题

**发现时间：** 2026-04-23 15:51  
**状态：** ✅ 已解决

**处理方式：**  
在 order-query 技能中添加提示：
- 银行卡必须是医生本人的
- 手机号必须是银行预留手机号
- 检查卡号是否有空格

---

### #H012 身份核验流程优化

**发现时间：** 2026-04-24 20:09  
**状态：** ✅ 已解决

**处理方式：**
```bash
# 1. 创建 other-contacts/{contactId}/profile.json
# 2. 核验通过后标记 verified=true
# 3. 记录 doctorUid、phone 等信息
```

---

### #001 新用户欢迎流程未执行

**发现时间：** 2026-04-27 17:40  
**状态：** ✅ 已解决

**处理方式：**
```bash
# 1. 检查用户档案
cat /home/admin/.openclaw/workspace/other-contacts/{contactId}/profile.json

# 2. 标记为待欢迎状态
{
  "status": "pending_welcome",
  "rebuildReason": "新用户欢迎流程未正确执行"
}

# 3. 引导用户主动发消息激活渠道
```

---

### #004 企业微信通知发送失败

**发现时间：** 2026-04-27 17:06  
**状态：** ⏳ 待处理

**问题描述：**  
通过 message 工具发送企业微信消息返回 500 错误："未找到渠道"。

**根本原因：**  
接收方（全科医生团队）虽已建档，但**未主动给小医发消息**，渠道未激活。

**处理方式：**
```bash
# 让接收方主动给小医发微信消息
# 系统自动激活渠道
```

**责任人：** 全科医生团队  
**预计解决：** 等待医生主动发消息

---

## ⚠️ 中优先级问题（11 个）

### #H003 会话启动流程不完善

**发现时间：** 2026-04-20 16:39  
**状态：** ✅ 已解决

**处理方式：**  
制定 AGENTS.md 启动检查清单：
1. 获取 contactId
2. 检查 user_index.json
3. 新用户→发送欢迎词
4. 老用户→加载 SESSION_STATE

---

### #H004 API 请求超时

**发现时间：** 2026-04-21 15:39  
**状态：** ✅ 已解决

**处理方式：**
- 增加超时时间：`API_TIMEOUT = 30`
- 添加重试逻辑
- 优化错误提示

---

### #H005 活动查询功能缺失

**发现时间：** 2026-04-22 16:24  
**状态：** ✅ 已解决

**处理方式：**  
开发 `activity-query` 技能，调用 API：
- `DoctorIncomeUI.DoctorAnswerApi.getCityJobListByUid`

---

### #H010 活动报名流程不清晰

**发现时间：** 2026-04-24 15:20  
**状态：** ✅ 已解决

**处理方式：**  
整理 activity-faq.md，包含：
- 报名工具（小程序/APP）
- 报名步骤
- 入驻要求
- 常见问题

---

### #H011 审核状态查询需求

**发现时间：** 2026-04-24 15:25  
**状态：** ✅ 已解决

**处理方式：**  
使用 `activity-content-audit-query` 技能：
```bash
python3 skills/activity-content-audit-query/scripts/query_doctor_audit.py --phone 15809335900
```

---

### #003 API URL 双斜杠问题

**发现时间：** 2026-04-27 16:53  
**状态：** ✅ 已解决

**处理方式：**
```bash
# 修复 api_client.py URL 拼接
# ❌ 错误：f"{API_BASE_URL}/{api_path}"
# ✅ 正确：f"{API_BASE_URL}{api_path}"

sed -i 's|f"{API_BASE_URL}/{api_path}"|f"{API_BASE_URL}{api_path}"|g' skills/api_client.py
```

---

### #005 全科医生团队渠道未激活

**发现时间：** 2026-04-27 17:22  
**状态：** ⏳ 待处理

**问题描述：**  
全科医生团队（高巧津、黄达、郑小丹）无法接收工单通知。

**处理方式：**
```bash
# 1. 让全科医生用微信给小医发任意消息（如："你好"）
# 2. 系统自动激活渠道
# 3. 验证渠道激活
```

**责任人：** 高巧津、黄达、郑小丹

---

### #007 活动名称映射不完善

**发现时间：** 2026-04-27 16:29  
**状态：** ✅ 已解决

**处理方式：**
```bash
# 1. 创建映射配置文件
cat > config/activity-name-mapping.json << 'EOF'
{
  "mappings": [
    {
      "keywords": ["医道微光", "精准免疫"],
      "actualName": "精准免疫肿瘤诊疗管理",
      "shortUrl": "https://fjhma.com/1DL8uI"
    }
  ]
}
EOF

# 2. 更新 AGENTS.md 添加映射规则
```

---

### #20260428-01 活动查询流程优化

**发现时间：** 2026-04-28 10:05  
**状态：** ✅ 已解决

**问题描述：**  
活动查询逻辑不完善，未优先查本地映射表。

**处理方式：**
```bash
# 1. 更新 activity-query/SKILL.md v3.0
# 2. 更新 AGENTS.md v2.7
# 3. 明确查询流程：
#    ① 查映射表 → ② 返回链接 → ③ API 验证 → ④ 引导报名
```

---

### #20260428-02 欢迎词引导不足

**发现时间：** 2026-04-28 10:31  
**状态：** ✅ 已解决

**问题描述：**  
欢迎词末尾没有引导医生提供活动名称。

**处理方式：**
```bash
# 1. 更新 doctor-faq.md 欢迎词
# 2. 增加引导语：
#    "如果您想参加某个活动，直接告诉我活动名称或板块名称..."
# 3. 更新 AGENTS.md v2.8
```

---

### #20260428-03 未注册医生引导冗余

**发现时间：** 2026-04-28 10:41  
**状态：** ✅ 已解决

**问题描述：**  
未注册医生引导流程重复，让医生反感。

**处理方式：**
```bash
# 1. 简化话术：只给链接 + 一句话引导
# 2. 信任产品自动化流程
# 3. 文案原则：
#    - 不重复说明注册/认证流程
#    - 一句话引导："点击链接，按页面提示操作即可～"
```

---

## ℹ️ 低优先级问题（6 个）

### #H006 技能清单不明确

**发现时间：** 2026-04-22 16:55  
**状态：** ✅ 已解决

**处理方式：**  
创建 `config/skill-manifest.json`，包含 18 个技能清单。

---

### #H008 用户统计需求

**发现时间：** 2026-04-23 10:20  
**状态：** ✅ 已解决

**处理方式：**
```bash
python3 -c "import json; print(len(json.load(open('user_index.json'))))"
```

---

### #006 device identity required 警告

**发现时间：** 2026-04-27 17:55  
**状态：** ✅ 已澄清

**问题描述：**  
系统显示"device identity required"，误以为有设备配对申请。

**处理方式：**  
配置警告，非实际申请。检查确认无 pending 配对申请即可。

---

## 📋 待处理问题汇总（2 个）

| ID | 问题 | 责任人 | 预计解决 |
|----|------|--------|---------|
| #004 | 企业微信通知发送失败 | 全科医生团队 | 等待医生主动发消息 |
| #005 | 全科医生渠道未激活 | 高巧津、黄达、郑小丹 | 等待医生主动发消息 |

---

## 📂 相关文档

| 文档 | 路径 |
|------|------|
| 历史问题追踪 | `docs/history-issues-tracker.md` |
| 4.27 问题清单 | `docs/issue-tracker-20260427.md` |
| 用户服务流程 | `docs/user-service-flow.md` |
| 活动名称映射 | `config/activity-name-mapping.json` |
| 技能清单 | `config/skill-manifest.json` |

---

## 📊 问题类型分布

| 类型 | 数量 | 占比 |
|------|------|------|
| API 接口 | 6 | 23% |
| 用户流程 | 6 | 23% |
| 渠道激活 | 2 | 8% |
| 功能开发 | 4 | 15% |
| 数据管理 | 3 | 12% |
| 配置警告 | 1 | 4% |
| 功能优化 | 4 | 15% |

---

## 💡 经验总结

### 技术类
1. **签名算法**：必须先签名，后添加 appId/sign
2. **URL 拼接**：注意基础 URL 末尾是否已有 /
3. **渠道激活**：tutu-aggchat 需用户主动发消息
4. **API 参数**：UserId vs DOCTORUID 要分清

### 流程类
1. **新用户欢迎**：必须检测 verified 状态
2. **员工建档**：employee_list 人员也需激活渠道
3. **工单通知**：接收方渠道未激活会失败
4. **活动查询**：优先查映射表，再调 API

### 文档类
1. **活动名称映射**：品牌名→系统名必须维护
2. **用户服务流程**：已整理完整文档
3. **问题追踪**：每日记录便于复盘

---

_整理时间：2026-04-28 14:35_  
_文档版本：v1.0_