Skip to content

desktop-v0.1.2

Pre-release
Pre-release

Choose a tag to compare

@devilcoolyue devilcoolyue released this 04 Oct 08:06

Agentbox 首次公开提供 Windows/macOS 桌面客户端,沿用现有网页版的视觉风格与操作习惯,可连接现有 Linux 服务端使用持久化工作空间。本次同时包含 0.1.2 的工作空间状态刷新修复。

这是未签名测试版(Pre-release),桌面版本与服务端版本独立。 Mac 使用 ad-hoc 签名,尚无 Apple Developer ID 签名与公证;Windows 尚无 Authenticode 签名,安装或首次打开可能出现系统信任提示。本版通过下载安装包手动安装/升级,应用内自动更新未启用。

下载与安装

系统 安装包
macOS · Apple 芯片(M 系列) Agentbox-0.1.2-macos-arm64.dmg
macOS · Intel Agentbox-0.1.2-macos-intel.dmg
Windows · x64 Agentbox-0.1.2-windows-x64.exe

Mac 打开 DMG,将 Agentbox 拖入“应用程序”;Windows 运行 EXE,按当前用户安装。升级前先退出旧客户端。安装后填写 Agentbox 服务端地址,以已有账号登录。最终用户无需安装 Node、Rust 或 Go;Windows 安装包内含 WebView2 离线安装程序。

附件中的 SHA256SUMS 用于核对下载文件;provenance.json 记录源码、CI 与原始构建产物来源。第三方许可证已随应用打包,附件另提供 THIRD_PARTY_NOTICES.txt。

本次新增

  • 桌面工作台:Windows x64、Mac Intel、Mac ARM64 独立客户端,系统凭证库保存登录、空间搜索与切换、连接诊断。
  • 终端:支持旧服务端共享终端、网络断开后的重连、输出搜索、复制粘贴、暂存输入、字号与右键菜单;新版服务端支持独立 AI/Shell 多标签,切换空间保留项目终端连接。
  • 文件与附件:工作区/共享目录浏览,手动上传和下载,系统文件选择、文件拖放与粘贴、截图/图片粘贴上传,上传前确认目标与内容。
  • 项目与同步:新版服务端支持配对登录、逻辑项目与本地目录映射;支持双向或单向同步预览、逐文件冲突处理和持续同步。
  • 恢复与维护:同步历史分页、容量查看、恢复副本导出与清理、异常批次核对;对结果不确定的写入暂停处理,防止重复执行。
  • 统一界面:复用网页版 Agentbox 标识、线性图标与琥珀强调色,提供深浅主题、跟随系统外观、80%~200% 整体缩放与紧凑窗口布局。

0.1.2 修复

修复“终端已经连接,顶部和侧栏仍显示已停止”的旧状态问题。终端连接变化、窗口重新获焦时重新核对服务端状态,窗口可见期间每 5 秒刷新;并发刷新合并并补读,退出登录后丢弃旧账号结果。刷新保留已有终端连接,断开终端也不会直接把工作空间判定为停止。

服务端兼容与使用范围

  • 连接 v0.1.8 时可使用基础登录、空间列表、共享终端和手动文件传输。配套服务端 v0.1.9 已发布,升级服务器并重新登录客户端后,可使用桌面配对、逻辑项目、独立多终端及同步恢复扩展;入口按服务端通告能力显示。
  • 同步默认关闭。支持同步的新版服务端需由管理员明确设置 desktop_sync_enabled=true,客户端重新登录后才显示对应入口。恢复查看与清理按独立能力显示。
  • 手动上传单批、单附件各限 19 MiB;手动下载和同步单文件限 64 MiB。macOS 同步目录需位于可核验的内置固定磁盘。
  • 桌面安装包与服务端分别发布。服务端正式版现为 v0.1.9;安装客户端不会自动升级服务器或打开同步。服务端升级将 schema 9 迁移至 10,升级前请保留兼容备份。

验证与已知限制

发布包来自源码 96149c57625734d1337f73b5265d6070891585a9,对应 GitHub Actions 构建与验收。三平台正常安装包的安装/诊断探针,以及独立测试构建的原生登录、终端和状态刷新检查均通过;同时通过冻结旧服务端/网页/abox-link 兼容、Windows→WSL2 Linux 同步和 Linux 磁盘满/进程终止恢复测试。前端 59 项测试通过。

macOS 包最低版本配置为 12.0,但当前原生自动化环境是 macOS 15;Windows 自动化环境为托管 Windows Server 2025。最低系统版本、实体设备的 Finder/Explorer 手势、系统中文输入法、多屏/DPI、实际休眠恢复,以及真正缺少 WebView2 的离线 Windows 尚需人工验收。正式签名、公证和正式签名包的应用内升级另行发布,本版不作为已完成这些验收的稳定版。

客户端使用与开发说明 · 开发与验收记录