常见问题：杀毒软件拦截

OpenGeodex 自带 GDAL、Python 等数据处理工具，智能体做任务时会调用它们、运行脚本。部分杀毒软件（如 Windows 安全中心、360、火绒）对这类行为比较敏感，偶尔会把正常文件误判为风险。这通常不影响电脑安全，按下面的方法处理即可，不需要关闭杀毒软件。

常见表现

• 安装时提示“Windows 已保护你的电脑”，或安装包被拦下；
• 客户端打不开，或打开后很快退出；
• 插件提示“插件文件不完整，已停用”，或工具调用、运行脚本时反复失败；
• 杀毒软件弹窗询问是否允许 OpenGeodex 的某个程序运行。

怎么处理

1. 确认来源：只使用从官网 https://www.opengeodex.com 下载的安装包。来源不明的安装包请不要放行；
2. 弹窗询问时选“允许”：如果杀毒软件弹窗提示的是 OpenGeodex 目录下的程序，选择“允许”或“信任”，必要时勾选“记住我的选择”；
3. 从隔离区恢复：文件已被删除时，打开杀毒软件的“隔离区”或“保护历史记录”，找到 OpenGeodex 相关的文件，选择“恢复”并“添加信任”；
4. 把目录加入信任列表：在杀毒软件的“信任区”“白名单”或“排除项”里添加下面两个文件夹，以后就不会再被误删：
   • 程序安装目录，默认是 %LOCALAPPDATA%\Programs\OpenGeodex（安装时改过位置的，以实际位置为准）；
   • 数据目录 %LOCALAPPDATA%\OpenGeodex，扩展插件和 Python 运行环境放在这里；
5. 补回缺失的文件：恢复不了时，扩展插件到「设置 → 插件 → 插件市场」重新安装；内置插件或客户端本身有问题，重新运行安装包覆盖安装即可，会话、配置和数据都保留在数据目录里，不会丢失。

安装时提示“Windows 已保护你的电脑”

确认安装包来自官网后，点「更多信息」再点「仍要运行」即可继续安装。

仍然解决不了

处理后仍然打不开或反复被拦，可以把「设置 → 运行诊断」页面和杀毒软件提示的截图发邮件到 opengeodex@zealmap.com，我们会尽快帮你处理。