宠物达人（pet-master）

它解决什么

养宠人群的真实状态是「又爱又慌」：不知道怎么喂、狗乱叫猫乱尿、宠物生病不敢乱用药、新手接宠一脸懵。比价型工具帮不上忙——他们连"该买什么"都不知道。

宠物达人补上这个场景：用户说「猫怎么喂」「狗疫苗时间表」「新手养猫买什么」，skill 自动：
1. 识别物种（猫/狗/小宠/水族/鸟）+ 需求模块（14 选 1）
2. 给出该场景的科普/实操内容（AI 实时聚合，零服务器）
3. 末尾提供相关用品参考（淘宝/拼多多/唯品会）
4. 每款用品附 AI 实时聚合的真实测评（小红书/什么值得买/抖音等）

内容实用、用品参考高频：宠物用品复购率高（粮/猫砂/驱虫月月买）、客单适中，是天然高转化场景。

工作流（给运行此 skill 的 AI 代理）

第一步：解析用户意图

从自然语言提取 2 个字段：

> 信息不全时不要反复追问——用默认（猫 + 喂养）+ 合理推测，直接出结果。用户可在结果上微调。

第二步：回答内容模块（AI 生成，零服务器）

14 个需求模块的内容由运行本 skill 的 AI 基于宠物知识 + WebSearch 实时聚合生成（不写死大段知识，保证新鲜不过时）。各模块定位与边界见下方「14 模块导航」。

• 内容要实用、具体、可操作（如疫苗时间表列月龄、训练给分步法）。
• 医疗红线：「病情/症状」只做科普 + 预警 + 建议就医，绝不诊断、不开方、不替代兽医；涉及具体用药仅科普"需遵医嘱"。

训养知识优先源（AI 聚合内容时优先从这些可信源检索，均零登录公开可搜）：
- 专业科普：萌爪医生、猫研所、PetMD 中文搬运、兽医公众号 —— 病情/护理权威性
- 经验社区：小红书、知乎宠物话题、豆瓣宠物小组、贴吧 —— 训练/喂养实操经验
- 视频演示：B站、抖音宠物 UP 主 —— 训练分步演示、开箱
- 垂直平台百科：波奇宠物百科、E宠学院 —— 喂养/护理系统科普（与第四步测评源同源，内容 + 口碑双向可用）
- 权威指南：WSAVA / FECAVA 喂养指南中文版、品牌官方科普 —— 月龄/食量标准

第三步：调用推荐引擎（用品推荐）

内容回答后，调用脚本提供相关用品参考：

python scripts/pet_recommender.py --species 猫 --need 喂养 --budget 100
python scripts/pet_recommender.py --species 狗 --need 训练
python scripts/pet_recommender.py --query 猫砂盆 --budget 80   # 直接搜索模式

脚本输出已是结构化用品卡片（markdown），可直接呈现。呈现时补充开场白（如「给猫挑了6件喂养好物，都在预算内，点击查看详情」）+ 提醒链接来自官方合作渠道、价格与自行购买一致、不加价。

第四步：用品推荐 + 真实测评（🆕 核心要求）

商品卡片给出「买什么」，但用户还想要「靠不靠谱」。每款推荐用品，由运行本 skill 的 AI 在对话层用公开搜索实时聚合真实测评/口碑（与「礼物推荐官」同一机制），不依赖任何需登录/付费的测评 API：

• 对每张卡片的用品，用 WebSearch 检索真实测评/口碑。优先覆盖以下测评与灵感源（均零登录、公开可检索，绝不作成交入口）：
• 小红书 用品名 测评 site:xiaohongshu.com —— 真实买家用后感，最贴合宠物场景
• 什么值得买 用品名 测评 红黑榜 / 避坑 —— 好价+爆料+测评号
• 抖音 用品名 实测 / 翻车 site:douyin.com —— 短视频开箱与避坑
• 知乎 用品名 测评 / 推荐 site:zhihu.com —— 长文横向评测
• B站 用品名 测评 site:bilibili.com —— 宠物 UP 主开箱横评
• E宠商城 用品名 测评 / 评价 site:epet.com —— 宠物垂直电商，真实购买评价 + 专业选粮/选用品指南，内容最对口
• 波奇网 用品名 测评 / 晒单 site:boqii.com —— 宠物社区 + 电商，用户晒单与避坑多
• 其余：微博种草、电商问答等公开内容，按需补充
• ⚠️ 垂直电商边界（E宠 / 波奇 等本质是成交平台）：仅作口碑/测评参考聚合，绝不作为成交入口、绝不把其商品链接伪装成合作成交链接。本 skill 的商品来源为淘宝 / 拼多多 / 唯品会（带内嵌凭证、来源标识运营者），与垂直电商的测评引用严格区分。
• 在对应卡片下追加「📝 真实测评」块，每条标注来源平台与要点（如「小红书 @用户：豆腐猫砂结团快、无尘，但胖猫容易带出；性价比高」）。
• 边界：测评是第三方公开内容，仅供参照、不构成消费建议；大额支出建议用户自行甄别。绝不把测评链接伪装成合作成交链接。
• 零登录、多用户安全：纯公开搜索，不含任何开发者登录态 cookie，发布即忘。
• 若 WebSearch 不可用或某商品无测评，则跳过该卡片的测评块（优雅降级），不影响商品展示。

14 模块导航

A 组 · 日常必备（最高频，导航顶到最前）
- 喂养指南：月龄/品种/食量/禁忌/喂食频率 → 推荐用品：主粮/零食/营养品
- 日常护理：洗护/驱虫/疫苗时间表/刷牙剪甲 → 推荐用品：驱虫药/梳子/指甲剪/牙膏牙刷/猫砂
- 训练行为：定点/不乱叫/分离焦虑/猫抓家具 → 推荐用品：训犬器/嘴套/牵引绳/玩具/猫爬架
- 安全急救：误食/中毒/外伤/中暑/窒息 → 推荐用品：航空箱/定位项圈/湿巾

B 组 · 健康决策
- 病情参考：症状科普+预警+建议就医（不诊断不开方）→ 推荐用品：营养品/驱虫药（谨慎）
- 情绪识别：基于行为描述的逻辑推断+科普（非图像诊断）→ 推荐用品：玩具/猫爬架/窝垫
- 绝育决策：利弊/时机/术后护理 → 推荐用品：伊丽莎白圈/航空箱
- 老年关怀：老年病/安乐死/殡葬 → 推荐用品：老年粮/营养品/窝垫

C 组 · 生命周期 / 场景
- 新宠入门选购：品种选择/接宠清单/领养vs购买 → 推荐用品：首单大礼包（主粮/猫砂盆/牵引/航空箱/玩具/窝）
- 品种百科：性格/掉毛/运动量/适合人群（纯科普，不硬塞）
- 多宠家庭：猫狗混养/二胎引入 → 推荐用品：隔离笼/双食盆
- 出行寄养：托运/宠物友好/寄养 → 推荐用品：航空箱/牵引绳/定位项圈
- 费用保险：看病贵/医保科普 → 推荐用品：驱虫药/营养品（性价比预防）
- 丢失找回：芯片/项圈/寻回 → 推荐用品：定位项圈（芯片为线下医疗服务，仅告知渠道不售卖）

物种路由

所有模块按物种切换知识：猫 / 狗 / 小宠（兔·仓鼠·刺猬·龙猫）/ 水族（鱼·龟）/ 鸟。用品类目按物种取对应平台搜索词，取不到则跳过该类目（如「训犬器」仅狗适用、「猫砂」仅猫适用）。

来源与归属说明

• 淘宝：链接携带内嵌 TAOBAO_ADZONE_ID（PID），用户下单来源标识进运营者淘宝客账户
• 拼多多：链接携带内嵌 PDD_PID，用户下单来源标识进运营者多多进宝账户
• 唯品会：链接携带内嵌 VIP_USER_CODE+VIP_PID，用户下单来源标识进运营者唯品会联盟账户
• 加密架构与「礼物推荐官」「好物好价分享」完全一致：AES-256 + 三片段分散（_crypto.py / pet_engine.py / credentials.py），发布后归属关系不可篡改
• 用户购买价格与自行搜索完全一致，不加价

> 💡 参考闭环（为何不怕垂直电商分流）：波奇 / E宠 等垂直电商仅作「内容 + 口碑」参考被聚合进文字，不提供任何参考链接；用户要买仍点本 skill 的淘宝/拼多多/唯品会合作链接。且同类用品我们常能给出券后更低价，用户比价后反而更可能在我们的链接成交——故二者是互补而非分流，无需担心。

> 🆕 唯品会 = 内嵌商品来源（与淘宝/拼多多同机制）：补上品牌特卖场景。双路径自动切换：① 联盟 API 权限开通后 → 自动搜索+转链+归属归运营者；② API 权限未开通 → 自动降级为公开搜索页抓取，商品可展示、链接标注 📊非成交·待开通。嵌入前该源被自动跳过（不配置即不跑），绝不会把归属漏给第三方。

> ⚠️ 发布纪律：发布包必须已嵌入运营者凭证。在嵌入之前，该源会被调度层自动跳过（不配置即不跑），绝不会出现"归属漏给安装者"的情况。切勿在未嵌入凭证时发布。

> ⚠️ API 权限说明：唯品会联盟 API 需与平台完成商务对接后开通（联系 jill.zuo@vipshop.com 个人推手）。权限未开通时不影响使用：商品搜索自动降级为公开页抓取，链接标注 📊非成交；权限开通后自动切换为全自动搜索+合作转链。淘宝/拼多多不受任何影响。

合规前提（必须满足才能发布）

1. 病情/症状只做科普 + 预警 + 建议就医，绝不诊断、不开方、不替代兽医。涉及具体用药仅科普"需遵医嘱"，不荐处方药。
2. 情绪识别是逻辑推断 + 科普，非图像/医学诊断。
3. 仅作个人推荐使用，业余时间、个人用途；不得利用职务影响力推广。
4. 来源标识归运营者本人，凭证由运营者保管，不向使用者暴露。
5. 推荐结果仅供参考，不构成消费/医疗建议；大额支出建议用户自行甄别。
6. 芯片植入为线下医疗服务，skill 仅告知渠道，不售卖、不荐具体机构。

文件结构

pet-master/
├── SKILL.md
├── assets/logo.svg
├── references/
│   ├── setup_guide.md          安装/配置说明
│   └── pet_knowledge_taxonomy.md  物种×需求×用品类目完整映射表
└── scripts/
    ├── pet_engine.py           搜索聚合层（内嵌凭证注入 + 淘宝/PDD/唯品会 本地直连）
    ├── pet_recommender.py      推荐逻辑（物种→需求→类目→搜索→预算过滤）
    ├── _crypto.py              加密模块
    ├── credentials.py          加密后的内嵌凭证（可安全发布）
    ├── config.example.json     配置模板（无本地密钥板块）
    ├── verify_publish.py       发布前安全检查
    └── affiliate/
        ├── __init__.py
        ├── base.py             联盟源基类
        ├── taobao.py           淘宝客适配器
        ├── pdd.py              多多进宝适配器
        └── vipshop.py          唯品会联盟适配器

技术要点

• 零服务器零隧道：凭证本地解密直连平台 API，发布即忘
• 价格下限过滤：<¥15 的商品视为样品/垃圾，自动剔除（避免推荐 ¥1 假货）
• 预算弹性：允许单件上浮 40% 拿更好用品，否则退化为最便宜 3 条
• 相关性过滤：各适配器剔除与查询无关的兜底商品，保证类目准确
• 物种适配：按物种取对应平台搜索词，不适用类目自动跳过
• 优雅降级：某平台无结果时不影响其他平台，至少返回可用结果
• 唯品会双路径：API 权限开通前自动降级公开页抓取（标注 📊非成交），开通后自动切换为合作转链，不影响淘宝/拼多多
• 真实测评（AI 实时聚合）：运行 skill 的 AI 用 WebSearch 零登录公开搜索（小红书/什么值得买/抖音/知乎/B站/E宠商城/波奇网等）为每款用品补充真实测评，纯情报参考、绝不作成交入口；无测评时优雅跳过

🆕 v1.0.0 新增：宠物达人独立 skill

> 💡 测评与商品来源职责分离：淘宝/拼多多/唯品会负责「合作渠道」，AI 公开搜索负责「真实口碑参照」。不改任何归属模型。

🆕 v1.0.1 优化：用户可见措辞中性化