# 历史问题追踪清单

> 时间范围：2026-04-20 ~ 2026-04-27  
> 文档生成时间：2026-04-27 18:55

---

## 2026-04-20（项目启动初期）

### 问题 #H001：提现查询 API 参数错误

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

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

**解决方案：**
修改 `withdraw-order-query` 技能，使用 `UserID` 而非 `DOCTORUID`。

**调用方式：**
```bash
# 步骤 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`

---

### 问题 #H002：验证码收不到

**发现时间：** 16:41  
**严重级别：** ⚠️ 高  
**状态：** ✅ 已解决

**问题描述：**
用户登录时收不到验证码。

**排查过程：**
1. ✅ 清空短信发送次数（sms-clear 技能）
2. ✅ 使用 UID+ 手机号双重验证清空
3. ✅ 直接调用 API 发送测试验证码

**根本原因：**
- 短信服务有延迟
- 可能运营商拦截

**解决方案：**
```bash
# 清空短信次数
python3 skills/sms-clear/scripts/clear_sms.py --phone 18059139520

# 或直接调用 API
python3 skills/api_client.py call UserMgmt.Account.getYzm {...}
```

---

### 问题 #H003：会话启动流程不完善

**发现时间：** 16:39  
**严重级别：** ⚠️ 中  
**状态：** ✅ 已解决

**问题描述：**
新用户会话启动时，未正确加载欢迎流程和权限。

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

---

## 2026-04-21

### 问题 #H004：API 请求超时

**发现时间：** 15:39  
**严重级别：** ⚠️ 中  
**状态：** ✅ 已解决

**问题描述：**
API 调用超时（Request timed out）。

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

---

## 2026-04-22

### 问题 #H005：活动查询功能缺失

**发现时间：** 16:24  
**严重级别：** ⚠️ 中  
**状态：** ✅ 已解决

**问题描述：**
用户询问"有什么活动"时，无法提供活动列表。

**解决方案：**
开发 `activity-query` 技能，调用 API：
- `DoctorIncomeUI.DoctorAnswerApi.getCityJobListByUid`

---

### 问题 #H006：技能清单不明确

**发现时间：** 16:55  
**严重级别：** ℹ️ 低  
**状态：** ✅ 已解决

**问题描述：**
用户询问技能列表时，无法提供完整清单。

**解决方案：**
创建 `config/skill-manifest.json`，包含：
- 18 个技能（Layer 2: 4 个，Layer 3: 14 个）
- 每个技能的路径、描述、required 状态

---

## 2026-04-23

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

**发现时间：** 15:51  
**严重级别：** ⚠️ 高  
**状态：** ✅ 已解决

**问题描述：**
用户手机号与银行卡绑定不一致，导致提现失败。

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

---

### 问题 #H008：用户统计需求

**发现时间：** 10:20  
**严重级别：** ℹ️ 低  
**状态：** ✅ 已解决

**问题描述：**
需要统计已建档用户数量。

**解决方案：**
```bash
# 统计 user_index.json 中的用户数
python3 -c "import json; print(len(json.load(open('user_index.json'))))"
```

---

## 2026-04-24

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

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

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

**根本原因：**
签名计算顺序错误（2026-04-27 修复）

**临时方案：**
使用通用小程序链接：
```
#小程序://无边界互联网医院/0mEeGNNb3g0rGpg
```

**最终解决：**
修复 api_client.py 签名顺序（见 #002）

---

### 问题 #H010：活动报名流程不清晰

**发现时间：** 15:20  
**严重级别：** ⚠️ 中  
**状态：** ✅ 已解决

**问题描述：**
用户询问报名流程时，无法提供完整指引。

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

---

### 问题 #H011：审核状态查询需求

**发现时间：** 15:25  
**严重级别：** ⚠️ 中  
**状态：** ✅ 已解决

**问题描述：**
用户需要查询医生审核状态。

**解决方案：**
使用 `activity-content-audit-query` 技能：
```bash
python3 skills/activity-content-audit-query/scripts/query_doctor_audit.py --phone 15809335900
```

---

### 问题 #H012：身份核验流程优化

**发现时间：** 20:09  
**严重级别：** ⚠️ 高  
**状态：** ✅ 已解决

**问题描述：**
新用户身份核验流程不完善，verified 状态管理混乱。

**解决方案：**
1. 创建 other-contacts/{contactId}/profile.json
2. 核验通过后标记 verified=true
3. 记录 doctorUid、phone 等信息

---

## 2026-04-27（今日）

详见 `issue-tracker-20260427.md`

### 问题 #001~#007

| ID | 问题 | 状态 |
|----|------|------|
| #001 | 新用户欢迎流程未执行 | ✅ |
| #002 | activity-reg-link 签名失败 | ✅ |
| #003 | API URL 双斜杠 | ✅ |
| #004 | 企业微信通知失败 | ⏳ |
| #005 | 全科医生渠道未激活 | ⏳ |
| #006 | device identity 警告 | ✅ |
| #007 | 活动名称映射 | ✅ |

---

## 问题统计

### 按日期分类

| 日期 | 问题数 | 已解决 | 待处理 |
|------|--------|--------|--------|
| 2026-04-20 | 3 | 3 | 0 |
| 2026-04-21 | 1 | 1 | 0 |
| 2026-04-22 | 2 | 2 | 0 |
| 2026-04-23 | 2 | 2 | 0 |
| 2026-04-24 | 4 | 4 | 0 |
| 2026-04-27 | 7 | 5 | 2 |
| **合计** | **19** | **17** | **2** |

### 按严重级别分类

| 级别 | 数量 | 占比 |
|------|------|------|
| 🔴 严重 | 2 | 10.5% |
| ⚠️ 高 | 5 | 26.3% |
| ⚠️ 中 | 9 | 47.4% |
| ℹ️ 低 | 3 | 15.8% |

### 按类型分类

| 类型 | 数量 | 问题 ID |
|------|------|---------|
| API 接口 | 6 | #H001, #H002, #H004, #H009, #002, #003 |
| 用户流程 | 4 | #H003, #H010, #H012, #001 |
| 渠道激活 | 2 | #004, #005 |
| 功能开发 | 3 | #H005, #H006, #H011 |
| 数据管理 | 2 | #H007, #H008 |
| 配置警告 | 1 | #006 |
| 功能优化 | 1 | #007 |

---

## 待处理问题（2 个）

### #004 企业微信通知发送失败
- **原因：** 接收方渠道未激活
- **责任人：** 全科医生团队
- **预计解决：** 等待医生主动发消息

### #005 全科医生团队渠道未激活
- **原因：** 高巧津、黄达、郑小丹未主动发消息
- **责任人：** 全科医生团队
- **预计解决：** 等待医生主动发消息

---

## 经验总结

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

### 流程类
1. **新用户欢迎**：必须检测 verified 状态
2. **员工建档**：employee_list 人员也需激活渠道
3. **工单通知**：接收方渠道未激活会失败

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

---

_最后更新：2026-04-27 18:55_