workbuddy多阶段任务中途失败后可仅重试失败步骤并接续,前提是启用plan/craft模式、标注多阶段、开启产物保留与每步检查点写入,并配置step级重试策略(指令前缀/yaml/retry参数)。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当WorkBuddy执行多阶段任务(如网页抓取→数据清洗→图表生成→PDF导出)中途某一步失败,你不想让整个流程从头跑起,而是只重试失败那一步并接续后续——这需要启用检查点恢复机制并正确配置重试策略,否则前序产物将被丢弃、状态记录被清空。
确认任务支持检查点恢复
打开任务列表,找到目标任务,点击右侧「详情」→查看「执行模式」字段。只有显示为【Plan 或 Craft 模式】的任务才具备检查点能力;Ask 模式任务无中间产物,失败即全量重来。
再向下滚动到「任务类型」栏,确认标注为【多阶段任务】(含明确的阶段拆分,如“调研→处理→生成”)。单阶段任务不触发检查点逻辑,即使配置了产物保留也无效。
若两项均满足,继续下一步;任一不满足,请先在新建任务时选择Plan模式,并在提示词中用“第一步…第二步…”显式分段。
启用产物保留与检查点写入
在任务编辑页 → 「高级设置」区域 → 找到「产物保全策略」开关,勾选「启用阶段产物自动保存」。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表,就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
该选项默认关闭。不开启则每个步骤执行完立即清理临时文件,中断后连日志都找不到,更无法判断哪一步失败。
下方「检查点写入频率」下拉选「每步结束后」。若选「仅最终结果」,则只有最后一步完成时才落盘,前面所有步骤失败都会丢失上下文。
配置失败步骤精准重试
方法一:使用内置重试指令前缀(推荐用于临时调试)
在原始任务提示词最开头插入:
--retry=2 --timeout=60s --fallback=skip_step
注意:--fallback=skip_step 表示主模型失败后跳过当前步骤,直接进入下一步——前提是下一步不依赖本步输出;若强依赖,请改用 method 二。
方法二:在Skill YAML中绑定step-level重试逻辑(适用于长期稳定运行)
1、定位对应Skill的YAML文件(路径通常为Skills/your_skill_name/skill.yaml)
2、在需重试的step节点下添加retry策略块:
```yaml
- name: "提取PDF文本"
action: "pdf_ocr"
retry:
max_attempts: 3
backoff_seconds: 5
on_failure: "log_and_continue"
```
【max_attempts设为3以上才可能覆盖网络抖动类瞬时失败】
3、保存后在WorkBuddy技能管理页点击该Skill右侧「重新加载」
方法三:通过JSON手动注入step级重试参数(适合无法修改YAML的官方Skill)
关闭WorkBuddy → 打开%APPDATA%\WorkBuddy\config.json → 在根对象内添加:
"step_retry_policy": {"default_max_attempts": 2, "backoff_base": 3}
重启生效。此配置对所有未显式声明retry的step生效。










