omp · v18.8.2

这是 oh-my-pi（omp）v18.8.2 的版本发布说明，面向使用其编程代理相关包的用户。要解决的问题有二：

• 长时间 Anthropic 会话中反复产生的工具截图（inline screenshot）使请求携带的内嵌图片字节过多，超出请求大小限制。
• Tern 浏览器标签页以 URL 打开时在页面加载完成前即返回，导致首次 observe() 或 title() 读到空白页。

发布 v18.8.2，对三个包给出变更（含 Fixed 与 Removed 两类），并提供完整变更对比 v18.8.1...v18.8.2：

• @oh-my-pi/pi-catalog：暴露 provider 级 image-byte budget。
• @oh-my-pi/pi-coding-agent：修复图片超限与 Tern 浏览器时序问题，并移除按调用覆盖模型的接口。
• @oh-my-pi/pi-tui：从 task 参数类型中移除按调用的 model 字段。

• @oh-my-pi/pi-catalog：修复 Anthropic 请求携带过多 inline screenshot 字节的问题，方式是暴露 provider image-byte budget，且仅作用于官方 endpoint（#14453）。
• @oh-my-pi/pi-coding-agent：修复长 Anthropic 会话中反复工具截图超出请求大小限制——live image 现按字节裁剪；可恢复的 413 可能压缩（compact）较旧历史；终端 subagent 失败会上报到父级（#14453）。
• 同包修复 Tern 浏览器标签页问题：URL 在页面加载前返回导致首次 observe()/title() 读到空白页。
• 移除 task、eval agent()、workpool() 的按调用模型覆盖，subagent 改用已配置的 agent 模型与设置；@oh-my-pi/pi-tui 移除 task 参数类型中的 model 字段。
• What's Changed 条目：fix(session): prevented oversized live image requests（#14456）。

本版本以修复为主：图片字节预算与按字节裁剪、可恢复 413 时压缩历史、subagent 失败上报父级、Tern 首读空白页修复；同时收窄 API，移除按调用模型覆盖。适用边界：image-byte budget 仅在官方 endpoint 生效；依赖按调用模型覆盖的调用方行为会改变。其余结论原文未说明。

来源日期为 2026年10月8日 01:52（北京时间），即北京时间 2026年10月8日 01:52:59。变更跨度为 v18.8.1...v18.8.2。该说明描述的是发布时点的版本状态；此后是否仍成立，原文未说明。

适用于 oh-my-pi（omp）v18.8.2 的三个包：@oh-my-pi/pi-catalog、@oh-my-pi/pi-coding-agent、@oh-my-pi/pi-tui。典型场景：

• 通过 Anthropic 接口进行、且频繁产生工具截图的长会话。
• 使用 Tern 浏览器标签页并调用 observe()/title() 的场景。
• 注意：image-byte budget 仅作用于官方 endpoint，非官方 endpoint 不在此限。

行为变更：

• live image 改为按字节裁剪；可恢复的 413 可能压缩较旧会话历史；终端 subagent 失败会传到父级。
• Tern 标签页打开时序修复，首次 observe()/title() 不再读到空白页。
• 新增能力：暴露 provider image-byte budget（仅官方 endpoint）。

API/结构变更：

• 移除 task、eval agent()、workpool() 的按调用模型覆盖，subagent 使用已配置的 agent 模型与设置。
• @oh-my-pi/pi-tui 的 task 参数类型移除 model 字段。

无价格类变更；其余量化数据原文未说明。

有明确因果表述的：

• inline screenshot 字节过多导致请求超出大小限制，对应修复为暴露 image-byte budget、按字节裁剪、可能压缩历史。
• URL 在页面加载前返回导致首次 observe()/title() 读到空白页（Tern 问题因果链）。

仅为限定或相关、无因果证据的：

• “仅官方 endpoint”是作用范围限定，原文未对第三方端点行为作因果断言。
• 移除按调用模型覆盖与图片修复是并列变更，原文未说明二者有因果关系。
• “可能压缩历史”（may compact）为条件性行为，是否必然避免 413 原文未说明。

原文作者/署名（仅按结构化作者字段）：github-actions[bot]（GitHub 自动化账号）。关键技术（按原文描述）：

• provider image-byte budget：对 Anthropic 请求内嵌截图字节施加预算，仅官方 endpoint 生效。
• live image 按字节裁剪，配合可恢复 413 时压缩较旧历史，以控制长会话请求体积。
• subagent 失败上报：终端 subagent 的失败可到达 parent。
• Tern 浏览器标签页时序修复：避免 URL 提前返回导致的空白页首读。
• API 收窄：task/eval agent()/workpool() 与 pi-tui 参数类型同步移除按调用 model 字段。这些机制的底层实现细节原文未说明。

元：本发布本质上在解决“长会话 + 频繁工具截图”导致 Anthropic 请求体积超限（413 类故障）的稳定性问题，顺带修复 Tern 浏览器首读时序，并简化 API（取消按调用模型覆盖）。

反：最可能失效或有边界的部分——image-byte budget 仅官方 endpoint 生效，走第三方/代理端点的用户不受益；“may compact”表明 413 恢复是条件性而非保证；移除按调用覆盖对既有调用方是破坏性变更，迁移方式原文未说明。

空：去掉叙事后剩下的必要事实：v18.8.2 对三个包发布，修复项（image-byte budget、按字节裁剪、历史压缩、subagent 失败上报、Tern 首读）与移除项（task/eval agent()/workpool() 及 pi-tui 的按调用 model 字段），关联 PR #14453、#14456，变更跨度 v18.8.1...v18.8.2。

综合结论：这是一次以稳定性修复为主、附带 API 收窄的补丁版本；官方 endpoint 用户的长会话截图超限问题应得到缓解，但非官方 endpoint 场景与依赖按调用模型覆盖的代码需自行评估，其余影响原文未说明。