用途:通过 1Password 命令行(op)创建和管理结构化条目,主要用于保存 API 凭据、密钥及其他结构化数据。核心原则:仅将真正的密钥设为隐藏字段,客户端 ID、URL、用户名不算密钥;字段名清晰描述、与来源文档术语一致;补充账户、备注等上下文;清理模板中多余的默认字段。
字段类型:用后缀控制类型,如 "字段名[text]=值" 为明文,"[concealed]=值" 为隐藏,"[url]=地址" 为可点击链接,"[delete]" 删除字段;无后缀默认隐藏,应始终显式声明。
创建示例(API 凭据):op item create --category="API Credential" --title="服务名 - 应用名" --vault="VaultName" "Client ID[text]=ABC123" "Client Secret[concealed]=...",还可加 Account、Redirect URL、Authorization URL、Token Request URL、Developer Portal 及 notesPlain 备注。简单 API Key、数据库、服务器/SSH 条目的写法类似,使用对应 category。
模板字段处理:某些类别会附带 valid from、expires 等默认字段(初始显示为 1969-12-31)。不适用时用 op item edit "条目名" --vault="VaultName" "valid from[delete]" "expires[delete]" 删除;适用时用日期格式设置,如 op item edit ... "valid from=2026-01-27" "expires=2027-01-27"。
命名与上下文:避免 credential、token_uri、secret 等模糊名,改用 Client ID、Token Request URL、Client Secret 或 API Key 等具体名称,并与服务文档保持一致。用 notesPlain 记录用途、账户选择原因、限制或频率限制及文档链接。
可用保险库:先执行 op vault list 查看。验证:创建后在界面确认只有真正的密钥被隐藏、字段名清晰、无残留模板字段(或日期有效)、备注齐全。限制:资料未提供更详细的环境或版本要求。