用途：扫描项目中的 API 路由定义，提取方法、路径、参数与请求体等元数据，生成可直接复制运行的 cURL 命令，用于命令行接口测试与文档编写。
主要能力：支持 Express、Next.js、Fastify 等框架；自动识别 GET/POST/PUT/PATCH/DELETE 等方法；为 POST/PUT/PATCH 添加 Content-Type: application/json 与示例 JSON 请求体；支持 Bearer、Basic、API Key 认证头占位符；路径参数转为 {param} 占位符，查询参数拼入 URL；按资源分组输出；可选 -v 详细输出与 -i 显示响应头；输出格式支持 markdown、shell、plain。
使用方式：提供 TypeScript 生成脚本（scripts/generate-curl.ts），核心函数为 generateCurlCommand 与 generateCurlCommands，可按资源分组并输出指定格式；另附 CLI 脚本示例（scripts/curl-gen.ts），基于 commander 提供 --framework、--source、--output、--base-url、--format、--verbose 等选项；也可通过 Makefile 目标或环境变量文件（.env.curl）区分 dev/staging/prod 环境。
适用场景：本地或远程 API 快速调试、生成接口文档、编写 Shell 测试脚本、CI 中做接口冒烟测试。
限制：资料未提供具体安装命令、依赖版本、支持的框架版本范围及收费信息；生成脚本中的 scanRoutes 函数未给出实现，需自行补充路由扫描逻辑；示例中的令牌、URL 与数据均为占位内容，实际使用需替换。