小医问题汇总清单

**时间范围：** 2026-04-20 ~ 2026-04-28

**整理时间：** 2026-04-28 14:35

**整理人：** 小医

---

📊 总体统计

---

📅 按日期分布

---

🔴 严重问题（2 个）

#H001 提现查询 API 参数错误

**发现时间：** 2026-04-20 08:07

**严重级别：** 🔴 严重

**状态：** ✅ 已解决

**问题描述：**

提现查询接口使用错误的参数名 `DOCTORUID`，导致查询失败。

**处理方式：**

# 修改 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 参数值格式错误"。

**根本原因：**

签名计算顺序错误

**处理方式：**

# 修复 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

**状态：** ✅ 已解决

**处理方式：**

# 清空短信发送次数
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

**状态：** ✅ 已解决

**处理方式：**

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

---

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

**发现时间：** 2026-04-27 17:40

**状态：** ✅ 已解决

**处理方式：**

# 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 错误："未找到渠道"。

**根本原因：**

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

**处理方式：**

# 让接收方主动给小医发微信消息
# 系统自动激活渠道

**责任人：** 全科医生团队

**预计解决：** 等待医生主动发消息

---

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

#H003 会话启动流程不完善

**发现时间：** 2026-04-20 16:39

**状态：** ✅ 已解决

**处理方式：**

制定 AGENTS.md 启动检查清单：

---

#H004 API 请求超时

**发现时间：** 2026-04-21 15:39

**状态：** ✅ 已解决

**处理方式：**

---

#H005 活动查询功能缺失

**发现时间：** 2026-04-22 16:24

**状态：** ✅ 已解决

**处理方式：**

开发 `activity-query` 技能，调用 API：

---

#H010 活动报名流程不清晰

**发现时间：** 2026-04-24 15:20

**状态：** ✅ 已解决

**处理方式：**

整理 activity-faq.md，包含：

---

#H011 审核状态查询需求

**发现时间：** 2026-04-24 15:25

**状态：** ✅ 已解决

**处理方式：**

使用 `activity-content-audit-query` 技能：

python3 skills/activity-content-audit-query/scripts/query_doctor_audit.py --phone 15809335900

---

#003 API URL 双斜杠问题

**发现时间：** 2026-04-27 16:53

**状态：** ✅ 已解决

**处理方式：**

# 修复 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

**状态：** ⏳ 待处理

**问题描述：**

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

**处理方式：**

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

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

---

#007 活动名称映射不完善

**发现时间：** 2026-04-27 16:29

**状态：** ✅ 已解决

**处理方式：**

# 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

**状态：** ✅ 已解决

**问题描述：**

活动查询逻辑不完善，未优先查本地映射表。

**处理方式：**

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

---

#20260428-02 欢迎词引导不足

**发现时间：** 2026-04-28 10:31

**状态：** ✅ 已解决

**问题描述：**

欢迎词末尾没有引导医生提供活动名称。

**处理方式：**

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

---

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

**发现时间：** 2026-04-28 10:41

**状态：** ✅ 已解决

**问题描述：**

未注册医生引导流程重复，让医生反感。

**处理方式：**

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

---

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

#H006 技能清单不明确

**发现时间：** 2026-04-22 16:55

**状态：** ✅ 已解决

**处理方式：**

创建 `config/skill-manifest.json`，包含 18 个技能清单。

---

#H008 用户统计需求

**发现时间：** 2026-04-23 10:20

**状态：** ✅ 已解决

**处理方式：**

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 个）

---

📂 相关文档

---

📊 问题类型分布

---

💡 经验总结

技术类

流程类

文档类

---

_整理时间：2026-04-28 14:35_

_文档版本：v1.0_