浙江省人民医院在线服务

概述

phscli — 互联网医院 CLI 工具

⚠️ 核心约束（必须遵守）

严禁自行组装 HTTP 请求

所有操作必须通过 phscli.py CLI 工具执行。严禁执行以下行为：

• ❌ 直接使用 curl 或 requests 调用 API 端点
• ❌ 自行拼接 URL、构造 JSON 请求体或猜测参数
• ❌ 参考「请求格式」章节自行构建 HTTP 请求
• ❌ 调用 phscli.py 未实现的任何接口

✅ 正确做法： 仅使用本文档中"典型工作流程"和"可用命令一览"两节列出的 phscli.py 子命令。传递的参数和顺序必须与 phscli.py --help 或本文档示例完全一致。

原因：API 请求涉及加密签名、Token 注入、多级封装等细节，自行组装极易出错。CLI 工具已经封装了所有这些逻辑。

安全规则

1. 发送短信前必须显式确认

• auth send-sms 和 patient send-sms 执行前必须向用户显式确认。
• 登录失败或验证码错误时，必须再次确认后才能重发，禁止自动重试。
• 这是防止短信滥发或误触发的合规要求。

2. 挂号前院区选择（支持默认值 + 合并确认）

• 院区允许使用默认值（朝晖院区 434）或用户明确指定的院区，不必单独用一轮让用户从列表挑选。
• 但院区必须在开场 intake 或下单前的最终确认摘要中明示，让用户知情；用户未提出异议即视为确认。禁止在用户完全不知情的情况下静默选定院区。
• 确定院区后，必须静默执行 register set-hospital --hos-id <ID> 切换 sysCode，再进行科室列表 → 排班 → 号源 → 下单。
• 禁止跳过 sysCode 切换。 不同院区 sysCode 不同，切换错误会导致号源/下单失败。
• 若用户明确要求"看看有哪些院区"，再执行 register hospital-list 展示完整列表。

3. 查报告前必须选择院区

• 报告查询必须先执行 register hospital-list 并让用户选择。
• 不同医院数据独立存储。
• 选择后必须执行 register set-hospital --hos-id <ID> 再查询报告。
• 禁止跳过院区选择。

院区 / sysCode 对照

注意：API 可能返回不准确的院区名称；代码中 _HOSPITAL_NAME_OVERRIDE 会修正。

挂号交互协议（挂号必读）

目标：把中途来回压到 2 轮以内（1 轮开场集中收集 + 1 轮最终确认；验证码因合规单独占 1 轮）。不要走一步问一步。

A. 开场集中收集（收到挂号意图的第一步）

收到"挂号 / 挂个号 / 约某科"意图后，先不要逐项追问，也不要先问手机号。用一次多选提问（AskUserQuestion，可同屏 ≤4 题）一把收齐以下要素，缺什么补什么：

1. 科室 + 号别（如"心内科专家号"）——若用户没说或不确定，进入下方【B. 自动导诊】。
2. 日期 + 上下午（如"明天下午"）——"明天/后天/周X"由 agent 自行换算成 YYYY-MM-DD，不要反问日期。
3. 院区——默认朝晖院区(434)，仅当用户明确提到别的院区才改；不单独追问，在最终确认摘要里明示即可。
4. 就诊人——先执行 patient list，按以下策略处理：
   • 就诊人在列表中 → 直接用其 patienId，不问多余问题
   • 就诊人不在列表中 → 按以下流程自动添加，不需要先问用户"是否要添加就诊人"：

① 收集手机号 → 问用户该就诊人的手机号② 发验证码（需确认）→ patient send-sms --phone <手机号> ③ 尝试绑定 → patient add --name <姓名> --phone <手机号> --verify-code <验证码> ④ 结果处理：

• [OK] patienId=xxx → ✅ 添加成功，直接用
• [NEED_COMPLETE] checkValue=xxx → 一次问齐身份证号、地址（省市区）、详细地址、民族，然后执行 patient complete（无需再发验证码）
• 民族选项（code→label）：

“01-汉族 02-蒙古族 03-回族 04-藏族 05-维吾尔族06-苗族 07-彝族 08-壮族 09-布依族 10-朝鲜族11-满族 12-侗族 13-瑶族 14-白族 15-土家族16-哈尼族 17-哈萨克族 18-傣族 19-黎族 20-傈僳族21-佤族 22-畲族 23-高山族 24-拉祜族 25-水族26-东乡族 27-纳西族 28-景颇族 29-柯尔克孜族 30-土族31-达斡尔族 32-仫佬族 33-羌族 34-布朗族 35-撒拉族36-毛南族 37-仡佬族 38-锡伯族 39-阿昌族 40-普米族41-塔吉克族 42-怒族 43-乌孜别克族 44-俄罗斯族 45-鄂温克族46-德昂族 47-保安族 48-裕固族 49-京族 50-塔塔尔族51-独龙族 52-鄂伦春族 53-赫哲族 54-门巴族 55-珞巴族56-基诺族 57-其他` → 收集时让用户选择，取 code 填 –nation，label 填 –nation-name`

• 其他失败 → 提示用户

流程总结：patient list → 不在列表 → 手机号 → 发验证码 → patient add → (若有checkValue) 收集补充信息 → patient complete

已知信息（用户已在对话中给出的、或 session/patient list 能查到的）一律不要重复问。

B. 自动导诊（用户不知道挂什么科时）

当用户表达"不知道挂什么科 / 头晕挂哪个科 / 有这些症状"时，先启动导诊环节，不要直接甩科室列表让用户猜：

1. 询问主要症状、部位、持续时间、伴随表现（一次问清，避免多轮）。
2. 基于症状给出 1–3 个推荐科室，说明推荐理由，并标注首选。
3. 用户确认科室后，再进入正常挂号流程（拉排班 → 选号源 → 下单）。
4. 涉及急重症信号（胸痛、呼吸困难、意识改变、剧烈头痛、大出血等）时，明确提示尽快线下急诊/120，不要仅靠线上挂号。

导诊只做科室指引，不做诊断结论；措辞为"建议就诊 XX 科"，而非"你得了 XX 病"。

C. 默认值与推断规则

D. 唯一确认点

信息齐全后，只在下单前给一次确认摘要（院区/科室/医生/日期时段/就诊人/费用），用户确认或说"直接挂"即下单。中间步骤（切院区、拉排班、查号源）静默执行，不逐步征询。

E. 安全红线（不可省，独立于以上优化）

• 发送短信验证码前仍必须显式确认（合规要求）。但手机号从 session / 用户已给信息读取，不再单独追问手机号。
• 验证码错误或登录失败时，再次确认后才可重发，禁止自动重试。
• 取消挂号（cancel）无需短信确认，但需向用户复述将取消的订单信息。

6. checkValue 补充建档（patient add 返回 checkValue 时触发）

完整流程见上方 A.4 就诊人，本节仅说明 patient complete 执行细节。

收集缺失信息： 向用户一次问齐（不要分多轮）：

• 身份证号（必填）
• 常住地址省市区（推荐填）
• 详细地址XX路XX号（推荐填）
• 民族（必填，从上方民族列表中选择 code + label）

如果这些信息用户已经在上文提供过，直接复用，不要重复问。

执行 complete（无需再发短信验证码）：

patient complete 
    --check-value <输出的checkValue> 
    --name <姓名> --id-card <身份证号> --phone <手机号> 
    --address "省市区" --location "详细地址"

第四步：结果通知

• 成功 → 告诉用户建档成功并返回 patienId
• 失败 → 把失败信息展示给用户

规则：整个流程由 AI 驱动自动完成，不要打印命令让用户手动执行。打印 [NEED_COMPLETE] 是给 AI 看的信号，不是给用户的提示。

概述

本地 Python CLI 工具，通过 HTTP 调用互联网医院 API，处理短信认证、就诊人管理和预约挂号。当前环境为明文传输，无加密。

重要：运行时清除 PYTHONPATH

系统 PYTHONPATH 指向旧的 Python 目录，必须清除：

PYTHONPATH="" python_exec scripts/phscli.py <command>

完整命令模板：

PYTHONPATH="" "path/to/python" "scripts/phscli.py" <subcommand>

⚠️ 请求格式（仅供代码审查对照，不可直接调用）

严禁 参考此节自行构造 HTTP 请求。以下内容仅用于代码审查和问题排查。

所有操作必须使用 phscli.py CLI 命令。

认证 API（通过 skAllinoneAuthApi）

• 网关路径：/phs-user/authUser/skAllinoneAuthApi（走 gateway，无 =H33010300046 后缀）
• 请求头：phsId: 81681688，skey: H33010300046

业务 API（直连）

• 所有业务 API 路径末尾追加 =H33010300046 后缀
• 请求头：phsId: 81681688，skey: H33010300046
• 认证 API（skAllinoneAuthApi）不使用后缀

响应

直接返回明文 JSON（无需解密）。

关键参数

参数硬编码在 scripts/phscli.py 中，参见源码常量：PHS_ID、SKEY。

可用命令一览（权威来源）

以下为 phscli.py 支持的所有 CLI 子命令。任何不在以下列表中的接口均不存在，严禁尝试调用。

命令行参数名称和类型以 --help 输出为准。

认证:
  auth send-sms --phone <手机号>             发送登录短信验证码
  auth login   --sms-code <验证码>           验证码登录

就诊人管理:
  patient list                                就诊人列表
  patient send-sms --phone <手机号>           发送就诊人绑定验证码
  patient add    --name <姓名> --phone <手机号> --verify-code <验证码>  绑定已有就诊人
  patient complete --check-value <值> --name <姓名> --id-card <身份证>
                   --phone <手机号>
                   [--address <地址>] [--location <详细地址>]
                   [--nation <代码>] [--nation-name <名称>]           补充建档(AI自动,无需验证码)

挂号:
  register hospital-list                       医院列表
  register set-hospital --hos-id <ID>          切换院区/医院
  register dept-list --hos-id <ID>             科室列表
  register schedule  --dept-id <ID>            排班列表
  register number-source --sch-id <ID> --sch-date <日期> --ampm <1|2>
                          --categor <分类> --hos-id <ID>            号源查询
  register book       --patient-id <ID> --sch-id <ID> --num-id <ID>
                       --dis-no <编号> --appointment-number <编号>
                       --dept-name <科室名> --hos-id <ID> --hos-name <医院名>
                       --fee <金额> --res-date <日期> --ampm <1|2>
                       --categor <分类> --categor-name <分类名>
                       --name <就诊人姓名> [--source 3]          预约挂号
  register my-list                              我的挂号列表
  register cancel  --order-id <订单ID>          取消预约挂号

报告查询:
  report list   --type 检验|检查|体检 --patient-id <ID> [--name <姓名>]  报告列表
  report detail --type 检验|检查|体检 --rep-id <报告ID> --hos-id <ID>   报告详情

会话:
  session                                      查看当前会话
  logout                                       退出登录

后端 API 参考对照

所有业务 API 路径末尾追加 =H33010300046 后缀。认证 API（skAllinoneAuthApi）不使用后缀。

以下表格仅用于代码审查和问题排查。严禁 直接调用这些 HTTP 端点，必须通过 phscli.py CLI 命令执行。

典型工作流程

1. 认证

# 发送短信验证码
phscli.py auth send-sms --phone 138xxxx

# 验证码登录（自动获取 herenId + token）
phscli.py auth login --sms-code 123456

2. 就诊人管理

# 就诊人列表
phscli.py patient list

# 发送就诊人绑定验证码
phscli.py patient send-sms --phone 138xxxx

# 绑定已有就诊人（已在本院建档，通过姓名+手机号+验证码尝试绑定）
phscli.py patient add --name 张三 --phone 138xxxx --verify-code 123456
# ↑ 如果输出 [OK] → 完事; 如果输出 [NEED_COMPLETE] checkValue=xxx
#   → AI 收集身份证/地址等信息 → 直接 patient complete (无需验证码)

# 补充建档（当 patient add 输出 [NEED_COMPLETE] 时，由 AI 自动调用，不给用户手动执行）
# 成功返回: patienId=xxxxx, respCode=999002

3. 挂号流程（合并确认模式）

① 开场集中收集 → ② 静默执行（set-hospital → dept-list → schedule → number-source）
   → ③ 最终确认摘要 → ④ 下单

中间步骤静默执行，不上报给用户，只在最后给一次确认摘要。

# 3.1 院区切换（静默执行，用户不可见）
# set-hospital --hos-id <ID>

# 3.2 科室列表（静默执行）
# dept-list --hos-id <ID>

# 3.3 排班查询（静默执行）
# schedule --dept-id <ID>

# 3.4 号源查询（静默执行）
# number-source --sch-id <ID> --sch-date YYYY-MM-DD --ampm 1 --categor X --hos-id <ID>

# 3.5 最终确认摘要后下单
# book --patient-id X --sch-id X --num-id X --dis-no X --appointment-number X 
#       --dept-id "XXX|XXX" --dept-name "消化内科" 
#       --doc-name "某医生" 
#       --hos-id 434 --hos-name "浙江省人民医院朝晖院区" 
#       --fee 25.30 --res-date 2026-07-18 --ampm 2 
#       --categor 3 --categor-name "副主任" --name "某患者" --source 3
# 注意: --doc-name 必传 (从 schedule 输出获取)，否则 API 存入库时 docName 为空

4. 查看/取消

phscli.py register my-list            # 我的挂号
phscli.py register cancel --order-id <orderId>  # 取消挂号（需向用户复述订单信息）
phscli.py session                     # 查看会话
phscli.py logout                      # 退出登录

5. 报告查询

流程： 选择院区 -> 切换 sysCode -> 查询报告（不能跳过院区选择）

# 5.1 医院列表（必须先执行）
phscli.py register hospital-list

# 5.2 切换医院
phscli.py register set-hospital --hos-id <用户选择的ID>

# 5.3 检验/检查/体检报告列表
phscli.py report list --type 检验 --patient-id XXXXXXXX --name 某患者
phscli.py report list --type 检查 --patient-id XXXXXXXX --name 某患者
phscli.py report list --type 体检 --patient-id XXXXXXXX

# 5.4 报告详情（参数从列表结果获取）
phscli.py report detail --type 检验 --rep-id <报告ID> --hos-id 434
phscli.py report detail --type 检查 --rep-id <报告ID> --hos-id 434
phscli.py report detail --type 体检 --rep-id <报告ID> --hos-id 434

报告列表参数：

参数对齐说明

• patient add：对齐 addOldMedical.vue save()；verifyCode 使用双重 MD5 大写：MD5(code).toUpperCase() -> MD5(result).toUpperCase()
• patient complete：当 patient add 返回 checkValue 时调用，通过 skAddPat 补充建档。必填字段：checkValue、name、idCard、phone；可选字段：address、location、nation、nationName、idType。无需验证码
• reg book：发送全部 33 个字段匹配 RegConfirm.vue；未用字段传空字符串；号源参数来自 number-source 输出
• number-source：前端发送 8 个参数（sysCode、ampm、categor、docId、deptId、hosId、schDate、schId）；CLI 默认传核心 3 个，其余可选

注意事项

1. Token 保存在 scripts/session.json 中，过期前可复用无需重新登录
2. Token 过期时：重新执行 auth login
3. source 默认=3
4. numId 为挂号必填，从 number-source 输出获取
5. 所有业务 API 通过 biz_request()（自动注入 sysCode）
6. 认证 API 通过 auth_request()（包装 skAllinoneAuthApi 格式）
7. 无 SM4 加密/解密——明文请求和响应
8. 认证 API（skAllinoneAuthApi）不带 =H33010300046 后缀；所有业务 API 路径末尾追加 =H33010300046
9. 请求头包含 skey: H33010300046
10. patient add 返回字段名为 patienId（与前端拼写一致，非 patientId）
11. 若 patient add 返回 respCode=753：缺少证件信息，可再次执行 patient add 并补充 --id-card 参数
12. 就诊人不在列表中的处理流程： 见上方 A.4 就诊人 规则，AI 自动完成添加流程，不需问用户"是否要添加"
13. 就诊人绑定验证码 不等于 登录验证码：登录走认证网关，就诊人走直连 API
14. 建议使用 register 子命令（reg 的别名），避免与 Windows 注册表工具 reg.exe 冲突
15. 下单前必须执行 set-hospital --hos-id <ID>；不同院区 sysCode 不同
16. --appointment-number 为 book 的必填参数，值来自 number-source 输出的 disNo 字段
17. book 命令必填参数：--patient-id, --sch-id, --num-id, --dis-no, --appointment-number, --dept-name, --hos-id, --hos-name, --fee, --res-date, --ampm, --categor, --categor-name, --name。缺一不可，否则 API 会报"XX不能为空"。
18. book 的 --doc-name 虽然 CLI 标记为可选，但强烈建议传，否则接口存入库时该字段为空，my-list 查不到医生名。值从 schedule 输出的 doc 字段获取。
19. userInfoByToken 接口入参格式特殊：token 要放在 authParam.token 和顶层 token 两处，authParam.args 放 {sysCode, source}，url 不带 query string。当前版本已修复。