{"author":{"id":"4e3fvwoonbfzbvqtdwehr2fzdp","name":"陈成","avatar_url":"https://lh3.googleusercontent.com/a/ACg8ocLP6uaUWVTzl3dUQgZAldOJdTbU_NCUcOxb0Jx1K5CuD97UlDiQ=s96-c","handle":"sorrycc"},"mine":false,"report":{"topic_id":"2fnnvfedj5ta","markdown":"# OSC 7501 Program Status Protocol 调研\n\n\u003e 整理日期：2026-11-02\n\u003e 信息来源：X 书签与评论、X 搜索、规范原文、Mitchell 的博客、areweosc7501yet.com、tmux issue、Reddit、Hacker News、pi v1.1.0 与 opencode v2.2.0 源码（第 6 节）\n\n## TL;DR\n\n- **是什么**：Mitchell Hashimoto（Ghostty 作者，现在做 Superlogical / Rex）在 2026-10-06 发布的一条终端转义序列。程序通过 pty 告诉终端自己的状态：`idle / working / done / blocked / error`，还能附带原因（`kind`、`msg`）和进度。\n- **解决什么问题**：agentic inbox（herdr、cmux、Prowl、Orca 这类同时管理多个 agent 的工具）只能靠正则匹配窗口标题和屏幕内容来猜 agent 状态，Claude Code 每发一个版本就可能失效。OSC 7501 改成由程序自己上报。\n- **为什么能推开**：协议很简单，一个 shell 函数就能接入。不需要 SDK、socket、环境变量或 JSON。走 pty，所以 SSH 和容器里也能用。终端不认识这条序列会直接忽略，向后兼容。\n- **采用情况**：截至 10-29，areweosc7501yet 统计的程序 39 个里 19 个已发布、12 个在做；终端 24 个里 7 个已发布、5 个在做。Claude Code v2.1.295 在规范发布 3 天后就支持了，Codex、opencode、pi、Amp、goose、Grok Build、Bubble Tea、iTerm2、cmux、Orca、Prowl、Termius 等也已支持。\n- **争议**：tmux 作者 nicm 嫌规范太重（每个 pane 至少要存 64 条 record），目前只愿意做每个 pane 一条 root record 的精简版。有人认为 `kind=permission|question|auth` 是专为 AI agent 定的。还有人主张扩展 systemd 的 UAPI.15 OSC 3008，不要另起炉灶。Ghostty 本体目前还**没有**对用户开放（只有 libghostty-vt 合了解析器）。\n- **实际实现**：读了 pi 和 opencode 的源码，两家对规范的理解差别不小。pi 只有一条 root record，六种 state 都用上，退出时发 `clear`；opencode 用了多 record（每个会话一条），但从不发 `done` / `error`，退出时的 `clear` 因为时序 bug 发不出去。两家在 tmux 里都不上报。\n\n---\n\n## 1. 我的书签\n\n在 X History → Bookmarks 里搜 `7501` / `OSC`，命中：\n\n| 书签 | 内容 | 与主题的关系 |\n|---|---|---|\n| [@ZacharyZhang · ELYTerminal 0.1.3](https://x.com/ZacharyZhang/status/2111660849118986686)（10-18） | 自研终端，约 10 MB。新增会话状态（等你操作 / 出错 / 进行中带进度 / 已完成）和三平台系统通知 | **直接相关**：“程序可以上报状态和进度（OSC 7501、OSC 9;4），也可以发通知（OSC 9 / 777 / 99）。在 herdr 里，会话状态跟随 herdr 的 agent。” |\n| [@zoomq · luvus 吐槽](https://x.com/search?q=luvus%20omp)（08-25） | luvus 0.12.0 内置 agent 表只认 `pi`，不认 Oh My Pi 的 `omp` | 间接相关：说明“按进程名 / 屏幕文字猜 agent”的老办法很脆弱，正是 OSC 7501 要解决的问题 |\n\nELYTerminal 那条推的评论基本是在聊 UI（粉色看板娘 ELY、主题、herdr 快捷键失效），没有讨论协议本身。\n\n---\n\n## 2. 协议本体\n\n规范原文：\u003chttps://www.superlogical.com/rex/docs/build/program-status\u003e（当前 rev 0.4，2026-10-10）\n\n### 2.1 语法\n\n```text\nOSC 7501 ; pairs ST        上报\nOSC 7501 ; ? ST            特性探测\n\npairs := pair (\":\" pair)*\npair  := key \"=\" value\nkey   := [a-z]+\nvalue := [A-Za-z0-9_.,+/=-]*      # 不含 : 和 ;，所以无需转义\n```\n\n- 自由文本（`msg`、`title`）一律用 **base64(UTF-8)**，解码后不能含控制字符（包括换行）。\n- 不认识的 key 必须忽略，协议就靠这条规则扩展。\n- 畸形的 pair 跳过，其余照常处理。超过限制、base64 解不开或含控制字符的上报整条丢弃。\n\n### 2.2 状态与生命周期\n\n| state | 含义 | 生命周期 |\n|---|---|---|\n| `idle` | 空闲，等用户下一条指令 | 直到被替换或清除 |\n| `working` | 运行中，可带 `progress` | 进程退出或下一个 shell prompt（OSC 133 A）时清掉 |\n| `blocked` | 必须等用户操作，`kind` 说明原因 | 同 working |\n| `done` | 完成，结果还没被看过 | **进程退出和 prompt 后仍保留**，什么时候消失由终端决定 |\n| `error` | 失败并停止 | 同 done |\n| `clear` | 不是状态，删除该 id 及其子 record | — |\n\n```mermaid\nstateDiagram-v2\n    [*] --\u003e idle\n    idle --\u003e working: 开始任务\n    working --\u003e blocked: 需要用户\\nkind=permission/question/auth\n    blocked --\u003e working: 用户已处理\n    working --\u003e done: 完成\n    working --\u003e error: 失败\n    working --\u003e idle: 用户中断/取消\n    done --\u003e [*]: 用户回来看过\\n(终端决定)\n    error --\u003e [*]: 用户回来看过\n    note right of working\n      进程退出 / 新 shell prompt\n      会丢弃 working 与 blocked\n      done 与 error 保留\n    end note\n```\n\n规范明确**没有心跳**，终端不能要求程序重复发送来保活。\n\n### 2.3 Key 一览\n\n| key | 值 | 说明 |\n|---|---|---|\n| `state` | 见上 | 必填。不认识的值会让整条上报被忽略，所以将来新增的状态在旧终端上不会被误当成 idle |\n| `id` | `seg/seg/...`，每段 ≤32 字符、≤8 层 | 不填就是 root record。`/` 表示父子关系，用于级联清除和继承 app |\n| `kind` | `permission` / `question` / `auth` | 只对 blocked 有效 |\n| `progress` | 0–100 | 只对 working / blocked 有效，不填表示不确定进度 |\n| `app` | 如 `cargo`、`claude-code` | 稳定的机器标识，用来分组和选图标。子 record 从祖先继承 |\n| `title` | base64 | 多 record 时给人看的标签 |\n| `msg` | base64 | 一行人类可读描述，终端不能从中解读语义 |\n\n**每次上报都会完整替换对应的 record**，所以 `app` 这类字段每次都要带上。\n\n### 2.4 多 record（树）\n\n```mermaid\ngraph TD\n    R[\"root · app=deploy\u003cbr/\u003eworking: Deploying v2.4.1\"]\n    A[\"us-east\u003cbr/\u003eworking 40%: Pushing image\"]\n    B[\"eu-west\u003cbr/\u003eblocked kind=permission:\u003cbr/\u003eApprove deploy to production?\"]\n    R --\u003e A\n    R --\u003e B\n```\n\nroot 显示 working，同时子任务 eu-west 是 blocked。两者都成立，展示哪个由终端决定。\n\n### 2.5 特性探测\n\n```text\nprogram  → OSC 7501 ; ? ST   紧跟 CSI c (DA1)\nterminal → OSC 7501 ; ? : states=idle,working,done,blocked,error : kinds=permission,question,auth ST\n```\n\n终端都会回 DA1，所以如果 DA1 的回复先到，就说明终端不支持 OSC 7501，程序不用等超时。探测是可选的，也可以直接发。\n**这里有个坑**：tmux 只回 DA1，所以 Claude Code 在 tmux 里探测失败，不会上报（见第 5 节）。\n\n### 2.6 安全与限制\n\n- 整条序列 ≤4096 B；`msg` 编码后 ≤2732 B；`title` 编码后 ≤256 B；每个终端 ≤256 条 record（至少支持 64 条），超出时淘汰最久未更新的。\n- 终端回写给程序的只有探测回复，内容里没有任何来自上报的数据，也没有接口能读出 record，因此不存在注入回显的通道。\n- 在终端外展示时要标明来自哪个终端，防止程序冒充其他终端里的程序。桌面通知、声音等副作用应该限流。\n\n### 2.7 最小接入示例\n\n```sh\nstatus() {\n  printf '\\e]7501;state=%s:msg=%s\\e\\\\' \"$1\" \"$(printf '%s' \"$2\" | base64 | tr -d '\\n')\"\n}\nstatus working \"Syncing photos\"\nrsync -a ~/Photos backup:/photos \u0026\u0026 status done \"Photos synced\" || status error \"rsync failed\"\n```\n\n---\n\n## 3. 为什么要有它（Mitchell 的论证）\n\n博客：[A Terminal Protocol for Program Status (OSC 7501)](https://mitchellh.com/writing/program-status-osc7501)（2026-10-06）\n\n```mermaid\nflowchart LR\n    subgraph Before[\"以前\"]\n      P1[Claude Code / Codex / ...] --\u003e|改窗口标题、画 spinner| T1[终端]\n      T1 --\u003e|正则匹配标题 / 截屏| H1[herdr / cmux / 各种 inbox]\n      P1 -.-\u003e|专用 socket API / cmux notify| H1\n    end\n    subgraph After[\"OSC 7501\"]\n      P2[任意程序] --\u003e|\"OSC 7501 ; state=blocked:kind=permission ...\"| T2[终端 / 多路复用器]\n      T2 --\u003e U[Tab 图标 / 通知 / Inbox / Lua 事件]\n    end\n```\n\n- **靠启发式猜**：herdr 给 Claude Code 写了 16 条 TOML 规则，例如“窗口标题以盲文 spinner 或半圆字符开头就算 working”。这个文件 3 个月里光为 Claude Code 就改了 10 次。\n- **靠带外 API**：每个程序要分别对接每个 inbox，本地 socket 过 SSH 或容器还得额外桥接。pty 天然能穿透这些环境。\n- **和现有序列的区别**：\n  - OSC 9;4 只能表示进度，没有“等用户”这个状态，而且和 iTerm2 的 OSC 9 通知共用编号 9，容易乱码。\n  - OSC 9 / 99 / 777 是一次性通知，没有持续状态。\n  - OSC 133 由 shell 发出，只知道命令开始和结束。\n  - OSC 0/2 标题只是一个字符串。\n  - iTerm2 的 OSC 21337 和 Orca 的 OSC 9999 规定了展示方式或需要解析 JSON。\n- Mitchell 已经在 libghostty 和 Rex 各实现了一遍，并通过插件或 fork 给 Terraform、Claude Code、Codex、Homebrew 做了 PoC，每个都不超过十几行。\n\n---\n\n## 4. 生态与采用（截至 2026-10-29，数据来自 [areweosc7501yet.com](https://areweosc7501yet.com) / [data.json](https://areweosc7501yet.com/data.json)）\n\n```mermaid\ntimeline\n    title OSC 7501 时间线\n    2026-09-28 : rev 0.1 草案 (gist)\n    2026-10-06 : rev 0.2 / 博客发布 : libghostty-vt 合入解析器\n    2026-10-07 : rev 0.3 (无 progress = 不确定进度；可免探测)\n    2026-10-09 : Claude Code v2.1.295 支持 : SwiftTerm 合入\n    2026-10-10 : rev 0.4 (探测回复可列 states/kinds；移除 terminfo)\n    2026-10-11 : Prowl 发布支持\n    2026-10-16 : Termius Android Beta 基于 7501 做 agent 通知\n    2026-10-18 : ELYTerminal 0.1.3\n    2026-10 下旬 : tmux 作者同意做精简版 (单 root record)\n```\n\n| 类别 | ✅ 已发布 | 🚧 进行中 / PR | ⛔ 停滞或拒绝 / ⚪ 无动静 |\n|---|---|---|---|\n| Coding agents | Claude Code v2.1.295、Codex CLI rust-v0.163.0、opencode v2.2.0、pi v1.1.0、Amp、goose、Grok Build、Factory Droid、Crush、Kiro CLI、Antigravity CLI、Docker Agent、Mistral Vibe、MiniMax Code、fx | Gemini CLI、Qwen Code、Kimi Code、Hermes Agent、OpenClaw | ⚪ Cursor CLI、Kilo Code |\n| CLI / 构建工具 | Hugo、tuist、Buildkite Agent/CLI | Gradle、MSBuild、Composer、Expo、Aspire、UnrealBuildTool、WebKit | ⛔ firebase-tools；⚪ Homebrew、Terraform、Neovim、Nix |\n| 库 | Bubble Tea v2.1.0、charmbracelet/x、OpenTUI | crossterm、libvaxis、tqdm | — |\n| 终端模拟器 | iTerm2 v3.7.5、ghostel、Pebrel | kitty、Contour、Intelligent Terminal | ⚪ **Ghostty（本体）**、Alacritty、WezTerm、Warp、VS Code、Windows Terminal、Zed、foot、Rio |\n| 多路复用器 / Inbox | Rex、cmux、Orca、Prowl | Herdr、zellij | ⛔ tmux（先拒后松口，见下） |\n| 引擎 | SwiftTerm | libghostty-vt | ⚪ xterm.js |\n\nX 上的落地案例：\n- [onevcat · Prowl 支持 OSC 7501](https://x.com/search?q=Prowl%20OSC%207501%20onevcat)：首批接 Claude 和 Pi，Agent Workflow 和 Remote Mirror 等功能都会受益。\n- [Termius Android Beta](https://x.com/search?q=Termius%20OSC%207501)：agent 需要你、完成或失败时推送通知，支持 Claude Code 和 Grok Build。\n- [@jiacheng_ai · `w1` wrapper](https://x.com/search?q=w1%20OSC%207501)：给不支持或实现有问题的 agent 包一层，`w1 codex` 后 Rex 等终端就能正确显示状态。\n- [@samuellhuber · Agent Substrate + omp collab](https://x.com/samuellhuber/status/2116520519231258944)：云上的 agent 也走 OSC 7501。\n- [@pechtimu · NATS + herdr 流水线](https://x.com/pechtimu/status/2116497922263011478)：producer → NATS → herdr worker → agent 用 OSC 7501 上报 working/blocked/done → 进入下一步。\n- [@JinjingLiang（Orca）](https://x.com/JinjingLiang/status/2116980515446440320)：“我们支持 OSC 7501，但多数 agent harness 实现得零零散散，仍然需要 hooks 作为兜底。”\n- [Bub](https://x.com/bubdotbuild/status/2116583486241042777)、Rune 1.3（[r/golang](https://www.reddit.com/r/golang/comments/1xdokmj/)、[HN](https://news.ycombinator.com/item?id=50214325)）也加了支持。\n\n---\n\n## 5. 争议与反对意见\n\n### 5.1 tmux：太重了，先做最小子集\n\n[tmux#5713](https://github.com/tmux/tmux/issues/5713)\n\n1. 提案人给出复现：tmux 只回 DA1，Claude Code 的探测因此判定不支持。pi 可以用 `PI_PROGRAM_STATUS=1` 跳过探测，但 tmux 会把未知 OSC 直接丢掉。\n2. nicm 第一次回复：“为时过早，先看别的终端和程序会不会跟进。”第二次回复：“pane 标题、OSC 9 进度条、OSC 133 已经够用了。”然后关闭了 issue。\n3. 社区列出支持者名单后，nicm 松口，但仍批评协议“**太复杂、太重**”：\n   - “最低要求是每个 pane 存 64 条 record，这很荒谬。最低应该是 1 条，record 和 id 做成可选扩展。”\n   - Codex 实际只发两种序列：`state={}:app=codex` 和 `state=clear`。\n   - 计划：每个 pane 只存一条 root record，忽略 `kind` 和可能的 `title`。不做“进程退出时清除”，只在 OSC 133 A 时清除。暴露 `program_state / program_name / program_message` 三个 format 变量。\n   - 欢迎提 PR。\n\n### 5.2 “就是给 AI agent 量身定做的”\n\n- HN [paaloeye](https://news.ycombinator.com/item?id=49984159)：读完整份规范，觉得它过度贴合 TUI AI agent 这一个场景。`kind := permission | question | auth` 在其他场景下没什么意义。\n- r/Ghostty 上有人说“kind 写死在规范里，简直离谱”，更希望用 authz / authn 之类的划分。\n- HN kevin_thibedeau：在数据流里继续塞带内信令会变成安全噩梦，更好的做法是提供一个可以锁定权限的进程状态查询接口。\n\n### 5.3 已有标准：UAPI.15 OSC 3008、SIGINFO、BEL\n\n- systemd 的 [UAPI.15 OSC 3008 (Hierarchical Context Signalling)](https://uapi-group.org/specifications/specs/osc_context/) 已经在 Ubuntu 26.04 里可用。有人认为应该扩展它，而不是新开一条序列。\n- UAPI group 的 Arian van Putten 和 Christian Brauner 在 X 上[邀请 Mitchell 把规范交给 UAPI group 托管](https://x.com/mitchellh/status/2108316851537322111)。Mitchell 回复“喜欢由独立组织来托管的想法”，之后再答复。**规范的归属可能会变**。\n- BSD 和 Darwin 的 `^T` / SIGINFO 是拉取模式，OSC 7501 是推送模式。\n- 有人觉得用终端 BEL 加多路复用器 toast 就够了，Mitchell 的文章没提 BEL 显得奇怪。也有人反驳说规范的 “Relationship to other sequences” 一节已经讨论过。\n- 编号之争：JdeBP 认为这种用途在语义上应该用 APC 而不是 OSC。Mitchell 的回应是 OSC 和 APC 的语义区分早已名存实亡，而且 APC 兼容性差，macOS Terminal.app 会把 APC 内容直接打印到屏幕上。\n\n### 5.4 Ghostty 自己的态度\n\nr/Ghostty 上有人说它是被 “shotgun merged” 进 Ghostty main 的，目前只在 libghostty 层面。areweosc7501yet 也显示 Ghostty 本体是 idle。作者本人的终端还没对用户开放这个功能，这一点挺有意思。\n\n### 5.5 其他建议\n\n- `progress` 应该带上预计剩余时间（比如 dd、rsync）。\n- 希望增加反向通道，让程序推一份 `key:command` 映射给终端，供终端提供交互。go-booba 已经把 JSON 塞进 `msg` 里实现了一个 hack 版。\n- 社区普遍关心的问题：\n  - tmux passthrough 怎么办（5.1 是目前的答案）\n  - `waiting` 能不能说明在等谁（规范用 `kind` 回答）\n  - 怎么区分卡住和在跑一个很慢的构建（Gradle 用户）\n\n---\n\n## 6. 实现对照：pi v1.1.0 与 opencode v2.2.0\n\n两份源码分析：pi 看的是 `earendil-works/pi` tag `v1.1.0`（引入提交 [`503c605`](https://github.com/earendil-works/pi/commit/503c605528f9af993c0e37ede468cf884fb0ff5b)，Mario Zechner，10-07）；opencode 看的是 `anomalyco/opencode` tag `v2.2.0`（10-27）和它依赖的 OpenTUI 0.7.0。只读代码，没有在真实终端里跑过。\n\n### 6.1 一张表看差异\n\n| | pi v1.1.0 | opencode v2.2.0 |\n|---|---|---|\n| 分层 | `pi-tui` 编码和探测，`coding-agent` 的 `ProgramStatusReporter` 把 agent 事件映射成状态 | opencode 只调 `renderer.setProgramStatus()`，校验、base64 和写入都在 OpenTUI 的 Zig native 层 |\n| record | 只有 root，不发 `id` / `title` / `progress` | root 汇总 + 每个待处理会话一条子记录（`id` = session ID，不合规就用 `ses_\u003csha256 前 16 位\u003e`）；子 agent 并进根会话，不单独成记录 |\n| 用到的 state | 六种全用：idle / working / blocked / done / error / clear | 只有 idle / working / blocked / clear，**不发 done、error** |\n| `kind` | permission（confirm 对话框）、question（select / input / editor）、auth（登录） | permission（工具权限）、question（表单），没有 auth |\n| `msg` | 会话名、对话框标题、错误首行；不放 prompt 和模型输出 | 固定文案：`Permission needs input`、`Input needs response`，汇总时 `N sessions need input` / `N sessions working`；会话标题放 `title` |\n| 探测 | 发 `OSC 7501;?` + DA1，DA1 先到即不支持，没有超时；结果**决定**发不发 | 也发探测，但结果**不用于门控**，不管支不支持都照发 |\n| 开关 | `PI_PROGRAM_STATUS=1` 跳过探测直接发，`=0` 永不发 | 没有开关 |\n| tmux | 不做 passthrough，探测必然失败，什么都不发 | 不做 passthrough（刻意的：外层终端分不清 pane），序列只交给 tmux 自己 |\n| 退出 | `TUI.stop()` 发 `clear`，Ctrl+Z、外部编辑器、模式切换也会 clear 再补发 | 想在卸载时发 `clear`，但 renderer 已经 `_isDestroyed`，**实际发不出去** |\n| 去重 / 失败 | `JSON.stringify` 比上一次，不限流 | 同样按 `JSON.stringify` 去重；写失败（suspend、背压）不重试，要等下次状态变化 |\n| 覆盖范围 | 只有 interactive 模式，`-p` / json / rpc 不报 | 只有打开的 tab 和当前查看的会话 |\n\n### 6.2 pi 的状态映射\n\n```mermaid\nstateDiagram-v2\n  [*] --\u003e idle: TUI 启动\n  idle --\u003e working: agent_start / 手动 /compact\n  done --\u003e working: agent_start\n  error --\u003e working: agent_start\n  working --\u003e done: agent_settled 且最后一条正常\n  working --\u003e error: agent_settled 且 stopReason=error\n  working --\u003e idle: agent_settled{aborted}（Esc）\n  state \"blocked (permission | question | auth)\" as blocked\n  working --\u003e blocked: 对话框 / 登录\n  idle --\u003e blocked: 对话框 / 登录\n  blocked --\u003e working: 全部关闭，回到底层状态\n  working --\u003e [*]: stop() → clear\n  done --\u003e [*]: stop() → clear\n```\n\n- 整个 `agent_start` 到 `agent_settled` 都是 `working`，工具执行不单独上报。重试成功会覆盖之前记下的 error。\n- pi 核心没有工具审批，`kind=permission` 只来自 confirm 类对话框，扩展做的权限门控也走这里。扩展用 `ctx.ui.custom()` 自己画的交互**不会**报 blocked，扩展 API 也没有暴露 `setProgramStatus`。\n- 登录用 `try/finally` 包住 `blocked:kind=auth`，保证解除。\n\n### 6.3 opencode 的状态映射\n\n| 会话（含子 agent）条件 | 子记录 |\n|---|---|\n| 有权限请求 | `blocked:kind=permission` |\n| 有 question / 表单 | `blocked:kind=question` |\n| running 或有非 synthetic 的 pending | `working` |\n| 都没有（空闲、完成、中断、出错） | `clear`（之前没发过就不发） |\n\nroot 的汇总规则：恰好 1 个 blocked 或 1 个 working 时，直接复用那条会话记录（去掉 id）；多个时报 `N sessions …`，多个 blocked 且 kind 不一致就省略 kind；都没有就是 `idle`。整条链路靠 Solid 的 `createEffect` 驱动，数据一变就重算，只把有变化的记录发出去。\n\nopencode 的这部分代码经历过一次回滚：PR [#55172](https://github.com/anomalyco/opencode/pull/55172)（10-13）引入，随 OpenTUI 0.6 升级一起被 revert，PR [#55339](https://github.com/anomalyco/opencode/pull/55339)（10-19）重新加回。v2.2.0 是第一个带这个功能的正式 release，但 release notes 里没提。\n\n### 6.4 退出 bug（opencode）\n\n```mermaid\nsequenceDiagram\n  participant O as opencode\n  participant R as OpenTUI renderer\n  participant S as Solid root\n  O-\u003e\u003eR: destroyRenderer() → renderer.destroy()\n  R-\u003e\u003eR: _isDestroyed = true\n  R-\u003e\u003eS: emit(\"destroy\") → dispose\n  S-\u003e\u003eO: onCleanup → send(ROOT, clear)\n  O-\u003e\u003eR: setProgramStatus({state: clear})\n  R--\u003e\u003eO: false（已销毁，什么也不写）\n```\n\n后果：退出前 root 是 working / blocked 时，终端按规范会自己丢弃，影响不大；但最常见的是退出前处于 `idle`，规范只说终端 MAY 丢弃 idle，所以部分终端里会残留一条 idle。单测的 mock renderer 永远返回 `true`，没测出来。修法很简单：在 `renderer.destroy()` 之前先发 clear，和现在先清终端标题的做法一样。\n\n### 6.5 两家共同的问题\n\n- **都没有 `progress`**，也都不用 `id` 表达子 agent 层级（opencode 的 id 只有一层）。\n- **退出语义和规范相反或缺失**。规范的设计是 done / error 在进程退出后保留，等用户回来看。pi 退出时主动 `clear`，崩溃也是 clear 不是 error，把 done / error 抹掉了；opencode 根本不发 done / error。结果是用户退出后，dashboard 上看不到\"上次完成了还是出错了\"。\n- **tmux 里都拿不到状态**，原因不同：pi 是探测失败后不发，opencode 是发了但 tmux 不认识。设 `PI_PROGRAM_STATUS=1` 也只能跳过探测这一步，tmux 不转发，外层终端照样收不到。真正的解法只能是 tmux 自己实现（第 5.1 节的精简版）。\n- **msg 信息量都不高**。pi 出于隐私只放会话名；opencode 是固定文案。规范的示例鼓励写成\"Allow bash: rm -rf build?\"这种具体内容。\n\n这也印证了 Orca 作者那句\"多数 agent harness 实现得零零散散，仍然需要 hooks 兜底\"：同样标着\"已发布\"，pi 和 opencode 能给终端的信息差了一大截。\n\n---\n\n## 7. 我的看法\n\n1. **对 agent 编排工具来说，这是确定的利好**。herdr 和 cmux 这类工具可以去掉大部分正则规则。Claude Code、Codex、pi、opencode 这些主力 agent 都已经支持，覆盖了大部分实际使用场景。\n2. **tmux 是最大的短板**。大量人在 tmux 里跑 agent，tmux 不回探测，Claude Code 就不会上报。tmux 精简版发布之前，tmux 用户还得靠 hooks 或 `w1` 这类 wrapper，也可以自己在 Claude Code 的 Stop / Notification hook 里往 `/dev/tty` 写序列。\n3. **规范有分层的余地**。nicm 的“单 root record 作为最低要求，id 和多 record 作为可选扩展”很有道理。如果规范转交 UAPI group，rev 1.0 很可能朝这个方向调整。\n4. **自己的 CLI 接入成本很低**：在 agent 进入等审批 / 等输入 / 完成 / 失败时各发一条 `OSC 7501`，带上 `app=\u003cname\u003e`。探测时记得跟一个 `CSI c`，避免等待超时。\n5. **“已支持”不等于“支持得好”**。areweosc7501yet 只看有没有发布，不看实现了哪些部分。从 pi 和 opencode 的代码看，至少要分三档：只有 working / blocked（opencode）；完整的单 record，含 done / error（pi）；多 record 加层级 id（目前两家都没做到）。自己接入时可以照 pi 的状态映射做，再补上两家都缺的：退出时保留 done / error，失败了重试，blocked 的 msg 写清楚在等什么。\n\n---\n\n## 参考链接\n\n**规范与官方**\n- 规范：\u003chttps://www.superlogical.com/rex/docs/build/program-status\u003e\n- rev 0.1 gist：\u003chttps://gist.github.com/mitchellh/7acae3abd8355c1c00287d67e96c913a\u003e\n- Mitchell 博客：\u003chttps://mitchellh.com/writing/program-status-osc7501\u003e\n- 发布推文：\u003chttps://x.com/mitchellh/status/2107577887159386152\u003e\n- Claude Code 支持推文：\u003chttps://x.com/mitchellh/status/2108296550405619967\u003e\n- UAPI group 托管讨论：\u003chttps://x.com/mitchellh/status/2108316851537322111\u003e\n\n**支持追踪**\n- \u003chttps://areweosc7501yet.com\u003e ／ \u003chttps://github.com/benjuntilla/areweosc7501yet\u003e\n- Claude Code v2.1.295：\u003chttps://github.com/anthropics/claude-code/releases/tag/v2.1.295\u003e\n- libghostty-vt：\u003chttps://github.com/ghostty-org/ghostty/pull/14560\u003e\n- cmux 文档：\u003chttps://github.com/manaflow-ai/cmux/blob/main/docs/program-status.md\u003e\n- pi 文档：\u003chttps://pi.dev/docs/latest/terminal-setup#program-status\u003e\n- tmux issue：\u003chttps://github.com/tmux/tmux/issues/5713\u003e\n\n**实现源码**\n- pi 引入提交：\u003chttps://github.com/earendil-works/pi/commit/503c605528f9af993c0e37ede468cf884fb0ff5b\u003e\n- pi issue #10607：\u003chttps://github.com/earendil-works/pi/issues/10607\u003e\n- pi reporter：\u003chttps://github.com/earendil-works/pi/blob/v1.1.0/packages/coding-agent/src/modes/interactive/program-status-reporter.ts\u003e\n- opencode PR #55172：\u003chttps://github.com/anomalyco/opencode/pull/55172\u003e ／ #55339：\u003chttps://github.com/anomalyco/opencode/pull/55339\u003e\n- opencode program-status.ts：\u003chttps://github.com/anomalyco/opencode/blob/v2.2.0/packages/tui/src/context/program-status.ts\u003e\n- OpenTUI PR #1657：\u003chttps://github.com/anomalyco/opentui/pull/1657\u003e\n\n**X**\n- 书签 · ELYTerminal 0.1.3：\u003chttps://x.com/ZacharyZhang/status/2111660849118986686\u003e\n- Geek Lite 推荐 areweosc7501yet：\u003chttps://x.com/QingQ77/status/2116370072633765921\u003e\n- Orca 作者谈兜底：\u003chttps://x.com/JinjingLiang/status/2116980515446440320\u003e\n- Agent Substrate：\u003chttps://x.com/samuellhuber/status/2116520519231258944\u003e\n- NATS 流水线：\u003chttps://x.com/pechtimu/status/2116497922263011478\u003e\n- Bub：\u003chttps://x.com/bubdotbuild/status/2116583486241042777\u003e\n- X 搜索：\u003chttps://x.com/search?q=%22OSC%207501%22\u003e\n\n**Reddit / HN**\n- r/Ghostty · Any thoughts on OSC 7501：\u003chttps://www.reddit.com/r/Ghostty/comments/1x0up4n/any_thoughts_on_osc_7501/\u003e\n- r/Ghostty · areweosc7501yet 发布：\u003chttps://www.reddit.com/r/Ghostty/comments/1xibqt1/\u003e\n- r/golang · Rune 1.3：\u003chttps://www.reddit.com/r/golang/comments/1xdokmj/\u003e\n- HN 主帖（188 分 / 55 评论）：\u003chttps://news.ycombinator.com/item?id=49984159\u003e\n- UAPI.15 OSC 3008：\u003chttps://uapi-group.org/specifications/specs/osc_context/\u003e\n","html":"","default_view":"markdown","version":5,"updated_by":"4e3fvwoonbfzbvqtdwehr2fzdp","updated_at":"2026-11-04T15:00:49Z","assets":[],"base_url":"/pub/2fnnvfedj5ta/p/"},"sources":[],"topic":{"id":"2fnnvfedj5ta","title":"OSC 7501 Program Status Protocol","question":"OSC 7501 是什么、解决什么问题，生态跟进到哪了，有哪些争议？","visibility":"public","slug":"osc-7501","hue":132,"emoji":"🚦","owner_id":"4e3fvwoonbfzbvqtdwehr2fzdp","created_at":"2026-11-04T14:44:36Z","updated_at":"2026-11-04T15:00:49Z","published_at":"2026-11-04T14:44:49Z","item_count":0,"report_words":2967,"formats":["markdown"],"url":"https://research.sorrycc.dev/@sorrycc/osc-7501"}}
