什么是Smart Wake
Smart Wake 是一个专为防止子代理（subagent）超时导致任务中断而设计的智能恢复机制。它通过结合检查点（checkpoint）保存、定时唤醒（cron wake）和会话生成恢复（session spawn with resume context）三大核心能力，确保长时间运行的任务在遭遇系统限制或意外中断时能够无缝续接，避免重复工作和数据丢失。该工具特别适用于那些需要持续执行、可能跨越多轮对话或长时间等待的场景，例如夜间批处理、复杂数据爬取、多阶段分析流程等。其设计遵循严格的审计原则，每次唤醒都携带明确的上下文与状态信息，使整个执行过程具备完整的可追溯性。
核心功能特点
- 自动保存任务状态至检查点，支持细粒度进度记录与断点续传
- 基于网关 cron 的定时唤醒机制，可在预设时间自动重启任务
- 通过 sessions_spawn 实现带上下文的会话恢复，精准跳过已完成步骤
- 强制要求任务 ID 和标准化状态契约，保障跨会话一致性
- 内置防循环与重试控制，限制最大唤醒次数以防止资源浪费
- 完成或失败时自动清理相关定时任务，维护系统整洁
适用场景
Smart Wake 最典型的应用场景是那些运行时间超过默认子代理超时阈值的长期任务。例如，一个需要连续数小时进行网页抓取并清洗数据的爬虫项目，若未启用 Smart Wake，一旦触发超时就会被强制终止，导致大量已获取内容丢失。借助该机制，系统会在接近超时时自动保存当前抓取进度（如已访问页面列表、导出文件路径），并通过后台 cron 任务在几分钟后再启动新会话，从上次停止处继续执行剩余页面采集。另一个常见用例是多步骤工作流，比如市场调研报告生成：第一步收集公开资料，第二步去重整理，第三步撰写初稿。即使中间某一步因网络延迟或 API 限流暂停，Smart Wake 也能确保后续环节准确接续，无需从头开始。此外，对于需要在非工作时间（如凌晨）运行但希望次日继续推进的任务，该机制同样适用——只需配置合理的唤醒间隔，即可实现无人值守的持续作业。