北京大学国际医院患者服务

问题

北京大学国际医院的挂号、排班和预约分散在小程序/人工渠道里，工程师或自动化脚本难以稳定接入：验证码、短信登录、Token 有效期、敏感操作重验都会让简单查询变成多步状态管理。若用临时脚本调用接口，还容易把 PKUIH_API_KEY、短信验证码或登录态写入日志和环境配置。pkuih-patient-service 把这些步骤封装成 Skill，让模型或终端流程按固定 API 获取科室、医生、号位并完成预约。

工作方式

该技能围绕认证、预约、报告、缴费四类接口组织。核心可用能力包括：

• 认证：getCaptcha()、sendSms(...)、login(...)、logout()，登录态约 30 分钟有效。
• 挂号：appointment.getDoctorSchedule(...) 查询科室和医生排班，appointment.getScheduleDetail(...) 获取号位，appointment.book(...) 提交预约，appointment.getAppointments(...) 查询记录。
• 扩展预留：报告模块和缴费模块已在接口层出现，但资料标注为即将推出，使用时应视为不可依赖。

关键步骤是申请 API Key、配置 ~/.profile 中的环境变量，然后按“验证码 -> 短信 -> 登录 -> 查询排班 -> 选择号位 -> 预约”的流程调用。对支付、取消等高风险操作，技能要求重新验证身份，并自动清理 /tmp/pkuih_state.json 中的状态。

适用边界

它适合做医院开放接口的薄封装和流程编排，不适合把生产支付、医疗决策或患者隐私数据长期留存。API Key 是前提，且必须避免提交到仓库；短信验证码 5 分钟有效；跨会话依赖短时效 token 和本地状态。若需要稳定上线，应补充接口限流、失败重试、密钥轮换和审计日志。