# 更新日志 CodeBuddy Code 的所有重要更新都会记录在这里。 我们遵循 [语义化版本](https://semver.org/spec/v2.0.0.html) 规范。 ## [未发布] ## [2.184.0] - 2026-11-13 ### 🎉 新功能 - **非 WorkBuddy 宿主可开启 macOS osascript 沙箱外执行**：通过 `CODEBUDDY_CLI_CAPABILITIES=sandbox.native-osascript` 显式开启单条字面量 osascript 命令的沙箱外执行能力，沿用现有审批与会话授权；WorkBuddy Desktop 默认行为不变（#178217）。 - **Read 工具返回行区间元数据**：每次成功读取返回本次行区间与文件总行数；截断语义对齐主流实现，部分读取给出下一页参数，单行超长、整文件超 token 上限、offset 越过 EOF 等边界行为统一，ACP 与沙箱通道一致，提示路径在工作目录外使用绝对路径（#179730）。 - **usage_update 新增 model_calls 指标**：按 step 下发每次模型调用的耗时、首字延迟、结果、尝试次数、结束原因与实际模型，随会话记录落盘并被 `session/resume` 回放；客户端在 `_meta['codebuddy.ai'].modelCallMetrics` 声明后才下发（#179641）。 - **文件权限兜底审批支持会话级目录授权**：经校验的目录授权可覆盖本次会话；无法提供目录授权时沿用原有命令审批规则。 - **智能体目录列表默认稳定排序**：Web UI 目录顺序固定为创建序（新的在前），应答/干活不再使行跳位；「按状态动态排序」开关可恢复旧行为（默认关闭）。 - **左侧菜单支持固定会话顺序**：开启后列表顺序不随任务状态自动切换（默认关闭）。 - **置顶会话在「最近会话」浮层顶部显示**：与全屏对话页置顶分组体验一致。 - **定时任务支持立即运行**：Web UI 任务卡片新增「立即运行」按钮（循环任务），触发后执行记录即时可见。 ### 🔧 改进 - **定时任务默认留在当前会话执行**：到点前可查看下次执行时间并取消；只有明确指定其他智能体时才另开会话（#177750）。 - **大工具参数预览不再拖慢会话**：减少大工具参数预览造成的卡顿，保留完整的工具参数与执行结果（#174411）。 - **多任务事件公平调度**：多任务事件集中到达时让出执行时间给其他请求，减少任务切换和界面响应等待（#176548 #178589）。 - **标准工具模式提示精简**：不再向系统提示词追加重复的模式纠偏正文；PTC 与极简模式契约统一用 `` 标签包裹，新会话首轮不再向用户消息重复注入模式提醒，仅在活跃历史确认工具模式切换时纠偏。 - **LLM 请求新增归属头**：新增 `X-Feature-Module` 功能模块归属和 `X-Agent-Core: agent-cli` 核心实现标记，便于模型服务区分功能入口与不同 Agent core；无功能模块时显式发送空值，跳过内部请求头时一并清理（#181254）。 - **REPL 后台任务回执结构化**：Bash/PowerShell 转后台时沙箱直接拿到 `{ status, taskId, id }` 句柄而非整段人读文本；`describeTool` 对延迟索引工具自动补全真实 schema；沙箱工具回执中的宿主文本块数组拍平为文本。 - **工具交替循环识别**：两个工具连续交替 20 轮时进入现有工具循环判定流程，减少空转。 - **消息待处理横幅补充说明**：标注「回合结束后自动发送」，消除等待期困惑。 ### 🐛 修复 - **PreToolUse hook 改写参数后的权限判定**：所有权限模式都按改写后的参数判断；hook 返回 `allow` 时 deny 规则仍拒绝、ask 规则仍弹窗；plan 模式下不再直接放行非只读调用；`updatedInput` 不符合工具参数定义时拒绝执行并告知模型原因；审批弹窗、IDE、SDK `canUseTool` 与 stream-json 权限请求展示实际要执行的参数；审批方原样批准时不再重跑 hook（#167309）。 - **PermissionRequest hook 改写参数后同样要过 deny 与 ask 规则**（#167309）。 - **A2A 与 stream-json 同时应答 AskUserQuestion**：stream-json 一方只取 `answers`，其他字段不再写入工具参数（#167309）。 - **沙箱审批现在会执行 PermissionRequest hook**：删除文件、命中文件/网络询问规则、批量删除或申请提权时，审批弹窗出现前先执行 settings 配置的 hook；放行直接执行、拒绝直接拒绝，不再等到超时；同一次工具调用只执行一次（#177445）。 - **WorkBuddy 沙箱询问规则不再被零退出跳过审批**：命中命令、文件或网络询问规则时，即使命令最终退出码为 0 也会触发审批；普通拒绝记录在零退出时不触发重跑的行为保留（#175830）。 - **海外沙箱子 agent 语言默认值**：宿主写入 `DEPLOY_REGION=intl` 且会话未设置语言时，按「默认英文、中文提问回中文」回答，不再固定回中文；国内和已设置语言的会话行为不变（#177634）。 - **TUI 自动探测终端亮暗**：启动时自动探测终端背景亮暗（OSC 11，回落 OSC 10 / COLORFGBG），未显式设置 theme 时按亮暗自动选用 light / dark 主题，修复浅色终端上默认 dark 主题正文几乎不可见的问题；深色系金色恢复亮金 `#fdd663`，浅色系保持 `#9E6A24`，agent-rs TUI 同步对齐（#181764）。 - **WorkBuddy 沙箱安全审计上报恢复**：修复被拦截命令的分析与上报自 5.7 起静默失效的问题；SDK 初始化失败后可在后续命令自动重试恢复（#179664）。 - **目录授权不再重复询问**：修复本地会话批准目录访问后，切换会话或恢复目标执行时重复询问的问题；已确认的目录授权继续限定于原会话和原操作。 - **模型原生拒答不再报内部错误**：保留模型拒答原文，不自动重试，后续对话可继续；不修改 WorkBuddy 展示策略（#167310）。 - **编辑重发后团队协调者可续跑**：修复团队成员完成时，协调者因重复应用旧消息回退而无法续跑的问题（#174441）。 - **删除团队只影响当前团队**：删除时只检查和清理当前团队的成员，其他会话中的团队可以继续运行（#180023）。 - **宿主下发品牌不再被 CLI 兜底覆盖**：官方产物未配置 customization.json 时，非空 `productName` 以宿主下发值为准，系统提示词不再出现产品名写成 CodeBuddy 的情况；宿主下发空值时仍使用兜底品牌（#178969）。 - **PTC 模式 Mod 订阅恢复 Notification**：hasHooks 门禁计入 Mod 的 classic.* / classic. 订阅，不再在 classic 扇出前短路事件；AskUserQuestion 等待期间的 permission_prompt 等通知可正常送达。 - **排队消息等待上一轮历史落盘**：整轮结束自动发送排队消息前，先等待上一轮答复写入会话历史；排队轮次的模型上下文不再缺失上一轮回答。 - **Web UI 新建会话卡死与消息串台**：会话创建回归 frame 域原子执行，新会话消息不再被回答到进行中的旧会话；发送出口解析统一收敛。 - **Web UI 默认模型不生效**：设置默认模型后新建会话即生效（daemon 侧设置变更即时重采样）。 - **Web UI dock 弹窗自动展开又收起**：尊重用户关闭偏好，水合不再自动展开；显式开关行为保留。 - **Web UI 分身工作状态绿点不显示**：启动恢复路径补记绑定状态，工作绿点恢复正常点亮。 - **Web UI 菜单宽度每会话各记一份**：宽度全局唯一记忆，切换会话不再跳变。 - **待发送消息预览显示真实文件名**：file 附件不再显示 (attachment) 占位。 ## [2.183.0] - 2026-11-11 ### 🎉 新功能 - **打开智能体时自动恢复执行开关**：Web UI 设置新增该开关，默认保持点开已结束智能体即自动恢复；关闭后打开只查看历史，需点「重新运行」或发送消息才恢复，刷新页面或重连远端不再隐式拉起已停止的智能体（#177157）。 - **资源管理器多根工作区**：Web UI 可同时打开多个目录，分区渲染、独立折叠/刷新；「添加目录」以追加方式加入工作区并自动同步后端访问权限，「打开目录」保持原有替换行为。 - **会话内展示定时任务执行结果**：定时任务触发后在对话中展示结果条（状态、耗时、失败原因），可一键跳转「执行记录」详情；刷新或会话重载后自动恢复。 - **btw 侧聊 Markdown 渲染**：侧聊回答按 Markdown 渲染（标题、列表、代码块、链接），与主聊天观感一致。 - **目标恢复不自起新一轮**：goalControl `resume` 支持 `continueRun: false`，只恢复目标而不自起 kick-off 轮；宿主在目标暂停期间收到普通消息时，由该消息所在轮结束后继续推进目标，避免与 kick-off 轮抢跑。 ### 🔧 改进 - **主机连接准备放开回环限制**：Web UI 的 SSH 主机添加/连接准备接口不再要求从 127.0.0.1 发起，通过域名或局域网地址访问网关（含 DevCloud 中继等远程场景）即可添加带密码或私钥的主机；保护收敛为网关鉴权本身，启用鉴权时认证失败仍返回 401。 - **会话恢复与目录读取提速**：缩短本地会话恢复和读取命令、技能目录的等待时间（#176548）。 - **云端会话 MCP 并发**：挂载大量 MCP 连接器时，过期的工具目录改为并发刷新，等待时间收敛到最慢的一个；经延迟加载调用的只读 MCP 工具按只读声明并行执行。 - **命令授权按会话复用**：安全中心的命令询问按同一会话和工作目录复用授权；单条命令按命中的前缀规则复用，复合命令原样执行可复用，改动任一命令段后重新询问。 - **工具模式提醒精简**：工具模式相关的系统提示词和会话提醒统一使用英文并兼容旧中文历史；标准模式首轮和模式未变化的后续轮不再重复附加提醒，模式切换、模型能力回退和会话恢复时保留必要纠偏（#178688）。 - **TUI 底栏提示优化**：权限模式切换提示改为 `⇧tab`（自定义快捷键显示实际绑定）；非默认权限模式、输入框有内容或行宽不够时不再显示 `? for shortcuts`；底栏金色加深，浅色终端更易阅读。 - **文件下载与预览动作区分**：文件请求携带 `intent=download|preview` 动作语义，为下载审批与行为分流提供依据，未知取值明确拒绝。 - **桌面窄窗口不再误判为移动端**：移动端判定改为真实设备信号（UA/触摸能力）优先，宽度仅作兜底；窄窗口下回车发送恢复正常。 - **后台任务期间切换权限模式立即报错**：后台任务运行期间切换权限模式当场返回 “Sandbox rules can only change after background tasks finish”，会话级模式保持原值，避免改成新模式后后续每一轮都失败；后台任务结束后切换照常生效（#177895）。 - **图片查看回归保护**：覆盖读图失败提示、历史会话恢复时的图片回放、宿主侧进度与授权，以及不同模型能力下的图片输入差异（#178376）。 ### 🐛 修复 - **交互卡片与插件调用**：修复交互卡片通过延迟工具调用时无法展示、历史恢复后识别错误、交互流程重复执行及错误结果提前反馈的问题；修复桌面会话中支付 Mod 无法调用 App 专用工具、插件隔离环境参数导致连接断开、插件服务更名后卡片调用定位错误等问题；支持包含空格的 MCP 服务名称，插件内部调用不再绕过用户权限规则。 - **agent-home 表面按产品面放行 headless job**：Web UI 派发/恢复/重拉时显式声明产品面，未声明的 headless job 默认不进入自治工具面，云平台流水线等宿主恢复 Agent Teams 可用；无收件人频道的广播接收面同步收窄（#176858）。 - **SendMessage 归因自愈**：跨进程/重启后队员会话丢失团队上下文时，凭创建时写入的身份字段自愈归因，完全外来的会话仍拒绝（#177114）。 - **TeamCreate 支持持久化**：宿主设 `CODEBUDDY_TEAMS_PERSIST=1` 后显式创建的团队容器不再被会话退出清理，工具结果新增 `Team dir` 行标明落盘路径（#176860）。 - **团队队长工具模式重放失败**：修复启动后台智能体并成为团队队长后，宿主重放工具模式配置导致后续消息和队员回信失败的问题；配置错误给出明确提示，自动续跑遇到确定性配置错误时保留未读消息并停止重复唤醒（#177757）。 - **工具模式切换被错误拒绝**：修复仅开启工具模式能力的客户端切换模式被错误拒绝的问题，角色选择权限、连接归属和模型能力限制保持独立生效（#178688）。 - **自动审批误拒命令**：修复自动审批在部分工具模式下无法读取本地上下文、导致命令被错误拒绝的问题（#178178）。 - **目标 recap 误弹**：无参 `/goal` 的状态查询改走独立的 `recap` 动作，`snapshot` 恢复静默语义，宿主 attach / 换 runtime 后不再误弹「当前没有目标」。 - **已完成目标不再复活**：目标达成或不可达后，后续 reconcile 不再从历史中复活目标并重挂 Stop hook。 - **改目标 / 恢复后不再评估被打断的那一轮**：Stop hook 对 cancelled / interrupted 回合跳过目标评估，避免白等一次模型调用、多出「Goal evaluation unavailable」或误判「已达成」。 - **目标暂停能停掉评估**：目标 Stop hook 评估支持中止，暂停 / 清除 / 换条件时立即停止仍在运行的评估；评估期间恢复或换目标让当前轮接着跑，不再与客户端排队消息抢会话。 - **进程内会话目标控制**：进程内 server 会话（Harness）支持目标的暂停 / 恢复 / 编辑 / 清除；`/goal` 提问的历史记录与 ACP 同形，宿主投影时不再露出命令原文或把状态行当成提问。 - **`codebuddy agents` 启动崩溃**：修复入口首帧没有当前会话时报 `Cannot read properties of undefined (reading 'id')` 的问题。 - **AskUserQuestion 参数校验前置**：一次超过 4 题时在弹框前返回参数错误并提示拆分调用，选项数与标题长度校验同步对齐，避免作答后才被拒绝。 - **加固系统无法创建空文件**：专家团等需要先落下空输出文件的任务不再失败，覆盖已有文件时正确清空。 - **会话偶发卡在「准备中」**：插件运行时刷新挂起时，提交链路的等待增加 5 秒上限，超时后放行，会话不再卡死。 - **REPL 子工具失败被掩盖**：REPL 脚本正常结束时，子工具失败不再被完成结果掩盖，模型可收到失败摘要；折叠界面保留子工具原有报错，不再重复汇总错误数量（#177633）。 - **REPL 沙箱加固**：暴露给沙箱的 API 在收到非法入参时不再在宿主侧同步抛出未转换的异常，阻断经异常构造器取回宿主能力的逃逸路径，并补充全向量回归测试（#177715）。 - **fork 会话继承源工作区**：从会话 fork 的新任务继承源会话的工作目录与上下文，显式选择的工作区仍最高优先。 - **文件下载越权访问收口**：下载动作接入审批校验，授权范围为工作目录与附加目录，含 realpath 复核防符号链接逃逸，本地与远端链路一致。 - **Windows 添加 SSH 远程主机失败**：修复本机探测与安装脚本被权限检查误判为「不安全」而拒绝执行的问题。 ## [2.182.0] - 2026-11-09 ### 🎉 新功能 - **会话目标宿主控制**：宿主可管理可冷恢复的会话目标，运行中编辑复用当前轮次，暂停和清除仅停止自动续跑；敏感文件审批在异常和超时时遵守配置策略（#175475）。 - **TUI 底栏状态项粒度配置**：支持按 `tui.statusLine` 配置底栏可见状态项（`model` / `reasoning` / `agents` / `shortcuts` / `permission` / `thinking` / `shells` / `git-branch` / `context-remaining` / `tokens`）；未设置保持默认全显，空数组隐藏全部可配置状态项（MCP 错误、IDE 选区等事件态提示不受影响）；新增 `git-branch` 分支段，非 git 目录自动隐藏。 - **新增 `/new` 命令**：保留终端已有内容并开启全新对话，沿用当前会话设置；旧对话仍可通过 `/resume` 恢复。`/clear` 继续清屏后开启新对话。 - **桌面端 osascript 审批执行**：macOS 固定支持在沙箱外执行单条 osascript 命令，默认权限下通过通用审批卡片展示多语言风险提示，可选择仅允许本次、会话内允许或拒绝；完全访问模式免审批，普通命令 allow 规则不能免审批；会话授权只按程序名复用，不跨会话、不持久保存；管道、复合命令、动态展开和路径形式的程序调用不通过该专用出口放行。 ### 🔧 改进 - **自定义排除路径**：接入自定义不自动备份路径和直接删除路径，与原有内置排除规则分别合并生效，覆盖 macOS、Windows 和 Linux 执行入口；排除路径统一通过新版 `SetExclusionRules` 协议下发，不再使用备份开关请求中的旧排除字段。 - **长会话压缩内存优化**：不再专门保留压缩前轮次用于运行中回退，降低长会话多次压缩后的内存占用；压缩后的文件和对话回退保持可用，已保存的旧对话仍可查看（#176056）。 - **模型输出背压**：模型输出消费变慢时暂停读取上游数据，避免未读内容持续积压占用内存；继续消费后保持输出完整，停止任务时正常释放连接。 - **流式输出内存与连接释放**：降低大段流式输出的额外内存分配，并在输出处理提前退出时正确关闭响应，避免已中止的响应继续传输（#176056）。 - **每轮用量事件**：本轮结束事件补齐 token 用量，主线程轮次与子 Agent 轮次结束时带上本轮真实模型请求累加后的输入 / 输出 / 缓存读写用量及应答模型，未触达模型的轮次不携带用量。 ### 🐛 修复 - **ACP 工具审批拒绝**：审批拒绝不再错误终止整轮任务，危险操作仍被阻止，拒绝作为工具反馈交回模型；真正的取消和计划拒绝保留停止语义。 - **工具循环误报**：连续读取不同文件不再误报工具循环；规则命中后先做 jev 复核，确认不是重复执行就继续，不再弹出确认。 - **会话恢复地址来源**：本地缓存的服务地址缺失或过期时，恢复会话仍能使用同一份产品配置中的地址，并在回放失败时保持进程存活，避免宿主反复重启会话。 - **MCP 会话失效后长期断开**：远端 MCP 服务端回收会话后，工具列表请求与重新连接不再互相打断，重新连接不会中断正在进行的连接，也不会误关新建立的连接（#175004）。 - **云端沙箱 ViewImage 读图失败**：修复图片占位符给出的 blob 路径在沙箱内不存在，导致首次读图必然失败、模型需绕路查找上传文件的问题。 - **Web UI 首次连接 502**：新建后台智能体时等待 worker 地址完成注册，避免 ACP 首次连接因启动竞态返回 502（#176308）。 - **新建智能体与主输入框保持一致**：工具模式展示和提交独立继承主会话当前模式，PTC、极简和创造模式不再回落到标准模式或出现跳动；独立工具模式不携带不支持的 Plan 循环，关闭主 Agent 总闸时 shipped 模式安全回落；创建同事和恢复会话时保留继承的工具模式（#176308）。 - **后台协作会话消息积压**：忙时不再排队等到超时，超过时限自动插空投递，任务不再看起来卡死。 - **看板与私信操作失败指引**：任务不存在、重复完成、缺验收材料等错误直接说明缺什么、该怎么补，不再盲目重试。 - **后台协作长会话上下文治理**：上下文线性增长到阈值或临近模型窗口上限时自动压缩，避免整段历史反复重发造成的高成本与无响应。 - **暂停同事状态更新**：频道 @ 到已暂停的同事，或该同事自己发言后，左侧列表和频道成员行会一起离开「已暂停」，改显示当前活动。 - **左右运行状态对齐**：左侧显示运行中时右侧输入框同步变为可停止，不用等模型吐出第一个字；网络断开本身不会把任务改成失败或空闲。 - **新建智能体输入框锁定**：新草稿继承工具模式，但主会话正在跑不会把新输入框锁成运行中。 - **后台智能体运行状态滞后**：修复没有首个 LLM 帧时的运行状态滞后，并去除无 messageId 的镜像流重复输出。 - **频道 @所有人**：广播只用来同步上下文，不再让每个同事显示被点名；没有新内容时保持沉默，空回复和就位确认不会再转给其他人或用户（#176125）。 - **纠偏私信**：私信可以标明不用回复，对方没在跑时不会被这条私信叫醒；建同事不填权限时默认完全访问；私信可以用唯一的名字找到人，创建结果可直接读到编号（#176125）。 - **分身频道回执**：主会话收到频道信封后按 `SpeakInChannel` 处理，不再把 @ 分身误当成 1:1 私信，避免答案只落到私聊（#176125）。 - **频道处理中提示**：改为消息区浮层，成员开始或结束工作时不再插入或移除虚拟消息行，不改变历史消息的滚动位置（#176125）。 - **Goal 启动阶段取消**：暂停替换运行控制器后，启动阶段取消不再被收成内部错误（#97819）。 - **Goal runtime 回收窗口取消**：启动取消时不再误报为内部错误，该竞态稳定收口为正常取消（#97819）。 - **行内补全提示占位**：修复首个字符不置灰、看起来像用户已输入内容的问题。 - **文件回退菜单误报**：重复编辑已有文件后，回退菜单不再误报"没有代码变更"（#176056）。 - **代理规则查询超时**：同一地址在 5 分钟内已有可用代理结论时沿用该结论，应用短暂卡顿时模型请求不再报「检查网络」；从未查询过的地址和明确拒绝的情况仍按原方式报错（#174582）。 - **工具调用 ID 复用**：模型在后续对话中复用工具调用 ID 时，历史记录配对错误导致服务报错、对话无法继续（#172950）。 - **工具结果文件被覆盖**：同一会话复用工具调用 ID 时，大工具结果文件不再被后续输出覆盖，保留独立的完整结果及历史读取路径（#172950）。 - **root 用户粘贴图片丢失**：切换会话再回来图片消失；历史回放可以显示 root 家目录里的粘贴图和会话附件（#175324）。 - **`/new` 重复打印欢迎信息**：新建对话时不再重复打印欢迎 banner 和命令回显，保留已有终端内容；`/clear` 仍正常显示新会话的欢迎信息。 - **分支会话目标继承**：修复分支会话错误继承源目标的问题，保留普通会话的目标恢复以及分支独立设置、暂停和清除目标的能力（#175475）。 ## [2.181.0] - 2026-11-06 ### 🎉 新功能 - **插件评估 `plugin eval`**：新增 `plugin eval` 与 `plugin eval init`，支持插件评估用例、消融对比、免费及模型评分器、MCP mock 与录制回放，生成 JSON 与本地 HTML 报告；成本与预算使用网关积分，通过 `--max-cost-credits` 设置上限。 - **插件测试 `plugin test`**：新增 `codebuddy plugin test` 命令，在插件目录下运行自带测试文件，测试可像插件一样调用各项能力，也可在最底层注册 hook 模拟宿主应答，逐个输出通过与失败原因，插件作者在本地即可验证 hooks 行为（#168929）。 - **服务端会话 toolMode**：服务端执行入口支持独立的会话 `toolMode` 参数，按实际模型与宿主准入校验，使用既有运行轮快照控制提示词与工具调用，不改变角色、权限或全局用户设置，供 Harness 模式配置接线使用（#172952）。 - **MCP 权限规则增强**：所有 MCP 服务的权限规则末尾写 `(*)` / `()` 时按整工具或整服务规则处理，整服务 deny 也会隐藏其工具；自定义 agent 的 `tools` 可用 `mcp__<服务片段>` / `mcp__<服务片段>__*` 使用整台 MCP 服务工具，普通与插件服务均适用并统一符号归一化匹配。 - **插件 MCP 命名规则调整**：插件 MCP 服务器改用 `plugin:<插件名>:<服务名>`、工具改用 `mcp__plugin_<插件名>_<服务名>__<工具名>`，同名服务以 `plugin.json` 配置为准；旧服务名的权限规则、禁用列表与 hook matcher 不再匹配插件工具，需按新名重写，插件 MCP 的 OAuth 需重新登录（不兼容变更）。 ### 🔧 改进 - **后台任务流式投递**：支持宿主为后台任务减少流式增量投递，保留完整结果与任务完成通知，降低多任务并发时的事件积压。 - **自动模式审核判定**：自动模式审核在审核模型调用不可用工具或返回格式有误时更容易完成判定，减少操作被误拦截（#175212）。 - **输入框底栏常驻模型与档位**：底栏常驻显示当前模型与思考档位，切换后立即刷新；欢迎头图不再重复显示模型，模型名与档位统一小写；窄终端下提示按行截断，智能体提示与快捷键提示合并为一行；后台 shell 计数与提示并入模型行，窄终端优先截断提示、保留完整计数，空闲态按 ↓ 先进入 shells 与 `press ↓` 提示保持一致。 - **获批命令走沙箱单次 token**：命令获批、命中会话授权或自动批准后，优先使用单次执行 token 在沙箱内执行；token 创建或沙箱准备失败且确认命令尚未启动时沿用本地执行并记录回退原因，启动状态不明确、策略拒绝或取消时不重跑（#162691）。 - **插件与技能加载提速**：多个任务同时启动时复用已安装插件的组件读取结果，减少重复加载，保持加载顺序与会话配置隔离，取消时停止排队中的读取；插件更新与刷新后正确重新加载。 - **插件选项配置规范化**：删除 `CODEBUDDY_PLUGIN_OPTION_`、`PLUGIN_OPT_` 与 `${PLUGIN_OPT:key}`；钩子进程改用官方约定的选项环境变量（仅导出到钩子进程），配置占位符改用 `${user_config.key}`，MCP / LSP / MCPB 共用默认值与枚举过滤规则，缺失配置时给出统一指引（不兼容变更）。 - **MCP 工具输入 schema**：MCP 工具的模型声明保留服务提供的额外字段约束，未声明该约束的对象保持开放，模型声明与实际参数校验使用同一份服务 schema。 - **流式 JSON 每轮用量**：长连接 stream-json 执行期间上报已结算的每轮模型与生成工具用量 / 积分，使用稳定的阶段标识与终态 / 回放快照；会话总 token 与 USD 字段不变，缺失积分保持未知，被中断的请求不再返回上一轮回答。 - **plugin eval 的 MCP 命名**：`plugin eval` 的 MCP mock 复用宿主命名规则，插件替身按完整注册服务键覆盖真实声明，授权与轨迹使用与插件加载器一致的工具名。 - **plugin eval 启动隔离**：`plugin eval` / `plugin eval init` / `plugin test` 的父进程从启动起不读取、展开或连接当前目录与用户的 MCP。 ### 🐛 修复 - **Goal/Stop 评估模型上下文不足**：长会话中评估请求始终携带完整历史；lite 模型装不下时切换到当前会话主模型，没有可用主模型时直接判定评估不可用，不再发送注定超限的请求（#166057）。 - **会话重新附着后后台任务运行期间消息与 MCP**：宿主重新加载历史后会话级 MCP 连接被误判需要替换，导致新消息被拒并提示 10000 错误；现在后台任务运行期间只迁移宿主提供的 MCP 连接，其余保持不变（#170890）。 - **Fork 对话偶现失败**：Fork 点之前存在失败响应用量或失败轮次重试记录时会被误判历史不一致而失败；现统一 Fork 选取历史与持久化校验保留的记录类型（#172708）。 - **大型任务列表反复压缩**：修复大型任务列表导致反复压缩的问题。 - **PTC 媒体结果丢失本地路径**：修复 PTC 模式下图片生成、图片编辑和视频生成的媒体结果丢失本地路径导致产物卡片不显示；HTTP 宿主补齐 PTC 内层工具事件，实时与回放保留经安全审查的最小媒体身份（#173408）。 - **PTC 内部工具父子关联丢失**：修复 PTC 内部工具在 HTTP 实时和历史投影中丢失父子关联与取消信息的问题，保留必要的关联、完成和遗漏事实（#173965）。 - **PTC 计划审批前不展示完整计划**：修复 PTC 计划审批前不自动展示完整计划预览的问题，用户可先核对计划内容再确认执行（#173973）。 - **云主机添加目录误报与工具报错展示**：桌面版切换到云主机后「添加目录」可正常确认，不再误报「这不是一个目录」；工具调用失败时报错改为 ERROR 标签加错误态底色并自动换行，不再截断（#174027）。 - **编辑重发提前切换对话历史**：修复编辑重发在新消息被接受前就切换对话历史的问题；接受前取消或失败保留旧对话，接受后按选定分支继续并支持中断后的文件回退恢复。 - **Agent Home 审批与问答闭环**：修复同事身份绑定、跨会话审批回投、私密数据传递、收件箱控制和 Web UI 状态同步在重启、并发与跨进程场景下可能停滞的问题，后续模型轮次和历史答案保持一致。 - **TaskCreate / TaskUpdate 参数提示**：修正 REPL 中参数提示，明确使用 `taskId` 更新任务状态，避免模型传 `id` 导致校验失败（#174632）。 - **Web UI frame bus 502**：修复 Agent worker 冷启动或退出时反复出现 frame bus 502 的问题，连接现在短暂等待后有界重试并正确收敛到离线状态。 - **手机浏览器输入框换行**：手机端软键盘回车键改为插入换行，发送由右侧按钮完成；桌面端 Enter 发送、Shift+Enter 换行不变。 - **自定义模型额度不足反复重试**：修复自定义模型返回余额不足或账户欠费时仍反复重试的问题，直接显示额度不足提示，普通限流仍按原策略重试。 - **缓存服务地址不一致**：修复启动时缓存的服务地址与模型列表不一致导致会话恢复失败的问题，并防止请求结束后错误处理重复写入响应导致 CLI 进程退出。 - **小程序 / App 技能任务计数**：小程序和 App 里实际调用技能后会计入成长计划的技能任务，同一次技能调用不会在之后的对话里被重复计数（#173264）。 - **权限切换后沙箱规则更新**：修复 Harness 本地任务切换权限后需等待下一轮消息才更新沙箱规则的问题，切换时重新下发当前沙箱会话的持久规则并保留本轮临时授权，同代已应用时跳过重复下发（#164767）。 - **后台任务未知退出码拖垮会话**：内部「退出状态未知」哨兵不再作为 ACP 终态退出码下发（改为 null 并附明确结束原因），单个畸形更新帧不再关闭 live 会话订阅，停止的后台任务不再表现为「agent 进程意外终止」（#174553）。 - **macOS 默认删除放行**：补齐 macOS 当前用户 X 子树及路径别名的默认删除放行，保留显式限制，不从非标准 TMPDIR 推导兄弟目录。 - **连接器恢复后工具仍不可用**：修复连接器短暂异常恢复后工具仍显示不可用、重连时错误报告工具已就绪；重连后立即刷新工具目录并避免旧请求迟到结果覆盖，后台任务运行期间连接器重绑定失败后不再重试的问题也一并修复。 - **MCP 工具失败错误说明**：MCP 工具失败时显示服务端错误说明，恢复会话、stream-json 输出、REPL 和插件钩子能正确识别失败，经 DeferExecuteTool 调用时保留错误码，工具返回错误后仍可恢复后续请求。 - **插件 userConfig 默认值**：插件函数钩子按 `userConfig` 解析默认值、用户设置与 `--settings`，运行模块前校验并在公开配置变化后重载；bundle / 创作 / 导出包改用 `userConfig..default`，不再读取 manifest 顶层 `options`；`userConfig` 每个字段必须声明 `type` / `title` / `description` 且键名匹配标识符规则，不合规声明会阻止组件加载（已有包需重新构建 / 安装 / 导出）。 - **SSH 连接失败缺日志**：连接失败及远端会话 attach 失败时在本机日志记录失败原因（`[HostConnect]`），便于定位 Windows 等平台连接问题。 - **Windows SSH 认证后仍失败**：修复 Windows 上认证通过后因清理临时日志失败而返回 SSH 连接失败（HTTP 502）的问题。 - **stream-json 终态文本**：stream-json 输出正常结束时包含终态前到达的全部回复文本。 - **turn.complete 触发时序**：`turn.complete` 和 `session.measure` 等最后一条响应写入历史后才触发，hook 读到的回答和用量不再偶尔缺少这条响应；进程在后台配置清理结束前关闭时退出码不再变成 1（#168929）。 - **插件运行时与沙箱加固**（#168929，随 `plugin test` 一同交付）：hooks / 测试 / 视图 / REPL 的沙箱边界、`next()` 与 `$` 调用的入参与克隆校验、matcher 逐层判断、`next.to` / `next.trace`、流式收尾与中止、session.append / session.end 答案校验，以及深层嵌套数据传递、栈溢出、宿主原型冻结等边界问题得到系统性加固。 ## [2.180.0] - 2026-11-04 ### 🎉 新功能 - **模型可下发 PTC 默认工具模式**：支持通过模型配置 `toolMode` 下发 PTC 默认模式，保留用户显式选择优先级。`CODEBUDDY_CODE_MODE_ENABLED` 统一控制 PTC / 极简模式：TUI 与 WebUI 默认许可，其他宿主默认关闭，关闭后模式选择器隐藏这两项，标准 / 创造模式不受影响；程序化调用需显式设置 `CODEBUDDY_CODE_MODE_ENABLED=1`。模型未下发 `toolMode`、明确 `direct` 或声明无效时隐藏入口；会话中切换到不支持的模型时自动回退标准模式并同步界面，不修改用户偏好 (#167448)。 - **自动记忆附带摘要注入**：自动记忆首轮注入会附带受预算上限约束的 Memory summary，规则类反馈随摘要进入上下文，并补充何时读取记忆正文的决策边界；缺 type 或 frontmatter 的记忆以 unknown 垫底纳入摘要，摘要会过滤疑似凭据行。可用 `CODEBUDDY_MEMORY_SUMMARY=0` 关闭 (#170626)。 - **定制版可打包独立 Web UI 视觉资源**：定制打包新增 `--assets `，一次性放入 `page-logo.svg`、`logo.svg`、`pwa-icon.svg` 即可覆盖侧栏 / 欢迎页 / 登录页水印、浏览器标签图标与 PWA / 通知图标；`--page-logo` / `--favicon` / `--pwa-icon` 仍可按槽位覆盖非标准文件名。仅接受 SVG，打包时校验格式与大小，基座构建未暴露槽位时失败关闭；品牌文案同步投影到 HTML 标题、agent-stage iframe、降级页与 PWA 名称。官方版与未指定槽位保持现有资源 (#153571)。 ### 🔧 改进 - **本地记忆提示词改为自研文案**：主 Agent 的记忆说明、后台记忆提取、挑选相关记忆和陈旧提醒的提示词按新结构重写，示例换成办公与研发场景；记忆类型、文件格式、`MEMORY.md` 目录和工具名不变，已有记忆照常读取 (#153721)。 - **REPL 能力边界说明更清晰**：工具描述、Code Mode overlay 与 production tpl 明确「仅支持 JavaScript、不支持 TypeScript」，列出可用全局（console、setTimeout/clearTimeout、TextEncoder/TextDecoder）与不可用的宿主 API；`fetch`、`require`、`process`、DOM 等未定义时给出替代工具提示。 - **REPL 报错更可操作**：出错帧附带前后文；Pythonism（三元 `if` / `elif` / `True` / `None` / `print` 等）给出可行动的 JavaScript 改写提示；通用解析失败给出说明。`Bash` 反斜杠预检对所有宿主生效，会丢失反斜杠的命令字符串在执行前拒绝。 - **`permissions.deny` 覆盖 REPL 工具目录**：被禁工具从 REPL 目录剔除，精确名搜索与调用拒绝路径补充规则来源（`permissions.deny` / `--disallowedTools`）与「不要重试同名工具」提示，骨架目录列出整工具级 deny。 - **auto 权限模式审批更稳定**：模型或网络异常时自动重试并切换可用模型，每次尝试默认最多等待 90 秒，连续 60 秒无输出时提前重试；可通过 `CODEBUDDY_AUTO_REVIEW_TIMEOUT_MS`、`CODEBUDDY_AUTO_REVIEW_STALL_TIMEOUT_MS` 调整。全部尝试失败后仍不执行动作，保持原有权限边界。 - **AskUserForStructuredInput 等待时长可配置**：新增 `CODEBUDDY_ASK_USER_FOR_STRUCTURED_INPUT_TIMEOUT_MS`（毫秒，默认 10 分钟），超时后撤销表单并让模型继续处理。 - **后台任务状态区分更明确**：区分阻塞等待、进度读取与完成通知，显示当前状态与耗时，避免把空输出或等待超时误判为完成；普通会话与执行任务的代理保留原有等待语义，协调者读取进度后等待完成通知 (#170204)。 - **子代理调度按产品配置过滤**：按产品配置过滤不适用的内置子代理，同时保留自定义代理能力；内置子代理被关闭时提示改用其他可用类型或直接完成 (#162917)。 - **公众号文章附件支持**：支持公众号文章附件的消息格式转换与历史卡片恢复，保留文章标题、来源和原文链接。 - **复制操作反馈**：Web UI 资源管理器、编辑器标签、源代码管理等处的「复制路径 / 名称」操作，复制后提示「已复制到剪贴板」，失败时提示「复制失败」(#170683)。 - **macOS 沙箱补充常用工具链缓存放行**：补充 Homebrew（含 Intel / Rosetta）、pnpm store、nvm 下载缓存与 Yarn 全局包缓存默认放行规则，保留已有自定义权限限制。 - **移除外部 Agent 目录的默认沙箱放行**：保留共享技能目录，已保存的用户配置不做定向清理。 - **Web UI 长名称截断可读性**：资源管理器根目录名不再被隐藏按钮挤占宽度；最近会话标题与任务模版描述被截断时可悬停查看全称 (#172160)。 ### 🐛 修复 - **历史敏感映射缺失与思考明文回流**：完整映射照常还原，缺失映射的内容保留密文，避免整轮对话失败；模型思考内容保持密文，不再随后续请求以明文发送 (#167109)。 - **轮次进行中「复制请求 ID」缺少 traceId**：工具由宿主执行、轮次尚未结束时，思考帧与 `tool_call_update` 等 live 帧现在也会带上当前前台 run 的 `codebuddy.ai/traceId`；已自带 traceId 的帧不覆盖 (#130672 #172287)。 - **MCP 仅返回结构化结果时模型误判无输出**：部分 MCP 工具只返回结构化结果时，模型不再只看到 "(No output)" 并误判为没有数据。 - **同名插件市场换源后安装失败**：另一进程仍持有旧市场缓存时，安装或刷新插件不再失败。 - **团队任务冷启动续跑**：修复重启后继续团队任务时唤醒已有成员可能报错中断、同一次执行中先派出再继续成员时进度关联到较早调用、正常退出后成员被永久结束无法唤醒、以及重启后首次继续时未及时恢复团队身份导致成员仍暂停等问题 (#171597)。 - **含中文的 UTF-8 文件被 Edit 误损坏**：修复文件编码探测在采样窗口恰好截断中文字符时误判为 GBK、编辑后整文件中文被重编码损坏的问题 (#172447)。 - **NotebookEdit 说明更清晰**：修正单元格 ID 与插入 / 删除说明；工具参数、执行逻辑和默认开关保持不变 (#168401)。 - **REPL 工具与运行时全局不可再被覆盖**：REPL 中已提供的工具名和运行时全局不能再由代码覆盖，后续调用仍使用原来的工具；工具从当前目录移除后，再覆盖或调用该名字会说明已不可用，并提示重新查看当前可用工具。 - **自定义模型不再携带平台身份请求头**：自定义模型直连第三方端点时不再附带企业、用户等平台身份请求头，身份信息不再随请求发往用户自配的第三方服务；经官方网关转发的自定义模型与内置模型行为不变 (#172062)。 - **REPL 工具在压缩对话后保留**：避免稀疏 toolsUpdate 清空已注入的 Bash / ViewImage 与 MCP methods (#170792)。 - **压缩后仍可回退**：手动或自动压缩对话后，双击 Esc / `/rewind` 仍能选择压缩前的提问，恢复代码和对话后回到压缩前状态；PTC / Code Mode 下压缩前每轮的文件改动也能正确显示并可单独回退 (#172098)。 - **长会话恢复变慢**：修复恢复长会话时重复扫描历史消息导致响应缓慢的问题。 - **`/goal` 评估模型不一致**：修复会话中切换模型而全局配置模型不可用时，`/goal` 每轮结束都提示「Goal evaluation unavailable」、无法判定完成的问题；Stop 评估现在使用与当前会话一致的模型 (#168973)。 - **`/goal` 长循环上下文膨胀**：修复 Stop feedback 同一轮被写两次、且每轮重复注入整段续跑约束的问题。反馈只经 Stop hook 的 `continueRequest` 单通道写入，只在上下文里没有该约束时补发全文，其余轮次只回 `[条件]: 评估理由` (#170322)。 - **Vim INSERT 模式误中断**：修复 Vim INSERT 模式按 Esc 切换到 NORMAL 时误中断正在生成的回复；保留 NORMAL 模式和标准编辑模式下的 Esc 取消能力 (#171819)。 - **`/clear` 重复执行**：修复粘贴内容后首次按回车执行 `/clear` 时命令被重复为 `/clear/clear` 并误触发模型请求的问题 (#171977)。 - **Windows 搜索不进入 junction 目录**：Glob / Grep 在 Windows 下默认跟随链接目录，junction 下的子目录和文件不再从搜索结果中缺失 (#169375)。 - **Windows 连接 SSH 远程工作区失败**：修复 Windows 上准备成功后连接立即失败并提示 SSH 连接失败（HTTP 502）的问题。 - **子代理内置工具清单与 MCP 声明不能配合**：支持空内置清单下直接使用已授权的 MCP 工具，恢复 MCP 服务选择器与服务级通配匹配，同时保留精确 MCP 工具限制、安全校验及会话隔离。 - **Web UI 历史会话列表重复**：修复因路径大小写不同而重复显示同一会话的问题 (#170788)。 - **Web UI 写入文件预览区高度塌陷**：修复 Agent 写入文件时编辑内容预览区只能看到一条缝、无法完整查看文件内容的问题。 - **Web UI 分身切换模组入口闪烁**：从智能体切回分身时左侧栏模组入口不再闪烁 (#170455)。 - **输入与长草稿编辑体验**：修复连续输入与粘贴交界时长内容绕过粘贴折叠的问题；限制长草稿和历史召回的可见编辑区域并跟随光标，避免输入框挤出屏幕和大量重绘；改善小尺寸终端下的输入与导航。 - **被叫醒的智能体状态闪烁**：被同事或频道来信叫醒继续工作的智能体在执行过程中如实显示为运行中，对话页不再在「已完成」与「思考中」之间反复闪烁。 - **Agent Home 收信编造与漏收**：修复协作成员在收信频繁、上下文较长时回合收尾反复自行编造「下一条来信」并被拒绝（`REFUSED: FABRICATED MESSAGE`）的问题；同时避免被拒的编造内容导致之后的真实来信被误判为重复而漏收 (#172140)。 - **关闭敏感信息保护后无法更新长期记忆**：修复该问题。 - **内置 devcloud 中继网关地址被覆盖**：默认地址改为 http；在「网关设置」中修改并保存的内置网关地址不再被默认值覆盖回 https。 - **定制版用户数据目录分裂**：MCP 配置、内存监控与崩溃诊断、企业策略缓存全部跟随客户配置的用户目录，不再回落到官方目录；后台任务、daemon 与恢复指引改用客户二进制名；定制打包同步替换文档中的用户目录、项目目录与指令文件名 (#153571)。 - **REPL cell 被用户停止的文案**：明确归因为「the run was stopped by the user」并提示不要重试，不再与超时共用疑似故障的文案。 ## [2.179.3] - 2026-11-03 ### 🎉 新功能 - **Windows / Linux 桌面端新增标题栏菜单与托盘**：标题栏左侧新增菜单按钮，可打开原本只在 macOS 菜单栏里的设置（如切换内置 / 外置 CLI、退出时停止后台服务）；新增托盘图标，可显示窗口、退出或停止后台服务并退出。行为变化：关闭窗口默认最小化到托盘，不再直接退出；如需恢复关窗即退出，在托盘菜单或标题栏菜单「服务」中取消勾选「关闭窗口时最小化到托盘」。macOS 行为不变。 ### 🔧 改进 - **企业安全中心支持读取前敏感检测**：敏感保护中可开启「文件读取前检测」（`preReadDetection: true`），开启后 Agent 读取文件（含编辑已有文件前加载原文）会在内容进入工具前扫描敏感信息，命中时按企业规则给出的选项处理；未下发或个人版保持原有行为 (#144925)。 - **沙箱执行遵循企业统一下发策略**：遵循企业统一下发的程序黑名单、网络严格模式、拦截恶意网站和 HTTP 请求拦截策略；企业统一下发的自动备份开关、备份总上限与单文件大小上限同样生效；企业未下发的项继续沿用本地设置 (#144925)。 - **启动阶段并发加载与 IO 优化**：并发发现项目规则和加载自定义命令，本地缓存改为异步原子读写；减少启动时无关设置合并、重复工具参数转换和主 Agent 展示的会话磁盘读取，模型配置已就绪时首屏模型展示不再等待全部 Agent 注册；ACP SDK 加载延后到首次连接，本机标识异步获取，避免原生命令阻塞启动主线程。 - **WebSearch 工具结果默认跳过敏感信息检测**：保留已有密文保护、外发检查和工具执行审批。 ### 🐛 修复 - **MCP 完成 OAuth 后仍显示待认证**：修复 MCP 服务器授权并成功连接后仍显示「待认证 / 连接失败」的问题；连接成功时同步清除此前 401 留下的 needsAuth 与错误信息，Web UI 不再让过期认证标记盖住已连接状态，并区分「未连接 / 待审批 / 连接失败」(#140189)。 - **文本形式的短错误码显示错误**：修复自定义模型服务以文本形式返回 429、500、503 这类较短数字错误码时，错误提示显示请求状态码、而不是服务返回的错误码的问题；字母形式错误码仍按原规则处理 (#167599)。 - **Harness 公共错误丢失产品业务码**：保留 HTTP 400 携带的 402 / 404 / 502 等产品业务码；与 HTTP 状态相同的 429 / 5xx 仍视为状态码，不当作业务码 (#166528)。 - **悬停已退出会话就拉起后台进程**：修复 Web UI 中鼠标悬停在已退出的智能体 / 会话上就拉起后台进程的问题，悬停只预取历史不再启动进程，避免浏览列表时凭空累积数百 MB 内存；真正打开时仍会自动恢复，并直接显示已预取的历史 (#170420)。 - **`--serve` 常驻进程命令行被展示名覆盖**：进程标题改为保留原启动命令（展示名仍在最前），按 `codebuddy --serve` 命令行识别进程的健康检查、取 pid、采样等外部监控升级后不再静默失配 (#170421)。 - **频道任务板下游任务永久卡住**：上游步骤被判放弃后，lead 或用户可用任务更新改写下游任务依赖（改指向替代步骤或解除依赖），原任务编号与历史保持不变；依赖终态的报错给出可执行的下一步 (#170422)。 - **切换数据目录后会话仍写入旧位置**：修复预热激活切换数据目录后会话仍写入旧位置，以及会话目录被清理后首次保存失败的问题；保留目录预热和缓存复用，正常保存不增加文件系统探测，仅在目录缺失时重建并重试一次。 ## [2.179.2] - 2026-11-02 ### 🎉 新功能 - **Web UI 直接切换工作目录**：本机 daemon 的 Web UI 在主对话的目录 chip 菜单里新增「切换工作目录…」，daemon 会以新目录重启（后台任务不受影响），页面随后在新目录重新加载，不再依赖 CodeBuddy Desktop 菜单；同时新增 `POST /api/v1/daemon/workspace` 接口。 ### 🔧 改进 - **AICC 机密模型的端侧判定只看模型标签**：模型目录里带 `enterprise:aicc` 标签的内置模型一律走 AICC 加密（`custom-local:` 自定义模型除外），移除 `AiccConfidentialModel` 产品开关、模型 id 名单配置以及「IOA 内网或企业旗舰版账号」限制；专享版等其他账号类型只要能看到 AICC 模型即按 AICC 逻辑调用，能否看到该模型继续由服务端企业白名单控制 (#127985)。 - **会话初始化取消与超时及时返回**：初始化超时或取消后不再长时间等待清理，失败及时返回且不影响其他会话；减少大量技能初始化时重复的文件检查，以及能力列表与首次执行前重复的资源读取；补齐初始化前置读取的取消响应和各阶段耗时记录，便于定位慢启动 (#163909)。 ### 🐛 修复 - **云主机切换工作区时目录选择反复失败**：修复反复报 `HOST_PREPARATION_DIRECTORY_FAILED`、点「打开目录」没有反应的问题；切换时显示进行中并拦截重复提交，复用已打开的目录租约直接连接（不再多等一轮探测），失败原因显示在弹窗内。 ## [2.179.1] - 2026-11-01 ### 🎉 新功能 - **频道历史完整保留与结构化读取**：频道历史不再按 800 字符截断正文，模型回看时标出消息 kind 并合并同一任务生命周期内的重复更新；长消息在时间线中默认折叠，展开后可查看全文。`historyFormat=json` 返回带 `id`、标准化 `kind`、完整正文、任务载荷和分页游标的结构化记录，可按 `kind` 和 `pinnedOnly` 过滤；当前安全窗口没有匹配项时返回 `olderCursor`，可用 `beforeCursor` 继续扫描。 - **频道任务板支持协调角色、DAG 依赖与复核**：ChannelTasks 可创建/派发协调角色与依赖，提供 `review` 动作提交带证据的接受或返工决定并标注 reviewerRole，依赖步骤据此推进或重开；`listFormat=json` 回显协调、复核、依赖、`stepId` 与远端状态，`correlationId` 让 specialist/critic/arbiter 共享同一协调批次。 - **频道消息编辑、撤回、固定与成员静音**：频道消息支持编辑、撤回和固定，资料面板展示固定的决策与结论；可按成员静音，静音成员仍保留在历史中但不会被频道自动唤醒，静音当前轮次 baton 成员时看门狗会立即记录跳过并交棒。 ### 🔧 改进 - **频道任务与历史工具统一返回机器可读错误码**：ChannelTasks、SpeakInChannel 和 Agent Home 编排工具的失败路径统一带上 `error` code（如 `BOARD_READ_FAILED`、`COMPUTER_UNAVAILABLE`、`FABRICATED_INCOMING_MESSAGE`、`COORDINATION_ROLE_REQUIRED`、`COORDINATION_CORRELATION_REQUIRED`、`KICKOFF_NOT_POSTED`），调用方无需解析人类可读文案。 - **频道任务远端 MR/PR 状态探测**：已完成任务中的 GitHub / CNB / GitLab 引用会做只读远端状态探测，结果以内联 `remoteStatus` 返回；探测不可用时保留 `remote-review=pending`，不改动本地任务板。 - **频道空闲时仍推进逻辑时钟**：持久化 idle ticker 在频道安静时继续推进逻辑时钟、执行复核 SLA 超时和 outbox 排空，并对超时占用的 claimed 任务做有界去重 nudge。 - **`lossless` 的 `acp-v2` 订阅增加积压保护**：积压到 4096 帧后不再入队文字、思考增量和工具参数增量，完整条目、工具开始、最终参数、生命周期和用量照送；开始丢弃时告警一次，`sessionEventBacklog()` 多返回最大积压、丢弃帧数与格式化/回调耗时 (#166248 #163262)。 - **远程主机自动替换过期后台服务**：遇到身份已确认但配置过期的旧服务时，在同一次连接中自动替换并重连；Web UI 手动重试会重新准备连接租约，新开通的中继账号同时获得 Web 绑定所需代理权限。 - **WorkBuddy 仅在 plan 模式暴露 Plan 子代理**：非 plan 模式的会话不再向模型暴露内置 Plan 子代理 (#164123)。 ### 🐛 修复 - **专家团积分用尽后仍唤醒主 Agent**：主 Agent 或任一成员积分用尽后，团队消息先保留，等用户下一次发送消息再继续处理；成员因积分用尽失败时带上与主会话相同的错误码 (#155225)。 - **停止子 Agent 时取消终态抢跑**：改为等这一轮输出写完（最多 3 秒）再发取消终态，终态之后不再转发该轮输出，进程内 Harness 不再把迟到输出判为协议故障 (#161833)。 - **旧 ACP 入口 `session/steer` 提前回 `idle`**：主 Agent 已答完、提问还在等成员时，插话先进入缓冲并叫醒主 Agent，被取走后才回 `steered: true`；叫醒失败、被新请求抢占、用户取消等场景会撤回插话并回 `idle` (#167576)。 - **团队成员恢复执行时继承已结束的 hook 上下文**：修复因此跳过模型请求的问题；ACP 将内部空响应错误按失败上报，保留正常完成和真实用户取消行为。 - **`hy4-dev` 图片直传模式误判**：修正 `hy4` 前缀把 `hy4-dev` 判为非多模态的问题，并支持模型级 `imageInputMode` 远端配置 (#168519)。 - **主理人收不到成员结果**：中断或会话卸载后保留未处理结果并在恢复时继续送达，主理人完成当前回复后成员仍可在后台继续工作 (#163063 #161795)。 ## [2.179.0] - 2026-10-30 ### 🎉 新功能 - **Web 插件管理可直接查看和管理 MCP 服务**：MCP 筛选下会列出 mcp.json 中配置的服务器，显示连接状态、传输方式和来源，并支持启用/停用、重连、删除与发起认证；插件自带的服务器在此只读；同时提供多种能力的插件在 Skills 和 MCP 两个筛选里都能找到，种类改由插件自身声明的能力判定，不再靠插件名猜测 (#165860 #166031)。 - **REPL 执行中实时展示内层工具调用**：折叠态按完成态的调用树逐条透出，正在执行的调用显示转圈与实时耗时，长任务不再只剩一行 running (#166646)。 - **Goal 支持附件与更长的目标条件**：可随目标发送文件、图片、资源引用和长文本上下文，暂停恢复保留附件，敏感内容沿用现有审查；条件上限由 4000 提升到 8000 字符。Web UI 目标编辑弹层支持上传、粘贴、拖拽附件以及预览和移除，等待发送时保留新草稿、切换会话取消旧请求 (#97819)。 - **同一会话空闲时可切换工具模式**：终端和 CLI 自带 Web UI 可在标准、PTC、极简与创造模式之间切换而无需清空历史，下一轮同步使用新的调用指导、工具声明和上下文统计，保留原角色、模型与权限；运行中或等待审批时仍禁止切换不同策略。 - **Mod 的 `$` 接口补齐到 2.1.311**：无头运行（SDK / 服务模式）下会话、工具、命令、配置、模型、MCP 等接口可用，`$.session.usage` 返回上下文窗口用量，`$.tool.call` 与 `$.command.run` 在当前会话里真实执行（工具先经权限检查），Mod 可在会话内登记工具、命令和子 agent 并随会话结束回收，`$.config.set` 真正写入设置，`$.settings.read` 支持 `local` / `flag` / `policy` 来源和 `{ key }`，新增 `$.ui.notify`、`$.ui.view`、`$.session.identity`、`$.prompt.media`、`$.prompt.paint`；`tool.check` 的 hook 能读到 `approver` 与 `isReadOnly`，`ask` 只能由人回答；公开类型声明同步到上游 2.1.311 (#160452 #167398)。 ### 🔧 改进 - **Agent Home 频道消息流改为虚拟化渲染**：只挂载可视区域内的消息行，行高实测、窗口外不进 DOM；单频道内存保留最近 1000 条，滚动到顶部自动加载更早历史，长频道滚动与重渲不再随消息数变卡，气泡合并、引用跳转、卡片作答等交互保持不变。长文本消息在挂载时即使用真实高度，避免首帧未测量导致的消息重叠 (#168263)。 - **辅助任务模型失败自动回退**：用户自选的 Lite 模型请求失败时不再只认 401，任何模型错误都先在原模型重试一次，仍失败则恢复默认模型再执行一次，同一会话内后续请求直接走默认模型；此类请求不再叠加请求层退避重试，失败时不会长时间卡住，未登录与取消不触发 (#159950)。 - **频道发言正文上限提升**：由 2000 提升到 20000 字符，超限时显式报错（HTTP 400 `MESSAGE_TOO_LONG`、工具侧提示未发送），不再静默截断；房间历史裁剪仍保留，但会标出被省略的字符数。 - **自动快照跳过未变更文件**：已确认与备份一致、且之后未被修改的文件不再每条消息重读，跟踪大文件后发消息不再明显变慢；确认不了时仍逐字节比较 (#166155)。 - **Bash 沙箱追踪补充阶段**：Galileo 时间线增加策略检查、沙箱首跑、拦截归因和本地重试阶段，内部审批等待关联到沙箱编排并区分等待、授权和实际执行耗时；宿主通道的人工审批补上等待 span，自动审查与审批排队不计入人工等待。 - **请求发起方统计更准确**：修正定时任务、团队消息和插件辅助调用的发起方归类，新增请求场景分类；用户插话仍按用户输入统计，工具续轮不重复打标，辅助调用的已知用途保持固定类别。 - **上下文压缩摘要在多会话下跟随当前会话模型**：Harness 多会话时以 `requestOptions.model` 优先于 `options.model`，显式指定的压缩模型仍然优先 (#166900)。 - **会话资源配置改为 capabilitiesRoots**：以稳定资源 ID 和执行位置描述会话资源，常规 skills/agents 目录与插件包一并由既有扫描器加载，保留已安装插件配置与技能元数据 (#163268)。 - **Harness 上报 skill_info 回填身份**：进程内 Harness 上报时回填 run 级 userId / enterpriseId，并按会话技能加进程技能查找 skillId。 - **清理已废弃的测试和 SDK 示例入口**：统一维护仍在使用的验证资源，减少开发者误用历史流程。 ### 🐛 修复 - **会话历史清理开关不再随环境继承**：交互式入口不再把 `CODEBUDDY_SESSION_HISTORY_CLEANUP=1` 写进自身 `process.env`，工具、hook、MCP、插件里拉起的嵌套 `codebuddy` 不会继承后按内置 30 天删除会话；读不到用户保留期（`--setting-sources` 排除 USER 档或读取失败）时整次跳过清理，不再回落到 30 天；显式设置的环境变量与 `codebuddy cleanup --days ` 仍然生效。 - **Web UI 状态不再被陈旧快照覆盖**：实时回合仍运行时，频道、侧栏和顶部状态栏优先展示实时运行状态，避免智能体状态在工作中跳回已完成或空闲 (#167429)。 - **Web UI 通知通道 409 不再无限重试**：任何 409 都按连接冲突处理，先释放旧连接再重新获取授权并重建通知流（有次数上限），服务端同时带上稳定错误码 `ACP_NOTIFICATION_STREAM_CONFLICT`；只有 Bearer 凭据的页面也能建立总线连接，认证下沉到 `client_hello` 的 ACP 授权校验，非浏览器客户端仍要求网关密码。 - **远程主机准备失败能看出该修哪里**：本机探测资产问题单独归类为 `HOST_PREPARATION_PROBE_ASSET_UNAVAILABLE` 并带 `assetCode` 与 `path`；`/prepare` 由 502 改为 409 且 `retryable: false`，`/connect` 维持 502 但保留 `reason` / `assetCode` / `path` / `retryable`；远端 ssh 失败按 `dns` / `tcp` / `banner` / `auth` 归层给出提示；探测资产按目标平台只读取所需那份，`.ps1` 固定以 LF 落盘 (#167289)。 - **沙箱内命令已成功不再触发审批或重复执行**：避免重复产生副作用；自动模式下沙箱拦截后保留首轮结果并提示显式申请沙箱外执行；命令转后台后提权拒绝不再被误报为成功；云沙箱中审批放行后点「停止」不再卡死会话，而是以取消收尾 (#166209 #168035)。 - **PTC 模式问答不再十分钟超时**：用户稍后返回终端仍可回答，取消或停止时正确撤回本次问题；Code Mode / PTC 内层工具调用现在会执行 PreToolUse 决策，hook 的 allow、deny 与参数改写在权限检查前生效。 - **工具模式上下文诊断更准确**：按实际模型声明估算工具占用并避免重复计算 MCP 工具，PTC 与极简恢复专用 REPL 调用说明，模式选择不改变真实角色、权限与其他会话。 - **带图会话第二轮不再重复注入图片本地路径**：避免打断模型前缀缓存导致命中率骤降 (#164903)。 - **微信支付卡片恢复显示**：宿主接管微信支付后支付卡可正常显示、查询结果可回填，调用失败时保留错误原因并区分商户订单与支付状态，避免引导重复下单 (#164381)。 - **Agent Home 频道协作修正**：系统入站消息按只读回执处理，出站工具不再暴露入站字段，模型误重放 incoming 会被明确拒绝；跨进程派单提交后任务板按持久化协调版本刷新并显示新任务；REPL 内 Agent 在实时参数更新及长 prompt 超预算时保留任务描述，子代理卡片不再统一回退到 general-purpose。 - **Agent Home 同事统一使用默认权限**：创建、唤醒与定时任务统一使用默认权限，并继承创建者当前有效模型。 - **自定义子代理 `tools: []` 按零工具白名单生效**：不再退化成继承全部工具，`agent/list` 与资源查询原样返回，调用方可区分「未声明」与「显式零工具」 (#167401)。 - **原生 ACP 延迟 MCP 调用不再新增审批**：已授权的调用保留原有授权与执行路径 (#167426)。 - **MCP strict schema 日志刷屏**：无法无损转换时仍降级为非 strict，但日志降为调试级别，需要排查时用 `DEBUG=openai-agents:core` 打开。 - **旧云沙箱伽利略配置不再触发启动等待**：不再消费旧 `CODEBUDDY_GALILEO_CONFIG` 的内容，存在该旧配置的云沙箱中上报暂时关闭，首轮请求不再为此最多等 10 秒；后续恢复上报改由 `CODEBUDDY_GALILEO_CONFIG_V1` 承载（本次未开启下发）(#150453)。 - **定时任务返回聊天可定位到触发消息**：job 只读转录覆盖期间不再错过定位事件。 - **终端连续或长按退格不再插入不可见控制字符** (#168311)。 ## [2.178.1] - 2026-10-29 ### 🔧 改进 - **各模式统一为业务 Agent 的工具策略**：终端和 CLI 自带 Web UI 的标准、PTC、极简与创造模式改为同一业务 Agent 的工具策略，切换模式不再改变角色、所选模型或权限，模式状态按会话同步；子代理保留自身角色与工具限制，REPL 工具目录、调用与授权沿同一会话策略生效，嵌入宿主不再受终端手动模式影响；原生延迟工具保持纯文本结果，MCP 参数按原始 Schema 校验，延迟工具原名与 SDK 别名保持一致的参数转换和诊断，长整数业务 ID 不再在工具包装中提前舍入。 - **底层对话引擎升级**：保持现有对话、工具调用、审批、取消与历史会话恢复行为不变 (#131958)。 - **收紧 Agent Home 的同事消息工具协议**：模型只能执行列表和发送，系统入站回执不再出现在可调用参数中；兼容历史回执解析，绕过 schema 时明确拒绝伪造来信。 - **子代理失败提示补充执行模型**：子代理执行失败时在错误文案的 subagent 后带上实际执行模型，便于区分主模型和子模型。 ### 🐛 修复 - **审批恢复后的执行与二次拦截**：已被拒绝的工具调用在审批恢复后不会再被执行，自动模式下用户已批准的调用不会被二次拦截；内容安全拦截继续显示安全提示而非内部错误；模型偶尔返回格式异常的工具名后，该会话后续对话不再持续报错 (#131958)。 - **PTC 下 REPL 内嵌问答不再重复弹窗**：宿主已托管审批或用户已作答的提问不会被误判为需要再次审批，问答结果以文本形式返回给模型 (#164482)。 - **频道同事不再被同一条消息反复唤醒**：消息已在之前的通知里给过、又不需要他回应时直接收下，不再为它单独唤醒；被 @ 或轮到他发言时照常唤醒，只用一行提示指向之前那条 (#165119)。 - **任务完成通知里同一个文件只出现一次**：同一文件的不同路径写法（如 `/tmp` 与 `/private/tmp`）现在会合并 (#165119)。 - **任务板执行人登记**：登记了实际执行人的任务即使还没人认领，改派后登记也会自动清除；按成员筛选任务时，频道外的实际执行人也会出现在筛选项里 (#165389)。 - **旧版本任务板升级**：Agent Home 已有的任务板不再报错、加载失败，第一次修改时自动转存到新的存储；同事在调用模型之前失败时显示真实原因，不再一律提示去查模型服务 (#165540)。 - **REPL 返回值里的图片可以出现在任意位置**：图片放在对象字段、数组或嵌套结构里都会被识别并展示，不再把整段 base64 当文本发回、被传输上限截断成损坏数据；图片参数写错时给出改用看图工具的手把手指引。 - **服务模式下推送流不再被误判断开**：远程终端等推送流在网络较慢、输出量较大时不再被误判为停止读取而断开，终端输出不再截断或需要重连；只有客户端长时间完全不再读取时才会断开连接 (#165505)。 - **Web UI 编辑器终端切回不再错乱**：在全屏终端程序（如 CodeBuddy Code 交互界面）运行中切到其他页面再切回，不再出现重复状态行、分隔线长短不一等错乱。 ## [2.178.0] - 2026-10-28 ### 🎉 新功能 - **链路追踪页面能按会话找到 trace**：会话列表右键「查看链路追踪」即可打开该会话（含子智能体、后台任务进程）的全部 trace，也可用 `#/traces?session=<会话 ID>` 直接打开；列表新增执行者与工具筛选，span 标题改为「工具名 + 描述」「模型调用 · 模型名」等可读形式，详情页显示执行者与所属会话，可复制会话 ID 或一键只看该会话；列表按时间从新到旧读取、并发会话不再串号 (#164202)。 - **频道人数上限调大，并可在设置中修改**：频道默认最多容纳 12 个 AI 同事（原来 6 个），「设置 → AI 同事 → 频道最大成员数」可改为 2～20；调小上限不移出已有成员，只是不能再加人；人数超限时提示当前上限和修改入口，每轮讨论发言名额随人数相应增加 (#164672)。 - **新增 `/approve` 重试授权**：可选择当前会话最近被自动审查拒绝的动作，记录对该准确动作的一次重试授权；不会直接执行动作或切换权限模式，重试仍需经过自动审查；终端界面完整展示自动审查的拒绝原因、风险与授权等级，以及审查失败或超时提示 (#164700)。 - **Agent Home 支持只读频道与任务执行人登记**：主智能体可只读回看频道发言与任务事件（可分页往前读），不打扰频道成员；任务被私信转给别人时可在任务板登记实际执行人（可为频道外同事），卡片与时间线显示真正做的人，改派、放回或收回认领时自动清除，完成结果记在实际执行人名下 (#165389)。 ### 🔧 改进 - **定制构建全程使用客户身份**：模型以配置的 CLI 名称自我介绍，`/init` 生成配置的指令文件，Web UI 入口页与连接文案使用配置的产品名，skills 提示指向配置的配置目录；官方构建行为不变 (#153571)。 - **Mods 的 `tool.check` Hook 返回 `ask` 语义对齐**：引擎记下发起询问的插件（`ToolCheckResult.plugin`），这类询问只能由人回答；任何权限模式、本会话已记住的允许和自动风险审查都不会替人放行（自动审查仍可拒绝）；ACP 客户端和宿主回调收到的确认只有「允许一次」和「拒绝」(#160452)。 - **server 新增只读 `sessionEventBacklog()`**：返回各会话订阅还没送达的事件帧数，只列有积压的会话、从多到少，供宿主做内存诊断；读取不改变投递 (#161150)。 - **补齐 Harness 模型元数据透传**：支持通过 prompt 的 `_meta['codebuddy.ai']` 发送 `customPassthroughHeaders` 和 `extraFieldsMeta`，沿用请求头前缀白名单与模型转发策略；载荷按执行轮捕获，子任务和延迟调用保持所属轮快照，后续提问省略字段时不沿用上轮值。 - **Web UI 运行状态更透明**：对话底部状态行区分「模型生成中 / 模型正在生成某工具的参数」「某工具执行中」「等待模型响应」，并显示当前步骤已持续时间；代码执行卡片区分「模型正在生成代码」与「正在执行代码」(#164183)。 - **Web UI 长会话更流畅**：头像动画滚出视野或被遮挡即停，伴宠不再让页面每帧重绘，终端标题更新不再触发整界面重渲染。 - **远程主机状态一致、频道数据更可靠**：连接远程电脑后主会话与各智能体看到的主机状态保持一致（回环用本地桌面、已连接电脑转发操作、未连接显示离线），Linux 远程电脑支持桌面操作与剪贴板；同事消息确认送达前不会丢失，任务板或频道目录文件损坏时保留原文件并备份、可从备份恢复。 - **智能体证据核验**：智能体自己编造的「队友来信」被明确拒绝并告知消息不存在；频道任务标完成必须附本机可核实的证据（存在的文件或可解析的提交），缺失或对不上会被拒绝；任务板为已完成任务标出「证据已核验」或「未经证据」。 ### 🐛 修复 - **Windows 进程与句柄**：修复 NPM CLI 连续执行 Bash 后遗留 conhost 进程和原生句柄的问题，交互终端、命令输出和后台任务行为保持不变 (#159867)。 - **网络错误归因**：网络连续中断、重试次数用尽后不再被误判为「模型服务异常」，保持网络异常提示 (#161377)。 - **Web UI 终端**：包管理器脚本启动时内置终端不再命中项目依赖中的同名 `cbc`/`codebuddy` 命令 (#164916)；终端里运行 `cbc` 不再无输出静默退出，残留配置会提示原因和解决办法 (#164062)。 - **Chat 网关思考开关**：显式关闭思考时正确发送 `reasoning_effort: none`；第三方 Chat、Responses 和未设置开关时保持原行为 (#163753)。 - **同事重启接回会话**：切换过会话的同事重启后不再收不到任务和 @ 消息；即使会话长时间对不上，收件箱也会改投到实际运行的会话，不再无限等待。 - **桌面端新窗口通知**：修复「新窗口」页面收不到完成后系统通知的问题；系统通知被拒绝时设置页「发一条测试通知」如实提示失败。 - **远程主机密钥轮换**：主机重建、密钥轮换后不再被「主机密钥已改变」永久阻断——自己的 SSH 配置已关闭校验（`StrictHostKeyChecking no`）时自动重新确认并替换过期记录；未关闭校验的主机保持阻断 (#164092)。 - **Web UI 工具卡片**：复制入口浮于结果区右上角并分别标注「参数」「结果」，桌面端悬停出现、触屏窄屏常驻；执行命令的命令行与输出合并为一张卡片 (#164113)。 - **带图消息显示**：会话标题与气泡不再露出 ``、`@image#1` 等内部标记，「回到这里」按钮移到气泡下方操作行；只发图片的消息正常显示缩略图、刷新不消失，只发图会话标题跟随界面语言，旧标题去掉路径 (#164162)。 - **自动沙箱边界**：修复自动模式下沙箱写入边界与权限判断不一致的问题，仅对工作区、临时目录及明确允许的目录免审写入；沙箱拦截无记录时给出明确的受审查重试提示，完整保留权限拒绝原因和沙箱提示 (#164191)。 - **推送流背压**：修复服务模式下页面挂起或代理停止读取时，文件监听/终端输出/任务列表等推送流持续积压导致内存增长直至崩溃的问题；停止读取的连接会被主动断开，文件监听不再上报内部锁文件 (#164286)。 - **分身卡片**：选中后有明显底色；悬浮提示图片标记显示为「[图片]」，标题单行、摘要最多两行、运行状态显示在标题右侧 (#164298)。 - **私信自动建会话**：给还没开过会话的同事发私信自动起会话并投递，起会话失败时信不丢、稍后自动重试 (#164665)。 - **新建会话使用默认模型**：Web UI 手动切换过一次模型后，新建会话不再沿用那次选择，一律使用设置里的默认模型（项目设置优先）；输入框切换只影响当前会话 (#164976)。 - **频道消息去重与完成通知**：只用任务板干活、不在频道发言的同事不再反复收到同一批旧消息；任务完成通知列出 Issue、MR、commit、证据路径并注明是否经证据核验 (#165119)。 - **智能体切换不跳动**：打开正在运行、历史较长的智能体直接呈现折叠形态，不再先全部展开再折叠 (#165281)。 - **额度用尽提示**：个人、部门和企业额度用尽时，已用数量、上限和周期正确传给界面。 - **插件详情页**：展开部分插件详情不再整页报「页面加载出错」，信息格式不一致也能正常显示，单卡失败只影响该卡片并可重试。 - **任务模板图标**：推荐模版中安全扫描、TODO 清理、测试覆盖率等卡片按类型显示对应图标，不再统一是时钟。 ## [2.177.1] - 2026-10-27 ### 🎉 新功能 - **后台会话预热池**：后台智能体（Web UI 派发的后台会话）默认使用 CLI 预热缩短首次连接时间，后台服务维护 1 个待命进程、新建会话时直接激活，实测首次可连接耗时由约 1.3 秒降至约 0.4 秒；可在 Web UI「设置 - 行为」中随时开关（即时生效），也可用环境变量 `CODEBUDDY_BG_PREWARM_POOL_SIZE` 调整预热数量（0 关闭）(#161405)。 - **额度用尽说明更具体**：额度用尽时会区分个人、部门和企业资源包，并保留原有的备用模型切换。 - **Web UI 新增「显示 REPL 内部工具调用」开关**：默认隐藏内部执行步骤与详情，可随时开启，保留子智能体、回复与必要交互。 ### 🔧 改进 - **子代理派发与任务工具使用收紧**：只有用户、项目指令、skill 或当前 agent / 模式明确要求时才派发子代理，「深入、全面分析」不算授权；TeamCreate 不再因任务复杂而主动建团队。可逆、只读、修复类工作和已授权的操作不再反复确认，授权在原范围内跨轮有效，高风险操作仍需确认。plan 模式强调复用已有实现、最终计划包含背景与端到端验证方式、审批只走 ExitPlanMode，Plan 子代理改为架构设计角色；Explore 收窄为范围明确的定位类问题；任务工具只在 3 步以上、用户要求清单、用户给出多项任务或 plan 模式下使用 (#143786)。 - **桌面端后台服务改用一组固定端口**（56527 / 56528 / 56529，按顺序取第一个空闲的），端口稳定后 Web UI 的通知授权与本地设备状态不再因端口漂移被清空；三个都被占用时不指定端口，回落到原有默认端口 (#163017)。 - **主机管理页新增主机信息悬浮卡片**：主机名旁的 info 图标可查看完整主机信息（主机名、共享者、SSH 账号与端口、全部局域网地址、连接方式、登录方式、中继网关与网关地址、隧道名），他人共享的设备还会展示共享有效期 (#163017)。 - **Web UI「打开目录」弹窗新增刷新按钮**：远程主机目录浏览可显示指向目录的软链接，弹窗静置较久后自动恢复连接而不再卡在加载失败；资源管理器目录树加载长时间无响应时转为可重试的错误提示。 - **IDE 集成终端进程归属检测改为异步并增加超时**，同轮检测复用查询结果，减少 Windows PowerShell 探测对输入和界面更新的阻塞；终端 @文件补全在移动光标进入已完成路径时不再重触发搜索，查询复用工作区索引并后台刷新，模糊匹配分批执行 (#162812)。 - **轮末结算写入上下文类目快照**（`context-usage` fact），历史会话 resume / 回放时可取回类目明细 (#161180)。 - **新增 `sandbox.safeDeleteBulkApprovalEnabled` 配置**：可独立关闭批量删除数量阈值审批，同时保留删除保护和其他权限检查；默认开启，配置刷新后对后续工具调用生效。 - **从远程主机切回本机后，终端接回切换前仍在运行的本机会话**，不再新开 shell、丢失原有输出。 ### 🐛 修复 - **等待提问回答或工具审批时停止，本轮真正结束**：stream-json 模式下本轮停在 AskUserQuestion 或工具审批上时宿主发送 interrupt，不再把取消当成「用户拒绝回答」另起一轮继续执行；本轮未执行的工具调用记为「被用户中断」，先跑完本轮 Stop hook、写出取消终态 `type=result`，再处理排队的消息 (#158327)。 - **Stop hook 要求续跑但续跑未能启动时不再卡在「生成中」**：续跑被拦截、取消或启动失败时，本轮以已有答复写出终态 `type=result`，后续消息不再被一直挂起 (#158327)。 - **REPL 返回的图片支持任意位置**：图片放在对象字段、数组或嵌套结构里都会被识别并展示，不再把整段 base64 当文本发回而被传输上限截断成损坏数据 (#148988)。 - **代码执行返回无效图片时立即给出明确提示**：保留其他结果和正常输出，不再造成后续对话反复丢图。 - **企业微信长回复完整送达**：超过平台单条长度上限时拆成多条依次发送，拆分处代码块在下一条重新打开、表格重复表头，每条等平台确认送达后再发下一条；流式回复无法继续时改为普通消息补发完整内容，最终仍未送达时返回失败并说明原因 (#151881)。 - **修复团队任务在自动重试交接期间提前结束的问题**，回复与任务输出持续更新，直到本轮任务真正完成 (#151213)。 - **修复团队成员详情与续跑历史的身份关联**：使用稳定子会话 ID、公开昵称与角色读取成员内容，保留旧 agentName 与历史描述符兼容；成员续跑后可用当前 task_id 查询 TaskOutput，团长不再误读用于展示状态的后台记录，重开历史后成员也不再被重复分类为普通子代理 (#160479)。 - **修复 Windows 上系统 PATH 不含 PowerShell 时插件 hook 启动失败并拦截用户提问的问题**：按 PATH、系统自带 PowerShell 路径依次查找，找不到时改由默认 shell 执行 (#161099)。 - **修复 Plan 模式下同轮并行「写计划文件 + 退出计划」时审批卡片只显示兜底提示、看不到计划正文的问题**：退出计划前重新读取最新的计划文件内容 (#163073)。 - **修复 `settings.agent` 自定义主线程的工具检查误用子代理实例、导致错误提示工具不可用的问题**，保留延迟工具与子代理权限限制 (#159902)。 - **修复桌面端左下角更新提示面板「下载中」按钮文字在暗色主题下几乎看不清的问题**：禁用态改用中性灰底与次要文字色 (#162319)。 - **修复桌面端左下角头像菜单「可观测」分组与「配置」分组左沿错位的问题**：分组分隔线不再把后续分组整体右移 (#162632)。 - **修复 WorkBuddy Harness 会话的沙箱审批绕过 AIReview 的问题**，恢复静默决策、风险提示和取消处理 (#162930)。 - **修复从定时任务执行记录进入对话时误提示「没有可定位的过程记录」的问题**：重新打开的历史对话也能定位到对应执行，较早的执行会自动加载更早历史后定位 (#163016)。 - **修复智能体进程已退出时点「新建会话」反复 502、舞台长期停在「正在连接会话…」的问题**：改为先重启该智能体、等重新绑上后再建会话；已接上且没有历史时直接展示空会话。 - **修复 Lite 模型请求失败后未恢复默认模型的问题**：仅当用户设置的 Lite 模型最终返回 HTTP 401 时清除用户级覆盖并通过 ACP 通知宿主，网关故障、限流、超时和网络错误不再清除用户选择；Lite 模型自动恢复默认后广播 USER 级重置通知，避免 one-shot 辅助任务的临时会话导致提示丢失 (#159950)。 ## [2.177.0] - 2026-10-26 ### 🎉 新功能 - **会话级 Code Mode 配置**：新增 ACP `codeMode` 配置项（`off` / `all`），对所有 ACP 宿主下发；完整 PTC 通过 REPL 调用内部工具，首轮后锁定取值，同值重放保持幂等。Code Mode 下 REPL 保留为模式入口，不被宿主传入的 `--tools` 工具精选集过滤，会话模式标记按现有历史存储保全；未上线的 MCP-only 模式删除，不增加存量迁移 (#141591)。 - **Web UI 支持在对话内预览 SVG 与播放视频**；远程会话的审批与问题请求可发送到本地桌面原生通知，操作按钮提供悬停提示 (#161919)。 - **stream-json 新增 `reconnect_mcp` 控制请求**：无需重启 CLI 即可重新连接已配置的 MCP 服务，响应在服务工具可用后返回完成 (#158574)。 - **交互式终端长任务网络重连**：断网后持续重连直到恢复或按 Esc 停止，重连间隔按 1/2/4/8/16/32/64 秒增长并保持 64 秒；等待时显示重连提示、次数与断开原因。主任务默认不再限制 500 轮，`--max-turns` 与 `CODEBUDDY_CODE_MAX_TURNS` 仍然生效 (#152375)。 - **Web UI 子代理工作台与消息级 Fork**：后台子代理与同步子代理统一在右侧工作台查看执行详情，过程与结论展示与主对话一致；消息复制按钮旁新增 Fork，可带上到该消息为止的上下文在侧栏并行处理任务 (#160582)。 - **模型请求与自动恢复的本地退避统一使用 ±10% 随机抖动**，上限限制基准间隔，服务端要求的等待仍优先 (#152375)。 ### 🔧 改进 - **PTC 全量 Code Mode 内部工具展示**：按真实调用展示等待、运行、完成、失败和取消状态，ACP 历史重开时恢复相同调用身份与顺序；展示记录采用有界安全摘要，不改变模型的 REPL 执行接口 (#141591)。 - **Web UI 长会话内存优化**：停在底部空闲时自动释放更早消息占用的页面内存，上滑时按页加载回来，屏上内容不变；运行中、待确认或查看其他面板时不触发。导出对话包含完整历史 (#154955)。 - **桌面端更新提示优化**：新版本已下载提示的主按钮在深浅色主题下都清晰可点，会话与任务将结束的提醒单独成行，面板样式与其他弹层保持一致 (#160547)。 - **WebUI 输入框右键菜单补齐剪切、复制、粘贴、全选**，与换行、发送分组展示，按选区与可编辑状态自动启用或禁用，显示当前平台快捷键，支持键盘操作；菜单粘贴可粘贴图片和文件，剪切可撤销 (#160558)。 - **Daemon 重启后自动恢复微信与企业微信渠道连接**：手动关闭的渠道不恢复，恢复在后台进行，失败时按上限间隔重试并展示「重连中 / 由其他进程承载 / 重连失败」状态；同一机器人始终只由一个进程连接 (#160574)。 - **Web UI 编辑器体验优化**：编辑器页面用顶部搜索打开文件会直接在编辑器中打开；图片预览与调用链图谱双指缩放跟随捏合幅度平滑缩放并以光标为中心；代码编辑器与差异视图触控板滚动更跟手 (#160896)。 - **Auto 模式工具安全审查增强**：统一常规工具、MCP、REPL 及后台命令的风险判断与审批反馈，支持查看默认和生效策略并通过额外策略补充审查要求；自动审查优先使用快速模型，不可用或调用失败时回退原有审查模型。 - **自定义模型请求头分账**：直连白名单内的合作模型服务平台请求携带渠道、模型类型、端来源和哈希后的企业标识，其他地址及跳过内部请求头的请求不携带 (#125729)。 - **Web UI 对话流正文字号由 13px 调整为 13.5px**，辅助文字保持不变 (#161671)。 ### 🐛 修复 - **修复嵌入式 Agent Runtime 中用户停止后，后台任务完成通知自动启动新轮次的问题**：停止期间保留未消费通知，直到下一条显式用户输入执行完毕后再派发 (#151224)。 - **修复云任务标题丢失用户请求的问题**：开场消息包含技能引用时不再丢失原始请求 (#151275)。 - **修复 WebUI 刷新页面或切换会话后，历史回复底部的本轮消耗积分与「复制请求 ID」消失的问题** (#160549)。 - **修复定时任务执行记录指向错误会话的问题**：「查看执行过程和结果」会打开真正执行该轮的对话，已有历史执行记录也会自动纠正 (#160551)。 - **修复 Web UI 国际化文案**：英文界面不再出现中文，中文界面不再出现英文；统一「智能体」「Sign in」「canceled」等术语与省略号写法 (#160561)。 - **修复后台子代理运行期间切换工作树后输出记录持续写入失败、丢失后续内容的问题** (#160614)。 - **修复 Desktop 内置浏览器重启后重复提示登录、导入后黑屏**：按「每次启动自动更新」重新同步 Chrome 登录状态并在页面加载前完成；重启后恢复各会话（含新对话页）上次打开的网页，新对话页拥有独立的工作台 (#160641)。 - **修复同一台设备上多个 CBC 进程共用中继时状态不同步的问题**：任一进程开启或停止「共享本机 SSH」，其他进程自动跟随；承载中继 Web 绑定的进程退出后，其他进程自动接管 (#160972)。 - **修复 Web UI 侧栏 Fork 分支与主对话渲染不一致**：分支运行时同样流式输出、完整展示工具卡片，实时显示思考与阶段信息，分支结束后仍可查看历史并继续发消息 (#161013)。 - **修复模型输入内存保护误拦截**：先回收一次内存再判断，只有回收后仍然耗尽才暂停当前请求；内存充足时历史条数很多也能正常对话 (#161015)。 - **修复新建会话在快照同步期间长时间停留在连接中的问题** (#161919)。 - **修复 Auto 审查残留与拒绝反馈问题**：REPL 并发调用结束后残留状态、一次性批准撤销后被在途失败审核恢复、MCP 达到拒绝上限未结束本轮、后台命令拒绝反馈缺失等。 - **修复工作目录为网络共享（WebDAV/UNC）路径时 Windows 上 CLI 冷启动崩溃**：加载插件/Mod 的编译器不再依赖会话工作目录。 - **修复 `/fork` 和 `/branch` 对包含上下文窗口记录的会话误报历史元数据损坏**，保留独立子智能体历史并支持重启后继续父子对话 (#161013 #161015)。 - **修复流式连接中断自动恢复时的提示**：显示明确恢复提示而非只显示 `aborted`，重试耗尽与主动取消保持不同提示；修复已输出部分正文时提前显示 `Worked for` 的问题 (#152375)。 - **修复 Windows 上 PowerShell 只读命令因路径末尾为 `/en`、`/enc` 或 `-en` 被误判为编码命令的问题**，并补充拦截 `-e`、`-ec` 别名及 `-EncodedCommand` 任意前缀 (#158081)。 - **修复 `-p` 无头模式后台工作流固定等满 10 分钟才退出的问题**：工作流一结束即退出，主 agent 总结打印到终端；超出等待上限时告警、停止后台任务并以非 0 退出 (#158181)。 - **完善多成员协作回归覆盖**，并修复验收页面窄屏导航布局 (#89304)。 - **修复远程主机连接时「停止并重试」无法替换异常后台服务的问题**，不再持续返回 502。 - **修复终端对话快速输入或粘贴后立即回车时消息末尾文字丢失的问题** (#161864)。 ## [2.176.0] - 2026-10-25 ### 🎉 新功能 - **远程 SSH 主机支持桌面深链打开**：远程控制 Web UI 的主机列表新增「在桌面端打开」，点击生成 `codebuddy-desktop://` 深链唤起本机桌面客户端，直接打开该 SSH 主机及其工作区；主机与工作区信息随链接恢复，未登记的主机保持挂起不误连 (#160333)。 - **服务模式由宿主提供确认卡通道**：`QueryOptions.elicitation` 与 ACP 连接的 `elicitation/create`、`elicitation/complete` 同形，会话激活时绑定，子任务沿用主会话的通道。微信支付拦截的支付确认卡与 A2A 工具的认证失败、审批中断卡片优先经它发给宿主；此前服务模式没有确认卡通道，这些卡片不发出。微信支付服务先查会话自己的 weixinpay MCP，服务模式下它由宿主按会话声明。CLI 进程不设该选项，行为不变 (#143363)。 - **服务模式会话支持 `strictMcpConfig`**：`QueryOptions.strictMcpConfig` 与 CLI 的 `--strict-mcp-config` 同义，为 `true` 时会话插件（已启用插件与 `pluginRoots`）声明的 MCP 不进会话 MCP，插件的技能、命令、hooks、agents 照常加载；Product、插件与工作区定义的 Agent 不启动自带的 MCP，`agents` 传入的定义保留。会话激活时绑定，`reload({ strictMcpConfig })` 替换常驻会话的取值 (#143363)。 - **IOA 默认请求头的路由模式**：新增环境变量 `CODEBUDDY_ENV_ROUTE_MODE`，取值同设置项 `envRouteMode`。设置里没有 `envRouteMode` 时读这个变量，只用于选择 `X-Domain`、`X-Enterprise-Id`、`X-Tenant-Id` 的 staging 或正式取值；地址选择不受影响 (#143363)。 - **专家请求头随提示的 baggage**：提示的 W3C `baggage` 带 `x-expert-id`、`x-expert-team-task`、`x-moderation-type` 时，展开成同名平台请求头 `X-Expert-Id`、`X-Expert-Team-Task`、`X-Moderation-Type`。只加在内置模型请求上，覆盖用户自定义头里的同名项；平台 REST（生图、生视频、生音频、记忆平台）与联网搜索、网页读取发往平台的请求同样带上；回合外的自主回合沿用准入时的值；值不是合法请求头值时丢弃该成员。经 `CODEBUDDY_CUSTOM_HEADERS` 传入的请求头不变 (#143363)。 - **文件变更支持按轮净差异通知**：文件变更支持按轮净差异通知；大文本的小修改保留标准补丁，复杂计算退化为内容准确的粗粒度补丁 (#143363)。 - **服务模式支持预设本轮 conversationRequestId**：Server 支持调用方预设本轮 conversationRequestId，使 Harness 对话的前端调试信息、模型请求、事件和历史保持同一 ID；非法或重复 ID 在执行前拒绝，后台自主续跑仍使用新 ID (#143363)。 - **服务端会话的 stdio MCP 可在会话执行环境里启动**：`start()` 的会话 `mcpServers` 中，标记 `connection_origin: 'environment'` 的 stdio 服务在查询运行时于会话的执行环境里启动，启用沙箱时在会话沙箱内，与 CLI 进程启动会话 MCP 的方式一致。会话的第一次查询在首个模型请求前等它连接，等待上限是 `CODEBUDDY_FIRST_RUN_MCP_PREWAIT_TIMEOUT_MS`，与进程级 MCP 的首轮等待相同，期间连上的服务工具出现在首个请求里；之后的查询沿用同一连接，会话关闭或沙箱重启时随之关闭或重连。超过等待上限仍未连上时查询照常进行，它的工具在连上之后可用。未标记的服务与 CLI 进程不受影响 (#143363)。 - **服务模式的错误字段**：服务模式落盘的请求终态带上模型服务给的提示文案、排队信息与自定义模型标记，新增的 `codeBuddyErrorFromFailure` 供宿主把实时失败投影成同一形状；自定义模型鉴权失败、配置缺失与空回复使用新的错误码 (#143363)。 - **服务模式的宿主内部请求头**：查询选项新增 `internalModelRequestHeaders`，宿主为本会话的内置模型请求提供请求头（如图灵盾设备令牌）。每次 query 整体置换，空对象清空，省略保持上次；与插件运行时的内部头同一门控与清理集：自定义模型端点不下发，`CODEBUDDY_SKIP_INTERNAL_HEADERS` 时清理，只在驻留会话上，不进历史与存储 (#143363)。 - **服务模式会话发现源的策略席位**：查询选项新增 `remoteAgentsTrusted` 与 `remoteAgentsEnabled`，是进程 env `CODEBUDDY_A2A_TRUSTED_RESULTS` / `CODEBUDDY_A2A_OUTBOUND_ENABLED` 的会话版，只对会话自己以 `remoteAgentsUrl` 表态的发现源生效：前者声明该源中 Agent 的返回可信、A2A 工具结果免于防注入检测，后者为本会话打开出站 A2A 特性开关（与 env 覆盖一样只能打开）。两项是一个置换单元，省略保持当前，钝化清除 (#143363)。 - **宿主可让沙箱起不来的一轮在本机执行**：`start()` 新增 `sandboxUnavailable` 选项。服务端会话要求本地沙箱而沙箱起不来、本平台没有沙箱或读不到沙箱设置时，默认 `'fail'` 让这一轮失败，会话不会在它要求的沙箱之外运行；`'local'` 与 CLI 进程一样按关闭沙箱执行这一轮，只适合会话都属于本机用户的宿主。后台任务进行中修改沙箱规则仍然报错。CLI 进程不受影响 (#143363)。 - **库模式由宿主提供服务代理地址**：`start()` 新增 `serviceProxy` 选项。CLI 进程在回环端点上提供服务代理，hook 命令、Bash 命令与 stdio MCP 经 `CODEBUDDY_SERVICE_PROXY_URL` 访问；库模式没有回环端点，这些进程此前拿不到该变量。宿主自己提供服务代理时，以 `serviceProxy.resolve()` 给出地址，每次启动这类进程时询问，返回 `undefined` 即不提供。ConfigChange hook 仍用按操作开启的代理地址；CLI 进程不设该选项，行为不变 (#143363)。 - **服务模式的会话插件根**：查询选项新增 `pluginRoots`，列出只在本会话加载的插件目录。会话按目录直接读插件清单并走标准加载器，`id` 决定插件身份（命令命名空间），同 `id` 的已安装或市场副本让位；缺清单或加载失败时告警并跳过。会话激活时绑定，`reload(sessionId, { pluginRoots })` 整体替换，`readSessionCatalog` 同样接受 (#143363)。 - **库模式按会话给 Agent 启动的进程设置环境变量**：`start()` 新增 `shellEnvironmentPolicy` 选项，名字取自 Codex 的 `shell_environment_policy`。会话每次运行开始时以 `set({ sessionId, signal })` 询问宿主一次，可以直接返回变量表，也可以返回 Promise；到该会话下一次运行开始或会话关闭之前，Agent 为它启动 Bash、PowerShell 命令与沙箱里的 Grep、hook 命令、只属于该会话的 stdio MCP 服务和独立进程的团队成员时都用这次结果里给出的变量，子 Agent 与进程内的团队成员也一样，已经启动的进程保留启动时的环境。这次询问失败、返回 `undefined` 或 60 秒内没有结果时不保留，各处在启动进程前各自询问。返回的变量在本运行时环境与 shell 快照之上，在 MCP 声明的环境和 Agent 为每个进程设置的变量之下；`PATH`、凭据等 Agent 自己设置的变量被丢弃，并按变量名告警。shell 命令的目录改由新变量 `CODEBUDDY_SHELL_PREPEND_PATH` 给出，Agent 在加载 shell 快照之后把它放到 `PATH` 最前，风险审查和 Linux 沙箱规则也读它；此前读取的 `WORKBUDDY_EXTRA_PATHS` 不再读取。库模式下不论是否提供该选项，每次会话驻留都生成自己的 shell 快照，关闭会话时删除，不再预热进程级快照；不属于任何会话的调用在需要时生成进程这一份。CLI 进程不使用该选项，宿主改为把目录写进 `CODEBUDDY_SHELL_PREPEND_PATH` (#143363)。 - **start({ env }) 支持移除环境变量**：Server 的 `start({ env })` 支持把值设为 `undefined`，从本运行时的环境中移除对应变量；在 Harness 共享运行时内只对 Agent 隐藏宿主进程的值，不修改宿主进程。凭据类键也可以这样移除，设置取值仍然拒绝 (#143363)。 - **按会话设置 Agent Teams**：服务模式新增查询选项 `agentTeams`。在带 `product` 的查询中，TeamCreate、TeamDelete、SendMessage、Agent 工具组队，以及 Agent 与 TaskList 描述中的 Teams 部分，都按本会话的设置决定，并发会话互不影响。`null` 恢复为进程设置 `CODEBUDDY_CODE_EXPERIMENTAL_AGENT_TEAMS` (#143363)。 - **按会话关闭会话标题生成**：服务模式新增查询选项 `aiTitle`。为 `false` 时，本会话不再在提示后发起生成标题的模型请求，其他会话不受影响；`null` 恢复为进程设置 `CODEBUDDY_CODE_DISABLE_TERMINAL_TITLE` (#143363)。 - **按查询的需确认规则**：服务模式新增查询选项 `askTools`，文法同 `allowedTools`，提供即整体替换，省略时沿用上次。判定时与各设置档的 `permissions.ask` 合并，在 bypass 之前判定；可信放行规则（含 `allowedTools`）先于它放行。子 Agent 沿用主会话的规则 (#143363)。 ### 🐛 问题修复 - **ACP v2 标准错误终态**：ACP v2 使用标准错误终态并保留业务错误详情；旧 CLI 错误展示保持不变 (#143363)。 - **会话连接器**：首次等待连接器启动时可以及时取消对话；关闭会话会等待尚在初始化的连接器进程完成清理，避免后台进程残留 (#143363)。 - **安全审查拒绝只作用于当前调用**：修复安全审查已自动拒绝的工具调用在对话继续时被重复审查、甚至因后续审查结论变化而执行的问题。拒绝仅作用于当前调用，后续独立调用仍正常审查 (#143363)。 - **Harness 取消归因与历史恢复**：修复 Harness 取消归因与历史恢复，内部审批超时和上下文限制使用标准终态，保持 WorkBuddy 停止提示与循环退费语义 (#143363)。 - **截断与审批结果的终态归因**：修复模型截断、请求次数上限和敏感输入审批结果的终态归因，恢复后保留同一结果与原有展示，被拒绝轮次不进入后续模型上下文 (#143363)。 - 修复同步和异步 Hook 超时后，仅终止外层 shell、实际命令仍在后台运行的问题。复用已有进程树回收，保留超时结果语义 (#143363)。 - **常驻服务工具调用的安全审查与风险提示**：修复常驻服务调用工具时未执行安全审查自动阻断、人工审批缺少风险提示的问题，保持既有安全审查语义。 - **ViewImage 大图不再中断 ACP 会话**：修复 ViewImage 图片结果在 ACP 中重复传输导致消息过大、会话连接中断的问题，保留完整图片及历史内容。 - **延迟调用的 MCP 工具视图与历史**：修复 Harness 延迟调用 MCP 工具时 App 视图和历史数据缺失，保持旧 CLI 广播与工具审批行为。 - **连接器安全**：修复进程内会话中远程连接器和托管浏览器调用未遵循网络访问规则的问题，保留现有审批与取消行为 (#143363)。 - **微信支付**：支付已完成或取消时，回收尚未响应的宿主确认请求，避免过期卡片阻塞后续审批 (#143363)。 - 修复模型等待响应头超时被误判为取消的问题，复用首 token 超时恢复预算；真实用户取消仍立即停止且不触发重试 (#160294)。 - **插件的 `tool.call` 钩子**：每次工具调用只派发一次。命令行模式下 MCP 工具（含工具搜索加载后调用的延迟工具、代码模式沙箱里调用的工具）也会派发；经延迟调用通道调用的工具按目标工具的名字派发，子代理的调用带上子代理 id；钩子返回的附加上下文与错误标记会进入模型读到的工具结果。插件经 `$.mcp.call` 直接调用 MCP 工具时不再派发 `tool.call` (#143363)。 - **插件钩子与工具确认的顺序**：命令行模式下启用了插件运行时，工具确认改在插件的 `tool.call` 钩子、PreToolUse 钩子与 `tool.check` 之后进行，确认的是钩子最终交给工具的参数；钩子改写参数不再被拒绝。子代理的工具调用被拒绝时，主代理能读到拒绝原因 (#143363)。 - **服务模式 MCP 直调不再双发钩子**：修复服务模式会话中模型直接调用 MCP 工具时，插件的 tool.call 钩子执行两次的问题（例如同一次调用弹出两张确认卡） (#143363)。 - **库模式的沙箱会话使用会话的工作目录**：库模式下 Agent 启动沙箱时，OpenSession 带发起启动的会话的工作目录，sandbox 中心按它展开 `{SESSION_WORKSPACE}` 规则；此前带的是宿主进程的工作目录。启动参数 `BootstrapOptions` 新增可选的 `workingDir`。CLI 进程仍用进程的工作目录，行为不变 (#143363)。 - **服务模式会话在 ACP 路径提供「本会话允许」的地方都提供**：服务模式的审批请求此前只对权限服务的普通默认询问（Bash 除外）与本会话范围的产品技能规则提供 `allow_always`，hook 返回 ask 的调用、必须审批的工具与 Bash 每次调用都询问。现在除工具风险审查外都提供（"Allow for this session"）。选择后的记忆与 ACP 路径相同：高风险命令与 ExitPlanMode 只放行这一次；宿主设置 `CODEBUDDY_ALWAYS_APPROVAL_OVERRIDES_HOOK_ASK` 时，记住的批准优先于 hook 的 ask；Bash 记住整个工具。CLI 不受影响 (#143363)。 - **关闭会话与后台任务**：服务模式关闭会话时，与 CLI 进程退出一样结束整棵会话树：先结束该会话及各级子代理仍在运行的后台任务，再取消仍在运行的子代理（包括不随会话中止的分离子代理）并等它们清理完毕，然后钝化会话。此前关闭后任务进程继续运行，退出时客户端收不到更新，模型也收不到完成通知。关闭的会话不再接收这些任务的完成通知；团队成员仍按原有方式强制结束 (#143363)。 - **服务模式会话按查询的 Product 过滤内置技能**：服务模式的技能有两个来源，都没有按查询带来的 Product 过滤：会话激活时的技能扫描同样读取内置技能目录；查询的 Product 叠加到进程的 Product 上之后，也没有再执行产品配置的过滤。Product 里 `disabledBuiltinSkills` 列出的内置技能因此仍出现在 Skill 工具的列表里，也能加载；`DisableMultimodalGeneration`、`DisableTerminalVariable` 也只按进程的 Product 生效。现在两处都按查询的 Product 过滤，规则与 CLI 相同。CLI 不受影响 (#143363)。 - **服务端会话在执行环境里启动的 MCP 按会话的连接上限连接**：查询选项新增 `mcpConnectTimeoutMs`（正整数毫秒）。标记 `connection_origin: 'environment'` 的 stdio 服务每次连接都以这个值为上限，到期没连上时这次连接失败、服务进程结束，查询照常进行。它取代内联连接的上限（服务自己的 `timeout`、`MCP_TIMEOUT`、30 秒）。此前进程内会话只能用内联连接的 30 秒，宿主为会话 MCP 设的连接上限到不了这些服务。它不属于会话 MCP 的配置：只改它的查询不重连 MCP，下一次连接用最后给出的值；省略保持当前值，`null` 回到内联连接的上限，会话钝化时清除。CLI 进程与以子进程运行的 CLI 不受影响 (#143363)。 - **服务端会话在执行环境里启动的 MCP 按会话的首轮等待上限等待**：查询选项新增 `mcpFirstPromptWaitMs`（非负整数毫秒，`0` 不等）。会话的第一次查询在首个模型请求前等标记 `connection_origin: 'environment'` 的 stdio 服务连接，最多等这个值；宿主没有给出时才取进程环境的 `CODEBUDDY_FIRST_RUN_MCP_PREWAIT_TIMEOUT_MS`（默认 2 秒）。此前进程内会话只能取宿主进程的环境变量，宿主为某个会话放宽的等待到不了这些服务。它不属于会话 MCP 的配置：只改它的查询不重连 MCP，下一次等待用最后给出的值；省略保持当前值，`null` 回到进程环境变量，会话钝化时清除。CLI 进程与以子进程运行的 CLI 照旧读环境变量 (#143363)。 - **服务模式的错误原文**：服务模式与 ACP 规范接口的公共错误带上脱敏后的错误原文 `additionalDetails`（去掉调用栈与凭据形状的值，上限 2000 字符），宿主据此还原原来的 `data.details` (#143363)。 - **中止归因**：run 的取消器 reason 在 `codebuddy.ai/error` 键下带公共错误时，这一轮的持久终态记为该错误而不是 `cancelled` (#143363)。 - **服务模式 hook 拦截提交后的结束状态**：服务模式下 UserPromptSubmit hook 或插件 Mod 的 `prompt.submit` 返回 `drop` 拦截提交时，本轮按正常结束（`completed`），不再按失败结束并推送错误事件；拦截消息照旧写入会话，与 CLI 的 ACP 会话一致 (#143363)。 - **空闲会话与后台任务**：服务模式的空闲清扫不再钝化有运行中后台任务的会话。此前关闭沙箱或本机放行时，后台 Bash 运行期间会话可能被钝化，终端卡片停在运行中，模型也收不到完成通知。一直运行的后台任务会让会话常驻 (#143363)。 - **进程内插件 Mod 的子进程与出网**：Harness 进程内的 functional hooks 与插件 Mod 和 CLI 一样可以使用 `$.process.run`、`$.process.spawn`、`$.http.fetch`；`CBC_MODS_ALLOW_PROCESS=0`、`CBC_MODS_ALLOW_HTTP=0` 时拒绝，每次调用时读取。此前进程内一律拒绝，依赖子进程的插件 Mod（例如订阅门控）不生效 (#143363)。 - **服务模式会话的 Agent 工具列出会话级子代理**：服务模式下，会话启用的插件、会话工作目录里的自定义 Agent 与查询选项 `agents` 注入的 Agent 原先可以派发，但不出现在 Agent 工具的子代理目录里，模型看不到。现在它们并入该会话的目录，同名时以会话级为准，与派发一致；插件 `settings.agent` 指定的根 Agent 不列出，与 CLI 一致。其他会话与 CLI 不受影响 (#143363)。 - **服务模式会话的审批请求带上审批卡片分类**：服务模式下，PreToolUse hook 声明的审批分类（如高积分闸门）与产品的技能审批规则没有进入审批请求，宿主只能显示通用审批卡。现在审批请求的 `toolCall._meta` 带上 `codebuddy.ai/approvalPolicyId`、`codebuddy.ai/approvalCategory`、`codebuddy.ai/approvalKind`（技能审批另带 `codebuddy.ai/approvalScope`），拼法与 ACP 路径相同。CLI 不受影响 (#143363)。 - **服务模式会话插件的 MCP 白名单与延迟工具清单对齐 CLI 子进程**：会话插件声明的 builtin 裸名清单（不含 `mcp__*`）不再精确约束透明代理服务的裸名工具，与 CLI 子进程丢弃该清单的口径一致；显式空清单仍隐藏裸名工具，SDK Host builtin 仍受插件声明约束，含 `mcp__*` 的清单仍精确匹配。本轮工具目录的 ToolSearch 清单改列 MCP 索引原名（含连字符），不再是 SDK 归一化后的下划线写法；DeferExecuteTool 先按清单名、再按 SDK 声明名查找 (#143363)。 - **服务模式的资料库上传与分享按运行身份鉴权**：LibraryUpload 的启用判定与请求鉴权、Artifact 与 ArtifactControl 的请求鉴权先读本轮绑定的运行身份，缺席时用启动登录；运行身份的归因头与宿主头替换启动登录派生的同名头。进程内会话没有启动登录时，LibraryUpload 不再缺席。CLI 进程不绑定运行身份，行为不变 (#143363)。 - **服务模式会话按产品技能审批规则提供「本会话允许」**：产品技能审批规则的 `authorization.scope` 为 `session` 时，服务模式的审批请求没有 `allow_always` 选项，同一技能每次调用都询问；宿主按规则只显示对应 `allow_always` 的「允许」时无法批准。现在这类调用提供 `allow_always`（"Allow for this session"），选择后本会话内同一技能不再询问，与 ACP 路径相同；`scope` 为 `once` 的规则不变。CLI 不受影响 (#143363)。 - **服务模式下，工具调用的开始信号改在钩子与权限确认之后发出**：宿主注册了工具钩子时，`session_info_update` 里带工具调用 id 的 `tool_executing` 阶段原本在派发时就发出，早于钩子和权限确认：确认卡还在等待时，宿主就把这次调用显示为执行中，被拒绝的调用也显示过执行中。现在派发时只发不带调用 id 的 `tool_executing`，钩子放行、权限确认通过、工具开始运行时才发出带这次调用 id 的开始信号；被钩子或用户拒绝的调用不发。CLI 不受影响 (#143363)。 - **会话设置来源隔离**：服务模式支持按会话收窄 `settingSources`，受限工作区可只读取用户设置，阻止项目与本地设置中的 hook 和权限规则生效；并发会话互不影响，复用现有 reload 更新驻留会话 (#143363)。 - **子代理父会话工具与 A2A 目录**：修复宿主提供会话 MCP 时，子代理无法使用父会话工具的问题，保留子代理白名单及连接归属；修复会话独立 Product/插件路径首轮缺少 A2A Agent 目录的问题 (#143363)。 - **整轮净差异只保留标准文件变更信息**：整轮净差异只保留标准文件变更信息，避免将最后一次编辑的备份误作为整轮改前内容；工具卡片和历史回放继续保留各次编辑的备份 (#143363)。 - **凭据保护**：WorkBuddy 使用常驻服务时，内置工具申请的临时凭据继续自动保护；官方多模态工具可在同一会话复用，无需重复确认。自定义工具和其他会话仍需按原有规则确认，关闭保护及服务异常时的降级行为保持不变 (#143363)。 - **安全确认**：WorkBuddy 使用常驻服务时，敏感信息保护、疑似循环的工具调用、工具风险复核后的执行确认、运行时安全策略，以及 REPL 内的提问、计划确认和安全确认，改为通过宿主弹出确认卡片。此前这些确认没有界面可以显示，会静默放行或一直等到超时。卡片的选项和超时时间与原来一致；超时或本轮取消时，卡片自动撤回 (#143363)。 - **回复语言**：修复 WorkBuddy 使用常驻服务时界面语言未同步到回复和标题生成的问题。不同会话独立应用语言，切换后在后续对话生效。 - **企业安全策略**：WorkBuddy 使用常驻服务时，沙箱开关、沙箱规则、删除保护和敏感信息保护按本轮对话的产品配置执行，不再读取进程级配置；本轮配置未下发策略时按未托管处理 (#143363)。 - **会话配置**：修复 WorkBuddy 使用常驻服务时 Max Mode 设置失败的问题。开启后关闭普通预压缩，关闭后恢复默认策略；不同会话相互隔离，模型切换时仍执行必要的压缩。 - **网络环境**：WorkBuddy 使用常驻服务时，IOA 默认请求头（模型请求、WebFetch、WebSearch）、自定义模型的内部元数据透传，以及 endpoint 与环境不符的告警，按本轮对话产品配置的网络环境判断，不再读取进程级配置；本轮配置未声明网络环境时按未设置处理 (#143363)。 - **沙箱规则重建**：WorkBuddy 使用常驻服务时，会话释放与 center 重连后重建的沙箱规则按该会话最近一次查询的产品配置读取企业托管策略，不再按未托管下发用户本地规则 (#143363)。 - **安全审查**：修复 WorkBuddy 使用常驻服务时安全审查设置未生效的问题。保留本轮策略快照，在后续轮次应用新设置；非法配置清除旧策略，不同会话相互隔离。 - 修复服务模式清空上下文的维护入口：保留对话历史，以持久化分界隔离后续上下文，不额外发起模型请求 (#143363)。 - 压缩通知统一使用标准 `compaction_update`，保留实时与历史中的压缩来源，宿主可区分发送前静默压缩和紧急压缩 (#143363)。 - 修复压缩前扩展等待期间无法停止的问题：取消后保留原有上下文，后续对话与压缩可继续使用 (#143363)。 - **遥测**：WorkBuddy 使用常驻服务时，未自带会话的遥测事件使用所在 Agent 会话的 id，不再由所有会话共用进程级的会话标识 (#143363)。 - **提示的上游元数据**：WorkBuddy 使用常驻服务时，服务端查询按 ACP 的方式采纳提示 `_meta['codebuddy.ai']` 中的专家、运行环境、用户、遥测与自动化标记，并记录提示请求 ID、发送时间与开始时间；场景不写进会话，仍只随本轮发给内置模型请求，非专家场景清掉上一轮的专家；Galileo 关联、首字时间、`X-Agent-Runtime` 与 `X-Agent-Purpose` 与 CLI 子进程一致。提示请求 ID 与发送时间也可由 baggage 成员 `workbuddy.prompt_request_id`、`workbuddy.client_send_time` 给出 (#143363)。 ## [2.175.0] - 2026-10-24 ### 🎉 新功能 - **Web UI 快速访问面板**：⌘P 与 ⇧⌘P 合并为同一个面板，输入 `>` 运行命令、`/` 斜杠命令、`#` 转到对话、`?` 查看帮助；顶部新增可关闭的搜索框（桌面版融入标题栏，全屏时也可用），左侧新增后退 / 前进，可在智能体、对话、页面和文件之间来回切换。⌘P 优先列出最近打开的文件并同时搜索整个工作区。「打开目录」弹窗支持输入即导航与键盘操作，加载失败时说明原因并可重试或返回上级。桌面版会记住窗口大小与位置，「完成后通知」恢复正常 (#160120)。 - **项目指令文件向上递归查找可关闭**：在项目子目录启动会话时，默认会沿目录向上逐级查找并加载 `CODEBUDDY.md` / `AGENTS.md`。现在可在 settings 中设置 `memory.parentDiscovery: false`，或设置环境变量 `CODEBUDDY_DISABLE_PARENT_MEMORY=1`（优先级更高），关闭后只加载启动目录本身的指令文件与规则目录；Web UI 设置页「记忆」分组同步提供该开关 (#159973)。 ### 🔧 改进 - **桌面版挂机与 Web UI 空闲资源占用下降**：宠物动画按状态分档帧率并在画面无变化时跳过重绘，选中任务的兜底轮询降频，频道事件流与兜底轮询在服务异常时指数退避、恢复后自动回到原节奏，事件总线停止空转采集并清理已结束会话的流缓存 (#159981)。 - **任务执行期间更省电**：流式回复的逐字释放改为约 30fps 节拍（速度不变），刷新兜底草稿不再逐个增量把整条回复序列化写入存储；窗口失焦或页面隐藏时暂停所有循环动画，回到窗口后自动恢复；模型请求预处理不再逐条深拷贝工具结果。 - **Web UI 对话过程展示更清爽**：思考不再在每个工具前单独占一行，悬停工具行即可查看对应思考；过程标题改为统计实际操作次数，不再出现完成后时长变小的情况；运行中的当前思考只在底部状态显示一次；工具行突出任务描述；长任务运行时只展示最近几步，更早的步骤可一键展开 (#160026)。 - **Web UI 文件变更汇总改为胶囊**：在输入框上方显示「N 个文件已更改 +X -Y」，点击可展开文件列表、查看 diff 或撤销本轮改动，不再在对话流中逐轮插入卡片；修复重新加载历史后每轮变更文件把之前轮次也计入的问题。点击消息中的 `~/` 路径或目录时能正确定位。 - **桌面端标题栏与快速访问细节优化**：窗口关闭等按钮与标题栏垂直居中；后退 / 前进跳过不会改变画面的记录，不再出现点了没反应；搜索框右侧新增「回到我的分身」入口；顶部搜索框改为在设置「外观」中开关；快速访问面板文字统一为 13px；侧栏 Logo 下方不再显示版本号，改为悬停提示。 - **远程主机安装改为单一稳定入口**：POSIX 目标装到 `releases/` 并用 `current` 软链指向当前版本，升级不再改写正在运行的 release，磁盘最多保留两份；准备阶段探测 / 整体超时放宽（30s / 75s），慢机器装完不再报 504；「停止后台服务并重试」未选目录时也能发起，旧版无身份指纹的 daemon 可二次确认后强制结束；准备失败或已被消费时弹窗内可直接重新准备。 ### 🐛 问题修复 - **Remote Control（/gateway）安全与稳定性**：修复登录限流可被全速绕过；手机端 Web 终端不再把网关密码放进 URL，网关密码不再永久留在浏览器本地存储；补齐 Host 头全局校验，防止恶意网页通过 DNS Rebinding 操控本地 Gateway；Tunnel 进程意外退出后自动恢复；消息发送失败不再无限转圈；长连接超时定时器不再泄漏；job 页后台轮询暂停以省电 (#159983)。 - **后台服务重启后 Web UI 分身自动恢复会话**：重启后分身会还原上次打开的会话，主机管理里的中继 Web 绑定自动跟随当前服务，不再需要手动重新绑定 (#160098)。 - **频道工具在用户自己的会话里恢复正常**：主 Agent 发言、私信、改任务板不再被误判成「没有 Agent Home 身份」；复用同一批成员的频道时会把频道 lead 补上，不再留下无法派单的空 lead 频道；建频道的开场白发送失败时会在结果里明确说明，而不是静默丢弃后仍显示已叫醒成员 (#160169)。 - **切到远程主机后新建 / 恢复智能体页面不再卡死**：远程侧补齐 job frame 的会话快照路由，并给「补齐视口」的自动翻页加上失败熔断，避免远端路由不可用时把重试泵成每秒上千次的循环。 - **经中继 Web 绑定子路径打开 Web UI 时 WebSocket 可正常连接**：注入的 base-path 引导脚本把 `ws:` / `wss:` 与页面的 `http:` / `https:` 视为同源，绝对 WebSocket 地址也会补上子路径前缀；相对地址仍按页面协议转成 `ws` / `wss`。 - **Windows 下智能体重启偶发失败**：agent-home 目录与任务状态写盘在目标文件被短暂占用时，对原子替换做退避重试，不再直接返回 500。 ## [2.174.0] - 2026-10-24 ### 🎉 新功能 - **Web UI 支持为智能体设置系统提示词**：在侧栏右键智能体选择「系统提示词」，可选择追加到内置提示词之后或替换内置提示词，保存后下一轮对话即生效，无需重启；可一键恢复默认。通过 `/fork-bg` 复制出的后台会话会沿用原会话的 `--system-prompt`、`--system-prompt-file` 与 `--append-system-prompt`。 - **企微机器人支持接收频道内容**：在 CBC 的远程控制面板里为单个企微机器人开启「接收频道内容」后，机器人所在频道的每条新帖和新回复都会作为输入交给 Agent，Agent 可在对应帖子下以评论回复。默认关闭；仅处理新建内容，机器人自己发出的内容不会再次触发；频道里的内容不会被当作斜杠命令执行，也不能回答待确认的权限提示。企业未开通频道灰度时会给出明确提示。 - **Ctrl+L 清屏并保留当前会话**：清除屏幕和回滚区，之后只显示新内容，上下文不变（`/clear` 仍是新开会话）。Web UI 同步支持 Ctrl+L 清屏。原重绘动作保留为 `app:redraw`，可在 keybindings.json 中自行绑定。 ### 🔧 改进 - **模型请求上报 Harness 元数据**：使用内置模型时，每次模型请求会在 `extra_vars.harnessMetadata` 中携带本次调用在当前请求内的序号、上一次调用，以及子 Agent 的层级和创建它的调用，便于服务端还原调用链路。使用自定义（第三方）模型时不携带，行为不变。 - **技能清单按来源分组**：`` 的 `skills under folder:` 由「SKILL.md 的父目录」改为「技能来源」。应用包内置副本与 `workbuddy-builtin` 市场插件统一收敛为一行 `workbuddy-builtin`；插件缓存与本地市场目录截到插件名层，不再暴露版本、`skills`、`experts` 层；用户/项目/连接器/会话注入等平铺来源按扫描根一行展示，多个注入目录各成一行。字符预算口径、条目格式与截断策略不变。 - **新增 `CODEBUDDY_BASH_FORCE_PARALLEL` 环境变量**：显式传入 `1` 或 `true` 后，同一轮里的 Bash 与 PowerShell 调用一律并行执行，不再按命令内容推算是否只读；未传入时行为不变。 - **Web UI 智能体切换与恢复更快更稳**：恢复已退出的智能体时不再长时间等待网络同步和重复加载历史；恢复不会再把智能体顶到列表顶部，状态只显示「恢复中」且不多弹完成提示；切换时模组入口不再闪烁，切回仍在运行的智能体不再提示恢复中，历史记录在接上前后保持一致。切换智能体时对话、文件改动卡片与输入框配置首帧即为最终状态，总是停在对话底部；悬停时预取历史，打开更快 (#159886)。 - **中继 Web 绑定换端口后可一键重新绑定**：重启后端口变化时界面标记「端口已变更」并提供一键「重新绑定」，子路径、访问密钥等配置保持不变；重启恢复时 Web 绑定不再被其它共享恢复失败连带跳过。 - **侧栏右键菜单加宽**，长菜单项不再折行。 - **独立可执行版本的运行时升级**：Bun 运行时升级至 1.4.4，构建工具链中的 uv 升级至 0.13.5 (#158945)。 ### 🐛 问题修复 - **Code Mode 下 MCP 工具调用名统一**：使用逻辑服务名与原始工具名，搜索、描述和 REPL 调用保持一致 (#148355)。 - **ACP 工具调用参数不再被显示为工具输出**：正确保留参数的完整 JSON 值及流式、完成和历史回放中的敏感保护标记；无法确定敏感范围时保守隐藏整个参数。配置更新等待后台任务和排队续跑结束 (#158644 #158454)。 - **后台频道任务完成回执不再投递到错误会话。** - **`chat_tool_action` 事件补齐 `toolArgs`**：仅对已批准的调用与字段上报参数，本地路径与 ID 脱敏；未知字段或最终 JSON 达 1 KiB 以上时省略 `toolArgs` 但保留工具事件。 - **未绑定的 Ctrl+字母不再插入字母**：修复终端按 Ctrl+L 时输入框多出一个 "l" 的问题。 - **Linux 启用 sandbox-cli 的环境变量改为 `ENABLE_LINUX_SANDBOX_CLI`**：只有值为 `1` 时才进入沙箱。新名字未设置时，本机留下的 `WORKBUDDY_ENABLE_LINUX_SANDBOX_CLI` 仍然生效；新名字有值时不再看旧名字。WorkBuddy 在 Linux 上注入新名字 `1`。 - **Web UI 任务列表偶发 500**：job 目录索引不再把 ctime 计入 stamp，扫描持续不稳定时降级返回本次目录快照而不是抛错，左侧智能体/任务列表不再整块加载失败 (#157938)。 - **同一设备多进程新建中继 Web 绑定不再被拒**：修复「代理已存在」导致的失败；中继网关相关错误提示改为跟随界面语言（中文 / 英文）显示，进入页面时自动加载中继网关失败不再主动弹出错误 (#159160)。 - **定时任务可靠性**：长时间无进展会自动判定失败，不再永久停在「执行中」；后台任务与团队成员进程不再承载项目定时任务；容器或远程访问时「查看实时过程」不再跳到无法连接的地址；模型工具名中混入的模板标签会被自动清洗，避免整轮失败；修复检查忽略文件时偶发的进程崩溃。移动端工作台菜单与桌面对齐，窄屏输入工具条保持单行。 - **大目录下服务模式更稳定**：在 Linux 上以服务模式运行且工作目录很大时，文件监听达到上限后不再继续遍历整棵目录树，避免长时间卡住。 - **内存诊断报告按时间分别保存**，不再互相覆盖。 - **日志不再记录仓库地址中的凭据**：仓库远程地址里内嵌的访问令牌在写日志前会被去除。 - **常驻服务会话里运行嵌套 `codebuddy -p` 不再卡住**：一次性进程不再被当成常驻服务，执行完正常退出，不会打断当前任务、取消子代理，也不会抢走已连接的微信等频道。 - **SSH askpass 不再因超长 argv 失败**：校验 SSH 进程归属时只读取进程名和启动时间，不再读取完整命令行，避免远程引导脚本撑爆有界观测缓冲区导致 askpass 全部 fail-closed。 - **远程工作区安装策略**：直接安装与 WebUI 完全相同的版本，不再走「兼容版本」分支；安装落在控制器专属目录，不覆盖目标端已有安装。远端 `remote-host serve` 启动时注入 `DISABLE_AUTOUPDATER=1`。npm 安装失败时把目标端有界诊断带入连接日志，界面改为「检测 → 一键安装同版本 → 自动重新检测」，底层状态收进「技术详情」。 - **远程主机上的 Web UI 终端不再卡在「重连中」**：owner 会话未就绪或探活期间被换绑时按退避继续重试，ACP 换绑后重新订阅输出流；终端输出这类长期流式响应不再套用请求总时长超时，不再每隔两分钟被代理切断重连。 - **远端 Node.js 运行时按实际环境解析**：探测与安装共用同一个运行时解析器，按「已证实路径 → CBC 同前缀 runtime → 当前 shell → 版本管理器自身命令 → 用户 shell 的 rc → 用户前缀」依次取证，不再误判「版本过低」；解析失败且用户已批准时自动把 Node.js LTS 装到用户前缀后再继续。 - **远程 serve 复用探测到的 Node 运行时**：修复「准备阶段 CBC compatible、连接阶段却因系统 Node 过低而 `serveFailed`」；修正 POSIX 与 Windows 兜底 PATH 优先级，显式运行时优先于系统目录。 - **Web 端长会话向上滚动可加载更早对话**：历史改为按游标分页，上滑到顶继续取回更早一页；只有尾部追加新的用户消息才吸底；翻页只补新增分组、滚动度量按帧合并，修复长会话上滑卡顿与整段历史全量挂载导致的卡死。 - **子代理不再重复携带整份主提示**：在 Code Mode 等站立模式下派发通用子代理或基于主模板的自定义子代理时，每次子代理请求约减少 6k 输入 token，也避免两份指令互相矛盾。 - **退出时用量统计修正**：部分模型的 input 恒为 0、未命中缓存的输入被误计为 cache write；`/context` 与 `/stats` 的缓存写入统计同步修正。 ## [2.173.0] - 2026-10-22 ### 🎉 新功能 - **ViewImage 工具**：新增统一的图片读取入口。多模态模型调用时直接返回图片；非多模态模型调用时由识图模型读取图片并返回与提问相关的文字描述，主模型不再接收图片，避免带图请求触发服务端模型改派与会话缓存失效。Read 工具遇到图片文件时改为引导使用 ViewImage。 - **用户发图的图片转文字**：当前模型不支持原生图片输入时，用户消息里的图片会换成一句带本地路径的提示，引导模型改用 ViewImage 读取。图片本身仍保留在会话历史里，切换到多模态模型后照常直接发送，不会因为换模型丢图；历史里超出保留轮次的图片占位符也追加了 ViewImage 使用指引。 - **委托改为可叠加的协调工作模式**：委托不再占用权限模式，而是可以叠加在常规、代码模式和精简模式之上，与多任务模式互斥；新增 `/delegate` 命令开关委托，Web 界面输入框新增委托胶囊并支持一键开关，ACP 客户端可通过会话配置项开启委托。委托派出的子智能体沿用主会话的权限设置。对话框的权限选择器精简为默认、自动、完全访问三项，新建智能体的启动权限精简为四项。**不兼容变更**：ACP 客户端不能再通过切换权限模式为 `delegate` 开启委托，此类请求会直接报错，请改用委托配置项。同时修复委托叠加代码模式时模型拿不到可用工具、停止后重新派出的后台子智能体被误终止、精简模式开启委托时无法派发子智能体、代码执行报错时缺少委托指引等问题。 - **中继隧道新增「Web 访问」**：把本机 Web UI 绑定到中继网关的子路径（留空随机生成，网关上全局唯一），在任何浏览器或手机上打开 `https://<网关>/w/<子路径>/` 并用本人 iOA 账号登录即可直接访问，无需输入 Web UI 密码；可选开启访问密钥（默认关），复制的完整链接自带密钥，打开后密钥自动从地址栏清除并按子路径保存在该浏览器。支持复制链接、二维码、开关 / 更换密钥和解除绑定，CodeBuddy 重启后绑定自动恢复；主机管理页在手机上的布局同步优化 (#157090)。 - **Lite 场景模型 Host API**：宿主可通过 `/api/v1/model-variants/lite` 查询、设置和恢复与 `/model:lite` 相同的用户级 Lite 配置，便于 WorkBuddy 等客户端展示和修改当前生效的 Lite 模型 (#148427)。 ### 🔧 改进 - **模型列表按终端可用高度展示**：不再限制十项；优先保留相邻模型的完整 ID，再分配描述高度，滚动时提前露出邻项。模型 ID、费率和英文描述按统一列宽对齐，窄屏费率优先简写为完整倍率，空间不足时整列隐藏描述与费率，长 ID 可换行 (#153564)。 - **文件改动帧新增「改前内容」指引**：Write / Edit / MultiEdit 每一刀写盘前都会备份当时的内容，改动帧据此指明该次改动对应的备份版本；未备份时明确给出原因（检查点已关闭、无需备份、备份缺失），客户端的差异视图与撤销不再需要猜测。 - **Agent Home 打开更快更稳**：ACP 绑定失败时在同一 endpoint 上按 250ms → 500ms → 1s → 2s 有界重试，最多 4 次；鼠标悬停已退出的智能体行 150ms 即预热 worker，全局预热间隔不小于 5 秒；智能体转录缓存跨组件挂载保留，回到同一条会话时首帧直接显示上次转录；新增启动阶段打点，可在 Console 用 `window.__agentHomeStartup()` 读取每段耗时。 - **Web UI 观感与易用性优化**：下拉菜单与悬浮框统一为一致的弹层风格；主机管理页重新设计，并新增中继连接的工作原理示意图；模组页的工作台视图与编辑器保持一致；智能体恢复提示改到输入框上方；新手引导不再自动弹出，可随时手动打开 (#157661)。 - **自动记忆不再保存敏感数据**：自动记忆不再保存密码、密钥、令牌，也不再保存真实的主机、端口、域名、路径、账号与证书标识，只保留「东西在哪、长什么样」；用户在对话里贴配置、启动横幅或日志时，记忆只留键名和位置，明确要求记住时同样不保存原值。 - **Team 空闲时不再反复刷新**：成员全部结束后停留在成员视图或让终端一直挂着，界面不再每隔几秒反复刷新，空闲 CPU 占用和日志量明显下降 (#157112)。 - **插件组合运行补充回归保障**：验证工具拒绝后的会话恢复和异常隔离 (#89304)。 ### 🐛 问题修复 - **Read 读取 BMP 图片**：BMP 现与 PNG / JPG / WEBP / GIF 一致，Read 返回绝对路径并提示调用 ViewImage，不再返回「二进制文件」错误 (#153331)。 - **ViewImage 识图超时放宽至 60 秒**：此前 30 秒窗口没有余量、偶发超时后只能回报「图片没能读到」。 - **工具执行中停止后本轮不再卡在「执行中」**：stream-json 模式下工具审批放行、工具正在执行时宿主发送 interrupt，被中断的一轮现在会立即写出唯一一条取消终态 `type=result`（`terminal_reason=aborted_tools`），sandbox-proxy 能正常结束本轮，同一连接可继续对话；A2A 混合模式下对应任务报 CANCELED (#156921)。 - **Hook 拦截工具调用时原因可见、来源明确**：插件或用户配置的 PreToolUse hook 拦截工具时，日志会单行记录拦截原因、来源插件与对应调用；模型收到的结果会标明是被 hook 拦截，减少误判为工具故障 (#157167)。 - **daemon 恢复的 job 在 `/reply` 后正常收尾**：每轮回复结束后 job 都会回到 `done/idle` 并带上本轮结果，不再一直停在 `working/active` (#157372)。 - **新建智能体后的回复稳定上屏**：修复 Web UI 中新建智能体后流式回复反复刷新、正文不随输出追加、输入框状态来回跳动的问题；刷新页面或切回该智能体后，已经流出的正文不再从半截重新开始。 - **Agent Home 多个问题修复**：修复首轮回复展示、恢复智能体输入法组合态、最近活跃排序、忙时重复消息，以及频道图片 / 文件附件上传失败的问题 (#157103)。 - **Web UI 派发或恢复的会话可用自主组队**：这类会话现在可以正常创建频道、查看同事并分配任务 (#157284)。 - **恢复 Agent View 键盘接管与列表滚动**：在会话列表里按回车、`→` 或 Esc 能重新进入选中的后台会话，已结束的会话回车后重新拉起；会话多到一屏放不下时光标越过窗口底部会带着列表一起滚动，进不去时给出原因。 - **Linux 独立 CLI 沙箱恢复显式开启**：只有 `ENABLE_LINUX_SANDBOX_CLI=1` 时才进入 `sandbox-cli`，避免在无法创建 user namespace 的机器上 bash 启动失败。 - **远端主机连接修复**：「SSH 准备」不再把主机密钥已通过校验、仅因探测进程没有凭据而停在认证阶段的情况误判为不可达；显式端口一定生效（显式端口 → ssh 配置解析端口 → 22）；带密码或私钥的连接准备只允许回环来源；目标端存在无法复用的后台服务时展示 PID、端口、工作目录与启动时间，并支持确认后停止重试。 - **远端 CBC 更新不再悄悄多装一份**：安装目标由控制端显式指定为该 SSH 用户的 npm 前缀（POSIX 为 `~/.local`，Windows 为 `%APPDATA%\npm`），并在连接日志里显示实际安装路径；目标端 Node.js 低于 v18.20.8 时直接中止并给出原因；远端 CBC 探测失败时，弹窗给出可在目标机直接执行的排查命令。 - **切换到远端主机后不再误报账号状态未知**：账号状态探测改为在目标连接的路由通道就绪后才发起，不再把正常可用的远端主机误判并阻断创建智能体。 ## [2.172.1] - 2026-10-21 ### 🎉 新功能 - **自定义子代理可禁止模型自动调用**：在 `.codebuddy/agents/*.md` 中设置 `disable-model-invocation: true` 后，该子代理不再出现在模型的 Agent 候选清单中，避免被自动选用；仍可按名称委派（例如在 skill 中写明代理名），工具、模型与权限配置不变。 - **Web UI 远程连接支持 FRP 中继隧道**：主机管理新增「中继隧道」：内网设备互不相通时，可通过 frp 网关中继打通远程 SSH。账号就绪后默认自动共享本机 SSH（无 sshd 时静默启动仅公钥的 sshd，失败可重试，`CODEBUDDY_FRP_AUTO_SHARE=0` 关闭）；同账号其他设备会出现在「设备」里，同一 iOA 企业内也可邀请其他账号共享并随时撤销，对方使用专用密钥登录；一键添加为远程主机后，SSH 连接先直连、直连不通才走中继。支持添加、修改和删除网关；登录账号属于 iOA 时自带内置网关，并可直接「用 iOA 身份开通」。网关地址、frps 服务端（主机、端口、TLS）与连接时的本地端口均可自定义，网关配置按登录账号隔离。连接两端均由 CodeBuddy 自身进程完成，无需安装或运行任何 frp 程序 (#156233)。 - **工具结果可声明 MCP App 视图**：任何工具（含 mod 在 `tool.call` 中改写的结果）可在结果的 MCP 元数据里声明 `ui://` 资源所在的 MCP server 与要展示的数据，宿主只读取该资源并渲染到当前工具卡，卡片按钮通过 MCP Apps 协议回调 MCP 工具；宿主不会替任何调用方执行工具。可用 `CBC_MCP_APP_VIEWS=0` 关闭 (#156568)。 - **微信支付运行时拦截可关闭**：设置 `CBC_WEIXINPAY_INTERCEPTION=0`（或 false / no / off）即可关闭 `WeixinPay-Required` 的识别与拦截，优先于远程配置 (#156568)。 ### 🔧 功能改进 - **Bash / PowerShell 执行结果精简**：移除前台、后台及错误回执中与调用参数重复的命令正文，保留实际输出和执行状态；REPL 兼容新旧结果格式，避免程序输出中的命令标签影响结构化结果读取。部分直接接收工具结果正文的 hook 及失败错误诊断将不再包含重复命令，请通过独立的 `tool_input.command` 获取调用命令。 - **Web UI 流式输出更流畅**：长回复流式输出时，对话区自动吸底不再每帧额外触发页面重排，降低 CPU 占用与卡顿，同时保持始终跟随最新内容 (#156569)。 - **流式 Markdown 渲染降耗**：已完成的代码块不再随新内容逐帧重复语法高亮，正在输出的代码块先以纯文本显示、输出完成后再高亮，长回答输出期间界面更流畅、内存占用更低。 - **后台更省电**：桌面端与 Web 界面切到其他应用后，侧栏智能体头像的装饰动画暂停、宠物动画降低刷新频率，后台空闲时的 CPU 占用明显下降；回到窗口后动画立即恢复，体验不变。 - **发版流水线**：修复 openspec 企业专家团测试夹具（13 个 zip）被 `*.zip filter=lfs` 规则命中、导致全新检出后工作区被判定为 dirty、goreleaser 拒绝构建的问题。 - **Linux 沙箱默认由 `sandbox-cli` 执行**：Linux 上开启沙箱后默认由 `sandbox-cli` 执行命令，与 macOS / Windows 一致；此前独立 CLI 在 Linux 上开启沙箱时，命令实际不经隔离直接执行。宿主可通过 `ENABLE_LINUX_SANDBOX_CLI=0` 关闭。同时移除已无执行路径的 `@anthropic-ai/sandbox-runtime` 旧后端，`/sandbox` 在 Linux 上的依赖检查只要求 `bubblewrap`，不再要求 `socat` (#153722)。 - **Mods `$.mcp.call` 返回值对齐官方 `McpToolResult`**：返回 `{ content, isError, structuredContent }`，content 为服务端原样的内容块；调用未真正到达服务端（未连接、被出站审查拦截等）时 `isError` 为 true (#156568)。 - **新手引导「已看过」改为服务端持久化**：之前只存在浏览器本地缓存，换端口或浏览器会重新弹出引导；现在保存在用户级设置中，并会把旧的本地状态迁移上去 (#156568)。 ### 🐛 问题修复 - **会话运行态卡在 `model_done`**：修复上下文压缩失败并取消续跑后，续跑轮正常结束但终态 `agent_end` 未被状态机收下，导致会话永久保持 busy、同会话后续提问被当作排队消息静默丢弃的问题；新消息准入前会把无 lifecycle owner、无在途 run 的残留运行态收敛回 idle (#153047)。 - **Agent Teams 成员关闭状态**：修复成员已交付产出时因关闭请求被误标为「已中断」的问题；关闭会等待本轮正常结束并保持「已完成」，减少不必要的回复轮次与重复完成通知 (#153786)。 - **Grep 带 glob 搜索超时**：修复大仓库中带 glob 搜索时空等 30 秒后超时失败、模型被迫改用全仓 grep 重搜的问题；现在只启动一次 ripgrep，并按 glob 的目录前缀缩小搜索范围，搜索超时时保留已找到的结果并提示缩小范围 (#154213)。 - **Auto 模式下 REPL 内层工具权限分类**：内层工具不再因嵌套深度跳过权限分类，实际工具参数按普通调用执行权限分类：模型允许时直接执行、拒绝时直接拦截；分类失败后需要确认的动作不再静默放行，并修复等待分类期间取消后仍可能执行的问题 (#155940)。 - **专家团收尾时序**：修复专家团最后一位成员结束后，主对话在负责人尚未处理完成员结果时提前结束，导致负责人的后续输出被错误归到上一轮、下一轮提问在会话中错位的问题 (#154806)。 - **Windows 终端重绘**：在 Windows 终端中进入 `/login` 再返回，或调整窗口大小时，旧欢迎界面不再残留在滚动历史里层层堆叠，往上滚动只会看到一份 (#153803)。 - **定时任务锁失效**：电脑休眠唤醒或进程长时间卡顿后，定时任务执行记录的文件锁可能被其他进程判定过期并清理；本次写入现在按普通失败交给已有重试处理，不再触发进程级未捕获异常，也不会在终端输出异常堆栈。 - **升级失败提示**：npm 升级失败时，错误信息不再只有 `exit code 1`，会带上 npm 给出的具体原因（如缓存目录权限问题）；后台自动更新失败时不再每小时弹出错误提示（当前版本不受影响），仅在安装被损坏、需要手动修复时提示。 - **远端 CBC 安装与连接**：远端缺少 CBC 时统一走 npm 安装，缺 Node.js/npm 时先请求明确授权再安装到当前 SSH 用户目录；远端 CBC 不兼容时展示具体原因（版本、协议、探测失败等），不再只显示「未知」，并提供一键更新、兼容判定改为版本范围 + 协议校验；修复主机导入不支持 `ssh root@host -p 36000` 形式端口、远端后台服务升级后复用旧实例导致连接失败、原生更新清理历史版本时可能删除当前运行入口以及更新失败仍返回成功的问题。 - **远端目录浏览**：目录浏览可进入根目录（切换工作区不再 502），路径栏随导航刷新。 - **Web UI 智能体自动恢复**：修复侧栏 / 智能体页点击已退出的智能体后不再自动拉起 worker、必须手动点「重启」才能继续对话的问题（历史抽屉与深链仍保持只读）。 - **新建智能体回复稳定上屏**：修复 Web UI 中新建智能体后流式回复反复刷新、正文不随输出追加、输入框状态来回跳动的问题；刷新页面或切回该智能体后，已流出的正文不再从半截重新开始。 - **Windows 上 Glob 搜索兜底**：修复 Windows 上内置搜索程序偶发启动失败时 Glob 文件搜索直接报错的问题，现在会自动改用备用搜索方式返回结果 (#155323)。 - **UserPromptSubmit hook 阻断后上下文丢失**：修复阻断后进程重建会丢失此前对话上下文的问题；阻断提示不再挂到未落盘的用户输入上，读取旧会话时也会修复既有的断链 (#156425)。 - **MCP App 卡片按钮调用被拒**：修复卡片内按钮触发的反向调用没有携带会话信息、在开启敏感出站审查的环境里统一返回拒绝（按钮永远无效）的问题 (#156568)。 ## [2.171.0] - 2026-10-20 ### 🎉 新功能 - **模型请求分层重试**：生成开始前的模型请求失败优先遵循网关 `retry_policy`：策略为不重试时不重试；允许重试或未下发策略时，对 429（瞬时限流）、5xx（EdgeOne 570-579 除外）、408、409 最多重试 8 次，1s 起步翻倍、单次本地等待封顶 32s。服务端通过 `Retry-After`（秒数或 HTTP 日期）或 `retry_policy.retry_after` 要求更久时按服务端时间等待，不再截短；重试等待期间会话显示为正在重试，用户停止后立即结束等待且不再发起请求。 - **远程主机管理**：侧边栏提供紧凑的主机快速切换与主机管理页面，支持在新窗口打开指定主机并保留原窗口的工作区与会话；添加主机时可复用已有 SSH 配置，或预览 SSH 命令并明确应用连接信息。 - **远程授权目录文件与 Git 只读**：可在已授权的远程目录中浏览文件，查看 Git 状态、Diff、日志与分支；浏览器取消或连接中断时对应的远程文件/Git 请求同步终止，不再在后台悬挂。 ### 🔧 功能改进 - **后台会话崩溃自动续跑**：`--bg` 后台会话进程异常退出（如 OOM 被强杀）时按原会话 `--resume` 自动拉起，崩溃时任务仍在进行则自动发送续跑提示接着执行；600 秒内最多自动重启 3 次，可用 `CODEBUDDY_JOB_CRASH_AUTO_RESUME` 关闭，并用 `CODEBUDDY_JOB_CRASH_MAX_RESTARTS` / `CODEBUDDY_JOB_CRASH_RESTART_WINDOW` / `CODEBUDDY_JOB_CRASH_RESUME_PROMPT` 调整次数、窗口与提示文案。 - **REPL 调用展示**：调用行不再展示完整代码（收进 Ctrl+O），结果区默认每次一行展示内部工具调用；设置 `CODEBUDDY_REPL_HIDE_TOOL_CALL_DETAILS=1` 可隐藏明细，结果区只保留耗时与 Output。 - **云端记忆工具命名**：记忆召回与更新工具统一为 `MemoryRecall`、`MemoryUpdate`，精简云端记忆使用规则并明确平台不可用时不得写入本地文件替代，保持 Cloud Agent MCP 的展示兼容。 ### 🐛 问题修复 - **网关密码下的 ACP 连接认证**：修复 `--serve` 开启网关密码后，暴露远程端口或经 Tunnel／反向代理转发时无需密码即可创建 ACP 连接、领取连接令牌的问题，以及密码可经网址泄露到代理与访问日志的问题 (#146634)。 - **嵌套 CLI 误删宿主会话历史**：Bash / PowerShell 执行的用户命令不再继承宿主 `CODEBUDDY_CONFIG_DIR`，避免在 WorkBuddy 对话中运行用户自装的 `codebuddy` 时按 30 天策略清理宿主会话导致旧对话显示「暂无对话记录」；第一方脚本仍可通过 `WORKBUDDY_CONFIG_DIR` 获取宿主目录 (#152783)。 - **stream-json 回合边界**：print 模式每轮 `result` 为该轮最后一帧，不再在 `result` 之后补发 `system/init`，避免回合超过 30 秒时向 SDK 宿主进程内 MCP server 多发工具列表请求导致宿主退出 (#120260, #154617)；`--a2a` 混合模式轮次在 stdout 上以 `system/init` 开头。 - **后台任务重复唤醒**：修复后台任务结果已读取后仍重复唤醒对话的问题，等待中的未读完成通知合并处理，通知轮正常结束且无内容时静默收尾 (#143750)。 - **纯思考响应误续跑**：交互式 CLI 中模型仅返回思考过程、无正文与工具调用时正常结束本轮，避免续跑请求以 assistant 消息结尾被模型网关拒绝；显式关闭开关与非交互调用保持原行为 (#154840)。 - **自动刷新插件打断提交**：修复刷新插件时中断正在提交的消息、请求提前结束且无法显示模型错误提示的问题，未变化的插件保留运行状态 (#153952)。 - **检查点与文件回退**：修复编辑前后字节长度相同时检查点未保存新版本、恢复代码误撤销更早轮次修改的问题 (#152458)，以及恢复旧会话并压缩上下文后文件回退提示 `Checkpoint workspace is unavailable` 的问题。 - **内置只读工具误拦截**：修复内置工具展示本地文件及部分只读操作可能被安全审查误拦截的问题，保留敏感文件、自定义安全规则与原有权限检查 (#152556)。 - **后台会话启动状态登记**：修复 Windows 下后台会话偶发无法完成启动状态登记，以及会话已运行但进程信息未登记时回复被误存为待发送消息的问题。 - **`codebuddy update` 多 Node 环境**：修复机器上并存多个 Node（Homebrew 与 mise / nvm）时更新后一直停在旧版本的问题，npm 升级始终装回当前正在运行的这份安装。 - **PTC 嵌套派发归属**：修复 PTC 模式下协调者嵌套派发子 Agent 时误切换团队归属，导致运行中的下级从终端任务树消失、回报无法唤醒协调者的问题。 - **远程连接与生命周期**：身份验证完成后才显示已连接；取消或断开时及时回收认证资源，迟到结果不影响新连接；远程网关退出后自动关闭独立进程组中的智能体；改进密码传递，避免暴露在进程参数与环境变量中。 - **远程主机切换与观测**：修复断开远程连接后被自动恢复重新连接、实例删除失败与有效进程被误判为已替换的问题；统计、链路与监控页面接入远程服务，切换主机时清除旧主机数据并阻止迟到响应覆盖。 - **远程首屏与 daemon 操作**：先完成远程 API 与存储作用域绑定再挂载会话组件，避免刷新后账号与状态查询误发到本机；停止远端 daemon 或断开连接失败时保留操作菜单并显示错误。 - **关闭文件预览**：本地与远程文件读取均传递取消信号，避免预览关闭后仍占用连接。 - **模组重新信任**：修复模组取消信任后因缺少信任的历史诊断阻止再次弹出授权确认、无法重新信任并启用的问题。 - **智能体后台运行协作能力**：修复 Web UI 智能体任务改为后台无界面运行后，频道成员在重启或恢复会话后无法发言、无法读写任务板与私信的问题；用户自行发起的无人值守任务仍不开放这些协作能力。 - **智能体模型与权限保留**：目录读取快路径仍从主任务补齐缺失配置，且不会覆盖显式设置。 - **macOS 快捷键写法**：命令面板、快捷键设置、编辑器与对话空态、最近会话提示统一使用 ⌃⌥⇧⌘ 符号及系统菜单顺序，Windows / Linux 保持 `Ctrl+Shift+P`；快捷键设置页仍支持 `cmd+shift+p` 等写法搜索 (#153795)。 - **Web UI 手机浏览器适配**：底部输入区与各类底部控件避开 iPhone Safari 浮动地址栏，触屏按钮更易点按，输入时页面不再自动放大，窄屏与键盘弹出时菜单不再超出可见区域；对话空状态的欢迎区恢复为简洁的品牌标识。 - **Desktop Web UI 新手引导**：修复 CodeBuddy Desktop 拉起 daemon 后，daemon 重启时新手引导再次自动弹出的问题，未显式指定端口时复用稳定 Web UI 端口并保持设备级 origin 状态 (#154485)。 ## [2.170.0] - 2026-10-19 ### 🎉 新功能 - **Web UI 新手引导**：首次进入智能体页时分步讲解分身、如何拉频道和智能体协作、模组能做什么以及能力边界；欢迎区提供可点开的引导卡片，并可从头像菜单、设置页和命令面板随时重新观看。欢迎区与桌面端选择工作目录的启动页同步使用最新的智能体头像，分身保持专属形象。 ### 🔧 功能改进 - **工作台内置浏览器**：CodeBuddy Desktop 提供内置浏览器时，工作台不再展示 Web UI 自带的浏览器预览：「打开浏览器」入口、对话与内嵌智能体页面中的链接统一在 Desktop 内置浏览器中打开，其标签与入口改用地球图标；普通浏览器中保持原有预览。 - **工作台按会话保存**：每个会话保留自己的标签页（含 Desktop 内置浏览器），切换会话或刷新、重启后恢复到该会话的工作台；切到其它页面时 Desktop 内置浏览器会收起，不再遮挡页面。 - **工作台浏览器页签**：页签改为胶囊样式并显示站点图标，浏览器页签按标题自适应、工具栏居中；空白页跟随主题，修复切换视图后页面残留、菜单被页面遮挡、中文输入法回车误触发搜索及后台任务输出滚动条位置。 - **模型选择面板**：新增随光标切换、自动换行的独立详情区，描述优先跟随系统界面语言，缺少中文文案时回退英文，并支持手动指定语言；列表根据终端尺寸调整可见项数，修复长列表切换时的旧详情残留与显示错位。模型说明及相关展示文案按纯文本处理，限制长度，阻止控制字符改变终端标题或剪贴板。 - **图片读取与历史回放开销**：读取图片时保留完整图片预览，避免工具结果重复传输图片数据，降低大图和多图读取的传输开销；本地 WorkBuddy Client 显式声明能力后，历史图片直接回放为 BlobRef 资源引用，其他 ACP Client 继续收到标准 base64 图片，保持兼容。 - **Windows Shell 环境快照**：函数定义改为直接写入快照，不再逐函数 base64 编码后再还原，避免完整版 Git for Windows 大量函数时序列化逼近 10 秒超时；在已启用删除保护的命令执行环境中再启动 CLI 时，快照不再被拖慢，约 1~2 秒完成。 - **工具检索 Decision 精排（内部能力）**：ToolSearch 和 PTC 工具检索支持可选的 Decision 精排，默认关闭；开启后默认精排最多 128 个候选，超时或接口失败时回退至原检索顺序。 - **云上 CBC 伽利略配置**：支持云上 CBC 专用伽利略配置，日志及会话、模型、工具调用链路可上报到指定后端对象和环境，保持桌面端默认行为不变；专用配置无效时，日志与追踪一致关闭且不回落到产品配置。 - **问答链路数据埋点**：对齐问答核心链路埋点口径，`chat_request_send` 新增 `isMaxMode` / `source`，`mentionContexts` 升级为 `type:count` KV 字符串数组，`skillId` 支持本轮多技能聚合；仅数据改动，不影响运行时行为。 - **质量验证录屏**：TUI 终端录屏改为 asciicast v2 格式（`tui.cast`），并记录每一步操作和检查结果的标记；`quality:trace show` 可直接回放该录屏。 ### 🐛 问题修复 - **取消后保留已写盘的文件修改**：取消对话时，若 `Write` / `Edit` / `MultiEdit` 已把修改写入磁盘，会话记录保留真实执行结果，不再记成「Interrupted by user」；免审批下执行的工具同样生效（#142914）。 - **会话卡在生成中**：修复模型请求出错后预判会自动重试、实际未重试时，stream-json / ACP 等通道不下发本轮终态结果，导致前端一直显示「生成中」。 - **记忆提取空压缩**：记忆提取等辅助调用不再触发会话压缩；压缩结果没有写入历史时连续压缩次数会回滚，后续对话仍能正常压缩（#152070）。 - **压缩后误显示用户取消**：修复上下文压缩后任务正常完成仍显示「用户已取消」的问题，保留真实取消、目标暂停与续写失败的正确终态。 - **远程访问完全访问（#153450）**：修复远程访问 Web UI 时新建智能体选择「完全访问」报 `unsupported permissionMode` 的问题，远程访问也可使用完全访问权限并设为默认。 - **PowerShell 赋值脚本裁决**：修复 PowerShell 赋值脚本被按 Bash 解析，导致沙箱命令裁决主体为空的错误；使用 PowerShell AST 提取命令，不新增合法脚本语法限制，并正确处理 wrapper 字符串转义和未调用的函数定义。 - **PowerShell 编码命令误判（#17117）**：修复 `checkEncodedCommand` 的 `\b` 边界在文件名 `-EN`、路径 `/en.` 处成立，导致普通明文命令被整体拦截；真实编码命令仍被阻断。 - **Web UI Bash 命令输入**：执行 REPL 中的 Bash 命令前提示会丢失反斜杠的字符串转义，避免错误命令静默挂起；自动命令不再无限等待无人提供的标准输入，后台任务显示转后台原因、实际运行时长和最近收到新输出的时间。 - **Web UI 文件树 Git 忽略状态**：修复查询 Git 忽略状态可能导致 CLI 退出、打断任务的问题；非 Git 目录正常显示文件树，减少重复查询并取消过期请求。 - **Web UI 任务状态与启动**：新增服务端计算的任务活跃度投影，统一 agent-view、jobs API 与 Web UI 行；接管的 job 报 idle/settled 时关闭输入框的运行中状态；重启 job worker 时恢复被中断的用户指令；Web UI 智能体任务改为 headless 运行，移除启动对 PTY broker 的依赖；保留可操作的失败详情。 - **插件工具结果文本**：交互式终端正确显示插件工具返回的文本结果，不再显示 `[object Object]`（#149571）。 - **非托管入口自动更新**：修复从源码目录或非托管入口运行时，误更新另一份全局安装并反复重装、提示安装损坏的问题。 - **REPL 折叠标题**：调用行默认展示 code（去换行压成一行，水平放不下时截断），并同时展示模型回填的 description，不再显示无信息量的 Code / REPL（#153360）。 ## [2.169.0] - 2026-10-19 ### 🎉 新功能 - **Web UI 全屏工作台对话标签**：全屏工作台新增固定对话标签并显示当前会话标题，可在对话与文件、终端等标签之间切换，切换后保持会话状态。 ### 🔧 功能改进 - **工作台浏览器地址栏与页签**：地址栏聚焦态对齐 Chrome（填充胶囊 + 焦点环）；页签改为无缝排列、激活页签与内容区连成一整块，并显示站点 favicon。 - **插件入口收进头像菜单**：左侧导航栏移除「插件」一级入口，改由底部头像菜单进入，减少左轨占用。 - **模组页头部按钮等宽**：「添加模组」与「AI 创建」统一最小宽度并排，避免长短不一。 ### 🐛 问题修复 - **工作台浏览器空白页跟随主题**：空白页签不再挂载会露出白底的预览页面，统一渲染跟随明暗主题的空白画布；地址栏中的 `about:blank` 也按空白页处理。 - **工作台浏览器收起后不再残留**：桌面端非激活页签或收起右侧工作台时隐藏浏览器预览，避免网页浮在界面上且无法关闭；重新展开时不再刷新页面或丢失前进后退历史。 - **新建文件行号与编辑卡片**：查看新建文件时仅显示一列行号；编辑卡片使用本轮固定的编辑片段展示差异，不再因会话状态变化偶发丢失高亮。 ## [2.168.3] - 2026-10-18 ### 🎉 新功能 - **定时任务有效期与指派**：持久化定时任务默认设置 30 天有效期，查看具体结果或手动续期后重新计时；到期暂停并保留历史，可自定义有效期或明确选择永不过期。定时任务可以指派给分身或同事，默认由分身在任务所在项目执行；改派后隔离执行历史，指派对象失效时暂停而不自动换人。 - **防止系统自动休眠**：全局设置新增默认开启的「防止系统自动休眠」开关，允许正常熄屏；关闭后后台服务即时释放防休眠请求，无需重启。Windows 防休眠方式同步修正，电源请求随进程退出自动释放，不再写入持久系统 override。 ### 🔧 功能改进 - **Web UI 输入区与消息队列**：工作流、后台任务与待处理消息统一吸附在输入框上方，默认紧凑摘要、详情互斥展开，避免并存时挤占对话区；忙碌时默认在下一次模型请求插入跟进消息，输入框加号菜单可切换插入或排队并记住选择，消息队列仅在存在实际消息时显示。 - **问答卡片**：优化问题层级、选项状态、自定义回答、填写进度、提交反馈、审核回改与历史答案摘要，修复刷新后已回答记录被隐藏的问题。 - **对话顶栏与提示样式**：精简对话顶栏，移除导出按钮，将工作台展开按钮置于最右，统一左右侧栏图标；统一停止、执行限制和后台失败提示样式并保留具体错误信息，连接故障支持展开详情并保留重试与接管入口。 - **工具过程渲染开销**：收起动画结束后释放不可见正文与视图订阅，重新展开保留完整记录；过程计时不再每秒重绘整段历史正文，流式阶段不再反复执行定稿解析与文件校验。 - **TUI 长文本换行**：优化长中文与 emoji 工具输出的换行计算，减少输出更新阻塞终端输入回显的情况，保留完整内容与精确省略行数。 - **技能管理日志**：减少技能管理可用性检查产生的重复日志和无关配置序列化开销，保留首次状态及开关变化诊断。 ### 🐛 问题修复 - **文件改动卡片显示行数（#134426）**：ACP v2 文件变更的每个 `DiffChange` 在 `_meta['codebuddy.ai/stats']` 中携带增删行数与字符数，大文件未生成 patch 时仍能显示 `+N -N`，会话回放同样保留。 - **计划批准后权限未生效（#142040）**：服务端批准计划后，所选权限在同一轮后续操作前应用，自动模式继续遵守可用性限制。 - **取消后旧操作仍执行**：修复自动审批等待期间取消任务后，迟到的审批或插件处理仍可能执行旧操作的问题；取消后可正常开始新任务，已运行的后台任务和原始对话内容不受影响。 - **daemon 重启后远程控制未恢复**：用户主动连接成功后保存恢复偏好，主动停止后不再恢复，普通 CLI 不自动联网；已断开的微信、企微与远程控制连接执行停止时仍会清除恢复意图，停止期间的迟到连接不会重新启动。 - **定时任务网络恢复**：修复电脑休眠后网络尚未恢复时定时任务立即失败的问题，网络恢复后再启动，并在执行记录中显示可读的失败原因。 - **Web UI 左侧栏底部布局**：`before`、`after`、`footer` 的模组贡献统一由宿主按行承载并约束 rail 宽度，避免自定义尺寸或长内容把底部入口挤乱。 - **Web UI 宠物与对话定位**：宠物类型与显示偏好保存到本机服务，重启后更换访问端口仍可恢复选择；查看较早消息后发送新消息会立即回到对话底部，工具过程与下一条用户消息之间保留清晰间距。 - **Web UI 排队消息竞争**：修复多条排队消息消费时通用自动排空与 ACP 排空同时启动下一轮的竞争，主会话由 ACP 串行消费并完整转发结果；回合结束后抵达的跟进消息通过原消费循环自动继续，停止后不自动恢复。 - **输入框 Agent 模式**：修复 Web UI 选中智能体后的输入框不显示当前 Agent 模式的问题，智能体新建会话后也会继续显示对应模式。 - **Web UI 子代理与思考强度**：派发子代理的 Agent 卡不再被后续流式参数帧或快照尾部覆盖，实时对话与刷新回放均保留子代理身份；PTC 模式下通过 `Agent()` 派发的子代理同样显示为子代理卡片；取消当前回合后不再残留「运行中」状态；MCP 经 `DeferExecuteTool` 返回的压缩 JSON 自动格式化并支持折叠预览；思考强度读取与终端一致的配置，各模型档位按实际支持能力展示。 ## [2.168.2] - 2026-10-16 > 说明：v2.168.1 未成功发布，本版本重新发布其全部内容。 ### 🔧 功能改进 - **TUI 新会话默认使用 PTC 模式（#141503）**：交互式 TUI 新建空白会话在未指定 Agent、未设置默认模式且无上次选择时，默认使用 PTC 模式；`/agent-mode` 的切换会被记住，`--agent cli` 可显式使用标准模式。非交互调用、SDK、ACP、后台会话及恢复会话行为不变，关闭主 Agent 总开关后仍使用标准模式。 ### 🐛 问题修复 - **子 Agent 模型跟随会话（#149675）**：通过 IDE 模型选择器、`/model` 或 ACP 切换模型后，未单独配置模型的默认 `lite` 子 Agent 跟随当前会话所选模型，包括自定义模型，不再回落到启动默认模型。 - **企微机器人连接被抢占（#150664）**：新开命令行进程自动连接前会让位给正在服务同一机器人的存活进程，仅手动连接才接管；被本机其他进程接管后，对方退出时可自动重连，并提供明确的告警日志。 - **Mod Hook 误报（#150666）**：不再把 Mod 的 Hook 清单当作 Shell Hook 配置校验，正常加载的 Mod 启动时不再误报「hook 配置格式无效」。 - **频道引用回复错位（#150667）**：忙碌成员在本轮结束后收到的引用回复仍保留自身消息编号及被引用原话，避免将答复对应到其他待办。 - **团队负责人频道权限（#150668）**：负责派单的 lead 创建子 Agent 后，仍可在频道发言和更新任务板，不再被误判为影子会话；团队成员及子代理仍不能冒名发言。 - **Web UI 文件路径点击（#150752）**：相对路径按当前会话工作目录、上级目录及项目文件查找，重名文件提供候选菜单；支持文件名加行号、行列号、多行号及 Markdown 文件链接。助手输出完成后统一校验文件路径，仅真实存在的文件显示为可点击链接。 - **大图工具结果导致终端卡死（#151011）**：浏览器截图等 MCP 工具返回的内嵌图片在终端显示为 `[Image: …]` 摘要；超长无空格文本换行采用线性处理，避免界面长时间无响应。 - **专家团 Hook 工具拦截（#149700）**：修复安装 Hooks 插件后，专家团队员及 leader 后续轮次的工具调用被 `Hook operation was cancelled or completed` 错误拦截的问题。 - **压缩后上下文用量（#148771）**：上下文压缩后的估算用量用于实时推送、配置切换与会话恢复，不再显示压缩前用量；累计计费保持不变，下次模型请求后恢复实测用量。 - **原生运行时错误恢复（#149666）**：修复工具调用异常无法自纠正、步数上限误判及取消和权限拒绝分类不准确的问题。 - **独立二进制批量安全删除（#150443）**：修复批量删除获准后仍失败的问题，宿主与 Shell 共用真实 sidecar 路径，正确保存自动批准、手动批准和拒绝结果，批准后仍通过安全删除回收文件。 - **任务列表文案与恢复**：非英文任务标题不再被错误拼接 `ing`；恢复中断会话后，每轮从保存的任务列表恢复当前进度，避免列表为空或停留在旧状态。 - **搜索信源保留（#150643）**：WebSearch 不再误删合规隐藏 URL 的搜索信源，保留可用摘要与来源信息。 - **当前失败请求重试（#143142）**：Harness 可通过 `session/prompt` 重试当前轮并复用原 requestId 和用户消息，避免排队重试重复创建输入，支持从持久化历史恢复。 - **macOS 工具输出警告**：修复签名版 IDE 执行安全删除和 brokered 命令时，输出混入 Electron 环境变量警告的问题。 - **Windows Gateway 终端选择**：按 PATH 选择 PowerShell，避免同步版本探测阻塞请求或跳过可用终端。 - **会话授权与规则隔离**：HTTP「本次会话放行」授权在本地保存并按序同步，安全中心断连或重启后可重新下发，释放会话后同步清理；文件、命令和网络的「本会话允许」在当前 Agent 会话内复用，不自动新增安全中心规则，受保护条目失效后重新审批。规则上下文与产品保护路径绑定目标会话，避免切换会话后串用规则；释放历史会话不再清空当前受限规则。 - **沙箱命令收尾与取消**：执行期间持续确认文件操作记录，重试不重复添加删除事件；命令退出、启动失败或关闭运行时会等待文件操作及清理完成，再获取结果。取消超时不再视为可信退出，释放后 30 秒仍未退出的执行按无退出状态收尾；查询与关闭仅对可识别的短暂传输故障有限重试，证据不完整或收尾失败时明确提示文件可能已被修改。 - **沙箱资源与安全删除兼容性**：跳过不完整的 Runtime Kit 候选目录，Broker 资源缺失时明确失败；修复 Desktop 本地沙箱包与独立删除 helper 的校验冲突。批量删除预检在安全中心裁决不可用时保留用户审批，定制版保护与放行路径使用产品目录配置。 ## [2.168.0] - 2026-10-15 ### 🎉 新功能 - **模组工具返回图片**：模组注册的工具可以返回 MCP 风格的图片内容，模型会直接看到图片（例如网页截图），不再只收到文本。 - **桌面 Agent 浏览器原语**：在 CodeBuddy Desktop 中，模组可以通过 `desktop.agentBrowser.acquire()` 拿到自己的浏览器租约，用视图、页内 CDP、镜像帧 / 原生挂载 / webview、独立的 Cookie 分区、加密保存的登录凭据和原生确认框等原语自己实现浏览器功能；没有模组申请时 Desktop 不创建任何相关资源。 - **内置模组批准接口**：新增 `GET /api/v1/plugins/mods/source` 与 `POST /api/v1/plugins/mods/approve`，安装方可以按确切源码哈希批准刚安装的模组（与 `cbc plugin add --yes` 一致）。 ### 🔧 功能改进 - **模组启动与重载开销**：通过有界编译结果复用、轻量发现与可取消下载降低模组启动和重载成本；已安装模组只在视图、文件、记忆主题或显式操作需要时加载，不再重启无关扩展。 - **模组入口提前可用**：模组可以在代码加载前发布本地化的工作台与命令入口，用户可在原生命令快捷键设置里绑定这些命令，已保存的绑定在停用再启用后依然保留；新增跟随原生主题与语言的持久化 Notes 工作台模板。 - **模组资源与快照回收**：包内图片、字体与数据与代码独立加载，复用已验证的资源字节并安全回收未使用的快照；已批准的 Web 包与函数 Hook 使用所选定的不可变源码，撤销、损坏与安装标识变化仍是明确失败；普通原生插件与开发目录行为不变。 - **模组命名空间与服务诊断**：保持模组之间的翻译命名空间相互独立；提供服务 API 不匹配的诊断，并在不重新下载的前提下恢复兼容的消费者；新增可选的、带校验的浏览器存储迁移与版本快照，升级失败时保留旧数据。 - **模组启动诊断**：暴露有界的启动与命令诊断，只在页面就绪后发布发生变化的报告，并允许在不重放业务写入、不降低源码批准要求的前提下显式恢复。 - **模组创作错误本地化**：模组创建、组合与编辑的入口错误改用本地语言提示，覆盖会话繁忙、待回答提问或待审批、会话缺失、模式切换超时与会话变更等场景；源码批准与加载上限也使用本地语言，诊断细节保留在本地化摘要之后，第三方错误内容保持原样。 - **模组集合导出与锁定**：`plugin collection` 可导出已安装 Web 模组的精确源码快照及其必需依赖闭包，保留包默认值、本地化贡献与选定的启用状态，不读取用户配置、凭据或业务数据；接收方使用普通 bundle 导入流程，且必须独立批准每一份源码。锁定 bundle 成员的路径、名称、版本、完整源码哈希与启用状态，在安装或构建前拒绝不匹配的成员，只有在明确的构建 / profile 组合后才更新派生锁，非法更新时保留最后一次提交的目录。该锁定是可复现性校验，不是发布者签名或批准授权。 - **WorkBuddy 首轮响应**：预热 CBC 在 activate 阶段异步启动 outbound A2A AgentCard 发现，不延迟 ready ACK；首条消息仅在发现尚未完成时等待同一个请求。 ### 🐛 问题修复 - **Monitor 成本失控**：修复 Monitor 启动后可以永不停止、用户离开后仍持续唤醒模型并消耗大量 Token 的问题。现在所有 Monitor 默认运行 5 分钟、最长 30 分钟，移除了可无限运行的 `persistent` 参数；到期后模型会收到一次带事件数的通知，确有需要可自行重新开启。此前 Monitor 的完整工具说明也未注册，模型看到的只是占位字符串，现在完整说明正式生效。 - **防注入检测覆盖率（#149039）**：增加每轮工具结果审核的输入预算，减少较长任务中后续工具结果因预算耗尽而跳过审核的情况。 - **Web UI 监听器泄漏（#149564）**：任务面板反向代理复用连接时不再累积超时监听器，长时间运行不再刷出 `MaxListenersExceededWarning`。 - **ACP 子代理提问（#89387）**：在 WorkBuddy Desktop / Web 中，workflow `agent()`、Agent 工具和 fork skill 启动的子代理现在可以正常使用 AskUserQuestion，不再静默失去提问能力。 - **插件 Hook 特殊路径（#148529）**：用户目录中含有反引号、美元符号等字符时，插件 Hook 不再因路径被当作命令语法而启动失败。 - **分支会话保留子代理历史**：`/fork` 与 `/branch` 现在可以复制包含已完成子代理历史的会话，并保留所选主 Agent、模型、输出风格与权限；关联的子代理记录与工具输出独立复制，分支可以续聊而不影响原会话。 - **Goal**：修复清除后仍继续执行、异步操作覆盖新目标、重启后状态丢失及已结束目标重新激活的问题；分支会话不继承原目标，重新加载后正确完成目标，清除已暂停目标不会中断其他工作；Esc 暂停 Goal，终端补充暂停、恢复和清除提示。 - **Goal 持续推进**：评估失败不再误报目标达成，提示目标已保留并可继续任务重试；未达成判定缺少原因时仍可续跑，每轮强化完整目标验证与必要提问边界，不绕过授权和暂停。 - **会话恢复与列表**：修复会话保存与历史追加并发时 JSONL 被清空、导致重启后会话消失的问题；修复长会话或模型出错后 resume 列表把仍有工作记录的会话误判为空的问题。 - **模组创建会话绑定**：修复新建会话（以及清空会话）后进入模组创作时，会话绑定迟迟建立不起来、要等满 15 秒才失败的问题；连续发起多个创建请求不再静默丢弃后一个，当前已是创造模式且仍在运行时，会为新的创建请求另开一条创造模式会话。 - **浏览器模组定时器**：修复使用普通定时器或动画帧的浏览器模组（例如游戏与动画组件）报 `setTimeout is unavailable` 的问题；定时器与动画帧现在正常运行，并在模组停止、更新或页面切换时自动取消。 - **模组客户端检查恢复**：修复模组客户端就绪握手与会话启动竞争、或在重新绑定时被撤回，导致当前应用页面上的检查无法完成的问题；现在只重试幂等的页面握手，并为查询挂载、取消与在途容量设置上界，同时保持精确的连接 / 会话归属，不再从其他已打开页面作答。 - **后台任务列表刷新**：修复进程检查较慢时 Agent View 列表停留在旧状态的问题，操作后的刷新会合并执行。 - **停止后删除**：修复后台进程被清理 PID 或启动时间表示变化后，Ctrl+X 偶发无法停止、删除同一任务的问题；列表重绘后快捷键读取当前选择，停止失败时显示原因。 - **后台会话接管**：修复临时目录路径过长时无法接管后台会话的问题；控制端点启动失败时停止内层进程并保留错误。 - **空闲回收与主动停止**：修复后台会话空闲回收请求重叠时被直接拒绝，导致正常结束的 worker 在退出后被误判为异常结束的问题；用户主动停止后台任务时明确显示 `stopped by you`，不再与异常结束共用提示。 - **PR 关联与评审**：支持从结构化 gh 工具输出关联 PR，Jobs 详情返回 PR 链接和检查状态，成功完成但仍有开放 PR 的任务进入待评审分组。 ## [2.167.0] - 2026-10-14 ### 🎉 新功能 - **模组整页应用（#147597）**：模组可以注册整页应用，入口出现在 Web UI 左侧导航最顶部；同一页面可在 CodeBuddy Desktop 中以独立窗口或全局浮窗打开。在 CodeBuddy Desktop 中，模组还可以打开独立窗口、置顶的全局浮窗并注册全局快捷键，模组停用或页面刷新时自动释放；模组可以使用依赖弹层（Portal）的常见 React 组件库。内置 Web 模组去掉 `codebuddy-` 前缀，彩蛋模组更名为 `brawler`。 - **工作台浏览器（#148857）**：右侧工作台的「+」菜单新增「浏览器」，可以新开空白标签并在地址栏手动输入网址（自动补全协议，支持 localhost 等本地开发地址），提供后退、前进、刷新、停止和在外部浏览器打开。在 CodeBuddy Desktop 中可直接打开禁止被内嵌的网站并支持在其中登录，页面跳转后地址与标签标题自动同步；网页运行在独立隔离的环境中，无法访问本机或应用能力。普通浏览器中打开被站点禁止内嵌的页面时，提示可改用 CodeBuddy Desktop 打开。 - **压缩恢复会话内动态上下文**：新增 `current-context` 层的压缩恢复能力，压缩后按固定顺序提取身份、模式、连接器状态等白名单标签在历史中的最后一份并回填，避免压缩续聊时丢失这些上下文；其中模式标签按互斥槽位只保留最新一份，避免同时恢复冲突指令。 - **云端长期记忆工具（#60574）**：在 WorkBuddy 桌面端运行时新增 `MemAnswer` 与 `MemCurate` 工具。`MemAnswer` 按自然语言问题召回当前用户的云端长期记忆，并附带最多 5 条来源；`MemCurate` 把值得跨会话保留的用户信息提交到云端记忆，单次内容超长时直接提示精简或拆分。提交受理不代表已经记住，工具结果会明确提醒模型不要向用户宣称记忆已保存；其他宿主环境不启用这两个工具。 ### 🔧 功能改进 - **启动与目录扫描开销（#145582）**：减少同一次 Skills 扫描中重复读取父目录元数据的开销，插件命令与 Skills 加载可通过当前 DataFs 的查询级只读装饰器合并重复 IO；收窄管理路径使用的 Agent 常量、Hook 和插件协议导入，减少 Harness 冷启动和首次目录查询共同承担的依赖加载；保留宿主文件系统的可选版本元数据，并避免把 UnionFs 上层目录版本误当作合并目录版本，独立 CLI 默认读写与挂载语义保持不变。 - **Web UI 工具集精简**：Web UI 会话不再向 Agent 提供页面查询与页面操作两个委托工具，对话中不再出现对应的工具调用。 - **回归保障（#89304）**：增强跨平台场景的端到端测试稳定性，降低回归误报；加强终端、Web UI、SDK 与协议接入的真实链路回归验证，并补充终端登录、环境认证与自动权限场景的回归覆盖。 ### 🐛 问题修复 - **渠道消息与主 Agent 模式（#144106）**：修复在 PTC、Creator 或自定义主 Agent 模式下，企业微信 / 微信远程控制或 MCP channel 推来的消息唤醒会话时，这一轮会以标准模式执行的问题（Creator 的追加指令和自定义预设正文丢失、PTC 下 REPL 工具说明被换成标准模式版本），现在这一轮与该会话的主 Agent 一致；修复每次渠道消息唤醒都会在共享的 agent 上多挂一个监听、且别的会话结束时会提前恢复本会话权限模式的问题，权限模式只在本会话这一轮结束（或超时）时恢复。 - **持久化定时任务沿用主 Agent（#144106）**：修复持久化定时任务到点执行时总是以标准模式运行的问题，现在任务执行时沿用当前会话正在使用的主 Agent 模式（PTC、Creator、自定义主 Agent 等），切换模式后下一次触发也跟着变。 - **连不上的会话 MCP 不再拖垮整轮对话（#146512）**：会话插件 `.mcp.json` 和子代理声明的 inline MCP 原先依次连接，每个都要等满 60 秒，也不看 server 配置里的 `timeout`，一个连不上就会让宿主等不到对话受理而报「网络请求超时」。现在改为并行连接，连接超时依次取该 server 的 `timeout`、环境变量 `MCP_TIMEOUT`、默认 30 秒；连不上的 server 只是缺少自己的工具，本轮对话照常进行。 - **终端粘贴内容不再丢失（#148803）**：修复在终端（TUI）里先粘贴大段文本或图片，再按 Home 回到行首输入 `/命令`，用补全菜单回车选中命令时，粘贴的内容只剩 `[Pasted text #N]` 占位符、不再作为命令参数发送的问题。 - **A2A 链路追踪**：修复 `A2AGetTask` 轮询和 `A2ACancelTask` 未透传 `traceparent`、`tracestate` 与 `baggage`，导致同一远端任务的查询和取消请求产生独立 Trace 的问题。 - **Code Mode 误直连调用工具**：模型在 Code Mode 里把文件读写、频道发言、成员消息等工具当作直接工具调用时，改为当轮返回「请在 REPL 中调用」的工具提示，同一轮里的其他调用照常执行；不再整轮失败后自动重试，对话里也不再出现一条额外的系统纠正消息。 - **Daemon 重启保持权限模式**：修复重启 daemon 后，分身（主会话）被重置为默认权限模式的问题，现在会保持之前设置的权限模式。 - **本地模型纯思考消息**：修复历史包含纯思考消息时，后续对话可能失败的问题，保留原有思考和工具调用行为。 - **启动日志范围**：正常启动时不再把自动发现的 Mod 加载明细输出到启动界面；显式通过 `--plugin-dir` 指定的 Mod 仍保留加载与失败报告。 - **插件缓存与安装并发**：修复启动时插件缓存清理与安装并发执行，导致暂存目录被删除、安装偶发失败的问题。 - **移除隐蔽任务提醒**：移除长任务运行中自动注入的任务列表提醒。此前在标准模式直连任务工具、或 PTC 模式在 REPL 沙箱内使用 `TaskCreate` / `TaskUpdate`（及旧版 `TodoWrite`）时，若一段时间未更新任务状态，会向模型追加一条隐藏提醒，该行为被反馈会带来副作用，现已整体撤除；不清理或过滤旧会话已保存的提醒内容，任务工具和任务列表在 TUI 的展示不受影响。 - **Server 文件系统适配**：修复 Server 文件系统适配接口对 bigint 文件标识的类型兼容，以及发布类型声明对私有核心包子路径的引用。 - **终端取消提问后 Web UI 同步停止**：修复在终端（TUI）发起的对话里 Agent 用 AskUserQuestion 提问、用户按 ESC 取消后，同时打开的内嵌 Web UI 会一直显示「思考中」、输入框一直提示消息会排队的问题，现在会收到「本轮已取消」并恢复空闲。 - **企微机器人连接锁**：修复新开一个 CBC 会自动连接同一企微机器人、把仍在运行的老进程踢下线的问题（企微同一机器人只允许一个长连接订阅者）。现在自动连接会先检查跨进程连接锁，若机器人正被另一个存活进程服务则礼让跳过，只有用户手动连接时才接管；持有者进程已退出（或来自其他主机）时锁视为陈旧，新进程可正常接管，不会因为残留锁文件而连不上。 - **图片位置**：用户消息中的图片现在统一排在用户查询文本之后，符合约定的内容顺序。 ## [2.166.0] - 2026-10-14 ### 🎉 新功能 - **ACP 后台任务管理（#144511）**：支持 ACP 客户端列出后台 Bash / PowerShell 任务、查询状态和最终结果，并按任务 ID 取消；任务按会话隔离，取消后保留结果记录，且不会额外触发模型调用。宿主可按会话和终端 ID 停止后台任务而不打断前台对话，后台任务的查询与取消也补齐了旧版宿主兼容入口。 - **Web UI 每轮文件变更**：对话中每轮结束后显示本轮编辑过的文件和增删行数，点击「查看」即可在右侧工作台打开 diff 并定位到改动行，最近一轮支持一键撤销；「设置 → 外观」新增「对话内显示文件变更」开关。变更视图跟随当前打开的智能体会话。 - **工作空间插件（#145418）**：Web UI 输入框「+」菜单与智能体右键菜单新增「工作空间插件」，在右侧面板按智能体工作目录启用、禁用或从市场添加插件，配置写入该工作空间的 `.codebuddy/settings.json`，可一键恢复继承用户级设置。 - **「我的分身」与头像升级（#147424）**：Web UI 智能体列表中的主智能体升级为「我的分身」，固定在列表最上方并配专属头像，默认可以加入房间和频道，频道里被同事 @ 时会转给你的主对话处理；头像库重新设计为更柔和呆萌的风格并新增多款款式；列表支持「按目录分组」（默认关闭）。 - **Web UI 输入框能力升级**：输入框加号菜单按上下文、工作方式和技能分组，支持搜索、键盘选择和移动端操作；可引用工作区文件或文件夹（目录引用不会改变工作目录或授予访问权限），运行中仍可补充附件，运行中有草稿时同时提供发送和停止按钮；中文输入法组词期间确认文字后再搜索。 - **Web UI 快捷键**：对话输入支持快捷停止、权限模式切换、模型选择、思考切换、复制最近回复、展开任务进度和搜索输入历史；快捷键使用独立配置，可改键、解绑和恢复，不覆盖终端快捷键。 - **Web UI 宠物**：新增西游记系列宠物（悟空、唐僧、八戒、沙僧、白龙马），默认显示在输入框右上方，随智能体状态切换动作；单击摸摸、双击打招呼、眼睛跟随鼠标；可用 `/pets` 显示、隐藏或切换宠物，偏好保存在当前浏览器。 - **更省积分的长效提示缓存**：使用内置模型时，请求自动启用 1 小时的提示缓存（此前为 5 分钟）。长会话、反复读取同一批上下文的场景中，重复内容更容易命中缓存而不按全量重新计费，可明显降低积分消耗；缓存档位在会话首次请求时确定并在该会话内保持不变。可把环境变量 `CODEBUDDY_DISABLE_PROMPT_CACHING_1H` 设为 `1` 退回 5 分钟缓存。 - **MCP 网络域名规则**：开启沙箱后，HTTP / SSE / 远程 MCP 的工具调用按安全中心的网络域名规则判定：允许的直接执行，需审批的弹出审批卡片，禁止的直接拒绝，并记录到安全审计日志。 - **stream-json 会话配置对齐本地 ACP（#145200）**：由环境变量 `CBC_SESSION_CONFIG_SYNC=1` 开启，未设置时协议与行为和此前完全一致。开启后 `set_config.contextWindow` 按当前模型档位校验，`result._meta` 新增本轮实际生效的上下文预算，新增会话级思考键 `thoughtLevel`，`set_model` 切模型后按 ACP 同一顺序修正思考与档位配置。 - **server 库形内置 REPL（#147078）**：经 `@tencent-ai/agent-cli/server` 接入时，内置工具清单加入 REPL（Code Mode）。默认不开启，设置 `CODEBUDDY_REPL_ENABLED=1` 后，会话中即可执行代码。 - **我的应用与模组中心**：Web UI 新增「我的应用」，支持用自然语言创建、修改、组合和修复应用，无需节点编辑器、Schema 表单或发布流程，安装常驻代码仍需正常授权。自定义扩展管理收拢为「模组中心」，功能模组与外观模组共用清单、搜索、类型过滤和 AI 创建入口；模组详情支持查看保存版本、恢复指定版本，以及直接导出标准安装包（固定版本依赖随包携带，不携带用户状态与授权）。 - **模组插槽与工作台（#147469）**：工作台新增生命周期管理的标签页与文件预览槽位；侧边栏开放顶部、动作、导航、底部和账户等插槽，面板可直接摆放到原生左侧智能体栏；模组还可为后台任务与子代理详情、智能体目录与工作台停靠区贡献原生插槽，并保留原生输出、取消、历史与权限归属。 - **Mods desktop 命名空间（#146490）**：Mods 浏览器扩展新增可选的 `desktop` 命名空间，在桌面壳中可打开链接与目录、复制、发送系统通知和在工作目录启动终端；普通 Web UI 下该服务不存在，模组可渐进增强并保留浏览器降级。 - **模组创作与分发**：新增 `plugin init/build/pack/import/export` 标准包创作与分享流程，以及 `cbc plugin --profile web add` 的 npm / Git / 本地目录来源安装入口（安装不执行任何 npm lifecycle 脚本）；AI 创建支持事务化增量草稿补丁、无源码回执、字段级校验和预览动作测试，浏览器源码诊断可定位到文件、行、列。 ### 🔧 功能改进 - **模型请求标识 X-Agent-Runtime**：模型请求新增 `X-Agent-Runtime` 请求头，标识对话运行形态：`local-agent`（本地对话）、`cloud-agent`（云端对话）、`agent-agent`（A2A），未指定或其他值为 `other`。可经 `_meta.baggage`、ACP `_meta` 或环境变量 `CODEBUDDY_AGENT_RUNTIME` 指定。 - **工具并发上限**：同一轮中可并发的工具调用（只读的 `Read`、`Grep`、`Agent` 等）最多同时执行 10 个，超出的按顺序排队，避免大量调用同时跑时占满资源；可用环境变量 `CODEBUDDY_MAX_TOOL_USE_CONCURRENCY` 调整。 - **会话历史清理改为显式开启（#145446）**：新增环境变量 `CODEBUDDY_SESSION_HISTORY_CLEANUP` 替代原来的 `CODEBUDDY_DISABLE_SESSION_HISTORY_CLEANUP`，仅设为 `1` / `true` 时执行 30 天会话 / 记忆 / Trace 清理。交互式启动（TUI、`--serve` Web UI、`codebuddy cleanup`）默认开启清理，`-p`、`--acp`、`--a2a`、SDK 以及 WorkBuddy、云端 Agent 等被程序拉起的 CLI 默认保留全部历史，不会因宿主漏配而误删。**不兼容变更**：CLI 不再读取旧变量，曾用它关闭清理的用户请改为 `CODEBUDDY_SESSION_HISTORY_CLEANUP=0`。 - **大目录启动不再卡顿**：在包含大量子目录的目录（如用户主目录）中启动时，后台仓库发现改为异步、有上限的扫描，并跳过隐藏目录与系统资料目录，启动期不再长时间阻塞，也不再产生大量诊断日志。 - **Bash 大输出预览（#143816）**：优化 Bash 大输出落盘后的预览内容，成功时优先展示实际输出开头，失败时保留退出码提示，便于快速判断命令结果。 - **自定义模型排查增强（#145984）**：自定义模型请求失败或重试时，日志附带上游返回的请求 ID、链路追踪和限流等响应头，便于与模型服务方核对问题；凭据和用户身份类信息不会被记录。未在 `models.json` 单独填写 API Key 时，恢复使用环境变量或全局配置中的凭据。 - **模型请求录制（#146229）**：模型请求录制（`OTEL_LOG_RAW_API_BODIES=file:<目录>`）的响应记录补充实际使用的模型、首个 token 时间、完成时间与被重试的失败尝试，便于分析每次调用的耗时与重试。 - **Web UI 分支与终端**：分支选择框使用中文等输入法时，回车先确认候选词上屏，不再直接创建或切换分支；分支列表改为两行展示分支名、领先 / 落后提交数与本地化相对时间，以及作者、提交号和提交信息；CodeBuddy Desktop 内置终端在本机未安装 codebuddy 时自动使用应用内置的 CLI。 - **Web UI 导航细节**：左侧导航底部新增「设置」入口，头像菜单改为从导航栏右侧弹出并优先显示账号真实头像；「源代码管理」图标的变更数角标改为贴在图标右下角并带底色描边，在自定义皮肤下也保持清晰可读。 - **回归保障（#89304）**：补充命令行、会话和终端关键流程的端到端回归，以及图片输入、异常恢复与历史会话的回归验证，提升版本发布的稳定性。 ### 🐛 问题修复 - **`--serve` 内部接口鉴权（#143153）**：修复 `codebuddy --serve` 暴露远程端口（如 `--host 0.0.0.0`）时内部接口可被未授权调用、进而以当前用户权限执行命令的安全问题。开启网关认证后，内部接口与公开 API 一样需要凭据；直接调用内部接口的外部脚本需补带 `Authorization: Bearer <网关密码>`，否则返回 401。 - **主 Agent 模式一致性**：修复在 PTC、Creator 或自定义主 Agent 模式下，定时任务（含 `/loop`）触发、后台会话收到后续消息、团队 lead 被成员消息唤醒的那一轮会以标准模式执行的问题（Creator 追加指令与自定义预设正文丢失、PTC 下 REPL 工具说明被替换）；现在这些轮次与用户自己发消息时使用同一个主 Agent。 - **Agent Teams 停止语义**：修复通过 Server 接入（如 Agent Harness）的 Team 会话在用户停止后，队员消息和框架通知又自动唤醒 lead 开始新一轮的问题；停止后队员也会被一并暂停，期间收到的队员消息会保留，等用户下一次发消息后再送达。 - **工具调用顺序与并发**：修复同一轮中排在需确认调用之后的调用不等审批就先执行的问题（现在按顺序执行，被拒绝时后续调用显示为 `Skipped (an earlier tool call was rejected)`）；修复写文件、编辑、执行命令等有副作用操作可能乱序并发执行的问题，只读调用仍可并发。 - **退出码显示**：Bash / PowerShell 命令以非 0 退出码结束时，交互界面会在结果首行显示退出码并以错误颜色标出，不再看起来像执行成功。 - **斜杠命令回显**：修复在 IDE / Web UI 中执行 `/init` 等内置提示词型命令后，用户气泡把展开后的整段系统提示词显示出来的问题；历史回放同样只显示命令本身（含参数），模型收到的提示词不变。 - **复制中文乱码（#145105）**：修复在 macOS 桌面版内置终端中运行 CLI 时，`/copy` 复制的中文内容粘贴后变成乱码的问题；内置终端缺少语言环境时也会默认使用 UTF-8。 - **MCP JSON 工具结果**：修复延迟加载的 MCP 连接器（如乐享、表格）返回 JSON 对象结果后，下一轮对话报 `Only text tool outputs are supported for chat completions`（错误码 10000）、会话此后无法继续的问题；已出现该报错的会话重新打开后可继续对话。 - **自动升级**：修复通过 npm 安装时，自动升级过程中网络中断可能导致旧版本被删除、退出后命令无法启动（`command not found`）的问题；现在升级会先完整下载新版本再替换，替换阶段若安装被破坏会自动重装修复。 - **server 库形接入（#147078）**：修复经 server 库接入时 ToolSearch 只要搜到工具就报 `Tool search failed: … is not a function`；一并修复会话首轮跳过 MCP 服务器连接等待、命令型 hook 输出提示信息时出错卡住的问题。 - **会话标题生成（#145164）**：修复部分模型生成会话标题时默认开启深度思考、导致标题迟迟不出现的问题；标题生成现在统一关闭思考。 - **后台任务输出与收尾**：修复后台命令退出时与文件输出读取并发，导致终端推送或任务结果遗漏最后一段输出的问题；修复后台任务完成后的自动处理进行中，用户新发送的消息要等这轮处理全部结束才开始响应的问题。 - **ACP 历史与位置信息（#144697）**：修复 Read 参数中的非法路径或行号导致 Server / Harness ACP 连接关闭或历史恢复失败的问题；实时消息和历史回放会安全省略无效位置或可选行号，保留原始工具参数及结果。 - **Hook 上下文**：修复 hook 的 `systemMessage` 用户提示意外进入模型上下文的问题，界面提示、纯文本 stdout 和显式 `additionalContext` 行为保持不变。 - **网络 dispatcher**：修复调用方传入自定义网络 dispatcher 时首次请求初始化失败的问题，普通直连和待机仍保持按需加载。 - **图片历史兼容**：修复图片历史在 CLI 版本回退后无法继续对话的问题（新保存的图片引用兼容旧版，读取同时支持新旧格式），并修复恢复会话后使用 `/btw` 等临时问答时图片无法正常读取。 - **提示缓存与模型调用（#142992）**：修复模型调用重构后，提示缓存处理可能导致请求发送前失败的问题；保持自有模型缓存策略不变，不向自定义模型注入内部缓存字段。 - **模型优化默认值**：统一 Desktop 设置页与 CLI 模型请求的默认值策略，修复国内版未配置「帮助优化模型」时错误发送隐私数据标记的问题，并正确处理海外版、专享版等账号的默认状态。 - **文件回滚**：修复超过备份大小阈值的文件被误标为可精确恢复的问题；跳过备份的记录不再作为恢复快照，没有可用版本时保留文件当前内容。 - **沙箱文件审批与授权（#143090、#142526）**：修复沙箱文件审批通过后重跑命令时，首轮已成功删除的文件被误报不存在的问题；修复 macOS 沙箱删除或重命名文件、目录后旧路径自动授权持续累积的问题，回收同一沙箱会话中已失效路径的 auto_grant 与 temp 规则。 - **独立运行沙箱与连接稳定性**：独立运行（非 WorkBuddy 托管）开启沙箱后，命令不再因安全中心未启动而全部被拒绝执行，后台会话共用同一个安全中心；修复 Windows 版 CodeBuddy Desktop 中智能体会话完成首轮回复后即退出、后续消息报 502 的问题；Web UI 恢复繁忙会话时，首次加载超时后的重试给予更充足的等待时间。 - **Web UI 连接回退**：修复经反向代理访问时实时通道已连通但收不到会话消息、对话不显示的问题，现在确认能收到当前会话的消息后才切换到实时通道，被拒绝或断开时自动回退到原有连接方式；修复重新登录后打开带会话链接的页面偶发加载超时报错（加载稍慢时自动重试一次）。 - **Web UI 模式与页面状态**：修复刷新后已选择的 PTC 等智能体模式被错误显示为标准模式的问题，恢复对话时保留该对话自己的模式；修复打开或执行 `/btw` 时因空记录导致 React 最大更新深度错误的问题，并让被旧 Service Worker 接管的页面在 Agent 空闲时自动无感刷新。 - **输入历史**：修复恢复会话后上键可能跳过最后一次重复输入，以及新输入被恢复的旧记录排到前面的问题；上下翻阅仍能恢复未发送草稿。 - **企微 / 微信机器人（IOA）**：`/remote-control` 中已连接的企微、微信机器人不再随 CBC 登录态变化被断开，重新登录后会自动恢复；连接过（未手动停止）的机器人跨进程重启后自动重连；remote-control hostId 落盘复用，重启后不再生成新 ID。 - **持久化定时任务**：修复持久化的周期定时任务在创建 3 天后执行一次即被自动删除的问题，现在会持续运行直到手动删除。 - **本地专家**：修复首次使用尚未安装的本地专家插件时首轮对话回落到默认人设的问题；现在会在远端市场下载前优先完成本地专家安装，并在首次模型请求前注入专家提示词。 - **语音转写积分（#137815）**：修复使用免费模型调用 AudioTranscribe 后，对话中未展示语音转写实际积分消耗的问题，并保留该消耗供历史回放。 - **插件缓存与市场**：修复已保留新版缓存时插件更新仍选旧版、市场离线或移除及无启用选择时无法卸载的问题；目录市场的插件摘要先验证完整缓存投影再读取元数据；插件市场下载改用进程已配置的 fetch，修复中断下载残留文件的问题。 - **模组运行时与契约**：修复插槽 contract 的 strict / legacy 字符串及历史 object / null 输出导致 Slots 和 Runtime 整表校验失败的问题；修复 Workbench Pet 示例与模板的 styles 绑定；浏览器包与运行时元数据读取串行化，避免读到部分发布的代次。 - **Web UI 权限与附件细节**：修复新建智能体交替使用权限下拉和规划入口后，退出规划模式可能恢复过期权限的问题；附件读取完成后才允许发送，避免提前发送遗漏材料。 ## [2.165.0] - 2026-10-11 ### 🎉 新功能 - **Web UI 浏览器通知**：完成后通知新增浏览器通知渠道，由 Service Worker 投递，绑定站点 origin 授权，页面切后台 / PWA 窗口失焦 / 标签关闭后仍可靠，云端 / 无桌面环境同样可用。设置 → 通知改为「关闭 / 系统通知 / 浏览器通知」，用户自选；系统通知（本机 CodeBuddy 直接发，免站点授权、不受端口变化影响）保持为既有能力，浏览器通知不再自动降级，避免"选了一条却走了另一条"。点击通知统一把窗口拉回前台并导航到对应会话（主对话带 `sessionId`，同事 / job 带 `job` + `sessionId`）。子路径（base-path）模式下 Service Worker 被禁用，浏览器通知不可用，设置页就地提示并保留系统通知选项。另修复 Safari 中首次授权后设置页仍显示「被拦截」、需刷新页面才恢复的问题。 - **Mods API 对齐 Claude Code**：Mods 现在看到与 Claude Code 2.1.293 相同的 API：`codebuddy-code`（别名 `claude-code`）类型即 Claude Code 自身声明，且其中列出的事件全部生效——`prompt.autocomplete` 向补全列表添加行、`prompt.compose` 塑造系统提示词、`prompt.mention` 控制 `@file` 附加内容、`session.append` / `session.send` 观察对话与消息、`telemetry.log` / `telemetry.mark` 观察遥测、`session.compact` 覆盖 `/compact` 与自动压缩、`session.end` 在退出与 `/clear` 时触发、`ui.fault` 上报加载或渲染失败的 Client。新增 `$.process.spawn`、`$.mcp.connect`、`$.session.version`、`$.ui.copy`、`$.ui.selection` 五个调用；`turn.step` hook 支持流式，可单次请求切换模型或强度、或不调用模型直接作答；`agent.spawn` hook 可改写子代理提示词 / 模型 / 类型；`config.set` hook 可改写写入值；`command.describe` hook 可隐藏命令或改写补全条目；`$.session.messages`、`$.model.complete`、`$.model.fork`、`$.mcp.call` 等调用在终端中也可用。mod 注册的工具命名为 `mcp____` 并以 MCP 文本块返回结果，针对 MCP 工具的 `permissions.deny` 规则同样拦截；CLI Web UI 向 mod 报告自身为 `desktop` 表面。 - **运行社区 mod Flightdeck**：支持用 `--plugin-dir` 不加改动地运行社区 mod Flightdeck（实时 Agent 仪表盘）：mod 可保持响应式状态、跟随每个模型请求、观察子代理启动、读取权限决策、每轮后接收度量、在终端绘制动画 `Client` 区域并设置状态行。CLI Web UI 中 mod 面板停靠在对话旁的侧栏。另修复 CLI Web UI 在子代理工具卡片首次出现时崩溃的问题。 ### 🔧 功能改进 - **CLI 更新状态与自动重启（#144749）**：后台服务上报 CLI 更新状态并支持立即检查，可设置更新后空闲时自动重启；Web UI 跟进队列移到输入框上方，采用紧凑摘要并提供清晰的操作反馈。 - **Server 宿主注入 HTTP 代理策略**：Server 支持宿主注入动态 HTTP 代理策略，修复 Harness 写入代理配置后模型请求仍直连的问题；未注入时保持原有 CLI 与 Server 代理行为。代理策略回调同时接收 Agent 的有效环境，兼容嵌入式运行时的环境隔离与 settings.env 代理配置。 - **MCP OAuth 登录自动续期（#128551）**：授权时向服务端申请续期能力，服务端支持时 MCP 服务登录过期后自动续期，无需再手动授权；已登录的服务在下一次授权后生效。 ### 🐛 问题修复 - **ACP 错误码投影（#143142）**：修复 Server/Harness ACP 错误投影丢失上游业务码的问题，保留终态通知及已有持久化错误回放中的排队业务码；旧 CLI 错误格式与现有错误分类保持不变。 - **ACP SDK 1.7.0 与工具输入校验**：升级共享 ACP TypeScript SDK 至 1.7.0，CommonJS 消费方改用原生动态 import 加载其 ESM 入口并使用稳定的 elicitation API；工具输入按其声明的 JSON Schema dialect 校验（含 MCP SDK 2.x 的 draft 2020-12），保留既有 draft-07 与延迟工具强制转换行为；Server 的 ACP v2 输出中，提交的 `/compact` 命令以原始消息 ID 报告，内部压缩指令保持隐藏，默认 messages 与 ACP v1 输出行为不变。 - **MCP 授权错误信息丢失**：修复远程 MCP 服务在登录凭据过期或授权服务返回错误时，连接失败只提示 `Invalid OAuth error response ... [object Response]`、真实原因丢失的问题；现在能正确识别授权错误并按凭据失效流程重新授权，错误信息带上真实原因与状态码。 - **回退 `/clear` 后的安全审查继承**：该继承在会话清理后沿用上一会话待生效的审查策略，带来性能问题；改回让新会话从默认全关起步，等 Host 重新下发安全审查配置后再生效。会话模型、思考配置、上下文档位等其余配置的继承保持不变。 - **独立二进制下 daemon 服务空转**：修复独立二进制安装方式下，`daemon install` 注册的 Linux 后台服务把安装路径当提问反复发送给模型、持续消耗额度的问题。升级后重新执行一次 `codebuddy daemon install` 即可自动修复已注册的旧服务；后台服务异常时也会在几分钟内自动停止重试。另修复独立二进制安装方式下自动模式规则评审附带多余输入、tmux 模式下无法启动团队成员的问题。 - **Web UI 新建会话消息残留**：修复 Web UI 后台智能体内点击「新建会话」后，上一条会话的首句用户消息被重复补种进新会话的问题（首句归属改为锚定该智能体最初的会话，会话切换后不再生效）；同时修复智能体内换会话后左侧列表小字摘要停在旧内容、不再随新回合刷新的问题。 - **Electron 内嵌运行子命令参数移位**：修复 CLI 在 Electron 应用内运行（`ELECTRON_RUN_AS_NODE`，如 CodeBuddy Desktop 内置 CLI）时子命令参数被移位的问题：`codebuddy install ` 现在会安装指定版本，不再失败。 - **`find -delete` 执行前审批（#119395）**：修复声明 `CODEBUDDY_CLI_CAPABILITIES=file.safety` 的 IDE、Harness 等宿主未触发 `find -delete` 执行前审批的问题；复用现有 FileSafety 能力判断及审批流程，保留 WorkBuddy Desktop 默认行为和未声明能力的普通 CLI 行为。 - **后台任务收尾期间图片丢失**：后台任务完成后的自动处理进行中，用户发送的带图片消息不再丢失图片，会连同图片一起加入正在进行的处理，与纯文字消息行为一致。 - **含后台历史的会话无法 fork（#131672）**：保留历史工具结果，仅复制已完成的普通子任务历史，不接管源会话的运行任务。 - **ACP 小编辑文件 diff**：支持最大 2 MiB 文本文件（4 MiB 合并输入预算）的小编辑保留 ACP 文件 diff；行数预算避免对大量短行的文件做高成本分词。补丁大小与协作计算预算保持不变；产出的补丁仍保留在持久化的工具结果与回放中。 - **代理请求稳定性**：修复宿主修改 JavaScript 堆栈跟踪设置后 HTTP/HTTPS 代理请求失效的问题，同样修复模型请求与遥测；本地请求协议不匹配改报连接错误（而非 HTTP 400），且不再通过其他地址或代理路径重试。 - **PTC 安全审批交互**：PTC / Code Mode 沙箱中需要安全审批的工具调用（高危命令、敏感文件访问）不再直接失败：交互式会话（TUI / Web UI / ACP）显示嵌套审批提示，用户可批准或拒绝；非交互式会话保持阻止，并说明放行方式（`permissions.allow` 规则或完全访问模式）。另修复批准后复用 REPL worker 时，后续工具被已完成的 hook 上下文阻塞的问题。 - **sandbox-center 退出等待**：修复同步结束后预算定时器未释放，导致进程关闭后仍需等待最多 3 秒才能退出的问题；同步超时及降级策略保持不变。 - **Server 延迟工具短描述（#142379）**：修复 Server functional hooks 路径丢失延迟工具短描述、导致工具目录过长的问题；保留完整工具说明与现有白名单、审批规则。 - **Server `steer()` 撤回输入**：`steer()` 在其请求被取消时会撤回缓冲输入，且不打断查询或其他提交；队列回执暴露消费结果，宿主可区分已确认撤回与输入已交给运行中的 Agent。 - **ToolSearch 隐藏被禁工具（#126987）**：修复整工具级权限 deny 未从 ToolSearch 描述、搜索及精确查找中隐藏工具的问题；目录按所属会话过滤，权限更新后刷新描述；带参数的 deny 继续只限制具体调用，不隐藏整个工具。 ## [2.164.0] - 2026-10-09 ### 🎉 新功能 - **CLI Web UI 统一使用 AI 同事通讯录**：不再提供单干 / 组队模式切换；Agent 自主创建同事、使用频道和唤醒成员改为设置页中的独立开关。TUI、WorkBuddy、IDE 与无人值守入口的能力边界保持不变。同一个会话在终端与内嵌 Web UI 之间来回切换时，Agent 自主组队的工具只在 Web UI 发出的轮次里出现：回到终端继续聊不再继承这些工具，关掉浏览器后也一样。 - **Web UI 支持 Function Hooks mod 的 `Svg` 与 `Client` 元素**：`Svg` 以隔离图片显示（交互模式用无脚本沙箱框）；`Client` 的 surface module 在沙箱中运行，支持本地状态、帧时钟、指针与按键输入，`surface.post` 送达插件的 `ui.message` hook，hook 回的 `{ props }` 直接回到实例。 - **Function Hooks `ui.resolve` hook 生效**：插件可在加载时为其他插件改写或去掉元素；`$.ui.resolve(e)` 同步返回当前面的元素表，原有 `await $.ui.resolve(e)` 写法继续可用。 - **运行 Claude Code 示例 mod**：支持用 `--plugin-dir` 不加改动地运行 Claude Code 的示例 mod（Blast Radius、Replay Theater、Token Weather）；mod 可在提示词上方绘制条带（`AbovePrompt`），并在终端与 CLI Web UI 中用按钮打开面板（`$.ui.open`），通过 `$.session.usage()` 读取真实上下文用量，以及用 `tool.call` 暂扣高危 shell 命令。 - **Web UI 界面与对话字号档位**：设置页「外观」新增界面字号与对话字号档位（小 / 标准 / 大 / 特大）：界面字号调整整体文字大小，对话字号在其基础上单独调整对话流，设置会被记住并同步到其他已打开的页面。 ### 🔧 功能改进 - **stream-json 历史回放限长（#89304）**：支持仅在 stream-json 历史回放时限制工具调用参数、工具结果和推理文本的长度，减少云端会话恢复的 stdout 传输量，同时保持实时输出和模型上下文完整。 - **Agent SDK 跨语言端到端回归（#89304）**：为 Agent SDK 新增 JavaScript 与 Python 的端到端回归覆盖，涵盖认证、取消、会话生命周期与持久化、查询消息、工具钩子与权限、MCP 集成、子代理与长任务工具，提升发布信心，不改变运行时行为。 - **Function Hooks `classic.*` 钩子结果生效**：对齐 Claude Code，`classic.PreToolUse` 返回的 `updatedInput` 会在执行前改写工具参数，`next(e')` 改写同样生效，`deny` / `ask` 会拒绝或要求确认；`classic.PostToolUse` 等事件的 `additionalContext`、`updatedToolOutput`、`block` 等字段也会传回宿主。mod 仍不能放行宿主已拒绝的调用，也不能用 `allow` 跳过权限确认；`classic.PreToolUse` 收到的事件改为类型声明中的 `{ tool, tool_use_id, ...参数 }`，其余 `classic.*` 事件不再带出宿主内部的 session 对象。 ### 🐛 问题修复 - **插件 UserPromptSubmit hook 首轮不执行**：修复插件中配置的 UserPromptSubmit hook 在部分场景下不执行的问题：当插件已安装时，首轮对话不再因插件状态尚未就绪而跳过该 hook；当插件在本次进程内安装完成后，后续轮次也能正常触发。 - **ESC 取消后会话状态卡死**：修复交互式 TUI 中按 ESC 取消当前运行时，偶发无法彻底中止、会话状态卡死（spinner 持续转动、输入框不可用、后续 ESC 失效）的问题；取消后运行资源与会话状态正确收敛，不影响后续会话。 - **子代理丢失任务内容（400）**：修复 Web 界面、IDE 接入和 `-p` 非交互模式下，默认类型子代理丢失任务内容、请求被拒绝（400）的问题；子代理现在能正常收到并执行派发的任务。 - **【PTC】子代理读到用不了的工具说明（#142296）**：Code Mode 下 REPL 工具说明对所有身份是同一份文本，子代理（如只读的 Explore）会读到 Agent、TaskOutput 的用法，但它们的工具目录里并没有这些工具，容易反复检索却找不到。现在这部分用法按各身份实际拥有的工具生成，主代理保持完整说明。 - **【PTC】截断结果可完整取回（#142772）**：Code Mode 下 REPL 脚本返回的内容超过上限时，超出部分原先直接丢弃，模型只能重新执行整段逻辑。现在完整返回值会保留在沙箱的 `REPL.lastTruncated` 中，截断提示会告诉模型在下一次调用里对它筛选、汇总后只返回结论。 - **【PTC】子代理返回类型提示修正**：PTC / Code Mode 下，子代理 `Agent()` 的返回类型提示不再把“返回任务句柄”误写成只有显式后台调用才会发生。命名 Agent、团队成员会话以及定义级后台的 Agent 同样会异步返回任务句柄，模型据此先判断返回值类型再读取任务标识，避免把句柄当字符串用而丢失任务标识、重复派发子代理。 - **Web UI 历史回放被截断**：修复长会话打开、刷新或切换后，Web UI 用最新一页历史覆盖完整回放、导致起始用户提问消失的问题；现在会保留更早的历史，仅更新重叠的最新尾部。 - **Web UI 子代理历史恢复**：修复刷新或重新打开会话后，Agent 父卡未恢复子代理元数据、导致子代理详情无法识别和展开的问题。 - **Web UI 智能体配置隔离**：修复新建智能体的配置隔离：新建页里选择的权限模式、模型与引擎不再回写宿主用户默认，只有显式选择才写入该智能体档案，继承默认时保持跟随全局。同时修复新建智能体后首条用户消息不回显的问题，并把「完全访问」收紧为本机 Web UI 专属：远程、Tunnel、局域网或经代理转发的调用，无论直接传入该权限模式、还是先改写用户级默认权限再以缺省权限派发，都会被拒绝。 - **Web UI 新建智能体未继承默认权限**：修复新建智能体没有继承用户级默认权限模式的问题：新建时优先使用目标工作区解析出的有效默认值，仅在不存在显式默认时回退 last-used，并避免把继承到的默认值物化为智能体固定配置。 - **Web UI 图片预览无关闭入口**：修复对话流中图片放大预览没有关闭按钮的问题：右上角新增关闭按钮，所有图片预览均支持 Esc 键与点击遮罩关闭，关闭后焦点回到原位置。 - **CNB 子路径下品牌图片加载失败**：修复 Web UI 通过 CNB 实例子路径访问时，欢迎页与登录页品牌图片因未携带路径前缀而加载失败的问题。 - **会话文件检查点重复记录**：会话记录不再重复保存相同的文件检查点：写入新文件时只记一次，改写已跟踪文件不再追加重复记录。批量写文件的会话，检查点数据约减少一半（新建 300 个文件的会话从约 7.3MB 降到约 3.6MB）。记录格式不变，撤回、文件变更展示以及旧版本打开会话都不受影响。 - **工具内容注入防护下读取图片报错（#142310）**：开启「工具内容注入防护」后，读取图片（含 MCP 截图、自定义模型传图）的下一轮请求不再报「服务出现未知错误 | 10000」；图片结果仍按不可信内容包裹后发送给模型。 - **文档与 Excel 子代理保存未备份（#133876）**：文档脚本编辑与 Excel 子代理自动保存接入 Agent 会话文件备份，避免保存时遗漏回退所需的原文件内容。 - **微信远程控制重连残留轮询**：电脑休眠唤醒或网络恢复触发重连后，不再残留多条并发的消息轮询，避免断网时错误日志成倍刷屏、重连后重复拉取消息。 - **Windows 终端拼音候选框位置错误**：Windows VSCode 终端下停在输入位置时显示终端自身光标（不再画反色块），系统 ConPTY 才会同步光标位置，候选框不再钉在左下角。 ## [2.163.0] - 2026-10-09 ### 🎉 新功能 - **iOA 本地资源与产物上报（#128820）**：新增 iOA 场景下的本地资源与产物上报能力，采集受开关保护、上传有并发与超时上限。需要员工交互式登录，身份或特性变化时自动取消，文件不安全或超出预算时直接丢弃而不阻塞 CLI 使用。上传使用校验后的私有快照，粘贴的图片在界面清理临时文件前先保留私有副本。仅含附件的提交现在也会走完整的输入钩子链路。 - **自定义模型支持 OpenAI Responses API**：`models.json` 中的模型可设置 `"api": "openai-responses"`，请求改发 `{url}/responses`，多轮对话原样回放加密推理内容，会话记录同时保留上游 `model` / `region` / `accountId`。模型 apiKey 支持运行时占位符 `${CODEBUDDY_SESSION_ID}`，便于上游把同一任务的请求固定在同一账号。新增产品特性 `ResponsesStore`，开启后请求携带 `store: true`，否则显式发送 `store: false`；限流 429 退避重试，额度耗尽不重试并交给备用模型。另新增 `OTEL_LOG_RAW_API_BODIES` 用于落盘完整请求与响应体。 - **微信 / 企微聊天记录隐私标记持续生效**：聊天记录分享标记命中后，当前会话及其派生 Agent 的后续模型请求持续标记为隐私数据，独立会话恢复后仍保持该状态。标记仅覆盖走平台网关的模型请求，自定义模型与显式设置 `CODEBUDDY_SKIP_INTERNAL_HEADERS` 时不下发。 - **Mods（函数钩子）默认开启**：`--plugin-dir` 指定的 mod 与已装插件中的 mod 无需再设置环境变量即可加载；如需关闭，设置 `CBC_ENABLE_FUNCTION_HOOKS=0`。 - **Mods 新增网络请求与进程执行能力**：mod 现在可以通过宿主发起 http/https 请求（支持 `socketPath`）和按 argv 运行本地命令（不经 shell，默认 30 秒超时、最长 10 分钟，git 自动关闭仓库钩子）。命令无法启动、超时或请求失败时调用会 reject；管理员可通过环境变量关闭这两个能力。 - **关闭敏感数据防护的环境变量**：新增 `CODEBUDDY_DISABLE_SENSITIVE_PROTECTION=1`，关闭本进程的敏感数据防护，效果与设置文件中的 `sensitiveProtection.enabled: false` 一致，但不修改共享的设置文件；企业托管策略下发的值仍然优先。 - **Web UI 智能体自动命名**：新建智能体若未改名，先显示「新智能体」占位；第一段对话生成标题后自动改用该标题作为名字，且只改这一次。新建页、侧栏或顶栏手动起过的名字不会被覆盖，标题生成时页面是否打开都不影响。 - **Web UI Mods 生成式 UI**：助手消息支持由 mod 接管渲染，mod 可向模型注入自定义输出规则，再把回复里的标签画成卡片、按钮、提示条等可交互组件；按钮点击回到 mod 执行，重画时已显示的卡片按最新状态刷新。Mod 渲染树新增布局（方向、间距、内边距、边框卡片）与文本样式能力。同步新增「点餐 → 下单 → 退单」示例 mod。 - **通用生成式 UI 示例 mod**：新增不绑定业务的生成式 UI 示例，模型在回复里输出 genui JSON 代码块，Web UI 把它画成卡片、表格、进度、表单和按钮；点击按钮会把对应内容作为下一条消息发出，每张卡片只能回答一次，刷新页面后仍显示已选结果。mod 画出的输入框与下拉框现在可以直接填写和选择。 - **Web UI 管理类页面焕新**：任务、插件、远程控制、设置、快捷键、文档、进程、统计、追踪、日志页面统一了页头、卡片、按钮、标签切换和开关样式，加载时显示骨架屏，空数据和出错时给出下一步操作，并加入适度的入场与反馈动效（系统开启「减少动态效果」时自动关闭）。快捷键页按分组展示、组合键逐键显示为键帽，录制时实时回显并提示冲突；微信、企业微信的绑定二维码改为本地生成，失败时提供重试和手动填写入口；对话中的正文、标题、代码、表格、工具名与过程信息统一为 13px。 ### 🔧 功能改进 - **Bash / PowerShell 工具描述精简（#132427）**：两份工具说明去掉重复内容和低频细节，每轮常驻上下文分别减少约 51% / 33%（Bash 约 1500→730 token，PowerShell 约 1160→780 token）。同时明确：命令被用户、权限规则或安全策略拒绝后，不再换命令、换工具或换 shell 重试，而是如实说明。 - **PowerShell 语法提示按实际版本给出**：Windows 上会识别当前是 Windows PowerShell 5.1 还是 PowerShell 7+，只提示对应版本可用的链式运算符和默认编码，不再让 PowerShell 7 用户也被告知不能用 `&&`。 - **MCP 工具目录预取**：在首次提示词执行前异步准备 MCP 工具目录和会话专属工具描述，任务调度仅等待工具描述，实际使用 MCP 时复用目录预取的 singleflight，避免无关慢服务阻塞请求；MCP 权限过滤仍按请求生效，工具目录变化或连接替换时缓存自动失效。 - **内容搜索正则兜底重试**：正则中出现 `foo(`、`struct X {` 等不平衡字面括号时不再直接失败，而是把括号当作字面文本重试一次，并告知模型实际使用的模式，省去一次额外往返。 - **本地命令也先过敏感输入审批**：`/skills`、`/doctor`、`/cost` 等本地命令现在会先经过敏感输入审批，被拒时不再执行（有意收紧，fail-closed）。 - **跳过内部请求头时不再发送 User-Agent**：设置 `CODEBUDDY_SKIP_INTERNAL_HEADERS` 时出站请求不再发送 `User-Agent`（此前会由 axios 补回 `axios/`）。依赖该 UA 做兼容或统计的第三方网关部署方需注意。 - **历史图片校验结果复用**：图片预处理对完全相同的输入复用校验结果，历史图片不再每次请求重新扫描（3 MB PNG 约 32ms → 3ms），对话与 Responses 两条链路均受益。 - **自动化回归测试跨平台增强（#89304）**：扩充打印、服务、网关与交互界面等入口模式的端到端覆盖，涵盖流式恢复、MCP OAuth 生命周期、安全中心命令规则与终端启动诊断；回归用例默认不再依赖公网内置市场，并修复 Windows 平台用例收尾时的无效等待；支持对已知缺陷做告警级标注，缺陷触发时相关用例降级为告警而不中断整体回归，缺陷修复后自动恢复强校验。 ### 🐛 问题修复 - **AI 代码入库率（SaaS 企业账号）**：修复已开通入库率统计的 SaaS 企业账号下，CLI 写入的代码不计入入库率的问题；现在 CLI 会按企业的入库率开关正常上报 AI 改动，与 IDE 行为一致。 - **AgentLens 调用链丢失 span**：修复自建 OTLP 上报下遥测在对话进行中被重新初始化，导致 Agent 与工具调用 span 被整类丢弃、平台只显示模型调用 span 的问题；对话进行中不再中途重建上报通道。 - **检查点回退一致性**：修复首轮回退预览定位失败、可用替代版本未被实际恢复，以及文件恢复失败后仍截断会话的问题；分批恢复失败时补偿所有已执行批次。 - **`/clear` 保留会话设置**：保留模型选择、思考与上下文窗口覆盖、主 Agent 模式、工作区与工具配置以及安全审查设置，仅以全新的对话与执行状态开始；未设置模型覆盖的会话仍会采用最新默认值。 - **代码模式子代理派发**：子代理按自身预设的角色与任务边界执行，不再以主会话身份启动、偏离任务导致超时；同步派发的子代理返回结果可直接作为数据解析，误用后台任务查询时给出明确的修正提示。 - **重试耗尽后的提示文案**：响应超时且自动重试已耗尽时不再显示「正在自动重试」，改为提示检查网络、重试或切换模型；空响应改为明确的「模型未返回有效响应」提示，并给出重试、切换模型或反馈的建议。 - **会话回退目标选择**：修复异步更新后回退定位到第一个提示词的问题，只把用户提示词作为回退目标，重载或发送编辑后的提示词后保持所选状态，包括回退到开头的情况。 - **任务执行中插入消息的图片**：执行过程中插入的消息（立即发送）现在会保留附带的图片，模型可以直接看到图片内容；只发图片的插入消息也能送达当前这一轮。 - **图片与视频产物备份**：开启文件备份时，图片和视频生成工具在覆盖已有产物前备份原文件，并为新建产物登记回滚记录；修复云端图片和视频服务缺少文件写入依赖导致的产物保存失败。 - **沙箱追踪生命周期**：开启沙箱追踪的会话会在每轮开始时同步采集开关及保存目录，并在轮次结束、备份处理完成后刷新追踪记录；采集失败不影响对话和文件备份。 - **恢复会话后历史图片不显示**：修复恢复会话后历史消息中的图片无法显示的问题，保留原图和文件名；图片文件不可用时显示文字提示。 - **移动端资源管理器自动加载**：修复手机端进入资源管理器后文件树不自动加载、必须手动点击「打开目录」才显示的问题。 - **Web UI 页面细节**：修复日志页每行被拆成多列、文字挤成多行的问题，查看历史日志时不再被自动拉回底部；修复追踪时间线在窗口宽度变化时标签与条形错位、文字被拉伸的问题；修复插件市场选中单个市场时「重试」无效的问题；修复暗色主题下部分按钮出现多余灰色边框的问题。 ## [2.162.0] - 2026-10-07 ### 🎉 新功能 - **Web UI 会话导出（#140508 #140553）**：Web UI 输入 `/export` 可下载当前会话的对话记录与可用调试日志 ZIP；文件名包含完整会话 ID、时间和随机标识，便于区分多次导出。共享工作区日志仅保留提及该会话的行，归档附带敏感信息提示。 ### 🔧 功能改进 - **长任务任务列表提醒（#140589）**：长任务中会适时提醒模型检查当前任务列表，减少因进度信息过时而遗漏后续工作；提醒不作为用户消息展示，也不会强制改变任务顺序。支持通过环境变量临时关闭，便于灰度回滚和效果对照。 - **zsh 未匹配通配符透传（#140480）**：默认 shell 为 zsh 时，命令中未匹配到文件的通配符（如 `grep --include=*.ts`）不再导致整条命令报 "no matches found" 失败，而是与 bash 一致原样传给命令执行，减少无效的重试轮次。 ### 🐛 问题修复 - **Web UI 斜杠命令列表恢复完整（#140508 #140553）**：修复总线权威模式下命令目录更新被丢弃的问题，`/` 菜单不再只显示少量内置命令，后端下发的命令与技能会正常出现。 - **`/clear` 与 Web UI 会话切换即时生效（#140508 #140553）**：修复会话重置通知使用了新会话标识、导致前端把它当成其他会话事件而忽略的问题；`/clear`、`/resume`、`/fork` 现在会立即切换并刷新界面。 - **Web UI 新版本不再要求手动刷新（#140508 #140553）**：入口页改为网络优先，避免旧 Service Worker 一直返回上一版页面，新构建的菜单与交互刷新后即可生效。 - **新建智能体沿用用户默认配置（#140508 #140553）**：新建智能体优先使用用户显式设置的默认主智能体与默认授权模式，不再被上次临时选择覆盖。 - **Web UI 会话重置全端同步（#140508 #140553）**：修复会话重置后其他打开页面不跟随 `/clear`、收不到后续实时回复、已完成轮次无法按空闲态重载的问题；重置通知不再进入可回放历史。 - **Web UI 实时过程顺序与回放一致（#140640）**：修复 Web UI 多次工具调用时流式正文反复重取快照、阶段说明累加的问题；实时过程按思考、完整阶段正文、工具和结果的原始顺序展示，主对话过程默认展开、工具详情保持收起，最终答复完整可见。 - **ACP 连接释放后的资源占用（#140478）**：Web 界面或桌面端连接断开后，后台服务会及时停止向该连接推送对话与团队成员进度，长时间运行的服务不再因残留连接持续占用内存和 CPU，日志也不再被大量重复告警刷屏。 - **`/fork` 与 `/branch` 保留会话配置（#140439）**：分支现在会携带源会话的主 Agent（PTC 会话不再静默回落到 cli）、所选模型、输出风格与额外目录，不再复用源会话的运行状态和远程会话 ID；携带子代理历史的分支会明确提示不支持，不再生成引用损坏的子会话。 - **交互面板控制字符覆盖（#139725）**：修复模型输出中夹带回车等控制字符时，提问卡片和工具授权确认框内容被覆盖、显示不全的问题。 ## [2.161.4] - 2026-10-06 ### 🎉 新功能 - **Web 新建智能体身份卡**：Web 界面新建智能体时默认分配头像和名字，开口前可点头像从头像库换脸、点名字改称呼；对话开始后点顶栏头像和名字同样可以修改，所选头像随第一句话一起保存，主对话 CodeBuddy 的头像和名字不受影响。关联 #137919。 ### 🔧 功能改进 - **自动化回归测试跨平台增强（#89304）**：加强 CLI 核心链路的自动化回归覆盖，包括会话恢复、权限续聊、内存压缩、插件钩子与 Windows 平台交互场景，提升版本稳定性。 ### 🐛 问题修复 - **队友并发启动端口冲突**：修复队友（brokered job）并发启动时共享同一端口池导致的端口竞争问题，不再因 `listen EADDRINUSE` 停在「活着但不建会话」的僵尸态；稳定端口池现在只服务真正需要固定 origin 的交互实例，显式 `--port` 与父进程传入端口的优先级不变。 - **队友重启因会话未落盘而假死**：修复队友重启时目标会话从未成功创建导致直接报错退出的问题，现在会回退为新建空会话并进入可投递状态；用户显式 `--resume` 一个不存在的会话时仍按原语义报错。 - **`/compact` 在含图片对话中失败**：修复 `/compact` 在包含图片的对话中无法执行的问题，并在压缩失败时显示警告；折叠的终端对话中不再出现内部压缩摘要和过程消息。 - **Web UI 新建智能体状态异常**：修复 Web UI 新建智能体后主 Agent 模式胶囊消失、流式正文反复折叠，以及侧栏运行态和摘要更新不及时的问题。 ## [2.161.3] - 2026-10-05 ### 🎉 新功能 - **嵌入式宿主函数钩子**：嵌入式宿主可以通过函数钩子扩展输入、上下文和工具行为，扩展状态按执行作用域隔离。 - **工具按轮次延迟发现**：支持将内置工具、宿主工具和 MCP 工具按轮次设为延迟发现，同时保留工具权限、参数校验和审批检查。 - **Server 装载插件函数钩子**：Server 可从会话 dataFs 装载已启用插件的 functional hooks，与宿主 hooks 复用 Mods 引擎；模块状态、文件访问与清理归属各自会话。Headless UI 展示为无操作，提问仍等待宿主回调，工具授权沿用原有检查。 ### 🐛 问题修复 - **未启用 mods 时启动失败**：修复未启用 mods 时 headless 和 JS SDK 因缺少 esbuild 而启动失败的问题；TypeScript/TSX mods 无需额外安装编译器即可加载，保留隔离执行和缓存；CLI 与 Agent Harness 的独立可执行文件不再内嵌 esbuild。 - **缺失的项目设置文件被反复打开**：缺失的工作区 `.codebuddy/settings.json` / `settings.local.json` 读取结果现在与其他读取结果一样被缓存，同一文件的并发首次读取共享一次磁盘读取，消除会话启动或预热进程激活后每个文件上千次的失败打开。 - **后创建的项目设置未及时生效**：创建（或删除后重建）工作区 `.codebuddy` 目录时会重新绑定监听并刷新设置；监听建立前已缓存的设置会在监听就绪后刷新一次。 - **Auto Memory 提取权限隔离**：任务完成后执行记忆提取时不再修改当前会话的权限模式，避免界面和后续任务异常继承 bypass。 - **Remote Control 权限归属**：复用交互会话时保持用户当前选择的权限模式，只有独立远程会话继续使用无人值守权限。 - **输入钩子等待期间取消无法结束请求**：修复输入钩子等待期间取消或拒绝后，请求无法结束的问题。 - **函数钩子重复执行与上下文串用**：修正函数钩子的事件校验、异步注册、重试和执行预算，避免重复执行或跨会话共享上下文。 - **钩子改写参数的安全校验**：工具及审批改写的参数继续经过原有校验和安全检查；取消审批不会执行工具，延迟工具也保留高积分强制审批。 - **工具参数与钩子事件字段重名丢失**：修复宿主或 MCP 工具的参数与钩子事件字段重名时丢失参数的问题，重试时同样保留原值。 - **Server 延迟工具审批与 Plan 拒绝反馈**：修复 Server 启用 functional hooks 后，延迟工具缺少「本会话允许」选项，以及拒绝 Plan 时丢失继续规划反馈、提前续跑模型的问题（包括延迟代理自身审批被拒绝的情况）；显式审批规则与高风险工具的逐次确认保持不变。 - **工具结果被误判为轮次终止信号**：普通及延迟工具均保留结果的原生结构，避免将普通 JSON 文本误识别为轮次终止信号；附加的私有上下文仅供模型使用。 - **WorkBuddy 内置插件市场更新期间安装失败（#134482）**：修复 WorkBuddy 内置插件市场更新期间来源与内容不一致导致的插件安装失败，保留自动更新能力，更新失败时继续使用已安装版本。 ## [2.161.2] - 2026-10-04 ### 🔧 功能改进 - **Agent View 列表与侧栏加载提速**：收集 Agent View 列表时不再为每一行打开不存在的 broker 与 display 边车文件（正常作业读取仍会检查当前端点，目录枚举失败时保留原有读取行为）；侧栏不再重复执行首次 Agent Home 加载与紧随其后的冗余兜底轮询，并跳过无关列表渲染与已折叠的隐藏行，页面可见时首次目录加载失败仍按退避重试。 - **`/btw` 侧问与子 Agent 交互增强**：`/btw` 改为独立侧问面板，仅按 `f` 才把选中的问题升级为带工具的主树 Agent 并向主对话汇报结果；选中的子 Agent 现在可以接收后续文本、排队消息与图片，已完成、失败、停止的 Agent 在选中期间保持可见，离开时保留 30 秒宽限期并支持显式清除。 - **自动化回归测试跨平台增强（#89304）**：E2E 用例跨平台化并消除外网拓扑依赖，提升 Windows 与类 Unix 系统下的一致性与稳定性。 ### 🐛 问题修复 - **Agent View 工作区恢复与重绑**：仅在记录的目录或 Git worktree 能安全还原时恢复缺失的 Agent View 工作区，否则在启动时给出可操作的错误；已退出的 Agent 从侧栏进入时会被显式唤醒，深链与历史会话选择保持只读、不再重载会话文档；停止并重启后，所有已打开的 Agent 页面（含实时事件流）重新绑定到新的 Worker，会话身份保持不变。 - **Agent View 状态被过期活动覆盖**：逐轮串行化作业与进程注册表的状态更新，避免已完成、失败或手动停止的 Agent 被过期活动覆盖；空闲与回复摘要保持同步，不再闪现中间阶段或重载会话。 - **后台 Worker 回收**：浏览器保持被动 ACP 或 Jobs SSE 订阅时，已完成与空闲的后台 Worker 也能被回收，同时保留对进行中提问及其他请求的保护；由 Worker 自己用实时会话与任务核对过期活动作业，再重新开始空闲宽限期，而不是依据进程注册表推断空闲。 - **每轮跟进结果未同步到侧栏**：修复每轮完成的跟进结果未发布到所有打开的侧栏（与上一轮相同的回答被跳过）的问题；只读实时跟随者在会话流重连后可以补齐历史。 - **通用子 Agent 输入丢失**：修复在父 Agent 模式下运行通用子 Agent 时输入被丢弃、模型收到空消息的问题。 - **并行子 Agent 工具流归属错误**：修复并行子 Agent 的工具调用内容混入主对话流，以及网页内容分析偶发收到空输入的问题。 - **工具参数校验提示缺少类型**：延迟工具参数校验失败时展示实际类型和期望类型，同时不回显参数原值。 - **自定义模型配置提示无法直达**：修复自定义模型缺少接口地址或 API Key 时，客户端重启后错误提示里的「前往配置」无法直达该模型配置页的问题。 - **工具轮次追踪上下文丢失**：修复工具执行切换追踪上下文时丢失本轮 W3C baggage，导致子 Agent 请求场景回落为默认值的问题。 - **长会话恢复后任务标题被覆盖**：修复长会话恢复后已命名（含手动重命名）的任务标题被当成未命名会话、用最近一条消息重新生成并覆盖的问题；从会话中途分叉出的新会话仍会生成自己的标题。 - **运行环境重启后残留失效问题卡片**：stream-json 会话在运行环境重启后回放历史时，已中断的 `AskUserQuestion` 会被标记为已取消，不再留下可操作的失效卡片。 - **长工具执行后的 Trace 断链**：修复 stream-json 长工具执行期间 drainWait 请求覆盖会话追踪头、导致工具之后的模型请求与响应流脱离当前 Trace 的问题。 ## [2.161.1] - 2026-10-02 ### 🔧 功能改进 - **历史回放保留 Read 图片引用**：支持在历史回放中保留 Read 工具的图片引用，避免向 CloudAgent 重复传输 base64 图片数据。 ### 🐛 问题修复 - **取消对话后续提问上下文丢失**：修复取消对话后继续提问时，上一轮问题和已执行的工具记录未完整进入后续对话的问题；现在会保留这些上下文，并明确告知助手前一轮已中断，避免误将其当作待继续执行的请求。 - **Server 库 Skill 混入内置命令**：修复 Server 库运行时 Skill 工具混入并尝试执行 CLI 内置控制命令的问题；保留真正的技能，并让提示词命令调用使用当前会话的命令目录。 - **带尾随数据的图片被判无法处理**：修复部分 PNG / APNG 动图和手机拍摄的 JPEG 在文件末尾带有额外数据时被整张判为无法处理、会话历史里只剩「图片无法处理」且模型收不到图片的问题；这类图片现在会按原样保留在历史中并正常发送给模型。 - **Server 拒绝执行计划后未结束提问**：Server 在拒绝执行计划后正确结束当前提问，保持 Plan 模式并等待用户继续输入；工具审批等待、自动重试与取消行为保持不变。 - **Server query 场景元数据未生效**：修复 Server query 的场景元数据未用于模型请求和遥测的问题；复用 W3C baggage，按请求隔离并由子任务继承，保留 CLI 原有的场景默认行为。 - **Server ACP 历史回放丢失 traceId**：Server 的 ACP 历史回放现在保留原请求的 traceId，恢复会话后仍可复制请求 ID；继续移除历史追踪的传播上下文，不改变实时请求的追踪。 - **专家团同时汇报导致重复总结**：修复多名成员几乎同时汇报时负责人只看到其中一条就给出最终总结、随后又被其余汇报逐条触发并重复输出的问题；同时到达的汇报现在会一起交给负责人当前这一轮处理。 - **专家团成员唤醒后消息无人处理**：修复成员被唤醒继续工作后运行期间又收到其他成员消息时，这些消息无人处理、成员一直停在「运行中」导致整个专家团任务无法结束的问题；现在这类消息会在成员当前一轮结束后继续处理。 - **可信文件操作审批标题显示为通用项**：修复同一文件的推定读取记录干扰可信删除或写入操作、导致沙箱审批标题显示为通用「访问文件」的问题；同路径可信操作覆盖推定读取时恢复「本次会话内允许此目录」选项，真实混合操作仍不提供目录授权。 - **Web UI 子代理状态误拨主对话**：修复 Web UI 子代理后台输出误入主对话、反复将主智能体状态从空闲拨回运行中导致闪屏的问题。 - **Windows `/copy` 中文乱码**：修复 Windows 下使用 `/copy` 复制中文等 Unicode 文本乱码的问题，并保留原始换行符。 - **WSL 粘贴 Windows 剪贴板文本**：修复在 WSL 中通过 Ctrl+V 或 Alt+V 粘贴 Windows 剪贴板文本的问题。 ## [2.161.0] - 2026-10-01 ### 🎉 新功能 - **新增错误码 4100**：本地自定义模型缺少接口地址或 API Key 时，请求不再发往供应商端点，直接返回 4100 与「前往配置」指引。此前缺少 API Key 会带着账号凭据发出请求，并被误报为「密钥无效」，把配置问题误导成鉴权问题。4100 及其之后统一作为 Agent CLI 错误码区间维护。指向本机回环地址的模型（如 Ollama 本地）本就不需要 API Key，保持原行为不受影响。 - **上下文监控**：新增常驻上下文占用率显示配置，并支持通过 `CODEBUDDY_SHOW_CONTEXT_USAGE` 环境变量开启。 - **`/btw` 侧问**：侧问与主会话隔离并保留最近历史，TUI 与 WebUI 支持历史浏览、快捷切换、复制、清空，以及升级为带工具的后台任务。 - **`/web` 命令**：在默认浏览器中打开当前会话的 Web UI。没有 Web UI 地址的宿主（无 loopback / 远端会话）只提示不可用，不会打开浏览器。 - **Web UI 每轮积分用量**：每轮对话结束后于回复底部显示本轮共消耗的积分（含子代理与图片、视频生成），刷新页面或打开历史会话后仍可查看。 ### 🔧 功能改进 - **长历史会话恢复自适应限流**：会话恢复时按输出积压量自适应限流，避免图片与大附件回放导致进程内存溢出，同时保持正常消费场景的批量输出性能。 - **Server 生成层装配检查（#135550）**：补齐 Server 生成层中的 MCP 工具策略、模型重试与遥测依赖，保持 Shell 可选注入语义；编译和打包时检查源组件与生成层的依赖声明，保留 Effect 服务图类型，防止组件重构后遗漏接线。 ### 🐛 问题修复 - **模型中断后误判空流**：修复模型已输出部分内容、紧接着上游报错时，若两段数据恰好一起到达，已输出内容会被整段丢弃、按「没有任何输出」反复重试并最终提示「上游返回空流」的问题；现在会保留已输出内容并从中断处继续。 - **`/rewind` 回退工作区外文件失败**：修复会话中写过工作区外文件（如临时目录下的草稿）后，`/rewind` 回退代码直接失败并报 「Checkpoint file destination is outside the workspace」的问题；工作区外的文件现在会被跳过，不再阻塞工作区内文件的回退，回退失败时 rewind 面板会显示原因，不再丢失输入框内容。 - **后台服务文件变更资源泄漏**：修复后台服务在工作区一次性写入大量文件（如切出新的工作副本、安装依赖）时内存暴涨、失去响应甚至需要重启的问题；同时修复 Web UI 关闭页面或断开连接后，文件监听、进程输出订阅等后台资源不会释放、越积越多的问题。文件树在变更过多时会自动整体刷新。FileChanged 钩子改为按批次依次执行：短时间内同一文件的多次变化会合并为一次触发；一次性变化的文件过多（超过 1000 个）时，这一波变化不再逐个触发钩子，改为记录一条告警。 - **Server 文件与网络规则审批（#136552）**：Server 文件与网络规则的 ask 审批通过会话 canUseTool 回调交给宿主，修复 Harness 中 Read、Write、Edit 一直等待且不展示审批的问题。取消只清理所属请求，迟到的授权不会带入下一轮；未绑定宿主的 CLI 保留原审批通道。 - **Server 沙箱备份通道遗漏（#135550）**：修复 Server 原生依赖装配遗漏沙箱备份通道，导致开启文件安全后 Write/Edit 覆盖失败或新建文件未登记备份的问题。同步工具权限、循环调用保护和手动压缩入口的依赖，并增加装配漂移与真实沙箱备份回归。 - **Server Plan 模式权限（#136158）**：Server 进入 Plan 时保留会话原权限，退出时沿用 ExitPlanMode 恢复；支持宿主在首次挂载前通过 `permissionModeBeforePlan` 传入原模式。普通工具审批将可复用的会话规则传给 canUseTool，Defer 审批展示实际目标工具，授权规则只覆盖该目标。强制审批与高风险命令不提供此会话授权建议。 - **会话级 MCP 工具描述（#136531）**：会话级 MCP 的 ToolSearch 目录复用 `_meta.shortDescription`，与全局 MCP 目录保持一致；完整描述仍用于工具搜索和调用定义。 - **skill 名称开头普通文本误触发**：修复在会话中输入以某个已安装 skill 名称开头的普通文本（不带斜杠）时，消息被误判为 skill 命令的问题：此前模型会收到 skill 全文而非用户原话，且下一轮后历史中的用户原始消息也被覆盖。现在只有显式输入 `/skill-name` 才会触发 skill 展开。 - **TUI 顶部 Web UI 链接**：修复 TUI 顶部栏展示的 Web UI 链接会额外拼接当前会话 id（`?sessionId=...`）的问题，现在直接展示配置的 Web UI 地址。 - **Web UI 智能体选择串改**：修复 Web UI 中在多个智能体之间切换时，权限模式和模型选择互相串改、切回后又跳成别的值的问题；现在每个智能体各自保留自己的选择，子智能体里的选择也不会再改写全局默认权限。 - **Web UI 源代码管理刷新（#136936）**：Web UI 源代码管理面板改为变化即推送：文件改动、提交、切换分支后约 0.4 秒内刷新，仓库无变化时不再反复扫描，大仓库下单个文件变化的刷新从约 1.8 秒降到几十毫秒；页面隐藏时暂停、回到页面立即刷新，旧版本服务端自动回退到定时刷新。同时修复含空格或非 ASCII 字符的文件路径、已暂存重命名文件显示异常的问题。 - **Windows 自动升级卡死**：修复 Windows 上开着 CodeBuddy Code 时自动升级经常失败、并可能让安装残缺的问题：之后执行命令会卡死，只能重启。现在开着窗口也能正常自动升级；万一安装仍然残缺，命令会立即报错并改用普通方式执行，不会再卡死。 ## [2.160.0] - 2026-09-29 ### 🎉 新功能 - **Web UI 原生智能体视图 v2**：Web UI 改为单条总线（`/api/v1/bus`）复用多路数据流，`journal` 以 `seq/epoch/volatile` 定序，订阅带游标续传、`ack` 即重放结束；游标不可续回时返回 `resync_required`，客户端重取快照后按 `asOfSeq` 重订阅。新增会话快照接口，一次返回消息分页、`inFlightTurn` 与待审批 / 待回答，客户端「先快照后订阅」，运行态只来自快照与 `turn` 事件。目录流改走总线（展示字段投影 diff + 同 tick 合并帧 + 15s volatile keepalive），总线就绪时停用旧 SSE、掉线自动回退；多个 Web UI 页面之间视为对等写者，同一会话可在多个页面同时打开并发送，写入由服务端 run queue 串行，TUI / `--acp` 等非 Web UI 客户端维持原有防双写者语义。行状态设 2.5s 最短停留（需要输入立即切换），默认 Agent 行的忙闲收窄到「本页连接承载主会话」；worker 在 `RUN_FAILED` 回到 idle 但进程仍存活时，job 行落成 `failed` 并冻结终结时间。 - **Web UI 动态工作流可视化**：启动工作流（如 `/deep-research`）后，对话中出现实时更新的工作流卡片，展示状态、当前阶段、分段进度、agent 完成数与 token 用量；输入框上方在运行期间显示等待状态，结束后自动消失。点击卡片或输入 `/workflows` 可在右侧侧边栏按阶段查看每个 agent 的指令、最近活动与结果，并支持暂停、继续、停止整个工作流或跳过单个 agent。同时修复工作流子任务的中间过程被平铺到主对话中的问题，并补齐工作流相关界面与审批卡片的中英文文案。 - **沙箱审批规则来源与目录授权**：沙箱审批现在提供实际命中的规则来源，支持客户端查看对应规则或保护机制；支持 macOS 非白名单目录直接删除的允许、询问、禁止设置（默认询问）；文件审批支持当前目录及子目录的会话授权，读、写、删除分别生效。 - **资料库上传（`LibraryUpload`）**：新增工具，把本机单个文件上传为资料库节点，支持工作区外的文件（附件常在 Documents / 桌面）；打开前解析软链并与 `fstat` 比对防替换，敏感路径由会话权限规则把关（工作区内静默、其余需授权）；上传后节点保持私有，不生成公开分享链接；大文件按流式上传，不整体读入内存。新增 `ProductFeature.LibraryUpload` 灰度开关（默认关闭），同时校验 endpoint 与登录态，关闭时工具不注册。 - **Server subscribe 支持多种输出格式**：`subscribe` 支持 `openai`、`messages`、`acp-v1` 与 `acp-v2` 四种输出格式。默认保持原有 `messages` 输出；完整 SDK 原始事件通过 `format: 'openai'` 显式选择，现有消费者无需修改；Harness 使用 `acp-v2` 直接投影原生事件，复用历史消息编码，移除 stream-json 中转。旧 CLI 入口保持原有行为。 - **`$.ui.log` 进入 chat view**：mod-plugin（function hooks）里的 `$.ui.log(text)` 现在会作为一条 assistant-role 消息进入 TUI / Web UI 的会话历史，与用户 / 助手消息同区渲染，语义对齐 function hooks 协议的 transcript 行为。此前 `[mod] ` 只写 stderr、TUI 里几乎不可见，现在改为 `: ` 出现在会话历史里（headless / 无 chat view 的场景仍走 stderr 兜底，可追溯性等价）；`to === 'debug'` 通道保持只走 logger，不进 chat，避免污染 `--print` 的 stdout 契约。 - **后台工作流报告写回对话**：`/deep-research` 等命令启动的后台工作流完成后，会把最终报告写回对话，并像其他后台任务一样通知主 Agent，可随时按任务编号查看完整结果。 ### 🔧 功能改进 - **后台任务完成通知更克制**：调整后台任务完成通知的提示措辞，任务跑完后不再要求助手回头翻查历史消息、自行推断「还有哪些后续步骤要做」，减少任务结束后的无谓额外动作；同时明确这类通知属于系统事件而非用户发言，避免助手把它当成用户的确认或同意后继续执行。取输出的指引保持不变。 - **`/btw` 与切换小上下文窗口时先压缩**：`/btw` 超过模型上下文上限时会先执行标准 `/compact`，再基于压缩后的上下文回答；TUI `/model` 在切换到较小上下文窗口前复用同一压缩流程；运行中的会话或压缩后仍无法适配目标窗口时会保留当前模型并提示重试。 - **错误上报带上实际域名（#132873）**：请求失败时，错误明细会带上这次请求实际打到的域名，方便按域名查看错误。 - **模型输入内存保护可配置（#135093）**：支持通过 `CODEBUDDY_DISABLE_MODEL_INPUT_MEMORY_GUARD=1` 关闭保护，并允许 `/compact` 在内存压力下完成上下文压缩。 - **后台 Shell 任务的 TaskOutput 默认增量返回**：TaskOutput 默认只返回上次读取后的新增 stdout / stderr，避免轮询时重复消耗上下文；可通过 `full: true` 获取当前累计输出快照。 - **会话恢复读取更快（#135192）**：使用有界异步分块读取会话尾部，减少逐行回调与插件、MCP 初始化争用事件循环造成的等待，同时避免为中大型会话加载完整文件；会话列表读取增加并发限制，并减少工具描述缓存命中的重复调试日志，降低启动阶段的资源争用和聚合内存峰值。 ### 🐛 问题修复 - **内置插件市场不再每次启动重新下载**：安装后会正确记录版本，之后只在市场确实发布了新版本时才重新下载，启动更快、流量更省；同时会自动清理此前因进程中断残留在系统临时目录中的下载文件。 - **子 Agent 跟随主会话上下文窗口档位（#133811）**：修复 subagent（含 Agent Team 成员）不跟随主 Agent 上下文窗口档位选择的问题：主 Agent 切换到 1M 等档位后，新建或唤醒的 subagent 会自动同步该显式选择；主会话没有显式选择时 subagent 回落到自身模型的默认档，不会误继承主会话按其模型算出的有效预算。 - **Web UI 会话同步（#133784）**：新建会话、切换会话、链接直开恢复会话时立即显示历史，并实时收到其他端（含命令行）发到该会话的消息；同一会话可在多个网页同时打开并发送，不再提示「此会话正在其他窗口或设备使用中」；修复回合结束后会话偶发一直显示运行中、输入框卡在排队状态；回退对话后刷新页面，已回退的回复不再重新出现。 - **空流重试等待用量时断连（#124399）**：空流重试等待用量时如果连接断开，这一轮仍会自动重试，不会被当成一条没有正文的正常完成。 - **工具管控入口下线期间禁用设置不再生效**：智能体工具管控入口下线期间，已保存的工具与 MCP 禁用设置不再生效，避免工具被禁用后无法通过界面恢复。 - **Agent frontmatter 数字名称兼容（#101095）**：兼容 Agent frontmatter 中未加引号的有限数字名称和描述，避免文件存在但管理目录遗漏。 - **预热进程激活后读取实时环境**：修复预热进程激活后仍使用待命阶段环境变量和启动参数快照的问题，确保首轮工具描述及运行时配置使用当前会话值。 - **Product 工具描述模板名被直接发给模型**：修复 `/server` 使用逐轮 Product 时，工具描述模板名被直接发送给模型的问题；模板读取与工具描述缓存遵守执行配置边界，避免并发会话串用同名描述。 - **沙箱批量删除权限串用（多会话切换）**：默认权限会话不再借用其他会话的 fullAccess 跳过确认，完全访问会话也不会受其他默认权限会话影响而额外请求审批；批量删除审批、保护记录与审计始终归属命令执行的会话，需要确认时会等待用户允许后再重跑，拒绝后保持拦截。 - **PowerShell / Grep / Monitor 沙箱执行的会话归属**：确保删除保护、审批和后台任务属于实际执行会话；PowerShell 的 Server 沙箱审批复用 canUseTool 回调；取消后不再接受迟到的审批或发起新的 Shell 执行及本机重跑。 - **上下文压缩摘要污染用户消息身份（#72511）**：修复上下文压缩摘要污染真实用户消息身份，以及内部恢复续跑误触发 Sandbox 初始化和规则同步的问题。 - **sandbox-cli 输出与退出事件丢失**：修复 sandbox-cli 快速执行时输出和退出事件可能丢失、工具持续等待的问题；管道和 PTY 执行在响应到达时同步注册进程句柄，保留连续到达的输出与退出状态。 - **Sandbox Shell 懒加载遗漏事件**：Sandbox Shell 在组件初始化时注册反向监听，避免等待会话就绪期间遗漏事件；重启继续复用原监听。 - **Monitor 与 Bash 一致遵循 `usePty`**：Monitor 与 Bash 一致遵循宿主的 `query.options.usePty` 选择；未指定时保留 CLI 原有行为。 - **Server 无 prompt 的 compact 请求身份**：修复 Server 无 prompt 的 compact 操作未登记请求身份、导致压缩历史条目的 conversationRequestId 被上一轮覆盖的问题；维护操作复用内核的请求登记机制，与当前 runId 保持一致。 - **Server ACP 事件状态与关闭清理**：修复 Server ACP 工具参数增量、权限模式变更与重订阅事件状态；恢复读取会话时的 Agent 身份，减少无订阅者时的事件处理，并在关闭时取消 shell 快照进程。 - **Server 把普通文本中的客户端引用误显示为文件**：实时回显和历史回放保留文本内容，显式资源引用、图片和附件继续还原；旧 CLI 的默认引用解析行为不变。 - **Server 插件 Agent 组合**：Server 会话复用 CLI 插件 Agent 组合逻辑，正确展开 welcome-mode 与 interaction-mode 的模板，并应用工具声明（包括显式空列表）；插件模板读取遵守会话挂载的 dataFs，多会话模式选择互不影响，普通 CLI 的插件优先级保持不变。 - **Server 完整 stop 后支持同进程再次 start**：每次构建独立容器与 Effect 服务实例，恢复启动时覆盖的环境配置，并等待旧执行任务结束；关闭失败时拒绝重建。Server 文件锁仅在持锁期间注册退出清理，最后一个锁释放后注销自身监听器，避免 Harness 关闭后在宿主进程留下信号监听。 - **Server 沙箱「本次会话内允许」串会话（#134978 #134979）**：修复 Server 沙箱「本次会话内允许」未复用或误写到其他会话的问题；审批读写绑定到执行所属 Session，保留命令与工作目录的授权边界；Server 的 canUseTool 传递与 CLI 相同的沙箱展示信息，并复用原有目录授权校验。 - **Server 关闭崩溃**：等待 shell snapshot 预热回调完成后再释放内嵌 Server 运行时，避免关闭时崩溃。 - **会话级 MCP 工具未出现在 ToolSearch 清单（#134992）**：修复 `/server` 通过 `query({ mcpServers })` 注入的会话级 MCP 工具默认延迟加载后未出现在 ToolSearch 清单的问题；清单随工具变更、配置替换和移除刷新，并保持会话隔离。 - **Web UI 工作目录未同步**：修复 Web UI 从 CLI 启动进入后工作目录未同步的问题：默认 Agent（主对话）的家目录跟随当前 CLI 启动目录，不再停留在历史目录；侧栏该行的时间改为显示主会话最近一次用户发言的时间，不再回落成创建日期。 - **工作流与多任务派生 Agent 未完整继承主会话模式**：修复工作流和多任务派生的 agent 未完整继承主会话模式的问题，并将工作流进度留在工作流视图中；同时恢复主界面通过方向键选中、回车进入普通 Agent 的操作。 - **大型仓库创建工作树超时残留**：修复在大型仓库中创建工作树耗时过长被中止后，残留的半成品目录与分支导致后续无法正常重新创建的问题；创建工作树的等待时间也相应放宽。 ## [2.159.0] - 2026-09-28 ### 🎉 新功能 - **技能清单按目录分组展示**：Skill 工具的 `` 现按技能所在目录分组（每个目录一行 `skills under folder`），条目精简为「名称: 描述」，不再暴露技能文件路径；单条描述默认字符上限由 150 提升至 200；总预算不足时优先压缩描述，必要时从末尾省略条目并在末尾提示 `Omitted skills: N.`。 ### 🔧 功能改进 - **ACP 自动重试与 meta 提示**：ACP 网络自动重试时在 `agentPhase` 上带 `retry.reason=network`，接入方可直接识别重试原因；`session/prompt` 支持 `isMeta`，模型可见但不作为用户消息展示、广播或回放。 - **智能体头像更灵动且状态更清晰**：所有头像保持原本鲜明配色；闲置状态以舒缓动作呈现，活动中与等待关注状态通过更快的动作节奏和既有绿色/黄色状态点区分，不添加外圈光晕，也不降低透明度或饱和度，同时继续尊重系统的「减少动态效果」设置。 - **新建与组队头像更易区分**：普通头像扩展到 15 款；新建智能体优先选择当前使用较少的款式并持久化，房间和频道内再对冲突头像做稳定错位分配。 - **关联模型路由完善**：完善 GPT、Gemini 的 `lite` / `reasoning` 映射，并在提供新一代轻量模型的产品配置中优化 DeepSeek V4 系列路由；为缺少映射的 Hy4 IOA 与默认模型补充安全兜底，同时保持其他国产模型现有路由不变。 - **Skill 工具描述预算固定为 8000**：`` 列表整体（目录分组行 + 条目 + 省略行）的字符预算固定为 8000，不再读取 `CODEBUDDY_SKILL_TOOL_CHAR_BUDGET` / `SLASH_COMMAND_TOOL_CHAR_BUDGET` 环境变量覆盖，保证任何宿主环境下列表体上限一致、超出即按 per-entry cap → 均分 → names-only → 尾部省略逐级收敛。 ### 🐛 问题修复 - **Web UI 智能体配置切换不持久**：修复 Web UI 智能体模型与权限模式切换不持久的问题：配置按智能体写入状态存储并经 ACP 应用，打开模型下拉和刷新页面不再回退用户默认；权限模式直接更新 live Session 并保留覆盖值；新建智能体继承当前用户/工作区有效配置，旧智能体从主 Run 的持久启动参数自动补齐配置；嵌入智能体的目录 chip 显示真实固定 cwd。 - **并发编辑同一文件时会话卡死**：修复同一轮对话中并发编辑同一个文件时，会话可能长时间停在「修改中」、CPU 占满单核且无法停止的问题。文件快照备份不再与并发写入相互干扰；备份期间文件被外部改动时会记录告警，便于排查回退内容异常。 - **文件回退可能拿不到修改前内容**：此前快照备份写入失败会被忽略、修改照常进行，回退只能得到修改后的版本。现在备份建不出来会直接拦下本次修改并给出明确原因，文件保持原样。路径指向目录或特殊文件时会直接给出准确的路径错误，不再误报成备份故障；目录和特殊文件也不会在备份目录留下空文件。 - **PTC / Code Mode 下 `/rewind` 无法回滚文件**：这些模式下的文件编辑现在会正确创建历史快照，`/rewind` 面板不再对有实际改动的检查点误报「No code changes」，会列出改动文件并显示准确的 +N/-M 行数变更，且能通过「Restore code」把文件还原到编辑前的状态。常规模式行为不变。 - **Auto mode 权限判定**：修复强制推理模型在 Auto mode 下无法完成权限判定的问题，以及非交互 Auto mode 下安全操作被错误拒绝的问题。 - **Web UI 流式渲染闪动与跳动**：修复工具执行结束时结果区瞬间消失导致消息流上跳、思考过程完成时丢失用户已展开的阅读状态、含数学公式的正文被误判成表格而拆断等问题；长回答改为按已完成段落增量渲染，正文以稳定速率匀速流出并在末尾显示光标，不再成段跳出。 - **ESC 取消需要按两次**：修复 Web UI 中按 ESC 取消当前轮次需要按两次才停止的问题。 - **从非命令行入口注册系统服务**：修复从非命令行入口注册系统服务会写入无法启动的配置，以及把测试运行器等无效入口写入系统服务后反复启动失败的问题。 - **Web UI 右侧面板与本机文件链接**：修复切回智能体对话时可能同时出现两个右侧面板、在内嵌对话点击本机文件链接导致黑屏的问题；`file://` Markdown 链接统一在父页面右侧工作台打开，SVG 默认使用与图片一致的预览模式。 - **进程内 Agent Harness 使用 sandbox-cli**：修复 broker 因读取不到 CLI 的进程级当前会话而拒绝 Bash 文件访问的问题。broker 现在按实际执行中的 shell 调用校验会话与工具调用，并恢复该轮的异步上下文；shell snapshot 的进程退出清理也不再访问已释放的 Agent 运行时。 - **未显式选择模型时可能自动跑在预览模型上**：此前该场景按智能体声明列表的顺序取首个可用模型，而声明列表头部是模型选择器用的档位占位（默认位/快速/均衡/极致），当前环境没有对应模型时会被逐个跳过，于是自动落到列表里第一个真实模型。现在改为优先使用产品标记的默认位，没有则按当前环境下发的模型列表顺序取首个可用；智能体自身声明了具体模型时行为不变。 - **启动后首次拉取远端配置被拒**：修复首次拉取远端配置时 User-Agent 缺少产品品牌名、被服务端校验拒绝返回 400 的问题。此前产品配置尚未就绪时客户端标识会回退成安装包名，导致首屏那次配置请求失败；磁盘缓存未命中时会直接得到空配置，可用模型列表随之退化。现在首次请求与后续请求的 User-Agent 保持一致。 - **多截图对话提交立即失败（#132615）**：修复带多张截图（约 10 MB 以上）的对话提交后立即失败、报 `Request body larger than maxBodyLength limit` 的问题：此前 CLI 本地这一跳会在 10 MiB 就自行拒收，与其自身 100 MB 的接收上限不一致，重试也必然复现。内容体积确实超出服务端上限时，现在会自动移除过大的图片或截断较早的对话后继续作答，并由 AI 说明被省略了什么；无法自动恢复时才提示实际体积和处理建议，不再抛出内部传输错误信息。 - **长会话追踪数据内存占用**：限制长时间会话的追踪数据内存占用，降低服务进程因追踪数据持续增长而异常退出的风险。 - **macOS 后台服务启动失败重试频率**：限制 macOS 后台服务启动失败时的重试频率，避免失效的 CLI 路径持续拉起进程并快速写满错误日志。 ## [2.158.0] - 2026-09-24 ### 🎉 新功能 - **内置模型目录更新**：更新内置模型目录、可用范围、上下文能力与计费信息，并同步图像和视频生成模型配置。 - **Web UI 用户设置与工作空间设置**：用户设置与 CBC 配置模型保持一致并支持搜索；智能体右键菜单新增工作空间设置，可在右侧工作台按智能体工作目录编辑，相同工作目录复用同一配置，并可恢复为继承用户设置；智能体侧栏只保留全局导航头像，工作空间设置与对话导出统一收口到智能体右键菜单，后台和已完成智能体可直接导出对应转录；修复右键菜单二级分组在鼠标离开后不关闭的问题。 - **WebUI 编辑器视频预览**：打开 MP4、WebM、OGV、MOV、M4V、AVI 和 MKV 视频文件时，使用浏览器原生播放器直接预览，并提供播放、进度、音量和全屏控制。 ### 🔧 功能改进 - **同步子 Agent 支持可选墙钟超时（#129530）**：用 `CODEBUDDY_SUBAGENT_TIMEOUT_MS`（正整数毫秒，上限 `2147483647`）启用后，同步前台子 Agent 超过该预算仍未完成时会被终止，并把超时结果交回主 Agent 继续处理，主 Agent 不再无限等待。**不设、留空、非法值或超过上限均不启用**（保持原有无限等待行为）；后台、detached 和 Team member 不受此超时约束。 - **macOS 沙箱压缩包创建回退**：通过 zip、rar、7z/7zz/7za 创建或更新单个普通压缩包，以及通过 tar 创建压缩包时，接入文件备份与回退登记；分卷、删除源文件、解包等未覆盖模式保留原命令行为并提示回退限制。zip 空字符串目标保留原命令行为，并明确提示未接入回退；修复 zip 多字符选项被误判为短选项组合的问题；使用日志参数时明确提示未跟踪回退，避免将日志路径误登记为压缩包；对包含 lf 的 zip 选项串增加保守保护，统一提示未跟踪回退，合法的 ll 与 f 组合可拆为独立参数保留回退跟踪。 ### 🐛 问题修复 - **A2A 任务被调用方取消后，stream-json 终态被报成执行出错**：此前取消借用 `error_during_execution` 终态，并附带 `errors: ["Turn cancelled"]`。下游 sandbox-proxy 会把 `errors` 当作回复正文转给端侧，用户看到一行 `Turn cancelled`，结束原因还被映射成"拒绝继续"。现在取消不再算错误，对齐同类 Agent CLI 的约定：终态为 `subtype: "success"`、`is_error: false`、`result` 为空，并通过新增的 `terminal_reason` 字段说明中止发生在哪个阶段：`aborted_streaming` 表示停在模型输出上，`aborted_tools` 表示停在工具执行上。取消终态同样不会带上上一轮的答复或会话上残留的结构化输出。 - **A2A 取消时如果恰好有工具在等审批，终态被报成权限被拒**：这种情况下终态此前是 `Permission denied for tool(s): unknown`，把取消说成了权限被拒。现在同样输出取消终态，`terminal_reason` 为 `aborted_tools`。真正的"拒绝权限并中断"仍然按原样报权限被拒。 - **端侧点停止（控制请求 `interrupt`）的终态现在也带 `terminal_reason`**：其余字段不变，消费方不需要再猜这一轮是不是被中断的。 - **#127888 stream-json contextWindow 入口放开**：`set_config.contextWindow` 只校验为正整数，不再按 CLI 本地模型目录校验档位（本地目录缺失/滞后时会误拒上游合法档位）；`session_id` 指定哪个会话就写哪个会话。档位是否生效仍由消费端按当前模型档位判定。 - **企业模型列表 404**：endpoint 带 path 前缀（如沙箱 `http://auth.proxy/codebuddy`）时，`/console/enterprises/{id}/config/models` 请求丢掉前缀导致 404。改为交给 baseURL 拼接，保留前缀。 - **Agent Home 消息投递**：目标会话忙碌或尚未恢复完成时，收件箱会记录明确的等待阶段与原因；进入空闲后立即触发消费，投递或确认失败时保留消息继续重试。频道轮转和成员显式点名不再跳过被空闲回收的成员，后续接棒人会通过 SSE 持续展示"正在处理"。Job 详情现在可查询非空收件箱的 queued / processing 状态和最老消息等待时长。 - **Agent Home 唤醒审计**：将已入队但等待唤醒的消息从 `wake_skipped` 拆分为 `wake_deferred`，并让催办事件携带 messageId 和实际投递结果。 - **PTC 后台命令指引**：明确使用 `Bash({ run_in_background: true })` 承载会话内后台任务；文档补充需要跨会话存活时的 systemd user unit 用法，避免依赖裸 `nohup` / `setsid` 进程。 - **PTC 恢复回归**：补充长会话冷恢复测试，确保残缺 session-meta 不会令 PTC 回落 CLI，恢复后仍保持 REPL-only 工具面。 - **手动压缩重入**：主任务仍在执行或等待工具确认时触发手动压缩，会等主任务空闲后再开始，不再与当前回合抢跑，压缩摘要也不会泄漏成普通对话消息。 - **压缩后续写完成态**：自动压缩后的续写正常结束时，不再被误报为用户取消。 - **压缩边界展示**：消息前压缩和触顶压缩的边界会立即收进静态历史区，不再等助手回复后才收起；重绘前先刷新顶部栏，切换模型后顶部栏不会停在旧数据。 - **空流重试积分统计**：对话因空流自动重试时，已经产生的积分也会计入本轮消耗，聊天展示与账单保持一致。 - **对话中途追问上下文丢失**：修复"发送但不中断"的消息在触发工具后从后续模型上下文丢失，确保最终回答持续包含用户追加的问题。 - **`plugin_status` 状态上报默认关闭**：改为默认关闭，仅 CLI UI 版本默认开启，并继续支持通过环境变量显式覆盖。 - **自定义 Agent 文件链接边界**：自定义 Agent 的运行时加载与管理清单使用相同的文件链接边界，跳过指向 agents 目录外的文件链接，并保持项目级 Agent 优先于同名用户级 Agent。 - **stream-json 长会话请求身份稳定**：修复 stream-json 长会话中后台任务通知导致请求身份变化、终态无法匹配而阻塞后续请求的问题，并隔离迟到的上一轮结果，避免提前结束新请求。 ## [2.157.0] - 2026-09-23 ### 🎉 新功能 - **CLI 白牌定制**：支持通过 `customization.json` 定制 CLI 的软件名称、启动 Logo、品牌配色、EndPoint 网关、遥测上报端点、产品内链接、内置插件市场与配置目录，面向专享版 / 私有化交付；支持 npm 包形态（离线 tgz 分发）与 Bun 二进制形态（单文件可执行、定制配置编译期嵌入防篡改）两种定制出包方式；升级策略可按客户禁用自动更新或指向客户自建升级源；定制目录名 / 指令文件名与官方不同时，可按需回退读取存量配置与记忆。 - **录音文件识别内置工具**：可将本地音频文件转写为带时间范围的文本，支持 wav/mp3/m4a/flv/mp4/wma/3gp/amr/aac/ogg-opus/flac 等常见格式，单文件时长 ≤5 小时、大小 ≤1GB，覆盖中文、英语及多种方言。工具自动上传音频、内部提交异步转写并轮询，用户无需自行提供链接或查询进度；识别失败、文件无效或超时会返回明确说明。该能力为计费工具，可由宿主开启高积分前置确认（本次确认 / 会话内始终允许 / 拒绝），默认关闭，通过产品配置或环境变量开启。 - **资源管理器文件传输**：支持将本地文件拖拽上传到指定目录并显示文件数与字节进度；目录可通过右键菜单下载为 ZIP；并可从文件或目录所在位置直接打开终端。 - **Output Styles 能力增强**：新增内置样式，支持 `/output-style