机密¶

T3 Code 可以从机密提供方读取凭据，因此凭据会保存在你的密码管理器中，而 T3 Code 只保存对它的引用。代理也可以在一个私有卡片中向你请求机密，而不是在聊天中询问。

“机密”设置页面目前处于预览阶段，并非每个构建版本都包含。来自代理的机密请求在所有环境中均可用。

机密提供方¶

1Password 是受支持的提供方。T3 Code 通过 1Password CLI (op) 读取机密，因此 op 必须安装在运行 T3 Code 服务器的机器上并已登录。当你在另一台机器或手机上使用 T3 Code 时，那是远程机器，而不是你眼前的设备。

桌面端登录会要求在该机器上获得批准，而远程用户无法响应此请求。在远程或无头服务器上，请改用服务账户或 Connect 服务器登录 op。

要添加提供方，请打开 设置 → 机密，选择 添加提供方，然后输入名称和 1Password 账户：简称、登录地址（不含 https://）或 op account list 显示的 ID。机密提供方属于你所连接的环境。每个环境维护自己的列表。

使用机密引用¶

设置中的凭据字段（例如提供方环境变量与凭据、源代码控制令牌、使用限制密钥和设备主机令牌）旁边会显示来源选择器。选择 值 以保存凭据本身，或选择一个机密提供方并输入类似 op://vault/item/field 的引用。使用 复制机密引用 从 1Password 复制该引用。

T3 Code 在需要时会读取机密，例如在提供方启动时。更改 1Password 中的凭据并刷新即可使用新值。

在无法读取机密时¶

如果 1Password 已锁定或已退出登录，需要该机密的提供方或功能会显示一条错误，指明该机密提供方。请在服务器所在机器上解锁 1Password，然后在 设置 → 提供方 中选择 刷新。T3 Code 绝不会用另一个登录凭据替换它无法读取的已保存凭据。

移除机密提供方¶

当你在 设置 → 机密 中移除一个机密提供方时，T3 Code 会列出从该提供方读取的字段。移除它会清空这些字段，因此请在你需要它们之前重新设置。1Password 中的机密不会受到影响。

当代理请求机密时¶

需要令牌或密码的代理会在线程中显示一张机密请求卡片，而不是要求你将内容粘贴到聊天中。输入或粘贴该值并选择 安全保存，或选择 拒绝。你可以从 Web、桌面或移动端进行回复。

如果环境具有机密提供方，该卡片还会允许你选择该提供方并输入引用，而不是直接输入值。T3 Code 只在你回答时读取一次机密。如果 1Password 已锁定，卡片会说明情况，请求会保持打开：解锁后重试，或直接输入值。

该值永远不会出现在对话中。大多数请求也不会将其提供给代理：T3 Code 会将值传递给需要它的工具。当代理必须使用该值运行命令时，卡片会另行说明：该值会写入一个私有文件，代理的命令可以在大约 24 小时内读取该文件。