核心用法
API Generator 是一款后端开发脚手架工具，通过 bash scripts/apigen.sh 命令行接口生成标准化API代码。支持七类核心命令：
| 命令 | 用途 | 输出示例 |
|------|------|---------|
| `rest` | Express.js CRUD端点 | 路由+控制器+模型 |
| `graphql` | Schema定义 | Type/Query/Mutation |
| `swagger` | OpenAPI 3.0文档 | YAML/JSON规范 |
| `client` | Python消费端 | 类型安全HTTP客户端 |
| `mock` | 内存模拟服务器 | 快速原型验证 |
| `auth` | 认证中间件 | JWT/OAuth/API Key |
| `rate-limit` | 限流保护 | Token Bucket/滑动窗口 |
| `test` | 自动化测试 | Jest+Supertest套件 |
所有代码输出至stdout，支持重定向到项目文件，包含完整注释，可直接作为项目起点。
显著优点
- 开发效率：秒级生成标准化代码骨架，减少重复样板编写
- 规范统一：内置RESTful设计规范与OpenAPI标准，降低团队协作摩擦
- 全栈覆盖：从服务端到客户端、从认证到测试的完整工具链
- 零配置启动：纯bash脚本，无需复杂初始化
潜在局限
- 框架锁定：REST端点默认绑定Express.js，GraphQL schema需配合特定解析器使用
- 定制深度：生成代码为起点模板，复杂业务逻辑仍需手动扩展
- 输出方式：仅stdout输出，无文件自动写入或项目结构管理
- 生态依赖：mock server基于内存存储，生产环境需替换为持久化方案
适合人群
- 需要快速启动后端原型的全栈开发者
- 遵循标准化API规范的技术团队
- 教学/演示场景下的脚手架演示
常规风险
- 安全代码审查：生成的认证代码（JWT/OAuth）需审查密钥管理、token过期策略
- 限流配置：生产部署前需根据实际负载调整令牌桶容量与 refill 速率
- 测试覆盖：自动生成测试为基础断言，需补充边界 case 与异常流测试
- 依赖版本：Express、GraphQL等生成代码的依赖版本需定期同步安全补丁
> 来源可信度：官方技能文档（T2），未执行独立安全审计。建议生产使用前进行人工代码审查。