返回资讯中心
外部精选
软件工程
#开发者实时流

Paneflow 0.19.0 改用 OSC 7501 让 Agent 自行上报状态

来源标题:Agent status in Paneflow: from screen rules to OSC 7501

Paneflow 0.19.0 起,侧边栏的 Agent 轮次状态只由 Agent 通过终端 OSC 7501 序列自行声明,不再靠外部识别屏幕内容猜测。该机制覆盖 Claude Code v2.1.295 及 Codex(10 月合并支持);未声明状态的 Agent 不会显示轮次状态。

Hacker News 最新arthurjean2026/11/3 · 14 天前30 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

从 Paneflow 0.17.7 开始,侧边栏获取 agent 的回合状态只从一个地方来:agent 写入自己终端的状态。当 agent 因等待权限而停下时,它会写入这样一段序列(示例来自规范):

ESC ] 7501 ; state=blocked:kind=permission:app=terraform:msg=QXBwbHkgMyB0byBhZGQs... ESC \

通常的假设是,运行 agent 的工具必须从外部观察它们:匹配 spinner、识别权限提示、留意输入框重新出现。我实现过这套方案,做了好几次,然后又把它删掉了。我现在的立场是:回合状态属于 agent,它是唯一真正知道该状态的一方;终端的工作是原样传递这一声明,而不是去猜测。

这就是 Paneflow 0.19.0 中交付的内容。它覆盖了发出 OSC 7501 的 agent:从 v2.1.295 起的 Claude Code,以及 Codex——后者在十月通过 openai/codex#52725 和 #54114 合并了支持。不声明任何状态的 agent 不会获得回合状态,这是有意为之。

本文跟随一个 Claude Code 回合,从 agent 一路走到侧边栏;然后介绍通用形态、此前尝试过的六种方案、它的成本,以及最有力的反对意见。

如果你读过 Mitchell 关于该协议的文章,可以跳过本节。

Mitchell Hashimoto 于 2026 年 10 月 6 日发布了 Program Status Protocol,称其为“一个完全通用、终端原生的规范”,它出自他在 Superlogical 和 Ghostty 上的工作(他的文章)。程序写入 OSC 7501,键值对之间用冒号分隔:

程序用 OSC 7501 ; ? 请求支持。没有心跳。当 shell 提示符返回(OSC 133 A)或程序退出时,终端会丢弃 working 和 blocked;done 和 error 会保留,直到终端决定隐藏它们,例如在下一个按键时。

有两个特性对 Paneflow 很重要。状态来自唯一知道它的那个进程。而生命周期规则意味着终端永远不必让状态超时。

让我们跟随一个回合,穿过涉及的三个进程:拥有 PTY 的会话宿主、负责归约状态的 worker,以及桌面窗口。

Paneflow 的应答方式与 Ghostty 相同。宿主启动每个 shell 时都设置 TERM_PROGRAM=ghostty(spawn_env.rs),其终端引擎是 libghostty-vt。当 Claude Code 询问终端是否支持该协议时,引擎回复:

ESC ] 7501 ; ? : states=idle,working,done,blocked,error : kinds=permission,question,auth ESC \

宿主看到这条回复发往 PTY,就把该会话标记为 program_status_capable。只有宿主会应答。桌面端也嵌入 libghostty 用于绘制,但没有安装 OSC 7501 回调,因此 agent 永远不会收到两个回复;一个名为 desktop_terminals_neither_answer_nor_report_program_status 的测试保证了这一点。

你提交一个提示,Claude Code 写入 state=working。这些字节经过同一个 libghostty 解析器——它本来就在维护网格,因此 Paneflow 无需再扫描一遍。libghostty 把解析出的状态交给回调,宿主的事件循环将其转成一条记录:

ghostty::BackendEvent::ProgramStatus(report) => { self.program_status.apply(report); self.program_status_capable = true;

一个宿主线程每 500 ms 遍历一次会话,跳过没有新内容的会话,只在声明发生变化时才把当前声明写入会话的 manifest。worker 通过推送流跟随宿主。

worker 负责归约。paneflow-serve 位于宿主和所有客户端之间:桌面端、paneflow CLI、MCP bridge。它首先检查会话运行的是已知 agent,然后映射声明。这就是整个状态机(state.rs):

fn declared_verdict(&self) -> (Status, ActivitySource) { let Some(declared) = self.agent_declaration() else { return (Status::Idle, ActivitySource::None); }; let running = self.lifecycle.is_running(); let status = match declared.state.as_str() { DECLARED_ERROR => Status::Errored, DECLARED_WORKING if running => Status::Busy, DECLARED_BLOCKED if running => Status::Attention, _ => Status::Idle, }; (status, ActivitySource::Declared)

没有任何定时器、hook 或响铃来驱动它。已退出的进程永远不会是 busy 或 waiting,而 error 会在退出后继续存在。归约状态每次变化都会递增 state_seq 计数器,paneflow wait --idle 和 paneflow send --submit 跟随的就是它。

Claude Code 请求权限。它写入 state=blocked:kind=permission,问题放在 msg 中。worker 将会话移到 Attention,并且由于这是进入 Attention 的状态转换,它会决定发出一条携带该消息的“Needs input”通知。桌面端只决定你是否已经把该窗格放在眼前。该行显示 Need you,并移到侧边栏 Agents 区域的顶部。

回合以 state=done 结束。worker 发布一条“Finished”通知,并把会话标记为未读。该行显示 Done,直到你打开该标签页。宿主会保留 done 记录,直到你在窗格中输入;由 paneflow send 或 MCP write_pane 工具发送的文本不算作输入。

每个进程各司其职。宿主负责解析并保存记录,但有边界:每个会话 256 条记录;当待处理状态事件的突发超过 256 KiB 时,它会清空一切,而不是保留一个不完整的状态。worker 负责归约并决定通知,重启时从 manifest 重建每个会话。桌面端渲染从推送流接收到的内容,并将唤醒合并。

agent 声明的内容,以及你看到的内容:

Claude Code 和 Codex 仍然会收到 Paneflow 的 hook,各九个事件。它们携带 OSC 7501 不包含的信息:使对话可恢复的 provider session id 和 transcript 路径、为标签页命名的提示、填充通知的最后结果、子 agent 的启动和停止。它们从不移动状态,有一个测试固定了这一点:a_hook_event_carries_metadata_but_never_moves_the_declared_state。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →