YHo AutoFish 仅用于图像识别、桌面自动化流程学习与个人技术研究。程序通过屏幕截图、模板识别、OCR 和普通键盘输入工作，不读取游戏内存，不注入 DLL，不修改游戏资源文件。
使用自动化工具仍可能违反游戏或平台规则，并可能带来账号、收益、设备环境或其他风险。请只在你充分理解并能自行承担后果的前提下使用。禁止商业代练、批量传播、二次售卖、卡密售卖、冒充官方工具或任何侵权用途。
本程序开源免费发布。若你从付费渠道获得本程序，请立即停止付款，并优先从项目 Release 页面获取发布包。
1.2.2 是基于 1.2.1 的热修复版本，重点修复成功钓获偶发被误判为“鱼儿溜走了”的问题，并在开始钓鱼前增加低分辨率提醒，帮助用户避开低分辨率导致的识别不稳。
- 修复低置信度“鱼儿溜走了”提示误判，避免成功钓获被记录为空杆/失败。
- 优化失败与成功结算的判定顺序，优先确认成功结算特征，再处理失败提示。
- 新增低分辨率启动提醒：游戏客户区低于 1600 × 900 时，会提示用户调高分辨率或确认继续。
- 修复成功结算界面偶发不按 ESC 关闭，导致停留在结算画面或后续流程异常的问题。
- 修复“钓鱼准备界面开始钓鱼按钮”被误判为自动循环内可抛竿提示，导致重复按 F 或进入恢复流程的问题。
- 优化等待上钩阶段的可抛竿确认逻辑，只使用钓鱼初始界面特征辅助判断。
- 强制管理员运行，避免游戏管理员权限高于工具时按键无法送入。
- 修复高 DPI、2K、4K、全屏和非 1K 窗口下坐标与截图不一致的问题。
- 重构右下角钓鱼入口识别，支持多张 F 图标模板、边缘匹配、前景 mask 和 Q/E/R 组合控件辅助判断。
- 重构溜鱼耐力条识别，优先使用颜色法和 HUD 水平带限制，降低树林、白天高亮、水面绿色背景干扰。
- 优化黄色游标识别，减少被黄色发光背景误吸附的问题。
- 优化溜鱼控制参数，默认更积极，死区更窄，更适配官方降低 A/D 移动速度后的手感。
- 增加失败、空杆和异常恢复流程，修复鱼儿溜走后不重新钓鱼、F 按键未生效后长时间等待的问题。
- 优化成功结算判断，加入点击关闭提示、获得经验、重量单位等组合特征，减少失败误判成功。
- 修复点击停止后仍可能继续发送 F 键的问题。
- 捕获记录取消 1000 条硬裁剪，阶段总结改用单调递增记录 ID，旧数据可迁移。
- 新增用户接管保护：用户在游戏内点击或按键时自动暂停并提示，避免程序和用户操作冲突。
- 优化高级设置、运行日志、悬浮窗、关于界面和版本入口。
- 新增在线热更新：检查更新、下载、SHA256 校验、独立更新器覆盖、保护用户数据。
完整发布说明见 release_notes_v1.2.2.md。
推荐使用 GitHub Release 中的压缩包，不需要自己配置 Python 环境。
- 下载
YHoAutoFish-v1.2.2-windows.zip。 - 解压到一个固定目录，不要直接在压缩包内运行。
- 打开《异环》，进入可以钓鱼的位置。
- 运行
YHoAutoFish.exe。 - Windows 弹出管理员权限确认时选择“是”。
- 首次启动阅读用户协议和反侵权提示。
- 点击“初始化模块”，完成后点击“开始钓鱼”。
从 1.2 起，程序会强制请求管理员权限。若拒绝 UAC 权限，程序不会继续运行。
- 系统：Windows 10 或 Windows 11。
- 游戏：保持《异环》窗口可见，不要最小化。
- 权限：游戏和工具都建议以管理员权限运行；1.2 会自动请求管理员权限。
- 显示：支持常见 1080p、2K、4K、高 DPI、窗口化和全屏场景；仍建议保持游戏 UI 不被遮挡。
- 钓鱼点：角色站到钓鱼点，右下角能看到钓鱼交互提示。
- 运行中：不要遮挡顶部溜鱼 HUD、右下角交互 UI、上钩提示和结算界面。
| 功能 | 说明 |
|---|---|
| 自动抛竿 | 识别右下角钓鱼交互状态后自动按 F |
| 自动上钩 | 识别上钩文字提示后迅速按 F |
| 自动溜鱼 | 根据绿色耐力条和黄色游标自动控制 A/D |
| 自动结算 | 识别成功结算或失败提示，自动记录并进入下一轮 |
| 捕获记录 | 保存鱼名、重量、时间、稀有度和统计信息 |
| 图鉴系统 | 显示鱼类资源、解锁状态和稀有度筛选 |
| 阶段总结 | 按新增记录生成阶段统计，不受历史记录数量影响 |
| 悬浮窗 | 支持展开/收起，显示状态和日志 |
| 高级设置 | 按分类调整溜鱼、流程、识别、安全接管等参数 |
| 在线更新 | 标题栏版本入口检查更新并一键安装 |
- 钓鱼记录：查看捕获历史、筛选鱼类、统计重量和数量。
- 图鉴记录：按稀有度浏览鱼类，查看已解锁与未解锁状态。
- 运行日志：查看自动钓鱼状态、错误、恢复流程和调试信息。
- 高级设置：调整溜鱼控制、流程超时、识别判定和安全接管。
- 悬浮窗：游戏旁快速开始/停止，支持收起为横条。
- 关于：查看版本号、作者、项目地址、用户协议和反侵权协议。
1.2.2 的默认参数已按当前游戏 A/D 移动速度调校。多数用户不需要修改。
| 情况 | 建议 |
|---|---|
| 游标跟不上耐力条 | 适当提高“跟鱼力度” |
| 反应不够及时 | 降低“跟鱼死区”或“中心安全区宽度” |
| 左右抖动过猛 | 略微提高“跟鱼死区”或“最短按键保持” |
| 白天或树林环境识别不稳 | 开启调试溜鱼视图，反馈截图 |
| 失败后长时间不继续 | 检查恢复超时、上钩等待超时设置 |
| 结算识别慢 | 降低成功结算检测间隔，但会增加截图匹配频率 |
程序会在启动后后台自动检查一次更新，运行期间默认每 30 分钟轮询一次静态 latest.json。轮询只读取轻量清单，不调用 GitHub Release API；手动点击标题栏版本按钮会立即重新检查，不受自动轮询间隔影响。发现新版本后，标题栏版本按钮会变醒目，后台轮询会停止，避免反复提醒。
更新流程：
- 发现新版本后，标题栏版本按钮变醒目。
- 点击版本按钮，先确认用户协议和反侵权协议。
- 查看更新说明，选择一键全自动更新。
- 选择下载源：默认 GitHub 官方源，也可以切换到 Gitee 国内源。
- 程序下载更新包并校验 SHA256。
- 主程序退出，独立
YHoUpdater.exe显示安装进度并覆盖程序文件。 - 安装完成后停留在成功页面，由用户选择“启动新版”或“完成退出”。
更新工作目录为程序目录下的 .updates/，下载包、解压目录和更新器运行副本都会放在软件所在盘符，不再默认占用 C 盘 %TEMP%。更新完成后会清理下载包和解压目录，运行副本会在后续更新前按过期规则清理。
受保护的数据包括 config.json、records.json、records.db、logs/、screenshots/、captures/、.updates/ 等。
国内网络访问 GitHub 不稳定时，可以在 config.json 中增加备用更新源，不需要改代码：
{
"update_manifest_urls": [
"https://你的国内静态站/latest.json"
],
"gitee_repository_url": "https://gitee.com/fadedtumi/YHoAutoFish",
"update_gitee_manifest_urls": [
"https://你的 Gitee latest.json 直链"
],
"update_gitee_download_urls": [
"https://gitee.com/fadedtumi/YHoAutoFish/releases/download/{tag}/{asset_name}"
],
"update_download_urls": [
"https://你的国内静态站/{asset_name}"
],
"update_mirror_prefixes": [
"https://你的-github-代理/"
],
"update_startup_jitter_seconds": 20,
"update_check_interval_minutes": 30
}自动检查和手动检查更新都会优先读取 GitHub 官方 latest.json；如果 GitHub 不可用或 GitHub 当前没有比本地更新的版本，会继续尝试 Gitee。Gitee 默认会先请求 https://gitee.com/api/v5/repos/fadedtumi/YHoAutoFish/releases/latest 获取最新发行版标签，再读取 https://gitee.com/fadedtumi/YHoAutoFish/releases/download/{tag}/latest.json。如果直链 latest.json 偶发返回 502，程序会继续尝试 Gitee Release 附件下载接口。update_check_interval_minutes 控制后台轮询间隔，建议保持 30 分钟或更长；手动检查始终立即执行。update_download_urls、update_gitee_download_urls 支持 {version}、{tag}、{asset_name} 占位符。即使使用备用下载源，程序仍会按 latest.json 中的 SHA256 校验更新包，校验失败会拒绝安装。
Gitee 国内源使用连续分卷附件，例如 YHoAutoFish-v1.2.2-windows.zip.001、.002、.003。程序会自动下载所有分卷、校验 SHA256、合并为完整更新包并安装，普通用户不需要手动合并分卷。若下载过程中点击取消，程序会清理未完成的分卷、合并包和临时目录。
用户数据保存在程序目录：
records.json：捕获记录、图鉴解锁、统计数据。config.json：高级设置与运行偏好。logs/：更新器日志等运行日志。
发布包不会内置作者测试记录。你可以备份 records.json 和 config.json 来保留自己的数据。
| 问题 | 解决办法 |
|---|---|
| 程序启动要求管理员 | 这是 1.2 及后续版本的强制要求，点击 UAC 窗口“是” |
| 找不到游戏窗口 | 先启动游戏，确认窗口可见且进程为 HTGame.exe |
| 按键没有反应 | 确认管理员权限，避免游戏窗口失焦或被遮挡 |
| 不自动抛竿 | 确认角色在钓鱼点，右下角交互 UI 可见 |
| 溜鱼失败率高 | 先使用默认参数；必要时微调跟鱼力度、死区和安全区 |
| 鱼儿溜走后没有继续 | 查看运行日志中的恢复提示，确认回到可抛钩界面 |
| 鱼名或重量识别不准 | 保持结算界面无遮挡，必要时反馈调试截图 |
| 检查更新失败 | 可稍后手动检查；国内网络可配置 update_manifest_urls / update_download_urls 作为备用源 |
| 自动更新后数据还在吗 | 在受保护名单内的数据不会被覆盖 |
py main.py 提示缺少 PySide6 |
当前 py 默认 Python 可能缺少依赖。入口脚本已指定 python3.9，也可以显式运行 py -3.9 main.py |
普通用户只需要下载 YHoAutoFish-v1.2.2-windows.zip，解压后运行 YHoAutoFish.exe。
GitHub Release 提供完整压缩包；Gitee Release 可能因附件体积限制提供 .zip.001、.zip.002 等分卷。分卷主要用于程序自动更新，手动下载安装时建议优先使用 GitHub 完整压缩包；如果只能使用 Gitee 分卷，请下载所有连续分卷后按文件名顺序合并为完整 zip 再解压。
程序内的一键更新会自动处理 GitHub 完整包或 Gitee 分卷包，并在安装前校验 SHA256。校验失败时会拒绝安装，避免使用损坏或不匹配的更新包。
本项目采用自定义限制性许可证：LICENSE。
允许个人学习、研究、查看源码和本地非商业使用。未经作者书面许可，禁止商用、二次修改分发、打包转卖、转载镜像、改名发布、去除署名或制作衍生收费版本。
- 作者：
FADEDTUMI - 项目地址：
https://github.com/FADEDTUMI/YHoAutoFish - 当前版本：
1.2.2