（4031期）Shopee-店铺推送 – Shopee 推送配置与补推一站式管理

Shopee 推送配置与补推一站式管理 LinkFox 官方出品的 Shopee Open API Push 模块封装，支持回调配置、丢失消息补推，零积分消耗，专为跨境电商开发者设计。 使用说明 核心用法 本技能是 LinkFox 官方推出的 Shopee 开放平台 Push 推送机制封装工具，完整覆盖 Shopee Push 模块 4 个核心 API：setapppushconfig（配置回调）、getapppushconfig（查询配置）、getlostpushmessage（获取丢失消息）、confirmconsumedlostpush_message（确认已消费）。作为 linkfox-shopee-store-auth 的同系列后置技能，需先完成店铺授权后方可使用。 调用方式灵活多样：支持通过 POST /shopee/developerProxy 直接转发 API 请求，或调用 5 个预置 Python 脚本（含通用入口 push_api.py）。输出策略智能分层：响应体 ≤8KB 时完整打印，>8KB 时自动输出摘要（含顶层字段、计数及前3条样本），并强制落盘至工作目录的 linkfox/<日期>/<session>/data/ 路径下，便于后续用 jq 等工具按需抽取。 显著优点 官方生态深度集成：由 LinkFox 官方维护，与 Shopee Open Platform 原生 API 保持同步，接口路径、参数规范、错误码体系完全一致，降低学习成本。 零成本运营：明确标注"不消耗积分"，对于高频调用的推送配置场景极具成本优势，区别于 LinkFox 其他按次计费的技能。 工程化设计完善：内置 session 聚合、智能摘要、强制落盘机制，避免大响应体污染上下文；--inline 参数满足调试时的全量输出需求；异常处理文档（references/onboarding.md）覆盖 401/402、积分不足等常见场景。 补推机制闭环：独特的丢失消息管理双接口设计，支持先查询后确认的消费闭环，保障消息可靠性，适用于对数据一致性要求高的订单状态同步场景。 潜在缺点与局限性 强依赖前置技能：必须先安装 linkfox-shopee-store-auth 完成店铺 OAuth 授权，独立运行会失败（exit code 42），增加了部署复杂度。 无内置持久化：消息落盘仅为文件级临时存储，需用户自行接入数据库或消息队列做长期归档，不适合生产环境直接使用。 Shopee 平台绑定：仅支持 Shopee 生态，无法迁移至 Lazada、TikTok Shop 等其他跨境电商平台，技术栈锁定风险较高。 调试门槛存在：虽然提供摘要模式，但理解 Shopee Push 的回调签名验证、消息去重逻辑仍需阅读官方英文文档，新手上手周期较长。 适合的目标群体 跨境电商 SaaS 开发者：需为 Shopee 卖家搭建 ERP、WMS 等系统，实现订单状态实时同步 平台运营工具开发者：构建多店铺管理工具，需要集中配置 webhook 接收 Shopee 事件推送 数据集成工程师：负责 Shopee 店铺与内部 BI 系统的数据管道搭建，需处理消息丢失补偿场景 已有 LinkFox 授权体系的存量用户：同系列技能无缝衔接，生态内迁移成本低 使用风险 认证失效风险：Shopee OAuth token 存在有效期，授权过期后所有 Push 接口返回 401，需依赖 linkfox-shopee-store-auth 刷新机制，存在服务中断窗口。 回调 URL 安全风险：setapppush_config 配置的 webhook 端点若未做签名验证，可能遭受伪造推送攻击；建议生产环境强制校验 Shopee 回调签名。 消息堆积风险：高并发店铺场景下，丢失消息队列可能积压，getlostpush_message 未消费确认前会重复返回，需设计幂等处理逻辑。 路径写入权限：强制落盘依赖当前工作目录可写，容器化部署时若未挂载持久卷会导致报错，需注意 cwd 权限配置。 API 版本跟随风险：当前为 v2 版本，Shopee 官方 API 升级时可能存在 breaking change，需关注 LinkFox 官方的 skill 更新通知。 原始说明 Shopee（虾皮）Push 推送机制（与 linkfox-shopee-store-auth 同系列），经 /shopee/developerProxy 转发 Shopee Open API Push 模块全部 4 个接口：set_app_push_config、get_app_push_config、get_lost_push_message、confirm_consumed_lost_push_message。当用户提到 Shopee Push、推送回调、Push Mechanism、set_app_push_config、丢失推送补推、webhook 配置 时触发。即使未明确提及"Push"，只要涉及 Shopee 开放平台 Push 配置或补推消息管理，也应触发。