OWL 更新日志¶

本文档记录 OWL CLI（owl）、OWL Registry（registry）及两者共享的公共工具目录变更。

1.8.0(2026/11/04)¶

新增功能¶

• Registry 为已配置的 Studio/AIAPI 目标添加来源 IP V2 签名。HTTP API、远程 MCP 和相关子调用共用签名；每次发送及传输层重试重新生成 nonce 和签名。
• 新增 owl.field_schema.search，按关键词、类型、namespace 和 measurement 搜索当前有权限的工作空间字段配置，返回类型、单位及单位来源。支持分页，默认 100 条、最大 1000 条；保留全量 owl.field_schema.get。仅在字段未知或上下文失效时搜索，空结果不代表存储中没有数据。
• 补齐事件 offset、评论页码、基础设施和同组织链路游标、拓扑分组参数，以及 Monitor/SLO/Member 的可选分页。续页保留相同过滤条件、时间范围及权限上下文；省略新增分页字段的原有调用保持原语义。
• 笔记修改和删除支持 expected_etag，绑定读取时的版本。写入错误保留完成阶段、资源身份和恢复信息，帮助区分写入失败与写后回读失败。

问题修复与优化¶

• 来源 IP 优先取 X-Forwarded-For 第一个地址，仅在整个头缺失或为空白时回退到连接对端。非空头的首地址无效时拒绝签名，不改用后续地址。受保护目标禁止自动重定向。
• CLI、REST 和 MCP 保留上游结构化错误、DQL 诊断和写入恢复信息。CLI 改进参数帮助、组合校验和聚类查询时间预检；修正 P95 示例，补齐 LN、查询 limit、Pipeline 样本及 LLM 应用类别契约。聚类处理量不代表完整时间窗口覆盖。
• 外部 MCP 保留失败状态和多段文本的顺序与边界。修复超时、取消、stdio 进程退出、管道读取及 npx 恢复，单消息上限为 1 MiB；加强输出和 stderr 凭据脱敏。工具风险注解随发现和缓存传递，不能替代权限或审批。

升级与兼容说明¶

• 先部署支持新增契约的 Studio，再升级 Registry 并刷新工具目录：CLI 执行 owl sync，MCP 客户端重新发现工具。工具目录同步不会更新 CLI 二进制；获取新版帮助、本地校验及完整错误诊断需要升级 CLI。
• Registry 镜像自带配置默认启用签名。管理员需配置 OWL_AI_API_BASE_URL 和 OWL_AIAPI_SIGNING_SECRET_BASE64，确认 Studio 支持 V2，双方使用同一份 32 字节密钥的标准 Base64 值。缺少地址或密钥会导致启动失败。已有自定义配置需同步 aiapiSigning；省略时仍关闭。stdio 或不使用此功能的部署应显式设置 aiapiSigning.enabled: false。
• 入口网关必须正确设置并清理 X-Forwarded-For；Studio/网关独立拒绝受保护链路的缺签请求，并执行白名单、权限、时间窗口及 nonce 去重。仅升级 Owl 不代表整条保护链路已生效。
• 笔记版本冲突后重新读取并核对，不自动更换 ETag 重放；省略 expected_etag 不提供读后写保护。监控更新省略状态、告警策略及标签时保留原值，显式空列表表示清空。写入已完成而回读失败时不要重复创建；发送状态未知时先核实。

1.7.0(2026/10/28)¶

新增功能¶

• 新增 owl.catalog.entity_create、owl.catalog.entity_modify 和团队查询 owl.workspace.member.group_list；目录查询支持名称、URN 及属性筛选。
• CLI 新增 runtime-profile/v1，由执行器按用户注入独立 Profile 和凭据，凭据不写入配置。
• 新增 owl.data.read_dql_docs，按搜索返回的工具引用在 Registry 分页读取 DQL 文档正文。

问题修复与优化¶

• DQL 校验保留原始查询、解析或绑定诊断及可用的行列信息，并区分查询错误与校验器不可用。
• 限制 CLI 命令日志请求头长度，避免较长内联参数导致传输失败；业务参数仍通过完整请求体传输。
• 基础设施过滤移除上游不支持的 like，支持 =、!=、in。

升级与兼容说明¶

• 配套升级 CLI 和 Registry 后执行 owl sync，MCP 客户端重新发现工具。目录写入依赖配套 AIAPI / Backend，使用方法见目录实体创建与修改。
• 读取 DQL 文档时使用返回的 read_reference，不要在 Agent 本机读取 references_dir。启用运行时 Profile 的配套顺序为 Owl → Agent 完整发行包 → 重装启用用户模式；回滚前先关闭用户模式并重装。

1.6.1(2026/10/23)¶

安全修复¶

• CLI、标准及 UOS Registry 构建工具链升级至 Go 1.27.3，修复 crypto/x509 的 CVE-2026-111943，拒绝信任公告列出的不可信中间证书。源码构建需要 Go 1.27.3 或更高版本。

1.6.0(2026/10/21)¶

新增功能¶

• owl.event.resolve：按事件文档 ID、事件或故障 ID、链接解析事件详情。
• owl.account.workspace.same_org.list：新增 CLI 工具入口，发现同组织 Trace 查询的候选工作空间。

问题修复与优化¶

• CLI、HTTP 与 MCP 统一参数和时间范围校验，并加固基础设施过滤条件、工作空间分页及事件详情参数校验。owl exec -f json 预检失败会返回结构化 JSON 和非零退出码。
• owl sync 在任一分类下载失败时返回失败，保留失败分类原有缓存和本地版本。首次自动同步失败会阻止后续执行；缓存过期后的自动同步失败仍按原有行为警告并使用已有缓存。

升级与兼容说明¶

• 配套升级 CLI 与 Registry 后运行 owl sync，MCP 客户端重新发现工具。owl.event.get 继续使用列表返回的原始 doc_id；事件 ID、故障 ID 或链接使用 owl.event.resolve。
• v1.6.0 统一校验 13 位整数毫秒时间戳，要求结束时间大于开始时间。需要成对提供的参数不能只传一端；必填要求与最大跨度以各工具 schema 为准。owl.data.query 的时间范围最长为 7 天。
• owl.data.query 的 DQL 可以省略内联时间窗口，由 start_time / end_time 提供查询窗口。内联绝对窗口必须与外部窗口一致，相对窗口会被拒绝。PromQL 范围选择器表示回看时长，不作为查询窗口，也不进入 DQL 校验。Registry 需要可用的 dqlcheck；校验不可用时不会执行 DQL 查询。请求窗口不等同于后端实际执行或结果覆盖的时间范围。

1.5.0(2026/10/14)¶

OWL CLI 新增功能¶

• CLI 新增独立 Profile 管理与账号切换能力：可通过 owl profile add/list/current/rename/remove 保存和管理多套完整配置，通过 owl switch、--profile 或 OWL_PROFILE 持久或临时选择配置。每个命名 Profile 独立保存配置、凭据、缓存、数据和日志。（#21）
• CLI 新增 Bash 与 PowerShell 离线补全，可提示命令、Profile 别名、分类、工具名、工具参数及 schema 枚举值。补全只读取当前 Profile 的本地缓存，不联网，也不执行工具。（#24）

OWL CLI 问题修复与优化¶

• 加固 Bash 补全候选匹配，schema 中的 shell 特殊字符、空格或 URL 均按字面值处理。（#24）
• 修复 owl profile remove --purge 清理失败时可能先移除配置和凭据的问题；失败后可修正权限并重试。（#21）

OWL Registry 与公共工具目录¶

• 新增 owl.external_datasource.list 与 owl.external_datasource.query，用于发现当前空间可访问的外部数据源，并使用列表返回的 datasource_uuid 执行单条受限只读 SQL。（#13）
• Registry 日志会完整遮蔽 sql、rows 和嵌套 arguments 等敏感字段。（#13）
• owl.metric.list、owl.rum.list、owl.apm.list、owl.network.list、owl.profile.list、owl.logging.list、owl.billing.list 以及 owl.infrastructure.list/get 现在要求传入 13 位毫秒级 start_time 和 end_time，时间窗口最长 7 天。（#25）
• owl.llm.list 的时间范围仍为可选；同时省略 start_time 和 end_time 时查询最近 24 小时。（#25）
• DQL 查询工具的 dql_namespace / namespace schema 补充完整枚举和常用数据类型映射；owl.data.show_dql_namespace 提供完整类型含义，并明确其返回的 dql_namespace 值在 owl.data.query 中仍使用同名字段，在 simple query 与日志聚类工具中应原样传给 namespace。现有字段名和请求转发行为保持不变。

升级与兼容说明¶

• 未选择 Profile 时继续使用原 ${OWL_DIR}/config.yaml；根配置保留为 default，不会自动搬迁。CLI 的 --conf 已弃用，建议导入配置后改用 --profile。Registry 服务的 --config 不受影响。（#21）
• 升级 Registry 或公共目录后运行 owl sync。调用上述 discovery 和 infrastructure 工具时必须显式传入时间范围；owl.llm.list 可以继续省略时间范围。（#25）

1.4.0(2026/09/23)¶

新增功能¶

• 新增授权跨空间数据查询：通过 owl.workspace.data_authorized.list 发现授权空间，再向 DQL 工具传入 workspace_uuids 和 target_region。本空间查询无需发现空间，同组织跨空间 Trace 继续使用独立工具。
• 新增 workspace 分类，包含授权空间列表和 owl.workspace.member.list；旧名 owl.member.list 保留为调用别名，CLI 与 MCP 均复用新工具的参数和权限校验。
• 新增 owl.incident.get，按故障 UUID 获取详情及分页关联事件引用，再通过 owl.event.get 读取事件内容。

问题修复与优化¶

• 修复历史 testing-<SHA> 构建无法通过 owl update 升级的问题；Linux/macOS 与 Windows 安装器均支持迁移到当前配置通道的正式版本，保留原有配置及 SHA256 校验。普通版本继续只升不降，同版本跳过安装，无法识别的版本仍会报错。（#226）
• CLI 与 MCP 保留 AIAPI 错误诊断字段及 trace ID，便于定位跨空间查询失败原因。
• 参数预检支持 JSON Schema 联合类型，并保留各类型分支的约束校验。
• 静态 MCP 工具补充 OpenAI 元数据，并修复 OAuth Bearer token 向上游转发的问题。

升级要求¶

• 先确认目标站点已部署配套 AIAPI，包括 /api/v1/workspace/data_authorized/list、跨空间查询契约及 /api/v1/incident/get。
• 配套升级 CLI 与 Registry 程序，然后运行 owl sync 全量刷新目录；MCP 客户端重新发现工具。旧版 CLI 不支持别名，仅同步目录无法保证旧命令可用。
• 旧 member 分类移除；授权空间发现统一使用 owl.workspace.data_authorized.list。详见迁移说明。

1.3.0(2026/08/26)¶

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

新加功能¶

• CLI 新增全局 --conf 参数，可显式选择配置文件；配置展示和写入会跟随所选文件。
• CLI 新增 registry.insecure_skip_verify 和 registry.request_timeout 配置，用于受控开发环境及长耗时数据查询；跳过 TLS 校验默认关闭，请求超时默认 150 秒。
• Registry 新增统一 OAuth Broker 的站点路由和 token issuer/audience 校验；目标 AI API 由服务端白名单决定。
• Center MCP 可按配置直接暴露静态工具并排除指定工具；默认仍使用原有 facade 工具。
• Registry 新增 OpenAI Apps challenge endpoint；未配置 token 时保持关闭并返回 404。
• 新增 Registry 本地部署辅助流程，可配置远端 AI API 和 S3 服务。

问题修复/优化¶

• 保留 OAuth 上游的未授权响应，便于调用方正确识别凭据问题。
• owl.data.simple_query_file 的 limit 现在会在执行前校验为 1 到 10000。
• 数据查询工具超时调整为 130 秒，Registry 客户端默认超时调整为 150 秒并支持配置。
• Registry 镜像写入版本和 revision 信息，并补充发布流程回归测试，提升构建产物可追溯性。

兼容调整¶

• 原有 CLI 命令和默认配置路径保持不变；--conf 为新增入口，跳过 TLS 校验默认关闭。
• MCP 默认仍暴露 facade 工具；站点路由和 OpenAI Apps challenge 均需显式配置后启用。
• 尚未完整设计的 Agent Protocol（包括 owl agent --stdio）不包含在本次发布中。

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 修复。