用途：本技能面向 Shopee（虾皮）店铺的套装优惠（Bundle Deal）管理，覆盖 Shopee Open Platform Bundle Deal 模块的 10 个 API，可用于创建套装优惠、添加或维护优惠商品、查询列表与详情、更新、结束和删除套装优惠及优惠内商品。
主要能力与脚本：提供 add_bundle_deal.py、add_bundle_deal_item.py、get_bundle_deal_list.py、get_bundle_deal.py、get_bundle_deal_item.py、update_bundle_deal.py、update_bundle_deal_item.py、end_bundle_deal.py、delete_bundle_deal.py、delete_bundle_deal_item.py，以及通用入口 bundle_deal_api.py。各接口的入参与响应细节见 references/apis/ 下对应文档，模块总览见 references/api.md。
使用方式：依赖 linkfox-shopee-store-auth 选店，先运行 python scripts/check_auth_dependency.py，exit code 42 表示需先安装该授权技能。调用走 API 端点 POST /shopee/developerProxy，传入 shopId（或 merchantId），由服务端解析 token 转发，path 须为 api/v2/bundle_deal/...。也可执行 python scripts/<脚本名>.py '<JSON 参数>' [--inline]，完整参数与错误码见 references/api.md。典型流程为 add_bundle_deal.py 传完整 body、add_bundle_deal_item.py 添加商品、get_bundle_deal_list.py 确认状态。
输出与成本：脚本始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-shopee-store-bundle-deal-<timestamp>.json，禁止写入 /tmp；响应体 ≤ 8 KB 时全量打印 stdout，> 8 KB 时仅输出摘要，加 --inline 可强制全量打印。读数据建议先用摘要判断，再用 jq 或 ConvertFrom-Json 按需抽取。资料称本技能不消耗算力，但仍提示本工具会消耗算力，且失败或空结果时不得自动换关键词、翻页或连续试探，需继续检索应先向用户说明会产生额外消耗。
限制与异常处理：未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402、提示算力或余额不足（如 insufficient balance、quota exceeded、套餐到期、需充值等）时，按 references/onboarding.md 处理。店铺授权、限时折扣、Add-On Deal、Voucher、商品 listing 分别由其他技能负责。