Skip to content

v0.4.10

Choose a tag to compare

View all tags
@github-actions github-actions released this 27 Oct 06:31
· 5 commits to main since this release
v0.4.10
222c760

GenericAgent-Admin v0.4.10

消息引导与更新可靠性修复版

本次汇总 v0.4.8 之后的 5 项提交，调整 Chat 消息引导方式，修复队列附件传递、Linux/systemd 更新交接和镜像源版本检测，并修复此前阻塞发布构建的队列类型引用。

发布日期：2026-10-27　·　更新范围：v0.4.8 → v0.4.10

✨ 本次亮点

  • 消息引导不再靠中断重启：采用类似指挥家向子任务投递指令的安全点机制，在当前运行中接收后续要求。
  • 更新检测也使用镜像源：配置的 GitHub 镜像不仅用于下载，也参与版本检测。
  • 修复更新与附件链路：补齐 Linux/systemd 更新交接，以及队列消息恢复发送时的附件持久化和图片路径传递。

📦 下载与安装

如何选择？ 首次使用可选择自带运行环境的「便携包」；已有运行环境可选择「普通包」。macOS 桌面用户请选择 .app 应用，通过 Finder 启动。

系统 芯片架构 普通包 / 桌面应用 便携包
Windows x64 / AMD64 普通包 · SHA-256 便携包 · SHA-256
Windows ARM64 普通包 · SHA-256 便携包 · SHA-256
macOS Intel / AMD64 .app 应用 · SHA-256 暂不提供
macOS Apple Silicon / ARM64 .app 应用 · SHA-256 便携包 · SHA-256
Linux x64 / AMD64 普通包 · SHA-256 便携包 · SHA-256
Linux ARM64 普通包 · SHA-256 便携包 · SHA-256

每个下载入口旁均提供 SHA-256 校验文件；不提供的组合已明确标注「暂不提供」。

macOS 命令行下载与包类型说明
  • Intel Mac：命令行普通包 · SHA-256。
  • Apple Silicon：命令行普通包 · SHA-256。
  • 普通包：需自行配置 Python 与 GenericAgent 源码等运行环境。
  • 便携包：包含 GenericAgent 源码及 Python 运行环境，解压后按包内说明启动。
  • macOS 应用：解压后通过 Finder 打开 ga-admin.app，不要直接运行应用包内部的可执行文件。
  • 本次不提供 Intel Mac 便携包，请使用对应架构的普通包或 .app 应用。

📝 更新内容

体验优化

  • Chat 消息引导机制：在当前任务的安全点投递补充要求，不再通过取消当前运行并重新发起来实现引导；待投递队列保留到模型调用确认成功，已越过结束边界的消息继续留在队列中等待后续处理。
  • GitHub 镜像设置：版本检测读取与更新下载一致的镜像配置，设置界面的说明及保存确认文案同步更新。

问题修复

  • 队列图片与附件：修复空闲队列消息转为普通发送时的映射断点，保存附件元数据与文件引用，并将图片路径传给 worker，避免只传上传对象而遗漏模型所需的图片路径。
  • Linux/systemd 更新交接：将更新 helper 放入独立的临时服务，保留原服务身份并由原服务管理器接管启动；补充交接确认与超时处理，避免更新 helper 随原服务退出而被一同终止。
  • 发布编译：修复消息引导代码对未定义队列类型常量的引用，改为沿用现有内部完成通知类型，解除 v0.4.9 的全平台编译阻塞。

🔧 升级提示

  • 请使用 v0.4.10：v0.4.9 的发布构建失败，没有可用构建附件；其标签保留，不重写已公开版本。本版包含其全部修复及编译修正。
  • 先备份数据与配置，保留现有工作目录；本次发布不自动修改任何用户部署。
  • Linux/systemd 首次跨版本升级须特别留意：更新 helper 是从「发起更新时正在运行的程序」复制出来的，并非来自目标更新包。旧版本首次升级到本版时，仍可能使用旧更新逻辑，不能仅凭目标版本包含修复就认定本次升级已经受保护。对存在卡住问题的旧版本，建议在备份后手动替换到本版并通过原服务管理器启动；后续由本版发起的更新才具备本次新交接逻辑，实际服务权限与环境仍需核对。
  • 镜像源留空表示直连 GitHub；设置镜像后，版本检测与更新下载都会使用该配置。镜像需要同时支持 api.github.com 的版本查询和 github.com 的附件下载；仅支持附件下载的镜像不保证可用于版本检测。
  • Chat worker 与更新器均有代码变更；安装后需要启动本版程序并让相关 worker 加载新版代码，单纯刷新浏览器不等于完成升级。

🧪 验证与已知限制

  • 本次发布的 GitHub Actions 已完成六平台普通包、两种 macOS .app 应用及五种便携包的构建和上传，并完成最终发布任务。
  • 构建中的前端 verify 按现行脚本执行 ESLint、lib 测试与前端构建；不包含 UI 测试、Go 全量测试或真实模型端到端验收。
  • 发布后核对中文正文、公开正式版本状态、latest 指向，以及 13 个安装包和对应 13 个 SHA-256 附件的名称、上传状态与下载链接。
  • 未经本轮验证的范围：Linux/systemd 真实服务升级、生产模型下的消息引导与图片交互、各平台安装运行。本次发布不等于这些场景均已通过实机验收，也没有更新或重启本机生产部署。
展开完整提交记录（5 项）
  • 48064c6 — fix(chat): deliver queue guidance at Conductor-style safe points
  • 5d7483a — fix(updater): isolate systemd update helper and preserve service handoff
  • 6a30e50 — Fix queued chat attachment persistence
  • 0e1891f — Use configured GitHub mirror for update checks
  • 222c760 — fix(chat): use existing Conductor completion queue kind

查看完整版本差异

Assets 28
Loading