Agent 版本历史

v0.1.8(2026/06/12)¶

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

新加功能¶

• 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）
• 修复 obsycli 在流式 token 用量和最终 token 用量同时到达时可能重复累加的问题，增量 token 事件会按 reply_to_message_uuid 去重（7e073a1）
• 修复 obsycli 通过任意字符串 attach session 时可能误解析的问题，现在只接受序号或 session_/session- 前缀的显式 session id（7e073a1）

功能优化¶

• 优化 Agent tool loop 实现，将 commentary、结果 envelope、错误分类、LLM 调用、Plan Mode、repair 和 stop checkpoint 拆分到独立模块，降低运行时维护复杂度（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，obsycli 展示 read_skill/read_skill_file 时更清晰（7e073a1）
• 优化 profile cache 同步，增加 profile cache 文件锁和陈旧锁清理，并从已安装版本信息生成 skills index，降低并发同步导致 cache 状态不一致的概率（7e073a1）
• 优化 Agent 身份和 Prompt 规则，自我介绍优先使用运行时 agent_name，并避免暴露底层 LLM provider、model id、内部项目名和代码包名（7e073a1）
• 优化 obsycli 工具调用展示，支持 tool_display_name，限制长 tool reason 展示行数，并仅在当前存在 working message 时回放最近工具输出（7e073a1）
• 优化 obsycli 创建 task/session 的 metadata，显式写入 session_type=task 和 source_type=user，便于服务端区分 CLI 用户任务来源（57fb449）
• 优化手动测试脚本，支持并行启动多个手动测试实例，避免本地多实例调试互相覆盖运行目录和状态（bd73f2e）
• 补充 bug report、tool loop stop reason、结构化工具 envelope、schema/routing repair、Skill 读取、profile cache、LLM 错误分类、obsycli token 统计和手动测试脚本相关测试（7e073a1、57fb449、bd73f2e）

v0.1.7(2026/06/10)¶

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

新加功能¶

• obsycli 新增 /save 命令，可将 Agent 回复中携带的 internal asset 附件下载到 ~/.obsyclis/attachments/，并在有可保存附件时给出提示（01d75d9）
• obsycli 支持在对话流中直接展示 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 标题自动生成能力，obsycli 创建未命名 task 时可由 Agent 根据首条用户消息生成标题（6b5618a）

问题修复¶

• 修复 obsycli 在部分 LLM 回合中 working 状态过早消失的问题，发送成功且存在 message UUID 的普通消息都会持续跟踪运行状态（01d75d9）
• 修复 obsycli 错误提示和工具输出展示不稳定的问题，统一用户可见错误格式，并保留完整单行工具输出，避免关键错误被截断隐藏（01d75d9）
• 修复 beak-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）

功能优化¶

• 优化 beak-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 和 obsycli 展示，强化直接回答 repair、结构化交互事件、历史回放、plan 状态恢复和 tool output 紧凑渲染（c55f653）
• 优化 obsycli task 创建和列表体验，/newtask 支持自定义 task 名称，未命名 task 可走自动标题流程（6b5618a）
• 拆分 Agent Service 和 obsycli 运行态代码，补充附件保存、Task Insight、Skill 依赖安装、GTrace/OTEL、Plan Mode 和 session title 相关测试（316ecf2、c4be7f0、01d75d9、6b5618a）

v0.1.6(2026/06/03)¶

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

新加功能¶

• obsycli 新增 /close <number|task_id> 命令，支持关闭当前或指定 task，关闭后 task 进入 closing/completed 流程，避免继续发送新消息（4efd12a）
• Agent 新增 session_summary 事件，task 关闭时会生成会话总结并由服务端完成 session 状态流转（4efd12a）
• Agent 新增 agent_runtime_result 事件，obsycli 可展示 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）
• 优化 obsycli Plan Mode 展示，隐藏中间 plan_execution_progress 噪音，避免结构化内容和文本内容重复渲染，并在 plan event 到达时正确结束当前 working 状态（845d571、713593e）
• 优化 Agent Prompt 和 Prompt Builder 中的 Plan Mode 规则，补充新的 interaction action、文本输入字段和 session context 约束（713593e）
• 整理文档目录和 Plan Mode Web UI 契约，补充 /close、session_summary、agent_runtime_result 和 plan interaction schema 说明（845d571、713593e、4efd12a）
• 补充 Plan Mode、session 关闭、runtime result、history replay、WSS status update 和 obsycli /close 相关测试（845d571、713593e、4efd12a）

v0.1.5(2026/06/01)¶

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

新加功能¶

• 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）
• obsycli 新增 /plan、/plan-approve、/plan-reject、/plan-revise、/plan-interrupt 命令，并支持展示 plan 状态和结构化交互内容（c69d29c、d65661d）
• obsycli 新增 /permission-full 和 /permission-standard 命令，用于在 CLI 中切换当前 task 的 permission mode（d65661d）

问题修复¶

• 修复 obsycli /tasks 和 /attach 未限定 CLI 创建任务的问题，避免 CLI 误 attach 到非 obsycli 创建的 session（29faa63）
• 修复 obsycli 启动参数中未知子命令未及时报错的问题，避免错误命令被静默忽略（5d9f923）
• 修复 obsycli 近期历史消息读取对部分响应结构不兼容的问题，补充 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）
• 优化 obsycli 输入体验，支持 slash command 模糊匹配、高亮、Ctrl+L 清屏、双击 Esc 取消、统一命令历史和更简洁的启动提示（26edc7a、c69d29c）
• 优化 Agent 工具执行链路，抽象 composite tool executor 和 execution plan，统一处理 tool policy、schema validation、approval、repair 和真实执行决策（fcf17e3、c69d29c）
• 补充 MCP Client、Plan Mode、obsycli plan/permission、profile sync、工具执行和审批流程相关测试（41d0018、fcf17e3、14aad95、c69d29c、d65661d）

v0.1.4(2026/05/27)¶

本次发布主要聚焦 Agent Prompt 精简、obsycli 历史消息展示稳定性和 obsycli 代码结构拆分，主要有如下更新：

问题修复¶

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

功能优化¶

• 精简 Agent core prompt 中与工具描述重复的规则，改为由各 tool schema/description 承载路径范围、必填参数和使用条件，降低默认系统提示词体积（6e05c87）
• 强化 exec 工具说明，明确 exec 是直接程序执行，shell 语法、重定向、管道、变量展开、glob、循环和条件语句应使用 bash（6e05c87）
• 拆分 obsycli 大型 chat.go，按 startup、stream、agent event、state、session、render、tool/approval 等职责拆成多个文件，降低维护成本（6e05c87）
• 补充 obsycli stream 历史 message 抑制、agent event 日志记录、Prompt 构建和 exec 工具描述相关测试（6e05c87）

v0.1.3(2026/05/26)¶

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

新加功能¶

• 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）
• beak-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）

功能优化¶

• 优化 obsycli 的 thinking 和工具调用展示，长 reasoning、工具说明和输出预览会折叠截断，降低终端噪音（823c0bb）
• 优化 Prompt 规则，最终回复语言按原始用户任务判断，并避免泄露 runtime bookkeeping、repair prompt、tool protocol 等内部信息（823c0bb）
• 优化 Task Insight 提交流程，允许在任务过程中多次提交阶段性事实、动作、假设和结论，并使用运行时时间生成时间戳（5a1e699）
• 调整手动升级入口，文档中推荐直接使用 beak-agent-updater 触发 latest 或指定版本升级（5a1e699）
• 补充 Agent UI schema script、安装升级、工具调用事件、reasoning 展示和 Task Insight 相关测试（c2cb6e6、823c0bb、5a1e699）

v0.1.2(2026/05/25)¶

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

新加功能¶

• Agent 新增工具调用可视化能力，在 CLI 中展示工具调用原因、批量执行状态、输出预览，并支持通过 Ctrl+T 切换完整工具输出（4bd18ed）
• Agent 新增 Prompt Cache 支持，按稳定前缀、半稳定前缀和动态后缀拆分系统提示词，并为 OpenAI 兼容 Provider 增加显式缓存块传递能力（c9274e7）
• query_session_events 工具新增按需查询最近用户对话和工具执行历史的能力，减少默认注入上下文的体积（c9274e7）
• obsycli 会话页新增任务、Agent、输入/输出/缓存 Token 和剩余上下文状态展示（c9274e7）
• 新增 Agent Prompt 结构与示例文档，说明缓存分层、动态上下文和工具调用约定（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）
• 补充自托管安装脚本测试、Prompt 构建测试、工具调用可视化测试和配置 API 测试（4bd18ed、92e776d、c9274e7）