v1.8: unified evaluation and quality gates

黑流树海地图助手 v1.8

本次更新

• 修复 Windows 节点查询弹窗在空白区域点击或鼠标释放轮询漏触发后，后续节点可能无法再次打开的问题，并加入两项 UI 回归测试。
• 修复英文等非中文 Windows 区域设置下，预测完成时间格式可能触发 locale 编码错误的问题。
• 收口 Android 识别实验入口：正式识别继续固定为文字优先、iconFirst = false、classifyFlags = 0；低分辨率增强与文字/图标顺序只允许由 instrumented benchmark 显式启用。
• 建立 Windows/Android 统一识别评测平台，固定 21 个案例的来源、PNG 尺寸与 SHA-256，并统一模板、诡秘、尽头、节点类型和耗时指标。
• 新增 GitHub Actions 门禁：Windows Python 测试、覆盖率、Ruff、Mypy、资源/评测校验，以及 Android JVM 测试、lint、debug 构建、ABI/权限/fixture 审计；模拟器 instrumented 测试为独立手动/定时任务。
• 修复 Android 前台服务通知图标、硬编码文本和 lint 噪声；保留 launcher 竖屏、悬浮层横屏适配及 arm64-v8a 正式 ABI 约束。
• Android 更新为 versionCode 6 / versionName 1.8.0，Windows FileVersion/ProductVersion 更新为 1.8.0。

发布验证

• Python：89 项测试通过，覆盖率 63.39%（门槛 60%）；43 份模板、规则和图像资源校验通过；Ruff 与渐进式 Mypy 通过。
• 统一评测：21 个固定案例的 manifest、fixture SHA-256、PNG 尺寸和已提交报告一致性检查通过；Windows native 全量评测已重新运行并生成 JSON/Markdown 报告。
• Android：121 项 JVM 测试通过，0 失败、0 错误、0 跳过；lintDebug 0 错误（仅保留 Android Gradle Plugin 版本更新提示）；assembleDebug、arm64/x86_64 assembleDebugAndroidTest 与已签名 assembleRelease 均成功；91 项 runtime assets 通过校验，其中 69 项与桌面源字节一致。
• Windows EXE：全新隔离目录构建成功；--validate-only 退出码 0；FileVersion/ProductVersion 均为 1.8.0。
• 源码 ZIP：从仅含暂存发布范围的快照生成；全新解压后共 162 个文件，--validate-only 通过；未包含签名材料、.git、.venv、build、dist、debug_output、tests 或 tools。
• APK 审计：versionCode 6 / versionName 1.8.0；仅含 arm64-v8a；4 项预期权限；3 个 native 库的 ELF LOAD 与 APK ZIP 均通过 16KB 对齐；V2 签名和既有证书 SHA-256 指纹通过；ZIP/DEX 未包含 debug、test、instrumented benchmark 或 fixture 内容。

SHA-256

• hlsh-helper-v1.8-source.zip: 221cef08c0e17d837429a52a4ea4b03d3f2d7660530ffbec1517867d78e15673
• hlsh-helper-v1.8-windows.exe: c16160522399c1182ecfeb47c1bd5c1a6a3619baadd0c4658db404f3b4a426a1
• hlsh-helper-v1.8-android-arm64.apk: 30a1eefe42ec9bfb4558ab2c3e0afd67c143e2a2e830e0f20ed03d1121d6924e

说明：本轮未连接 Android 设备或模拟器，因此没有新增 instrumentation 或华为/小米实体设备安装验证；相关结论不会由 JVM、编译或桌面评测代替。

黑流树海地图助手 v1.7

黑流树海地图助手 v1.7

本次更新

• 修复三层模板 07（OP12）中诡秘节点类型与 isMystery 标志不一致的问题。
• 当最高外观分的原始帧未通过 SIFT 时，按外观分顺序继续检查其余有效帧，避免动态/淡入淡出的诡秘节点漏识别。
• 仅在融合分类与多帧外观证据一致时同步诡秘标志，避免无关节点被误提升为诡秘。
• 加入 OP12 原始三帧永久回归：固定识别 floor_3_template_07，并严格校验 10 个诡秘节点及 N23/N28 的恢复路径。
• Android 版本更新为 versionCode 5 / versionName 1.7.0，Windows 文件与产品版本更新为 1.7.0。

发布验证

• Python：65 项测试通过；43 项模板、规则和图像资源校验通过。
• Android 资源：连续两次生成/同步均验证 91 项 runtime assets。
• Android JVM：121 项测试通过，0 失败、0 跳过。
• Android instrumentation：Android 15 x86_64 模拟设备上 10/10 通过，包含真实 JNI/C++ OP12 三帧回归。
• Gradle：test、lintDebug、assembleDebug、assembleRelease 全部成功。
• APK：arm64-v8a only；4 项预期权限；ELF 与 ZIP 均通过 16KB 对齐；V2 发布签名验证通过；证书指纹与既有版本一致；未包含调试类、测试类或 OP12 原始帧夹具。
• Windows EXE：--validate-only 通过，FileVersion/ProductVersion 均为 1.7.0。
• 源码 ZIP：162 个条目；全新解压后 --validate-only 通过；不包含 Android 签名材料、.git、.venv、build、dist、debug_output、tests 或 tools。

SHA-256

• hlsh-helper-v1.7-source.zip: bc81cccf1ecb46c2a6cde68cd9ee296ae043d61fc506250bbae9db4be09af8dd
• hlsh-helper-v1.7-windows.exe: e102927916f796cabaef7387740202ea88711d21f88bc4b91bb9faef724f41e4
• hlsh-helper-v1.7-android-arm64.apk: a72e2a17edbedd8da389d72ad9863bc5f312baca41b2ef0329e144d15a628754

说明：本轮完成了模拟设备的实际 instrumentation 回归；未在华为/小米实体设备上重新安装验证。

v1.6

v1.6

本次发布重点修复 Android 16 全屏捕获下的识别框位移问题，并完善三帧识别与调试诊断能力。

主要变化

• 修复“识别结果正确，但悬浮框位置偏移”：仅当原始捕获缓冲为竖屏、实际显示内容为横屏时，使用居中的横屏内容坐标映射；其他方向继续使用原有映射并保留严格尺寸校验。
• 分离捕获缓冲尺寸、实际屏幕内容尺寸和悬浮窗显示尺寸，避免 Android 16/部分平板上 MediaProjection 几何信息不一致导致错位。
• 将识别会话中的显示几何一并保存，恢复上次结果时继续使用同一套坐标基准。
• 未知诡秘节点改为基于三张原始帧做节点级聚合与必要的特征复核，降低动画相位造成的漏识别，同时由回归夹具约束误报。
• Debug 版新增最近 5 次诊断 ZIP 与手动导出；Release 版使用 no-op 实现，不包含调试导出器、截图或设备测试夹具。

下载

• hlsh-helper-v1.6-windows.exe：Windows 免安装版。
• hlsh-helper-v1.6-android-arm64.apk：Android arm64 版，已使用正式证书进行 V2 签名。
• hlsh-helper-v1.6-source.zip：Windows 源码包，解压后运行 run.bat。

验证

• Python：65 项测试通过，43 个模板/规则/图像资源校验通过。
• Android：117 次 JVM 测试执行无失败；Lint、Debug 和 Release 构建通过。
• APK：arm64-only、4 项预期权限、16KB ELF/ZIP 对齐、V2 签名验证通过；Release 内容审计未发现调试导出器、测试或截图夹具。
• Windows EXE 与全新解压的源码包均通过 --validate-only。

本次发布环境没有连接 ADB 真机，因此未在发布流程中重跑 instrumented 测试；设备侧修复以提交前的实际验证结果为准。

v1.5

v1.5

本次同时发布 Windows 与 Android 正式版本，重点完成 Android 与 Windows 的功能对齐，并增强实机识别与悬浮窗稳定性。

Android

• 新增与 Windows 一致的「预测居民」：可点选 1–3 个模板节点，并按模板最短路径高亮同时距所有选择点不超过 5 步的「未知的凶戾」。
• 新增「地质节点记录」：支持会话内勾选、人工保存、恢复与清空；数据仅保存在应用私有目录，不申请存储权限，也不参与系统备份。
• 人工修改未知节点类型后，会像 Windows 一样重新计算其他未知节点候选，包括距离过滤、已出现数量和全局容量传播。
• 模板、规则和识别内核在服务初始化时一次性加载并缓存，移除每次识别的固定重复耗时。
• 改进动态「未知的诡秘」识别：地图定位仍使用稳定的三帧中值图；中值图未命中时，使用未融合的中间原始帧按相同严格阈值补充图标证据，不放宽现有阈值，也不重复完整模板匹配。
• 修正悬浮窗方向、显示原点、系统栏与刘海变化下的坐标映射和窗口清理；高亮计时任务现在可在关闭、清除或重新高亮时取消。
• 原生识别异常不再伪装成普通低置信度失败，诊断信息可区分输入错误与 native/OpenCV 异常。
• 正式 APK 版本为 1.5.0（versionCode 3），仅包含 arm64-v8a。

Windows

• 关闭程序时会先请求正在运行的识别线程中断并等待退出，避免 Qt 在线程仍运行时销毁 QThread。
• Windows 文件版本与产品版本同步更新为 1.5.0。

下载

• hlsh-helper-v1.5-source.zip：Windows 源码压缩包。
• hlsh-helper-v1.5-windows.exe：Windows 单文件程序。
• hlsh-helper-v1.5-android-arm64.apk：Android arm64 正式签名安装包。

私有签名文件未提交、未打入源码包，也未上传到 Release。

SHA-256

• APK: AB71D0A86DF53C55620A7502216ECE86BB0CA9959D3B3E5B4DCFA55CA4B06100
• Source ZIP: 739E4D273DBE842CCD2FA11BB40BC5DC1817EBC5F53AA9022CD9FF7F5615915F
• Windows EXE: 5A0115D93E9AECB02ACD6B410BA7253F143148B8E05DDBDB974EAB0B30609B57

验证

• Python：65 项测试通过；43 份模板、规则和图片资源校验通过；91 项 Android 运行时资源清单校验通过。
• Android：Gradle test、lintDebug、assembleRelease 及两组 instrumentation 测试 APK 编译通过。
• APK：versionCode 3 / versionName 1.5.0、4 项预期权限、arm64-only、16KB ELF/ZIP 对齐、无测试截图、V2 签名与既有证书指纹一致。
• 模拟器：真实屏幕授权、三帧捕获和 JNI 识别入口通过；此前的 1.5 候选版已由用户在华为和小米真机验证。
• Windows：PyInstaller 单文件构建成功；EXE --validate-only 通过，文件版本与产品版本均为 1.5.0。
• Source ZIP：全新目录解压后 196 个文件，运行时校验通过，不含私钥、.venv、build、dist、debug_output 或 tests。

v1.4

v1.4

本次同时发布 Windows 与 Android 正式版本。

Windows

• 新增“预测居民”：可选择 1–3 个节点，高亮与全部选择点距离不超过 5 步的“未知的凶戾”。
• 新增“地质节点记录”：支持勾选、保存与下次启动恢复。
• 统一识别标记网格对齐，更新应用图标，并补充相关回归测试。

Android

• 优化悬浮菜单、弹窗和控件随字体比例缩放的布局。
• 选择候选高亮类型后自动关闭菜单并立即开始高亮。
• 正式 APK 版本为 1.4.0（versionCode 2），仅包含 arm64-v8a。

下载

• hlsh-helper-v1.4-source.zip：Windows 源码压缩包。
• hlsh-helper-v1.4-windows.exe：Windows 单文件程序。
• hlsh-helper-v1.4-android-arm64.apk：Android arm64 正式签名安装包。

从 v1.4 起，后续每个 Release 都应同时提供以上三类文件。私有签名文件未提交、未打入源码包，也未上传到 Release。

SHA-256

• APK: D6D66D7D4C1CC48CFC228B5B0C085622D07E71017905002C16BA4CFFED772D02
• Source ZIP: CA0C152F03525398AF3C9128BDD92DE684912531B4BB4188E73F56B09E4BDC67
• Windows EXE: 94AEA1C35A37D8A14286C658658005B06E183A9D3EDE095C3A674873B10486D6

验证

• Python：65 项测试通过；43 份模板、规则和图片资源校验通过。
• Android：Gradle test、lintDebug、assembleRelease 通过。
• APK：权限、arm64 ABI、16KB ELF/ZIP 对齐、运行时资源泄漏与签名证书检查通过。
• Windows：EXE --validate-only 通过，文件版本与产品版本均为 1.4.0。

黑流树海地图助手 v1.3

黑流树海地图助手 v1.3

相对 v1.2 的主要变化

• 截图回看：日志为 点此进入（时间） | 截图回看（游戏叠加 / 截图+框）
• 筛选可能类型：可拖动面板，确认后匹配框金色闪烁约 3 秒
• 去掉「查询节点」按钮：进入后自动查询，Esc 退出
• 必须人工选层：已删除自动猜层
• 节点详情：点空白可关闭详情面板；主窗口按钮在查询模式下仍可点击

发布物

• 源码包：hlsh-assistant-source-v1.3.zip
• 独立 EXE：hlsh-assistant-v1.3-windows.exe

v1.2

更新节点生成规则与预测完成入口文案。

• 按新版 I～V 节点距离/数量规则更新
• 将 10+ 规则按项目约定转换为上限 15
• 更新命运所指与居民节点名称
• 预测完成日志改为可点击提示
• 附带源码包：hlsh-source-20260806.zip

黑流树海地图助手 v1.1

更新内容

• 修复屏幕覆盖模式下弹窗出现时，助手主界面和游戏按钮无法点击的问题。
• 点击弹窗外部会关闭弹窗，但不会吞掉游戏或助手窗口的原始点击。
• 将程序左上角、任务栏和 EXE 图标统一为“未知的诡秘”。
• 保留人工选择黑底白字、下拉选项和节点候选查询功能。

验证

• 53 项自动化测试通过。
• 43 个地图模板、规则和图像资源校验通过。
• Windows EXE 已完成打包。

黑流树海地图助手 v1.0

首个源码发布。包含地图模板识别、节点类型与文字识别、未知诡秘候选查询、悬浮标记交互，以及 Windows 安装和启动脚本。下载源码压缩包并解压，首次运行 install_deps.bat 安装依赖，之后运行 run.bat 启动。