核心用法
本 Skill 对接 UU跑腿官方开放平台,提供完整的同城即时配送链路,涵盖询价→下单→支付→追踪→取消全流程。支持双运行时(Node.js/Python),Agent 自动检测环境并执行对应脚本。
关键操作路径:
1. 首次注册:手机号一键验证获取 openId,或直接使用开发者凭证(appId/appSecret/openId)
2. 订单询价:提供起止地址获取 priceToken 及预估费用(单位分→元需转换)
3. 创建订单:凭 priceToken 和收件人电话直接发单,余额不足时自动生成微信扫码支付二维码
4. 订单管理:支持查询详情、实时追踪骑手位置、取消未完成的订单
支付处理:余额不足时输出 [PAYMENT_REQUIRED],需以附件形式发送本地二维码图片(wechat_pay_qrcode.png),并附兜底在线链接供用户保存扫码。
显著优点
- 官方权威:直接对接 UU跑腿开放平台,服务覆盖全国主要城市,运力有保障
- 零门槛体验:支持手机号快速注册,无需预先申请开发者账号
- 双语言支持:Node.js 与 Python 脚本并行,适配不同 Agent 环境
- 支付兜底完善:本地二维码+在线链接双方案,确保用户可完成微信支付
- 状态全流程可视:从接单到送达,骑手位置实时可追踪
潜在缺点与局限性
- 地域限制:依赖 UU跑腿自有运力,覆盖城市有限,偏远地区可能无法服务
- 价格Token 时效性:询价后需尽快下单,过期需重新询价
- 支付链路依赖微信:仅支持微信支付,无支付宝等其他渠道
- 配置层级复杂:defaults.json、config.json、环境变量三层优先级,新手易混淆
- 重试机制限制:注册失败仅自动重试 3 次,超出需人工介入
适合人群
- 个人用户:同城急送文件、钥匙、药品等小件物品
- 中小商户:餐饮外卖、鲜花蛋糕、生鲜零售的即时配送需求
- 开发者/企业:需集成同城配送能力的应用或系统
常规风险
| 风险类型 | 说明 | 缓释措施 |
|---------|------|---------|
| 凭证泄露 | appId/appSecret 硬编码或环境变量暴露 | 优先使用环境变量,避免提交至版本控制 |
| 支付欺诈 | 二维码被截屏替换或中间人篡改 | 确认域名归属 `uupt.com`,核对订单金额 |
| 隐私泄露 | 手机号、地址等个人信息传输 | API 使用 HTTPS,本地配置注意文件权限 |
| 订单纠纷 | 配送超时、物品损坏等争议 | 保留订单编号,通过 UU跑腿官方客服处理 |
| 运力不足 | 高峰期无骑手接单 | 建议预留充足时间,或选择加价服务(如支持)|
总体评估:作为官方开放的配送能力接口,功能完整且流程闭环,适合对时效性要求高的同城配送场景。建议商户用户优先申请正式开发者账号以获得更稳定的服务保障。