SuperAPI AI 工具集

vercel-env-puller

通用与其它

查看项目

更新于 10-16 05:02

技能介绍

用途:为多项目 Vercel 环境变量建立“只存名称、不存值”的清单,并在 Sandcastle 智能体启动时按项目解析真实密钥,实现最小权限注入。

主要能力:清单文件位于 .harness/env-manifests/{project-slug}.json,字段含 name、target、category、criticality;硬编码跳过 NEXT_PUBLIC_、DASHBOARD_PASSWORD、TAO_PASSWORD、TELEGRAM_、PLAUSIBLE_、POSTHOG_、VERCEL_TOKEN、VERCEL_GIT_、DEPLOY_HOOK* 等模式。criticality 为 blocker 的变量认证失败会触发 cfo_alert 与升级锁,degraded 继续并告警,optional 静默回退,skip 永不注入。

使用方式:刷新清单时执行 vercel pull、vercel env ls --json --environment=production,再运行 python3 scripts/refresh_env_manifest.py --slug {project_slug} --raw /tmp/raw.json --out .harness/env-manifests/{project_slug}.json。运行时调用 resolve_for_run(project_slug, run_id),通过 vercel env pull 拉取到 tmpfs 或 mkfifo,解析后立即 unlink,仅保留所需变量名,写入 0600 权限的 Sandcastle 配置文件,审计只记录变量名。

适用场景:多项目组合中需要真实生产密钥的自动化智能体运行,且要求按项目隔离、不落盘、可审计。

限制:不集成 Vault、1Password 或 AWS Secrets Manager;不支持跨团队共享清单;无清单热重载;清单不加密(因不含值)。调用方必须确保返回字典不被打印或持久化,并在 finally 中删除配置文件。