MadoHub Docs

Agent 检测

MadoHub 如何识别正在运行的 AI Agent 并追踪其状态。

MadoHub 会实时监控终端输出,识别当前运行的是哪个 AI Agent,以及它处于什么状态。这个能力支撑了图块标题栏上的可视化指示器,以及路由连接的触发逻辑。

支持的 Agent

Claude Code

通过终端输出中的 Unicode 标记进行检测:

标记含义
❯ (U+2770)Claude Code 提示符
✽ (U+273D)思考/加载指示器
⏺ (U+23FA)工具使用指示器

同时也会匹配输出中的字面字符串 "Claude Code"。

OpenAI Codex CLI

通过常见的 CLI 特征签名进行检测:

  • OpenAI Codex — 品牌行
  • codex> — TUI 提示符
  • openai/codex — 包引用
  • codex v[0-9] — 版本字符串
  • > _ OpenAI Codex — 启动横幅
  • 模型执行标识与参数特征

Amp 和 OpenCode

Amp 和 OpenCode 会话通过原生工作区进程自省机制自动识别,确保覆盖你日常工具链中的各类 CLI 会话。

通用 shell

如果没有检测到任何 Agent 标记,终端会被当作高性能标准 shell 会话处理。

Agent 状态

MadoHub 持续追踪每个终端的七种生命周期状态:

状态状态说明可视效果
WorkingAgent 正在积极生成代码、推理思考或调用工具绿色脉冲边框
IdleAgent 处于就绪状态,等待新的用户提示词标准边框 / 无特殊高亮
WaitingAgent 需要人工审批权限或操作确认橙色高亮边框
Stopped执行暂停或单轮任务运行完毕红色指示器
Completed任务已确认成功完成绿色成功指示器
Failed执行由于错误而中断红色错误指示器
Exited底层终端会话已退出灰色/暗淡指示器

MadoHub 结合实时终端数据流解析与底层结构化会话验证,确保活动、等待与完成状态之间的流转即时且准确。

智能完成检测

AI 编程 Agent 在不同版本中会使用多样化且持续演进的输出习惯来标记任务结束。MadoHub 摒弃了僵硬的静态关键词匹配,采用自适应模式识别引擎,精准捕获各类 Agent 版本的单轮任务达成节点。

当确认任务完成时:

  1. Agent 图块的可视化指示器会即刻更新以反映最新状态。
  2. 若开启了环境通知,系统会通过边缘微光动效与提示音给予即时反馈。
  3. 自动化路由触发器会立即激活,将生成产物与上下文顺畅流转给下游连接的 Agent。

On this page