更新日志¶

1.2.1(2026/08/07)¶

本次发布属于 hotfix 修复，内容如下：

问题修复¶

• 修复 data 类型工具生成的结果文件 ID 过长的问题；新文件改用 22 位 URL-safe 随机 ID，减少长参数导致文件名和路径过长的风险，也更便于 Agent 在后续命令中引用。（#8）
• 修复 owl.data.simple_query 与 owl.data.simple_query_file 只校验参数 schema、未校验自动生成 DQL 的问题；现在会在执行前构造等价 DQL 并调用 Registry 的 DQL 校验能力，提前拦截无效的查询片段。（#7）

功能优化¶

• simple query 的生成 DQL 校验失败时返回结构化 generated_dql / dql.builderError 问题，便于 Agent 定位并修复 where_clause、select_clause、group_by_clause 等参数。（#7）

兼容调整¶

• data 文件索引格式和稳定 queryKey 保持不变，已有索引及结果文件仍可继续读取；仅新生成文件的 ID 和文件名变短。（#8）
• 合法的 simple query 调用方式和远端执行链路保持不变；仅无效 DQL 会在请求发出前更早失败。（#7）

1.2.0(2026/08/05)¶

本次发布属于功能迭代发布，主要有如下更新：

新加功能¶

• CLI 新增 owl validate、owl tool validate 与 owl capabilities，可在不执行目标工具的前提下校验参数 schema 和工具专属语法，并以结构化结果供 Agent 判断与修复。（#6）
• 新增账号工作空间与本地 profile 管理能力，包括工作空间列表、访问密钥获取、工作空间切换和当前上下文查看；profile 用于管理工作空间凭据和当前上下文，缓存与 data 文件继续使用配置的共享路径。（3da3e8e）
• 新增同组织工作空间发现，并允许数据查询通过 same_org_workspace_uuids 查询同组织的多个工作空间，可用于跨工作空间 Trace 检索。（71fa73e）
• owl exec 新增版本更新提示：CLI 会按更新通道节流检查新版本，并在 JSON 输出中以不影响既有解析的 notice 字段提示升级。（7c7113c）
• 公共工具目录新增 mdsearch 文档检索和 SLO 列表能力。（135c8ff、18f87b0）
• 公共工具目录新增 Studio Notes V2 笔记列表、新增、修改和删除能力。（a72af5f）
• 公共工具目录新增数据转发规则发现和异步查询能力。（6c37c93、c6dcd80）
• 公共工具目录新增 Dashboard 列表能力。（6c98f0b）
• 新增面向 Linux、macOS、Windows 五个平台的 OSS 自动发布链路，测试通道验证通过后可将同一构建产物提升到生产通道。（9fba8e2）

问题修复¶

• 修复 HTTP 工具上游返回客户端错误时 Registry 丢失原始状态和错误信息的问题，CLI 现在可获得更准确、可操作的失败原因。（e1267e0）
• 修复 Dashboard 大结果仍沿 text 路径返回的问题；相关工具现在使用 data 文件保存结果，避免大载荷占用 Agent 上下文。（68cac16）
• 修复数据转发查询结果仍沿 text 路径返回的问题；查询结果现在写入 data 文件。（30aa6fc）
• 修复工作空间凭据切换和展示过程中可能混淆账号信息的问题；配置输出默认隐藏密钥，只有显式请求时才展示原始 secret。（3da3e8e）
• Streamable MCP 会话现在在建立前完成认证，未授权请求不会创建会话状态。（2a5d8e9）

功能优化¶

• 统一 owl exec 与 owl validate 的参数解析和预检逻辑，支持一次返回全部参数问题；校验前会执行正常的首次使用或缓存过期自动同步，若仍返回 tool_not_found，需显式运行 owl sync 后重试。（#6）
• CLI 操作会携带稳定的 operation ID，并在 Registry 请求和上游失败之间透传追踪信息，便于跨层定位问题。（386abc0）
• 日志中的敏感 token 只保留可用于关联问题的首尾字符，中间内容保持脱敏，避免完整凭据进入日志。（6a6d0ad）

兼容调整¶

• list、show、exec、schema 等原有短命令及 tool / tools 命名空间继续保持兼容；validate 和 capabilities 为新增入口。（#6）
• 旧版 token、auth.token、workspaces.<name>.token 与 auth.token_file 配置仍可读取；新写入凭据统一使用 api-key，不会主动删除旧配置。（3da3e8e）
• owl.data.query 的 PromQL 模式不会进入 DQL 校验器；原有合法查询与 MCP 工具调用方式保持不变。（#6）

1.0.11(2026/05/25)¶

本次发布属于迭代发布，主要有如下更新：

新加功能¶

• data 分类新增 CLI-only 工具 owl.data.simple_query_file，CLI 同步最新公共工具目录后可通过 simple query 参数调用现有 simple query 后端接口，并通过既有 data 文件生命周期保存结果。
• owl.data.simple_query_file 与 MCP 工具 owl.data.simple_query 保持独立暴露面，避免大结果通过 MCP text/context 路径返回。

功能优化¶

• 补充真实 public config 回归测试，覆盖 owl.data.simple_query_file 的 CLI 可见性、MCP 不可见性、outputType: data、认证方式和参数 schema。

兼容调整¶

• 既有 MCP 工具 owl.data.simple_query 保持 outputType: text 与 MCP-only 暴露方式不变。

1.0.10(2026/05/18)¶

本次发布属于 hotfix 修复，内容如下：

问题修复¶

• 修复 registry.endpoint 配置为带尾斜杠地址时，CLI 拼接 Registry API 路径可能生成双斜杠并导致 owl sync 返回 nginx 404 的问题。
• Registry Client 现在会在构造时规范化 endpoint，http://testing-owl-api.dataflux.cn/ 与 http://testing-owl-api.dataflux.cn 可按相同 Registry 地址处理。

功能优化¶

• 补充 Registry Client 与 SyncAll 回归测试，覆盖带尾斜杠 endpoint 下的分类同步路径，避免后续 URL 拼接退化。

兼容调整¶

• 不改变用户配置格式；已有无尾斜杠 endpoint 保持原行为，带尾斜杠 endpoint 也可兼容。

1.0.9(2026/05/12)¶

本次发布属于迭代发布，主要有如下更新：

新加功能¶

• data 分类新增 owl.logging.cluster_task.create，CLI 同步最新公共工具目录后可创建异步日志聚类分析任务。
• data 分类新增 owl.logging.cluster_task.get，可通过 create 返回的 task_id 查询异步日志聚类分析结果。
• 日志聚类任务支持传入完整 query，也支持通过 namespace、conditions、timeRange、analysisField 与 indexes 让后端组装查询。

功能优化¶

• 更新 data 分类描述与版本，明确公共目录已包含日志聚类任务创建与查询能力。
• 补充 loader 与 Registry server 回归测试，覆盖日志聚类任务 schema 解析、必填参数校验和 REST 执行转发。

兼容调整¶

• 本次变更为新增工具，不改变既有 owl.logging.list、owl.data.query 或其他 data 分类工具的调用方式。

1.0.8(2026/05/07)¶

本次发布属于迭代发布，主要有如下更新：

新加功能¶

• data 分类发现链路补充 owl.logging.list 与 owl.billing.list，CLI 同步最新公共工具目录后可直接发现日志与云账单的 source / field。
• owl.metric.list 支持 mode=tag 发现指标 tag key，并支持通过 source 过滤字段或 tag 结果。
• data 结果文件名保留可读前缀并追加 UUID，避免重复查询或多 session 并发时覆盖同名文件。
• data 文件索引新增稳定 queryKey，用于识别同一查询，同时保持旧版 index.json 兼容。

问题修复¶

• 修复发现工具 schema 未声明 source 参数导致 owl exec ... --source ... 被本地参数校验拒绝的问题。
• 修复 AIAPI discovery list 返回 success:false 业务错误时，Registry REST 与 MCP HTTP 工具外层仍可能误报成功的问题。
• 修复通过安装器 --owl-dir / -OwlDir 指定自定义 Owl 目录后，后续直接运行 owl config show 仍可能回退到默认配置目录的问题。

功能优化¶

• 更新 README 与使用文档中的数据发现示例，补充 mode=field、mode=tag、owl.logging.list 与 owl.billing.list 的调用方式。
• 调整公共目录同步提示，避免公共目录命中时输出容易误解的 Scope: public catalog。
• owl data clean 默认清理 1 天前文件，--days 0 或负数按 1 天处理。
• owl data clean 只清理 index 中登记的过期文件，未登记的孤儿文件保持原行为不主动扫描删除。
• Linux/macOS 与 Windows 安装器会在安装目标旁记录 .owldir 路径，并在未使用自定义目录或卸载时清理旧记录，使 CLI 可在无 OWL_DIR 环境变量时继续定位自定义配置、缓存与数据目录。
• 增加 loader、executor、Registry REST、MCP 的 discovery schema 与业务错误回归测试。
• 补充 CLI 配置解析与安装器自定义目录回归测试，覆盖 .owldir 记录读取、config show 路径展示和安装后目录落点。

兼容调整¶

• owl exec 参数形式保持不变，仍支持 --key value、key=value、-p JSON 与 --stdin。
• 非指标 discovery 工具只允许 mode=source|field；mode=tag 仅适用于 owl.metric.list。

1.0.7(2026/04/29)¶

本次发布属于迭代发布，主要有如下更新：

新加功能¶

• CLI 新增 tool 命名空间，并保留 tools 别名；该入口作为 list、show、exec、schema 等顶层命令之外的辅助形式，提升 Agent 猜测命令形式时的容错性。
• category 新增 categories 别名，方便 Agent 按自然命令猜测方式发现分类能力。

问题修复¶

• 修复 owl help tool、owl help categories 等帮助主题无法解析的问题。
• 修复部分 --help 调用会提前触发配置初始化或 Registry 依赖的问题，帮助命令现在可以在未配置环境下直接返回。

功能优化¶

• 补充帮助主题回归测试，确认按主题查询帮助（如 owl help tool）与按命令查看帮助（如 owl tool --help）返回一致信息。
• 调整 README 中的工具查看命令示例，补充 tool 命名空间用法。

兼容调整¶

• list、show、exec、schema 等原有顶层命令仍是主要使用方式，并继续保持兼容，避免破坏既有脚本。
• 清理部分已不再发布的示例工具与 Skill 配置。

1.0.6(2026/04/28)¶

本次发布属于迭代发布，主要有如下更新：

新加功能¶

• 新增 owl update 命令，可根据安装器记录的更新通道下载并执行对应平台安装脚本。
• Linux/macOS 安装脚本新增 --upgrade，Windows 安装脚本新增 -Upgrade，用于只在远端版本更新时升级本地 CLI。
• 安装器会在配置中写入 update.base_url 与 update.channel，为后续 owl update 提供更新来源。

问题修复¶

• 修复升级时无法稳定定位既有安装路径的问题；升级流程优先读取 Owl 目录中的 binpath，再回退到 PATH 中的 owl。
• 修复本地版本不低于远端版本时仍可能覆盖安装的问题；现在会跳过二进制替换，仅刷新更新通道配置。

功能优化¶

• 安装器新增语义版本比较逻辑，升级前会读取本地 owl --version 与远端 channel version 进行比较。
• 更新流程在 Linux/macOS 下同步执行安装脚本，在 Windows 下以独立 PowerShell 进程启动安装器，降低替换正在运行二进制的风险。

1.0.5(2026/04/28)¶

本次发布属于 hotfix 修复，内容如下：

问题修复¶

• 修复 Linux/macOS 安装器在 macOS 系统自带 Bash 3.2 下执行校验和比较时报 bad substitution 的问题。
• 将 Bash 4 语法 ${var,,} 替换为 POSIX 工具链可用的 tr '[:upper:]' '[:lower:]'，保证校验和大小写归一逻辑兼容旧 Bash。

功能优化¶

• 重新构建 5 平台 CLI 包，使发布目录版本、manifest 版本与包内 owl --version 输出保持一致。
• 保留 skill.md 与 skill.en.md 两份 Skill 文档，继续支持中英文 Agent Skill 分发。

1.0.4(2026/04/27)¶

本次发布属于 installer channel 发布，主要有如下更新：

新加功能¶

• 发布 skill.en.md，补齐英文 Agent Skill 说明文件。
• 将支持临时码安装与自定义 Owl 目录的安装器支撑文件发布到 1.0.4 channel 目录。

问题修复¶

• 修复上一版生产 channel 安装脚本缺少 OWL_DIR / OwlDir 支持的问题。
• 避免在已有 1.0.3 channel 被同步缓存影响时直接覆盖同版本发布，改用新 channel 目录承载修正后的安装入口。

1.0.3(2026/04/27)¶

本次发布属于迭代发布，主要有如下更新：

新加功能¶

• 安装器新增 OWL_TEMP_CODE 支持，可根据 OWL_REGISTRY_ENDPOINT 推导 ai-api 地址，并通过 /api/v1/account/accesskey/exchange 换取真实 token。
• 新增 skill.md，为 Agent 集成场景提供随 channel 分发的 Skill 说明。

问题修复¶

• 修复 bash -c "$(curl .../install.sh)" 入口下读取 BASH_SOURCE[0] 可能失败的问题，改为带 $0 fallback 的脚本入口解析。
• 修复内联 installer helper 中出现非预期换行写法的问题，使发布版 install.sh 更接近可直接执行的自包含脚本。

功能优化¶

• 临时码换取 token 时会校验 OWL_TOKEN 与换取结果是否一致，不一致时直接中止安装。
• OWL_TEMP_CODE 请求默认绕过本机代理，降低临时凭据交换被代理配置影响的概率。

1.0.2(2026/04/24)¶

本次发布属于迭代发布，主要有如下更新：

新加功能¶

• CLI 与安装器支持自定义 Owl 工作目录：新增 OWL_DIR、--owl-dir、-OwlDir。
• 安装器支持 OWL_OWNER / --owl-owner，便于 cloud-init 或 root 安装后把配置目录交给服务用户。
• 安装完成后记录二进制路径到 Owl 目录下的 binpath，供后续升级和 Agent 运行时定位使用。

问题修复¶

• 修复安装器持久化 registry.endpoint 与 auth.token 时固定写入当前用户目录的问题；现在会写入指定的 Owl 目录。
• 修复自定义目录场景下 config show 显示目录不准确的问题。

功能优化¶

• README 增加 cloud-init / systemd 服务用户安装说明，明确 OWL_DIR 与 OWL_OWNER 的推荐用法。
• 安装脚本中的卸载提示、配置目录初始化、路径记录逻辑统一使用解析后的 Owl 目录。

1.0.1(2026/04/23)¶

本次发布属于 hotfix 修复，内容如下：

新加功能¶

• CLI 新增首次使用自动同步能力：在本地缓存为空或缓存超过 registry.sync_interval 时，list、show、exec、schema、category 等命令会自动触发 owl sync。
• 新增 sync.auto 配置项，允许关闭自动同步。

问题修复¶

• 修复 1.0.0 Linux/macOS tar 包内 owl 二进制缺少可执行权限的问题。
• 修复 owl sync 增量同步时未清理远端已删除 category 缓存的问题。
• 修复部分无 HOME 的 cloud-init / systemd / container 环境下安装脚本可能因 set -u 提前退出的问题。

功能优化¶

• 自动同步失败时区分首次同步和缓存刷新：首次同步失败会返回错误，已有缓存刷新失败时会保留旧缓存并输出 warning。
• 发布目录恢复并跟踪 1.0.0 与 1.0.1 channel 产物，补齐 installer 回归测试与 CRLF/LF 审计。

1.0.0(2026/04/13)¶

本次发布属于初始发布，主要有如下更新：

新加功能¶

• 发布 Owl CLI 首个 channel 版本，提供 Linux、macOS、Windows 共 5 个平台包。
• 提供 install.sh、install.ps1、owl-install.ps1 与 SHA256SUMS，支持远程 channel 安装、指定版本安装、本地包安装与校验和验证。
• CLI 支持初始化配置、登录写入 token、同步工具目录、查看分类、查看工具、执行工具、输出 OpenAI function schema、缓存管理与数据文件管理。

功能优化¶

• 发布目录包含 README 与 USAGE 文档，说明测试/生产通道安装、运行时配置、离线安装、卸载与常用命令。
• 构建链路支持多平台交叉编译，并通过 version manifest 记录当前版本、历史版本、发布时间、commit 与平台列表。

已知问题¶

• Linux/macOS tar 包内 owl 二进制权限为 0644，直接解压后不可执行；该问题已在 1.0.1 修复。