用途：这是一个 Medusa 平台帮助技能，面向使用开源（MIT）无头电商引擎的开发者与制作者，解答商品、订单、购物车、客户、结账等平台问题，并区分 API 集成、事件响应、自托管与 Medusa Cloud 选择、结账转化、店铺运营等不同目标。
主要能力：先收集上下文，确认目标、使用的接口面（Admin API /admin、Store API /store、/auth/... 认证路由、事件/订阅系统、JS SDK、MCP 服务器或后台 UI）、版本（v2 模块化框架或旧版 v1）与托管方式（自托管或 Medusa Cloud）。随后按需读取平台指南与 API 参考，只回答相关部分。若问题属于跨平台策略（结账转化、Merchant of Record、数字产品定价、购后邮件、平台对比），会转交对应技能。
使用方式与要点：Medusa 没有原生出站 webhook，只有内部事件（如 order.placed），需在 src/subscribers/*.ts 的订阅者中自行发起 HTTP 请求，或安装社区 webhook 插件；订阅者异步执行，不应承担关键路径逻辑，关键流程应使用 workflow hook。认证方面，Admin/Store API 支持 JWT Bearer（来自 /auth/{actor}/{provider}）、Authorization: Basic 的 API key 或 cookie 会话；Storefront 还需发送 x-publishable-api-key 头以限定销售渠道。生产环境需使用 Redis Event Module，默认内存事件总线仅适合开发。
适用场景与限制：适合 API 集成与调试、事件响应、认证与分页、自托管与 Cloud 方案选择等。引擎为 MIT 许可、0% GMV 费用，自托管免费；Medusa Cloud 提供托管 Postgres/Redis/部署，自定义域名、自动扩缩容与后台 worker 属于更高档位。它是框架而非开箱即用店铺，需要 Node、Postgres、Redis 环境，无拖拽主题。资料为 2026-06 研究整理，计划限制、费用、认证与 API 版本需以官方文档为准。