前言¶
在 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 秒。
地址與城市¶
- 用戶主動提供 user_token(禁止複用他人 token),並寫入本地
dgss_token.md。 - 詢問配送城市,名稱規範到「市」一級(如「北京」→「北京市」);不接受省、區縣等非標準城市名。
- 調用 getAddrList 列出該城市已保存地址,用戶選擇
id作爲 aid;無地址時通過 addAddrList 新增(字段名須用area、addr,而非district、detail)。 - 可將
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