VaultContext 是一款通过命令行管理加密文件的工具，可在个人或项目保险库中存储、版本化、比较、归档、恢复并显式共享任意格式文件。随附的 vaultcontext 启动器需 uv 及 Linux/macOS Unix 套接字，uv 负责管理 Python 和依赖；可绝对路径调用或复制到 PATH。公开 GitHub 仓库无需账号或令牌，启动器将客户端固定到完整 Git 提交。
使用前配置 VAULTCONTEXT_URL 与 VAULTCONTEXT_USER_EMAIL，以普通用户账号运行 vaultcontext login 完成 Google 登录。CLI 不支持密码登录，Google 登录与加密解锁相互独立。用户需在交互式终端输入口令，不可在聊天中索取或写入参数、环境变量、标准输入。解锁后下载并解密服务器上的身份私钥至进程内存，启动同用户本地 Unix 套接字会话，默认 15 分钟后过期；会话可在命令与任务间复用，仅在用户要求或更换客户端/清理缓存前锁定。可通过 unlock --timeout 3600 延长至最多一小时。丢失口令且无已解锁会话或已登记的 macOS 钥匙串凭据将无法访问，无恢复密钥。
内容隐私边界要求代理只管理文件、绝不检查内容，即使被要求显示、摘要、搜索或脱敏。文件明文不得进入代理上下文、聊天、工具输出或日志。代理不得运行 vaultcontext cat 或读取源文件与恢复文件。仅在被明确要求比较时，可运行 vaultcontext compare DOCUMENT_ID LOCAL_PATH [--version VERSION_ID]，该命令返回相等与比较状态而不含内容或哈希。允许检查元数据，如 ID、名称、大小、修订、归档状态、历史与成员。
文件操作接受任意格式，按路径保存而非读取内容。恢复需显式目标路径，默认拒绝符号链接和已存在目标，除非授权 --overwrite；单文件上限 8 MiB。默认加密显示名为源路径参数，--name 可覆盖。文件变更生成新的不可变版本，可用 --document 更新既有文档 ID。archive 与 unarchive 整理整个文档但不删除数据或改变访问，所有者与编辑者可用，读者不可。
共享需用户明确指定接收方与范围，须通过独立可信渠道验证公钥指纹，share 需 --fingerprint，accept 需邀请方已验证指纹。共享作用于整个保险库及全部保留历史，而非单个文件。权限分读者、编辑者、所有者，撤销会立即移除服务器访问并轮换未来写入密钥。导出需单独输入归档口令，需已解锁保险库，归档口令不是实时保险库的恢复密钥。
演示环境仅在用户要求时配置，地址为 https://vault-demo.pocketcontext.com，须使用合成文件，服务器每日 00:00 UTC 重置账号、密钥与文件；演示中不可用共享、钥匙串登记与口令修改。失败时，修订冲突需重读元数据再重试，网络结果不确定应检查 ID/历史/成员状态，不得声称失败操作已完成。