用途:为 emulate(Vercel Labs 的有状态 API 模拟工具)生成和管理种子配置,让测试从预设的令牌、用户、仓库、项目等已知状态开始。
主要能力:emulate 提供带级联删除、游标分页、Webhook 投递与 HMAC 签名校验的真实状态机,而非简单 mock;覆盖 GitHub、Vercel、Google OAuth、Slack、Apple Auth、Microsoft Entra、AWS、MongoDB Atlas、Okta、Resend、Stripe、Clerk、Linear、Twilio 等服务,各自默认端口从 :4000 起分配。种子配置支持 tokens、github、vercel、okta、resend、stripe、mongoatlas 等块。提供 auto-discover 脚本扫描 package.json 依赖并生成 emulate.config.yaml,支持默认报告、--json、--apply 三种模式。配套 emulate-engineer 子代理用于从零生成完整配置、Webhook HMAC、CI 集成与并行端口隔离。
用法:npm install --save-dev emulate;npx emulate 启动全部服务;npx emulate --service github,stripe --seed ./emulate.config.yaml 启动指定服务;npx emulate init --service github 生成初始配置。编程接口从顶层包导出 createEmulator,种子以对象而非路径传入。Webhook 签名格式因服务而异,GitHub 使用 sha256= 头,Stripe 自 0.10.0 起使用 Stripe-Signature 格式。
限制:仅覆盖上述服务,其他 HTTP API 需改用 MSW/Nock 等;详细端点与 API 说明请阅读上游文档,本技能仅提供封装与本地约定。具体收费与价格信息暂未提供。