dsh-api-mock

前端项目刚起步，后端接口还在排期，页面渲染、状态流转、异常分支全没法验证——这是每个前端开发者都熟悉的等待。dsh-api-mock 做的事情很直接：读取一份 OpenAPI 3.x 规范（JSON 或 YAML），立刻产出一个零依赖、单文件即可运行的 Node Mock 服务器。它只用了 Node 内置的 http 模块，不装任何 npm 包，不需要 Docker，不需要联网，node mock-server.mjs 一行命令就能启动，所有接口立刻返回符合 schema 的示例响应，前端拿到就能联调。

插件提供两个工具。mock_generate 负责整体：解析规范、推断每条接口第一个 2xx 响应的 application/json schema、生成完整服务器文件并返回可用接口清单。mock_sample 则更轻量，可以按 schema 类型或指定 operationId 单独生成一个示例 JSON 值，适合快速造测试数据或种子数据。生成的示例数据是确定性的——字符串字段给出占位文本，整型给出 42，邮箱字段给出 user@example.com，枚举取首项——同时尊重规范里已经写好的 example、default 和 enum，不会凭空发明值。

它适合的场景很清晰：你手里有一份还算完整的 OpenAPI 文档（哪怕是团队共享的 Swagger 导出），但后端进度跟不上前端需求；或者你正在做一个独立项目，想先把交互跑通再考虑真实数据；又或者你只是想给新同事一个可以立刻点击、立刻看到响应结构的起点。不需要起微服务，不需要写 Jest fixture，打开终端、装好插件、跑一条生成命令，浏览器里就能看到 JSON。