下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/bearhome--xiaozhi-recycle.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @bearhome/xiaozhi-recycle。- 小智回收提供的自助下单skill,通过和用户对话,了解用户需求,协助用户创建回收订单
- 支持家电、衣服、数码、图书等生活中常见品类的回收,微信授权后可通过小智回收小程序查看回收记录和回收进展
- 全品类回收还是看小智回收
阅读全文 (展开查看完整说明)
概述
Overview
通过小智回收开放平台 REST API 完成自助下单。支持两类订单:
- 设备品类(device):手机、电脑、家电等电子设备回收,固定价格 0.01 元
- 衣服品类(clothing):旧衣物回收,按重量计价,需先询价后下单
设备下单和衣服下单均需微信登录授权(jr_sso_token)。衣服询价接口无需授权,可直接调用。
触发场景
- 用户说「帮我提交一个回收订单」
- 用户提供设备/衣物信息要求「小智回收下单」
- 用户需要「获取回收报价并下单」
- 用户询问「怎么自助回收XX」
下单流程
Step 1: 判断品类并收集信息
首先询问用户要回收的是设备还是衣服。
A. 设备品类信息收集
| 字段 | 说明 | 示例 |
|---|---|---|
name | 联系人姓名 | 张三 |
mobile | 联系电话 | 13800138000 |
prov_name | 省份 | 北京 |
city_name | 城市 | 北京市 |
area_name | 区/县 | 朝阳区 |
address | 详细地址 | XX路XX号 |
item_brand | 设备品牌 | 华为 |
item_cates | 设备品类 | 手机 |
item_model | 设备型号 | Mate 60 Pro |
remark | 备注(可选) | 期望上门时间 YYYY-MM-DD |
以下字段使用默认值,无需向用户询问,也不在订单摘要中展示:
price: 固定0.01(不展示给用户)source: 固定172sale_item_name: 自动取item_cates的值
B. 衣服品类信息收集
| 字段 | 说明 | 示例 |
|---|---|---|
name | 联系人姓名 | 彭先生 |
mobile | 联系电话 | 15711111111 |
prov_name | 省份 | 北京 |
city_name | 城市 | 北京市 |
area_name | 区/县 | 朝阳区 |
address | 详细地址 | 北苑路北 |
item_weight | 衣服重量(kg) | 11 |
in_express_time | 期望上门时间 | 2026-06-16 16:00:00 |
detail | 订单备注(可选) | 无 |
以下字段使用默认值,无需向用户询问:
source: 固定172goods_type: 固定1category_id: 固定2767item_cates: 固定衣服item_name: 固定衣服in_express: 固定2
Step 2: 确认订单摘要
信息收集完成后向用户展示订单摘要,等用户确认。
Step 3: 衣服品类 — 询价
(仅衣服品类需要此步骤)
用户确认信息后,先调询价接口获取单价:
python3 scripts/create_order.py
--order-type clothing
--query-price-only
--prov-name "北京"
--city-name "北京市"
--area-name "朝阳区"将返回的单价展示给用户,确认总价(单价 × 重量),用户确认后进入下单步骤。
Step 4: 生成授权页面 + 微信扫码授权 + 自动下单
用户确认后,生成自带小程序码的 HTML 授权页面(适配网页聊天等各类终端):
python3 scripts/create_order.py --login-url-only --code-html输出 code_html 字段中包含 HTML 页面的本地路径。使用 preview_url 打开该页面,直接呈现给用户,页面内嵌小程序码图片,用户用微信扫码即可跳转小智回收小程序完成授权。
其他模式(向后兼容):
--login-url-only(无--code-html):生成小程序码图片文件--login-url-only --code-type qrcode:生成网页二维码链接
然后在前台执行轮询下单脚本(不要用后台/异步方式):
设备品类:
python3 scripts/create_order.py
--order-type device
--name "张三"
--mobile "13800138000"
--prov-name "北京"
--city-name "北京市"
--area-name "朝阳区"
--address "XX路XX号"
--item-brand "华为"
--item-cates "手机"
--item-model "Mate 60 Pro"
--send-code "<sendCode>"衣服品类:
python3 scripts/create_order.py
--order-type clothing
--name "彭先生"
--mobile "15711111111"
--prov-name "北京"
--city-name "北京市"
--area-name "朝阳区"
--address "北苑路北"
--item-weight 11
--item-price 0.60
--in-express-time "2026-06-16 16:00:00"
--send-code "<sendCode>"脚本会先提示用户扫码授权,然后实时输出轮询进度。用户扫码点击「允许」后,脚本立即提示「已收到您的确认授权,正在为您自动下单…」并提交订单,用户立刻看到下单成功的响应。无需用户再次输入任何指令。
行政编码说明
衣服品类下单需要 provId、cityId、areaId(国家标准 GB/T 2260 行政区划代码)。脚本内置了主要省市区映射,会自动根据名称解析。如果解析失败,可以使用 --prov-id、--city-id、--area-id 手动指定。
关键注意事项
- 信息收集完成后向用户展示订单摘要,确认后再提交
- 衣服品类需先询价,用户确认价格后再下单
- 微信扫码授权:默认生成 HTML 授权页面(
--login-url-only --code-html),内嵌小程序码,用preview_url展示即可适配所有终端 - sendCode 每次请求动态生成,不可重复使用
- 轮询超时(120s)后需重新生成 sendCode 发起授权
- 若返回「该询价信息已下单,请勿重复使用」,说明该询价对应的订单已存在,需要新的询价记录
Resources
scripts/create_order.py
下单核心脚本,可直接执行,也可被 import 使用。支持设备/衣服双品类、微信扫码授权、询价和下单。
references/api.md
API 接口参考文档,包含参数说明和请求示例。