用途:在编写、审查、测试或迁移 NestJS 应用时提供版本感知的实践指导,涵盖 @nestjs/* API、模块、校验、传输层、测试与 CLI。
主要能力:以项目源码、package.json、锁文件、模块格式、HTTP 适配器和测试运行器为主要上下文,仅读取与任务相关的参考文档,按需路由到迁移、CLI、架构、请求生命周期、HTTP/数据、安全、GraphQL/WebSocket/微服务等主题。
必要用法:先检查 package.json 与锁文件中 @nestjs/core、@nestjs/common、平台适配器和 CLI 的版本;普通功能与缺陷修复保持现有大版本,不把 v12 专有 API 引入 v10/v11 项目;新项目或明确升级前,核实 npm 当前稳定标签与官方迁移指南,并保持所有 @nestjs/* 包大版本兼容;v11 升 v12 前先阅读迁移文档。保留项目已有的 CommonJS 或 ESM 选择,除非用户明确要求迁移模块格式。生成代码前检查现有模块边界与邻近模式,优先使用框架原语与当前适配器,控制器保持轻薄,非类依赖使用显式注入令牌,默认单例作用域,在传输边界校验不可信输入,保持错误契约稳定,通过 @nestjs/testing 测试可观察行为,编辑后运行仓库已定义的测试、类型检查、lint 与构建命令。
适用场景:NestJS 新功能开发、代码审查、单元与端到端测试、版本升级、CLI 与 monorepo 配置、校验与序列化、配置管理、数据库集成、安全与 API 文档、GraphQL、WebSocket 与微服务传输层等。
限制:资料未提供具体安装命令、收费或许可信息;NestJS 12 的版本与补丁号属于特定日期的观察,升级前需重新核实注册表与官方文档;路由冲突策略与解析策略均为可选,不应仅为匹配新项目默认值而迁移现有构建栈;不同主题的参考文档需按任务选择性阅读,未列明的功能细节暂未提供。