Skip to content

v1.0.0

Choose a tag to compare

@github-actions github-actions released this 06 Oct 13:42
ff1a994

AgentDock v1.0.0 是第一个 1.x 正式版本。本版本在 v0.9.1 基础上完成桌面端、NexusDock Bridge、MCP、可观测性、安装更新与发布分发架构的系统性收敛,并将 Windows / macOS 更新交还给各自的平台安装器处理,为后续长期维护建立稳定边界。

重点更新

  • 重构 Windows / macOS 原生桌面控制面板、托盘菜单、连接体验与运行状态展示,减少首次渲染、导航和停止态页面闪烁,并统一启动、停止、重启、检查更新等反馈。
  • NexusDock Bridge 改用正式节点配对协议并显式声明能力;MCP 工具元数据与文件参数 Schema 按 OpenAI 审核契约收敛。
  • 新增运行分析、工具耗时、工具内部阶段耗时、OpenTelemetry Trace Context、远程运行诊断与轻量运行概览。
  • 桌面自更新架构改为“更新器负责发现、下载、完整性/签名校验,平台安装器负责安装与回滚”:Windows 使用完整 Setup,macOS 使用 whole-App 更新。
  • AgentDock 一方分发以 NexusDock R2 为 canonical distribution,公开 Stable 由 latest.json / latest/* 提供;GitHub Releases 保留正式发布说明与历史归档。
  • cloudflared 从桌面强捆绑逻辑中拆为可选组件,通过统一 Component Repository / R2 镜像解析,并保留版本、兼容范围、校验与撤销能力。
  • Release 版本改由不可变 Git Tag 作为单一事实来源;RC、Stable、容器、R2、GitHub Release 统一由同一套门禁和候选产物驱动。

Windows / macOS 原生桌面体验

Windows

  • 重构原生控制面板与连接体验,收敛启动设置、快捷方式图标、首次渲染和数据驱动页面导航闪烁。(#187, #193, #199, #201)
  • 修正 Core 运行状态判断,并加速 AgentDock 已停止时主页加载,避免把“已停止”误显示为异常。(#213, #215)
  • Setup 生命周期继续收敛:减少临时计划任务残留,升级默认保留现有设置,并将真实安装、原地升级、legacy migration、标准用户 smoke 纳入 Release 门禁。(#180)

macOS

  • 重构原生控制面板、托盘交互和后台服务生命周期,补齐标准窗口快捷键、快速隧道生命周期与更新状态反馈。(#187, #198, #202, #204, #217)
  • 更新检查与安装状态解耦,恢复状态机更加明确;当签名身份发生变化时提供诊断提示,避免把 TCC / 签名问题误判成普通运行故障。(#197, #200, #160)
  • 调整桌面图标在系统浅色背景下的可读性。(#192)

NexusDock / Bridge / MCP 能力

  • Bridge 显式声明自身能力,并改用正式 NexusDock 节点配对协议契约,减少桌面端与服务端协议漂移。(#189, #203)
  • ACP 会话、提示与卡片交互继续完善,为 Coding Agent 会话和后续人机交互提供更稳定的桌面承载。
  • MCP 工具元数据、文件参数与 OpenAI 文件 Schema 按审核契约统一,减少工具 Schema 不兼容和平台解释差异。(#184, #185, #186)

可观测性与运行诊断

  • 新增运行分析与工具耗时统计,并进一步细化到工具内部阶段耗时。(#174, #175)
  • 接入 OpenTelemetry Trace Context,便于跨调用链关联运行数据。(#176)
  • 增加远程运行诊断与轻量运行概览,在不引入重复状态模型的前提下提供更清晰的运行现场。(#178, #183)

安装、更新与分发架构

  • Unix 安装流程与 Windows 发行结构继续收敛,Windows 第三方运行时依赖由安装器统一处理。(#194)
  • AgentDock 自有分发改为 NexusDock R2 canonical distribution:桌面更新读取 latest.json,友好下载入口使用 latest/*,不可变候选资产位于 releases/<tag>/。(#195)
  • RC / Stable 使用同一套 Release 架构;正式 Stable 只有在构建、三平台 staged verification、pre-publication gate、容器验证和 R2 发布全部通过后才公开。(#205)
  • Release 版本由 Git Tag 派生,Windows ProductVersion、macOS ReleaseVersion、Go buildinfo 与容器版本统一来源,避免额外的“准备版本号”提交。(#211)
  • Windows 桌面更新下载完整 AgentDockSetup-<arch>.exe,由 Setup 负责升级、配置保留、启动项迁移与 generation 激活;macOS 更新以整个 AgentDock.app 为 opaque artifact,由保留的更新 helper 完成原子替换、恢复与回滚。
  • Release 健康验证语义统一,避免安装/更新流程因模糊健康信号产生误回滚。
  • GitHub Release Assets 收敛为人工下载所需的 5 个成品加统一 SHA256SUMS.txt,机器更新所需的 updater ZIP、Windows payload ZIP、Darwin CLI archive、安装脚本、component catalog 与单文件 .sha256 继续保留在 R2 分发契约中,而不重复暴露到 GitHub Release。

cloudflared 可选组件与 R2 canonical distribution

  • cloudflared 从桌面包强耦合中拆出为可选组件,桌面 UI 统一组件层级、安装进度和状态反馈。(#191, #216)
  • cloudflared 组件镜像与校验接入 R2,组件元数据通过长期 Component Repository 管理版本、兼容范围、状态与 SHA-256。(#218)
  • 安装器与桌面端统一 cloudflared 组件解析逻辑,减少多套下载/校验路径长期漂移。(#219)

安全 / 签名 / 发布可靠性

  • Windows 在线更新在交给 Setup 前校验 SHA-256 与 Authenticode;自签过渡场景仍要求新旧官方 AgentDock signer 一致,不接受未签名或任意自签包。
  • macOS whole-App 更新继续校验 Bundle 身份、版本与代码签名;更新器不再把 App 内部文件布局当作长期协议。
  • Release workflow 采用不可变 Tag、私有 candidate、三平台深度验收、pre-publication gate、版本化容器验证、R2 镜像和最后公开 GitHub Release 的顺序,避免失败候选提前暴露为正式版本。
  • v0.9.1 的旧 updater 通过独立 v0.9.2 compatibility bridge 迁移到新更新协议;v1.0.0 发布后 GitHub Latest 仍固定在 v0.9.2,避免旧客户端跳过桥接版本。

贡献者

感谢 @Tibbar 对 Windows Setup 临时任务生命周期收敛的贡献。(#180)

下载与校验

Windows 安装包遵循项目公开的 Code Signing Policy。

发布文件提供 SHA256SUMS.txt,可用于校验下载内容完整性。

完整变更

v0.9.1...v1.0.0

下载 AgentDock

请选择与你设备对应的安装包,点击即可直接下载。

你的设备 直接下载
Windows 电脑(绝大多数 Intel / AMD 电脑) 下载 Windows 安装包
Windows ARM 电脑(例如 Snapdragon X 系列) 下载 Windows ARM 安装包
Mac(Apple 芯片或 Intel) 下载 macOS 安装包
Linux x86_64 / amd64 下载 Linux amd64
Linux arm64 下载 Linux arm64
SHA-256 校验清单 下载 SHA256SUMS.txt

Windows 和 macOS 用户建议直接使用对应安装包;Linux 用户可使用 tar.gz 或项目提供的 latest 安装入口。