用途：为使用 Bagisto 开源（MIT）Laravel/PHP 电商框架的开发者提供平台层面的帮助，包括 API 集成与调试、订单/商品同步到 CRM 或仓库、结账与转化问题、安装与运维排障，以及平台选型判断。
主要能力：先收集上下文（目标、使用的接口面、认证方式、托管方式、版本），再按需直接回答 Bagisto 专属问题或路由到相关技能。内置平台参考与 API 参考文档，覆盖模块、数据模型、定价态势与快速上手配方；回答时只取相关章节。
使用方式与关键事实：现行统一 API 通过 REST（/api/shop、/api/admin）和 GraphQL（/api/graphql，调试页 /api/graphiql）提供，公有 Shop 调用需 X-STOREFRONT-KEY，客户/管理员路由需 Laravel Sanctum Bearer token，访客通过 POST /api/shop/cart-tokens 获取购物车令牌。旧版独立包 bagisto/graphql-api 使用 JWT 与 x-app-secret-key，两者不可混用。REST/GraphQL 通常需单独安装：composer require bagisto/rest-api 或 bagisto/graphql-api，再运行对应 php artisan ...:install。分页上限 per_page=50，可用响应头 X-Total-Pages、X-Total-Count、X-Page 翻页。
限制：核心没有原生出站 webhook，需监听 Laravel 事件（如 checkout.order.save.after）、定时轮询或使用社区包；自托管免费无按笔交易费，Cloud 为托管方案，价格与 SLA 需以实际页面为准。安装常见问题包括 APP_URL 不匹配导致图片/混合内容错误、缓存与队列未配置导致缓慢、文件权限或 PHP 扩展缺失导致安装失败；GraphQL 生产环境需运行 php artisan lighthouse:cache。资料为 2026-06 尽力整理，具体计划门槛、费用、认证头与 API 包版本需以实时文档复核。