uupt-delivery

核心用法

UU跑腿同城配送服务 Skill 为用户提供完整的即时物流解决方案，覆盖从询价到签收的全生命周期管理。核心能力包括：

• 订单询价：根据起始地址和目的地址计算配送费用，返回 priceToken 用于后续下单
• 快速下单：询价后可直接创建订单，无需二次确认，支持余额支付或在线支付（微信/支付宝）
• 订单管理：查询订单详情、取消未完成的订单
• 实时追踪：查看跑男（骑手）实时位置和预计送达时间

该 Skill 采用双运行时设计，同时提供 Node.js 和 Python 两种实现，Agent 会自动检测可用环境并选择合适的版本执行。认证方式灵活，支持开发者模式（自有凭证）和快速体验模式（手机号一键注册）。

显著优点

1. 接入门槛低：内置默认应用凭证，新用户可通过手机号验证码快速注册，无需申请开放平台账号
2. 渠道适配完善：针对微信渠道特殊处理，自动生成支付二维码图片；其他渠道直接输出支付链接
3. 自动化程度高：首次使用时自动检测认证状态，引导完成注册流程；余额不足时自动切换支付流程
4. 配置管理清晰：分层配置设计（环境变量 > config.json > defaults.json），兼顾安全性与便利性

潜在缺点与局限性

1. 地域覆盖限制：UU跑腿服务范围以中国大陆城市为主，偏远地区可能无法配送
2. 价格Token时效性：询价返回的 priceToken 存在有效期，超时需重新询价
3. 依赖外部服务：所有功能依赖 UU跑腿开放平台 API，网络波动或服务故障会影响可用性
4. 支付渠道限制：虽然支持微信/支付宝，但需用户主动完成支付，无法直接代扣
5. 测试环境受限：文档提及测试环境，但生产环境才是主要服务目标

适合人群

• 个人用户：需要同城急送文件、礼物、商品的普通消费者
• 小微商户：没有自建配送体系的本地商家，如鲜花店、蛋糕店、药店等
• 企业行政：需要频繁同城递送合同、票据、样品的办公场景
• 开发者：需要快速集成同城配送能力的应用开发者

常规风险

• 隐私泄露风险：配送订单包含收发货地址、手机号等敏感信息，需确保本地配置和日志安全
• 支付安全风险：支付链接和二维码需通过可信渠道传递，防止中间人篡改
• 服务可用性风险：依赖 UU跑腿平台服务稳定性，高峰期可能出现运力紧张
• 地址解析误差：自动解析的地址可能存在偏差，建议用户提供完整准确的地址信息
• 余额管理风险：账户余额不足时订单创建会中断，需及时关注支付状态

核心用法

本 Skill 是 UU 跑腿官方开放平台的 Agent 接入组件，提供完整的同城即时配送能力。用户可通过自然语言触发「询价→下单→支付→追踪」全流程：输入起止地址即可获取实时配送报价；确认发单后系统自动创建订单并处理支付环节；订单生成后支持实时查询跑男位置与配送进度。Skill 同时提供 Node.js 与 Python 双运行时支持，Agent 自动检测环境并选择适配版本执行。

首次使用提供两种认证路径：开发者可直接配置自有 appId/appSecret/openId；普通用户通过手机号一键注册，系统自动完成授权并持久化凭证。所有场景均通过 [REGISTRATION_REQUIRED] 等状态标记实现无感引导，无需用户记忆复杂指令。

显著优点

官方生态直连：直接对接 UU 跑腿生产级 API，非第三方爬虫方案，服务稳定性与数据准确性有保障。

双语言无缝适配：同时支持 Node.js 与 Python 运行时，覆盖主流 Agent 部署环境，零额外配置成本。

场景化交互设计：内置 6 大场景判断逻辑（询价/发单/查单/取消/追踪/注册），Agent 自动识别用户意图并执行对应流程，无需显式指令切换。

支付体验优化：针对微信生态特别适配——余额不足时自动生成支付二维码图片并通过 message 工具发送；其他渠道则输出支付链接，兼顾体验与合规。

容错与重试机制：短信验证码环节支持图片验证码自动识别与 3 次重试；注册失败无需重新输入手机号，从发送环节继续流程。

潜在缺点与局限性

地域覆盖限制：默认城市为郑州市，其他城市需显式指定 cityName，跨城配送不支持。

价格 Token 时效：询价返回的 priceToken 存在有效期，获取后需尽快发单，过期需重新询价。

硬编码凭证设计：快速体验模式依赖内置默认凭证，虽权限受限且符合产品定位，但存在被滥用的理论风险。

隐私数据暴露：注册流程需向第三方 IP 查询服务（httpbin.org、ipinfo.io 等）发送请求以获取公网 IP，存在间接隐私泄露可能。

配置文件明文存储：openId 等凭证以明文 JSON 存储于本地，多用户系统下存在被越权读取风险。

适合的目标群体

• 本地生活服务开发者：需为 O2O 平台、社区团购、即时零售等场景快速接入同城配送能力的团队。
• 中小企业运营者：无技术背景的门店商家，通过 Agent 对话即可完成日常发货、查单、催单操作。
• 智能客服场景：需自动化处理用户配送咨询、订单状态查询、异常订单取消等客服流程的企业。
• 个人高频用户：有固定同城寄送需求的个人用户，可通过 Agent 实现「一句话发单」。

使用风险说明

API 配额与速率限制：依赖 UU 跑腿开放平台配额，高频调用可能触发限流，建议实现请求频率控制与指数退避重试。

外部服务可用性：注册环节依赖第三方 IP 查询服务，若服务不可用将导致注册流程中断；建议生产环境配置本地 IP 获取备选方案。

支付链路安全：支付二维码与链接由 UU 跑腿官方生成，Skill 仅做透传，不涉及资金敏感信息处理；但仍需确保 config.json 不被未授权访问。

地址解析准确性：API 对地址字符串的解析依赖 UU 跑腿内部地理编码，极模糊地址可能导致定位偏差或询价失败。

运行时依赖管理：Node.js 需 axios，Python 需 requests，环境隔离不当可能引发依赖冲突。