孕期指南(按次付费)
提供中文、分阶段的循证孕期指导。核心知识库部署在服务端,本技能只负责发起请求、取回账单、携凭证取回内容,单次调用 0.10 元(人民币)。
什么时候用
用户提到以下意图时使用:
- 孕期、孕周、怀孕第几周、预产期、产检、建档、糖筛、NT、大排畸、胎动、临产、待产包
- 孕期某类不适怎么办:孕吐、胃烧心、腰背痛、水肿、失眠、便秘、头晕、见红、宫缩
- 孕期能不能做某事:能不能吃、能不能运动、能不能坐飞机、能不能同房、能不能养猫
- 伴侣、家人如何参与,夫妻如何分工、如何沟通
- 产检记录怎么整理、隐私如何保护
- 想了解某条孕期建议的证据依据、信息来源是否可靠
不适同时出现以下任一情况,先给急救行动,不要调用本技能:大量出血、持续剧烈腹痛、破水、胎动明显减少或消失、抽搐、意识改变、持续高热、严重头痛伴视物模糊、胸痛或呼吸困难。先按当前所在地联系急救或产科,再考虑解释。
单次价格与计费方式
| 项目 | 内容 |
|---|---|
| 单价 | 0.10 元 / 次 |
| 计费口径 | 每成功交付一次指导内容计一次 |
| 付款方式 | 当前对话内确认支付,无需跳转页面 |
| 重复请求 | 同一订单重试不会重复扣费 |
价格以服务端账单为准;若账单金额与上表不一致,以账单为准并在回复中说明。
调用流程
三步,缺一不可。 不要跳步,不要自行拼装请求。
第一步:取回账单
node scripts/pregnancy-guide-paid.mjs probe --weeks 24 --topics symptoms,local
返回 kind: "payment-required" 时,输出中包含账单摘要:
{
"kind": "payment-required",
"bill": {
"seller_name": "宋才逸",
"goods_name": "孕期指南 · 循证孕期指导(单次)",
"amount": "0.10",
"currency": "CNY",
"pay_before": "2026-10-25T17:50:55+08:00",
"out_trade_no": "PGN_..."
},
"state_dir": "…/.state/pregnancy-xxxxxxxx"
}
此时停下来,向用户说明:本次要调用「孕期指南」服务,费用 0.10 元,等用户确认。
也可以返回 kind: "resource",表示服务端判定已付款,内容已直接返回——这时不必再走付款。
第二步:用户确认支付
用户确认后,由当前对话环境完成支付并返回 Payment-Proof。不要自行实现付款、不要伪造凭证、不要跳过付款去抓取内容。
如果环境没有提供支付能力,如实告诉用户「当前环境无法完成支付」,不要退化成免费回答,也不要编造内容充当服务输出。
第三步:携凭证取回内容
node scripts/pregnancy-guide-paid.mjs complete \
--state-dir "…/.state/pregnancy-xxxxxxxx" \
--payment-proof "<平台返回的 Payment-Proof>"
返回 kind: "resource" 时,content 字段是 JSON 字符串,解析后得到:
stageLabel/stageFocus— 当前阶段定位与该阶段重点sections[]— 每项含topic、title、bodyboundary— 医学边界声明,回答时要保留
state_dir 必须与 probe 时一致,否则找不到订单。
参数
| 参数 | 必填 | 说明 |
|---|---|---|
--weeks |
三选一 | 孕周,0–45 的整数。已知预产期也可以换算后再传 |
--topics |
三选一 | 关注主题,逗号分隔,最多 6 个,支持中文 |
--question |
三选一 | 自然语言问题,≤500 字,服务端会自行映射主题 |
--state-dir |
建议 | 订单状态目录;不传则按参数指纹自动生成 |
--url |
否 | 覆盖服务地址,通常不需要 |
主题取值(中英文均可):
| 主题 | 何时用 |
|---|---|
symptoms |
孕吐、疼痛、出血、水肿、失眠、便秘等不适 |
care |
日常照护、饮食、运动、用药安全 |
partner |
伴侣参与、夫妻分工与沟通 |
local |
就医入口、产检流程、转诊、费用查询 |
records |
产检记录整理、隐私保护 |
weekly |
每周随访节奏、日常任务安排 |
evidence |
某条建议的证据方法 |
sources |
信息来源与核对日期 |
book |
书籍知识摘要 |
stage |
阶段总览与准备重点 |
--weeks 与 --topics 建议一起给:只给孕周拿到的是阶段重点,加上主题才会带出对应的专题正文。
依赖与环境
| 项目 | 要求 |
|---|---|
| Node.js | ≥ 18(使用内置 fetch,无第三方依赖) |
| 网络 | 能访问服务端业务地址 |
| 服务地址 | 环境变量 PREGNANCY_SERVICE_URL,或技能包根目录 service-url.txt 中第一个非注释行。已预置生产地址,通常无需改动 |
| 状态目录 | 默认 ./.state/,需可写 |
无需 npm install。脚本只用 Node 标准库。
失败时怎么办
| 现象 | 处理 |
|---|---|
NO_SERVICE_URL |
服务地址未配置,提示用户设置 PREGNANCY_SERVICE_URL,不要猜地址 |
UNEXPECTED_STATUS |
服务端异常,如实告知并给出状态码,不要用本地内容替代 |
MISSING_PAYMENT_NEEDED |
服务端未按协议返回账单,判定为不可用,停止调用 |
kind: "retryable"(HTTP 502) |
内容已生成但履约确认失败,用同一 Payment-Proof 原样重试,不要重新下单 |
kind: "payment-required"(complete 返回 402) |
凭证过期、金额或订单不匹配、或未付款。先向用户说明,不要静默重新下单 |
MISSING_PAYMENT_PROOF |
缺少凭证,回到第二步向用户确认支付 |
同订单重试是安全的,服务端做幂等,不会重复扣费。但不要为了重试而新建订单——那会产生新的账单。
回答方式
取回内容后:
- 用用户能懂的话讲,不要整段贴 JSON 或 Markdown 原文。
- 先回应他最关心的那一件事,再展开背景。
- 涉及具体症状时,先给低风险可做的事、什么时候必须联系医护、需要观察哪些变化。
- 每次最多突出 1–3 个求助信号,不要罗列罕见病,不要给诊断标签。
- 保留边界声明:本服务提供循证信息与准备思路,不构成诊断、处方或替代产科决策。
- 不要提及
out_trade_no、trade_no、账单等支付细节,除非用户主动问。
隐私
- 不要求用户提供姓名、身份证号、病历号、精确地址。
- 订单状态目录只保存订单号、金额、请求参数和账单,不保存对话内容。
- 用户询问时,说明内容来自服务端知识库,本地只保留订单凭据。