蛋糕叔叔商城点单助手:在对话里完成蛋叔商城搜品与下单

前言

在 Agent 里帮用户买蛋糕、鲜花或零食,常见做法是再挂一层 MCP 或手写一堆 HTTP 封装。蛋叔商城(dangaoss.com)本身提供 WorkBuddy 侧的 JSON-RPC 接口,参数嵌套和返回结构都不算直观。若把「拿 token、选城市、管地址、搜 SKU、出支付链接」拆成零散脚本,维护成本高,也容易在 Windows 与 Linux 上踩编码和调用方式的问题。

下面介绍 SkillHub 社区技能 蛋糕叔叔商城点单助手(坐标 @user_c70e116b/dgss,当前版本 1.0.29)。它把蛋叔商城点单流程写进标准 SKILL.md,Agent 按步骤驱动;底层通过 curl 访问官方端点,并附带 scripts/dgss.py 作为 Windows 等环境下的调用封装,无需额外 MCP 代理。SkillHub 分类为 business-ops,标签含 requires_api_key=true(实际业务侧使用用户提供的 user_token)。

这是什么

蛋糕叔叔商城点单助手是面向蛋叔商城(dangaoss.com)的订购 Skill:蛋糕、甜品、零食、鲜花等品类的查找、选购与预订。发布者为社区用户 user_c70e116b,来源为 community。当用户提到购买蛋糕、甜品、零食、鲜花,或出现「蛋叔」「蛋糕」「下单」「订购」等意图时,Agent 应自动加载该 Skill。

官方入口:

  • Skill 包地址:https://api.skillhub.cn/user_c70e116b/dgss
  • SkillHub 页面:https://www.skillhub.cn/skills/user_c70e116b/dgss

核心功能

以下能力均来自 Skill 说明与安装包内容,可按步骤复现。

触发与工具约束

  • 触发场景:蛋糕预订、生日下单、甜品/零食/鲜花订购、查找附近门店好物等自然语言请求。
  • 允许工具:execute_command、read_file(由 Agent 执行脚本或 curl,并读写本地 token 文件)。
  • 协议:请求 https://www.dangaoss.com/dsapi/workbuddy/mcp_server,JSON-RPC 2.0;业务成功码为 code: 200;响应为双层 JSON(外层 RPC → result.content[0].text → 内层 {code, data, msg})。请求超时约 60 秒。

地址与城市

  1. 用户主动提供 user_token(禁止复用他人 token),并写入本地 dgss_token.md。
  2. 询问配送城市,名称规范到「市」一级(如「北京」→「北京市」);不接受省、区县等非标准城市名。
  3. 调用 getAddrList 列出该城市已保存地址,用户选择 id 作为 aid;无地址时通过 addAddrList 新增(字段名须用 area、addr,而非 district、detail)。
  4. 可将 default_city、default_aid 记入 dgss_token.md,下次优先确认是否沿用。

商品搜索

  • 分类 cat_id:1 蛋糕、5 零食、8 鲜花;关键词模糊时 Skill 要求向用户确认品类。
  • 调用 sweets_lst:必填 user_token、aid、keyword、cat_id;可选 page 分页。
  • 列表需按 Skill 规定的六列展示(序号、品牌、商品名称、规格、价格、详情链接)。

下单与订单查询

  • 调用 getOrderaddr 生成下单 URL(参数含 spec_id、quantitys、city_name 等);下单前须校验规格 ID 与规格名称一致。
  • 从返回 URL 中解析 scene 参数,可写入 dgss_token.md 便于复购或查询。
  • 调用 getOrderStatus 按 scene 查询订单状态;用户发送 8–20 位纯数字时,Skill 约定可识别为 scene 凭证。

调用方式

  • Linux / macOS:优先尝试 curl;亦可直接执行 python "<skills目录>/dgss/scripts/dgss.py" <命令> '<JSON参数>'。
  • Windows:curl 对中文参数易乱码,Skill 要求用 cmd /c 包裹 Python 调用,路径使用 %USERPROFILE% 下的 skills 目录。
  • 首次探测成功的执行方式可记入 MEMORY.md 的 dgss_exec_method,后续复用。

安装与启用

安装 SkillHub CLI(未安装时)

先检查是否已有 CLI:

command -v skillhub && skillhub --version

未安装时可按 SkillHub 官方安装文档执行完整安装(示例为文档中的推荐命令):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装本 Skill

安装时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 可能不会被识别。本 Skill 的搜索结果显示的安装方式为:

skillhub install dgss --namespace user_c70e116b --dir <你的 Agent skills 目录>

也可让 AI 按 SkillHub 安装说明操作,提示词示例(来自 SkillHub 页面):

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_c70e116b/dgss`。

常见 Agent 的 skills 路径(摘自 SkillHub 安装文档):

环境 默认 skills 目录
Cursor ~/.cursor/skills/
Claude Code ~/.claude/skills/
Codex ~/.codex/skills/ 或项目下 .agents/skills/

安装完成后,按你所用客户端要求重启或刷新 Agent,使 SKILL.md 被加载。

凭证与本地文件

  • 用户在浏览器打开 https://www.dangaoss.com/web/wb_index.html 登录后,将 USER_TOKEN 提供给 Agent;Skill 要求写入 dgss_token.md,且勿将含 token 的文件提交到 Git。
  • SkillHub 元数据标记 requires_api_key=true,落地时即对应用户 token 的配置与保管。

典型用法

下面按 Skill 规定的顺序说明一次完整点单;实际对话中由 Agent 逐步提问,无需用户记忆接口名。

1. 提供 token

用户完成蛋叔账号登录后,把 token 发给 Agent。Agent 更新 dgss_token.md 中的 user_token。

2. 确认城市与地址

Agent 询问配送城市,必要时调用地址列表(Linux/macOS 示例路径请替换为你的 skills 安装位置):

python "~/.cursor/skills/dgss/scripts/dgss.py" getAddrList '{"user_token":"TOKEN","city_name":"北京市"}'

3. 搜索商品

确定 cat_id 与关键词后搜索,例如巧克力蛋糕:

python "~/.cursor/skills/dgss/scripts/dgss.py" sweets_lst '{"user_token":"TOKEN","aid":"10806796","keyword":"巧克力","cat_id":1,"page":1}'

4. 生成下单链接

用户选定序号对应规格后:

python "~/.cursor/skills/dgss/scripts/dgss.py" getOrderaddr '{"user_token":"TOKEN","aid":"10806796","spec_id":1,"city_name":"北京市","quantitys":1}'

返回的 data 字段为可打开的下单 URL(如 https://www.dangaoss.com/web/wb_order.html?scene=...),用户在微信等环境中完成支付。

快捷口令(Skill 内置)

  • 「再来一单」「复购」:读取 dgss_token.md 中上次订单信息,在默认地址上重复下单。
  • 「买某某商品」:若已有默认地址,可跳过城市与地址步骤直接搜索。
  • 「换地址」「换 token」:清除或更新 dgss_token.md 中对应字段后重新走流程。

适用场景与注意

适合谁

  • 需要在 Cursor、Claude Code、Codex 等支持 Agent Skills 的环境里,用自然语言完成蛋叔商城选品与出单链接的团队或个人。
  • 希望避免单独部署 MCP,仅依赖 curl / 脚本与 execute_command 的场景。

限制与注意

  • 支付、物流、退款、发票等未在 Skill 流程中实现的能力,Skill 明确要求用固定话术回应,不引导至其他平台。
  • 下单仅支持单个 spec_id;部分城市或区域可能返回无法配送(如业务码 405)。
  • token 与地址信息存放在 Agent 工作区本地文件中,需自行做好权限与备份;勿在公开场合粘贴 token。
  • SkillHub 页面统计(截至资料抓取):评分 100000,下载 1932 次,安装 117 次;以 SkillHub 实时数据为准。

结尾

蛋糕叔叔商城点单助手把蛋叔商城 JSON-RPC 点单链路固化成可执行的 Skill 流程:token 登录、城市与地址、分类搜索、生成下单链接与订单查询,并区分 Windows 与 Unix 的调用方式。若你正在集成生活类电商能力,可从官方地址获取最新包与版本说明:

https://api.skillhub.cn/user_c70e116b/dgss

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜