GIS 团队试用内置智能助手时，常把验收集中在它能否生成脚本或回答图层问题。但在 QGIS 这类桌面应用里，真正会破坏可用性的往往是响应结束后聊天仍卡住、取消一次却留下多条状态、切换任务后旧线程把内容写回新会话。AgenticGIS 0.4.2 的官方发布说明提供了一组具体的 Qt6 生命周期修复，适合把“回答正确”之外的界面与任务收尾做成可复现验收。
数据口径与可核验事实
官方 GitHub Release 标记该版本为 v0.4.2，发布时间是 2026 年 8 月 12 日，版本名明确为“Qt6 Agent Lifecycle Fixes”。发布说明称，响应后出现陈旧聊天的问题改由 QThread 的 finished 信号触发 UI 恢复；该信号即使发生 BaseException 也会触发，原先单独依赖的 finished_history 在 PyQt6 中可能丢失。
该版本还为停止处理增加两道防线：对 ESC 自动重复使用 isAutoRepeat() 守卫，并在 _on_stop 加入幂等性守卫，防止一次长按生成多个空的“Stopped”气泡。针对询问用户的卡片，发布说明指出 _OptionRow.keyPressEvent 原来用 self.window() 拿到的是 QGIS 主窗口而不是 AskUserCard，因此 ESC 未能转交 _on_cancel()；修复改为沿父对象链查找。
在工作线程切换方面，_on_event 现在借助 lambda 捕获的 worker 引用判断陈旧 worker，已切走 worker 的晚到事件会被丢弃。_on_finished 也会在 _worker is None 时拒绝结果，避免取消后的陈旧历史被保存。流式渲染计时器会在 _on_finished 显式停止，_stop_active_worker 则统一完成部分文本、标记停止并停止计时器，使其清理语义与 _on_stop 对齐。
CLI 后端同样有针对流式协议的修复：大型 tool_calls 协议 JSON 会在文本片段间缓冲，避免原始不完整 JSON 泄漏到聊天气泡；版本还抽取了共享的 _emit_tool_calls 辅助逻辑。下载文件名会识别首行机器可读 JSON，并改用干净的回退名称，避免生成 ___type___tool_calls___ 这类文件名。
核心机制
这些修复共同处理的是同一条因果链：一个用户操作启动 worker，worker 产生流式事件，用户可能停止、切换或回答交互卡片，最终 UI 和历史记录都必须只归属于当时仍有效的任务。仅靠“请求完成”不足以证明任务有效；完成信号、worker 身份、取消状态和计时器状态需要同时一致。
因此，验收中应为每次任务分配会话或 worker 标识，并把“当前 worker”作为写入聊天、地图动作和历史记录的前置条件。UI 线程只消费当前标识的事件；停止或切换时，先冻结写入，再完成可见的部分文本，停止计时器，最后清理引用。这样，网络或模型服务晚到的片段也不会覆盖已经开始的新空间分析。
GIS 应用场景与技术路径
以“让助手根据当前图层生成缓冲区分析步骤”为例，先记录图层 ID、项目文件路径、选择集、坐标参考和任务 ID。观察响应开始、流式内容、工具调用提示、完成与历史写入。随后在流式输出中连续按住 ESC，检查界面只显示一次停止状态、计时器停止，且没有把未完成内容写成可恢复的成功历史。
再立即启动第二个任务，例如请求检查另一图层的字段。故意让第一个任务的响应延迟返回，验证旧事件不会进入第二个任务的聊天区，也不会触发地图或 Processing 操作。对包含“是否执行”选项的交互卡片，分别用鼠标和 ESC 取消，确认取消到达卡片自身并且不会误作用于 QGIS 主窗口快捷键。
CLI 或外部模型后端的验收也应覆盖碎片化工具调用：把一个较大的 tool_calls JSON 故意拆分成多段，确认聊天区只在可解析后显示结构化调用，不显示半段原始 JSON。下载结果则应使用机器可读首行和普通首行各跑一次，核对回退文件名可读且不覆盖同名成果。
风险与局限
这份发布说明描述的是 AgenticGIS 0.4.2 的修复内容，不能据此推断所有 QGIS 插件、所有模型后端或后续版本都有相同行为。QThread 的完成信号和 worker 身份守卫解决的是客户端状态归属，不能代替对模型请求、文件写入或 Processing 算法的真正取消；服务端可能仍完成已经发出的操作。
地理处理具有额外的外部状态。即使旧聊天事件被丢弃，已经提交的缓存写入、导出任务或图层编辑也可能继续运行。应把探索性对话与可写操作分层：读取图层元数据可自动执行，修改项目、删除数据和启动大范围处理应显示明确目标、范围和确认记录。
检查清单
- 响应正常结束与异常结束后，聊天 UI 是否都恢复为可输入状态？
- 连续触发 ESC 时，是否只产生一次停止状态并停止流式计时器？
- 询问用户的卡片能否正确接收 ESC 取消，而不误触主窗口？
- 切换到新任务后，旧 worker 的晚到事件是否被丢弃？
- 取消任务后，是否拒绝保存陈旧结果或把它标为成功历史？
- 分片
tool_calls是否只在 JSON 完整后以结构化形式展示？ - 涉及导出、编辑或 Processing 的调用是否仍有空间范围与写入确认？
结论
AgenticGIS 0.4.2 的价值不在于增加一个炫目的 GIS 功能，而在于把线程结束、取消、事件归属和流式协议边界补齐。将这些行为纳入 QGIS 智能助手的回归清单，才能在模型回答之外，确认它不会把旧任务、残留计时器或半段工具数据带进正在进行的空间工作。
资料来源
- AgenticGIS v0.4.2 官方发布说明，2026-09-25 查阅。