OpenGeodex

常见问题：看图、语音与客户端 ​

杀毒软件拦截或误删了文件 ​

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，我们会尽快帮你处理。

看图窗口没有显示数据 ​

确认数据文件存在且格式受支持，可以让智能体先用 GDAL 检查文件，再加载到看图窗口。看图窗口打不开或白屏、底图列表为空等问题，见看图窗口：运行要求与常见问题。

语音输入没有反应 ​

到「设置 → 语音」确认识别方式：本地要求运行时和模型都显示已就绪；火山引擎要求 API Key 正确、识别服务已开通且「模型与计费」与开通的一致。再确认系统已允许 OpenGeodex 使用麦克风。

按麦克风时出现的提示：

  • “无法使用麦克风：请在 Windows 设置 > 隐私和安全性 > 麦克风 中打开…”：打开 Windows「设置 → 隐私和安全性 → 麦克风」，打开「麦克风访问权限」和「允许桌面应用访问麦克风」，然后重试；
  • “没有检测到可用的麦克风”：连接麦克风或耳机后重试，并在 Windows 声音设置里确认输入设备；
  • “麦克风无法打开：可能被其他程序占用或被系统禁用”：关掉正在使用麦克风的会议、录音软件，或在 Windows 声音设置里启用该设备。

提示“当前版本已停止支持” ​

旧版本不再兼容服务端时，启动后会提示需要更新到新版本，只能「更新」或「退出」。点「更新」下载安装即可。

提示“账号已在其他设备登录，本设备已切换为免费版” ​

同时登录的设备数超过会员方案的上限，最久未使用的设备会被下线。需要多台电脑同时使用时，可以升级到支持更多设备的方案，见账号与登录。

关闭窗口后程序还在运行 ​

这是正常的：关闭按钮只把窗口收到系统托盘，任务会继续执行。要彻底退出，右键托盘图标选择「退出」。