代码改动新增 Claude Code、Codex 和 OpenCode 的 Session 导入适配器及统一导入服务，同时扩展 Multi-Agent 任务的取消与结束状态处理。导入转换、消息清理与持久化衔接让用户可将外部 Agent 的对话带入 Cline；队友取消状态则用于更准确地处理委派任务结束。发布说明还记录 Hub 替换前排空、MCP 连接超时、Checkpoint 恢复保护和模型目录更新等行为变化。
本版围绕 CLI 启动与退出、MCP 配置和对话控制修复局部可靠性问题：发布说明指出，使用绝对 URI 处理内存参数 Schema 可避免工作目录不可访问时工具初始化失败，保留流设置 `FD_CLOEXEC` 可避免子进程延长管道生命周期。另修正 `/btw` 在活跃 `/goal` 下触发非预期 Tool Call，以及删除对话后注释文件残留；行为影响主要落在启动、退出和 Session 清理路径。代码概览只观察到 `CHANGELOG.md`，未提供这些修复的实现文件或调用路径；Runtime Prompt 与 Tool Schema 相邻版本相同，Static Prompt 比较不可用。
Guardian 审批审查现在会从模型元数据中的 `auto_review.node_repl_policy` 读取 Node REPL 策略，并将策略带入审查 Session 配置，使审查能遵循对应模型提供的策略。相关逻辑落在 `guardian_node_repl_policy.rs`、`guardian/review_session.rs` 和 `session/step_activation.rs`；后者还会拒绝改变 Guardian parent-fallback Node REPL 策略的目标模型配置。Runtime Prompt 与 Tool Schema 相邻版本相同；Static Prompt 比较不可用。
本版修复两处可靠性问题：macOS 12（Monterey）上的 Claude Code 启动失败，以及远程和计划任务 Session 在重新发送的权限批准未能应用后因用户消息内容为空而失败。代码差异只观察到 `feed.xml` 和 `CHANGELOG.md` 的发布记录，没有实现文件样本可用于定位修复机制；Runtime Prompt 的唯一变化是版本计费头，Tool Schema 未变。
Session 处理器现在会在 Provider 报告丢弃 Anthropic thinking blocks 时记录警告；工具仍在运行时更新元数据，也会沿用原有开始时间，避免计时被重置。Azure 登录改为直接询问资源名称，`apply_patch` 则省略空的移动路径元数据；桌面标题编辑器改为失焦时保存。Runtime Prompt 的唯一差异是 Git 环境中的日期文本变化，工具集合未变；Static Prompt 当前不可用，不能据此判断相邻版本是否一致。
Session 在模型发现完成后会重新协调模型相关状态，日期与目录提醒也改为按消息内容判断和注入；这让新 Session 能采用刷新后的模型 Context 窗口信息，并减少长 Thread 历史因 Context 变化而产生的不必要更新。编辑链路新增对纯文本 `<SM:EDIT>` 负载的恢复，并将 Sloppy Edit 解析改为结构化 XML 标签；官方说明还提到压缩或裁剪工具结果时保留 Claude reasoning context。Runtime Prompt 的相邻差异仅是 CPU 字符串变化，Tool Schema 无变化；Static Prompt 比较不可用。
Agents 视图现在会在打开时渐进加载已保存 Session 目录，加载条件不再要求搜索框有内容；这修复了新打开视图时 Inactive 区域为空的问题。代码改动位于 `agents-view-mode.ts`，相关测试覆盖视图加载与 Inactive 回复行为。Runtime Prompt 和 Tool Schema 的相邻比较不可用，Static Prompt 也没有可比较资产。
代码改动涉及 prompt 队列、Session 配置与生命周期、Subagent 消息、Context 压缩摘要及 Tool Call 遥测。`prompt_queue.rs` 对 auto-wake 来源的排队提示跳过自动唤醒；`compaction_context.rs` 纳入 ScheduledLoop 和 WorkflowRun 摘要，遥测则补充操作类型与回退信息。这些改动显示 Agent 的任务衔接、Session 配置和运行状态记录有所调整；发布说明文本为空。
版本把内核迁移到通过 stdio JSON Lines 通信的轻量 Python REPL，并以 `bash()` 管理 Shell 子进程；请求级错误隔离、可取消执行和进程树清理让长时间运行的 Session 更容易恢复，也降低内核快照的内存开销。Daemon 与 Supervisor 增加直接 Session transport 和事件驱动的 Agent roster，使 TUI 可订阅 Session 与 Subagent 状态，并在连接或 worker 恢复时回退到 Supervisor 路由。官方说明还列出快照原子提交、SIGINT 生命周期和 Windows 进程隔离等可靠性与安全加固；发布说明后段被截断，未观察到的条目不纳入判断。
Artifact 的 Tool Definition 移除了发布版本说明字段 `note`，并将 `label` 改为可选的简短版本名；依赖版本说明的发布调用需要调整参数。System Prompt 还明确允许 CLAUDE.md 或 Skill 请求时调用 Agent、workflow 和 deep-research。官方发布说明另外列出自动模式的越界读取与云凭据防护，以及后台 Session、权限检查和 MCP 管理等可靠性修复；这些发布说明没有附带实现代码位置。
whole-worktree 的 Git porcelain status 改由 Git CLI 执行并限制输出捕获；只有未安装 Git 时才回退到进程内 gitoxide 遍历。该机制针对包含数万未跟踪文件的 worktree，避免原先的 native crash 和进程退出前持续占用数 GB 已提交内存；VCS native 操作逸出的 panic 现在以结构化 VcsError 暴露。证据来自官方发布说明，未提供对应代码位置；Runtime Prompt 和 Tool Schema 的相邻比较不可用，不能据此判断其是否变化。
Session 可见性默认范围扩大到同一 Agent 的其他 Session，改变了未启用 Sandbox 时的跨 Session 访问边界；发布说明同时指出可通过 `tools.sessions.visibility` 收窄范围，Sandbox 与跨 Agent 限制仍保留。执行侧在 `gateway-caller-context.ts` 累积并向下传递审批生命周期信号，使同一运行中的包装层保留先前的取消边界；`sessions_send` 的契约也区分目标已排队或已接管与后续消息送达，避免将接纳误认为任务完成。
编排层将单向 Subagent report 改为父 Agent 与可持续 Subagent 之间的后续消息传递：`tool-subagent-report` 被移除，`tool-subagent-control` 注册带有相邻 Agent 消息标记的发送工具；消息会等待 Subagent 当前轮次结束后进入下一轮，因此不能中断正在执行的工作。Session 层以 `seq`、`eventAt()` 和 `snapshotEvents()` 的按需读取接口取代 `Session.events`，并用强类型区分 `SessionSeq` 与 `SessionLogOffset`；同一版本还为 Python SDK、Headless、ACP 和自定义 Profile 默认启用 `web_fetch`，并在 Web PTC Mode 默认隐藏通用 `workflow` 工具。
Session 主流程加入流式输出防护、Tool Call 循环检测与重定向，并修复持久化压缩记录及 Responses Tool Call 结果的恢复配对；相关实现落在 `session/stream-guards.ts`、`session/tool-call-loop-redirect.ts` 和 `session/session-context.ts`，可减少异常输出或历史记录使 Session 卡住、丢失结果的情况。ACP 权限门、排队消息和 Session 工具模块也得到扩展，分别在连接客户端时明确需要授权的工具，并支持更完整的 Session 工具与消息处理。模型兼容策略、ClinePass/Devin Provider 与 Agent Hub 等更新扩展了模型路由、用量查看和 Agent 活动追踪；官方代码变更概览覆盖 16.3.10 至 18.1.0，Runtime Prompt/Tool Schema 的相邻版本比较不可用。
1.1.23 聚焦 CLI 执行与 Session 可靠性：减少 Subagent 轨迹元数据的重复传输，并修复子命令因未关闭的标准输入管道而挂起的问题。官方发布说明还列出 Tool Call 历史重建、Hook 崩溃处理、工具权限提示、认证续期及 Subagent 状态等修复，旨在让执行、授权与 Session 流程按预期继续；代码变更样本只展示了 CHANGELOG.md 中的发布条目，未提供实现文件细节。
规划能力从默认可见转为显式启用：官方发布说明要求设置 `tools.update_plan.enabled = true`，Runtime Prompt 差异也移除了 `update_plan` 工具声明，降低默认工具面中的规划入口。另一方面，发布说明称历史压缩后会保留 Guardian 审查中的用户指令、回答和有效授权，并在未提供目录时恢复 Thread 保存的工作目录，改善压缩与恢复后的 Context 连续性。MCP 输出限制、服务器命名和 Shell 命令超时也获得更细配置；这些机制来自发布说明，证据未提供对应源码样本。
协调器现在对 MCP 初始化等待设置 10 秒预算；MCP 状态更新按服务名加锁，并将错误绑定到出错的 Session，降低初始化卡住阻塞 Agent 执行、旧 Session 错误污染新 Session 的风险。配置层集中 TUI 默认值并加入退出横幅模式，界面可选紧凑、默认或隐藏；另有 Provider URL 校验、Markdown 换行和推理 Provider 稳定性修复。Runtime Prompt 与 Tool Schema 的相邻比较不可用，不能据此判断其变化；Static Prompt 也没有可比较数据。
Runtime Prompt 将 `execute_code` 描述为持久 Session kernel，并加入 `reset` 参数；这让多次调用可复用变量和已加载数据，但超时或中断会丢失状态。`delegate_task` 改为必填 `tasks` 数组，支持对子任务结果做 JSON Schema 校验，同时移除了单任务形式和角色覆盖参数；并行派发与运行中控制仍由 `action` 提供。代码样本还显示 Desktop 按 Gateway 事件恢复 Todo，并在 `session-info.ts` 中调整 Session 与面板绑定及运行状态协调。官方发布说明另称桌面 Bot Mode、Cron 连续 Memory 和受保护指令文件写入审批等已发布；这些是发布说明层的信号，所给源码样本未展示其完整实现。
Thread 分叉可从任意轮次创建独立 Git Worktree；超长 Session 压缩在单次摘要失败后改用分块总结和树形归并，并把结果安装为当前 Session 的压缩投影。代码在 `forkWorktree.ts`、`sessionRecoveryVersions.ts` 与 `SessionRecoveryVersionsHost.tsx` 等处体现了隔离分叉和恢复版本管理；这些机制让探索性工作与源检出分离，并改善超长 Thread 恢复和版本选择。Thread 目录身份、转录历史预置及尾部接管也有可靠性调整；Runtime Prompt、Tool Schema 与 Static Prompt 的相邻比较不可用。
版本说明列出四项可靠性修复：处理特定目录布局下的 Bash 任务输出交换失败、在缺少项目本地设置文件时保存“always allow”、在 claude.ai 连接降级后避免 Remote Control 长时间卡顿，并限制超大后台任务失败通知造成的请求体膨胀。可观察的代码改动落在 CHANGELOG.md 与 feed.xml，二者记录了这些行为契约；实现源码未包含在代码样本中。
Session 界面新增对未载入轮次的预览和跳转，并调整长 Session 渲染；QueueDock 与 session queue mirror 改为处理排队图片附件，read_image 通过 PNG/JPEG 文件签名识别无扩展名图片，改善图片回显和投递。Session 持久化方面，SQLite 后端及其 codec、schema、store 等实现被移除，发布说明称已有内容不会删除，但需使用旧版本导出；这是本次明确的存储能力与迁移边界变化。源码还将 WebSocket 心跳状态改为累计 missed heartbeats；Runtime Prompt、Tool Schema 与 Static Prompt 的相邻比较不可用，不能据此判断这些层是否变化。
Gateway Session 创建路径新增调用级 Context：`gateway-session-spawn-context.ts` 用 `AsyncLocalStorage` 将 Session 创建授权限制在一次本地 Tool Call 内，配合 `gateway-session-spawn-execution-identity.ts` 传递同一次调用的父执行身份凭据。新建的 `AgentRuntimeSessionSpawnContext` 还携带继承的 Tool Policy，表明 Session 启动可同时关联完成责任与允许、拒绝列表；这让创建权限和父身份有了明确的调用边界。发布说明还描述了 Session 权限模式、Workspace 锚定限制和可选 Sandbox 执行，以及设备与云端 Session 托管等变化，但给出的源码样本不足以确认这些发布项各自的实现细节。
Agent Preset 增加组合盘点机制，代码落在 `composition-inventory.ts`，读取 YAML、校验 Plugin 入口并检查组合状态；配套的预设索引与展示模块也有调整。Remote Gateway 将流式终止失败统一封装为 `RemoteError`，让调用方获得一致的错误类型；发布说明还提到连接重试、长 Session 处理效率与预设浏览体验改进。Runtime Prompt 和 Tool Schema 的当前捕获及相邻比较均不可用，不能据此判断其变化。
MCP 交互路径加入结构化表单与 Apps 卡片，ToolCard 通过懒加载呈现新界面；官方说明称支持 MCP 2026 多轮交互和 Sandbox 渲染，扩展 MCP 工具交互方式。能力控制加入并行调度、审查预算与指标，官方将其描述为缓存稳定的速度和质量控制。CLI 的 serve 与 git 操作修复了 DNS 重绑定、预览越界读及 git clean 过滤器执行等边界缺口；代码样本也显示了 Context 缓存统计、Session 导出及流式状态处理的改动。
本版在 `turn-recovery.ts` 将可重试错误纳入恢复判断，并在 `retry-fallback-chains.ts` 与 `agent-session.ts` 延后模型发现期间的 fallback 配置校验，减少安全可重试的 Tool Call 后传输错误导致回合提前结束，以及模型发现尚未完成时的误报。Session advisor 通过 `session-advisors.ts` 和 `agent-session.ts` 恢复订阅状态；共享浏览器新增目标登记与回收机制，未正常终止的 Session 可清理遗留页面等资源。发布说明还记录 tokenizer、图片解码、MCP OAuth、LSP 诊断和多 Provider 目录等修复；Runtime Prompt 仅见工作站 CPU 字段变化，Tool Schema 统计无增删改。
MCP Tool Call 新增扩展处理环节，可在结果交给模型前检查或替换结果；Plugin 市场 Context 汇集全局配置、仓库范围与加载错误，使目录请求能组合仓库配置并保留有效 Plugin。远程执行路径也调整为依据执行器的 home、操作系统和路径约定构建 Sandbox Context，影响远程权限判断与路径匹配。Runtime Prompt 的 Using skills 仅将 Skill 路径改为短路径根映射；Tool Schema 无增删改，Static Prompt 当前不可用。
远程凭据 Agent 改为由桌面端持有真实提供商凭据、远程本地 Agent 使用作用域虚拟令牌；凭据保存、清除或删除时只重建或撤销受影响的路由，被撤销令牌返回 HTTP 401。Shell 支持集中到跨平台清单与独立 Git 能力中，并加入 Session 索引重建生命周期控制、状态轮询竞争处理及转录视图稳定机制，改善命令修复指引、历史索引与运行期间界面行为。
Session 层调整排队输入的提交路径，并加入 Tool Call 后续交付与采样事件处理；相关代码位于 `prompt_queue.rs`、新增的 `post_tool_use_delivery.rs` 和 `sampling_events.rs`。这组改动将排队提交、Tool Call 后续处理及事件记录纳入更明确的 Session 控制流程，代码同时增加了对应测试。Runtime Prompt 的变化仅见消息分块格式及运行环境字段；Tool Schema 无增删改，不能据此判断源码层没有行为变化。
`packages/coding-agent/src/core/agent-session.ts` 在下一次 Assistant 响应前处理超阈值的大型工具结果，并将运行期间收到的 Context-only 扩展消息延后到当前轮工具结果之后追加；这改变了压缩与消息回放的时序，避免超限结果先发给 Provider 或消息插入 Tool Call 与结果之间。`packages/agent/src/agent-loop.ts` 改用最近完成轮次的快照准备下一轮 Context，`extensions/runner.ts` 则包装 UI Context 并跟踪阻塞式提示事件，让 Host 能区分 Agent 工作时间与等待用户输入的时间。另有 Terminal 能力覆盖、Fullscreen 选择复制控制及多项 Session、Provider 和兼容性修复；Runtime Prompt 与 Tool Schema 相邻比较未见变化，Static Prompt 比较不可用。
Tool 执行中断或失败后，Agent 可重放完整失败批次而无需额外模型轮次；pi-agent-core 也支持继续中断运行并先重试待处理 Tool Call。代码概览覆盖了 TUI、构建与 Skill 文件，发布说明还记录了 Sharpshooter Memory、Session 重启恢复和退出时存储 Checkpoint 等变化，整体提升了执行恢复与状态耐久性。Runtime Prompt 比较仅见工作站 CPU 与日期字段变化，Tool Schema 无增删改；Static Prompt 比较不可用，代码差异概览是截断的。
Subagent 配置开始通过 `deriveApprovalModeConfig` 与 `deriveWorktreeConfig` 推导，核心实现落在 `packages/core/src/tools/agent/agent.ts`；这让审批模式与 Worktree 配置可在覆盖配置时组合。工具调度器及相关测试改用 `LlmChat`，并引入 `goalToolResultProvenance`，体现了调度逻辑对聊天客户端类型和目标工具结果来源的适配。CLI 增加按 Agent 隔离的跟进消息队列，Web Shell 调整 Session 的 PR 状态展示；官方发布说明为空，Runtime Prompt、Tool Schema 与 Static Prompt 的相邻比较均不可用。
Claude Code 将模型切换纳入 Hook 控制流：新增 PreModelSwitch、PostModelSwitch，允许拦截、确认或标注切换；恢复 Session 时，SessionStart Hook 还会收到 Session 陈旧程度和预估缓存重建成本。执行与信任边界也有多项调整：文件工具重新校验符号链接目标，浏览器操作统一经过 Claude Code 权限检查，Sandbox 相关设置及敏感自定义请求头需审批。编排与可观测性方面，Remote Control 可实时查看前台 Subagent 的 Tool Call 和结果，/cost 与状态栏增加 Prompt Cache 数据；官方源码概览仅观察到 CHANGELOG.md 和 feed.xml 的发布记录，未包含这些机制的实现代码。
普通交互回合现在在提供者完成可见助手响应时结束，不再要求调用合成的 finish 工具；发布说明称这也移除了强制执行、协议修复提示和修复失败路径。ask 与携带数据的终结器（如 submit_plan）仍保留，工具模式据称从约 4,298 个 token 缩减至 4,138 个。现有证据来自官方发布说明，未提供对应代码变更样本。
任务恢复路径在 `taskService.ts` 中追加前一 Session 的任务提醒，并跳过状态为 `lost` 的任务；官方说明还称恢复时会提示前一 Session 的后台任务可能仍在运行。这让 Agent 在恢复后能获知仍可能活动的任务。`turnEvents.ts` 与 `contextMemory/types.ts` 增加附件记录类型，`promptService.ts` 从用户来源消息汇集附件并写入 Prompt 来源，扩展了消息来源携带的 Context。另有 workspace alias 持久化、模型认证与 Provider 解析调整，以及多项 Web 交互修复；这些是局部可靠性与配置行为改进。
Reasonix 加入远程 SSH Workspace，并让繁忙回合在切换 Session 时继续运行；`useRemoteSession.ts`、`RemoteConnectWizard.tsx` 和 `ProjectTreeRemoteGroups.tsx` 是相关代码位置。回合事件现在可跨中断和重启持久保存，发布说明称此机制会防止已接受的副作用重复执行；源码概览列出了 `turnEventProjection.ts`。此外，主题元数据迁入 SQLite、MCP 受管 Session 改用官方 Go SDK，分别影响状态恢复和宿主集成；Runtime Prompt 与 Tool Schema 的相邻比较不可用，代码差异仅检查了部分内容。
官方发布将 VCS 操作迁移到 `@oh-my-pi/pi-natives/vcs`，以 `VcsRepo`、能力检查和 `VcsError` 覆盖 Git 与 Jujutsu，并移除 SDK 中的 `git`、`jj` 包装模块，改变了集成端调用契约。另有 Context 压缩、续接调度、嵌套 Subagent 可见性及并发关闭错误等修复，针对工具结果保真、重复续接和观测完整性改善 Agent 运行行为。代码概览的 `keyFiles` 显示本次版本间隔还加入 TUI 调试接口并调整构建系统；该代码差异从 16.3.10 起且已截断，不能据此归因全部改动于 18.0.9。
Azure Provider 的认证命令封装改为接收参数数组并返回 Promise，`packages/opencode/src/plugin/azure.ts` 引入 `which` 与 `Process`。官方发布说明称 Azure CLI 登录现在无需 Bun；这使 Azure 认证可在不具备 Bun 的环境中使用。
Azure Provider 增加通过 Azure CLI 使用 Microsoft Entra ID 登录的实现，代码集中在 `packages/opencode/src/plugin/azure.ts`；发布说明确认 Azure 登录不再要求 API Key。Session 归档新增集中处理模块，并由时间线接入，Home 索引增加移除缓存项的路径，使归档 Session 能更快从 Home 列表消失。其他可观察调整涉及 Cloudflare AI Gateway 的 Workers AI 凭据处理、OpenAI Codex 的 residency 提取，以及未知结束状态下的 Session 续接判断；这些源码样例来自 v1.18.17 到 v1.18.24 的代码概览，发布说明还提到 V1 读取受支持的 V2 配置字段。
官方发布说明将 2.1.250 的变化概括为 Bug 修复与可靠性改进；可观察的代码改动落在 feed.xml 和 CHANGELOG.md，但现有代码概览未显示实现细节，因此无法据此说明具体行为影响。相邻版本 Runtime Prompt 的唯一差异是账单头中的版本标识更新，工具数量及定义没有变化。Static Prompt 当前不可用，不能据此判断其是否变化。
官方发布说明显示，`--restricted` 会移除默认命令、代码执行工具和 WebFetch（除非通过 `--tools` 指定），将文件工具限制在工作目录内，拒绝 `bypassPermissions` 并忽略用户、项目和本地设置；这改变了 Agent 的执行与信任边界。Session 机制方面，跨 Session 的 SendMessage 明确回复会送到父 Session 的对话；官方还修复 Tool Definition 在 OAuth 刷新及恢复时变化造成的 Prompt 缓存未命中和扩展思考 Context 丢失，并调整桌面 Session 清理与后台 Worktree 锁定。Workflow Tool 的 Runtime Prompt 明显精简，工作流脚本参考移入 workflow-authoring Skill；其通用 Tool Schema 数量仍为 30，Artifact、SendMessage、Workflow 三项定义有修改。Static Prompt 基线不可用，因此不据此判断 Static Prompt 是否变化。