企业官网建设流程全解析

OmniAgent Hyper-Harness超级脚手架：Sentinel规划+Guardian守卫+动态并发，复杂任务执行的完整设计

【免费下载链接】OmniAgentAn agent capable of self-evolving and dynamically hardening security项目地址: https://gitcode.com/gh_mirrors/om/OmniAgent

OmniAgent是一个开源的自我进化 Agent 框架，其核心模块Hyper-Harness 超级脚手架专为高效、安全地执行复杂任务而生。它由三大能力组成：Sentinel 规划 Agent负责把多步骤任务拆解成结构化里程碑，Guardian 守卫 Agent为高风险操作装上安全闸门，动态并发工具执行则把串行等待变成并行加速。三者协同，让 Agent 在面对长链路、多文件、高风险任务时既快又稳。本文带你完整看懂这套设计。

为什么需要 Hyper-Harness 超级脚手架

普通 Agent 执行复杂任务时常遇到三个问题：任务太大没头绪、操作风险没把控、工具串行太慢。Hyper-Harness 正是针对这三点打造的高效、安全、智能执行引擎，在 README.md 中被称为 "An efficient, safe, and intelligent execution scaffold"。

它的三大支柱一一对应上面的痛点：

想深入了解整体架构，可阅读 README.md 中的架构图与 omniagent/agents/ 目录说明。

Sentinel 规划Agent：如何为复杂任务拆解里程碑

Sentinel（哨兵）是一个轻量级规划 Agent，它只负责思考和验证，不执行任何工具。它把一个大任务拆成若干里程碑，逐个跟踪进度，实现"先规划、后执行"。源码位于 omniagent/agents/sentinel.py。

Sentinel 何时自动激活

Sentinel 不会为每个任务都启动，而是满足以下任一条件才激活，避免无谓的 LLM 开销：

1. 多步骤关键词：任务描述中出现 "然后 / 接着 / 之后 / finally" 等词达到阈值（默认 ≥2 次）
2. 反思连续失败：主 Agent 连续反思失败达到阈值（默认 ≥2 次），说明任务确实棘手
3. 目录跨度大：Bash 操作涉及多个不同目录（默认 ≥3 个），说明任务横跨多个工作区
4. LLM 复杂度估算：以上规则都未触发时，用一次轻量 LLM 调用判断任务是否需要规划

提示：如果任务能匹配到某个已有Skill，Sentinel 会直接判定"无需规划"，因为技能已能处理，避免重复拆解。

里程碑拆解与进度跟踪

一旦激活，Sentinel 会调用 LLM 把任务拆解成有序的里程碑列表（每个含描述、成功标准、依赖项），并遵循"少而大"原则——优先生成少量有意义的大里程碑，而非一堆零散小步骤。

它还会做两件关键的事：

• 进度验证：每完成一个里程碑，用 LLM 对照"成功标准"验证是否真正达成，而非盲目推进。
• 跨会话恢复：计划会以 JSON 持久化到.omniagent/sentinel/目录，即使会话中断，下次也能从中断处继续。

相关参数可在 omniagent/config/models.py 的SentinelConfig中调整，例如max_milestones（最大里程碑数，默认 10）。

Guardian 守卫Agent：高风险操作的安全闸门

如果说 Sentinel 管"想清楚"，Guardian（守卫）就管"别闯祸"。它是一个轻量级审查 Agent，在高风险操作执行前介入，提供静态策略之上的 LLM 深度审查。源码位于 omniagent/agents/guardian.py。

三重触发条件

Guardian 满足以下任一条件即被激活：

1. 高风险 Bash 命令：命中 ToolPolicy 高风险级别或内置的高危模式（如rm -rf /、sudo、mkfs、dd of=/dev/、curl | bash管道远程脚本等）
2. 文件写入累积：单轮响应中的文件写入/编辑操作达到阈值（默认 ≥3 次）
3. 风险操作后的最终响应：完成一连串风险操作后，对最终回复做一次复盘

LLM 深度审查与风险分级

触发后，Guardian 做三件事：

• 执行前审查：在执行前就拦截常见错误（路径写错、缺失导入、意外副作用）
• 风险标注：给操作打上low / medium / high / critical风险等级
• 自我修正建议：不只简单拦截，而是给出具体的修复建议

尤其值得称道的是：当命令会执行某个脚本文件时，Guardian 会读取脚本内容进行深度审查，专门揪出命令本身看不出、却藏在脚本里的危险操作（如find ... -exec rm、递归删除、数据外传）。一旦判定为critical，配合auto_block_on_critical会自动拦截。

只读命令（ls、grep、cat等）会被自动跳过审查，既安全又不拖慢速度。

动态并发工具执行：把串行等待变成并行加速

传统 Agent 往往"一个工具跑完再跑下一个"，长链路任务因此很慢。OmniAgent 的动态并发工具执行自动解析工具间依赖，把"串行等待"变成"异步并行"。核心实现在 omniagent/agents/reflexion.py 的_execute_actions方法中。

它的分流逻辑非常清晰：

• 并行批：相互独立、只读的工具（如读取、检索类）→ 用asyncio.gather并行调用
• 串行队列：有依赖或会改变状态的工具（如bash、写入、编辑）→按顺序串行执行，保证安全

这样既拿到了并行的速度，又不会因并发写而产生竞态。你可以用enable_parallel_execution开关控制该能力，并会记录parallel_batches、parallel_tools等统计信息，方便观察加速效果。

三者协同：一条复杂任务的完整执行路径

把三块拼起来，一次复杂任务的执行流大致是这样的：

1. 入口判断：任务进来，Sentinel 评估复杂度——简单任务直接放行，复杂任务则拆解里程碑。
2. 执行阶段：每个里程碑内的工具调用走动态并发，独立只读工具并行、写操作串行，长链路显著提速。
3. 安全把关：其中任何高风险操作都会触发Guardian审查，风险过高则拦截并给出修正建议。
4. 进度推进：Sentinel 验证里程碑达成后推进到下一里程碑，直到全部完成或跨会话恢复。

这套"规划 + 并发 + 守卫"的组合，正是 Hyper-Harness 相对单循环 ReAct 架构在任务成功率上的核心优势。

快速上手：安装与启动 OmniAgent

只需 Python 3.11+ 和一个 LLM API Key 即可体验完整能力：

pip install -e . omniagent onboard # 交互式配置：选择模型供应商、填入 API Key omniagent chat # 终端交互 omniagent serve # 启动 Web UI → http://127.0.0.1:18790

配置分层为 默认值 →~/.omniagent/config.yaml→ 环境变量，Sentinel 与 Guardian 的相关阈值都可在config.yaml中按需调整。

模块路径索引

• 规划 Agent：omniagent/agents/sentinel.py
• 守卫 Agent：omniagent/agents/guardian.py
• 反思循环与动态并发执行：omniagent/agents/reflexion.py
• 配置模型（SentinelConfig / GuardianConfig / 并发开关）：omniagent/config/models.py
• 整体架构与对比表：README.md

Hyper-Harness 超级脚手架用"规划、并发、守卫"三件套，把复杂任务从"慢且险"变成"快且稳"——这正是 OmniAgent 作为自我进化 Agent 框架在执行层给出的完整答案。

【免费下载链接】OmniAgentAn agent capable of self-evolving and dynamically hardening security项目地址: https://gitcode.com/gh_mirrors/om/OmniAgent