核心定位与用途
Standard Agentic Commerce Engine 是一款面向Agentic Commerce的生产级通用引擎，通过标准化协议连接自主代理与现代无头电商后端。它将任何数字 storefront 即时转化为"Agent-Native"系统，支持商品发现、购物车操作、用户管理等完整电商流程。
核心用法
1. 环境配置：设置 COMMERCE_URL 和 COMMERCE_BRAND_ID 环境变量
2. 商品发现：使用 search / list 命令，支持分页参数避免上下文溢出
3. 购物车操作：原子级控制（add/update/remove/clear），支持多规格变体
4. 订单创建：通过 create-order 生成待支付订单，返回支付URL交由用户完成最终付款（关键限制：代理不直接处理金融支付）
5. 状态管理：本地存储Token（0600权限），HTTPS强制传输，无状态API设计
显著优点
- 标准化协议：统一的
SERVER_SPEC.md规范，降低多平台对接成本 - 生产就绪：提供FastAPI参考实现，分钟级部署
- 安全架构：v1.4.0+ 不存储原始密码，Token本地隔离，HTTPS强制
- 真实案例验证：Lafeitu Gourmet Skill 已投入实际 artisanal food 品牌使用
潜在局限与风险
- 支付瓶颈：代理无法直接执行消费者支付（银行卡/移动支付），必须人工接管最后一步
- 后端依赖：需目标电商系统实现兼容的Agent-Native接口，存量系统改造存在成本
- Token生命周期：未明确Token过期刷新机制，长期会话可能中断
- 匿名Visitor ID：虽无PII，但仍存在跨站追踪的理论可能
适合人群
- 无头电商开发者（Headless Commerce）
- 需要为品牌构建AI购物助手的Agent开发者
- 希望现有网站快速"Agent化"的技术团队
- 对自动化采购、库存查询有B2B需求的企业
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 金融授权缺失 | 中 | 设计约束，非漏洞，但影响用户体验闭环 |
| 配置泄露 | 低 | COMMERCE_URL/BRAND_ID为环境变量，需妥善管理 |
| 中间人攻击 | 低 | v1.4.7+ 强制HTTPS，历史版本可能降级 |
| 本地权限提升 | 低 | 凭证文件0600权限，多用户系统需注意隔离 |