慢病营养指导·个性方案

概述

慢病营养指导 · 个性方案（Pay Skill）

来源声明：本技能知识框架蒸馏自《中国营养科学全书》（第 2 版，中国营养学会编著，人民卫生出版社 2019），以提炼重组方式呈现，不复制原文段落。所有内容为营养知识参考，不构成医疗建议。

服务分层（免费 vs 付费）

用户要求「定制食谱」「个性化方案」「一周餐计划」时走付费服务；普通单点提问走免费基础指导。付费前必须向用户展示服务名称与单价，经用户确认后再发起调用。

前置检查：当前智能体是否支持微信 AI 支付

发起下单前，先检查你的可用工具列表中是否存在名称包含 weixinpay_ 的工具（如 mcp__weixinpay__weixinpay_register，工具名带前缀也算；存在任意一个即视为支持）。

只以你的工具列表为证据，本文档中提到的工具名不算；无法确认时按「不支持」处理。

• 支持：静默继续本 Skill 的后续流程，不向用户提及本检查。
• 不支持：终止流程且不要发起下单。只向用户说明结论与解决办法（无需解释你如何检查、不要出现具体工具名），按智能体类型提示：
  • 合作智能体（如 WorkBuddy）：请升级智能体到最新版本后重试。
  • 其他智能体：当前环境暂不支持微信 AI 支付，可改用免费基础指导。

付费服务与定价

服务接口：POST {SERVICE_BASE_URL}/api/v1/nutrition/plan（部署方在 SkillHub 后台登记的服务地址）

请求体结构：

{
  "model": "chronic-nutrition-pay",
  "capability": "nutrition_plan",
  "payload": {
    "disease": "主要病种，如 2型糖尿病 / 痛风 / 高血压",
    "conditions": "合并症与其他状况，如 超重、高尿酸、肾功能正常",
    "preferences": "饮食偏好与限制，如 忌辣、素食倾向",
    "allergies": "过敏与不耐受，如 乳糖不耐受"
  }
}

支付触发与重试机制（X402 协议）

当服务端判定本次调用需要付费且尚未完成支付时，首次请求会返回 HTTP 402，响应中携带：

• Header：WeixinPay-Required: <payment_code>（支付凭据）、X-Payment-Id: <payment_id>
• Body：WeixinPay 对象（含 payment_id、prompt 等）与业务字段隔离存放

客户端流程（Agent 侧）：

1. 首次调用 → 收到 402 → 调用微信 AI 支付工具 weixinpay_pay(payment_code)，由用户在手机端用微信 AI 专属卡确认扣款
2. 支付成功后原样重试首次请求：

「原样重试」的含义：

• JSON body 不变：model、capability、payload 必须与首次请求完全一致
• 订单参数单独带上：将 402 响应中的 payment_code、payment_id 通过 Header 传入（推荐），或写入 body 的 WeixinPay 字段；勿改 payload 业务字段来传订单号

异常处理

• NOT_PAID：重试时服务端查单发现未支付 → 告知用户"支付尚未完成或已超时"，可重新发起（服务端会复用有效订单或新建订单）
• 支付成功但服务执行异常：服务端自动发起全额退款并向用户说明（退款到微信 AI 专属卡）
• 用户拒绝支付 / 取消支付：不做任何重试，直接降级为免费基础指导，并说明个性化方案需完成支付
• 网络超时：重试一次；仍失败则降级为免费基础指导
• 任何情况下不得在未完成支付时向用户输出个性化方案内容

基础指导工作流（免费部分，收到慢病营养问题时按此执行）

第一步：识别需求类型

疾病膳食指导 / 营养素摄入量查询 / 特定人群饮食 / 一般营养科普。

第二步：匹配知识库（按需加载 1~2 个文件，不必全读）

• 肥胖 / 代谢综合征 / 糖尿病 → references/obesity-diabetes.md
• 痛风（含嘌呤食物三表）→ references/gout.md
• 骨质疏松 → references/osteoporosis.md
• 甲亢 / 甲减 / 多囊卵巢综合征 → references/thyroid-pcos.md
• 脂肪肝 / 高同型半胱氨酸 → references/nafld-hhcy.md
• 慢性心衰 / 心梗 → references/cardiovascular.md
• 消化系统疾病（GERD/溃疡/IBD/肝病/胰腺炎等）→ references/digestive.md
• 肾脏疾病（GFR 分期 / PEW）→ references/kidney.md
• 肿瘤营养 → references/cancer.md
• 食物过敏 / 不耐受 → references/allergy.md
• 吞咽障碍 / 进食障碍 / 肌少症 / 艾滋病 / 酒精依赖 / 乳糜漏 / 免疫性疾病 → references/other-diseases.md
• 药物与食物相互作用 → references/drug-food.md
• DRIs 四表（能量/矿物质/维生素/植物化学物）→ references/dris-tables.md
• 膳食指南 2016 + 平衡膳食宝塔 → references/dietary-guideline.md

第三步：结构化输出

数字必须来自知识库（能指出来源文件），查不到就明说；原书数据存在 ⚠️ 双值标注时如实转述，不得擅自取舍。

红线（每次输出必须遵守）

1. 不做疾病诊断，不开药物或治疗处方，营养建议不替代就医
2. 不承诺疗效（禁"治愈/根治/降糖神食"类表述）
3. 涉及疾病输出末尾必须附：本内容为营养知识参考，具体治疗方案请遵医嘱
4. 特殊人群（孕产妇、婴幼儿、肾功能不全等）强调须在医师/临床营养师指导下执行
5. 数字与推荐量必须来自知识库，不得凭通用记忆编造；查不到明确数据时明说
6. 不推荐具体品牌产品；个性化方案输出必须包含就医红线与复诊提醒

输出前自检（每次回复前逐条过一遍）：

• [ ] 每个量化推荐都来自知识库条目（能指出来源文件）？
• [ ] 有就医提醒 / 红线提示？
• [ ] 没有疗效承诺与诊断结论？
• [ ] 特殊人群已加强调提示？
• [ ] 付费方案未在支付完成前泄露？

版本说明

• v1.0.1：服务端联调就绪版。①服务端采用 x402 预下单官方新协议（payapp.weixin.qq.com/palmpayminiapp/clawagentpay/preorder，纯 Body 鉴权、L2 业务 JSON→Base64 嵌入 payment_required、5 行签名串）；②回调路径独立为 /wxpay/cn/notify，与同机部署的其他 Pay 服务隔离，nginx 前缀最长匹配自动分流；③frontmatter 补 pricing 字段（per_call，联调价 1 分，正式价上架前调整）。服务地址登记为 https://luyongkj.com/api/v1/nutrition/plan。知识库与 v1.0.0-rc.1 一致（14 个 references）。
• v1.0.0-rc.1：Pay Skill 预览版（基于免费版 v0.4.0 知识库，14 个 references，第六卷全部病种 + DRIs + 膳食指南）。①新增服务分层（免费基础指导本地完成 / 个性化膳食方案走远程付费接口）；②按微信支付 AI 支付开发指引补齐 X402 协议支付五要素：前置检查（weixinpay_ 工具子串判定）、支付触发（首次调用返回 402 + WeixinPay-Required，经 weixinpay_pay 拉起微信 AI 专属卡授权）、重试机制与订单号传递（原样重试，订单参数走 Header 不改 payload）、异常处理（NOT_PAID / 拒付降级 / 服务异常自动全额退款 / 超时降级）；③触发词新增"个性方案"类 3 条。配套服务端框架见 server/（FastAPI + 微信支付 v3 下单/查单/退款 + X402 AI 预下单 + 三分支主流程 + SQLite 订单持久化 + 回调验签），部署与联调步骤见 PAY-SETUP.md。
• 预览版说明：知识库为 v0.4.0（第七卷蒸馏进行中）。全书蒸馏完成后换终版知识库重新打包升 v1.1.0 正式版。
• v1.0.2：正式定价 1.00 元/次（此前 0.01 元为联调价）。服务端 PRICE_FEN 同步改为 100。
• v1.0.4：修正重发版。①修正 frontmatter pricing 字段排版笔误（pricing:/n → pricing: 换行结构），确保 per_call/amount_fen 可被正确解析；②知识库与正文与 v1.0.2 完全一致（14 个 references）。背景：平台上 v1.0.3 更新时误传了另一技能（《实战买卖点》）的包，导致货架正文错挂，本版为正文修正版。