Windows 下必须使用 Python 脚本调用(curl 中文参数会乱码):
# Windows - 使用 cmd /c 包裹完整命令(关键!)
cmd /c "python \"%USERPROFILE%\.workbuddy\skills\shengridnagao\scripts\dgss.py\" <命令> '<JSON参数>'"
# 示例
cmd /c "python \"%USERPROFILE%\.workbuddy\skills\shengridnagao\scripts\dgss.py\" getAddrList '{\"user_token\":\"TOKEN\",\"city_name\":\"北京市\"}'"
Linux/Mac 下可直接使用:
python "~/.workbuddy/skills/shengridnagao/scripts/dgss.py" <命令> '<JSON参数>'
https://www.dangaoss.com/dsapi/workbuddy/mcp_server
params.arguments 嵌套结构
code: 200
result.content[0].text → 内层业务 JSON({code, data, msg})
⚠️ 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\shengridnagao\scripts\dgss.py\" getAddrList '{\"user_token\":\"TOKEN\",\"city_name\":\"北京市\"}'"
Linux/Mac 调用:
python "~/.workbuddy/skills/shengridnagao/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_aid
addAddrList 添加
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\shengridnagao\scripts\dgss.py\" addAddrList '{\"user_token\":\"TOKEN\",\"province\":\"北京市\",\"city\":\"北京市\",\"area\":\"海淀区\",\"addr\":\"详细地址\",\"name\":\"姓名\",\"phone\":\"手机号\"}'"
Linux/Mac 调用:
python "~/.workbuddy/skills/shengridnagao/scripts/dgss.py" addAddrList '{"user_token":"TOKEN","province":"北京市","city":"北京市","area":"海淀区","addr":"详细地址","name":"姓名","phone":"手机号"}'
> 添加成功后,取 data[0].id 作为 aid 使用。
⚠️ 本技能只支持订购蛋糕,如果用户想购买零食、鲜花等其他商品,直接返回提示:
> "抱歉,只支持订购蛋糕哦~ 零食、鲜花等其他商品暂不支持"
分类编号:本技能只支持 cat_id = 1(蛋糕)
询问文案:
> "您想购买什么蛋糕?"
调用 cake_sweets_lst 搜索商品:
参数:
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| user_token | string | 是 | 用户 token |
| aid | string/int | 是 | 地址 ID(从步骤3获取的 id) |
| keyword | string | 是 | 搜索关键词 |
| page | int | 否 | 页码,默认 1 |
Windows 调用(使用 cmd /c 包裹):
cmd /c "python \"%USERPROFILE%\.workbuddy\skills\shengridnagao\scripts\dgss.py\" cake_sweets_lst '{\"user_token\":\"TOKEN\",\"aid\":\"10806796\",\"keyword\":\"巧克力\",\"page\":1}'"
Linux/Mac 调用:
python "~/.workbuddy/skills/shengridnagao/scripts/dgss.py" cake_sweets_lst '{"user_token":"TOKEN","aid":"10806796","keyword":"巧克力","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 | 味多美 | 缤纷盛果蛋糕 | 巧克力味蛋糕杂果夹心 15cm | ¥198 | 查看详情 |
> | 2 | 可露朵 | 正蓝旗焦糖烤奶皮子蛋糕 | 4英寸 / 1-3人食 | ¥178 | 查看详情 |
⚠️ 规格校验(必须执行):
生成下单链接前,必须校验 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\shengridnagao\scripts\dgss.py\" getOrderaddr '{\"user_token\":\"TOKEN\",\"aid\":\"10806796\",\"spec_id\":1,\"city_name\":\"北京市\",\"quantitys\":1}'"
Linux/Mac 调用:
python "~/.workbuddy/skills/shengridnagao/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 | 味多美 | 缤纷盛果蛋糕 | 巧克力味蛋糕杂果夹心 15cm | ¥198 | 查看详情 |
序号:从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\shengridnagao\scripts\dgss.py\" getOrderStatus '{\"user_token\":\"TOKEN\",\"scene\":\"3881514438313\"}'"
Linux/Mac 调用:
python "~/.workbuddy/skills/shengridnagao/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] ← 调用方式记忆
| 用户输入 | 规范后 |
|----------|--------|
| 北京 | 北京市 |
| 上海 | 上海市 |
| 深圳 | 深圳市 |
| 广州 | 广州市 |
| 张家口 | 张家口市 |
共 4 个版本