深度集成

安全操作确认

ZCode 会把 ZCode Agent 的权限控制放在任务界面里。执行模式选择器位于输入框附近,用户可以根据任务风险决定 Agent 的执行方式。

这套机制的核心是:在允许执行前,先看清 Agent 准备做什么。对于命令、文件改动、网络访问、脚本执行等操作,ZCode 会在任务里展示对应内容;如果进入高权限或全自动模式,工具栏会持续显示风险提示。

ZCode Agent 权限模式

ZCode Agent 是 ZCode 自研的主 Agent。它与 GLM 5.2 系列模型适配更紧,长任务和多步骤开发任务更适合从这里开始。

ZCode Agent 权限模式

执行模式共四档,聊天输入框聚焦时按 Shift + Tab 可以快速循环切换:

模式说明适合场景
变更前确认每次修改文件或执行命令前都先确认,也是默认档位。关键代码、生产配置等高风险改动。
自动编辑文件编辑自动执行,命令等操作仍需确认。常规迭代开发。
计划模式先制定计划,确认后再开始实施。重构、迁移、长任务。
完全访问尽量自动执行,减少确认。已确认上下文可信、希望连续执行的任务。

工作流程

  1. 触发确认:Agent 发起需要授权的操作时,当前任务会暂停,输入区也会进入阻塞状态,避免继续追加新的执行要求。
  2. 弹出请求:界面会展示 Agent 计划执行的具体命令、文件改动或工具调用内容。
  3. 用户决策:确认后 Agent 才会继续执行;拒绝后会中止本次操作或回到可调整状态。
  4. 任务同步:权限请求属于当前任务。切换任务后再回来,确认状态仍会保留;侧边栏也会显示等待确认状态。

决策选项

选项说明建议场景
允许仅授权 Agent 执行当前这一次操作。临时或不确定的单次任务。
始终允许授权当前及后续同类型操作,无需再次询问。操作安全可信且需要高频执行,例如常规编译。
拒绝禁止 Agent 执行当前操作。发现指令、路径或风险不符合预期。
始终拒绝禁止当前及后续同类型操作。明确不希望 Agent 执行的某类操作。

部分场景下还会出现 允许本会话始终允许本项目 等更细粒度的选项,按需选择即可。


提问超时自动继续

除了权限确认,Agent 有时会主动问你一个选择题(比如「用方案 A 还是方案 B」)。这类提问默认带 5 分钟倒计时,快到时间时面板上会显示剩余时长。到点还没人回答,Agent 会按自己的判断挑一个方向继续推进,这一步在历史记录里标记为「未回答,已自动继续」。

只要你有任何动作——鼠标移到问答面板上、开始选择、点击秒数、或在侧栏点「停止计时」——倒计时就会 永久停止,安心思考即可。

不希望它自动继续,可以在 设置 → 常规 → 提问自动继续 关掉,之后所有提问都会一直等你回答。注意这个开关不可追溯:关闭期间产生的提问,即使之后重新打开也不会恢复计时。

倒计时只作用于这类普通提问,权限请求和计划审批本来就会一直等待,不受影响。


常见场景

  • 运行第三方脚本:Agent 尝试运行项目中的 Python、Shell 或 Node.js 脚本。
  • 网络请求:Agent 需要通过 curl 或其它方式访问外部 API。
  • 文件改动:Agent 创建、编辑、删除或重命名文件。ZCode 会在任务结果中展示文件改动摘要,并提供打开和撤销入口。
  • 系统级命令:执行可能修改系统配置、安装依赖或删除文件的命令。

使用建议

  • 在允许执行前,仔细阅读即将执行的命令、路径和文件名。
  • 不确定时优先用 允许,不要直接用 始终允许
  • “始终允许”和完全访问模式都会减少后续确认,请只在确认安全可信时使用。
  • 大改动优先使用“计划模式”,先确认方案,再开始实施。

下一步