用途:处理 Shopee Open Platform Push 推送模块,共 4 个 API,经 POST /shopee/developerProxy 转发(path 须为 api/v2/push/...)。依赖 linkfox-shopee-store-auth 作为同系列前置。
主要能力:set_app_push_config(POST)配置 Push 回调;get_app_push_config(GET)查询配置;get_lost_push_message(GET)拉取丢失消息;confirm_consumed_lost_push_message(POST)确认已消费;另有 push_api.py 通用入口。
使用方式:API 端点 POST /shopee/developerProxy,不同操作通过请求体区分,完整参数、响应与错误码见 references/api.md。Python 脚本调用格式为 python scripts/<脚本名>.py '<JSON 参数>' [--inline]。运行前先执行 python scripts/check_auth_dependency.py,exit code 42 表示需先安装 linkfox-shopee-store-auth。
输出策略:完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill-name>-<timestamp>.json,禁止写入 /tmp;响应体 ≤8 KB 时落盘后全量打印,>8 KB 时仅输出摘要,--inline 可强制全量打印。建议先看摘要,再用 jq 或 ConvertFrom-Json 按需抽取字段。
适用场景:配置 Push 回调并确认配置;补推丢失消息并确认消费。
限制:用户侧授权流程、Public OAuth/Partner 查询、订单/商品等业务 API 不在本技能范围。成本约束:本工具会消耗算力,失败或空结果不得自动换关键词、翻页或连续试探,需继续检索时应先向用户说明额外消耗。未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402、提示算力或余额不足时,按 references/onboarding.md 处理。算力消耗规则:不消耗算力。