定时任务

定时任务用于周期性重复的工作：交给 AI 自动执行，不必每次重新交代。

入口：设置 → 开发 → 定时任务。托盘菜单里也有「暂停全部定时任务」和「N 处改动待确认」的快捷入口。

触发方式

新建任务时，计划一栏提供这些预设：

预设	含义	对应的 cron
每小时	整点执行	0 * * * *
每天 09:00	每天固定时间	0 9 * * *
工作日 09:00	周一到周五	0 9 * * 1-5
每周一 09:00	每周一次	0 9 * * 1
一次性	指定某个时刻执行一次	—
事件触发	不轮询，由事件唤醒	—
自定义	直接写 cron 表达式	任意

事件触发有两种：

事件	匹配条件	说明
本机后台进程退出	命令或输出文件路径的片段	适合「编译跑完自动整理结果」
工作区文件变化	相对工作区的路径模式：*.py、src/、src/**，可逗号分隔多个	监听的是这个任务自己的工作区

同一任务两次触发之间有 15 秒冷却，避免一次保存触发多次。

文件变化的监听范围跟着任务绑定的工作区走，不是你当前打开的项目。想让「改项目就触发」，建任务时把工作区指到那个项目。

只读档与可写档

档位	能做什么	结果去哪
只读（默认）	查询、分析、总结	直接作为任务结果
可写	写文件、编辑文件、新增文件	在隔离副本里改，改完进收件箱

• 只读档在真实工作区上运行，可用工具限定为：读文件、搜索、符号查询、只读 Git、联网检索、记忆与技能清单。写入类、终端类、mcp__ 与插件工具一律拒绝。
• 可写档只多了「写文件 / 编辑 / 新增」三个工具；删除、终端、测试运行、MCP、插件工具仍然拒绝。
• 隔离副本包含你当前未提交与未跟踪的文件（基于检查点保存的工作区状态）；复制上限为 20,000 个文件 / 300 MB。

收件箱里的 diff

• 改动以补丁形式保存；单个文件超过 2 MB 时不保存，也不会进入收件箱；
• 点「应用」才写回真实工作区，写入前会做路径越界检查、禁止写 .git 等目录；
• 如果某个文件在任务跑完之后你自己又改过，这一条会被跳过并提示，保留你的版本；
• 点「丢弃」什么都不发生。

命令动作

任务还可以配一条命令（只在可写档可用）：在隔离副本里执行，输出喂给 AI 继续分析。命令本身产生的文件改动不进待审 diff。

预算与上限

限制	默认	可调范围
单次积分预算	20 积分	按任务设置
单次工具调用数	50 次	1–200
单次最长运行时长	30 分钟	—
每日积分上限	200 积分/天（所有任务共用）	可给单个任务再设上限
执行次数 / 到期时间	二选一	事件触发的任务必须填一个

触发上限时任务正常停止并记录原因，不会静默卡死。每次执行都会留下记录：开始时间、耗时、结果摘要、消耗积分。

什么时候会执行

• 只在应用运行时执行。点 × 默认最小化到托盘，此时任务照常跑；「设置 → 常规 → 关闭窗口时」选「直接退出应用」后，定时任务随之停止。
• 同一时间只跑一个任务；你有 AI 对话正在跑时，这次触发会跳过。
• 电脑睡眠唤醒后，只补最近错过的一次；错过超过 7 天则只推进计划、不补跑。
• 上次应用退出时正在运行的任务，下次启动会标记为「被中断」，不会接着跑。

管理

操作	位置
新建 / 编辑	设置 → 开发 → 定时任务 →「＋ 新建定时任务」
暂停某个	任务行右侧开关
暂停全部 / 恢复全部	托盘菜单
查看历史	点任务名，列出每次执行的时间与结果
总开关	页面顶部的「定时任务总开关」

常见问题

Q：定时任务会消耗积分吗？ 会，按 token 扣减，和执行一次普通对话一样。单次预算和每日上限就是用来控制这部分开销的。

Q：写档任务改坏了怎么办？ 它改的是隔离副本，应用之前你的工作区没被动过。应用之后如果发现不对，用源代码管理的检查点回退。

Q：任务能调用插件或 MCP 吗？ 不能。定时任务只使用内置的读写工具，插件与 MCP 工具不在其可用范围内。

Q：为什么这次没跑？ 看任务历史里的跳过原因：应用没开、上一个任务还在跑、你有对话正在进行、每日积分用完，都会写进记录。