dmno-dev/varlock

解决的问题

Varlock 解决了以对 AI 代理安全的方式管理环境变量和机密的问题。传统的 .env 文件经常导致机密泄露，或是在示例文件与实际值之间缺乏同步。Varlock 引入了一种基于架构的方法，让 AI 代理能够理解配置需求（类型、验证、描述），而无需看到实际的敏感值。

运作方式

它使用一种称为 @env-spec 的新 DSL，通过 JSDoc 风格的注释将架构和功能附加到 .env 文件中。这允许开发人员在 .env.schema 文件中定义单一事实来源。该工具提供了一个 CLI，用于加载、验证并执行带有已解析变量的程序。它还具有一个插件系统，可从 1Password、AWS、Azure 和 GCP 等外部后端提取机密，并包含一个 varlock scan 指令来检测 AI 生成代码中泄露的机密。

适用对象

正在构建 AI 集成应用程序的开发人员和团队，他们需要在保护机密的同时，为 AI 代理提供必要的上下文，并在多个环境中保持类型安全。

特色亮点

• AI 安全配置：为代理提供变量名称和类型，而不暴露机密。
• 防止机密泄露：通过 varlock scan 进行主动扫描，以及包含日志遮蔽的运行时保护。
• 类型安全：通过 VSCode 扩展功能提供验证、强制转换和 IntelliSense 支持。
• 可扩展的后端支持：为主要机密管理器（例如 HashiCorp Vault、Infisical、1Password）提供广泛的插件支持。
• 多环境管理：自动加载 .env.* 文件与明确导入。