⚠️ 本技能仅支持御蝶坊品牌蛋糕商品,绝对不可突破以下边界:
> 对不起,当前技能只支持订购御蝶坊相关商品哦~
> 对不起,当前技能只支持订购御蝶坊相关商品哦~
Windows 下必须使用 Python 脚本调用(curl 中文参数会乱码):
# Windows - 使用 cmd /c 包裹完整命令(关键!)
cmd /c "python \"%USERPROFILE%\.workbuddy\skills\yudiefang\scripts\dgss.py\" <命令> '<JSON参数>'"
# 示例
cmd /c "python \"%USERPROFILE%\.workbuddy\skills\yudiefang\scripts\dgss.py\" getAddrList '{\"user_token\":\"TOKEN\",\"city_name\":\"北京市\"}'"
Linux/Mac 下可直接使用:
python "~/.workbuddy/skills/yudiefang/scripts/dgss.py" <命令> '<JSON参数>'
https://www.dangaoss.com/dsapi/workbuddy/mcp_serverparams.arguments 嵌套结构code: 200result.content[0].text → 内层业务 JSON({code, data, msg})channel_no = brand_yudiefang(已在 dgss.py 中固定,无需手动传入)brand_id = 102345(已在 dgss.py 中固定,无需手动传入)⚠️ Token 安全存储:
dgss_token.md 文件中.gitignore,禁止提交到代码仓库⚠️ 重要:token 必须由当前用户主动提供,禁止复用其他用户的 token
获取 Token 提示:
御蝶坊已就位,请提供您的 USER_TOKEN 完成登录~
1. 打开浏览器,访问 https://www.dangaoss.com/web/wb_index.html
2. 登录你的蛋叔账号(或扫码登录)
3. 获取你的 Token 告诉我
获取成功后 → 立即更新 dgss_token.md:写入 user_token
首先检查 dgss_token.md:查看 default_city 和 default_aid 字段
询问城市:
> "您想把蛋糕送到哪个城市?"
用户回答后,将城市名称规范到"市"一级(如"北京"→"北京市")。
不接受省、区县、商圈等非标准城市名称,非法城市直接提示重新输入。
调用 getAddrList 获取该城市的已保存地址:
参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ------ | ------ | ------ | ------ |
user_token | string | 是 | 用户 token |
city_name | string | 是 | 城市名称(规范到"市"一级) |
Windows 调用(使用 cmd /c 包裹):
cmd /c "python "%USERPROFILE%\.workbuddy\skills\yudiefang\scripts\dgss.py" getAddrList '{\"user_token\":\"TOKEN\",\"city_name\":\"北京市\"}'"
Linux/Mac 调用:
python "~/.workbuddy/skills/yudiefang/scripts/dgss.py" getAddrList '{"user_token":"TOKEN","city_name":"北京市"}'
返回示例:
{"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"{\"code\":200,\"data\":[{\"id\":\"10806796\",\"name\":\"张三\",\"phone\":\"13800138000\",\"province\":\"北京市\",\"city\":\"北京市\",\"area\":\"海淀区\",\"addr\":\"嘉豪国际中心-C座\"}],\"msg\":\"获取成功\"}"}]}}
id(即 aid)>
> | 序号 | 姓名 | 手机尾号 | 地址 |
> | :---: | :---: | :---: | :--- |
> | 1 | 张三 | 8000 | 北京市海淀区嘉豪国际中心-C座 |
>
dgss_token.md:保存 default_city 和 default_aidaddAddrList 添加dgss_token.md:保存 default_city 和 default_aid添加新地址参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ------ | ------ | ------ | ------ |
user_token | string | 是 | 用户 token |
province | string | 是 | 省份(如"广东省") |
city | string | 是 | 城市(如"深圳市") |
area | string | 是 | 区县(注意:字段名是 area,不是 district) |
addr | string | 是 | 详细地址(注意:字段名是 addr,不是 detail) |
name | string | 是 | 收货人姓名 |
phone | string | 是 | 11位手机号(1[3-9]开头) |
Windows 调用(使用 cmd /c 包裹):
cmd /c "python "%USERPROFILE%\.workbuddy\skills\yudiefang\scripts\dgss.py" addAddrList '{\"user_token\":\"TOKEN\",\"province\":\"北京市\",\"city\":\"北京市\",\"area\":\"海淀区\",\"addr\":\"详细地址\",\"name\":\"姓名\",\"phone\":\"手机号\"}'"
Linux/Mac 调用:
python "~/.workbuddy/skills/yudiefang/scripts/dgss.py" addAddrList '{"user_token":"TOKEN","province":"北京市","city":"北京市","area":"海淀区","addr":"详细地址","name":"姓名","phone":"手机号"}'
> 添加成功后,取 data[0].id 作为 aid 使用。
⚠️ 本技能仅支持蛋糕类商品(cat_id 固定为 1)
询问文案:
> "您想买什么蛋糕?"
分类识别规则:
调用 brand_sweets_lst 搜索御蝶坊品牌蛋糕:
参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ------ | ------ | ------ | ------ |
user_token | string | 是 | 用户 token |
aid | string/int | 是 | 地址 ID(从步骤3获取的 id) |
keyword | string | 是 | 搜索关键词 |
cat_id | int | 是 | 固定为 1(蛋糕) |
brand_id | int | 是 | 固定为 102345(御蝶坊,已在脚本中硬编码) |
channel_no | string | 是 | 固定为 brand_yudiefang(已在脚本中硬编码) |
page | int | 否 | 页码,默认 1 |
Windows 调用(使用 cmd /c 包裹):
cmd /c "python "%USERPROFILE%\.workbuddy\skills\yudiefang\scripts\dgss.py" brand_sweets_lst '{\"user_token\":\"TOKEN\",\"aid\":\"10806796\",\"keyword\":\"巧克力\",\"cat_id\":1,\"page\":1}'"
Linux/Mac 调用:
python "~/.workbuddy/skills/yudiefang/scripts/dgss.py" brand_sweets_lst '{"user_token":"TOKEN","aid":"10806796","keyword":"巧克力","cat_id":1,"page":1}'
返回示例:
{"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"{\"code\":200,\"data\":[{\"品牌名称\":1,\"规格ID\":1,\"商品名称\":\"草莓奶油蛋糕\",\"规格价格\":19900,\"sku\":\"6寸\",\"规格描述\":\"2-3人吃\"}],\"msg\":\"获取成功\"}"}]}}
page + 1> | 序号 | 品牌 | 商品名称 | 规格 | 价格 | 详情 |
> | :---: | :---: | :---: | :--- | :---: | :---: |
> | 1 | 御蝶坊 | 草莓奶油蛋糕 | 6寸 / 2-3人食 | ¥199 | 查看详情 |
第一层:用户关键词搜索无结果
brand_sweets_lst,如果返回的 data 为空或无商品> 暂时没找到"{用户输入的关键词}"相关商品,不妨更换关键词试试,也可以为您推荐御蝶坊其他商品哦!
第二层:用户换关键词或同意推荐后,搜索"御蝶坊"也无结果
brand_sweets_lst 搜索> 当前地址没有可配送的商品,更换一个地址试试哦
⚠️ 规格校验(必须执行):
生成下单链接前,必须校验 spec_id 和 规格名称 是否一致:
规格ID 和 规格名称spec_id 与 规格名称 组合展示给用户确认数量获取:
quantitys: "1"quantitys: 用户说的数量调用 getOrderaddr 生成下单链接:
参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ------ | ------ | ------ | ------ |
user_token | string | 是 | 用户 token |
aid | string/int | 是 | 地址 ID |
spec_id | string/int | 是 | sku(仅支持单个) |
city_name | string | 是 | 城市名称 |
quantitys | string | 是 | 购买数量 |
Windows 调用(使用 cmd /c 包裹):
cmd /c "python "%USERPROFILE%\.workbuddy\skills\yudiefang\scripts\dgss.py" getOrderaddr '{\"user_token\":\"TOKEN\",\"aid\":\"10806796\",\"spec_id\":1,\"city_name\":\"北京市\",\"quantitys\":1}'"
Linux/Mac 调用:
python "~/.workbuddy/skills/yudiefang/scripts/dgss.py" getOrderaddr '{"user_token":"TOKEN","aid":"10806796","spec_id":1,"city_name":"北京市","quantitys":1}'
返回示例:
{"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"{\"code\":200,\"data\":\"https://www.dangaoss.com/web/wb_order.html?scene=112\",\"msg\":\"下单url获取成功\"}"}]}}
获取到下单链接后,按以下格式返回给用户:
✅ 订单已生成!
扫码支付:[立即支付](URL)
1. 打开微信扫上面的二维码
2. 选择[商品名称] ¥[价格]
3. 确认收货地址:[省市区+详细地址]
4. 完成支付
5. 💡 订单凭证:{scene值}(下次查询订单时直接发送此编码即可)
📦 订单摘要
| 项目 | 内容 |
|------|------|
| 收货人 | [{name}] [{phone}] |
| 商品 | [{商品名称}] [{规格}] |
| 价格 | ¥{价格} |
| 配送地址 | [{area}][{addr}] |
按钮实现:
data 字段返回的下单 URL订单标识提取:
data URL 中提取 scene 参数(如 https://www.dangaoss.com/web/wb_order.html?scene=112 → scene=112)scene= 后的值记忆更新:
dgss_token.md:写入 last_order_scene、last_order_goods、last_order_spec⚠️ 商品列表展示规则(最高优先级):
> | 序号 | 品牌 | 商品名称 | 规格 | 价格 | 详情 |
> | :---: | :---: | :---: | :--- | :---: | :---: |
> | 1 | 御蝶坊 | 草莓奶油蛋糕 | 6寸 / 2-3人食 | ¥199 | 查看详情 |
序号:从1开始的序号品牌:接口返回的"品牌名称"字段商品名称:接口返回的"商品名称"字段规格:接口返回的"规格名称"字段价格:接口返回的"规格价格"字段(格式:¥XXX)详情:接口返回的"商品详情"字段(格式:查看详情)⚠️ 订单查询规则:
getOrderStatus 接口查询dgss_token.md 中有多个订单记录,需询问用户查询哪个商品名称 和 订单状态,必须展示给用户订单查询流程:
dgss_token.md 获取:检查 last_order_scene 字段3881514438313 的纯数字串,识别为 scene 码,直接使用getOrderStatus 获取订单状态> scene 识别规则:当用户输入为纯数字(8-20位)且不在下单流程中时,自动识别为 scene 凭证
getOrderStatus 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ------ | ------ | ------ | ------ |
user_token | string | 是 | 用户 token |
scene | string | 是 | 订单 scene(从下单链接 scene=xxx 获取) |
返回示例:
{"code":200,"msg":"获取成功","data":{"scene":"3881514438313","status_name":"订单未支付"}}
查询结果展示格式:
| 项目 | 内容 |
|---|---|
| ------ | ------ |
| 商品 | {dgss_token.md 中的 last_order_goods} {dgss_token.md 中的 last_order_spec} |
| 订单状态 | {接口返回的 status_name} |
Windows 调用:
cmd /c "python "%USERPROFILE%\.workbuddy\skills\yudiefang\scripts\dgss.py" getOrderStatus '{\"user_token\":\"TOKEN\",\"scene\":\"3881514438313\"}'"
Linux/Mac 调用:
python "~/.workbuddy/skills/yudiefang/scripts/dgss.py" getOrderStatus '{"user_token":"TOKEN","scene":"3881514438313"}'
| 概念 | 正确字段名 | 错误写法 |
|---|---|---|
| ------ | ----------- | --------- |
| 区县 | area | ~~district~~ |
| 详细地址 | addr | ~~detail~~ |
| 地址 ID(搜索/下单) | aid | ~~addr_id~~ |
| 成功状态码 | 200 | ~~0~~ |
| 下单返回 URL | data(字符串) | ~~data.order_url~~ |
> 核心原则:用户只需要知道"下一步做什么",不需要知道"发生了什么"。
⚠️ 标准文案必须严格遵守:
绝对禁止输出的内容:
每次回复只允许包含:
错误时的标准回复格式(不超过2句话):
spec_id,不支持多规格叠加标准话术示例:
| 错误码 | 含义 | 友好提示 |
|---|---|---|
| -------- | ------ | --------- |
| 200 | 成功 | 正常返回数据 |
| 401 | 缺少规格 | "请选择商品规格" |
| 402 | 缺少配送地址 | "请选择或添加收货地址" |
| 403 | 规格不存在/已下架 | "该规格已下架,请重新选择" |
| 405 | 无法配送 | "该商品暂不支持配送到此区域" |
| 4013 | 缺少授权 | "授权信息异常,请重新登录获取 Token" |
| 4024 | 缺少城市 | "请输入配送城市,如:北京市" |
| 4026 | 城市未开通/参数缺失 | "该城市暂未开通配送" / 提示缺少的具体信息 |
目标:避免每次重复尝试 curl/python 等不同调用方式,首次成功后永久复用该方式。
每次执行命令前,按以下顺序检查:
dgss_exec_method 字段| 尝试顺序 | 方式 | 适用场景 | 成功后记录 |
|---|---|---|---|
| --------- | ------ | --------- | ----------- |
| 1 | curl 直接调用 | Linux/Mac 环境 | dgss_exec_method: curl |
| 2 | python dgss.py | Windows Python 可用 | dgss_exec_method: python |
| 3 | cmd /c "python dgss.py" | Windows 需 cmd 包裹 | dgss_exec_method: cmd_python |
| 用户指令 | 执行逻辑 |
|---|---|
| --------- | --------- |
| "再来一单" / "复购" / "再买一次" | 读取 dgss_token.md 中的订单信息,直接用默认地址下单相同商品 |
| "买XX(商品名)" | 如果有默认地址,跳过城市和地址选择,直接搜索商品 |
| "换地址" / "换城市" | 清除 dgss_token.md 中的 default_city 和 default_aid,重新询问 |
| "换token" / "换账号" | 请用户重新提供新的 token |
- **user_token**: [用户token]
- **default_city**: [默认城市,如"北京市"]
- **default_aid**: [默认地址ID]
- **last_order_scene**: [订单标识]
- **last_order_goods**: [商品名称]
- **last_order_spec**: [规格名称]
- **dgss_exec_method**: [curl / python / cmd_python] ← 调用方式记忆
| 用户输入 | 规范后 |
|---|---|
| ---------- | -------- |
| 北京 | 北京市 |
| 上海 | 上海市 |
| 深圳 | 深圳市 |
| 广州 | 广州市 |
| 张家口 | 张家口市 |
共 3 个版本