Skip to content

故障排查 ​

先确认软件版本、完整解压和小地图框选,再按错误信息定位。

Capture region is outside the virtual desktop bounds ​

原因:保存的截图区域不在当前 Windows 虚拟桌面的物理像素范围内,常见于更换显示器、缩放比例、主屏幕或窗口模式。

处理:

  1. 停止追踪。
  2. 将鼠标移到游戏所在显示器。
  3. 使用“框选截图范围”重新框选完整小地图。
  4. 打开预览确认画面。
  5. 重新启动追踪;运行中重新框选时客户端会重启服务。

仍失败时删除 runtime/settings_override.json,重启客户端后重新配置。不要复制其他玩家的区域坐标。

service.exe 缺失或无法启动 ​

在 Windows v0.10.6 的解压目录内检查 sift-map-tracker/service/service.exe。如果缺失,检查安全软件隔离记录,并从官方渠道重新获取完整包。

SIFT 缓存无法生成 ​

按弹窗提示检查可用内存和系统盘剩余空间,并确认当前 Windows 账户可以写入 %LOCALAPPDATA%\SiftMapTracker\sift-cache。如暂时无法生成,可取消并在释放空间后重新启动追踪。已经确认的框选区域会保留。也可以调整游戏显示尺寸后重新框选,短边在 164–256 像素时会使用包内缓存。

服务被应用控制策略阻止 ​

如果日志显示“应用程序控制策略已阻止此文件”,说明 Windows、单位策略或安全软件阻止了 service.exe。确认包体来源后,在系统安全策略中允许该文件或联系设备管理员。客户端无法绕过组织策略。

35 ms 后指针不更新 ​

将刷新间隔恢复为 50 ms 或 60 ms,保存并重启追踪。35 ms 不会让 SIFT 识别更快,反而会增加帧合并、图片解码和 UI 调度压力。

草地、雪地或海面无法定位 ​

这是图像特征不足导致的算法限制,不一定是配置错误。移动到道路、建筑、岸线附近,保持小地图无遮挡,并参考定位风险图。

资源文件加载慢 ​

首次或失效缓存需要后台生成完整 PNG。等待缓存完成;不要连续切换大资源文件。有效缓存仍重复生成时,提交资源 JSON、manifest 和运行日志。

配置页参数为空 ​

确认包体包含默认配置并且客户端与服务来自同一版本。不要把旧版客户端复制进新版服务目录。尝试“恢复默认”,仍为空时保留现场并提交日志和目录结构截图。

需要收集什么 ​

Windows v0.10.4 起会自动保存运行日志。问题出现后,可在文件资源管理器的地址栏输入 %LOCALAPPDATA%\SiftMapTracker\logs,找到 runtime.log。反馈时请注明出错时间,并附上:

  • 客户端版本;
  • Windows 版本、显示器分辨率和缩放比例;
  • 当前算法从启动服务到报错的完整日志;
  • settings_override.json 中与截图区域相关的字段;
  • 问题能否稳定复现。

免费发布,仅供学习交流,禁止用于商业用途