把聊天面板接到 QGIS 工具，能让操作者用自然语言发起缓冲、叠加、统计或图层处理，却也让一次含糊的请求可能变成多步数据写入。QGIS-OC-CHAT 是一个将 QGIS 插件与 OpenCode 侧车服务结合的原型，明确把规划、人工确认、验证、快照和回滚列为架构模块。它的价值不在于替代 QGIS 操作员，而在于说明聊天入口应怎样被约束为可复查的动作计划。

可核查事实

  • QGIS-OC-CHAT 被项目 README 定义为面向 OpenCode 支持 GIS 工作流的 QGIS 插件和侧车原型。

  • 项目将 MCP-QGIS 定位为 MCP/QGIS 桥接和工具接口，QGIS-OC-CHAT 则探索聊天插件、OpenCode 式规划、人工确认、RAG 上下文与安全 GIS 工具执行。

  • 仓库包含 QGIS 插件脚手架 plugin/qgischat/、侧车服务模块 sidecar/qgischat/，以及 OpenCode 客户端和 CLI 集成点。

  • README 列出工具分发、规划、验证、快照、回滚、人机协同确认和 RAG 模块。

  • 仓库还提供单元、集成、SLO 和人工端到端测试脚手架，以及 release/ 中的发布清单和校验和。

  • 项目状态被明确标注为 MVP/RC 阶段，可用于审查架构与测试，不能表述成成熟的 QGIS 插件。

  • README 给出本地构建插件、侧车和发布包的脚本，并以 python -m pytest 运行测试；GitHub 页面列出 v0.1.0-rc 发布于 2026 年 6 月 8 日。

  • 项目安全说明要求对私有或生产 GIS 数据先审查动作计划和快照行为，并以人工确认和回滚导向的执行作为设计原则。

核心机制：聊天只生成计划，执行必须经过明确闸门

插件面板负责承接用户意图，侧车服务负责连接 OpenCode、检索上下文和派发工具；二者分开后，计划与实际执行之间就可以插入验证和确认。项目把工具分发、规划、验证、快照、回滚和人机协同列为独立模块，说明一个可用的 GIS 助手至少要能回答：准备运行什么工具、输入和输出是什么、会改动哪些图层、失败时如何恢复。

在生产中，应让模型只能生成结构化行动计划，而非直接调用任意脚本。每个计划应显示目标图层、数据范围、坐标参考系、工具参数、预期输出、写入权限和风险级别；低风险的只读查询可自动执行，创建新候选层或覆盖已有数据则应要求操作者确认。

GIS 场景：用快照保护一次多步图层处理

例如，用户请求“筛出近一年新增建设用地并更新巡查图层”时，助手可以先生成步骤：选择两个时相的影像或地类层、运行变化或差分、过滤最小面积、与行政区相交、输出候选层。操作者应在界面中看到源图层版本、每一步参数、预计写入位置和受影响要素数，再决定是否执行。

执行开始前，对会被改动的项目、图层或数据库事务建立快照；每个步骤写入运行日志和中间产物。若拓扑检查、要素计数或空间范围校验失败，则停止后续步骤并恢复到快照。最终输出应先作为候选层，由人工审核后再合并进权威业务图层。

技术路径

  1. 将聊天请求转换为含输入、输出、CRS、工具、参数、权限和影响范围的结构化计划。

  2. 按只读、生成候选层、修改既有数据三级划分工具权限，并为后两级设置显式确认。

  3. 在写操作前建立项目或图层快照；数据库操作使用可回滚事务并记录版本号。

  4. 每一步运行后检查输出是否存在、要素数是否合理、几何是否有效、范围是否越界。

  5. 保存计划、确认人、工具版本、输入摘要、日志、中间产物和回滚结果，形成可审计运行记录。

  6. 将自动结果发布为候选图层；只有通过业务审核后才能写入权威数据资产。

检查清单

  • 用户是否能在执行前查看完整动作计划和受影响图层？

  • 每个写入动作是否具有确认、快照和可验证的回滚路径？

  • 工具权限是否将只读分析与权威数据修改分开？

  • 运行记录是否包含输入版本、参数、输出和人工确认？

  • 原型的测试、发布包和校验和是否已在目标环境独立验证？

风险边界

QGIS-OC-CHAT 的 README 明确将项目定位为 MVP/RC 阶段，仓库结构和测试脚手架不等于已通过真实生产环境验证。侧车、RAG 或 MCP 桥接也不会自动限制模型对敏感数据的解释、导出和误用。

快照与回滚只覆盖事先纳入范围的状态，外部服务调用、不可逆发布、权限错误或已被其他用户覆盖的数据都可能无法恢复。生产部署仍需最小权限、隔离环境、备份恢复演练、审计留存和有责任主体的人工审批。

资料依据

本文依据 QGIS-OC-CHAT 项目 README 撰写。项目定位、MCP-QGIS 关系、插件与侧车目录、OpenCode 集成、规划/验证/快照/回滚/HITL/RAG 模块、测试、MVP/RC 状态、构建命令、发布和安全说明均来自一手仓库说明；执行闸门和审计步骤为 GIS 生产建议。

结论

聊天面板可以降低 GIS 自动化的操作门槛，但不应缩短审批与核查链路。把计划、确认、快照、验证和回滚放在插件与侧车之间，才能让自然语言成为可控的 GIS 操作入口。