骨化三醇胶丸（罗盖全 Rocaltrol）用药全指南
骨化三醇是活性维生素 D₃（1,25-二羟维生素 D₃），是维生素 D 在体内的"最终活性形态"。它直接促进肠道钙吸收、调节甲状旁腺激素、维持血钙骨代谢平衡。常用于：绝经后/老年性骨质疏松、慢性肾功能不全（透析）继发性甲旁亢与肾性骨营养不良、甲状旁腺功能低下、维生素 D 依赖性佝偻病。
本技能不替代医生处方，所有剂量与疗程以您的主治医师为准。急症（高钙血症抽搐、严重高钙）请直接就医。
核心红线（先读这段）
- 骨化三醇不是"钙片"：它是让钙被吸收的"钥匙"，本身含钙量极低。很多人把它当钙补，反而把血钙补爆。
- 过量 = 高钙血症：恶心、呕吐、便秘、多尿、口渴、乏力、心律失常。长期高钙伤肾（肾结石、肾钙化）。定期查血钙、血磷、PTH、肾功能。
- 剂量极小（常用 0.25μg/粒）：切勿凭感觉加量；漏服不要双倍补。
- 与钙片/利尿剂/洋地黄合用要算总账：合用时血钙更易飙高，需更密集监测。
什么时候该用 / 慎用 / 禁用
- ✅ 适用：骨质疏松（尤其伴低钙/甲旁亢倾向）、慢性肾衰透析继发甲旁亢、甲状旁腺切除后低钙、假性/特发性甲旁低、维生素 D 依赖性佝偻病。
- ⚠️ 慎用：肾功能不好（需调剂量+监测）、心肾功能不全、婴幼儿/老年人、正在服洋地黄（地高辛）或噻嗪类利尿剂。
- ⛔ 禁用：维生素 D 中毒、高钙血症、高磷血症（无恰当治疗前）、对骨化三醇过敏。
用法要点
- 口服，随餐或空腹均可（吸收不受食物大影响），固定每天同一时间。
- 骨质疏松常用起始 0.25μg 每日 1–2 次；透析继发甲旁亢常用 0.25μg 每日 1 次起，按 PTH 调；甲旁低需更大剂量并严密监测血钙。
- 具体以处方为准；本技能脚本只做"按体重/适应证初算 + 红线自查"，不替代医嘱。
与其他药/食物的相互作用
- 钙剂（碳酸钙等）：合用时血钙升高风险↑，需减量并监测。
- 噻嗪类利尿剂（氢氯噻嗪等）：减少尿钙排泄→高钙风险↑。
- 洋地黄（地高辛）：高钙会增加洋地黄中毒风险，血钙需严格控在范围。
- 镁剂（含镁抗酸药）：透析患者长期合用可致高镁血症。
- 糖皮质激素：长期使用增加钙流失，可能需加量（遵医嘱）。
- 含铝抗酸药：长期大量合用致铝蓄积（尤其肾不好者），避免。
特殊人群
- 孕妇/哺乳：仅在获益明确大于风险时使用，遵医嘱。
- 儿童：按体重算量，佝偻病治疗需儿科专科。
- 老人：更易发生高钙，起始低、监测密。
- 肾/心功能不好：减量并密集监测血钙电解质。
附带的本地工具（纯离线）
scripts/calcitriol_check.py：风险自查（禁忌/慎用/相互作用/高钙信号），CLI + 图形。scripts/calcitriol_dose.py：按体重/适应证估算剂量范围，CLI + 图形。
运行：python calcitriol_check.py --quick（自测）或--gui打开图形界面。
文件结构
references/drug-facts.md：成分机制、适应证、用法用量、不良反应、禁忌慎用、相互作用、特殊人群。references/faq-scenarios.md：12 个真实患者问答。references/calcitriol-comparison.md：活性维生素 D（骨化三醇/阿法骨化醇/普通维D）横评。
支付宝付费改造契约（PAYSKILL）
本技能为付费技能（PAYSKILL）。调用遵循支付宝 AI 生意画像契约，由平台调度层执行 probe → pay → complete → ack 流程：
- probe（探测）：平台调用前先探测是否已持有本技能的支付宝有效订阅 / 付费凭证。已付费则直接放行。
- 402 Payment-Needed：未付费时，脚本向标准输出返回 HTTP 状态
402与Payment-Needed标记，提示用户通过支付宝完成付费（pay），平台据此唤起付费页。 - complete（扣费确认）：用户在支付宝完成扣费后，平台下发
Payment-Proof（付费凭证）。 - ack（验签放行）：平台携带
Payment-Proof重试本次调用；scripts/payment_gate.py验签该凭证，确认有效后放行主流程。
订阅持久化与幂等：
- 付费状态缓存在本地
.pay_cache/state.json，避免每次调用重复付费（订阅持久化）。 - 同一
Payment-Proof在 24h 幂等窗口内仅生效一次，避免重复扣费。
现金流改造后的调用套路：
用户调用 → 平台 probe →
未付费：下发 402 Payment-Needed → 支付宝 pay → complete → 下发 Payment-Proof
已付费/携带 Proof：脚本 ack 验签 → 放行主流程
> 本契约由 SkillHUB 平台调度层解析，脚本本地仅处理 402 / 验签 / 持久化 三环节；付费本体交给支付宝。
支付宝 AI 按量付费（Machine Pay / A2M）改造说明
本 Skill 已按支付宝官方 A2M 协议改造为 Pay Skill，付费闸口位于 scripts/payment_gate.py，统一调用云端计费服务 https://pay.pembroli.cn/api/resource。
付费流程
- 未付费调用时，服务端返回 HTTP 402 +
Payment-Needed头，携带金额、商户、订单号及 RSA2 签名。 - 买家侧
payment_gate.py收到 402 后引导用户完成支付，平台回传Payment-Proof。 - 客户端携带
Payment-Proof重试资源端点。
验付调用
服务端收到 Payment-Proof 后，调用支付宝验付接口（alipay.aipay.agent.payment.verify）核验凭证有效性（trade_no、out_trade_no、active 状态），验证失败返回 400，验证通过才进入资源发放。
履约确认
资源发放成功后，服务端异步调用履约确认接口（alipay.aipay.agent.fulfillment.confirm，trade_no）回执，标记本笔订单已履约；并按 out_trade_no 做幂等，重复请求直接返回已缓存结果，杜绝重复收费。
幂等与缓存
买家侧按 slug 本地缓存 Payment-Proof（24h TTL），有效期内免重复支付；服务端按订单号幂等，保证同一笔订单只履约一次。
