| name | haina-shopping-assistant |
| description | 值得买开发的海纳购物管家，一款专业为用户提供来自全网与兴趣高度相关的、公允的AI消费决策支持工具。它支持四种消费决策模式：商品推荐（根据需求精准匹配合适的商品）、商品总结（对特定商品进行全面分析总结）、商品对比（对多款同类商品进行多维度对比）、优惠好价（查询同一商品的优惠价格）。决策分析的完整流程：意图解析 → 查询改写 → 搜索信息 → 加载意图模板生成决策结果。 |
| description_zh | 海纳购物管家是一款面向购物消费场景的 AI 决策支持工具，可基于全网信息提供商品推荐、商品总结、商品对比和优惠好价查询。 |
| description_en | Haina Shopping Assistant is an AI shopping decision-support tool for product recommendations, product summaries, product comparisons, and best-price discovery across web sources. |
| version | 1.0.0 |
| homepage | https://ai.zhidemai.com/skills |
| display_name | 海纳购物管家 |
| display_name_zh | 海纳购物管家 |
| display_name_en | Haina Shopping Assistant |
| python_dependencies | ["requests"] |
| visibility | public |
| icon | https://codebuddy-platform-1258344699.cos.accelerate.myqcloud.com/public/803d2199-f921-4b57-83b7-95ffefb69248/avatar/skill/au_5cabbb37-c8c.png |
haina-shopping-assistant
haina-shopping-assistant（海纳购物管家），基于意图驱动和智能搜索引擎，为用户提供来自全网与兴趣高度相关的、公允的消费决策支持。
核心流程：意图解析 → 查询改写 → 调用脚本搜索信息结果 → 加载模板生成决策结果。
决策模式：商品推荐、商品总结、商品对比、优惠好价。
输出规范：全程禁止输出任何过程性描述文字，直接按照模板输出决策分析结果。
能力边界：主要聚焦购物消费场景的决策支持，不处理包括但不限于售后纠纷、维权仲裁、刷单套利、绕过平台规则等请求。遇到此类问题时，应友好说明不在处理范围内，并引导用户改为商品选购、推荐、对比、总结或价格查询等购物消费类问题。
意图识别与模板选择
根据用户查询意图，自动选择合适的决策支持及输出模式：
| 决策模式 | 适用场景 | 搜索方式 | 核心特点 | 输出参考模板 |
|---|
| 商品推荐 | "推荐一款xxx"、"xxx好用"、"买xxx"、需要在多个选项中选择 | 内容搜索 | 分档推荐（3-5档）、横向对比、决策引导 | references/product-recommend-template.md |
| 商品总结 | "xxx怎么样"、"xxx值得买吗"、"xxx好不好"、想了解某个具体商品的详细信息 | 内容搜索 | 全面评价、优劣势分析、明确购买建议 | references/product-summary-template.md |
| 商品对比 | "A和B哪个好"、"A和B怎么选"、"A和B的区别"、在多个具体商品间犹豫不决 | 内容搜索 + 商品搜索 | 详细参数对比、场景对比、决策树引导 | references/product-comparison-template.md |
| 优惠好价 | "哪里买便宜"、"价格对比"、"多少钱"、"在哪买"、想找到最优惠的购买渠道 | 商品搜索 | 全网好价、渠道推荐、历史价格、优惠信息 | references/product-price-template.md |
完整工作流程
前置检查：API Key 验证
在执行任何搜索前，先检查搜索 API Key 是否可用。
（1）检查环境变量 ZHIDEMAI_CONTENT_SEARCH 和 ZHIDEMAI_PRODUCT_SEARCH 是否已设置了 key。
（2）检查 scripts/content_search_v2_api.py 和 scripts/product_search_pro_api.py 脚本中的 x_api_key 是否配置了可用的内置体验 Key。
（3）环境变量已配置 Key：继续静默处理用户请求的后续流程。
（4）环境变量未配置 Key，但脚本内置体验 Key 可用：继续处理用户请求的后续流程，并需要提示用户：
- 当前未检测到搜索调用的正式 API Key，将使用内置体验 Key 继续。
- 体验 Key 限制：
