Repository navigation
v0.4.6
GenericAgent-Admin v0.4.6
弱网静态资源优化
减少刷新时重复传输的静态资源，并显著缩小网页图标。
发布日期：2026-10-21 · 更新范围：v0.4.5 → v0.4.6
✨ 本次亮点
- 静态资源支持 ETag 条件请求，未变化时返回 304。
- MiSans 字体使用内容哈希地址，支持长期缓存与版本更新失效。
- 网页 PNG 图标由 525797 字节减至 13691 字节，ICO 由 110452 字节减至 5189 字节。
📦 下载与安装
如何选择？ 首次使用可选择自带运行环境的「便携包」；已有运行环境可选择「普通包」。macOS 桌面用户请选择
.app应用，通过 Finder 启动。
| 系统 | 芯片架构 | 普通包 / 桌面应用 | 便携包 |
|---|---|---|---|
| Windows | amd64 | 普通包 · SHA-256 | 便携包 · SHA-256 |
| Windows | arm64 | 普通包 · SHA-256 | 便携包 · SHA-256 |
| Linux | amd64 | 普通包 · SHA-256 | 便携包 · SHA-256 |
| Linux | arm64 | 普通包 · SHA-256 | 便携包 · SHA-256 |
| macOS | amd64 | .app 应用 · SHA-256 | 暂不提供 |
| macOS | arm64 | .app 应用 · SHA-256 | 便携包 · SHA-256 |
每个下载入口旁均提供 SHA-256 校验文件；不提供的组合明确标注「暂不提供」。
macOS 命令行下载与包类型说明
-
普通包：需自行配置 Python 与 GenericAgent 源码等运行环境。
-
便携包：包含 GenericAgent 源码及 Python 运行环境，解压后按包内说明启动。
-
macOS 应用：解压后通过 Finder 打开
ga-admin.app，不要直接运行应用包内部的可执行文件。
📝 更新内容
新增功能
本次为性能优化版本，无新增业务功能。
体验优化
- 56 个 MiSans 字体分片纳入 Vite 内容哈希资源管线。
- 页面品牌图标与 PNG favicon 改用 128px 轻量资源；保留高清原图，不修改原生平台图标。
问题修复
- 修复根路径静态资源缺少 ETag 条件缓存而重复完整下载的问题。
🔧 升级提示
- 按需下载对应平台附件升级；本次未部署或重启现有服务。
- 字体地址切换后首次访问需要建立新缓存，后续访问可复用缓存。
🧪 验证与已知限制
-
前端 verify、图标生成与引用回归通过；Go 全量测试及构建通过。
-
六平台普通包、五种便携包及发布工作流全部成功。
-
隔离实例模拟 200KiB/s、80ms 延迟：首次配置页冷开 9.80 秒、缓存后刷新 1.68 秒。该数据为新版本单次测量，不是新旧版本对照或完整聊天页耗时。
-
尚未部署到目标远端服务，未完成目标远端认证访问和弱网端到端验收；不能据此承诺会话列表慢已彻底解决。
-
三主题图标加载与布局检查通过，截图视觉复核及手机真机验收尚未完成。