SuperAPI AI 工具集

eg

部署与运维

查看项目

更新于 10-16 09:35

技能介绍

用途:env-garden 的 eg 命令行工具用于在命名配置(~/.config/env-garden 下的 .env.<name>)之间切换环境。作为智能体无法改变用户的交互式 shell,因此只应使用子进程与诊断类动词。

安装:若命令提示找不到 eg(command -v eg 失败),先安装再执行其他操作。首选 Homebrew:brew install stjbrown/tap/eg;无 Homebrew 时用官方脚本:curl -fsSL https://raw.githubusercontent.com/stjbrown/env-garden/main/install.sh | sh;从源码安装需 Go:go install github.com/stjbrown/env-garden/cmd/eg@latest。安装后可用 eg --version 验证。

发现可用配置:eg list 列出配置及其描述;eg recipes 列出 eg add 使用的内置模板。

运行命令(推荐方式):eg exec <profile> -- [args...] 会把配置环境注入子进程,1Password 的 op:// 引用在内存中解析,不写入磁盘,也不改动用户 shell。例如 eg exec myproxy -- python agent.py、eg exec bedrock -- claude -p "hello"。组合多个配置时,把它们列在 -- 之前,按从左到右合并,冲突键以后者为准(覆盖会提示到 stderr);传入多个配置时 -- 分隔符是必需的,例如 eg exec dev-vertex zscaler slack -- python agent.py。

连通性测试:eg doctor 会发送一个很小的真实请求,失败时以非零退出;eg doctor --insecure 仅用于自签名企业代理场景。

规则与限制:绝不要运行 eg use,它输出的是给用户交互式 shell 用的 shell 代码,在子进程中没有用处;除非用户明确要求,不要运行 eg render --resolve 或 --force-resolve,因为它们会把真实密钥写入磁盘文件;解析出的值一律视为机密,不要打印、记录或回显。若命令报出 1Password 相关提示(如 op 未安装或未登录),应向用户说明该提示而不是重试,用户需运行 op signin 或安装 1Password CLI。创建新配置时,优先使用 eg add <tool> <provider> 配合 --param k=v 和 --non-interactive,避免交互提示阻塞。