外部精选
omp · v18.8.6
本文来自外部来源,不是黄奕彬的原创文章。本站提供原文入口,并在采集端生成 AI 结构化摘要、解读与中文翻译(如有),一切以原文为准。
阅读原文(github.com)结构化摘要 AI 生成
背景与问题
oh-my-pi (omp) v18.8.6 的发布说明,面向该编码代理工具的使用者与贡献者,记录相对 v18.8.5 的变更。
要解决的问题包括:会话历史裁剪破坏 Anthropic prompt 缓存效率、Google Gemini 与 Cloud Code Assist (Antigravity) 因工具 schema 含不支持的关键字或多类型字段而请求失败、多账号下认证代理配额判断错误、恢复的 Claude 会话丢失思考上下文与缓存复用、X 帖文读取依赖的 Nitter 镜像不可用,以及 TUI 渲染、模型选择器、配置热重载等多处缺陷。
方法或内容
以分包 changelog 形式发布:pi-agent-core 新增 warm-cache 感知的会话裁剪与 AgentLoopConfig.hasQueuedAsides(Agent 上亦可获取);pi-ai 修复 Gemini/CCA 的 JSON Schema 兼容、auth broker 账号选择与配额执行、Anthropic 系模型流式标记解码;pi-catalog 新增 Claude 各宿主的 prompt-cache-lookback 公共目录轴与 resolvePromptCacheLookback API,并修复模型发现;pi-coding-agent 新增按会话 Git worktree(worktree.onStart/onExit)设置、扩展 xAI X 帖文搜索与登录态读取,并修复十余项缺陷;pi-tui 改进流式长 Markdown 列表渲染并修复选择器问题。
末尾附 What's Changed 的 PR 列表与新贡献者。
关键发现 / 结果
主要变更点:
- 裁剪会话历史时保持在模型 prompt-cache lookback 窗口内以保留 Anthropic 缓存效率;
- Web 搜索在 xai-oauth 登录与 xai API key 同时可用时优先前者(除非
modelProviderOrder另行指定); - X 搜索支持仅 X、按作者、排除作者、日期与时效过滤,登录态下可读 X 帖文/线程/回复/主页/搜索/话题标签,替代不可用的 Nitter 镜像;
- 修复包括:
/switch与备选模型选择器因速度统计含无名模型而崩溃、lsp 与generate_image读取 FIFO/终端/无界设备路径导致挂起或内存耗尽、/wt移动的会话从恢复列表消失、启动期或符号链接重定向后的配置编辑被热重载忽略、@advisor 子代理误用内置慢模型等。
What's Changed 共列 12 个 PR(#13701 及 #14730–#14972),新贡献者为 @mgpai22 与 @clasalle-lila。性能改进未给出量化数据。
结论与意义
该版本是以缺陷修复为主、附带若干新功能的例行维护发布,覆盖五个包。适用边界:prompt-cache 相关改进针对 Anthropic/Claude 系模型;schema 兼容修复针对 Google Gemini 与 Cloud Code Assist;xAI/X 功能需相应凭证或登录态。
关于性能或缓存效率的具体收益原文未给出量化结论;是否引入破坏性变更、升级注意事项原文未说明。
AI 解读 AI 生成
方法:按「时空变量」分析(时间 / 空间 / 变量,严格区分包含、相关与因果),对象包括原文作者、署名人员与关键技术及其实际原理;结论用「元反空」(元思考、反思考、空思考、综合)整理。
时间:何时发生,现在是否仍成立
来源日期(Release 发布时间)为 2026年10月9日 03:05(北京时间);变更范围明确为 v18.8.5...v18.8.6。所有条目为发布时点的变更声明,在该时点即时生效。这些主张是否现在仍成立取决于其后是否出现更新版本;原文未说明后续版本或行为回滚情况,因此对更新版本的用户不保证仍适用。
空间:谁的环境 / 场景
适用于 oh-my-pi (omp) v18.8.6 及其包 @oh-my-pi/pi-agent-core、pi-ai、pi-catalog、pi-coding-agent、pi-tui 的使用者。
细分场景:Anthropic/Claude 系模型的 prompt 缓存、lookback 窗口与流式解码;Google Gemini 与 Cloud Code Assist (Antigravity) 的工具 schema 兼容;多账号 auth broker;按会话 Git worktree 隔离;xAI/X 搜索与读取(需凭证或登录态);TUI 使用及编译后 omp 二进制中扩展的模块加载。
变量:实际改变了什么
相对 v18.8.5 的实际变化:新增 warm-cache 感知裁剪、hasQueuedAsides 配置、prompt-cache-lookback 目录轴与 resolvePromptCacheLookback API、worktree.onStart/onExit 设置、xAI X 帖文搜索与读取;行为改变——Web 搜索在两者同时可用时优先 xai-oauth 登录而非 xai API key(可被 modelProviderOrder 覆盖)、供应商发布未被目录收录的模型时改为跳过并警告以保留其他模型的可发现性;此外多项崩溃、挂起、显示与会话恢复缺陷被修复。
价格类数据原文未说明。
区分:包含 ≠ 相关 ≠ 因果
包含关系:prompt-cache-lookback 是 pi-catalog 的公共目录轴,resolvePromptCacheLookback 是其配套 API;worktree.onStart/onExit 是 pi-coding-agent 的设置项。
相关关系:What's Changed 中的 PR 编号与功能仅为提交对应记录。
有明确因果证据的:修复型条目直接声明因果,如剥离 uniqueItems 等不支持的关键字以解决 Google/CCA 请求失败、停止工具结果裁剪在多个小轮次后重写整个 Anthropic 缓存、拒绝读取 FIFO/设备以避免挂起或内存耗尽、首条消息前注册扩展或 MCP 工具导致恢复会话丢失思考上下文。
而“改进渲染性能”“保留缓存效率”未附量化证据,其效果因果不确定。
对象:作者/署名与关键技术原理
署名仅来自结构化作者字段:github-actions[bot],即该 Release 由自动化机器人发布;正文未给出人类署名作者。
正文另列 PR 贡献者:@will-bogusz、@H4vC、@alnaggar-dev、@gitpushoriginmaster、@roboomp、@DrFaustus-vic、@mgpai22、@jwaldrip、@clasalle-lila、@iliaal,其中 @mgpai22 与 @clasalle-lila 为首次贡献。
关键技术按原文描述:warm-cache 感知裁剪使裁剪后历史保持在模型 prompt-cache lookback 窗口内以保留 Anthropic prompt 缓存效率;auth broker 在多账号时一致按所选账号的配额执行;工具 schema 中不支持的关键字或允许多类型的字段被剥离以适配 Google/CCA;每会话创建隔离 Git worktree 并在会话结束时清理;Nitter 镜像不可用后由登录态 xAI 读取 X 帖文等内容替代。
元反空综合结论
元:这是 omp 多包项目的自动发布说明,本质在解决“两个相邻版本之间改了什么、由谁贡献”的透明度问题,服务于升级决策。
反:最可能失效或有边界的主张——
- 性能类表述(流式长 Markdown 列表渲染更快、保留 Anthropic 缓存效率)无量化数据支撑;
- xAI/X 搜索与读取依赖登录态和凭证的持续可用性;
- schema 与流式解码修复仅覆盖所列提供商(Anthropic 系、Google Gemini、CCA),不外推到其他模型或宿主;
- 来源日期为 2026-10-08,其后版本可能再次改变相关行为。
空:去掉叙事后剩下的必要事实是——v18.8.6 相对 v18.8.5 在 pi-agent-core、pi-ai、pi-catalog、pi-coding-agent、pi-tui 五个包中新增若干功能(按会话 Git worktree、xAI X 搜索与读取、prompt-cache-lookback 目录轴与 API、hasQueuedAsides)并修复十余项具体缺陷,附 12 个 PR 编号与贡献者名单。
综合:可信度较高的例行维护版本说明,事实条目与 PR 一一对应,适合作为升级参考;但对性能与缓存“效率”收益应视为未经量化验证的说法。
中文译文 AI 生成
@oh-my-pi/pi-agent-core
新增
新增了对具备热缓存感知能力的对话裁剪支持,使裁剪后的历史保持在模型的 prompt-cache 回溯(lookback)窗口内,同时保留 Anthropic prompt-cache 效率。
新增 AgentLoopConfig.hasQueuedAsides(也可在 Agent 上使用),允许可中断的等待操作检测已排队的旁路消息,而无需消费它们或向其他工具发送信号。
@oh-my-pi/pi-ai
修复
修复了 Google Gemini 和 Cloud Code Assist(Antigravity)请求在工具 schema 包含不支持的 JSON Schema 关键字或允许多种类型的字段时失败的问题。修复了认证代理的账户选择和用量限制执行,使其在存在多个账户时始终使用所选账户的配额。
修复了 Anthropic 系列模型的流式输出,使编码的标记 token 在文本、工具调用更新、部分消息和已完成的工具调用中被正确解码。
@oh-my-pi/pi-catalog
新增
新增了对所有主机上 Claude 模型的 prompt-cache 回溯支持,包括公开的 prompt-cache-lookback 目录轴和 resolvePromptCacheLookback API。
修复
修复了当提供方在模型被目录识别之前就发布模型时的模型发现问题;不支持的模型现在会被跳过并给出警告,从而使其他可用模型仍然可被发现。
@oh-my-pi/pi-coding-agent
新增
新增了按会话的 Git worktree 支持,通过 worktree.onStart 和 worktree.onExit 设置为每个会话创建隔离的 worktree,并在会话结束时将其清理。
扩展了 xAI 网页搜索,加入 X 帖子搜索,包括仅限 X 的查询和针对特定作者的查询、作者排除、日期和新近度过滤器,以及在凭据可用时自动路由到 xAI。新增了在登录后由 xAI 驱动的对 X 帖子、讨论串与回复、个人资料、搜索和话题标签的阅读功能,替代了不可用的 Nitter 镜像。
变更
当两者同时可用时,网页搜索现在优先使用经过认证的 xai-oauth 登录而非 xai API key,除非 modelProviderOrder 指定了不同的顺序。
修复
修复了切换 judge 角色后 judge 门控功能继续使用过期模型链的问题。改进了从长对话中裁剪工具结果时的 Anthropic prompt-cache 复用。修复了当扩展或 MCP 工具在第一条消息之前注册时,恢复的 Claude 会话丢失早期 thinking 上下文和 prompt-cache 复用的问题。
修复了使用 @advisor 配置的 subagent advisor 使用内置慢速模型而非所配置 advisor 角色的问题。修复了当存储的模型速度统计中包含未命名模型时 /switch 命令和备选模型选择器崩溃的问题。
修复了 lsp 和 generate_image 尝试读取 FIFO、终端或无界设备路径的问题,此类读取可能导致挂起或耗尽内存。修复了来自扩展的旁路消息被阻塞在正在运行的等待操作之后的问题。修复了导入 @oh-my-pi/pi-tui/native/* 的扩展在已编译的 omp 二进制文件中加载失败的问题。
修复了在 Anthropic 空闲摘要、/btw 和 /omfg 回复以及流式预览中出现原始 token 标记而非 Nerd Font 图标的问题。修复了使用 /wt 移动的会话从恢复列表中消失的问题;位于 Git worktree 中的会话现在仍可被发现,并且如果其 worktree 被移除,可以恢复或重新安置。
修复了配置实时重载忽略在启动期间或配置符号链接刚被重新指向后所做的编辑,直到下一次无关编辑才生效的问题。
@oh-my-pi/pi-tui
变更
改进了流式渲染长 Markdown 列表的性能,同时保留嵌套项、编号和引用链接。
修复
新增了原生 Tern/TSP 模块的包导出,允许已编译 omp 二进制文件中的扩展导入它们。修复了 Tern /model 选择器的 Roles 标签页,使键入和 Backspace 能够一致地编辑搜索字段而不会触发角色命令。修复了会话选择器,使会话在当前文件夹与所有项目视图之间切换时保留并显示其目录。
变更内容
fix(agent):防止工具结果裁剪在许多小轮次后重写整个 Anthropic cache,由 @will-bogusz 在 #14751 中完成fix(coding-agent):在工具于第一条消息之前注册时保留恢复的 Claude 会话的 thinking 与 cache,由 @will-bogusz 在 #14754 中完成fix(ai):防止 broker 客户端在自身 fetch 失败时根据同级账户的用量判定某账户,由 @will-bogusz 在 #14904 中完成fix(coding-agent):依据所有者角色解析 @advisor subagent advisor,由 @H4vC 在 #14972 中完成fix(judgment):设置变更时使缓存的 judge 角色链失效,由 @alnaggar-dev 在 #14861 中完成feat(coding-agent):新增worktree.onStart和worktree.onExit设置,由 @gitpushoriginmaster 在 #14908 中完成fix(coding-agent):跳过导致模型选择器崩溃的 nullmodel_perf键,由 @roboomp 在 #14787 中完成fix(lsp,image):拒绝 FIFO 和设备而不是在其上挂起,由 @DrFaustus-vic 在 #14730 中完成fix(agent):当旁路消息排队时结束可中断的等待,由 @mgpai22 在 #14731 中完成fix(ai):为 Google 和 CCA 剥离uniqueItems和不支持的 schema 关键字,由 @jwaldrip 在 #14766 中完成fix(tui):为已编译二进制文件的扩展注册 pi-tui native/* 子路径,由 @clasalle-lila 在 #14835 中完成
使长流式列表变为增量式,由 @iliaal 在 #13701 中完成
新贡献者
@mgpai22 在 #14731 中完成了他们的首次贡献@clasalle-lila 在 #14835 中完成了他们的首次贡献
完整更新日志:v18.8.5...v18.8.6
展开原文提取正文(采集端自动提取,可能有缺失)
@oh-my-pi/pi-agent-core
Added
Added support for warm-cache-aware conversation pruning, keeping pruned history within the model’s prompt-cache lookback window while preserving Anthropic prompt-cache efficiency. Added AgentLoopConfig.hasQueuedAsides (also available on Agent) to allow interruptible waits to detect queued asides without consuming them or signaling other tools.
@oh-my-pi/pi-ai
Fixed
Fixed Google Gemini and Cloud Code Assist (Antigravity) requests failing when tool schemas contain unsupported JSON Schema keywords or fields that allow multiple types. Fixed auth broker account selection and usage-limit enforcement to consistently use the selected account’s quota when multiple accounts are present. Fixed Anthropic-family model streaming so encoded marker tokens are decoded correctly in text, tool-call updates, partial messages, and completed tool calls.
@oh-my-pi/pi-catalog
Added
Added prompt-cache lookback support for Claude models across all hosts, including the public prompt-cache-lookback catalog axis and resolvePromptCacheLookback API.
Fixed
Fixed model discovery when providers publish models before they are recognized by the catalog; unsupported models are now skipped with a warning so other available models remain discoverable.
@oh-my-pi/pi-coding-agent
Added
Added per-session Git worktree support with worktree.onStart and worktree.onExit settings to create an isolated worktree for each session and clean it up when the session ends. Expanded xAI web search with X post search, including X-only and author-specific queries, author exclusions, date and recency filters, and automatic xAI routing when credentials are available. Added xAI-powered reading of X posts, threads and replies, profiles, searches, and hashtags when logged in, replacing the unavailable Nitter mirrors.
Changed
Web search now prefers an authenticated xai-oauth login over an xai API key when both are available, unless modelProviderOrder specifies a different order.
Fixed
Fixed judge-gated features continuing to use a stale model chain after switching judge roles. Improved Anthropic prompt-cache reuse when pruning tool results from long conversations. Fixed resumed Claude sessions losing earlier thinking context and prompt-cache reuse when extensions or MCP tools were registered before the first message. Fixed subagent advisors configured with @advisor using the built-in slow model instead of the configured advisor role. Fixed the /switch command and alternate model picker crashing when stored model speed statistics contained an unnamed model. Fixed lsp and generate_image attempting to read FIFO, terminal, or unbounded device paths, which could hang or exhaust memory. Fixed aside messages from extensions being blocked behind a running wait operation. Fixed extensions importing @oh-my-pi/pi-tui/native/* failing to load in compiled omp binaries. Fixed raw token markers appearing instead of Nerd Font icons in Anthropic idle recaps, /btw and /omfg replies, and streaming previews. Fixed sessions moved with /wt disappearing from resume lists; sessions in Git worktrees now remain discoverable and can be resumed or relocated if their worktree was removed. Fixed live config reload ignoring edits made during startup or right after a config symlink was retargeted, until the next unrelated edit.
@oh-my-pi/pi-tui
Changed
Improved rendering performance for streaming long Markdown lists while preserving nested items, numbering, and reference links.
Fixed
Added package exports for the native Tern/TSP modules, allowing extensions in compiled omp binaries to import them. Fixed the Tern /model picker's Roles tab so typing and Backspace consistently edit the search field without triggering role commands. Fixed the session picker so sessions retain and display their directory when switching between the current folder and all-project views.
What's Changed
fix(agent):stop tool-result pruning from re-writing the whole Anthropic cache behind many small turns by @will-bogusz in #14751fix(coding-agent):keep resumed Claude sessions' thinking and cache when tools register before the first message by @will-bogusz in #14754fix(ai):stop broker clients judging an account by a sibling's usage when its own fetch fails by @will-bogusz in #14904fix(coding-agent):resolve @advisor subagent advisor against owner roles by @H4vC in #14972fix(judgment):invalidate the cached judge role chain when settings change by @alnaggar-dev in #14861feat(coding-agent):addworktree.onStartandworktree.onExitsettings by @gitpushoriginmaster in #14908fix(coding-agent):skipped nullmodel_perfkeys that crashed the model picker by @roboomp in #14787fix(lsp,image):refuse FIFOs and devices instead of hanging on them by @DrFaustus-vic in #14730fix(agent):end an interruptible wait when an aside is queued by @mgpai22 in #14731fix(ai):stripuniqueItemsand unsupported schema keywords for Google and CCA by @jwaldrip in #14766fix(tui):register pi-tui native/* subpaths for compiled-binary extensions by @clasalle-lila in #14835
Make long streamed lists incremental by @iliaal in #13701
New Contributors
@mgpai22 made their first contribution in #14731 @clasalle-lila made their first contribution in #14835
Full Changelog: v18.8.5...v18.8.6
原文入口
阅读原文(github.com)原文将在新窗口打开。收录时间不是内容更新时间;正文、译文与解读的版权归原作者/来源所有,本站仅作个人阅读辅助并保留原文入口;页面时间均为北京时间。
了解来源批准与收录规则