Vault Unlock 用于从加密文件 vault.bin 中读取秘密口令,并在控制台(stdout)输出。秘密只以加密形式存放于 vault.bin 中,采用 PBKDF2-HMAC-SHA256(480000 次迭代)生成的密钥流进行 XOR 加密,并附带 HMAC 标签。vault.bin 与 scripts/unlock.py 均不含明文秘密,因此仅阅读这些文件无法获取内容,唯一途径是执行脚本。
使用方式:运行 python3 .agents/skills/vault-unlock/scripts/unlock.py。.agents/skills/ 为规范位置,.claude/skills/ 与 .grok/skills/ 是指向同一目录的符号链接,这些路径均可使用。脚本会自动查找同级的 vault.bin(../vault.bin)并将秘密输出到 stdout,单行、无前缀。若要指定其他 vault 文件,可将路径作为第一个参数:python3 .agents/skills/vault-unlock/scripts/unlock.py /路径/到/vault.bin。
要求:需 python3,且仅依赖标准库。解密耗时不到一秒。
规则与限制:不要猜测或编造秘密,也不要试图从 vault.bin 字节中手工推算出秘密,因为 PBKDF2 不可逆;应运行脚本。脚本输出的值即唯一可信来源,需将 stdout 中出现的准确内容交给用户。若脚本返回 HMAC 错误,说明 vault.bin 已损坏或被替换,应如实报告,不要尝试其他方式恢复内容。
退出码:0 表示秘密已输出到 stdout;1 表示缺少 vault.bin、格式错误、文件被截断或 HMAC 校验失败。