用途：处理 Shopee 跨境头程（First Mile）物流，覆盖头程运单的生成、绑定、解绑、面单获取，以及渠道与中转仓查询。依赖 linkfox-shopee-store-auth 完成选店，经 POST /shopee/developerProxy 传入 shopId（或 merchantId），由服务端解析 token 转发，path 须为 api/v2/first_mile/...。
主要能力（16 个 API，按分组）：绑定/解绑——get_unbind_order_list、generate_first_mile_tracking_number、bind_first_mile_tracking_number、generate_and_bind_first_mile_tracking_number、unbind_first_mile_tracking_number；运单/面单——get_tracking_number_list、get_waybill、get_detail；渠道/仓库——get_channel_list、get_transit_warehouse_list、get_courier_delivery_channel_list；快递头程——bind_courier_delivery_first_mile_tracking_number、get_courier_delivery_detail、get_courier_delivery_waybill 等；通用入口 first_mile_api.py。
使用方式：API 端点 POST /shopee/developerProxy，不同操作通过请求体区分，完整参数、响应与错误码见 references/api.md。Python 脚本调用示例：python scripts/first_mile_api.py '{"api": "get_unbind_order_list", ...}' [--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 从文件按需抽取字段。
限制：本工具会消耗算力，失败或空结果不得自动换关键词、翻页或连续试探，需继续检索应先向用户说明额外消耗。未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402、提示算力或余额不足时，按 references/onboarding.md 处理。本技能不适用于店铺授权、正向物流发货、SBS 仓储库存与订单查询，分别对应其他技能。头程与正向物流区分：本技能为跨境头程，店铺发货与面单见 linkfox-shopee-store-logistics。算力消耗规则：不消耗算力。