客户端操作指南

新版监控会上传每个窗口的会话/帧序号和采集质量，服务端选定主窗口，其他窗口为备用。 连接支持统一当前状态的新服务器时，预警、星图和 QQ 以同一结果为准，本地人数不覆盖服务端选择。 实时视图不显示历史“上次”敌情；采集失效、停止监控或连接异常时移除相应实时数据， 不把移除解释为星系安全。此项自 1.0.73 修复，1.0.72 不包含；发布状态见发布记录。 预警启动、网络重连及正常连接轮换均加载当前状态与对应游标，不补播停用或断线期间已结束的来敌/清空。 档案与组织规则在 Web 管理界面配置，不需要客户端维护人员资料或声望。

这份文档只介绍 Windows 客户端的界面操作。下载安装后，不需要配置 Python、OCR 模型或环境变量。

下载和启动

1. 下载最新版 Windows 客户端。
2. 解压整个压缩包，不要只复制其中的 EXE 文件。
3. 启动 EVE-Sentry-Monitor.exe。
4. 将 EVE Online 设为“窗口化”或“无边框窗口”模式，并保持游戏窗口未最小化。

首次运行时，Windows 如果显示安全提示，请确认文件来源后选择继续运行。

更新包下载并校验完成后，关闭客户端窗口会退出旧进程、覆盖当前解压目录并从同一路径 重新启动。即使启用了“关闭到托盘”，待安装更新也会优先完成安装；普通关闭仍进入托盘。

第一次使用

1. 连接服务端

在客户端左侧填写：

• 服务端：管理员提供的服务器地址。客户端不内置默认地址，需要显式填写；留空时不会 建立网络连接，可进行本地监控识别，但不会上传情报，也不能开启预警。
• 设备密钥（可选）：需要客户端身份认证时从网页账号创建，或向管理员获取；通常以 eve_ 开头。留空时客户端不进行认证预检和身份扫描，也不发送 Authorization 请求头。

输入完成后点击界面其他位置。顶部连接状态显示正常后再继续操作。密钥为空时身份状态 显示 未启用认证 属于正常状态；服务端为 enforce 模式时仍需填写有效密钥。

2. 选择 EVE 窗口

1. 先登录 EVE，并打开本地频道成员列表。
2. 在 目标窗口 下拉框中选择一个角色窗口，用于区域校准和预览。
3. 点击 监控窗口 N/M，逐个勾选需要监控的 EVE 窗口；菜单也支持 全选 和 仅选当前窗口。
4. 如果没有看到窗口，点击下拉框右侧的 刷新窗口 图标。
5. 依次在下拉框中切换窗口并点击 选择区域，框选各自的本地频道成员列表。
6. 点击 预览，确认当前窗口截图只包含需要识别的成员列表。

目标窗口下拉框只控制当前校准和预览对象，不会改变监控范围。客户端按窗口/角色保留勾选 状态和各自区域；窗口位置、大小或显示器缩放发生明显变化时，建议重新选择区域。多窗口 监控会按角色分别读取本地频道日志，因此不同 EVE 窗口可以处于不同星系。

监控窗口菜单按“角色 · 星系 · 状态”显示已发现的 EVE 窗口。游戏窗口暂时关闭时，当前在线 菜单项会消失并停止对应采集线程，但勾选记忆不会被清除；同一窗口重新出现后会恢复原选择。 全选当前在线窗口 只影响当时已发现的窗口，之后首次出现的新窗口不会被静默加入。 按钮变为红色表示当前没有可启动的已选在线窗口。

3. 开始监控和预警

• 点击 开始监控：只识别 监控窗口 N/M 菜单中已勾选的 EVE 窗口。运行中改变勾选项时，监控线程会自动更新。
• 点击 开启预警：接收各监控节点的预警，在顶部浮窗显示并按设置播放声音。

监控使用后台窗口捕获，不会在 EVE 窗口周围显示 Windows Graphics Capture 的黄色边框。

客户端会在执行启动动作前检查前置条件：监控必须至少选择一个当前在线的 EVE 窗口， 并且每个已选窗口都要有成员列表区域。条件不满足时只提示原因，不会进入身份验证或启动 识别线程；修正后再次点击即可。全选当前在线窗口 只选择本次已发现的窗口，之后新上线 的窗口不会被静默加入，避免误监控。

开启预警前必须填写服务端地址。地址输入错误时输入框会标红并保留修改内容，修正为有效的 http:// 或 https:// 地址后再试；清空地址会关闭服务端通信。认证正在进行时取消按钮， 认证完成后不会重新开启已取消的功能。

这两个按钮互相独立：

• 只开启监控时，本机会上报信息，但不会显示预警浮窗。
• 只开启预警时，本机不会识别窗口，但仍可接收其他节点的预警。

填写设备密钥后，客户端会自动从 EVE 日志发现角色身份，不需要手动开启 Listener 扫描。 扫描按中英文 Local 日志文件名末尾的角色 ID 分组，只处理每个角色修改时间最新的一份， 并向服务端上报 ID，不回放全部历史。带 ID 的日志不会读取文件正文；只有缺少末尾 ID 的 旧格式日志才读取 Listener 文件头进行兼容。设备密钥为空时不会执行身份扫描。

• 需要完整功能时，请同时开启监控和预警。

界面说明

监控线程会单独检测每个 EVE 窗口的采集连接：窗口明确关闭会立即标记为掉线，后台画面连续 三次不可用才会标记为掉线，避免单帧采集抖动误报。下一次成功采集会标记为已恢复，并立即 刷新客户端心跳。心跳的 details.targets 会在有状态信息时包含 capture_online 和 capture_failure_count；capture_offline_count 表示当前掉线的监控窗口数量。掉线不会清除 窗口选择，窗口重新出现后仍按原选择策略重连。

客户端不再读取 EVE logs/Gamelogs 进行游戏服务器掉线检测。监控状态仅反映 EVE 窗口和 后台画面捕获线程是否可用；游戏内连接状态由 EVE 客户端自身显示。

扫描间隔控制画面变化检测频率，默认 2 秒（可调整为 1–10 秒）。画面无变化时客户端会跳过 OCR 以减少资源占用，但仍按设定的扫描间隔继续截图检测，不会因为连续静态画面自动延长间隔。 红色敌对图标检测与 Presence 上传独立于 OCR，OCR 变慢或失败不会阻塞首条预警。

告警声音

左侧可以：

• 开启或关闭 告警声音。
• 在 告警声音文件 中点击 选择，选择自定义 WAV 音频；点击 试听 可按当前音量 播放一次，清空路径即可恢复使用内置声音。
• 使用 音量 滑块调整告警声音大小，右侧会显示当前百分比。
• 在 播放方式 中选择 持续 或 间隔。持续会在仍有敌对目标时循环播放， 直到该星系恢复安全；间隔会按下面的播放间隔和次数播放。
• 使用 持续 模式时，预警浮窗会显示 停止本轮；点击后立即停止当前声音， 在本轮敌对全部清空前不会再次响起，下一轮告警会自动恢复。
• 设置同一轮告警的 播放间隔。
• 设置同一轮告警的 播放次数。

播放间隔和播放次数只影响 按间隔响 模式；切换为 持续响 后，这两个数值会保留， 切回按间隔响时继续生效。自定义声音目前支持 WAV 文件；文件不存在、无法读取或未设置时， 客户端会自动回退到内置告警声音。告警声音设置会保存到本地配置，客户端重启后仍然保留。

Presence、OCR 与局部星图

顶部预警浮窗中，绿色表示安全，红色表示发现敌对目标；红色方框会显示当前红色敌对图标 数量。客户端每轮只截取一次成员列表区域。红色敌对图标检测产生 Presence，是实时敌对人数 的权威来源；完整 OCR 只识别文本名单，用于人员详情、ESI 分类和按需查询。关闭 OCR 不会 停止 Presence，上报 OCR 也不会改变 Presence。

常规完整 OCR 在红色数量或名单区域发生变化时执行；按需查询命令可以额外触发一次独立 OCR。客户端上传完整 OCR 名单，只过滤行首的 UI 图标噪声，不按敌我清洗，也不上传敌对 人数、文字框或红色图标坐标。服务端收到名单后逐名通过 ESI 校验并分类。 完整 OCR 成功后不会继续消耗补偿 帧，只有空结果才有限重试。姓名区域指纹会忽略背景变化和图标边界的轻微像素抖动，避免 稳定名单重复执行 OCR。 除按需查询外，稳定画面和清空状态不会重复执行常规 OCR，距离等非姓名区域变化也不会触发 常规识别。 浮窗可在 列表 和 星图 间切换。星图视图通过紧凑的账号按钮展开多选菜单， 不会常驻显示角色列表；菜单包含本地账户和服务端当前在线、开启监控且采集有效的监控节点，可 多选需要关注的账户，并选择显示其所在星系周围 1、2、3 或 5 跳。

已选本地账户位置显示为金色星形（位置不代表安全），有实时敌对时变为红色星形；其他在线监控节点显示青绿色 圆点和圆环。非在线、停止或采集失败的监控节点退出实时显示，失效敌情不保留红色菱形或“上次”标签。 同星系仍有有效备用监控时保留该星系实时结果。SSE 异常显示连接提示，清除远端旧数据并停止对应声音， 不发送“清空”；恢复后从当前快照重建。地理拓扑与本地账户位置不作为远端在线监控证据。

采集租约仍需持续上报续期，即使敌对数量不变也会发送 Presence；这不等于重复来敌。 成功确认日志仅在首次确认、数量/星系/采集会话变化或上报失败后恢复时记录，避免相同数量持续刷屏。

客户端只请求所选账户附近的局部拓扑，不下载或绘制全量星图。请求由后台线程执行，超时为 5 秒；已有请求运行时只保留最后一个待处理请求，因此不会冻结浮窗。角色从一个星系跳到另 一个星系后，客户端会清除旧星系并强制刷新新星系的当前数量，即使前后数量相同也不会残留 旧的红色节点。

监控窗口菜单支持运行中增量调整。新增窗口只创建并启动对应的监控线程，取消选择或窗口 下线时只停止对应线程，其他窗口的线程、扫描进度和 OCR 调度器保持不变，不会触发全量重连。

日常使用

1. 启动并登录 EVE Online。
2. 启动 EVE Sentry。
3. 确认顶部连接状态和 运行状态 没有异常。
4. 在目标窗口下拉框和 监控窗口 N/M 菜单中确认窗口；首次运行或没有保存选择时默认不 勾选，已有选择记录时会自动恢复，需确认它们仍符合本次监控范围。
5. 依次选择每个窗口的 选择区域 并框选成员列表；未选择窗口或区域时，点击开始监控会提示并不会启动 OCR。
6. 点击 开始监控。
7. 需要接收预警时，再点击 开启预警。

退出前可分别点击 停止监控 和 关闭预警。如果直接关闭客户端，也会停止本机监控。

更新客户端

客户端会自动检查新版本，也可以点击左下角的 检查更新。

发现新版本后，按界面提示下载并选择 安装并重启。更新期间不要手动移动或删除客户端目录；已配置的设备密钥和本地设置会保留。

从 1.0.9 起，已经校验完成的更新包会在客户端重启后继续保留，无需重新下载。安装前会检查压缩包、客户端目录写入权限和可用磁盘空间；检查失败时客户端不会退出，可以修复问题后重试。

从 1.0.11 起，各 EVE 窗口的识别区域保存在 %LOCALAPPDATA%\EVE Sentry\region_prefs.json， 客户端更新不会再覆盖该配置。首次启动会自动迁移安装目录或上一个版本备份中的旧配置； 已有用户目录配置时始终以用户目录为准。

安装器会备份当前版本，并在新客户端连续运行 8 秒且确认版本号后才删除备份。安装或启动检查失败时会自动恢复旧版本，并在下次启动显示结果。详细安装日志保存在 %LOCALAPPDATA%\EVE Sentry\updates\update.log。

常见问题

目标窗口为空

• 确认 EVE 已启动且已进入角色。
• 确认游戏不是全屏独占模式，也没有最小化。
• 点击 刷新窗口。
• 如果改过 窗口关键字，恢复默认值后重试。

预览区域不正确

点击 选择区域 重新框选成员列表。框选时尽量避开聊天正文、滚动条以外的按钮和其他窗口。

无法开始监控

依次查看 运行状态 中的服务端、身份、OCR、窗口和区域。密钥留空时显示 未启用认证 不是客户端故障；若服务端为 enforce 模式则需填写有效密钥。已填写但失效时，需要在 网页中重新创建密钥或联系管理员。

有红色预警但没有声音

确认左侧 告警声音 已开启、Windows 没有静音，并检查播放间隔和播放次数。

预警显示“异常连接”或反复重连

/api/v1/events 默认每 30 秒正常结束一次响应，客户端随后立即重连；这属于正常连接轮换， 不表示预警连接异常。1.0.73 统一启动与重连策略： 每条新连接均请求当前 Bootstrap，不携带 Last-Event-ID 或 since 补播旧事件。 快照与对应水位来自同一服务端数据库视图；整体替换实时状态后，在同一连接接收后续新变化。 断线期间已经来敌又清空的星系不会先红后绿；仍有敌人的星系直接显示当前敌情。 对账不生成历史来敌/清空通知。客户端继续在 %LOCALAPPDATA%\EVE Sentry\alert_client_state.json 保留告警去重记录和游标检查点，但 不以旧连接的检查点初始化新预警视图。后续合成 Presence、报告或节点事件 ID 不会覆盖 本次持久序号。浮窗相同可见状态不重复重建布局，实际来敌/清空立即更新，不增加防抖等待。 服务端可能发送仅含 id: state:W 的无数据 控制块来恢复浏览器重连游标；客户端解析器会忽略它，不把它显示成告警。

Windows 客户端为 SSE 请求 1 秒的注释心跳；客户端向服务端发送的应用心跳默认为 10 秒， 两者不是同一种心跳。局部星图拓扑请求固定使用 5 秒超时。

预警客户端的 SSE 连接和心跳请求共用一个 HTTP 客户端。服务端短暂繁忙时，心跳可能比 平时慢，但不代表连接已经断开。客户端对这类请求使用 5–15 秒的有界超时，并在失败后 按退避策略重连；不要把告警 API 的请求超时重新限制为 3 秒，否则会把短暂的服务端延迟 误判为异常连接并放大重连负载。

若状态持续异常，请先确认服务端地址和设备密钥，再导出诊断包。诊断包中的 client.log 应重点查看 Heartbeat update failed、HTTP 200 和 HTTP 201 是否交替出现： 如果心跳随后恢复成功，通常是瞬时延迟；如果长时间只有超时，再交给管理员检查服务端 SSE 连接数和负载。

仍然无法解决

点击左下角 导出诊断包，把生成的文件和问题发生时间一起交给管理员。诊断包用于排查客户端状态，不需要手工复制运行日志。