用途:校验环境配置文件,检测缺失或配置错误的变量,并生成类型化 env schema。适用于需要检查 .env 与代码引用一致性的项目。
主要能力:读取 .env 及 .env.local、.env.development、.env.production;扫描 .ts/.tsx/.js/.jsx 中的 process.env.* 与 import.meta.env.* 引用;对比找出缺失变量、未使用变量、空值、重复定义、格式错误;检测疑似真实密钥与含凭据的连接串,并检查 .gitignore 是否包含 .env 与 .env.local;生成或更新 .env.example,可选生成类型化校验 schema;进行命名规范审计。
使用方式:先读取 config/defaults.md 并按用户技术栈调整模式与示例;按流程读取 env 文件、扫描代码、对比、检测安全问题、生成文件。输出为 Env Validation Report,按严重程度分组列出文件位置与建议,并列出生成的文件。自动修复会生成更新后的 .env.example 与类型化 schema,覆盖已有文件前需询问用户。
类型化 schema 支持 T3 Env(Next.js)与普通 Zod 两种模式,示例使用 @t3-oss/env-nextjs 与 zod。
限制:未提供具体安装命令、价格、平台支持范围与运行环境要求;实际检测规则与排除项以资料所述为准,未提及的框架或语言支持暂未提供。