emulate
本地化、全状态的生产级API模拟服务，用于CI和无网络沙箱环境。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：emulate。 它的用途是：本地化、全状态的生产级API模拟服务，用于CI和无网络沙箱环境。 完整的 Skill 内容见：https://321skill.com/skills/emulate/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我需要为调用GitHub API和Stripe支付的功能写集成测试，但不想依赖网络和真实账户。” 它会建议你使用emulate，在本地启动GitHub和Stripe的模拟服务，并指导你将测试中的API基地址指向`http://localhost:4001`和`http://localhost:4009`，从而进行完全可控的离线测试。
介绍
emulate 是一个为现代开发工作流设计的本地API模拟服务集合。它解决了开发者在持续集成（CI）测试、离线环境或需要隔离网络依赖的沙箱中，无法稳定调用外部服务（如GitHub、Vercel、Stripe等）的痛点。
使用极其简单，无需配置文件，只需运行 npx emulate 即可启动所有预设服务，每个服务（如GitHub、Vercel、Stripe等）都会在本地指定端口（如4001, 4000, 4009）启动一个高保真的模拟实例。开发者可以通过CLI灵活控制启动哪些服务、指定端口，或通过程序化API集成到测试框架中。
它非常适合前端、后端及全栈开发者，尤其是在编写涉及第三方API集成的单元测试、集成测试或进行本地功能开发时。对于需要确保测试可重复、不依赖外部网络稳定性，或需要在飞机、无网络环境下编码的团队来说，这是一个强大的工具。
建议初次使用时通过 npx emulate init 生成配置文件进行探索。虽然它提供了生产级保真度，但请注意它模拟的是API的行为和状态，并非真实服务的完全替代品，最终上线前仍需在真实或类生产环境中进行验证。结合 portless 使用可以获得带可信HTTPS的URL，进一步提升本地开发体验。
核心特点
与简单的HTTP Mock服务器不同，emulate提供的是完全状态化、高保真的API模拟，能够持久化数据状态并模拟真实服务的完整交互逻辑，而非仅返回预设的静态响应。它开箱即用，无需复杂配置即可模拟十几种主流云服务，并支持通过种子文件初始化数据状态，更贴近真实开发场景。
注意事项
不适合需要与真实服务进行最新API同步或测试真实服务端极限性能和边缘场景的情况。
常见问题
emulate和mock有什么区别？
emulate是状态化、高保真的模拟，能持久化数据并模拟完整业务逻辑；mock通常只是返回预设静态响应的桩。
如何在CI流水线中使用emulate？
在CI脚本中通过`npx emulate`启动所需服务，你的测试代码即可将API请求指向对应的本地端点进行无网络测试。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/emulate/raw/index.md 读取 emulate 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/emulate/raw/index.md（查看排版版本）