支持
写信时请说明设备型号、系统版本和 App 版本(在「设置 › 关于」里),以及问题出现前做了什么。请不要在邮件或截图里带上任何密钥。
数据和安全
- 我的密钥保存在哪里?
- 只在你的设备上。密钥内容用 AES-GCM 加密后写入 App 自己的数据库,加密用的密钥放在系统钥匙串里。App 没有账号,不联网,我们没有服务器,也看不到你的任何内容。
- 换新手机或新电脑,数据会跟过去吗?
- 目前不会。App 还没有 iCloud 同步和备份导出;在 iPhone 和 iPad 上,加密用的密钥只留在原来那台设备上,把备份恢复到新设备后原来的密钥内容可能打不开。换设备前请确认重要的密钥在别处还能拿到,或者可以在对应平台重新生成。iCloud 同步和加密备份在计划中。
- 忘了密钥、误删了,能帮我找回吗?
- 删除的密钥在「设置 › 最近删除」里保留 30 天,可以恢复。超过 30 天、彻底删除、清除所有数据或删除 App 之后无法恢复,我们手里没有任何副本。
- 面容 ID 用不了怎么办?
- 验证失败时系统会让你输入设备密码。如果「解锁」开关是灰的,说明这台设备还没有设置密码或面容 ID / 触控 ID,先到系统设置里设置。
- 复制的密钥会留在剪贴板里吗?
- 会按「设置 › 剪贴板自动清除」的时间清掉,默认 90 秒。复制的内容标记为仅限本机,不会通过「通用剪贴板」出现在你的其它设备上。
使用
- 没有我要的平台怎么办?
- 新增密钥时在选择平台的页面底部点「添加自定义平台」,填名称和字段即可。也欢迎写信告诉我们,常用的会加进内置目录。
- 一个平台有好几条密钥怎么存?
- 同一个平台可以存多条,列表里只占一行,进详情后左右切换卡片。在更多菜单里可以把常用的一条设为默认,它会固定在第 1 张。
- 「项目」是做什么的?
- 把一个项目要用的密钥放在一起,每条密钥在项目里有一个环境变量名(例如
OPENAI_API_KEY)。一条密钥可以属于多个项目。 - Mac 上有哪些快捷键?
- ⌘K 搜索,↑↓ 选择,↩ 打开,⌘C 复制当前密钥,⌘N 新增,⌘, 设置。
让 Agent 取密钥(Mac)
KeyPocket 的 Mac 版自带 MCP 服务,不用另外安装。
- 在 KeyPocket 的「设置 › Agent」里打开「允许 Agent 请求密钥」。系统询问通知权限时建议允许。
- 点「复制命令」,在终端里运行。Claude Code 的命令是:
其它支持 MCP 的客户端按 stdio 服务配置:claude mcp add --scope user keypocket -- /Applications/KeyPocket.app/Contents/MacOS/KeyPocket mcp{ "mcpServers": { "keypocket": { "command": "/Applications/KeyPocket.app/Contents/MacOS/KeyPocket", "args": ["mcp"] } } } - 让 Agent 列出项目,或请求某个项目里的某个变量。KeyPocket 会弹出确认,用触控 ID 允许后密钥进入剪贴板,90 秒后清除。
- Agent 能看到我的密钥吗?
- KeyPocket 不会把密钥内容返回给 Agent,Agent 能列出的只有项目名、变量名和所属平台。但密钥进了剪贴板以后,Agent 可以读取剪贴板,这一步 KeyPocket 拦不住,所以每次都需要你确认。
- 为什么有时候不弹确认?
- 确认一次后 1 分钟内,同一个 Agent 会话取同一个项目的密钥不用再确认,但每取一条都会发通知,通知上可以点「停止」。没有开通知权限时,每次请求都会确认。
- Agent 说连不上 KeyPocket?
- 先确认「允许 Agent 请求密钥」是开着的;App 不在「应用程序」文件夹时,用设置里「复制命令」给的路径重新添加一次。