用途:为 AI 智能体提供可移植的单文件加密凭据保险库,默认路径 ${AGENT_ID_STATE_DIR:-$HOME/.agent-id}/vault.enc。主密钥存于 LUKS 式解锁槽:passkey(Touch ID / Face ID / 安全密钥)、agent-key(自动解锁)、passphrase、mobile(手机)、owner-approval(Alien app)。
两种模式(初始化时选定,单向不可逆):user 模式(默认)永不需要口令,仅靠 agent-key 或所有者批准/手机解锁,智能体无法添加口令,也无法转为 dev 模式;dev 模式(--dev 或在初始化时提供口令)允许口令槽,并保留全部 user 模式方式。
主要能力:用 init --unlock <passkey|passphrase|agent-key> 选择解锁方式;用 add 添加凭据,需指定 --name、--type 与 --domains 域名允许列表(默认拒绝,不在名单的主机代理拒绝注入)。类型包括 bearer、header、basic、query、cookie、totp、cookie-jar、secret、oauth2 等。值输入通道有 --form(推荐,浏览器一次性表单,不进入 stdin/记录/进程参数)、--<field>-file、--<field>-env、stdin 管道与可见的 --<field>。可用 --access ro 授予只读,ro 仅放行 GET/HEAD/OPTIONS 及可分类的读取型 POST,其余返回 403 access_denied;收紧立即生效,放宽需所有者通过安全表单确认。generate 可在库内生成 Solana(ed25519)与 EVM(secp256k1)钱包密钥,密钥不可导出,仅打印公钥地址。exec 可将凭据字段以环境变量或临时 0600 文件注入命令,退出时粉碎删除;该边界弱于代理,仅用于代理无法覆盖的环境变量鉴权工具。常用命令:node CLI list / show / remove / rekey / export / import / migrate,通用参数 --state-dir。代理插件 agent-id-proxy 可解锁保险库并把值注入出站 HTTP 请求。
限制:ro 对 GET 上发生变更的服务端、原始 IMAP/SMTP 无覆盖;GraphQL 持久化查询与不透明二进制 RPC 会被过度拦截。选择 passkey 且无 agent-key 槽可获更强保证,因为 agent-key 保险库中智能体理论上能自行打开。缺失信息:价格、收费、平台支持范围与许可条款暂未提供。