企业官网建设流程全解析

告别盲目重试：PhyAgentOS Planner主导的失败恢复与PlanRevision机制指南

【免费下载链接】PhyAgentOS-corePhyAgentOS is a Recursive Self-Improving (RSI) physical agent operating system that enables agents to recursively self-improve through agentic workflows.项目地址: https://gitcode.com/gh_mirrors/ph/PhyAgentOS-core

PhyAgentOS 是一个递归自改进（RSI）的物理 Agent 操作系统，让 Agent 通过自主工作流不断自我进化。在具身任务（机器人操作、物理仿真）中，一次失败往往意味着真实世界的副作用。PhyAgentOS 用Planner 主导的失败恢复与PlanRevision 追加修订机制，让 Agent 不再"原样重试"，而是带着失败证据重新规划——这正是告别盲目重试的关键。

为什么"盲目重试"在物理世界里很危险？

软件世界里"失败了再跑一遍"常常无害，但物理 Agent 不一样：机械臂可能已经碰翻杯子、传送带可能已经停摆。PhyAgentOS 把事实分成三类，各司其职：

💡 关键设计：Action 被"接纳"不等于完成；超时或unknown结果不能证明物理执行已停止，也不能作为盲目重试的依据（见 docs/zh/01-framework-introduction.md）。

PlanRevision：计划的"追加式世代账本"

PlanRevision 是 PhyAgentOS 失败恢复的核心数据结构。它的规则很直观：

• 只追加、不重写：任务内每一代计划（revision）都是不可变的，历史执行记录与验证尝试永远可追溯；
• 任务身份稳定：恢复始终发生在同一个task_id上，而不是偷偷创建新任务；
• 有预算、有期限：重规划次数受max_replans限制，且受replan_deadline截止时间约束，防止无限循环。

核心定义见 PhyAgentOS/forge/task.py，其中每个修订代都携带自己的reason（为什么改计划）、执行记录和验证判定。

失败后会发生什么：Planner 主导的恢复流程

当验证器判定当前计划走不通，恢复流程分三步走：

1. 判定replan_required：在recovery验证模式下，验证器发现目标"仍有希望达成"但未满足成功标准时，返回replan_required判定，并附带上未满足的 criteria、保留约束和证据引用（判定协议见 PhyAgentOS/verification/service.py）；
2. 任务进入awaiting_replan状态：任务暂停在原地，等待重规划，而不是继续硬着头皮执行；
3. Planner 开启新一代 PlanRevision：调用begin_revision后，Planner 会接收四类信息——未满足的标准、需要保留的约束、指导信息与证据引用、截止时间，然后重新选择工具，生成分数递增的新修订代。

这个状态机可以概括为一行：

executing ── recovery verdict ──► awaiting_replan ── begin revision ──► executing

begin_revision的三重安全阀（状态必须是awaiting_replan、未超过重规划预算、未超过截止时间）实现于 PhyAgentOS/forge/task.py。任何一条不满足，任务就会干净利落地转入失败终态，而不是无限重试。

四档验证模式：recovery 模式如何启用？

只需在任务验证契约里把mode设为recovery，并给出目标与至少一条成功标准，即可获得完整的失败恢复能力。完整配置项参考 docs/zh/04-forge-configuration-reference.md。

恢复经验不白来：失败会沉淀为 Lesson

失败与成功一样有价值。ExperienceCoordinator 会把每次 AgentTask 的修订代判定、验证尝试与证据归入一条脱敏的"任务经历"（task episode）：

• 最终失败或replan_required→ 可形成工作流相关的失败观察；
• 失败重规划后最终成功 → 标记为mixed，同时沉淀恢复工作流经验与失败观察；
• 沉淀的 Lesson 是通用的"恢复原则"，不含具体坐标、对象名等敏感细节，且不会绕过验证器。

详见 docs/zh/05-agent-experience-and-skill-evolution.md。

核心文件速查

• 任务聚合与 PlanRevision：PhyAgentOS/forge/task.py
• 重规划工具入口：PhyAgentOS/agent/tools/forge_task.py
• 验证服务与判定协议：PhyAgentOS/verification/service.py
• 开发者手册（恢复机制章节）：docs/zh/03-developer-manual.md
• 框架总览（状态机与三类事实）：docs/zh/01-framework-introduction.md

小结

PhyAgentOS 的失败恢复哲学可以浓缩成一句话：失败不是重来的信号，而是重新规划的输入。PlanRevision 用追加式账本保留了每一代计划的完整历史，recovery 验证模式让 Agent 在证据不足时果断停下，Planner 则拿着未满足标准与证据重新决策。对于正在构建物理 Agent 的团队，这套机制是避免"在真实世界里撞南墙撞一百次"的实用答案。

【免费下载链接】PhyAgentOS-corePhyAgentOS is a Recursive Self-Improving (RSI) physical agent operating system that enables agents to recursively self-improve through agentic workflows.项目地址: https://gitcode.com/gh_mirrors/ph/PhyAgentOS-core