Skip to content

v0.4.5

Choose a tag to compare

@github-actions github-actions released this 18 Oct 15:39
· 70 commits to main since this release

GenericAgent-Admin v0.4.5

会话读取与认证开销优化

本次更新集中减少会话扫描、管理员认证和用量账本的重复开销,同时修复历史执行过程的提前下载、图片草稿保留与指挥家会话编辑重发问题。

发布日期:2026-10-18 · 更新范围:v0.4.4 → v0.4.5


✨ 本次亮点

  • 减少重复读写:列表、启动标题补全、Loop 恢复及 Hub 桥接列表复用会话摘要索引;用量未变时不再重写账本。
  • 降低认证开销:已验证的管理员凭据可复用进程内校验缓存,避免每次请求重复执行昂贵的密码派生。
  • 按需加载更彻底:历史执行过程不会再因展开偏好而提前下载,仍可点击展开读取完整内容。
  • 交互与进度更可靠:图片附件纳入会话草稿;指挥家进度返回更可读的近期公开步骤,编辑重发不再把内部完成回执当成用户轮次。

📦 下载与安装

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

系统 芯片架构 普通包 / 桌面应用 便携包
Windows amd64 普通包 ZIP / SHA-256 便携包 / SHA-256
Windows arm64 普通包 ZIP / SHA-256 便携包 / SHA-256
Linux amd64 普通包 ZIP / SHA-256 便携包 / SHA-256
Linux arm64 普通包 ZIP / SHA-256 便携包 / SHA-256
macOS amd64 .app / SHA-256 暂不提供
macOS arm64 .app / SHA-256 便携包 / SHA-256

所有下载入口均附带 SHA-256 校验文件;不提供的组合明确标注「暂不提供」。

macOS 命令行下载与包类型说明
  • amd64: 命令行普通包 ZIP / SHA-256

  • arm64: 命令行普通包 ZIP / SHA-256

  • 普通包:需自行配置 Python 与 GenericAgent 源码等运行环境。

  • 便携包:包含 GenericAgent 源码及 Python 运行环境,解压后按包内说明启动。

  • macOS 应用:解压后通过 Finder 打开 ga-admin.app,不要直接运行应用包内部的可执行文件。

  • Intel Mac:本次提供 Intel 原生桌面应用及命令行普通包,暂不提供 Intel 便携包。

📝 更新内容

体验优化

  • 管理员认证:为最近成功验证的凭据维护绑定当前密码哈希的进程内校验缓存,并复用密码派生的 HMAC 状态,减少重复认证计算。
  • Hub 桥接列表:从会话摘要索引读取桥接会话,不再为列出会话逐一重解析完整正文。
  • 启动扫描:标题补全候选与 Loop 恢复复用摘要索引,保持原有标题候选判定;Loop 恢复仅重读启用 Loop 的会话正文。
  • 用量账本:仅在新增记录或标题、模型、归一后的 Token / Other 用量实际变化时落盘;保留历史零值修正与世界线裁剪前已记录用量。
  • 指挥家进度:按需查询可返回近期公开步骤、摘要与正文片段、快照更新时间及缺失原因,便于区分正在执行、尚无公开步骤和快照不可用。

问题修复

  • 无效会话缓存:按文件尺寸和纳秒修改时间缓存无法解码的会话 JSON,避免重复解析和索引重写;文件变化后重新尝试,读取或权限等瞬态错误不进入负缓存。
  • 历史执行过程:修复关闭「自动收起」后提前请求历史执行过程完整正文的问题;惰性历史默认保持按需读取,实时运行和手动展开行为保留。
  • 图片草稿:图片附件随会话草稿保存与恢复,支持只有图片、没有文字的草稿,减少切换会话或刷新时丢失待发送图片的情况。
  • 指挥家编辑重发:内部完成回执不再参与用户轮次计数或文本匹配,避免错误裁剪对话边界;裁剪点之前的回执原文仍保留。

🔧 升级提示

  • 更新前建议备份现有配置与会话数据,并选择与系统、芯片架构一致的包。
  • 图片草稿保存在当前浏览器的本地存储中,不会跨浏览器同步;可用空间不足或存储不可用时,持久化仍可能失败,重要图片请保留原文件。
  • 本次操作仅发布新版本,不会自动升级或重启现有部署;下载完成后按原有更新流程操作。

🧪 验证与已知限制

  • 本地前端 npm run verify 通过:ESLint、523 项 lib 测试及生产构建。
  • 本地 go test ./... -count=1 -timeout=180s 与 go build ./... 通过;相关回归覆盖缓存失效、冷暖启动摘要复用、Loop 恢复幂等及账本重复调用后的文件字节和修改时间不变。
  • GitHub Actions:6个系统/架构普通包、5个便携包及发布收尾均成功;26项附件(含 SHA-256 校验文件)已齐全。查看构建记录。
  • 上述结果不等于生产环境 CPU 收益或所有真实模型端到端行为已验收;本次未部署、未重启生产。
  • 指挥家返回的步骤和进度属于执行者公开活动,不代表修复已完成或验收成功;暂无更新也不能单独证明任务卡死。

展开完整提交记录(9 项)
  • 86f5ba2 fix(usage): skip ledger writes when recorded usage is unchanged
  • 2382e5c fix(chat): reuse session summaries for startup title and loop scans
  • 2786917 fix(chat): cache invalid session fingerprints without rewriting the summary index
  • 641b1f8 fix(hub): list bridge sessions from the summary index instead of reparsing every session
  • f194194 fix(adminauth): avoid re-deriving PBKDF2 on every authenticated request
  • a1d2015 fix(chat): persist composer image attachments in session drafts
  • 300196b fix(chat): avoid eager downloads of lazy execution history
  • b9f5d81 fix(chat): exclude conductor receipts from resend boundaries
  • 9710ef1 feat(conductor): make on-demand worker progress readable

查看完整版本差异