欢迎使用 POE2 MapGuider
POE2 MapGuider 是一款专为《流放之路 2》玩家打造的辅助工具，支持横版（HB）与竖版（VB）两种布局，可自动显示地图攻略、角色信息与地图耗时，减少来回切换窗口。
提示： 本工具开源且安全，不会修改游戏内存，仅读取日志文件和公开 API。
版本选择建议： 竖版（VB）适合并排查看攻略；横版（HB）适合全屏游戏时悬浮查看信息。按你的游戏习惯任选即可。
图 1.1 - POE2 MapGuider 主界面
安装与运行
POE2 MapGuider 基于 Python 开发，支持 Windows 10/11 系统。
环境准备
请确保您已安装 Python 3.8 或更高版本。
# 1. 安装依赖库 pip install PyQt6 requests py-window-styles # 2. 运行程序 python poe2_monitor.py
注：如果是直接下载的 exe 版本，直接双击运行即可，无需安装 Python 环境。
仪表盘概览
启动后，您将看到采用深色主题设计的控制台。
网络监控
显示当前公网 IP 及归属地信息，帮助判断网络线路状态。
自动计时
无需手动操作，进出地图自动开始/停止计时，精准统计刷图效率。
速通榜（开发中）： 横版状态栏提供 🏆速通榜 快捷入口。 目前仅用于跳转查看全球剧情竞速排行榜，后续会考虑与本地地图耗时统计联动展示。
速通榜（开发中）
速通榜项目正在持续开发中，当前可访问预览站点查看页面样式与功能方向：https://lss.lol/poe2/
后续将逐步支持：个人成绩查询、剧情速通榜展示、异界地图记录统计与赛季数据汇总。
图 1.2 - 剧情速通榜预览
图 1.3 - 异界地图记录预览
角色信息同步
支持 WeGame 与 poe.ninja 角色链接，粘贴后即可快速同步角色信息。
操作步骤：
- 打开 WeGame 助手或 poe.ninja 角色页面，复制角色分享链接。
- 在 POE2 MapGuider 的输入框中粘贴链接。
- 点击“刷新”按钮，即可加载角色等级、职业和游戏时长等数据。
地图统计
工具会自动读取游戏日志（Client.txt），识别您进入的地图区域。
注意： 请确保 WeGame 的“辅助功能”已开启，否则游戏可能不会生成日志文件，导致无法识别地图。
- 1 自动识别： 进入地图时自动显示地图名称。
- 2 地图攻略： 自动显示当前地图攻略、BOSS 与奖励信息，减少遗漏精魂与天赋点。
- 3 耗时统计： 离开地图或返回藏身处时，自动结算该次刷图用时，并且可以限时最近两次地图纪录。
日志路径识别： 默认会自动识别日志路径；如果识别失败，手动选择一次 Client.txt 即可继续使用。
图 1.3 - 地图识别与攻略展示
横版支持（HB 悬浮窗）
横版模式更适合边刷图边看信息：窗口置顶、紧凑显示地图/计时/攻略，并尽量不遮挡游戏操作。
紧凑信息栏
同屏展示：当前地图、计时器、BOSS 提示、攻略文字、区域内容、相连地图与角色信息。
不挡操作（穿透）
默认尽量鼠标穿透，不影响点击游戏；当鼠标移到攻略区域或状态栏链接（如 🏆速通榜）上时可交互（滚动/点击）。
左侧按钮栏
提供拖拽、日志路径、绑定 WeGame 角色、IP 显示/隐藏、关闭等快捷操作。
隐私友好
默认用“.”隐藏完整 IP/归属地信息，可通过左侧“IP”按钮随时切换显示。
图 1.4 - 横版（HB）主界面
图 1.5 - 左侧按功能钮（拖拽、自定义日志路径、绑定角色信息、IP 信息开关、退出程序）
图 1.6 - BOSS 信息、区域内容、相连地图与攻略信息展示
区域内容与相连地图： 能够显示当前区域包含的关键内容（如试炼、神坛等）以及所有相连的出口地图。若信息过长，会出现“...”按钮，点击可查看完整详情弹窗。
竖版路线图： 竖版支持路线图查看，路线较多时可左右切换，跟图更直观。
常见问题 (FAQ)
软件是否免费？
基础功能完全免费。部分高级功能可能需要激活码解锁（详见软件内说明）。
无法识别日志路径怎么办？
程序会自动尝试在默认文档路径下查找。如果未找到，请点击界面上的“设置日志路径”按钮，手动选择 Client.txt 文件。
常见路径参考：
- G:\POE2\logs\Client.txt
- F:\WeGameApps\rail_apps\流放之路：降临(2002052)\logs\Client.txt
- Documents\My Games\Path of Exile 2\logs\Client.txt
更新日志
v2.3.12 最新
- 文档顶部按钮已接入真实链接：下载最新版与问题反馈可直接跳转。
v2.3.11
- 文档为速通榜模块补充官网超链接，支持从教程页直接访问。
v2.3.10
- 文档新增速通榜开发中说明，补充后续功能简介，并加入速通榜与异界记录页面截图。
v2.3.9
- 文档统一品牌文案，将“PoE 2 Monitor”调整为“POE2 MapGuider”。
v2.3.8
- 文档根据推文补充了双布局建议、poe.ninja 角色同步、日志识别兜底和竖版路线图说明，并统一为面向用户的简洁描述。
v2.3.7
- 新增HB 与 VB 共享激活状态，两个版本现在读写同一份激活配置。
- 新增已激活用户点击激活按钮可直接查看激活信息（商品、激活时间、有效期、剩余天数）。
- 优化更新激活码购买链接，并同步激活接口有效期文案展示。
- 文档根据推文补充双布局使用建议、poe.ninja 角色同步、日志自动识别与手动兜底、竖版路线图说明。
v2.1
- 优化UI/UX 全面升级：
- HB 模式左侧“拖拽”按钮增加蓝色半透明背景与高亮边框，提升可见性。
- HB 模式“关闭”按钮增加红色半透明背景与高亮边框，防止误触并提升识别度。
- 统一 HB 模式各行文本左边距，优化垂直对齐，提升视觉整洁度。
- 攻略文本增加阴影效果，增强文字层次感与可读性。
- 修复多语言与国际服适配：
- 修复英文客户端显示中文内容的问题，新增基于地图名称的语言自动检测。
- 优化语言判断优先级（地图名 > 日志路径），解决 Client.txt 文件名导致的误判。
- 修复自动刷新后语言重置为英文的 Bug。
- 新增交互体验改进：
- 优化“...”详情按钮显示逻辑，仅在内容截断时出现，减少视觉干扰。
- 恢复并优化详情弹窗功能。
v1.2
- 新增横版（HB）悬浮窗：紧凑展示地图、计时、BOSS、攻略与角色信息。
- 新增左侧快捷按钮栏：拖拽、日志路径、绑定 WeGame、IP 显示/隐藏、关闭。
- 新增状态栏加入“🏆速通榜”快捷入口（开发中）。
- 优化默认隐藏完整 IP/归属地信息，减少隐私暴露；可一键切换显示。
- 优化攻略文本滚动交互更稳定，拖动滚动条后不会被刷新重置位置。
- 优化压缩按钮栏高度并修复按钮间距，减少遮挡与重叠。
v1.1
- 新增支持全局快捷键（老板键）：
- 用户可自定义显示/隐藏窗口的组合键（如 Alt+S）。
- 底层采用 Windows 原生 API，响应极快且安全防封。
- 新增顶部工具栏：
- 版本更新检查入口。
- 激活码快捷输入入口。
- 联系作者快捷入口。
- 优化重构底层消息处理逻辑，修复部分系统下快捷键可能导致的崩溃问题。
- 优化移除不稳定的边缘吸附功能，提升窗口操作稳定性。
v1.0
首个公开版本发布，包含以下核心功能：
- 网络监控：实时显示公网 IP 及归属地。
- 角色同步：支持 WeGame 角色分享链接解析，一键同步等级与职业。
- 地图助手：自动识别 Client.txt 日志，显示当前地图名称及攻略信息。
- 自动计时：进出地图自动开始/暂停计时，精准统计刷图效率。
- 多服支持：完美兼容国服（WeGame）与国际服日志路径。