叶桂中医产品电商化
把叶桂语料中的温病与润燥知识，转成可上架、可投放、且经得起广告法检查的电商商品内容。
适用场景
- 从叶桂语料中提取养生、节气、饮食、起居类知识点
- 把知识点映射到具体电商商品（选品 / 匹配 / 排序）
- 产出商品标题、主图卖点、详情页文案、搜索关键词
- 温病与润燥类目上架前的合规审查与改写
医家知识档案
| 项 | 内容 |
|---|---|
| 医家 | 叶桂（Ye Gui (Ye Tianshi)） |
| 时代 | 清代（1667—1746 年） |
| 学术定位 | 温病学派奠基人；创卫气营血辨证，倡养胃阴之说 |
| 代表著作 | 《温热论》、《临证指南医案》（由其弟子辑录） |
核心思想
- 卫气营血辨证：把外感温热病分为四个浅深层次
- 「温邪上受，首先犯肺」的传变认识
- 重视养胃阴、顾护津液，反对滥用温燥
可商品化知识要点
- 卫气营血作为「由表入里分层」认知模型的通俗表达
- 温邪与风寒在起居调护上的差异（通气、避风、补水）
- 「顾护津液」在四季饮水与饮食宜忌中的生活化表述
- 温病学说在节气与地域气候叙事中的应用
推荐品类映射
| 品类 | 说明 |
|---|---|
| 花草茶与代用茶 | 菊花、金银花、桑叶、薄荷等（普通食品口径） |
| 润燥食品 | 梨膏、蜂蜜、银耳、百合（不得宣称清肺止咳） |
| 四季饮品器具 | 煮茶壶、随行杯、养生壶 |
| 中医科普图书 | 温病学派入门、叶天士医案选读、节气调理读物 |
本医家特有合规红线
- 「清热」「润燥」等中医术语不得直译为功效宣称，须改写为口味、工艺、场景描述
- 代用茶、膏滋一律按普通食品口径撰写，不得出现止咳、清肺、降火等表述
你会拿到什么
一次调用，落盘 5 份可直接使用的交付物：
| 交付物 | 内容 |
|---|---|
00-知识卡片.yaml |
10–30 条语料知识点，标注出处与可商品化档位 |
01-匹配矩阵.md |
知识点 × 商品匹配打分，只推进 A 级以上 Top 3 |
02-标题与卖点.md |
商品标题 + 主图五图卖点 + 分层搜索词 |
03-详情页文案.md |
详情页八屏骨架 |
04-合规报告.md / 05-合规改写版.md |
广告法违禁词扫描结果与改写稿 |
效果预览
输入：「用叶桂的温病润燥思路，给一款秋梨膏做选品和文案」
01-匹配矩阵.md（节选）
| 商品 | 匹配度 | 知识点支撑 | 档位 |
|---|---|---|---|
| 秋梨膏便携装 | 0.87 | 温病润燥 · 时令调养 | A |
| 银耳羹速食杯 | 0.76 | 润燥生津 · 日常饮膳 | A |
| 百合干炖品料 | 0.62 | 润肺和胃 · 时令食材 | B（备选） |
02-标题与卖点.md（节选）
> 标题：秋梨膏便携装 20 条 · 独立条装 · 兑水即饮
> 主图卖点：① 独立条装一次一条 ② 兑水即饮 ③ 配料表干净 ④ 通勤随身带 ⑤ 20 天量
> 分层搜索词：秋梨膏 / 便携润燥饮 / 独立条装冲饮 / 秋冬日常饮
04-合规报告.md（节选）
| 命中 | 等级 | 原表述 | 建议改写 |
|---|---|---|---|
| 治疗 | BLOCK | 止咳立竿见影 | 日常饮用，顺应时令 |
| 功效承诺 | WARN | 喝三天就好 | 删除时间承诺 |
改写后脚本退出码回到 0，才当作成品交付。
计费说明
本技能是 SkillHub Pay Skill，采用支付宝 AI 按量付费：¥0.50 / 次，每次成功调用计费一次。
未付费时服务端返回 HTTP 402 Payment Required 账单（Payment-Needed 响应头），付费后携带
Payment-Proof 请求头重试；服务端验付通过才执行业务逻辑，完成后返回履约确认（ack）。
走 probe → pay → complete → ack 四阶段，订单按 payment-order-id 与 Idempotency-Key 幂等
去重，同一凭证 24h 内仅生效一次，不会重复扣款、不会重复履约。
- 支付依赖：Python
alipay-sdk-python、cryptography、requests（见requirements.txt） - 协议细则、错误码表、端点与命令行见
references/payment-protocol.md -
- 付费改造关键词锚点：支付宝 AI 按量付费 / 按量付费 / 402 / 402 Payment Required / Payment-Needed / Payment-Proof / Idempotency-Key / payment-order-id / pay-url / probe / pay / complete / ack / 验付 / 履约确认 / 幂等 / 支付依赖 / alipay-sdk-python / cryptography / requests / Pay Skill / 付费改造 / 升级为 Pay Skill
运行前置：定位脚本路径
下文命令中的 <SKILL_DIR> 指本 skill 的安装目录，不要硬编码任何用户目录（不同机器路径不同）。
执行前先定位：
Glob: **/yegui-ecommerce/scripts/compliance_check.py
命中结果的父目录即 <SKILL_DIR>。命令一律写成单行：PowerShell 的续行符是反引号，
反斜杠续行在 PowerShell 下会直接失败。Windows 用 python，macOS/Linux 用 python3。
流水线（前置闸口 + 五阶段）
阶段顺序不可跳。每一阶段的产物都必须落盘，供下一阶段消费。
阶段 0 · 付费闸口（Pay Skill 必过）
付费门控（必经，Pay Skill 硬要求）：阶段 1–5 的任何产出动作之前，必须先跑付费闸口。
未付费一律返回 402 账单（Payment-Needed），不执行任何业务逻辑。
python <SKILL_DIR>/scripts/payment_gate.py probe
- 退出码
0→ 已完成complete并取得ack回执，继续阶段 1 - 退出码
3→ 已输出 402 Payment-Needed 账单（含payment-order-id与pay-url），
暂停执行，引导用户完成支付宝 pay；平台下发 Payment-Proof 后执行
payment_gate.py ack --proof <凭证>进入 complete + ack，退出码回到 0 再继续 - 退出码
4→PROOF_INVALID，凭证无效或已被使用，需重新 pay 获取新凭证 - Agent 不得绕过付费直接产出。创作者本地自用时可设
SKILLPAY_BYPASS=1跳过闸口
阶段 1 · 知识提取
读 references/corpus-extraction.md，按其中的检索流程操作：
- Glob 定位
**/yegui-corpus/references/INDEX.md - Grep 关键词定位分块，一次最多读 3 个分块
- 抽取成知识卡片（schema 见该文档），标注出处与
commercializable档位 - 命中
forbidden的条目直接丢弃，并在交付物里列出丢弃理由
产出：00-知识卡片.yaml（10-30 条，按档位分组统计）
语料库不可用时的降级路径（未安装叶桂专家包的机器上必然发生，按序尝试）：
- 明确告知用户「未检测到叶桂语料库」，并说明可到专家中心安装叶桂专家
- 请用户提供自有中医资料（PDF / 文档 / 文本），按同一套知识卡片 schema 抽取，
source记为该资料 - 用户无资料时，降级为通用温病与润燥知识，卡片
source一律标注「未经语料库取证」，
并在交付物顶部显著说明——不得用通用知识冒充语料检索结果
阶段 2 · 商品匹配
读 references/product-matching.md，获取平台公开商品：
- 用 WebSearch 按「品类词 + 人群词 + 场景词」找候选；需要精确字段时用 agent-browser skill 抓商品页
- 按字段规范整理成 JSON（务必填
desc，否则人群场景维度趋近 0） - 跑打分脚本
python3 <SKILL_DIR>/scripts/score_match.py match.json --out 01-匹配矩阵.md --min-grade A --top 3
Windows 示例（python 不在 PATH 时用完整路径）：
C:\Users\<你的用户名>\.workbuddy\binaries\python\versions\3.13.12\python.exe <SKILL_DIR>\scripts\score_match.py match.json --out 01-匹配矩阵.md --min-grade A --top 3
产出：01-匹配矩阵.md + match.scored.json。只推进 A 及以上；B 级进备选池。
阶段 3 · 文案生成
读 references/copywriting-playbook.md，按模板产出：
- 标题（符合平台字数限制）
- 主图五图卖点
- 详情页八屏骨架
- 分层搜索关键词
中医术语一律按对照表改写成中性表达——「对身体做了什么」改成「是什么、怎么用、什么感觉」。
产出：02-标题与卖点.md、03-详情页文案.md
阶段 4 · 合规自检（强制）
先判定商品类目（general / health_food / device / book），再跑脚本：
python3 <SKILL_DIR>/scripts/compliance_check.py 03-详情页文案.md --category general --out 04-合规报告.md --rewrite 05-合规改写版.md
Windows 示例：
C:\Users\<你的用户名>\.workbuddy\binaries\python\versions\3.13.12\python.exe <SKILL_DIR>\scripts\compliance_check.py 03-详情页文案.md --category general --out 04-合规报告.md --rewrite 05-合规改写版.md
退出码 1 表示存在 BLOCK 级表述，必须处理到退出码为 0 才算完成。改写产物是草稿，需人工复核语义通顺性。
产出：04-合规报告.md、05-合规改写版.md
阶段 5 · 人工复核清单
脚本只做文本匹配。按 references/compliance-playbook.md 第 5 节，人工过一遍图片内文字、谐音变体、暗示性表述、评论区和客服话术、直播口播、第三方改写版本。
硬性规则
- 不治病：不得出现疾病名称、治疗、治愈、功效承诺，指向本商品
- 不背书：不得以叶桂或任何医师名义做推荐、认证、同款、配方背书；不得用患者见证
- 不越界：不得出现用法用量、疗程、处方；不碰需资质品类（保健食品、医疗器械、药品）
- 先检索再输出：中医内容必须先在语料库中取证并标出处，禁止凭记忆编造「叶桂说过」
- 不伪造数据：商品价格、销量、评分获取不到就写「未获取」，不得估算填充
- 合规不过不交付：阶段 4 退出码非 0 时，交付物必须附带风险说明，不得当作成品给出
资源索引
| 文件 | 用途 | 何时读 |
|---|---|---|
references/corpus-extraction.md |
语料定位、检索流程、知识卡片 schema、可商品化四档判定 | 阶段 1 |
references/product-matching.md |
商品获取路径、字段规范、打分口径、平台差异 | 阶段 2 |
references/copywriting-playbook.md |
标题/主图/详情页模板、中医术语改写对照表 | 阶段 3 |
references/payment-protocol.md |
付费协议细则：402 字段表、probe→pay→complete→ack、错误码、真实端点与命令 | 阶段 0 / 排障 |
references/compliance-playbook.md |
类目判定、脚本用法、人工复核清单 | 阶段 4-5 |
scripts/compliance_check.py |
合规自检与一键改写 | 阶段 4 |
scripts/compliance_lexicon.json |
违禁词库（282 词条，10 类） | 需增改词条时 |
scripts/score_match.py |
知识点 × 商品匹配打分 | 阶段 2 |
scripts/payment_gate.py |
支付宝按量付费网关：402 账单下发 / Payment-Proof 验付 / 履约 ack / 订单持久化与幂等 | 阶段 0 |
requirements.txt |
支付依赖包清单（alipay-sdk-python、cryptography、requests） | 接生产验付时 |
README.md |
用途、依赖、快速上手与限制说明 | 首次使用时 |
典型触发语
- 「从叶桂语料里提取关于秋冬养护的知识点，找匹配的电商商品」
- 「这个养生品帮我写标题和详情页，要能过广告法」
- 「检查这份商品文案有没有违规表述，给我合规版」
- 「叶桂讲的某某食材，能不能做成选品，给个方案」
目标平台
本 skill 面向中国电商生态：淘宝/天猫、京东、拼多多、抖音电商、小红书。合规判定依据《广告法》《食品安全法》《化妆品监督管理条例》《药品管理法》《电子商务法》及平台类目规则。
安全与合规说明
脚本行为边界：compliance_check.py 与 score_match.py 只读取用户显式指定的输入文件、写出用户显式指定的输出文件；
不访问网络、不调用外部命令、不删除或移动任何文件、不读取指定范围以外的路径。
词库通过脚本自身的 __file__ 相对定位，不依赖任何绝对路径。
payment_gate.py 只读写订单状态文件 .pay_cache/state.json（默认在当前工作目录下，可用
PAY_CACHE_DIR 覆盖），记录 payment-order-id 与状态机流水。仅当配置了 PAY_VERIFY_URL 时才发起
网络请求，且只向该地址提交 Payment-Proof、payment-order-id 与 service_id；不读取、不上传任何业务数据。
应用私钥只存服务端环境变量，包内不含任何密钥。
唯一的例外：score_match.py 除 --out 指定的文件外，还会在输入文件同目录生成 <输入名>.scored.json
（结构化打分结果，供阶段 3 消费）。这是预期行为，如需避免请把输入文件放在专用目录。
医学免责：本 skill 产出的是电商商品文案，不构成诊疗建议。涉及疾病、处方、剂量的内容已按 forbidden 档过滤，
不得作为健康指导使用。使用者仍需自行完成法务审核。
数据时效：商品信息来自平台公开页面，价格与销量为抓取时快照，上架或投放前必须复核。
本医家专属触发语
- 「叶桂知识提取」相关：叶桂温病与润燥知识提取、选品与文案
- 「叶天士选品」相关：叶桂温病与润燥知识提取、选品与文案
- 「温病学派文案」相关：叶桂温病与润燥知识提取、选品与文案
- 「花草茶合规」相关：叶桂温病与润燥知识提取、选品与文案
