SuperAPI AI 工具集

1password

安全与审计

查看项目

更新于 10-15 23:59

技能介绍

用途:本技能用于设置和使用 1Password CLI(op),包括安装 CLI、启用桌面应用集成、登录(单账号或多账号)等场景。安装应遵循官方 CLI 入门步骤,不要猜测安装命令。

前置条件:可靠执行 op 命令需要 tmux,因为 shell 工具每条命令使用新的 TTY,缺少 tmux 会导致重复认证问题。安装方式:macOS 用 brew install tmux;Linux(Debian/Ubuntu)用 sudo apt install tmux;Linux(RHEL/Fedora)用 sudo dnf install tmux。

参考文件:references/get-started.md 提供安装、应用集成与登录流程;references/cli-examples.md 提供真实 op 示例。

工作流:检查操作系统与 shell;用 op --version 确认 CLI 存在;确认已启用桌面应用集成且应用已解锁;必须为所有 op 命令创建新的 tmux 会话,不在 tmux 外直接调用 op;在 tmux 内执行 op signin 登录或授权(预期出现应用提示);在 tmux 内用 op whoami 验证访问权限,成功后才能读取任何密钥;多账号时使用 --account 或 OP_ACCOUNT。

必需的 tmux 会话:由于 shell 工具每条命令使用新 TTY,应始终在专用 tmux 会话中运行 op,使用新 socket 和会话名。socket 放在 ${LETTA_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/letta-tmux-sockets} 下以便隔离和清理;使用带时间戳的会话名(如 op-auth-$(date +%Y%m%d-%H%M%S))避免复用旧会话;完成后用 tmux -S "$SOCKET" kill-session -t "$SESSION" 结束会话,避免残留长时间运行的 tmux 进程。

安全准则:绝不把密钥粘贴到日志、聊天或代码中;优先使用 op run / op inject 而非把密钥写入磁盘;若需不使用应用集成登录,使用 op account add;若命令返回“account is not signed in”,在 tmux 内重新运行 op signin 并在应用中授权;不要在 tmux 外运行 op,若 tmux 不可用应停止并询问。