Repository navigation
v0.4.5
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 项)
86f5ba2fix(usage): skip ledger writes when recorded usage is unchanged2382e5cfix(chat): reuse session summaries for startup title and loop scans2786917fix(chat): cache invalid session fingerprints without rewriting the summary index641b1f8fix(hub): list bridge sessions from the summary index instead of reparsing every sessionf194194fix(adminauth): avoid re-deriving PBKDF2 on every authenticated requesta1d2015fix(chat): persist composer image attachments in session drafts300196bfix(chat): avoid eager downloads of lazy execution historyb9f5d81fix(chat): exclude conductor receipts from resend boundaries9710ef1feat(conductor): make on-demand worker progress readable