用途:管理项目环境变量与 .env 文件,覆盖扫描、校验、生成模板和同步配置。触发场景包括管理环境变量、配置同步、Secrets 检查。
主要能力:扫描 .env 及 .env.local、.env.development、.env.production 等文件,默认只提取变量名、来源和是否为空,真实值脱敏;扫描代码中 process.env.XXX、os.environ['XXX']、os.getenv('XXX') 引用;识别已使用但未定义的变量和静态扫描未发现引用的候选变量。校验必填项默认值、URL 格式、端口范围、布尔格式,检测硬编码 API Key/Token/Password,对比 .env.example 与实际 .env 差异。生成 .env.example 模板和 .env.schema.json 校验规则,建议迁移硬编码密钥,生成 dotenv 加载配置。同步 monorepo 共享变量,生成 Docker Compose env_file 与 CI/CD Secrets 清单。
使用方式:由用户提出环境变量或 .env 相关需求时激活,按扫描、校验、生成/修复、同步流程执行,输出脱敏报告与模板。
限制:不自动删除或改写真实 .env,需先展示差异并取得确认;“未使用”仅指静态扫描未发现,仍需检查 CI、容器、部署平台和动态访问;不把生产 Secret 复制到模板、Schema、日志或聊天输出。注意框架前缀差异(Next.js NEXT_PUBLIC_、Vite VITE_、CRA REACT_APP_、Nuxt NUXT_PUBLIC_、Vue CLI VUE_APP_),Docker 构建 ARG 与运行时 ENV 不同,monorepo 根 .env 不会自动被子包读取。