SnapShots
SnapShot 会捕获你正在操作的窗口,并附加到当前草稿。附件带有应用名称和窗口标题;在能够获取时,还包括应用图标,以及窗口的辅助功能数据(其中的控件、文本,以及它们在图像中的位置)。智能体可以凭借这些数据对截图进行推理。
SnapShots 默认关闭,可在 macOS、Windows,以及使用 Wayland 的 Linux 桌面应用中使用。不支持 X11 会话。
开启
打开 设置 > SnapShots,然后打开该功能。设置分两步:先允许捕获,再选择快捷键。每一步只显示你的桌面所需要的内容。稍后完成 会重新关闭捕获,但会保留你已经安装的内容,这样就可以从上次停下的地方继续。
- macOS 在设置过程中会请求屏幕录制权限。只有在 包含应用文本 打开时,才会请求辅助功能权限。
- Windows 不需要设置,也不需要权限。
- Linux 取决于你的桌面。参见 Linux 桌面。
关闭捕获会释放快捷键。这不会卸载你已经安装的助手程序或扩展。
进行捕获
切换到目标窗口,然后按下快捷键。macOS 和 Windows 上的默认方式是同时按下两个 Shift 键。T3 Code 会把图像附加到草稿,并把自身带到前台。如果没有打开的对话线程(thread),它会在当前项目(project)中开始一份草稿。
当 T3 Code 位于前台时按下快捷键,捕获的就是 T3 Code 自身。
待处理的捕获会留在磁盘上,直到附件保存到草稿为止。因此,即使中途关闭应用,捕获也不会丢失,并会在下次启动时附加上去。因图像过大而被拒绝的捕获会被丢弃。
更改快捷键
在设置中选中该快捷键,按下新的按键,然后选择 保存。在 macOS 和 Windows 上,可以使用一对修饰键,例如 Command+Command 或 Ctrl+Ctrl,也可以使用组合键。T3 Code 会拒绝与自身快捷键相冲突的快捷键,以及操作系统已经保留的快捷键。
在 Linux 上,请选择组合键;不支持修饰键对。在 Niri 和 Hyprland 上,快捷键写在你的合成器配置里,因此 更改快捷键 会重新打开设置,以便审阅这项更改。
包含应用文本
包含应用文本 控制捕获是否包含窗口的辅助功能数据。关闭之后,附件里就只有截图。在 macOS 上,这也会去掉对辅助功能权限的要求。
是否可用取决于具体应用。有些应用只暴露窗口控件,不暴露文档或终端中的内容。如果某个应用响应过慢,T3 Code 会附上不含这些数据的截图,而不是继续等待。
在 GNOME 上,浏览器可能需要先在桌面的辅助功能设置中启用应用辅助功能,才会暴露文本。启用之后请重启浏览器。
附件上、应用名称旁边的图标会表明是否包含了辅助功能数据。选中它可以查看捕获到的内容。
声音、闪光和动画
设置可以控制捕获声音、被捕获窗口上的短暂闪光,以及图像飞入草稿的动画。每一项都可以单独关闭。操作系统的减弱动态效果设置也会禁用该动画。
Linux 桌面
SnapShots 适用于 Wayland 会话。每个桌面提供捕获的方式不同;设置会标出你当前的桌面,并且只显示它所需要的内容。偏好设置会在各个桌面之间保留,但每个桌面的助手程序和快捷键批准是分开的。
GNOME。 请在设置过程中安装随附的 T3 Code SnapShots 扩展。它按用户安装,可以离线完成,并且不需要管理员密码。首次安装后请注销并重新登录,以便 GNOME 发现它,然后从设置流程中或从 GNOME 的扩展应用里启用它。如果 GNOME 已经禁用了全部用户扩展,请先在那里把它们打开。在 GNOME 的扩展应用中禁用或移除该扩展,即可撤销访问。
KDE Plasma 6。 请在设置过程中安装随附的捕获助手程序;不需要注销。如果快捷键没有触发,请在 系统设置 > 键盘 > 快捷键 中检查 T3 Code。如果在你的键盘布局上,使用 Shift 和数字的快捷键不起作用,请改用字母组合键。可以在 管理捕获 > 访问 > 高级 中移除该助手程序。
Hyprland 和 Omarchy。 请在设置过程中安装随附的助手程序,然后选择一个快捷键,并选择 审阅更改。T3 Code 会显示它将对你的 Hyprland 配置作出的确切更改。保存快捷键 只会写入这项更改,保留一份备份,并重新加载 Hyprland。如果出现屏幕共享提示,请为该助手程序批准它。在 Omarchy 上,请绑定在你自己的配置中,而不是随发行版提供的默认配置。某些 Hyprland 版本在捕获被阻止时,会返回一张 “access denied” 图像,而不是返回错误;请检查该助手程序的屏幕共享权限。
Niri。 请选择一个快捷键,并选择 审阅更改。T3 Code 会显示它将添加到你的 Niri 配置中的确切绑定,校验结果,保留一份备份,并在你批准后保存。Niri 会自行重新加载配置。该绑定需要 gdbus 命令(command),它通常是发行版所带 GLib 工具的一部分。从配置中删除这一行,即可释放该按键。
其他 Wayland 桌面。 当 T3 Code 能够捕获活动窗口时,它会使用桌面的截图门户。否则,设置会显示 仅手动捕获,快捷键会打开桌面的窗口选择器。通过选择器得到的捕获不包含辅助功能数据。
在 Wayland 会话中经由 XWayland 运行的应用仍然可以被捕获。