更新日志¶

v0.13.0(2026/09/23)¶

本次同步发布 obs-agent 与 obscli v0.13.0，新增会话与任务模型选择、会话快照分享、Incident Webhook、跨空间查询、会话私密凭据和全屏工具详情，改善历史同步、长任务的上下文保留、诊断报告与断线恢复。

Beak¶

新加功能¶

会话、定时任务和任务接入可分别保存模型与推理配置，执行记录保留当时的选择。新会话继承用户最近主动选择，新任务默认 Auto；修改配置不影响已排队消息。模型下架时保留原选择，本次执行自动回退 Auto 并提示；模型列表支持多语言简介和默认推理档位，需配套新版 Agent 与前端（#224、!493）。
任务创建者可生成免登录、只读的会话快照分享链接，包含创建时已保存的正式历史和附件；源任务后续修改或删除不影响快照。支持设置有效期和可选短链，短链服务失败时仍可使用原链接；未设置有效期则长期有效，本版不提供撤销或分享管理列表。需配套前端版本，所有 Beak 副本共享持久化的 BEAK_ASSET_ROOT/session-shares 目录，并放行 X-Session-Share-Token 请求头；短链通过 BEAK_SHORT_URL_SERVER_JSON 配置（#223、!489）。
Agent 支持独立的 Incident Webhook，故障通知可进入现有任务分析流程；与 Event Webhook 分别管理密钥、启停和投递配置。历史 Agent 可通过管理后台补齐，支持分页、进度查看和失败重跑；完整能力需配套 Backend、Connector、Owl 与分析 Skill（#222、!488）。

问题修复¶

修复 curl 命令中的 OAuth token、证书路径和口令可能进入工具参数摘要的问题，实时消息及持久化历史均进行隐藏（#212、!498）。
修复 Connector 断线时关闭回调死锁、在途请求一直等待超时的问题；同时修复流式请求的早到数据丢失，以及 Redis 重订阅被拒后连接仍在线但无法接收消息的问题（#214、#176、!479、!469）。
修复渠道消息通过后续 @ 触发 Agent 时遗漏原消息图片等附件的问题，断线后的持久化重试也会保留原附件（#176、!469）。
仅发生模型重试、没有工具调用的回合也保留执行记录入口，历史与实时记录可查看重试过程；恢复提示自动隐藏需配套前端版本（#205、!472）。
修复旧 MySQL 数据库缺少 MCP 运行状态字段导致启动或查询异常的问题，启动时补齐缺失字段，保留已有业务数据（#176、!469）。

功能优化¶

工具调用历史保留可安全展示的参数摘要，对凭据等敏感内容继续脱敏，并区分部分隐藏、整体隐藏、旧记录缺失和截断，便于判断实际保留了哪些操作信息；已被脱敏或丢失的内容不会恢复（#212、!490）。

obs-agent¶

新加功能¶

支持按用户指定范围查询已授权的其他工作空间数据，分页时保留目标空间、站点和查询条件；同组织跨空间 Trace 查询使用独立的空间列表。默认仍查询当前空间，授权列表失败时明确报错，不自动扩大查询范围（#221、!486）。
支持向当前会话提交文本或文件凭据，供普通 shell 命令使用；秘密不作为聊天消息发送给模型，已知原文在工具输出中脱敏。关闭会话、重启或断线后撤销，其他会话不会自动继承；这不能替代系统账号或容器隔离。详见会话私密凭据（#190、!454）。

问题修复¶

合法身份定义和行为边界完整进入模型提示，不再静默截断。两项各最多 10,000 个 Unicode 字符，含身份信息、标题和分隔符的完整资料最多 20,000 字符；超限或剩余提示预算不足时明确失败（#82、!487）。
修复未声明在 Skill 中的 Owl 工具被错误隐藏或禁止执行的问题；工具参数校验、调研要求、审批和实际访问权限继续生效（#216、!483）。
长任务按完整请求检查上下文容量，默认分两步压缩历史；摘要失败、为空或被截断时，改用限定长度的本地摘录继续任务，保留原始记录并支持重启恢复。设置 AGENT_HISTORY_COMPACTION_TWO_STEP=false 可切回单步摘要，失败时仍使用本地摘录（#209、!475）。
已读取且仍有效的 Skill 在历史压缩和重启恢复后保留全文；再次读取时使用当前安装内容，避免继续使用旧内容。多个 Skill 合计超出模型容量时仍会明确失败（#209、!475）。
修复工具失败后客户端长期显示运行中的问题，失败结果与预检修复状态会正确回传并保留记录；修复证据审查请求因推理参数冲突而无法继续回答的问题（#217、#220、!482、!485）。
Bug Report 单独保留当前会话截至采集开始时的全部可恢复用户消息，避免因工具事件过多而截断用户消息；无法补齐时标明缺失原因，近期日志按文件完整采集。详见会话 Bug Report 手册（#217、!482）。
修复测试通道发布的 Agent 版本号可能被历史自动升级器拒绝的问题；测试制品使用兼容的版本格式，不改变生产版本来源或现有升级入口（#226、!495）。

obscli¶

新加功能¶

Ctrl+T 打开全屏工具详情，查看参数、调用说明、进展和结果，支持滚动、调用切换与按编号定位；按 q 返回并恢复输入草稿。已加载及后续收到的聊天内容持续保存到本地会话缓存，再次 attach 可复用；/tool-index on|off 控制普通聊天中的工具编号，推理预览保留最新 5 个屏幕行（#219、!484）。
/credentials 提供私密凭据写入与删除，同屏填写名称和值、确认文件或覆盖；obscli run --import-credential PATH 从 JSON 导入凭据，全部确认后才发送任务，任一导入失败或未确认时不启动任务。内置交互菜单、提示和错误统一使用英文，用户内容与模型输出保持原文（#190、!454）。

问题修复¶

slash 命令等待网络响应时，可按 Ctrl+C 或连续两次 Esc 停止等待并保留草稿；写操作结果不确定时提示先核对状态，避免重复执行（#210、!476）。
凭据表单提交后的网络等待也支持 Ctrl+C 或连续两次 Esc 取消；等待期间的输入和粘贴会被丢弃，避免秘密进入普通聊天草稿、日志或缓存。取消已发送的写请求不代表撤销服务端操作，需核实结果后再重试（#190、#210、!496）。
修复流式正文和工具调用前言重复显示，以及重复或迟到的工具事件让已结束调用重新显示为运行中的问题（#211、#220、!477、!485）。
修复再次 attach 时远端摘要覆盖本地完整工具文本，以及离线期间完成的工具缺少最终状态和结果的问题。先显示本地最近聊天，再后台分页补齐 Beak 可提供的全部消息和执行详情，期间可继续输入；后续增量同步，保留本地已有的完整内容。较早的工具记录可在 Ctrl+T 查看（#212、!490）。
/save 不再重复下载已成功保存的附件；失败项保留供重试，历史重放也不会将已保存项重新加入队列（#176、!469）。

升级注意事项¶

OpenAPI 契约升级为 2.0.0，补齐并收紧响应字段、必填项、可空值和字典类型。API 消费方需从新版发布包重新生成类型并执行兼容性检查；本次契约更新不改变实际 HTTP 处理逻辑。已知限制：分享消息列表的响应结构尚未完整声明，严格类型生成仍会报告该接口待细化，本版尚未修正（#203、#223、!470、!489）。
跨空间查询需先更新 Owl Registry，再更新 Agent；使用相关 CLI 帮助需配套新版 Owl CLI。同组织空间列表仅用于 Trace 查询，不代表拥有这些空间的通用数据查询权限（#221）。
Incident 历史补齐按升级步骤 2026091701，由管理员运行 fix_incident_webhook_ensure_and_sync；本步骤没有 SQL，也不会在服务启动时修改历史数据。旧 Backend 或 Connector 不支持时保留待同步并记为跳过，原 Event 接入继续工作；依赖升级后重跑，并确认目标 Incident 均已同步，跳过不代表可用（#222）。
Profile 完整性校验需配套 Beak、新版 Agent 和前端。历史超长资料须缩短后重试；两项各自未超过 10,000 字符，也可能因身份信息及渲染开销超过整体限制（#82）。
工具完整参数和新的安全摘要需配套更新 Beak、Agent 与 obscli；旧事件没有发送的参数、服务端已脱敏或超出保留期的内容无法还原。旧版本地缓存可继续使用，索引会自动重建；30 天未更新且未被使用时自动清理（#212、#219）。
Agent 端的 Bug Report ZIP 检查上限提高到 1 GiB，但本次 Beak 上传接口仍限制单文件 32 MiB，超过该限制会上传失败；大报告上传需配套服务端后续更新。报告仍通过临时下载链接分享（#217）。
会话私密凭据需配套新版 Beak 与 Agent，Web 入口还需配套前端版本。文件凭据仅支持 Unix Agent，Windows 客户端仍可上传给 Unix Agent；Agent 离线时不接受提交，断线重连后需重新提交。携带凭据的命令返回时会清理同一进程组内的后台子进程，不适合用来启动长期后台服务（#190）。

v0.12.0(2026/09/16)¶

本次同步发布 obs-agent 与 obscli v0.12.0，支持公共模板定时更新和独立服务地址下发，改善 Skill 清理、MCP 安装恢复、流式会话、会话语言和终端交互。

Beak¶

新加功能¶

支持通过原生 OTLP 导出 Beak 的指标、日志和链路数据，便于关联会话、Agent 与任务的运行情况（#150、!410）。
公共 Skill、MCP、Agent 模板和 schemas 支持从 OSS 制品定时更新，多实例共享一次同步结果；失败保留上一可用版本。镜像不再内置模板，旧手工同步接口与工具移除，启用前需统一共享存储、Redis 和制品配置（#187、!452）。

问题修复¶

修复 MCP 安装计划与配置包版本不一致时，重试仍使用错误版本、Agent 静默回滚且页面长期提示需要升级的问题。重试重新计算一致的版本，失败保留诊断及上一可用配置，迟到的旧安装报告不会覆盖新尝试（#164、!425）。
修复集群消息处理中的事务竞争，以及 Agent 断连期间未确认消息过早结束投递的问题，改善跨节点重连后的消息恢复（#185、!448、!450）。
修复市场和工作空间 Skill 删除、禁用后的文件及 Agent 关联残留；清理失败可重试，离线 Agent 重连后继续卸载，同名重装不受旧清理任务影响（#177、!437）。

obs-agent¶

新加功能¶

模型、Web Search 和邮件服务地址支持独立下发，每项优先使用 Connector 的部署配置，否则使用 Beak 对应的 SaaS 默认值；本地非空配置仍优先。安装阶段不再用模型地址补齐搜索或邮件地址（#180、!463）。
自托管安装自动补装缺失的 gh/glab，复用已有安装和登录状态，方便 Agent 使用 GitHub、GitLab 的原生 CLI（#184、!447）。
正文与 thinking 支持流式展示和会话恢复后的历史回放，保持既有任务及会话生命周期（#186、!458）。

问题修复¶

首轮标题与回答共享会话语言选择；无法确定语言时遵循当前请求和会话上下文，不再强制回退为英文（#134、#160、!451）。
修复拒绝审批后同批待审批工具仍被执行、失效审批在恢复会话后重新出现的问题；拒绝结果保留供 Agent 解释或选择安全替代，取消或过期审批结束当前执行（#189、!458）。
identity、soul、restriction 分别按 1000、10000、10000 个 Unicode 字符限制，避免共享限额使后置规则丢失；仍遵守整体上下文预算（#201、!465）。

功能优化¶

默认展示模型提供的 thinking 内容，仍保留显式 hidden 配置（#191、!455）。
默认引导 Agent 使用会话语言生成 HTML 邮件，改善邮件内容的语言一致性与排版（#196、!461）。

obscli¶

问题修复¶

修复轮次分隔、工具输出和长回复的重复显示；并行工具预览受终端高度约束，长参数及窗口缩放不会将活动预览重复写入历史，完整结果仍保留（#192、#200、!456、!464）。
attach 恢复持久化的工具调用历史，重新进入会话后可查看已有执行记录（#193、!457）。
run 在创建任务前校验目标 Agent，避免无效目标产生无法执行的任务（#195、!460）。
收敛补全弹窗触发条件并简化中断提示，减少普通输入时的意外弹窗与干扰（#197、!462）。

功能优化¶

run 默认端到端超时延长至 2 小时，减少长任务被默认超时提前终止的问题（#194、!459）。

升级注意事项¶

先升级 Beak，并分别配置模型、搜索、邮件三项默认地址，再更新 Agent 安装器或容器；即使三个地址相同也必须分别填写。新安装器请求安装配置 v2，缺少独立服务地址时明确失败；旧安装器继续使用 v1 契约。已保存的托管 VM cloud-init 或自定义模板需同步传入搜索、邮件地址。本地已有的非空地址不会因平台默认值变化而自动改写（#180）。
部署环境启用 Connector 地址覆盖前，需要完成真实模型、搜索和邮件服务联调（#180）。
MCP 历史数据恢复需要配套部署 Beak、新版 Agent 和前端，由运维备份后执行升级步骤 2026091601，再在 MCP 卡片重试安装；服务启动不会自动修复历史业务数据。验收需确认新尝试的期望、已安装、运行版本一致，并完成实际工具调用（#164）。
历史已删除 Skill 的清理由运维按升级步骤 2026090901 执行；先停止旧实例及资源写入、清理任务，由新版本初始化表结构后执行数据修复。已有同名资源和其他租户的数据受到保护（#177）。
公共模板同步默认关闭。升级前停用旧外部同步调用、移除旧 GitLab 同步配置，全部实例切换后再通过 BEAK_PUBLIC_RESOURCES_SYNC_JSON 启用定时同步。所有实例须共享数据库、Redis 命名空间及同一路径的持久化卷；首次同步成功前继续读取已有资源目录（#187）。

v0.11.2(2026/09/10)¶

本次同步发布 obs-agent 与 obscli v0.11.2，修复升级依赖补装和 Markdown 显示问题。

obs-agent¶

问题修复¶

修复自托管 Agent 升级后缺少 git-rg 等新增基础工具的问题；自动和手动升级都会在启动新版 Agent 前补装依赖，无需等待 Skill Profile 更新（#181）。
可选工具安装失败时保留诊断并继续核心升级；即使 Agent 已是最新版，后续自动或手动升级仍会重试未完成的依赖安装，继续遵循空闲保护（#181）。
修复升级结束后锁未及时释放、导致后续升级偶发跳过的问题（#181）。
升级时实时显示脱敏进度和输出，等待空闲、回滚以及最终结果均有提示，避免长时间无反馈（#181）。

obscli¶

问题修复¶

修复流式回复结束后表格仍显示 Markdown 原文、加粗和代码块样式未生效的问题，同时恢复工具调用说明和进度文字中的加粗与行内代码样式。交互终端继续实时显示回复，结束后呈现完整格式，正文和附件不会重复显示（#182）。

v0.11.1(2026/09/10)¶

本次发布 obs-agent 自动升级修复，obscli 保持 v0.11.0。

obs-agent¶

问题修复¶

修复旧版 updater 被新版安装器拦截、无法自动升级的问题；旧入口无需人工替换即可完成过渡。支持空闲保护的 Agent 继续等待已有任务结束；没有空闲协议的旧版在首次过渡时会直接重启，可能中断正在执行的对话（#179）。
托管升级失败时恢复原有版本、配置和服务，保留失败原因并继续自动重试；新目标版本无需等待旧目标的退避时间（#179）。

v0.11.0(2026/09/09)¶

本次发布新增自然语言定时任务管理和复杂任务预调研，改善 Skill 上下文、计划修改、回复语言与 Agent 安装升级，并同步发布 obs-agent 和 obscli v0.11.0。

Beak¶

新加功能¶

自动化任务支持每 X 小时、天、周、月或年的周期配置，按任务时区计算后续执行时间，并跳过不存在的日历日期；Crontab 在创建、更新和启用时要求相邻执行间隔至少一小时（#140、!397）。
审批事件补充发起 Agent 和处理者的名称，实时消息、历史记录和重连回放使用同一展示信息；名称仅在当前租户范围内解析，保留原有审批权限和身份标识（#158、!421）。

问题修复¶

修复单个渠道账号凭据验证过慢时阻塞其他健康账号续租、导致连接失效的问题（#175、!434）。
修复审批事件查询 Agent 名称时未响应请求取消或查询超时的问题；超时后保留身份标识，后续请求可恢复名称展示（#158、!436）。
修复流式增量正文和控制事件混入持久历史的问题；历史归档和读取统一过滤暂态事件，活动连接的流式回放仍可正常使用（#178、!438）。
修复计划模式提交修改意见时反馈丢失、计划版本未推进，以及并发批准、拒绝或修改可能产生不一致状态的问题；修改意见和附件会作为新一轮规划的输入，过期计划操作会被拒绝（#171、!420）。
修复过期加密消息的重试可能导致 Agent 反复断连、长期离线的问题，失效运行的重试不再阻塞后续连接与任务（#161、!423）。

obs-agent¶

新加功能¶

新增普通对话的端到端流式输出，支持逐步接收回答正文、取消、断线恢复和跨节点回放；新版 obscli 可实时显示增量回答，未声明流式能力的旧客户端继续接收完整最终回复（#35、!275）。
支持通过自然语言创建、查询、修改和删除当前 Agent 的定时任务，并查看运行记录；任务变更遵循审批设置，查询和执行按工作区及 Agent 权限隔离（#115、!384）。
复杂任务支持先核对可用工具、证据和执行路径，再开始执行；证据不足时可继续补查。可通过 AGENT_PRE_SEARCH_ENABLED=false 关闭主 Agent 与子 Agent 的预调研要求（#113、#155、!365、!417）。
主机安装与容器镜像内置 git-rg，安装时获取最新稳定版并验证产物，方便 Agent 搜索代码仓库；使用方式与凭证配置见 git-rg 简明手册（#157、#163、!418、!424）。

问题修复¶

修复 Skill 内容未变化时，定期同步仍短暂移除已就绪索引、导致新任务缺少 Skill 摘要的问题；版本变化时仍等待安装协调完成后再显示（#173）。
修复历史压缩只保留 Skill 占位结果时，恢复 Skill 未重新载入完整指令的问题（#172、!431）。
修复 nice、env、sudo 等包装命令可能绕过审批或工作目录外写入限制的问题，恢复原有审批与写路径检查（#168、!428）。
修复 RUM 来源和字段发现被错误要求预调研的问题，简单发现操作可直接执行（#174、!433）。
修复升级预约期间关闭会话导致关闭摘要永久丢失的问题；预约解除后可通过重连恢复摘要生成，重复投递仍会去重（#176、!435）。
修复移出近期未使用的 Skill 后仍按旧上下文用量触发多余历史压缩的问题；释放空间后会同步更新压缩预算，剩余上下文仍超限时继续正常压缩（#170、!430）。
修复多语言对话中的回复语言漂移；每轮任务根据用户输入及明确的语言要求确定回复语言，并在后续任务与会话恢复时保持一致（#127、!400）。
修复最终输出不符合约定格式时被当作未知结束原因、跳过重试或无法恢复的问题；恢复过程会保留必要上下文，避免把内部修复信息当作最终回答（#142、!426）。
修复可选基础依赖下载失败导致主机安装中止的问题；可降级依赖失败后继续安装，并将诊断记录保存在持久目录（#159、!422）。
修复升级中断后磁盘版本与运行版本不一致、无法继续升级的问题；支持恢复未完成升级，并保留完整失败详情供排障（#162、!427）。
修复合法 Shell 命令与重定向可能被误判的问题，并向 Agent 提供实际 Shell 环境，减少使用不兼容命令后的重复试错（#151、!413）。
修复会话标题生成时模型 reasoning 参数不兼容的问题，提高自动标题生成的稳定性（#141、!401）。
纳入此前未随 Beak v0.10.1 补丁发布的 Agent 附件修复：完善上传附件与最终回复的绑定，校验 A2A 执行轮次，并允许回传失败后的任务重新领取与恢复（#149）。

功能优化¶

同一会话保留 Skill 激活状态，减少重复读取；上下文紧张时优先移出近期未使用的 Skill。Skill 内容统一使用完整 Markdown，并清理已移除 Skill 的误导性说明（#144、#146、#148、#169、!404、!407、!409、!429）。
向 AI Hub 传递会话标识，便于同一会话的模型请求保持路由亲和性（#147、!412）。

obscli¶

新加功能¶

在对话和历史记录中展示复杂任务的预调研结果，包括目标、证据、执行步骤与验证方式（#113、!365）。

问题修复¶

修复流式正文显示完成后最终附件被遗漏、表格未完整显示以及回复状态未正确收尾的问题，正文仍只显示一次（#178、!438）。
修复中文区域设置下终端边框宽度计算不一致，导致内容换行或布局错位的问题（!384）。

升级注意事项¶

历史高频 Crontab 任务在更新或重新启用前需调整为至少一小时的执行间隔；仍可暂停、手动执行或修改计划（#140、!397）。
从较早版本升级且尚未完成附件数据升级时，应先备份，再由运维执行相应升级清单；服务启动不会自动修复历史业务数据。诊断附件保留期限无法自动确认的记录仍需人工核对。
obs-agent v0.11.0 包含 A2A 附件协议修复；Beak 继续兼容旧 Agent 的文本 A2A 回复，完整附件行为建议配合新版 Agent 使用。

v0.10.1（Beak 附件补丁）¶

本次只发布 Beak 附件修复补丁；obs-agent 未随本次发布，相关 Agent 修复纳入 v0.11.0 候选版本。obscli 无行为变更，继续使用 v0.10.0。

Beak¶

问题修复¶

修复同一会话中已上传附件因未绑定消息或由系统创建而返回 404 的问题；具有会话读取权限的成员可以访问同租户、同会话内 active 且未过期的附件，跨租户、跨会话和失效附件仍不可访问（#149）。
修复 A2A 返回的普通附件在主 Agent 未发送最终消息时可能过期的问题；回传附件以源会话副本供用户下载，正式结果与副本发布原子保存，并支持重复回传和重启恢复（#149）。
修复 A2A 任务重新领取时沿用已撤销信任或旧审批权限的问题；诊断附件的跨会话副本保留原件截止时间，不会因回传或消息绑定变成永久保留（#149）。
兼容未升级 Agent 的 A2A 文本回复；旧协议不自动重领同一任务，等待超时返回明确失败，避免主 Agent 无限等待。新版协议仍校验执行轮次；旧 Agent 的 A2A 附件能力不在此次兼容保证范围内（#149）。

obs-agent（纳入 v0.11.0 候选版本）¶

问题修复¶

修复上传附件与最终回复绑定不完整、A2A 完成重试可能混用执行轮次的问题；新 Agent 显式声明严格投递协议。服务端兼容旧协议，用户无需为文本 A2A 强制升级 Agent（#149）。
修复 A2A 完成回传失败后，新领取批次被同一 Agent 的重复消息检查忽略、导致任务无法恢复的问题（#149）。

升级注意事项¶

普通历史附件不需要伪造消息编号即可读取，但附件记录、会话归属、有效期和实际存储文件仍须有效；本补丁不恢复已丢失的文件。
历史消息绑定和已发布 A2A 副本的业务数据升级由运维在备份后按升级清单执行，不在服务启动时自动回填。
历史诊断副本需按升级清单恢复保留期限；原件或关联信息已缺失的副本不能自动推断期限，须人工核对。已经超过原件期限的副本会被后续清理任务删除，升级前应完成备份。

v0.10.0(2026/09/02)¶

本次发布新增版本化 OpenAPI 契约和 obscli 跨工作区任务能力，支持独立配置模型、Web Search 与邮件服务，并集中修复 Reply Run 历史恢复与终态错误、Agent 结构化控制、外部 IM 上下文、数据库启动迁移和 obscli 附件处理等问题。

Beak¶

新加功能¶

发布版本化 OpenAPI 3.0.3 契约，新增 /openapi.yaml、/openapi.json 和 /swagger/ 入口；dev、tag 与 MR 流水线分别生成可校验的契约包或评审产物，并通过 checksum、manifest 及 DTO/schema 漂移检查阻止 Reply Run 与 Session Summary 契约失配（#106、!372）

问题修复¶

修复 Reply Run 控制事件可能进入用户消息、fresh schema 缺失会话历史状态表，以及刷新、重连或终态归档失败后过程事件、审批状态、Agent 接受时间和取消详情恢复不完整的问题；历史、关系库和 active replay 现在按结构化身份合并并去重，Redis 故障时仍降级返回持久历史（#110、#114、!357、!370、!375）
修复 Agent 运行失败后，Reply Run 已进入终态但随后提交的 fallback 回答可能被确认成功却未持久化或广播的问题；终态状态与用户可见输出现在原子收口，重复 transition、ACK 丢失和断线重试不会重复或丢失回答（#131、!386）
修复外部 IM 的 Command Delivery 与 Reply Run 生命周期不一致的问题；定向消息现在会原子创建 queued Reply Run 并携带其结构化 ID，广播消息仍可靠进入 Agent 上下文，但不会创建 Reply Run 或触发回复（#102、!356）
修复外部 IM 群聊中只 @ Agent、且短时间内没有可复用消息时可能投递空内容的问题；Beak 会使用结构化 mention-only/context-followup 状态生成非空续问，同时保留已有附件和 Reply Run 生命周期（#112、!363）
修复服务启动时重复执行历史数据回填、刷新事件序号或重建索引，可能造成大表扫描、锁等待和业务数据变更的问题；运行时初始化现在只负责 schema，历史数据修复统一由 internal/upgrade.yaml 的显式升级步骤执行（#109、!360）

obs-agent¶

新加功能¶

支持为 OpenAI-compatible 模型、Web Search 和 Send Email 分别配置服务地址与凭证；Host 与容器安装会按固定 allowlist 解析字面量 install-config，保护本地非空覆盖并校验 endpoint/credential 原子性，避免模型凭证被发送到工具服务（#21、!367）
Owl evidence collection 新增 RUM 数据源发现，并支持日志、链路与 RUM 按精确业务字段执行跨数据源文档查询；指标查询继续要求绑定单一数据源，缺少预定义路由时仍可动态探索 Owl 能力（!369）

问题修复¶

修复 Skill 激活元数据缺失、类型错误或前后不一致时仍可能继续暴露或执行受管工具的问题；异常配置现在 fail closed，并返回稳定的结构化失败状态（#103、!358）
修复 Beak 与 AI Hub 链路通过错误文案、Reason 或本地化文本推断策略拒绝、HTTP 状态和重试类别的问题；控制流现在使用 typed error、稳定 code 和 enum，修改文案或包装错误不再改变运行行为（#108、!359）
修复 evidence review 在工具已禁用后可能把 XML/JSON 工具协议或内部 repair 文本作为最终回答的问题；无工具复审阶段现在必须通过结构化 final_answer.v1 契约收口，非法输出会确定性修复或失败（#122、!383）
修复工具型任务中断后，用户继续任务时可能只返回“将继续执行”的承诺文本却把 Reply Run 标记为 completed 的问题；continuation 现在使用结构化决策和终态契约恢复所需 Skill/tool 上下文，不合格输出会进入 repair 或明确失败，无关的新问题仍优先遵循最新用户意图（#133、!387）

obscli¶

新加功能¶

/agents 与 /tasks 支持列出账号可访问的全部工作区，并在选择 Agent 或 Task 后切换到对应 Session workspace；交互式消息、审批、历史、附件、资源和 Skill 会使用当前 workspace，obscli run 同时新增 --workspace-uuid（#117、!374）

问题修复¶

修复 Reply Run 控制事件可能作为未知 payload 原样显示在对话区的问题；控制面状态继续用于恢复任务，但不再泄漏到用户回答（#114、!370）
修复模型或 Agent 运行错误重试耗尽后只清除进度、没有显示最终失败原因的问题；交互界面现在从 agent_runtime_result.v2 的类型化字段安全展示错误标题、摘要和 Trace ID，并与后续 fallback 回答去重，重新连接和历史回放保持一致（#131、!386）
修复多模态消息批量上传中途失败时已上传附件仍留在 Session 中的问题；obscli 会回滚本批次临时资产，并在清理失败时返回可诊断错误（#103、!362）
修复从剪贴板生成的临时媒体文件在发送、取消或失败后可能残留的问题，避免本地临时目录持续积累图片数据（#103、!364）
修复切换、关闭或清除 Task 后 footer 继续显示上一 Session credit 用量的问题；新 Session 会先清空状态，再从自身的结构化 usage 快照恢复（#118、!373）

v0.9.1(2026/08/29)¶

本次为 v0.9.0 的 Agent 热修复版本，降低 A2A 任务领取轮询对 MySQL 的持续压力，并避免依赖异常时的高频重试放大故障。

Beak¶

问题修复¶

修复大量 Agent 高频领取 A2A 任务时可能导致 MySQL CPU 持续高负载的问题；任务查询现在使用目标 Agent 前导索引，同一 Agent 的并发领取请求会在单节点及多节点间协调，认证或协调依赖暂时不可用时返回可重试状态（!378）

obs-agent¶

问题修复¶

修复 A2A 任务领取使用固定短周期轮询、依赖故障时仍持续高频请求的问题；默认轮询间隔调整为 10 秒，连续失败时按 10 至 60 秒渐进退避并遵循服务端 Retry-After，凭证明确失效时停止无效轮询（!378）

v0.9.0(2026/08/26)¶

本次发布重点增强 Agent 的 Owl 分析执行、权威 Reply Run 生命周期、工具审批和运行可观测性，同时新增图片多模态输入与账号跨空间 Agent 查询能力，并改善 obscli 的结果复制与会话状态展示。

Beak¶

新加功能¶

新增账号维度的跨空间可用 Agent 列表接口 GET /api/v1/me/agents/available；接口按 Token 中的账号与 deployment 范围批量获取空间、角色和暂停状态，过滤无权限或不可用 Agent，并以稳定的空间优先顺序进行全局分页（#96）
新增权威 Reply Run 生命周期与会话恢复：从用户消息排队、投递、执行、等待审批到完成、失败、取消或中断，均使用统一的 run ID、状态、时间与事件序列；历史、bootstrap、replay 和实时流按 cursor 与 revision 对账，页面刷新或切换会话后可恢复 thinking、工具调用、审批和最终回复，并统一任务状态与耗时口径，避免旧快照覆盖较新的实时内容（#69）

问题修复¶

修复电脑休眠或网络中断后 Agent 可能长期显示在线、消息持续空白等待的问题；Beak 会在心跳过期后主动关闭旧连接并将 Agent 状态收敛为离线（#85、!342）
修复用户取消消息后，未完成的持久化投递仍可能在 Agent 重连时重新执行的问题；取消操作现在会留下不可重新领取的终态记录，同时继续保留原始消息历史（#99）
修复消息渠道后台状态更新与删除并发时，迟到的旧状态可能把已删除账号恢复为活动状态的问题；状态更新现在只写入运行字段，并拒绝覆盖删除终态（#98）
修复 Webhook 即时投递原始事件后缺少处理状态的问题；消息现在会按事件语言和聚合模式提示 Agent 仍在处理（#95）
默认 Agent 告警 Webhook 在公开 Skill 可用时改用 owl-observability-analysis，Skill 不存在或查询失败时仍会继续执行告警任务，自定义 Webhook 不受影响（!348）

obs-agent¶

新加功能¶

引入 Skill 驱动的 Owl Agent 执行 Harness：领域 Skill 通过结构化 activation_tools 显式激活受管 Owl 工具，支持类型化查询、事件身份解析、分页读取大型结果和独立证据复核；未激活的底层通用工具不再直接暴露给模型（#101）
重构工具审批生命周期：交互式审批不再因固定超时自动过期，用户发送新消息时会取消旧审批和旧运行；Subagent 仅暂停等待审批的分支，A2A 与 Scheduled Job 等无人值守任务按结构化审批模式快速失败或明确使用 YOLO 模式（#90）
LLM 自动重试新增结构化运行进度事件，并在恢复后发送对应终态；同时增加首字节、reasoning、正文与总耗时等分段指标，方便区分超时、限流、网络和上游故障（#81、#88）

问题修复¶

修复 YOLO 模式收集诊断报告时仍可能进入审批流程，以及采集阶段耗尽超时预算后上传立即失败的问题；诊断采集与上传现在使用独立预算，并保留结构化授权审计（#86）
修复 Bash 命令替换中合法的 /dev/null 重定向可能被误判为越出工作目录的问题，同时保持对相似路径和工作目录外写入的拒绝（#100）
修复长输入及部分非中文请求的自动标题连续超长后直接失败的问题；标题生成会逐步收紧目标长度，并继续避免破坏词义的硬截断（#79）
修复 Owl CLI 提示词边界不清导致模型把说明文字拼入命令的问题；可执行示例现在使用明确的 Markdown 代码边界（#77）

功能优化¶

将 render_document 收窄为可靠的 Markdown 与纯文本生成工具；PDF 交由专业 PDF Skill 处理，HTML 和 PDF 请求不再生成具有误导性的文件（#91）

obscli¶

新加功能¶

新增图片多模态 Prompt：可在 obscli 中使用 @path、@~/path 或 @clipboard 按原顺序混合输入文字和图片；附件仅在发送时上传，任一上传失败会原子拒绝整条消息。Beak 全链路保留 Session 范围的 asset 引用，obs-agent 仅在调用 AI Hub 前转换为 image_url，并通过结构化错误隔离失败轮次，避免污染后续模型历史。v0.9.0 仅启用图片，音频能力保留为后续扩展（#32）
新增 /copy 命令，可将当前任务最近一条已完成的 LLM final 或 plan final 原始 Markdown 复制到系统剪贴板，重新进入历史任务后仍可使用（#89）
footer 新增最近一次对话耗时与当前会话历史压缩次数，字段可继续通过 /statusline 配置，并可从结构化历史事件恢复（#94）

问题修复¶

修复围栏代码块跨流式分片时可能提前关闭、后续内容被错误渲染的问题，提升长代码输出在终端中的稳定性（!334）

v0.8.1(2026/08/19)¶

本次为 v0.8.0 的热修复版本，集中修复 Agent 自观测开关未即时生效、IM 接入、MCP 重试、集群投递、自动任务标题、用户可见语言、诊断邮件和 obscli 终端渲染问题。

Beak¶

问题修复¶

修复已安装 Agent 修改自观测开关后必须重新安装或重启才能生效的问题；在线 Agent 现在可在同一进程内即时启停 metrics、logs 和 traces，Beak 通过类型化 desired/applied revision 跟踪实际应用状态，离线 Agent 上线后自动收敛，旧版 Agent 会明确显示为不支持（#71）
修复微信扫码返回 account_uuid 后无法直接更新别名或删除 IM 接入的问题；更新和删除接口现在都会在当前 workspace 与 Agent 范围内解析真实 binding，同时保留启停状态、跨 Agent 隔离和重复删除幂等（#62、ab7495f6）
修复 MCP 重试期间缺少中间进度、全局工具发现失败原因不明确的问题；Agent 检测阶段会使用同一 attempt 上报且保留最后可用工具，控制面按超时、网络、TLS、认证、授权和协议错误返回脱敏原因（#63）
修复自动生成的中文及中英文混排任务标题在 12 个 rune 处被硬截断、产生半个词或半句话的问题；标题会在 Agent 返回、服务端持久化和实时事件之间保持一致，同时保留用户手动改名优先级（#74）
修复 Redis 短暂不可用后持久化命令可能无法补投，以及 Beak 节点优雅退出后 connector lease 在 TTL 窗口内仍可能指向已下线连接的问题（b3a905b4、69daa80c）

obs-agent¶

问题修复¶

修复中文或英文任务中的最终答复、工具过程说明、任务洞察、审批理由、计划事件等用户可见内容可能混用另一种语言的问题；各输出现在统一遵循原始用户任务语言，命令、路径、日志字段和产品名仍保持原文（#65、#68）
修复自动标题任务与主回答生命周期耦合且难以观测的问题；标题生成现在独立执行并使用轻量模型配置，同时新增可按 session、message、task、command 和 attempt 定位的 trace、运行事件与指标（#64）
修复 Bug Report 邮件正文缺少诊断包地址的问题；纯文本和 HTML 邮件现在会安全附加诊断 ZIP 的 7 天临时下载链接、文件名和过期时间（#67）

obscli¶

问题修复¶

修复复杂日志 Markdown 表格错列，以及终端缩放或多行状态栏刷新后出现内容残影、重复 footer 和滚屏的问题（#70）

v0.8.0(2026/08/12)¶

本次发布分别更新 Beak、obs-agent 与 obscli：Beak 新增 MCP 配置刷新和 Runbook 引用能力，并增强消息渠道、会话标题及命令投递的可靠性；obs-agent 新增 DQL 查询 Skill，简化任务完成与运行限制协议，并完善 MCP 运行、checkpoint 和离线重连；obscli 修正容器引用参数。

Beak¶

新加功能¶

Webhook 消息渠道投递新增“先投递原始事件”开关；开启后每条告警会立即投递到目标渠道，Agent 仍可按聚合窗口分析并投递最终结果。默认告警任务会在公开且启用时使用 owl-alert-investigation Skill，原始事件投递失败不会阻塞后续分析（471b5ff0）
微信 IM 消息渠道支持设置最多 50 个字符的展示别名；别名仅影响界面和任务接入目标名称，不改变账号绑定、启停或消息投递行为，未设置别名的已有渠道继续使用原名称（6454837e）
MCP 管理新增远程工具发现、批量发现和定向 Profile 刷新能力；刷新失败时保留最后可用的工具快照，并隔离单个 MCP 的异常，避免影响其他资源（#38）
消息支持引用知识库 Runbook，并自动绑定 runbook-dsl Skill；引用会保留 Runbook 的资源身份，Agent 可读取完整内容并按 Runbook DSL 执行（#50）
容器引用统一使用结构化 container 类型和 canonical container ID，供 Agent 确定性调用 Owl 容器查询能力（#53）

问题修复¶

修复删除运行中 session 后未可靠投递取消命令、关联 A2A 调用未及时取消的问题；Beak 现在会持久化 session 取消命令，并同步取消关联调用（5d670cee）
修复 Agent 暂时离线、服务重启或多实例竞争时命令投递可能丢失或重复的问题；Beak 通过持久化投递记录、租约、重试和 ACK 收敛命令状态（5d670cee）
修复新 session 自动生成任务名称偶发失效的问题；标题任务现在会持久化并独立于主回答执行，可在模型超时、Agent 断线或服务重启后重试，同时避免覆盖用户手动修改的名称（#51）

功能优化¶

优化 Agent 与消息渠道列表及接入链路：agents/available 不再逐 Agent 查询 Skill/MCP 关联，企业微信等渠道统一由 SDK 校验凭证和账号身份（5d670cee）

obs-agent¶

新加功能¶

新增 dql-querying 领域 Skill，为模型提供版本化的 DQL 语法、常见查询意图映射、跨方言反例和查询验证流程；常规查询优先使用专用 Owl 工具或 typed/simple query，复杂 DQL 在执行前仍会校验（#47）
MCP 运行时支持安全激活远程工具、候选配置切换和定向刷新，并在冷启动或单资源失败时继续使用最后可用的工具快照（#38）

问题修复¶

修复 obs-agent 的通用完成工具可能与 Owl 等业务工具竞争、让模型把未来执行承诺误报为任务完成的问题；普通对话现在直接以自然回复结束，历史完成工具记录不会再进入模型上下文，Task Insight 仍可按需独立提交（#42、#45）
修复 active checkpoint 后的新消息被强制解释为继续上一任务的问题；obs-agent 现在把有界 checkpoint 与最新消息一并交给模型判断，并要求续跑状态持久化成功后才调用模型，避免运行状态与会话记录分叉（#41）
修复收到 session 取消命令后对应 worker 仍可能继续回复的问题；obs-agent 现在会停止该 worker，并阻止继续生成回复（5d670cee）
修复 MCP 启动命令未按配置环境解析、包运行器首次启动容易超时，以及 HTTP MCP 认证、授权或访问策略失败难以诊断的问题；obs-agent 现在按有效 PATH 和工作目录解析命令，为 npx、uvx 提供更合理的启动时间，并返回安全、结构化的错误类型（#55）

功能优化¶

obs-agent 移除依赖模型报告的 goal、progress、evidence 和动态 lease，改用确定性的模型调用次数、token 与运行时长上限；配置统一为 AGENT_MAX_LLM_CALLS 等 run limits，旧 iteration 配置仅作为升级兼容输入（#48）
obs-agent 离线重连后会按原消息 UUID 接收未完成命令并回传 ACK，避免重复创建用户消息或遗漏待处理任务（5d670cee）
清理不再生效的历史裁剪、上下文压缩、工具循环和权限模式环境变量，避免部署配置与实际行为不一致；复杂会话默认不再受累计 token 硬上限限制，仍可通过 AGENT_MAX_RUN_TOKENS 显式启用保护（#56）

obscli¶

问题修复¶

修复选择“@容器”引用时传递为 deployment、导致 Owl 无法识别资源的问题；obscli 现在传递 container 类型和 canonical container ID（#53）

v0.7.1(2026/08/07)¶

本次发布主要修复 obs-agent 在 Owl 查询修复流程中的证据保留和错误处理，使诊断数据可完整追溯，并避免对不可修复的查询构建错误进行无效重试。

问题修复¶

修复 Owl 查询修复流程可能丢失原始参数、Schema 诊断和结构化数据原始字节，以及修复次数耗尽后提前终止对话的问题；obs-agent 现在会持久化可通过 read_tool_event 完整读取的类型化诊断与原始证据，并在修复失败后继续生成业务结论（#40）
修复 Owl Simple Query 构建器生成无效 DQL 时，obs-agent 将不可修复的构建错误误判为参数问题并反复重试的问题；兼容版本的 Owl 返回结构化错误后，obs-agent 会展示明确的 tool_builder_error 并停止无效修复，直接 DQL 语法错误和普通参数错误仍可继续修复（#39）

v0.7.0(2026/08/05)¶

本次发布增强 obs-agent 现场诊断，并集中改善长会话历史压缩、subagent 运行可靠性、Owl 查询修复和 obscli 交互体验。

新加功能¶

obs-agent 的 collect_bug_report 新增 v2 诊断包，可在普通模式完成结构化审批后，或在 YOLO 模式直接授权后，收集当前会话、工具与 LLM 时间线、受限轮转日志、最近 6 小时运行指标、网络与构建信息、heap/goroutine 以及可选 CPU profile；报告统一执行敏感信息脱敏，单项采集失败时可生成有界的 partial 报告，并通过独立诊断资产提供 30 天保留、7 天签名下载、授权审计和到期清理。使用方式见在 Session 中收集并发送 Agent Bug Report（#34）

问题修复¶

修复 collect_bug_report 复用诊断采集的 60 秒 context 执行上传，导致采集耗尽预算后上传立即返回 context deadline exceeded 的问题；采集和上传现在使用独立预算，并继续响应同一用户取消信号（#86）
修复工具循环因重复失败而停止后，同批次未执行工具缺少终态、用户输入“继续”可能触发 provider 400/2013 的问题；未完成调用现在会记录结构化 skipped 结果，同时保持不执行（#33）
修复单副本 obs-agent 使用 RWO 持久卷时 Helm 升级可能因 Multi-Attach 卡住，以及品牌 Chart 可能残留未解析 Beak 地址的问题；Chart 改用 Recreate 策略并在打包时注入和校验品牌地址（#24）
修复中文会话中的任务洞察可能受英文工具 Schema 或结果影响而显示英文的问题；任务洞察现在明确与本轮最终回复使用相同自然语言（#29）
修复 Owl 结构化数据摘要向模型暴露缓存文件路径、导致 Agent 猜测本地路径并调用 read_file 失败的问题；模型改为使用类型化引用读取托管结果（#26）

功能优化¶

优化长会话历史压缩和 subagent 可靠性：在 context 达到 80% 时执行一次有界压缩，限制摘要预算与投影中的超长工具结果，拒绝空摘要，并在 obscli/Web 中展示压缩耗时和预计 context 缩减；同时补齐 subagent 工具证据、失败终态和每次 provider retry 的独立 operation lease。obscli 发送失败的 prompt 也会保留在输入历史中（#19）
优化 owl_exec 执行链路，在安全检查和审批后通过结构化能力协商预校验参数与 DQL，使可修复问题在真实查询前返回模型；同时减少重复任务洞察和不必要的 Owl 结果补读，支持通过 LLM_REQUEST_TIMEOUT 配置单次请求超时，并让 obscli Markdown 表格适配终端宽度（#30）
优化 Agent 模型往返：小型 Owl 数据在双重大小限制内直接进入模型投影，最终 task insight 与任务完成可在同一次结构化提交中完成；大型数据仍保留摘要和托管引用（#28）
优化 task_blocked 的用户可见输出，只展示 Agent 生成的业务结论或简短摘要，不再重复展开 runtime 标题、reason code、safe actions 和 fallback 回答；结构化 checkpoint 与诊断字段保持不变（#27）
优化 Agent trace 身份字段，补充标准 gen_ai.conversation.id 和构建版本，同时保留现有会话兼容字段（#25）
优化 Owl 工具调用指引：Agent 会在新环境中先检查 Owl 帮助和具体工具 Schema，优先使用只读工具并在查询前校验 DQL，按结构化结果判断执行状态，并根据 Errors、Logs、APM、Events、Metrics 和 Network 数据域选择对应工具（#37）

v0.6.1(2026/07/30)¶

本次发布主要修复公开 Skill 的同步与运行状态、Skill 源文件下载，以及 Agent 协作配置的权限和状态边界。

问题修复¶

修复公开 Skill 在启用安装状态跟踪后可能没有进入运行时索引、缺少依赖安装，或在 profile 同步与安装协调并发时从本地版本清单丢失的问题；obs-agent 现在会显式区分无需逐 Agent 安装的公开 Skill，在依赖就绪后保持其可用，并通过同一缓存锁安全更新 Skill 包和版本清单（4036ac69）
修复 Skill 源文件下载只能按 ZIP 返回、单文件 Skill 无法下载，以及上传 TAR.GZ 后下载文件名和内容类型不正确的问题；下载接口现在会保留原始源码包，并按 SKILL.md、ZIP 或 TAR.GZ 返回匹配的文件名和内容类型（156401c5）
修复 Agent 创建者无法管理自己创建的 A2A 协作配置，以及离线、创建中或运行受阻的 Agent 仍可能接受协作配置更新的问题；创建者现在可管理协作设置，不可写状态会返回明确冲突错误（156401c5）

v0.6.0(2026/07/29)¶

本次发布新增逐 Agent 的 Skill/MCP 安装状态，以及面向长任务的历史压缩与恢复能力，并修复 obs-agent 的 OpenTelemetry 指标与链路属性，使资源安装、长任务执行和 Agent 运行数据都能以结构化状态稳定追踪。

新加功能¶

新增逐 Agent 的 Skill/MCP 安装状态与运行健康跟踪。保存 Agent Profile、Skill 或 MCP 绑定后，Beak 会定向通知对应 obs-agent 立即同步；obs-agent 会执行资源安装、移除和健康检查，并回报启用、安装中、已安装、失败、运行健康及版本收敛状态。管理端可查看 Agent 级汇总和逐项详情、重试失败资源；离线 Agent、旧版本 Agent 和安装失败等场景会通过持久化执行记录、升级等待状态与周期同步最终收敛（54041571）
obs-agent 新增长任务历史压缩与恢复能力。工具结果会按预算生成明确标记的预览，并保留可按事件读取的完整详情；上下文接近模型限制时，Agent 会在不拆分工具调用与结果的前提下生成 continuation summary，持久化压缩后的精确历史和可继续 checkpoint，并在后续消息或进程重启后恢复。obscli 同时新增 /compact，用于手动压缩当前 Task 的较早历史（817b6f18）

问题修复¶

修复 obs-agent OpenTelemetry 指标与链路属性不一致的问题；统一 Agent、工具和 Skill 的 operation 名称、状态、耗时单位与直方图区间，使用 delta temporality 导出指标，并恢复 Agent 身份、Skill 名称、调用 ID 和会话等关键维度，便于准确聚合调用次数、耗时和失败结果（c679f78c、ebc7d5e6）

v0.5.0(2026/07/22)¶

本次发布主要聚焦 Beak 原生 Agent 协作、obscli 自动化调用和结构化上下文选择、obs-agent 企业代理与容器部署能力，并增强 Agent 消息投递、长任务、subagent 和 tool loop 的稳定性与可观测性。

新加功能¶

新增 Beak 原生 Agent-to-Agent（A2A）任务委派能力。目标 Agent 可配置公开寻址名、能力说明和可信来源；调用方 Agent 可通过 list_reachable_agents 发现已授权目标，并使用 send_message 委派任务。目标 Agent 始终在自身数据范围、Skill、工具权限、审批和 guard 边界内执行，结果以结构化终态返回；离线排队任务可在目标重连后继续，obscli 可只读查看 A2A 任务会话（cf004e11）
新增非交互式 obscli run 命令，支持从参数、文件或 stdin 提交一次性 prompt，列出在线 Agent，并以原始 Markdown 或 JSON 返回回答、用量和附件 metadata；命令提供稳定退出码、超时、诊断、YOLO 和 subagent 选项，便于集成到 shell 脚本和自动化任务，详见 obscli 手册（1a572ac1）
obscli 交互式输入框新增观测资源和 Skill 选择能力。输入 @ 可按 Service、Dashboard、Application、Host 和 Container 类型多选资源，输入 $ 可多选当前 Agent 的 Skill；选择结果会以结构化 metadata 随消息发送，并可随输入历史恢复，详见 obscli 手册（9e8eab12）
obs-agent 新增企业 HTTP 正向代理能力，支持 Basic Auth、HTTP_PROXY / HTTPS_PROXY / NO_PROXY、企业 CA，以及 Linux 安装、自更新、Docker、Kubernetes 和 Helm 场景；代理地址在日志中会隐藏凭据，详见 obs-agent 正向代理手册（0ad5dd7c）

问题修复¶

修复定向用户消息在目标 Agent 离线、WebSocket 断开、消息总线异常或 ACK 丢失时可能无法唤醒 Agent 的问题；服务端现在为每个目标创建持久 outbox，在 24 小时窗口内按退避策略进行至少一次投递，并只在收到目标 Agent 的 typed ACK 后停止重试（b76cd6a0）
修复 Kubernetes YAML 和 Helm 默认使用临时卷可能在 Pod 重建或升级后丢失运行中 session/task 历史的问题；新模板要求为工作目录、profile cache 和 Owl 数据使用持久化卷，Docker 示例也明确要求复用命名卷（0c1f0a62）
修复 obs-agent 安装目录和敏感文件权限可能受主机 umask 或旧文件权限影响的问题；配置、数据和日志目录使用固定权限，消息加密 key 和主日志会收紧为仅所有者可读写，同时避免跟随敏感路径上的符号链接（3b78a24e）
修复 session-local subagents 的 credit 未计入主任务用量汇总的问题，obscli 和可观测数据现在会展示完整的 token 与 credit 消耗（6eb6b2af）
修复自动化会话附件可能因系统用户身份缺少上传者权限而无法被 Agent 读取的问题；Webhook 和定时任务等系统触发会话可正常访问随消息上传的附件（b0c9ea93）
修复 Webhook、定时任务和外部会话在 Agent runtime 以结构化失败结果停止后仍可能保持运行中状态的问题；服务端会按稳定 stop_reason 将对应运行标记为失败并记录摘要（e4453728）

功能优化¶

优化工具调用失败后的进展反馈；Agent 在能够提供准确更新时，会通过结构化字段关联失败调用，并在下一次用户可见工具调用前说明直接原因、已确认的影响和调整步骤，减少无解释重试（0cebc36c）
优化长任务 tool loop 的执行预算：按结构化进展动态续租，无进展时先重规划再暂停，并为 LLM 调用、token、运行时长、普通瞬时错误重试和 HTTP 429 等场景提供独立边界与结构化 checkpoint，减少无效循环和上游 message 限制错误（7e56c92f）
优化 session-local subagent 调度，新增 wave supervisor、operation-aware lease、panic recovery、安全重试、结构化内部进展、可取消 wait_for 和显式 decline_subagents；独立任务继续并行执行，严格顺序任务不再被错误拆成同一 wave（d8a2ba04）
优化 Agent OpenTelemetry span 语义和属性，统一 Agent run、LLM、tool 与 subagent 链路字段，并补充 task、message、用量、运行结果和动态预算信息，便于跨版本查询与故障定位（50067540）

v0.4.0(2026/07/08)¶

本次发布主要聚焦 session-local subagents、obs-agent 容器化部署和发布链路拆分，同时补充 Agent 可观测性字段和若干运行时修复。

新加功能¶

新增 session-local subagents 能力。Agent 可以在同一会话内创建和调度子 agent，obscli 支持展示 subagent 事件、状态和输出，便于把复杂任务拆分为更小的并行工作单元（b624dc63）
新增 obs-agent 容器化发布能力，CI 会发布 Docker 镜像、Kubernetes manifest、Docker Compose 模板、Helm values 和 Helm chart。用户可通过 Docker、Kubernetes YAML 或 Helm 部署 obs-agent，详见 obs-agent 容器安装手册（2aff32e1）

问题修复¶

修复 Agent skill 索引可能包含不可读 skill 的问题，避免运行时尝试读取无权限或不可访问的 skill 文件（ca3029f8）
修复 Owl 安装相关配置仍可能写入旧路径的问题，安装和依赖初始化会统一使用 obs-agent 工作目录（255e7b0c）

功能优化¶

优化 Agent OpenTelemetry trace 字段，补充会话、任务、模型和工具调用相关属性，便于在链路追踪中排查 Agent 执行过程（f859adfe）
优化 agent/obscli CI release 配置，将通用校验、agent release、obscli release、Docker image 和部署配置拆分为独立 CI 文件，降低后续发布配置维护成本（2aff32e1）

v0.3.1(2026/07/02)¶

本次发布是 v0.3.0 的 agent/obscli hotfix，主要修复自部署 Agent 安装和 MCP 只读工具审批问题。

问题修复¶

修复自部署安装流程在全新主机上可能先安装 Owl/Skill 依赖、再创建 obs-agent 用户，导致 /var/lib/obs-agent/work/.owl 执行 chown obs-agent:obs-agent 时失败的问题（105e5620）
修复 MCP 工具声明 readOnlyHint 后仍可能触发写操作审批的问题；只读 MCP 工具会按只读提示进入更低风险的审批路径，减少不必要的用户确认（671f1733）

v0.3.0(2026/07/01)¶

本次发布主要聚焦 obs-agent/obscli 品牌命名迁移、Beak 与自部署 Agent 之间的链路消息加密、模型选择和 Windows 终端体验，主要有如下更新：

新加功能¶

Beak 与自部署 obs-agent 的 WebSocket 聊天链路新增 HPKE 应用层消息加密能力，可对 chat:user / chat:agent 的正文和业务 metadata 加密传输，并支持 Beak key ring、agent 本地 key 文件和 key 轮换配置；新安装默认使用 /var/lib/obs-agent/message-hpke-key.json，部署和排障请参考 obs-agent 链路加密运维文档（16cd141）
新增 obs-agent / obscli 发布物、安装脚本、卸载脚本、构建命令和用户文档入口，发布包、默认路径和本地配置统一迁移到 obs 命名（4205ac0）
新增 uninstall-legacy.sh 旧版卸载脚本，用于从旧 beak-agent / obsycli 固定系统布局迁移到 obs-agent / obscli；升级前请参考 obs-agent 日常使用手册和 obscli 手册中的旧版迁移说明清理旧服务、旧用户、旧配置目录和旧 CLI 本地数据（44dd995）
```
curl -fsSL https://static.guance.com/obs-agent/uninstall-legacy.sh | sudo bash -s -- --yes
```
新增 session model selection 能力，用户可在会话维度选择模型模式，obscli 会展示模型路由和实际响应模型，便于区分自动模型、固定模型和高级模型场景（eb7ebe6）
新增 obs-agent YOLO 模式配置，可在自部署场景下显式打开更宽松的权限模式，并在 obscli 中展示当前权限状态（8f424e7）
新增 Forethought Connector / Testing Studio socket 相关接入能力，支持通过 connector RPC、部署隔离和 WebSocket 通道承载自部署环境的 Agent 创建、认证和会话链路（382d6cc）

问题修复¶

修复 AI Hub 错误码映射与 Agent runtime stop_reason 命名不一致的问题，obscli 展示的错误原因和后续处理建议会更贴近平台返回的稳定错误码（8c0e946）
修复 AI Hub Chat API 或工具 API 失败时 trace id 不透出的问题，现在会从 X-Trace-ID 响应头提取 trace id，并写入 Agent 错误内容和 obscli 可见错误信息，便于排查 403、上游超时等问题（45c3820）
修复 obs 命名迁移后的卸载流程遗漏问题，uninstall.sh --yes 会按 obs-agent 固定布局清理 agent/updater/update-check 二进制、systemd unit、sudoers、配置、数据、日志以及 obs-agent 用户和用户组（44dd995）
修复 Windows PowerShell 启动 obscli 时可能直接显示 ANSI 控制字符、启动横幅边框错乱的问题，Windows 终端启动会按控制台能力选择更稳妥的渲染方式（492aaef）

功能优化¶

优化安装、升级、自更新和 release 脚本命名，make build-obscli、make release-obscli、install-obscli.sh、install-obscli.ps1、release-obscli.sh 等命令与发布目录统一使用 obscli（4205ac0）
优化 obscli 用户手册，补充 Linux/macOS、Windows PowerShell、Windows Git Bash 和 WSL 的安装卸载路径差异，并单独说明旧 obsycli 迁移清理方式（4205ac0）
优化 obscli 表格、空值、session 列表和自更新提示渲染，减少 Windows 与窄终端下的错位和无效 ANSI 输出（492aaef、f3f8e45）
优化集成测试运行方式，新增 Python harness 并迁移一批原 shell case，后续本地和 CI 验证可复用更稳定的测试入口（fa4e1be）

v0.2.1(2026/06/29)¶

本次发布主要聚焦 Plan Mode 新一轮计划稳定性、审批交互和 obscli 终端体验，主要有如下更新：

新加功能¶

obscli 新增 /statusline 命令，可通过弹窗多选配置底部状态栏字段，并写入 ~/.obscli/config.toml 持久化展示偏好（0a95241）
obscli 支持模拟 IM/channel session，上下文会写入 channel metadata，便于在 CLI 中验证 markdown-only channel 场景（38cd453）

问题修复¶

修复 Plan Mode 再次执行 /plan 时可能复用旧 plan id、旧 revision 或旧运行记忆的问题，新一轮计划会清理旧状态并重新从 revision 1 开始（2122100）
修复 Agent 默认不携带近期聊天上下文导致多轮对话容易丢失上下文的问题，AGENT_RECENT_CHAT_HISTORY_MESSAGES 默认值调整为 20（81cf418）
修复 session 名称更新后 WebSocket 客户端缺少通知的问题，现在会发布会话更新事件，客户端可及时刷新标题和列表展示（00e943a）
修复 obscli 工具输出和审批展示的若干交互问题，包括 stderr 截断、失败状态着色、ANSI reset 后续颜色保持、审批弹窗取消和拒绝后的回合结束处理（0a95241、38cd453）

功能优化¶

优化 obscli 交互式输入体验，重构多行编辑、历史搜索、slash command 选择、弹窗选择和终端按键解析，兼容 SS3 arrows、CSI-u/Kitty keyboard protocol、Home/End/Delete 等常见终端序列（0a95241、91f4d6f）
优化 markdown-only channel 会话的结构化能力边界，禁止在该类会话中直接提交 Plan Mode 和高风险操作审批动作，并给出明确的 markdown 文本提示（38cd453）
优化 Plan Mode 运行记忆和上下文注入，保留最近用户输入、最新 plan update/final plan 和 approved plan 信息，降低计划修订或确认后上下文断裂的概率（2122100）
优化 obscli 工具调用展示，按 stdout/stderr 分段截断长输出，避免误把普通输出中的 ERROR: 文本渲染为失败结果，并保留彩色输出中的后续颜色（0a95241）

v0.2.0(2026/06/17)¶

本次发布主要聚焦 obs-agent 运行时可诊断性、AI Hub 错误透出、Skill 调用链路和 obscli 交互展示，主要有如下更新：

新加功能¶

obscli 新增 ~/.obscli/config.toml 本地配置文件，支持通过 footer_fields 自定义底部状态栏字段，可选择展示 agent/task、model、token、context、permission 和 plan 状态（b0ebe75）
obscli 输入编辑器新增本地历史记录持久化，用户发送成功或失败后都能在后续交互中继续通过历史输入找回原始问题（b0ebe75）

问题修复¶

修复 AI Hub 返回结构化错误 code 时 Agent 只按通用 LLM HTTP 错误处理的问题，现在会优先透出 INVALID_BODY、VALIDATION_ERROR、AUTH_INVALID、AGENT_API_KEY_DISABLED、DAILY_CREDIT_LIMIT_REACHED、MONTHLY_CREDIT_LIMIT_REACHED、PROTECTED_SECRET_INVALID、NO_AUTO_MODEL 等稳定 stop_reason，并在 obscli 中展示对应处理建议（a09dcaa）
修复 OpenAI-compatible LLM 响应被 AI Hub envelope 包裹时无法正确解析的问题，Agent 现在支持从 data 字段解出真实 chat completion 内容，并保留响应模型信息（b0bc4e2）
修复 query_session_events 缺少游标续查能力和错误分类不稳定的问题，新增 cursor 参数并将缺少参数、历史读取失败等错误按工具错误结构化返回（b0bc4e2）
修复 render_document 可能覆盖同名目标文件的问题，生成文档时改为独占创建文件，避免误写已有文件（b0bc4e2）
修复 obscli session 列表仍展示已关闭或关闭中的 session、空列表展示不清晰的问题，现在默认过滤关闭状态并在无可用 session 时显示空表（b0ebe75）

功能优化¶

优化 Agent 用户可见文本的语言契约，final answer、tool commentary、progress feedback、approval reason、task insight、Agent UI 文案和关闭总结会优先遵循原始用户问题语言，避免受 Skill 文档、schema 或 repair prompt 语言干扰（b0ebe75）
移除 Agent use_skill 本地 tool call，Skill 继续通过 read_skill/read_skill_file 和 Prompt 指令链路使用，避免模型把普通 Skill 误当作可执行工具调用（b0bc4e2）
优化 Python 工具异常处理，补充缺少代码、非零退出、超时、缺少 python3 和输出过大等结构化错误返回；超大输出会以 output_too_large 截断为短错误，避免污染后续上下文（b0bc4e2）
优化 Agent runtime 停止结果，针对 AI Hub 错误补齐标题、摘要和可继续动作；对达到最大工具调用次数的场景减少冗余 completed/blocker 展示，提升 obscli/Web UI 可读性（a09dcaa）
优化 token usage 和可观测性事件，LLM 响应模型会写入 token metadata，obscli 底部状态栏可展示实际响应模型，便于排查自动路由和模型回退情况（b0ebe75）
优化 obs-agent --version 输出，补充 branch、commit、release date 和 Go version，便于确认线上 agent/obscli 发布物来源（b0ebe75）

v0.1.9(2026/06/15)¶

本次发布主要聚焦 obs-agent 默认模型配置、卸载流程补全和 release 物料完整性，主要有如下更新：

新加功能¶

Agent 支持省略 LLM_MODEL 配置，runtime 默认使用 default 模型标识，安装脚本和 Beak install-config 不再要求用户提供模型配置（d096537）
Agent release 新增 uninstall.sh 发布物，用户可通过 release URL 在线拉取卸载脚本（1e2c13f）

问题修复¶

修复升级时旧 agent.env 中 active LLM_MODEL 可能继续被保留的问题，安装脚本会移除该旧配置并只保留默认注释，避免本机旧模型值覆盖 runtime 默认值（d096537）
修复 LLM Chat span 的 response_model 总是等于请求模型的问题，现在会优先使用上游响应体里的 model 字段，失败或缺失时再回退到请求模型（d096537）

功能优化¶

补全 Agent 卸载范围，uninstall.sh --yes 会停止并删除 obs-agent-update-check service/timer，移除 updater/update-check 二进制和 /etc/sudoers.d/obs-agent（1e2c13f）
明确卸载边界，uninstall.sh 不会删除 skill-dep.sh 安装或检查过的系统命令、语言运行时、Python/Node 包、字体等 skill 运行依赖，避免误删宿主机已有或其它服务共享的组件（1e2c13f）

v0.1.8(2026/06/12)¶

本次发布主要聚焦 obs-agent 运行时诊断、tool loop 稳定性、Skill 使用链路和 obscli 展示修正，主要有如下更新：

新加功能¶

Agent 新增 collect_bug_report 工具，可收集运行时信息、近期日志、指标状态、脱敏后的 env/config 和 profile cache 诊断，并打包上传到当前 task 会话，便于排查 Agent 自身问题（7e073a1）

问题修复¶

修复 LLM 超时、限流、上游错误和网络错误缺少稳定 stop reason 的问题，Agent runtime 现在会返回结构化 llm_timeout/llm_rate_limited/llm_upstream_error/llm_network_error 等原因和可继续建议（7e073a1）
修复 tool call 参数 JSON 异常、同一失败 action 重复调用和同类工具错误重复时诊断信息不足的问题，停止结果会带上最近成功项、阻塞项和 safe_next_actions（7e073a1）
修复 obscli 在流式 token 用量和最终 token 用量同时到达时可能重复累加的问题，增量 token 事件会按 reply_to_message_uuid 去重（7e073a1）
修复 obscli 通过任意字符串 attach session 时可能误解析的问题，现在只接受序号或 session_/session- 前缀的显式 session id（7e073a1）

功能优化¶

优化工具结果给 LLM 的结构化 envelope，补充 ToolSuccess/ToolError、schema validation repair、routing repair 和 cache hit 标记，减少无效重试和错误工具选择（7e073a1）
优化 Skill 使用链路，skills index 不再暴露可猜测的 .beak-skills 文件路径，并在 tool event 中补充 skill_name/skill_file_path/tool_display_name，obscli 展示 read_skill/read_skill_file 时更清晰（7e073a1）
优化 profile cache 同步，增加 profile cache 文件锁和陈旧锁清理，并从已安装版本信息生成 skills index，降低并发同步导致 cache 状态不一致的概率（7e073a1）
优化 Agent 身份和 Prompt 规则，自我介绍优先使用运行时 agent_name，并避免暴露底层 LLM provider、model id、内部项目名和代码包名（7e073a1）
优化 obscli 工具调用展示，支持 tool_display_name，限制长 tool reason 展示行数，并仅在当前存在 working message 时回放最近工具输出（7e073a1）
优化 obscli 创建 task/session 的 metadata，显式写入 session_type=task 和 source_type=user，便于服务端区分 CLI 用户任务来源（57fb449）

v0.1.7(2026/06/10)¶

本次发布主要聚焦 obscli 交互体验、obs-agent GTrace 可观测性、Skill 使用链路和 Plan Mode 稳定性，主要有如下更新：

新加功能¶

obscli 新增 /save 命令，可将 Agent 回复中携带的 internal asset 附件下载到 ~/.obsclis/attachments/，并在有可保存附件时给出提示（01d75d9）
obscli 支持在对话流中直接展示 task_insight 和 session_summary，便于查看 Agent 阶段性洞察和 task 关闭总结（316ecf2、01d75d9）
Agent 新增 read_skill 和 read_skill_file 工具，用于先读取显式指定 Skill 的 SKILL.md 和引用文件，再按 Skill 说明执行任务（01d75d9）
Agent 支持用户 @ 实体/显式 Skill 请求上下文，消息 metadata 可携带 requested_skills 并注入 Prompt，避免只凭 Skill 名称猜测用法（d460e73）
Agent 新增 task 标题自动生成能力，obscli 创建未命名 task 时可由 Agent 根据首条用户消息生成标题（6b5618a）

问题修复¶

修复 obscli 在部分 LLM 回合中 working 状态过早消失的问题，发送成功且存在 message UUID 的普通消息都会持续跟踪运行状态（01d75d9）
修复 obscli 错误提示和工具输出展示不稳定的问题，统一用户可见错误格式，并保留完整单行工具输出，避免关键错误被截断隐藏（01d75d9）
修复 obs-agent 旧配置 OTEL_EXPORTER_OTLP_PROTOCOL=grpc 无法兼容的问题，现在会归一到 http/protobuf，避免历史安装配置启动失败（8d663c1）
修复 LLM Chat span 的 input_preview 在多轮 tool loop 中反复显示同一条原始用户输入的问题，现在会记录本次 LLM 请求中最近的非 runtime prompt 消息（01d75d9）
修复 Plan Mode 结构化交互 schema 仍可能依赖不稳定 action label 的问题，accept/reject/skip/revise 只按稳定 action id 处理（c55f653、01d75d9）

功能优化¶

优化 obs-agent GTrace/OTEL 上报，默认使用 OTLP HTTP/protobuf，支持 OTEL_EXPORTER_OTLP_HEADERS，并在日志和 trace 中补充 Agent 标识、Plan Mode 状态和 LLM 调用上下文（01d75d9、8d663c1）
优化 Skill 依赖安装流程，将异步依赖安装、超时控制、进程组清理和 changed package 过滤收敛到 cmd/agent runtime，Profile Client 只负责同步和索引（c4be7f0）
优化 Agent 工具与 Prompt 规则，明确 attached session files、上传附件、Skill 文件读取、工作目录写入和 progress_feedback 的使用约束（01d75d9、d460e73）
优化 Plan Mode runtime 和 obscli 展示，强化直接回答 repair、结构化交互事件、历史回放、plan 状态恢复和 tool output 紧凑渲染（c55f653）
优化 obscli task 创建和列表体验，/newtask 支持自定义 task 名称，未命名 task 可走自动标题流程（6b5618a）

v0.1.6(2026/06/03)¶

本次发布主要聚焦 Plan Mode 稳定性、task 关闭流程和 obscli 运行态展示，主要有如下更新：

新加功能¶

obscli 新增 /close <number|task_id> 命令，支持关闭当前或指定 task，关闭后 task 进入 closing/completed 流程，避免继续发送新消息（4efd12a）
Agent 新增 session_summary 事件，task 关闭时会生成会话总结并由服务端完成 session 状态流转（4efd12a）
Agent 新增 agent_runtime_result 事件，obscli 可展示 tool loop 停止原因、阻塞项、建议下一步和最近完成工作（845d571）

问题修复¶

修复 Plan Mode 结构化交互在历史回放中可能无法挂回触发用户消息的问题，plan events 会按 reply_to_message_uuid 兜底关联历史消息（845d571、713593e）
修复 Plan Mode 终态可能被旧 snapshot 回退的问题，避免 completed/interrupted 状态被过期 planning 状态覆盖（845d571）
修复 Plan Mode 交互确认流程判断不稳定的问题，统一使用 accept/reject/skip/revise action，并明确确认需求后下一步应提交 final plan（713593e）
修复 session status API 不支持 closing 的问题，关闭 task 时会发布 session_close_requested 上下文，Agent 可据此生成关闭总结（4efd12a）

功能优化¶

优化 Plan Mode 交互 schema，移除全局 free_text，改为字段级 custom_input/comment_input 和 text_entry，提升 CLI/Web UI 结构化输入一致性（713593e）
优化 obscli Plan Mode 展示，隐藏中间 plan_execution_progress 噪音，避免结构化内容和文本内容重复渲染，并在 plan event 到达时正确结束当前 working 状态（845d571、713593e）
优化 Agent Prompt 和 Prompt Builder 中的 Plan Mode 规则，补充新的 interaction action、文本输入字段和 session context 约束（713593e）

v0.1.5(2026/06/01)¶

本次发布主要聚焦 Agent MCP Client、Plan Mode、obscli 交互能力和权限/审批流程完善，主要有如下更新：

新加功能¶

Agent 新增 MCP Client 能力，支持从 profile cache 同步 MCP 配置和工具包，并通过 mcp_list_servers、mcp_list_tools、mcp_call_tool 统一路由调用 MCP 工具（fcf17e3、14aad95）
Agent 新增 session/task 级 Plan Mode，支持计划草稿、结构化交互、最终计划确认、执行进度、阻塞、打断和完成等 plan events（c69d29c、d65661d）
obscli 新增 /plan、/plan-approve、/plan-reject、/plan-revise、/plan-interrupt 命令，并支持展示 plan 状态和结构化交互内容（c69d29c、d65661d）
obscli 新增 /permission-full 和 /permission-standard 命令，用于在 CLI 中切换当前 task 的 permission mode（d65661d）

问题修复¶

修复 obscli /tasks 和 /attach 未限定 CLI 创建任务的问题，避免 CLI 误 attach 到非 obscli 创建的 session（29faa63）
修复 obscli 启动参数中未知子命令未及时报错的问题，避免错误命令被静默忽略（5d9f923）
修复 obscli 近期历史消息读取对部分响应结构不兼容的问题，补充 content.messages 和 content.data 解析兜底（5d9f923）
修复 bash 中远程登录、数据库客户端等高风险命令未进入 runtime approval 判断的问题（26edc7a）

功能优化¶

优化 MCP 工具暴露策略：默认只暴露稳定路由工具，小工具集 server 可按需展开直接工具，大工具集继续通过 mcp_call_tool 路由，降低 tool schema 膨胀（fcf17e3、14aad95）
优化 Agent Prompt 和 prompt cache 结构，补充 MCP、Plan Mode、permission mode 和 session context 规则，并将 MCP toolset version 纳入缓存 key 计算（41d0018、fcf17e3、c69d29c）
优化 query_session_events 默认历史消息查询数量，从 3 条调整为 20 条，增强多轮上下文恢复能力（26edc7a）
优化 obscli 输入体验，支持 slash command 模糊匹配、高亮、Ctrl+L 清屏、双击 Esc 取消、统一命令历史和更简洁的启动提示（26edc7a、c69d29c）

v0.1.4(2026/05/27)¶

本次发布主要聚焦 Agent Prompt 精简和 obscli 历史消息展示稳定性，主要有如下更新：

问题修复¶

修复 obscli 启动或重连后可能同步早期历史回答，导致当前交互区被旧 message 覆盖的问题（6e05c87）
修复 obscli 可能将历史 web_search_evidence 等 agent event 原始 JSON 输出到交互界面的问题，相关事件仍会保留在 obscli log 中便于排查（6e05c87）

v0.1.3(2026/05/26)¶

本次发布主要聚焦 agent runtime、obscli 展示和安装升级流程优化，主要有如下更新：

新加功能¶

Agent UI schema overlay 改为通过 scripts/prepare.py 和 scripts/compile.py 驱动，运行时按 skill 选择 overlay 并编译 agent-ui@1 draft blocks（5a1e699）
submit_agent_ui_blocks 支持使用 overlay 提供的 tool_input_schema，Agent 只提交 draft blocks，不再需要提交 overlay_id 和 layout（5a1e699）
obs-agent 新增 --default-envs 参数，用于输出运行时默认环境变量注释，安装脚本可直接使用二进制中的默认值（823c0bb）
新增 AGENT_REASONING_DISPLAY_MODE 配置，支持 hidden/raw 两种 reasoning 展示模式，默认隐藏原始 reasoning（823c0bb）

问题修复¶

修复工具调用 running 事件分层不清的问题：人类可见说明改为写入 metadata.commentary，running 事件的 content 保持为空，避免客户端误读（c2cb6e6、823c0bb）
修复 Agent 升级时 agent.env 中用户自定义 active 环境变量可能丢失的问题，升级会保留旧文件中未被新配置覆盖的 KEY=value 和 export KEY=value（823c0bb、5a1e699）
修复 Task Insight 事件归属问题，确保 insight 按回复消息关系持久化和发布（5a1e699）

功能优化¶

优化 obscli 的 thinking 和工具调用展示，长 reasoning、工具说明和输出预览会折叠截断，降低终端噪音（823c0bb）
优化 Prompt 规则，最终回复语言按原始用户任务判断，并避免泄露 runtime bookkeeping、repair prompt、tool protocol 等内部信息（823c0bb）
优化 Task Insight 提交流程，允许在任务过程中多次提交阶段性事实、动作、假设和结论，并使用运行时时间生成时间戳（5a1e699）

v0.1.2(2026/05/25)¶

本次发布主要聚焦 agent 和 obscli 的优化，不涉及 beak server 调整。主要有如下更新：

新加功能¶

Agent 新增工具调用可视化能力，在 CLI 中展示工具调用原因、批量执行状态、输出预览，并支持通过 Ctrl+T 切换完整工具输出（4bd18ed）
Agent 新增 Prompt Cache 支持，按稳定前缀、半稳定前缀和动态后缀拆分系统提示词，并为 OpenAI 兼容 Provider 增加显式缓存块传递能力（c9274e7）
query_session_events 工具新增按需查询最近用户对话和工具执行历史的能力，减少默认注入上下文的体积（c9274e7）
obscli 会话页新增任务、Agent、输入/输出/缓存 Token 和剩余上下文状态展示（c9274e7）

问题修复¶

修复 Agent 安装配置 API 未下发 llm_max_tokens 的问题，确保自托管 Agent 安装时可正确传递最大 Token 配置（92e776d）
修复自托管安装脚本在错误接口、HTML/JSON 响应或空响应场景下提示不清晰的问题，增加 HTTP 状态、响应摘要和 env 文件格式校验（92e776d）

功能优化¶

优化 /agents 和 /tasks 展示，隐藏原始 UUID，保留内部数字选择能力，提升 CLI 可读性（c9274e7）
优化 Agent 最终回复语言规则，默认跟随用户最新消息语言，同时保留命令、代码标识符和专有名词原文（c9274e7）
优化 LLM 观测数据，补充 Prompt Cached Tokens、缓存命中率和上下文用量到日志与链路属性中（c9274e7）
优化工具调用事件元数据，补充批次和输出摘要字段，便于前端和 CLI 统一展示（4bd18ed）