故障排查
先确认软件版本、完整解压和小地图框选,再按错误信息定位。
Capture region is outside the virtual desktop bounds
原因:保存的截图区域不在当前 Windows 虚拟桌面的物理像素范围内,常见于更换显示器、缩放比例、主屏幕或窗口模式。
处理:
- 停止追踪。
- 将鼠标移到游戏所在显示器。
- 使用“框选截图范围”重新框选完整小地图。
- 打开预览确认画面。
- 重新启动追踪;运行中重新框选时客户端会重启服务。
仍失败时删除 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中与截图区域相关的字段;- 问题能否稳定复现。
