用途：为使用 EverShop 的开发者提供平台级帮助，覆盖安装搭建、API 集成、商品/订单同步、事件响应、构建与运维问题，以及平台选型判断。
主要能力与用法：写入走 REST（如 POST /api/products、PATCH /api/products/{uuid}、/api/orders、/api/carts/...），读取走 GraphQL，没有宽泛的 REST 列表/查询接口；变更按资源 uuid 而非整数 id 定位。认证用 JWT：管理员令牌由 POST /api/user/tokens 获取，返回 accessToken 与 refreshToken，请求头带 Authorization: Bearer <token>；管理员令牌默认 15 分钟过期，长任务需保存 refreshToken 并在 401 时调用 POST /api/user/token/refresh，或调高 JWT_ADMIN_TOKEN_EXPIRY。端点默认私有，未声明访问权限即需认证。
事件与集成：没有出站 webhook，也没有注册 webhook URL 的界面；需在扩展中编写事件订阅者（如 subscribers/order_placed/handler.ts，默认导出的异步函数）自行发起外部请求，订阅者在进程内异步执行，重试与幂等需自行负责；无法部署代码时可退化为定时用 GraphQL 轮询订单。
适用场景与限制：自托管，需 Node 20+、PostgreSQL 13+，建议用 pm2/systemd 自动重启，大目录建议 8 GB+ 内存；软件免费（GPL-3.0），无按销售抽成，但不是 Merchant of Record，税务由自己承担，暂无托管云。常见坑：Node < 20 会导致构建失败；url_key/sku 需为小写连字符 slug；Docker 快速启动默认无管理员与数据，需 npm run seed 并创建管理员。以上为 2026-06 研究整理，版本、令牌过期默认值、事件列表与云服务状态请以官方文档为准。