用途:通过 1Password CLI(op)管理 1Password vault 中的密码与 API credentials,可保存、查询、读取 API key/token,并把密钥注入脚本的环境变量,适合开发工作流中的 secret 管理。
前置检查:确认 op 已安装并已与桌面 App 集成,先执行 op --version;未安装时引导安装:brew install --cask 1password-cli。安装后需在 1Password 桌面 App 中开启集成:Settings → Developer → Integrate with 1Password CLI。
主要能力:
- 保存 API Credential:用 op item create 创建条目,分类为 API Credential,标题规范为「{服务商} API Key - {用途标识}」。最小必填字段为 credential(API Key 本身),其余字段(website url、base_url、username、用途说明、过期时间、创建日期、tags)按用户实际提供情况填写,未提供的省略。
- 查询/搜索条目:可用 op item list --format=json 配合脚本按标题或 URL 关键词模糊匹配,输出条目的 ID、标题与更新时间。
- 读取 Credential:op item get "{标题}" --fields credential 读取隐藏值,加 --reveal 显示明文。
- 注入环境变量:在 .env 中使用 Secret References(如 OPENAI_API_KEY=op://Personal/OpenAI API Key - agent/credential)代替明文,再用 op run --env-file=.env -- your-script.sh 或 op run --env-file=.env -- python3 main.py 注入真实值运行脚本。
- Vault 管理:op vault list 查看所有 vault;op item list --vault="Personal" 查看某 vault 下所有条目;op item list --tags "deepseek" 按 tag 筛选。
典型工作流:用户要求保存某 API Key 时,先确认 op 可用,收集服务商名、API Key、网站 URL、用途与关联项目信息,执行 op item create 保存,最后输出保存结果(ID、标题、字段列表),不显示 credential 明文。
限制:依赖已安装并集成的 1Password CLI 与桌面 App;字段按用户提供情况填写,缺失字段省略;具体收费、价格、平台支持与效果资料暂未提供。