AgentDock v0.8.2 重点完善 ACP 与 Skill 使用体验、MCP / OAuth 兼容性和跨平台运行稳定性;同时继续收敛 Runtime 与工具契约边界,让 AgentDock 在 macOS、Windows、Linux / NixOS 和 ChatGPT 集成场景下更易配置、更稳定。
重点更新
ACP、Skill 与使用体验
- ACP 新增通用
customAdapter 配置,macOS / Windows 均可显式配置 Adapter 绝对路径和参数;未知 Agent 不再回退到 Codex,禁用 ACP 时仍会保留 Custom 配置。(#49) - 新增内置
agentdock-user-guide官方用户指南 Skill,覆盖 macOS、Windows、Linux、Docker、直接运行二进制、ChatGPT 工具 Schema 缓存刷新、NexusDock、AgentDock Skills 与文档仓库等常用配置和生效方式。(#58) - 用户指南补充 Coding Agent / ACP 专项说明,区分 Codex、Claude、Grok Provider CLI 与 ACP Adapter,并给出发现本机 Agent、补齐 Adapter、配置与验证的完整流程。(#63)
agentdock_context新增低优先级 Common Skills 索引,可读取~/.agents/skills中的通用 Skill;同名时始终优先 AgentDock 自有 Skill,并在 Context MCP Apps UI 中区分AgentDock Skills与Common Skills。(#60, #62)
MCP、OAuth 与命令环境
- 新增“启用 MCP Apps UI”开关并默认启用;关闭后只移除 Apps UI 资源和 UI metadata,不影响 MCP 工具本身执行。(#54)
- OAuth Authorization Server / Protected Resource Metadata 端点补齐
HEAD支持,修复部分客户端因探测方式不同而误判 AgentDock 未实现 OAuth 的问题。(#55, #51) exec_command支持通过AGENTDOCK_COMMAND_ENV_FROM_ENV_JSON显式映射宿主环境变量,在保持默认精简环境隔离的同时解决 NixOS /nix-ld等依赖宿主运行时变量的场景。(#50, #43)
Windows、macOS 与运行稳定性
- 修复 Windows 官方 Setup 启动长期 Runtime 时继承 Inno Setup
RedirectionGuard的问题,避免安装后命令进程访问 NTFS Junction 等路径受到错误限制。(#44, #42) - 修复 macOS Quick Tunnel 在公网 Origin 尚未生成时提前启用 OAuth 导致 Core 健康检查失败的问题,并补充 Tunnel 进程缺失时的自愈启动。(#56)
- 修复 Windows Quick Tunnel regenerate 时从追加日志开头读取并复用旧
trycloudflare.com地址的问题;新一轮启动只解析本轮新增日志,并兼容日志轮转 / 替换。(#61) - 后台日志统一增加
10 MiB × 5文件轮转策略;macOS、Windows、OpenRC 的 Core / Tunnel 和 Docker Compose 均限制日志增长,systemd 继续使用 journald。(#59)
Runtime 与工具契约
- 继续把 Runtime、文件、命令、浏览器、Recall、Task、MCP 等能力收敛到各自强类型 Service / Contract,减少重复 schema、delegate 和运行时万能入口,让工具契约拥有更明确的单一事实源。(#45, #46, #48)
- 完善文件工具的
.gitignore匹配语义和覆盖测试,提升仓库遍历、搜索与文件列表对真实 Git ignore 规则的兼容性。(#47)
贡献者
感谢 @weieast1314 贡献 macOS Quick Tunnel OAuth 启动时序修复。(#56)
下载与校验
所有发布文件都提供对应 .sha256 校验文件,可用于手动确认下载内容完整。
容器镜像会同步发布到 GHCR 与 Docker Hub,并由 Release workflow 实际拉取启动验证。
完整变更
下载 AgentDock
请选择与你设备对应的安装包,点击即可直接下载。
| 你的设备 | 直接下载 |
|---|---|
| Windows 电脑(绝大多数 Intel / AMD 电脑) | 下载 Windows 安装包 |
| Windows ARM 电脑(例如 Snapdragon X 系列) | 下载 Windows ARM 安装包 |
| Mac(Apple 芯片或 Intel 都可以) | 下载 macOS 安装包 |
Windows 和 macOS 用户建议直接使用上面的安装包。下方 Assets 里的其他 .zip、.tar.gz 文件主要用于便携运行、自动化部署等高级场景;.sha256 文件用于手动校验下载文件完整性。
Linux 用户请使用命令行脚本进行安装,Docker 用户请使用 AgentDock 容器镜像。