ahang1598 UU跑腿 Skill
本 Skill 通过 uupt-open-cli 提供同城跑腿配送（帮送 / 帮取 / 帮买）和帮帮服务（陪诊、搬抬、代办等）。WorkBuddy 连接本 Connector 时会自动安装 CLI 并完成手机号授权；之后所有业务操作都用 Bash 调用 CLI。
调用方式
优先使用 PATH 中的命令；找不到时使用固定安装路径：
uupt-open-cli <command> [flags]
# macOS / Linux 回退路径
$HOME/.uupt-open-cli/uupt-open-cli <command> [flags]
# Windows 回退路径
%USERPROFILE%\.uupt-open-cli\uupt-open-cli.exe <command> [flags]
不要猜测参数。地址、电话、订单号必须来自用户或上一步命令的返回值。价格字段单位是分，展示给用户时除以 100 转为元。
场景判断
先判断用户要的是跑腿配送还是帮帮服务：
| 用户表达 | 类型 | 判断依据 |
|---|---|---|
| 从 A 送到 B、寄文件、取快递再送到家、帮买后送达 | 跑腿配送 send |
物品在两个地点之间传递 |
| 陪诊、搬抬、代排队、现场保洁、只去驿站代取不另送 | 帮帮服务 help |
在同一地点提供现场协助 |
- 配送：必须有不同的起点和终点，默认
--order-type="send" - 帮帮：起点与终点相同，必须
--order-type="help"，创建订单时必须--note
可用命令
1. 授权状态（一般不必手动执行）
连接器安装时 WorkBuddy 会执行 auth login。若业务命令输出 [REGISTRATION_REQUIRED]，再引导用户完成授权。
uupt-open-cli auth status
uupt-open-cli auth login
uupt-open-cli auth logout
| 命令 | 说明 | 成功特征 |
|---|---|---|
| auth status | 检查是否已授权 | 退出码 0，输出包含 Logged in as |
| auth login | 打开本地授权页，用户用手机号+短信完成登录 | 退出码 0，输出 Logged in as |
| auth logout | 清除本地 openId，幂等 | 退出码 0 |
兼容命令（聊天中补授权时也可用）：
uupt-open-cli register --mobile="13800138000"
uupt-open-cli register --mobile="13800138000" --sms-code="123456"
uupt-open-cli register --mobile="13800138000" --image-code="5678"
2. 询价 price
# 跑腿配送
uupt-open-cli price --from-address="郑州市金水区花园路1号" --to-address="郑州市二七区大学路100号" --city="郑州市"
# 帮帮服务（to-address 可省略，CLI 会自动使用 from-address）
uupt-open-cli price --from-address="郑州市金水区花园路1号" --order-type="help"
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| --from-address | string | 是 | 起点；帮帮时填写服务地点 |
| --to-address | string | 配送必填 | 终点；帮帮可省略 |
| --city | string | 否 | 城市名，需带「市」，默认 郑州市 |
| --order-type | string | 否 | send（默认）或 help |
返回（JSON）：body.priceToken、body.needPayMoney / body.totalMoney（分）、body.distance（米）。priceToken 有时效，拿到后尽快下单。
回复用户时展示元，并确认是否继续下单所需的电话（帮帮再确认具体事项）。
3. 下单 create
用户明确要发单时：先询价拿 priceToken，再立即创建订单，不要二次确认。
# 跑腿配送
uupt-open-cli create --price-token="TOKEN_FROM_PRICE" --receiver-phone="13800138000"
# 跑腿配送（帮买 / 易碎品建议带 note）
uupt-open-cli create --price-token="TOKEN_FROM_PRICE" --receiver-phone="13800138000" --note="瑞幸生椰拿铁热一杯，少糖"
# 帮帮服务（note 必填）
uupt-open-cli create --price-token="TOKEN_FROM_PRICE" --receiver-phone="13800138000" --note="郑州人民医院东院区陪诊，协助挂号缴费取药"
# 微信渠道需要支付二维码时
uupt-open-cli create --price-token="TOKEN_FROM_PRICE" --receiver-phone="13800138000" --channel="wechat"
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| --price-token | string | 是 | 询价返回的 token |
| --receiver-phone | string | 是 | 收件人 / 联系人手机号 |
| --note | string | 帮帮必填 | 物品说明或帮帮内容 |
| --channel | string | 否 | wechat 时生成支付二维码文件 |
成功：JSON 中含 body.orderCode。
余额不足：输出包含 [PAYMENT_REQUIRED]，并带：
ORDER_CODE=订单号PAYMENT_URL=支付链接（微信 / 支付宝）QRCODE_FILE=本地二维码路径（仅--channel="wechat"）
处理规则：
- 微信渠道：必须带
--channel="wechat"，把二维码图片发给用户，不要只发链接 - 其他渠道：直接发送
PAYMENT_URL - 用户确认已支付后，立刻执行
detail查询订单状态
4. 查询订单 detail
uupt-open-cli detail --order-code="UU123456789"
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| --order-code | string | 是 | 订单编号 |
返回 JSON：body.orderCode、body.state、body.orderPrice、body.fromAddress、body.toAddress、body.driverName、body.driverMobile。
订单状态：1 下单成功，3 已接单，4 已到达，5 已取件，6 送达中，10 已完成，11 已取消，20 异常。
5. 取消订单 cancel
uupt-open-cli cancel --order-code="UU123456789" --reason="地址填错了"
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| --order-code | string | 是 | 订单编号 |
| --reason | string | 否 | 取消原因 |
6. 跑男追踪 track
uupt-open-cli track --order-code="UU123456789"
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| --order-code | string | 是 | 订单编号 |
返回 JSON：跑男姓名 / 电话、经纬度、距离。向用户转述当前位置和联系方式，不要原样倾倒坐标。
7. 领取优惠券 coupon
uupt-open-cli coupon
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| --source | int | 否 | 领取来源（决定可领哪些券包），默认1，一般无需传入 |
用户要领券或询问优惠（「领券」「领优惠券」「有优惠券吗」「有什么优惠」「有什么活动」「参加活动」）时直接执行，无需额外信息；输出 [REGISTRATION_REQUIRED] 时先引导用户完成授权后重试。
返回字段（JSON body）：
| 字段 | 说明 |
|---|---|
newlyClaimed |
是否本次新领取：true-本次新领取；false-今天已领过（返回当日记录） |
couponList |
领取的优惠券列表，每项含 packageName（券包名称，可为空）、couponDetail（优惠券信息）、expireDate（过期时间 yyyy-MM-dd） |
thursdayJoinAble |
是否可参与淡定星期四活动 |
回复优先级：couponList 为空或 null → 场景 C；newlyClaimed=false → 场景 B；其他 → 场景 A。任意场景下 thursdayJoinAble=true 时追加场景 D。回复严格按以下话术模板输出，不得改动任何标点、空行、换行位置，不得输出触发条件或任何 JSON 字段名。
场景 A：领券成功（newlyClaimed=true 且 couponList 非空）
🎉 一键领券完成！本次共领取 N 张优惠券
| 券名称 | 优惠券信息 | 过期时间 |
|--------|---------|--------|
| [packageName] | [couponDetail] | [expireDate] |
可以在UU跑腿App优惠券列表查看所有券详情。
N = couponList 条数；表格按 couponList 逐行输出；packageName 为空时填「优惠券」。
场景 B：当日已领过券（newlyClaimed=false）
您今天已经领过UU跑腿的优惠券啦，这是今日领取的优惠详情：
| 券名称 | 优惠券信息 | 过期时间 |
|--------|---------|--------|
| [packageName] | [couponDetail] | [expireDate] |
有新的优惠我第一时间通知你 🔔
场景 C：无可领券（couponList 为空或 null）
当前UU跑腿暂无优惠券，有新券上线我第一时间通知你 🔔
场景 D：淡定星期四活动（thursdayJoinAble=true，附加在上述任意场景回复之后）
命令会输出 THURSDAY_QRCODE_URL（远程图片链接）和 THURSDAY_QRCODE_FILE（本地图片路径，随 CLI 内嵌，始终可用）。在上述场景话术之后追加以下内容，图片必须真实展示，不能只输出 URL/路径文本：
另外你还可以参与「淡定星期四」活动，下单1元起！用微信扫描下方二维码即可参与 👇
图片展示方式按当前平台能力选择：支持远程 Markdown 图片渲染的平台用 ；不渲染远程链接但有本地图片发送机制的平台直接发送 THURSDAY_QRCODE_FILE；两者都不可用时输出活动说明文字 + 可点击的 THURSDAY_QRCODE_URL 链接，引导用户微信自行打开。
输出标记
| 标记 | 含义 | 处理 |
|---|---|---|
[REGISTRATION_REQUIRED] |
尚未授权 | 引导用户完成 auth login 或 register |
[SMS_SENT] |
短信已发送 | 请用户回复验证码 |
[IMAGE_CAPTCHA_REQUIRED] |
需要图片验证码 | 从 IMAGE_DATA= 展示图片，带 --image-code 重试 |
[REGISTRATION_SUCCESS] |
授权成功 | 继续执行用户最初的请求 |
[REGISTRATION_FAILED] |
授权失败 | 从发送验证码步骤重试，最多 3 次 |
[PAYMENT_REQUIRED] |
余额不足 | 按渠道展示支付信息，支付后再 detail |
[COUPON_RESULT] |
领券结果 | 提取 NEWLY_CLAIMED=、COUPON_COUNT=，符合条件时还有 THURSDAY_JOIN_ABLE=true、THURSDAY_QRCODE_URL=、THURSDAY_QRCODE_FILE=，按 coupon 命令的场景话术模板回复 |
[OK] |
操作成功 | 告知用户结果 |
[ERROR] / [FATAL] |
失败 | 展示错误信息，不要编造成功 |
退出码：0 成功，1 一般错误，2 需要图片验证码。
认证说明
- 用户在 WorkBuddy 中点击连接后，系统执行
auth login，打开http://127.0.0.1:<port>/login - 用户在页面填写手机号、短信验证码（必要时还有图片验证码），CLI 将
openId持久化到$HOME/.uupt-open-cli/configs/config.json auth status读取该本地凭证；已授权输出Logged in as ...且退出码为 0，未授权退出码非 0auth logout只删除本地openId，不卸载 CLI；登出后需重新授权- 凭证跨 WorkBuddy 重启有效；过期或丢失后
status会变为未认证，用户再次连接即可 - 不要把
appSecret、完整openId展示给用户
注意事项
- 所有命令通过 CLI 执行，不要直接调用开放平台 HTTP API
- 地址越完整越准确，尽量精确到门牌号；未指定城市时默认郑州市
- 帮买请把商品、规格、缺货如何处理写进
--note - 鲜花、蛋糕等易碎品在
--note注明轻拿轻放 / 保温防震 - 帮帮
--note写清：地点、事项、时长或人数、特殊要求 - 查询结果以 CLI 打印的 JSON 为准，不要编造跑男位置或费用
- 领取优惠券需先完成授权；同一用户同一来源当天只能新领一次，重复领取返回当日记录（
newlyClaimed=false）；回复严格按场景话术模板输出；thursdayJoinAble=true时必须真实展示活动二维码图片
English summary
Use uupt-open-cli for UU same-city delivery (send) and on-site help (help). Price first to get priceToken, then create. Amounts are in cents. If stdout contains [PAYMENT_REQUIRED], send QRCODE_FILE for WeChat or PAYMENT_URL otherwise. Run coupon when the user asks to claim coupons; reply with the fixed scenario templates from [COUPON_RESULT], and show the Thursday activity QR image when THURSDAY_JOIN_ABLE=true. Auth is completed by auth login during connector connect; auth status prints Logged in as when signed in.