Repository navigation
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)