适用范围
入口
- 侧栏「新对话」按钮,或
⌘N。 ⌥⌘O:打开新对话页并选中「不在任何项目中」。- 侧栏项目行悬停时的「+」,或项目页的「在此项目新建任务」:打开新对话页并预选该项目。
⌘ 换成 Ctrl、⌥ 换成 Alt(下同)。
新对话页的组成
会话在项目当前的工作目录里开始,新对话页没有分支选择。
使用步骤
- 点击「新对话」。项目默认是「不在任何项目中」。
- (可选)选一个项目。
- (可选)选择运行环境:「云主机」或「在你的设备上执行」下的某台设备。
- (可选)调整权限、模型与智力。
- 写下要做的事(也可以只发附件),按
Enter发送(Shift+Enter换行)。 - 侧栏出现这条会话,会话建好后自动进入会话页,Agent 开始工作。
选择项目
点项目按钮(⌥⇧⌘O)打开菜单,可以搜索项目、选择项目、「新建项目」或「不在任何项目中」;新对话页里还可以用 ⌥⌘1–⌥⌘9 直接选第 1–9 个项目。
- 每个项目下有一行来源小字,例如 GitHub 仓库名、「本机 · 文件夹名」;还没配置完的项目显示「正在配置 · 尚未完成」。
- 在别的电脑上的本地项目也可以选,会话会在那台设备上执行;设备离线时标「设备离线」。
- 新对话页不记住上次选的项目:每次点「新对话」都回到「不在任何项目中」。
不在任何项目中
不在任何项目中的会话不关联项目,在一个临时工作目录里运行,适合问答、写一段脚本、整理资料等。它在侧栏的「对话」分组里,之后可以移进项目,见 消息与会话操作。选择运行环境
运行环境决定 Agent 在哪台机器上读写文件、运行命令。Agent 本身始终在云端:- 默认是「云主机」;本地项目默认在项目所在的那台设备上执行。
- 不能选的设备会置灰并写明原因(如「设备离线」「未允许执行」)。
- 执行设备在新建会话时选定,之后不能更换;要换设备请新建会话。
选择权限
权限决定 Agent 执行操作前要不要先问你。点输入框左下角的权限按钮(Ctrl+Shift+S):
- 新会话默认是「完全访问」,每次都从默认开始,不记住上次的选择。
- 在设备上执行时,权限不能超过该设备的「权限上限」,超出的档位置灰;上限在那台设备客户端的「机器与授权」里修改。
- 已开始的会话里也可以随时改权限;修复任务、已归档的会话不能改。
- 需要你批准时怎么处理,见 需要你处理。
开启完全访问的确认
在设备上执行时切到「完全访问」,会弹出「开启完全访问?」,说明 Agent 将可以运行命令、访问互联网、创建和修改任何文件且不再征求你的同意,并提示敏感数据丢失或泄露、提示注入等风险(包括 Agent 可以读取本项目的全部密钥)。点「确认」才切换;点「取消」或按Esc 保持原权限。
选择模型与智力
输入框右下角是模型按钮和智力按钮。新会话默认沿用你账号的默认选择或上次新建会话时的选择。完整说明见 Harness 与模型。发送前的确认
以下弹窗只在第一次出现,点「取消」都不会发出消息,文字和附件留在输入框里。默认使用完全访问(第一次以完全访问发送)
弹窗「默认使用完全访问」说明 Agent 可以直接执行命令、安装依赖、修改云端环境里的文件、访问互联网和已连接的服务、读取本项目全部密钥,并提示可以随时在输入框左下角切换成「请求批准」或「替我批准」。点「知道了,开始任务」发出,之后不再出现。云主机管理员权限(第一次在云主机上发送)
云主机管理员权限处于开启状态时,第一次在云主机上发起会话会弹出「开启云主机管理员权限」,提示:- Agent 在云主机上拥有管理员权限,云主机里保存的凭据可以被读取。
- 审批和分支限制只是建议,不再强制。
- 关闭不会撤销已经做过的改动;误改系统文件可能需要重建云主机。
规则与状态
其他报错见 错误与恢复。