蛋糕叔叔商城點單助手:在對話裏完成蛋叔商城搜品與下單

前言

在 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

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

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

小夜