Agent 版本历史¶

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 诊断包，可在结构化审批后收集当前会话、工具与 LLM 时间线、受限轮转日志、最近 6 小时运行指标、网络与构建信息、heap/goroutine 以及可选 CPU profile；报告统一执行敏感信息脱敏，单项采集失败时可生成有界的 partial 报告，并通过独立诊断资产提供 30 天保留、7 天签名下载、审计和到期清理（#34）

问题修复¶

• 修复工具循环因重复失败而停止后，同批次未执行工具缺少终态、用户输入“继续”可能触发 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）