Windows 下必须使用 Python 脚本调用（curl 中文参数会乱码）：
# Windows - 使用 cmd /c 包裹完整命令（关键！）
cmd /c "python \"%USERPROFILE%\.workbuddy\skills\kesibeili\scripts\dgss.py\" <命令> '<JSON参数>'"
# 示例
cmd /c "python \"%USERPROFILE%\.workbuddy\skills\kesibeili\scripts\dgss.py\" getAddrList '{\"user_token\":\"TOKEN\",\"city_name\":\"北京市\"}'"
Linux/Mac 下可直接使用：
python "~/.workbuddy/skills/kesibeili/scripts/dgss.py" <命令> '<JSON参数>'
brand_kesibeili
102789（固定参数）
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，禁止提交到代码仓库
此技能仅支持可斯贝莉(Kesibeili)品牌商品订购。
当用户要求订购非可斯贝莉商品时，标准回复：
> "抱歉，只支持订购可斯贝莉相关商品哦~"
此技能仅支持蛋糕品类订购。
⚠️ 重要：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 | 是 | 城市名称（规范到"市"一级） |
| channel_no | string | 是 | 固定值：brand_kesibeili |
Windows 调用（使用 cmd /c 包裹）：
cmd /c "python \"%USERPROFILE%\.workbuddy\skills\kesibeili\scripts\dgss.py\" getAddrList '{\"user_token\":\"TOKEN\",\"city_name\":\"北京市\"}'"
Linux/Mac 调用：
python "~/.workbuddy/skills/kesibeili/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]开头） |
| channel_no | string | 是 | 固定值：brand_kesibeili |
Windows 调用（使用 cmd /c 包裹）：
cmd /c "python \"%USERPROFILE%\.workbuddy\skills\kesibeili\scripts\dgss.py\" addAddrList '{\"user_token\":\"TOKEN\",\"province\":\"北京市\",\"city\":\"北京市\",\"area\":\"海淀区\",\"addr\":\"详细地址\",\"name\":\"姓名\",\"phone\":\"手机号\"}'"
Linux/Mac 调用：
python "~/.workbuddy/skills/kesibeili/scripts/dgss.py" addAddrList '{"user_token":"TOKEN","province":"北京市","city":"北京市","area":"海淀区","addr":"详细地址","name":"姓名","phone":"手机号"}'
> 添加成功后，取 data[0].id 作为 aid 使用。
⚠️ 品类限制：此技能只支持蛋糕订购
询问文案：
> "您想购买什么口味的蛋糕？"
调用 brand_sweets_lst 搜索可斯贝莉品牌蛋糕：
参数：
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| user_token | string | 是 | 用户 token |
| aid | string/int | 是 | 地址 ID（从步骤3获取的 id） |
| keyword | string | 是 | 搜索关键词 |
| channel_no | string | 是 | 固定值：brand_kesibeili |
| brand_id | string | 是 | 固定值：102789 |
| page | int | 否 | 页码，默认 1 |
Windows 调用（使用 cmd /c 包裹）：
cmd /c "python \"%USERPROFILE%\.workbuddy\skills\kesibeili\scripts\dgss.py\" brand_sweets_lst '{\"user_token\":\"TOKEN\",\"aid\":\"10806796\",\"keyword\":\"巧克力\",\"page\":1}'"
Linux/Mac 调用：
python "~/.workbuddy/skills/kesibeili/scripts/dgss.py" brand_sweets_lst '{"user_token":"TOKEN","aid":"10806796","keyword":"巧克力","page":1}'
返回示例：
{"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"{\"code\":200,\"data\":[{\"品牌名称\":\"可斯贝莉\",\"规格ID\":1,\"商品名称\":\"草莓奶油蛋糕\",\"规格价格\":19900,\"sku\":\"6寸\",\"规格描述\":\"2-3人吃\"}],\"msg\":\"获取成功\"}"}]}}
page + 1
> | 序号 | 品牌 | 商品名称 | 规格 | 价格 | 详情 |
> | :---: | :---: | :---: | :--- | :---: | :--- |
> | 1 | 可斯贝莉 | 草莓奶油蛋糕 | 6寸 / 2-3人吃 | ¥199 | 查看详情 |
搜索无结果时的标准回复（严格按照以下文案，不得修改）：
> "暂时没找到「关键词」相关商品，不妨更换关键词试试，也可以为您推荐可斯贝莉其他商品哦！"
> "当前地址没有可配送的商品，更换一个地址试试哦"
⚠️ 规格校验（必须执行）：
生成下单链接前，必须校验 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 | 是 | 购买数量 |
| channel_no | string | 是 | 固定值：brand_kesibeili |
Windows 调用（使用 cmd /c 包裹）：
cmd /c "python \"%USERPROFILE%\.workbuddy\skills\kesibeili\scripts\dgss.py\" getOrderaddr '{\"user_token\":\"TOKEN\",\"aid\":\"10806796\",\"spec_id\":1,\"city_name\":\"北京市\",\"quantitys\":1}'"
Linux/Mac 调用：
python "~/.workbuddy/skills/kesibeili/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 获取） |
| channel_no | string | 是 | 固定值：brand_kesibeili |
返回示例：
{"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\kesibeili\scripts\dgss.py\" getOrderStatus '{\"user_token\":\"TOKEN\",\"scene\":\"3881514438313\"}'"
Linux/Mac 调用：
python "~/.workbuddy/skills/kesibeili/scripts/dgss.py" getOrderStatus '{"user_token":"TOKEN","scene":"3881514438313"}'
| 概念 | 正确字段名 | 错误写法 |
|------|-----------|---------|
| 区县 | area | ~~district~~ |
| 详细地址 | addr | ~~detail~~ |
| 地址 ID（搜索/下单） | aid | ~~addr_id~~ |
| 成功状态码 | 200 | ~~0~~ |
| 下单返回 URL | data（字符串） | ~~data.order_url~~ |
| 品牌渠道号 | channel_no: brand_kesibeili | ~~未传或传其他值~~ |
| 品牌ID | brand_id: 102789 | ~~未传或传其他值~~ |
> 核心原则：用户只需要知道"下一步做什么"，不需要知道"发生了什么"。
⚠️ 标准文案必须严格遵守：
绝对禁止输出的内容：
每次回复只允许包含：
错误时的标准回复格式（不超过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 个版本