自动化
有些工作不需要你每次亲自发起:每天早上汇总代码变更、每周五整理发布简报、每月检查一次依赖风险。自动化 让 ZCode Agent 按你设定的节奏自己跑起来,跑完把结果留在会话里等你查看。
自动化下面有两类任务:
- 定时任务(Scheduled tasks):你指定时间和重复规则,到点自动执行。本页介绍。
- 闲时任务:不指定时间,排队等算力富余时免费执行。见 闲时任务。
在左侧边栏点击 自动化 即可打开管理页面。它属于当前项目的工作流,不在设置里——打开它不会影响左侧的会话列表,随时可以退回原来的会话。

创建定时任务
有三种方式,效果一致,选顺手的即可。
用表单创建
在自动化页面点击 创建定时任务,填写四样东西:
| 字段 | 说明 |
|---|---|
| 任务标题 | 用于在列表和历史里识别这个任务 |
| 执行计划 | 什么时候跑、多久跑一次,见下文 调度规则 |
| 指令 | 每次触发时发给 Agent 的内容,写清楚要做什么、产出什么 |
| 项目 / 权限 / 模型 / 推理强度 | 指令输入框下方的工具条,见下文 任务配置 |
在会话里创建
点击创建按钮右侧的箭头,选择 去会话中创建,输入框会预填一句示例,你可以直接改成自己的需求,例如:
每个工作日 9 点,汇总当前项目的代码变更和待跟进事项。
用这种方式创建的任务会 绑定到当前会话:后续每次触发都把结果投递回同一个会话,而不是每次新开一个。适合希望所有产出集中在一处的场景。创建成功后,会话里会出现一张任务卡片,点击「去到定时任务」可以直接跳到它的详情。
从模板创建
自动化首页提供四个现成模板,点击即可预填完整指令,改改就能用:
- 工作日晨会动态 — 汇总昨日进展与今日重点
- 每日风险扫描 — 检查代码库中的潜在问题
- 周五发布简报 — 整理本周变更,形成发布说明
- 周三文档同步检查 — 核对文档与代码是否脱节
这些模板都遵循同一套约束:只做只读分析、只使用可验证的仓库事实、证据不足时明确说明,不推测,也不修改代码。
调度规则
在执行计划里选择频率:每小时 / 每天 / 每工作日 / 每周 / 每月 / 自定义。
选择「自定义」会打开重复规则对话框,可以组合出更细的节奏:
| 维度 | 可选值 |
|---|---|
| 重复单位 | 分钟、小时、天、周、月、年 |
| 间隔 | 每 N 个单位执行一次,例如「每 2 小时」「每 3 天」 |
| 具体时点 | 周几、每月几号、几月份,以及具体的时和分 |
| 按日期或按星期 | 每月重复时,可选「每月 15 号」或「每月第三个周一」 |

确认后,调度栏会收起成一句简短摘要,点击摘要可以再次编辑。
重复次数与截止时间
定时任务默认无限重复。如果只想跑固定几次,或者希望到某个日期后自动停止,可以设置 最大运行次数 或 截止时间。达到任一条件后,任务进入「已完成」状态,不再触发。
关于时间:所有时间都按你电脑的本地时区计算。任务卡片上会显示下次运行时间——一个月以内显示相对时间(如「3 天后」),超过一个月显示具体日期。
任务配置
指令输入框下方的工具条决定这个任务以什么身份、什么能力执行:
- 项目:任务在哪个项目目录下运行。只能选当前窗口已打开的本地项目,创建后不可修改。
- 权限:和会话里一样的四档执行模式,决定 Agent 能不能自己动手改文件、跑命令。选了「完全访问」时界面会一直留一个橙色提醒。
- 模型:指定执行时使用的模型,留空则跟随项目默认。
- 推理强度:控制思考深度,留空则跟随项目默认。
因为定时任务在你不盯着的时候执行,权限选择尤其值得斟酌——需要 Agent 自主改代码就放开权限,只想要一份分析报告就保持只读。
管理与运行
立即运行
任务卡片菜单里的 立即运行 会马上执行一次。它不打乱原本的计划——下次运行时间、已运行次数、启停状态都不会因此改变。

如果上一次触发还没跑完,重复点击不会排第二条,界面会提示「上一条正在运行」。
暂停、编辑与删除
任务有四种状态:运行中、已暂停、已完成、失败。
暂停后任务保留但不再触发,卡片上的执行时间与运行次数会弱化显示,随时可以恢复。编辑时如果有未保存的改动,返回前会提示你确认是否丢弃。
运行历史
任务详情页顶部可以在 设置 / 历史 之间切换。历史里记录每一次触发的结果,包括执行中、成功、失败,以及因为电脑未唤醒而 跳过 的那些。有对应会话的记录可以直接跳转过去查看当时发生了什么。
需要注意的限制
电脑必须是唤醒状态。 定时任务在你的电脑上执行,机器睡眠或应用未启动时不会触发,错过的一次性任务会记为跳过而不是补跑。如果任务安排在夜间或午休时段,请在自动化页面打开 保持唤醒 开关——这是一个全局开关,定时任务和闲时任务共用。
最多 20 条。 这是跨所有项目的总数,暂停、已完成、失败的任务同样占用名额,只有删除任务定义才会释放。达到上限时新建会被拦下,需要先去清理不再需要的任务。在会话里让 Agent 创建时如果撞上上限,它会直接告诉你并停下,不会自作主张删掉你已有的任务。
只支持本地项目。 新建任务时只能选当前窗口打开的本地项目,远程工作区不在支持范围内(已有的远程任务仍可查看和管理)。手机端远程控制界面不显示自动化。