用途：为使用 Swell（API 优先的无头 SaaS 商务后端，含原生订阅引擎）的开发者与运营者提供平台级帮助，覆盖 API 集成、商务事件响应、订阅计费、结账转化、迁移与店铺运营等场景。
主要能力：区分后端 API（api.swell.store，密钥，服务端）与前端 API（swell-js 或 GraphQL，公钥，客户端）、Webhook、Swell Apps、CLI 与仪表盘；说明密钥类型与作用域、计划门槛（订阅需 Basic+，多币种/价格表需 Standard+，各档有月度 API 请求上限）、数据模型与快速上手配方。
使用方式：先读取 references/learnings.md 与 references/platform-guide.md、references/swell-api-reference.md，按问题定位相关章节作答。服务端用密钥配合 swell-node/swell-php 访问 https://api.swell.store；浏览器端用公钥配合 swell-js 或 GraphQL（https://{store}.swell.store/graphql/v2）。官方库使用 8443 端口自定义协议，若被防火墙拦截可回退到 443 的 REST/GraphQL。跨平台策略问题按命令路由到 /sales-checkout、/sales-subscription-billing、/sales-merchant-of-record 等。
限制与注意：Webhook 载荷精简且无 HMAC 签名，需用 IP 白名单加秘密 URL/请求头保护，10 秒内返回 2xx，否则会被自动禁用；导入订阅时不要设置 $migrate: true，以免跳过计费调度事件导致重复扣款；数字商品购物车历史上仍要求配送字段；不支持自定义 SMTP；API 与文档成熟度不一。资料为 2026-06 研究整理，计划门槛、费用、认证、端口与 Webhook 签名需以官方文档为准。