钥匙串密码库

解决什么问题

让助手帮忙管密码时，最容易翻车的一步就是把密码直接发进聊天窗口。一旦明文进入对话，它就可能留在模型上下文、命令历史、进程参数、环境变量和日志里，事后几乎无法收回。这个技能把单条密码的完整生命周期关进 macOS 钥匙串，让明文不必经过对话。

工作原理

• 健康检查：先运行 scripts/password_vault.sh doctor，确认当前系统是 macOS，且 Swift 与钥匙串可用；任一条件不满足就停止，不会降级到明文文件。
• 新增：必填条目名称和密码（通过无回显终端输入或放入剪贴板），可选账号、网址和备注。密码由登录钥匙串加密保存，条目不启用同步，也不设置应用信任列表。
• 列表与元数据：只返回名称、账号、网址、备注和更新时间，从不读取或显示密码。
• 调取：默认复制到系统剪贴板，若剪贴板未被改写则 45 秒后清除；显示明文需要用户明确确认并知晓风险。
• 更新与删除：执行前必须再次确认目标条目和修改范围（密码、账号、网址还是备注）。

关键一步是：敏感操作前先复述条目名称和修改范围，得到确认后才加 --yes。密码传递支持无回显终端输入、--secret-clipboard（读取后立即清空剪贴板），以及仅限可信本地程序之间使用的 --secret-stdin（禁止把密码写进 shell 命令文本）。

边界与注意点

• 钥匙串只保护静态存储和访问授权，不防御恶意软件、键盘记录、屏幕录制或剪贴板监听。
• 系统弹窗一律选择「允许」，不要选「始终允许」，否则后续调用可能不再需要确认。
• 明文显示会进入终端滚动区和工具输出，即使已确认，仍应优先走剪贴板调取。
• 不支持团队共享、跨设备同步、浏览器自动填充、通行密钥、TOTP、批量导入导出和恢复主密码。
• 自检只使用伪造密码验证新增、读取、更新、删除链路，测试条目删除后，info 查询会返回条目不存在。