v0.4.11

GenericAgent-Admin v0.4.11

消息引导修复版

本次汇总 v0.4.10 之后的 5 项提交，修复 Chat 消息引导的显示和交互问题。

发布日期：2026-11-02　·　更新范围：v0.4.10 → v0.4.11

---

🐛 问题修复

• 引导到达时不再丢失本轮用户消息：回复进行中收到流式引导事件时，当前这一轮的用户原话会保留在会话里。
• 引导文案与实际行为一致：队列说明和引导按钮提示改为“作为引导插入当前任务（不中断，下次模型调用时接收）”，不再写“中止/暂停当前回复”。补了英文文案。
• 引导等待接收时锁定队列项：后端在队列查询和增删改的响应里返回 guiding_ids。前端据此禁用正在等待接收的那一条的编辑和删除按钮，引导按钮显示“等待接收”。之前按钮可以点，但点了只会收到 409 报错。引导被接收后，后端通知前端刷新队列，按钮恢复可用。

🧪 测试

• 补充了队列锁定状态的前端回归测试，更新了队列相关的源码契约断言。
• 删除了 chat_loop_test.go 中一个未使用的 io 导入。这个导入是之前就有的，它导致 internal/api 测试无法编译。

已知限制：会话首屏数据不带等待接收状态，要等打开会话后的第一次队列同步完成才会显示锁定。

---

📥 Downloads

Platform	Architecture	Binary	Portable Bundle
Windows	x86-64	ga-admin-windows-amd64.exe	ga-admin-portable-windows-amd64-v0.4.11.zip
	ARM64	ga-admin-windows-arm64.exe	ga-admin-portable-windows-arm64-v0.4.11.zip
Linux	x86-64	ga-admin-linux-amd64	ga-admin-portable-linux-amd64-v0.4.11.tar.gz
	ARM64	ga-admin-linux-arm64	ga-admin-portable-linux-arm64-v0.4.11.tar.gz
macOS	x86-64 (Intel)	ga-admin.app	Not available
	ARM64 (Apple Silicon)	ga-admin.app	ga-admin-portable-darwin-arm64-v0.4.11.tar.gz

Binary: Single executable archive on Windows/Linux and a Finder-ready .app archive on macOS; requires Python 3.8+ and GenericAgent source code on your system.
Portable Bundle: Complete standalone package with GA source code + Python 3.12.7 + venv, ready to run after extraction.

---

📝 Changelog

Changes since v0.4.10:

• test(api): drop unused io import in chat loop tests (3cbf47a)
• test(chat): cover pending guidance queue locks (d0f882a)
• fix(chat): lock queue items while guidance awaits acknowledgment (3e7c8d3)
• fix(chat): describe queue guidance as non-interrupting (f7f0ac9)
• fix(chat): keep run user message when streamed guide arrives (ff5975b)

v0.4.10

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

查看完整版本差异

v0.4.9

Assets are being uploaded...

v0.4.8

GenericAgent-Admin v0.4.8

会话编辑重发与历史恢复修复版

本次更新重点修复会话编辑重发后上下文错位、工具调用历史恢复报错，以及正式版与同版本预览版的更新排序问题。

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

---

✨ 本次亮点

• 重发不再误切上下文：识别真正的用户消息，排除工具回传与工作记忆注入，并同步保留重发位置之前的前情摘要。
• 恢复历史更稳健：清理无效工具调用标识、兼容缺失配对的工具结果，避免后续请求因工具历史异常返回 HTTP 400。
• 更新版本排序正确：相同版本号下，正式版优先于预览版。

📦 下载与安装

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

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

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

macOS 命令行下载与包类型说明

• macOS amd64 命令行普通包：下载 · SHA-256

• macOS arm64 命令行普通包：下载 · SHA-256

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

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

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

📝 更新内容

新增功能

无新增功能，本次为稳定性修复。

体验优化

• 更新检查正确区分同版本的正式发行与预览发行，避免将预览版排在正式版之前。

问题修复

• 修复编辑重发将工具结果或 WORKING MEMORY 注入误识别为用户消息，导致原始历史裁剪错位的问题。
• 对长会话已压缩掉的用户消息采用保守边界处理；前情摘要按用户轮同步截断，清除被丢弃分支的工作状态，避免携带未来信息。
• 修复恢复工具历史时空标识、孤立工具结果及未配对工具调用引发的请求错误（#22）。

🔧 升级提示

• 建议从 v0.4.7 及更早版本更新，尤其是经常使用编辑重发和长会话恢复的用户。
• 更新需替换发布包并重启 Admin；本次 GitHub 发布不会自动更新或重启你的现有实例。
• 本次包含自带 cmd/chat_worker.py 的修复，请使用同一版本发布包内的主程序和 worker 脚本。

🧪 验证与已知限制

• 本地 Go 全量测试与构建通过，覆盖重发、对话分支及版本模块；新增定向回归覆盖工具续轮误匹配、压缩窗口边界与摘要截断。

• Python worker 协议测试 52 项通过，无跳过。

• GitHub Actions 六平台普通构建、五平台便携包及最终发布流程全部通过；各平台执行前端 verify。

• 尚未通过真实模型完整验收编辑重发链路；生产会话副本只读模拟和协议测试不等同于真实模型端到端验证。

• 不保证修复已损坏的旧会话数据，也不会自动恢复此前已丢失的历史内容。

• Intel Mac 暂不提供便携包，可选择对应的普通包或 .app 应用。

---

展开完整提交记录（3 项）

• 31a85cc：修复重发历史截断，跳过 GA 工具续轮并保留前情上下文。
• 9005aeb：恢复历史时修复孤立及空标识工具块（#22）。
• dbce905：同版本下将正式发行排在预览发行之前。

查看完整版本差异

v0.4.7

GenericAgent-Admin v0.4.7

Conductor 提示词重写、可选看图工具与聊天页性能优化

重写 Conductor 主控提示词并修复回执与失败原因问题，新增可在设置中开启的看图工具，聊天页按需加载 KaTeX 并预压缩静态资源，同时完成前后端结构拆分。

发布日期：2026-10-23　·　更新范围：v0.4.6 → v0.4.7

---

✨ 本次亮点

• 新增可选的 view_image 看图工具：模型可在执行过程中查看截图等图片；主模型支持看图时直接注入，不支持时转交设置中配置的视觉模型。默认关闭。
• Conductor 主控提示词整篇重写，长度由约 5KB 精简到约 3.1KB；同一目标的后续工作复用原 worker，新增的独立需求另开 worker，子任务卡住时先在原 worker 上收窄交付物。
• 修复 Conductor 回执读取失败与失败原因丢失问题。
• KaTeX 运行时与样式改为按需加载；静态资源提供构建时生成的 Brotli 预压缩文件。

📦 下载与安装

如何选择？ 首次使用可选择自带运行环境的「便携包」；已有运行环境可选择「普通包」。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 命令行下载与包类型说明

• macOS amd64 命令行普通包 · SHA-256

• macOS arm64 命令行普通包 · SHA-256

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

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

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

📝 更新内容

新增功能

• 设置中新增看图工具开关及视觉模型配置；开启后模型可调用 view_image 查看图片，主模型不支持看图时自动转交视觉模型。

体验优化

• Conductor 主控提示词仅保留角色、边界、复用、审查与交付规则，审查、进度、取消等细则交由工具说明和回执承载。
• conductor_dispatch 说明明确：仅在继续、纠正或验证同一 worker 的原有任务时传入 session_id。
• 子任务卡住时优先在原 worker 上给出收窄后的具体指令，仍卡住才拆分或改派，不再原样重发。
• 聊天页 KaTeX 运行时和样式仅在出现公式时加载。
• assets 目录静态资源在构建完成后生成 Brotli 预压缩文件，浏览器支持时直接返回；index 保持动态主题注入。
• Markdown 分块解析结果有界缓存复用，减少重复解析。
• 后端 chat.go 按职责拆分为 12 个文件，前端 ChatApp 拆出多个组件与工具模块，style.css 移除被覆盖的重复声明；以上均为结构调整，不改变行为。

问题修复

• 修复 Conductor 失败原因截断后丢失末尾错误信息的问题。
• 修复 Conductor 回执在原子替换期间被拒绝读取导致失败的问题，并在读取后删除回执文件。
• 修复草稿附件写入 localStorage 超出配额的问题，附件改为存放在 localStorage 之外。
• 停止跟踪编译生成的 chat worker 字节码文件。

🔧 升级提示

• 看图工具默认关闭，需在设置中手动开启并配置视觉模型。
• 按需下载对应平台附件升级；本次未部署或重启任何现有服务。

🧪 验证与已知限制

• 前端 verify（lint、lib 测试、构建）及 Go 全量测试在 preview.1 阶段通过；最终提交推送前的 Go 全量测试中仅 1 项在清理临时目录时失败，单独重跑 3 次均通过，判断为偶发；Conductor 相关 Python 测试通过。
• Conductor 提示词经模拟场景 A/B 对比（每组 6–8 次）：卡住时复用原 worker 7/8，新增需求另开 worker 8/8，同一目标后续复用 8/8；样本较小，危险操作场景未用最终版重测。
• 看图工具曾用 deepseek-v4.1-flash 实测直接注入与转交两种模式。
• 未部署到任何目标服务，未完成真实多模型 Conductor 端到端、弱网传输及手机真机验收。

---

展开完整提交记录（54 项）

• Conductor: narrow stalled corrections on the original worker before reassigning (0e4658b)
• Rewrite Conductor parent prompt to a minimal A/B-tested version (f5f6917)
• feat(chat): add opt-in view_image tool with vision model fallback (ac5c706)
• fix(conductor): keep failure cause in worker error reason (3a169ae)
• fix(conductor): delete broker replies after reading (f56c63b)
• fix(conductor): retry broker replies denied during atomic replace (8fe9543)
• perf(web): serve build-time Brotli asset sidecars (a1e176e)
• perf(chat): load KaTeX runtime and styles on demand (8040f4b)
• refactor(api): move chat uploads out of chat.go (275b88c)
• refactor(api): move chat title generation out of chat.go (b0a296e)
• refactor(api): move chat session storage out of chat.go (4806405)
• refactor(api): move chat worker process out of chat.go (25addac)
• refactor(api): move chat LLM catalog out of chat.go (07f7e82)
• refactor(api): move chat streaming out of chat.go (200a523)
• refactor(api): move chat run state out of chat.go (ffcf688)
• refactor(api): move chat project mode out of chat.go (fa77031)
• refactor(api): move chat event parsing out of chat.go (ce9e8a1)
• refactor(api): move chat run worker out of chat.go (bda56fd)
• refactor(api): move chat one-shot workers out of chat.go (d5fcc21)
• refactor(api): move chat settings out of chat.go (05e14d7)
• refactor(styles): remove shadowed alignment and protect CSS fallbacks (8d781c6)
• refactor(styles): merge adjacent equivalent selector blocks (5333e2f)
• refactor(styles): reuse semantic tokens in model palette (185e46b)
• refactor(styles): isolate model workbench preserving cascade order (2282103)
• perf(chat): reuse bounded immutable markdown block parses (b73a673)
• refactor(web): extract assistant content, turn and usage row from ChatApp (8fd4478)
• refactor(web): extract file summary, goal status and command result cards from ChatApp (9f2bba3)
• refactor(web): extract keychain dialog and plan todo card from ChatApp (e28fff4)
• refactor(web): extract worldline views from ChatApp (a7e9879)
• refactor(web): extract composer controls from ChatApp (0a8b95b)
• refactor(web): extract UltraPlan views from ChatApp (bfcead7)
• refactor(web): extract markdown block components from ChatApp (22acde4)
• refactor(web): extract JsonTree from ChatApp (28eec2f)
• refactor(web): extract ToolResultDetails from ChatApp (4d1a811)
• refactor(web): extract tool call block components from ChatApp (ee69e4a)
• refactor(web): extract CopyButton from ChatApp (19648ee)
• refactor(web): extract inline markdown components from ChatApp (aca67e7)
• refactor(web): extract subagent output parser from ChatApp (33d6b48)
• refactor(web): extract serialized mermaid renderer from ChatApp (af68629)
• refactor(web): extract user message attachment text helpers from ChatApp (051a0ab)
• refactor(web): extract worldline command helpers from ChatApp (1a3bdb9)
• refactor(web): extract goal card state helpers from ChatApp (8bd33f8)
• refactor(web): extract upload file helpers from ChatApp (7865a47)
• refactor(web): extract markdown part preparation from ChatApp (f250349)
• refactor(web): extract session and model label helpers from ChatApp (12e1d9f)
• refactor(web): extract viewport and follow-scroll constants from ChatApp (6011c3b)
• refactor(web): extract builtin slash command helpers from ChatApp (0ee703e)
• refactor(web): extract usage and elapsed-time stats from ChatApp (80c44e9)
• refactor(web): extract UltraPlan state helpers from ChatApp (0150073)
• refactor(web): extract tool argument parsing from ChatApp (950dfc6)
• refactor(web): extract chat formatting helpers from ChatApp (8d9cb66)
• refactor(web): drop 846 overridden declarations from style.css (0ceb11d)
• chore: stop tracking compiled chat worker bytecode (df5c658)
• fix(chat): persist draft attachments outside localStorage quota (86a02e8)

查看完整版本差异

v0.4.7-preview.2

GenericAgent-Admin v0.4.7-preview.2

可选看图工具与 Conductor 提示词精简预览

新增可在设置中开启的看图工具，并重写 Conductor 主控提示词，使派发、复用与卡住处理更明确。本版本为预览版，不替代 v0.4.6 正式版。

发布日期：2026-10-23　·　更新范围：v0.4.7-preview.1 → v0.4.7-preview.2

---

✨ 本次亮点

• 新增可选的 view_image 看图工具：模型可在执行过程中查看截图等图片；主模型支持看图时直接注入，不支持时转交设置中配置的视觉模型。默认关闭。
• Conductor 主控提示词整篇重写，长度由约 5KB 精简到约 3.1KB；同一目标的后续工作复用原 worker，新增的独立需求另开 worker。
• 子任务卡住时，先在原 worker 上收窄到缺失的交付物，仍卡住才拆分或改派。

📦 下载与安装

如何选择？ 首次使用可选择自带运行环境的「便携包」；已有运行环境可选择「普通包」。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 命令行下载与包类型说明

• macOS amd64 命令行普通包 · SHA-256

• macOS arm64 命令行普通包 · SHA-256

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

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

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

📝 更新内容

新增功能

• 设置中新增看图工具开关及视觉模型配置；开启后模型可调用 view_image 查看图片，主模型不支持看图时自动转交视觉模型。

体验优化

• Conductor 主控提示词仅保留角色、边界、复用、审查与交付规则，审查、进度、取消等细则交由工具说明和回执承载。
• conductor_dispatch 说明明确：仅在继续、纠正或验证同一 worker 的原有任务时传入 session_id。
• 子任务卡住时优先在原 worker 上给出收窄后的具体指令，不再原样重发。

问题修复

本次无独立问题修复。

🔧 升级提示

• 本版本为预览版（prerelease），不会被标记为最新正式版；如需稳定版本请继续使用 v0.4.6。
• 看图工具默认关闭，需在设置中手动开启并配置视觉模型。
• 按需下载对应平台附件升级；本次未部署或重启任何现有服务。

🧪 验证与已知限制

• 发布前 Go 全量测试中仅 1 项在测试结束清理临时目录时失败，单独重跑 3 次均通过，判断为偶发；Conductor 相关 Python 测试通过。
• Conductor 提示词经模拟场景 A/B 对比（每组 6–8 次）：卡住时复用原 worker 7/8，新增需求另开 worker 8/8，同一目标后续复用 8/8；样本较小，危险操作场景未用最终版重测。
• 看图工具曾用 deepseek-v4.1-flash 实测直接注入与转交两种模式。
• 未部署到任何目标服务，未完成真实多模型 Conductor 端到端及手机真机验收。

---

展开完整提交记录（3 项）

• Conductor: narrow stalled corrections on the original worker before reassigning (0e4658b)
• Rewrite Conductor parent prompt to a minimal A/B-tested version (f5f6917)
• feat(chat): add opt-in view_image tool with vision model fallback (ac5c706)

查看完整版本差异

v0.4.7-preview.1

GenericAgent-Admin v0.4.7-preview.1

Conductor 稳定性与聊天页性能预览

修复 Conductor 回执读取与失败原因丢失问题，聊天页按需加载 KaTeX 并预压缩静态资源，同时完成大规模结构拆分。本版本为预览版，不替代 v0.4.6 正式版。

发布日期：2026-10-23　·　更新范围：v0.4.6 → v0.4.7-preview.1

---

✨ 本次亮点

• Conductor 子任务失败时，失败原因保留真正的错误标记（如「生成中断」）或异常行，不再只截取前 4096 字的正文。
• Conductor 回执在 Windows 原子替换期间被拒绝访问时自动重试，读取后即删除，避免回执文件堆积。
• KaTeX 运行时与样式改为按需加载；静态资源提供构建时生成的 Brotli 预压缩文件。

📦 下载与安装

如何选择？ 首次使用可选择自带运行环境的「便携包」；已有运行环境可选择「普通包」。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 命令行下载与包类型说明

• macOS amd64 命令行普通包 · SHA-256

• macOS arm64 命令行普通包 · SHA-256

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

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

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

📝 更新内容

新增功能

本次为修复与性能预览版本，无新增业务功能。

体验优化

• 聊天页 KaTeX 运行时和样式仅在出现公式时加载。
• assets 目录静态资源在构建完成后生成 Brotli 预压缩文件，浏览器支持时直接返回；index 保持动态主题注入。
• Markdown 分块解析结果有界缓存复用，减少重复解析。
• 后端 chat.go 按职责拆分为 12 个文件，前端 ChatApp 拆出多个组件与工具模块，style.css 移除被覆盖的重复声明；以上均为结构调整，不改变行为。

问题修复

• 修复 Conductor 失败原因截断后丢失末尾错误信息的问题。
• 修复 Conductor 回执在原子替换期间被拒绝读取导致失败的问题，并在读取后删除回执文件。
• 修复草稿附件写入 localStorage 超出配额的问题，附件改为存放在 localStorage 之外。
• 停止跟踪编译生成的 chat worker 字节码文件。

🔧 升级提示

• 本版本为预览版（prerelease），不会被标记为最新正式版；如需稳定版本请继续使用 v0.4.6。
• 按需下载对应平台附件升级；本次未部署或重启任何现有服务。

🧪 验证与已知限制

• 发布前前端 verify（lint、lib 测试、构建）通过；Go 全量测试（go test -p 1 ./...）通过。

• 发布工作流全部成功：六平台普通包、五种便携包及 SHA-256 校验文件共 26 个附件。

• Conductor 失败原因修复依据代码中的错误消息格式与单元测试，尚未用真实失败现场的 outcome 文件对照验证。

• 未部署到任何目标服务，未完成真实多模型 Conductor 端到端、弱网传输及手机真机验收。

---

展开完整提交记录（51 项）

• fix(conductor): keep failure cause in worker error reason (3a169ae)
• fix(conductor): delete broker replies after reading (f56c63b)
• fix(conductor): retry broker replies denied during atomic replace (8fe9543)
• perf(web): serve build-time Brotli asset sidecars (a1e176e)
• perf(chat): load KaTeX runtime and styles on demand (8040f4b)
• refactor(api): move chat uploads out of chat.go (275b88c)
• refactor(api): move chat title generation out of chat.go (b0a296e)
• refactor(api): move chat session storage out of chat.go (4806405)
• refactor(api): move chat worker process out of chat.go (25addac)
• refactor(api): move chat LLM catalog out of chat.go (07f7e82)
• refactor(api): move chat streaming out of chat.go (200a523)
• refactor(api): move chat run state out of chat.go (ffcf688)
• refactor(api): move chat project mode out of chat.go (fa77031)
• refactor(api): move chat event parsing out of chat.go (ce9e8a1)
• refactor(api): move chat run worker out of chat.go (bda56fd)
• refactor(api): move chat one-shot workers out of chat.go (d5fcc21)
• refactor(api): move chat settings out of chat.go (05e14d7)
• refactor(styles): remove shadowed alignment and protect CSS fallbacks (8d781c6)
• refactor(styles): merge adjacent equivalent selector blocks (5333e2f)
• refactor(styles): reuse semantic tokens in model palette (185e46b)
• refactor(styles): isolate model workbench preserving cascade order (2282103)
• perf(chat): reuse bounded immutable markdown block parses (b73a673)
• refactor(web): extract assistant content, turn and usage row from ChatApp (8fd4478)
• refactor(web): extract file summary, goal status and command result cards from ChatApp (9f2bba3)
• refactor(web): extract keychain dialog and plan todo card from ChatApp (e28fff4)
• refactor(web): extract worldline views from ChatApp (a7e9879)
• refactor(web): extract composer controls from ChatApp (0a8b95b)
• refactor(web): extract UltraPlan views from ChatApp (bfcead7)
• refactor(web): extract markdown block components from ChatApp (22acde4)
• refactor(web): extract JsonTree from ChatApp (28eec2f)
• refactor(web): extract ToolResultDetails from ChatApp (4d1a811)
• refactor(web): extract tool call block components from ChatApp (ee69e4a)
• refactor(web): extract CopyButton from ChatApp (19648ee)
• refactor(web): extract inline markdown components from ChatApp (aca67e7)
• refactor(web): extract subagent output parser from ChatApp (33d6b48)
• refactor(web): extract serialized mermaid renderer from ChatApp (af68629)
• refactor(web): extract user message attachment text helpers from ChatApp (051a0ab)
• refactor(web): extract worldline command helpers from ChatApp (1a3bdb9)
• refactor(web): extract goal card state helpers from ChatApp (8bd33f8)
• refactor(web): extract upload file helpers from ChatApp (7865a47)
• refactor(web): extract markdown part preparation from ChatApp (f250349)
• refactor(web): extract session and model label helpers from ChatApp (12e1d9f)
• refactor(web): extract viewport and follow-scroll constants from ChatApp (6011c3b)
• refactor(web): extract builtin slash command helpers from ChatApp (0ee703e)
• refactor(web): extract usage and elapsed-time stats from ChatApp (80c44e9)
• refactor(web): extract UltraPlan state helpers from ChatApp (0150073)
• refactor(web): extract tool argument parsing from ChatApp (950dfc6)
• refactor(web): extract chat formatting helpers from ChatApp (8d9cb66)
• refactor(web): drop 846 overridden declarations from style.css (0ceb11d)
• chore: stop tracking compiled chat worker bytecode (df5c658)
• fix(chat): persist draft attachments outside localStorage quota (86a02e8)

查看完整版本差异

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 命令行下载与包类型说明

• macOS amd64 命令行普通包 · SHA-256

• macOS arm64 命令行普通包 · SHA-256

• 普通包：需自行配置 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 秒。该数据为新版本单次测量，不是新旧版本对照或完整聊天页耗时。

• 尚未部署到目标远端服务，未完成目标远端认证访问和弱网端到端验收；不能据此承诺会话列表慢已彻底解决。

• 三主题图标加载与布局检查通过，截图视觉复核及手机真机验收尚未完成。

---

展开完整提交记录（3 项）

• fix(web): serve lightweight browser and brand icons (aa1e798)
• fix(web): bundle MiSans fonts as content-hashed assets (3480961)
• fix(static): revalidate root assets with ETags instead of full redownloads (6d0b1bd)

查看完整版本差异

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 项）

• 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

查看完整版本差异

GenericAgent-Admin v0.4.4

GenericAgent-Admin v0.4.4

指挥家调度可控 · 多图发送与侧栏体验修复

本次版本集中发布六项已提交更新：让指挥家看清并调整本父会话的调度上限，子会话标题与当前任务目标一致，并修复侧栏显示数量、多图发送及相册选择入口。

发布日期：2026-10-14　·　更新范围：v0.4.3 → v0.4.4

---

✨ 本次亮点

• 指挥家调度更透明：可以查询调度上限、排队与运行状态、请求计数，并调整本父会话的上限。
• 子会话标题跟随目标：新建和复用任务时更新标题，保留会话历史与当前派发内的手动改名。
• 多图发送更稳、选择更直接：限制图片预览负载，避免图片进入后续历史重复发送，新增独立的多选照片入口。
• 侧栏数量设置真正生效：修复自定义版块配置只显示若干项却仍展示过多条目的问题。

📦 下载与安装

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

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

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

macOS 命令行下载与包类型说明

• x64 / Intel：命令行包 · SHA-256

• ARM64 / Apple Silicon：命令行包 · SHA-256

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

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

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

📝 更新内容

新增功能

• 新增指挥家父会话级调度上限控制，作用于本父会话，不改全局设置或其他父会话。
• 聊天输入区新增独立照片选择入口，支持多选，保留原附件入口。

体验优化

• 指挥家调度概览补充上限与请求计数，帮助区分任务并发和模型请求状态。
• 子会话标题采用当前派发目标；复用不清空历史，旧数据与列表缓存同步归一。

问题修复

• 修复侧栏自定义版块显示数量未按配置生效的问题。
• 修复多图负载与历史重复携带图片可能导致后续消息发送失败的问题；对预览负载做有界处理。
• 修复移动端附件入口缺少专用照片选择方式的问题。
• 避免迟到的 AI 自动标题覆盖子会话任务目标标题；当前派发内用户手动改名仍保留。

🔧 升级提示

• 建议先备份配置和会话数据，再替换对应平台安装包；本次无需手动修改数据格式。
• 更新后需重启应用及其对应聊天 worker，使常驻进程加载本版代码；仅刷新浏览器不足以加载 Python worker 改动。
• 调整指挥家上限仅影响本父会话；不会通过降低上限取消已经运行的任务。
• 子会话在新的派发或复用开始时会采用新目标标题；旧目标标题不代表当前任务。

🧪 验证与已知限制

• 发布源码对应提交已通过 Go 全量测试、Go 构建及前端 npm run verify（lint、lib 测试、构建）。

• 发布前补验 Python 协议 51 项、Conductor 37 项、图片安装集成 3 项，共 91 项通过；Conductor 真实 GA 出站构造覆盖已启用，无跳过。该覆盖使用假模型／协议夹具，不等同于生产模型端到端验收。

• 子会话标题来源标签在当前 React 页面配合模拟 API 的浅色／深色／暖色 × 桌面／390px 六组检查通过，无页面异常或横向溢出。

• GitHub Actions 六个平台普通包构建、五组便携包构建与发布收尾全部成功；13个软件包及其SHA-256校验文件共26个附件已上传，校验文件与GitHub附件摘要一致。

• 浏览器照片选择能力取决于系统和浏览器；未将桌面浏览器窄屏测试当作手机真机相册验收。

• 整页截图已保存，但本次独立视觉服务两次超时，未完成独立视觉复核。

• 发布不等于部署：本次未更新或重启现有生产服务。

---

展开完整提交记录（6 项）

• fbaf002fa1d945b34279eba0844c9b6f8561ac73 fix(sidebar): honor configured section display counts
• a852ed9ed750d9e5b3168171eb53111642863d9f fix(chat): bound image previews and keep vision out of history
• a3eda6a1556cda0226263ab2bcffba4fae9ee680 fix(chat): add dedicated multi-photo picker to composer
• a4e0b6eda90871f20f1ec03ee8dd8068d9778eec fix(conductor): expose scheduler limits and request counts
• 565f2f0432df82316c5b29b58c150c0384cdad64 feat(conductor): allow per-parent scheduler limit control
• c0e7d9e243ceb802f6ff310008a10cfcc8e66306 fix(conductor): keep worker titles aligned with current objective

查看完整版本差异