欢迎使用 POE2 MapGuiderWelcome to POE2 MapGuider

POE2 MapGuider 是一款专为《流放之路 2》玩家打造的辅助工具，支持横版（HB）与竖版（VB）两种布局，可自动显示地图攻略、角色信息与地图耗时，减少来回切换窗口。同时支持在线排行榜、角色认证与刷图统计。

POE2 MapGuider is a companion tool for Path of Exile 2 players. It supports both Horizontal (HB) and Vertical (VB) layouts, automatically displaying map guides, character info, and map timing to reduce window switching. It also features an online leaderboard, character verification, and map run statistics.

图 1.1 — POE2 MapGuider VB 竖版主界面Fig 1.1 — POE2 MapGuider VB Main Interface

安装与运行Installation & Setup

支持 Windows 10/11 系统，提供 exe 免安装版本和 Python 源码运行两种方式。

Supports Windows 10/11. Available as a standalone exe or Python source.

方式一：exe 直接运行（推荐）Option 1: Run exe Directly (Recommended)

1. 前往 下载页面 获取最新版 zip 压缩包。
2. Visit the download page to get the latest zip package.
3. 解压到任意目录，双击 POE2MapGuider_VB.exe 或 POE2MapGuider_HB.exe 即可。
4. Extract to any folder, then double-click POE2MapGuider_VB.exe or POE2MapGuider_HB.exe.

解压后目录结构Folder Structure After Extraction

图 1.0 — 解压后的文件夹内容Fig 1.0 — Extracted folder contents

仪表盘概览Dashboard Overview

启动后，您将看到采用深色金色主题设计的控制台，核心功能一目了然。

On startup, you'll see a dark gold-themed dashboard with core features at a glance.

PSL 排行榜预览PSL Leaderboard Preview

访问 psl.lss.lol 查看速通榜、进度榜与个人刷图统计。

Visit psl.lss.lol for speedrun rankings, progress boards, and personal map stats.

图 1.2 — 剧情速通榜Fig 1.2 — Story Speedrun Leaderboard

图 1.3 — 刷图统计页面Fig 1.3 — Map Statistics Page

角色信息同步Character Sync

支持 WeGame（国服）与 poe.ninja（国际服）角色链接绑定，粘贴后即可快速同步角色信息，包括等级、职业、生命/魔力/护盾及力敏智六维属性。绑定后数据会自动上传至排行榜。

Supports WeGame (CN server) and poe.ninja (International server) character linking. Paste the URL to sync character info including level, class, HP/MP/ES, and STR/DEX/INT. Data auto-uploads to the leaderboard after binding.

方式一：WeGame 角色绑定（国服）Option 1: WeGame Binding (CN Server)

1. 打开浏览器，访问 WeGame 流放之路2 助手 - 角色页面。
2. Open browser and visit WeGame POE2 Helper - Character Page.
3. 登录你的 WeGame 账号，在角色列表中找到要绑定的角色。
4. Log in to your WeGame account and find the character you want to bind.
5. 点击角色进入详情页，复制浏览器地址栏中的完整 URL。
6. Click the character to view details, then copy the full URL from the address bar.
7. 回到 POE2 MapGuider，将链接粘贴到角色输入框中，点击"刷新"即可完成绑定。
8. Return to POE2 MapGuider, paste the link into the character input box, and click "Refresh" to complete binding.

图 1.4a — WeGame 助手角色页面，复制地址栏 URL 即可Fig 1.4a — WeGame Helper character page, copy the URL from address bar

方式二：poe.ninja 角色绑定（国际服）Option 2: poe.ninja Binding (International Server)

1. 打开浏览器，访问 poe.ninja 账号页面，登录你的 GGG 账号。
2. Open browser and visit poe.ninja account page, log in with your GGG account.
3. 在角色列表中找到你要绑定的角色，点击角色名进入详情页。
4. Find your character in the list and click the name to view details.
5. 复制浏览器地址栏中的完整 URL（格式类似 https://poe.ninja/poe2/builds/char/账号名/角色名）。
6. Copy the full URL from the address bar (format: https://poe.ninja/poe2/builds/char/account/charname).
7. 回到 POE2 MapGuider，将链接粘贴到角色输入框中，点击"刷新"即可完成绑定。
8. Return to POE2 MapGuider, paste the link into the character input box, and click "Refresh" to complete binding.

步骤 1 — 访问 poe.ninja 账号页面Step 1 — Visit poe.ninja account page

步骤 2 — 选择要绑定的角色Step 2 — Select character to bind

步骤 3 — 进入角色详情页Step 3 — Enter character details

步骤 4 — 复制地址栏 URL 粘贴到客户端Step 4 — Copy URL and paste into client

绑定后效果After Binding

绑定成功后，客户端会自动获取并显示角色的职业、等级、六维属性等信息。同时角色数据会同步到 PSL 排行榜，你可以在 角色档案 和 刷图统计 页面查看。

After binding, the client will automatically fetch and display your character's class, level, and six attributes. Data syncs to the PSL leaderboard — view it on Profile and Map Stats pages.

图 1.4b — 角色信息面板（含六维属性与认证状态）Fig 1.4b — Character info panel (with attributes and verification status)

地图统计Map Statistics

工具会自动读取游戏日志（Client.txt），识别您进入的地图区域并显示攻略。

The tool automatically reads the game log (Client.txt) to identify map areas you enter and display guides.

• 1 自动识别：进入地图时自动显示地图名称。 Auto Detection: Map name displays automatically when you enter.
• 2 地图攻略：自动显示当前地图攻略、BOSS 与奖励信息，减少遗漏精魂与天赋点。 Map Guide: Automatically shows current map guide, boss info, and rewards to help you not miss spirits and skill points.
• 3 耗时统计：离开地图或返回藏身处时，自动结算该次刷图用时，并显示最近两次地图记录。 Time Tracking: Automatically calculates run time when leaving map or returning to hideout, showing last 2 map records.
• 4 剧情速通计时：自动检测剧情开始（污流河畔）与通关（金字塔避难所），全程分段计时并上报速通榜。 Story Speedrun Timer: Auto-detects story start (Fetid Mire) and completion (Ziggurat Refuge), timing all segments and reporting to leaderboard.

图 1.5 — 地图识别与攻略展示Fig 1.5 — Map detection and guide display

横版支持（HB 悬浮窗）Horizontal Mode (HB Overlay)

横版模式更适合边刷图边看信息：窗口置顶、紧凑显示地图/计时/攻略，并尽量不遮挡游戏操作。

HB mode is ideal for viewing info while mapping: always-on-top window, compact display of map/timer/guide, designed to not obstruct gameplay.

图 1.6 — 横版（HB）主界面Fig 1.6 — HB mode main interface

图 1.7 — 左侧功能按钮Fig 1.7 — Left side buttons

图 1.8 — BOSS 信息与攻略展示Fig 1.8 — Boss info and guide display

PSL 排行榜PSL Leaderboard

PSL（POE2 Speedrun Leaderboard）是配套的在线排行榜系统，支持速通榜与进度榜两种视图，数据由客户端自动上传。

PSL (POE2 Speedrun Leaderboard) is the companion online ranking system with speedrun and progress views. Data is auto-uploaded by the client.

图 2.1 — PSL 速通榜与进度榜标签页Fig 2.1 — PSL Speedrun and Progress tabs

角色档案Profile

访问 psl.lss.lol/profile 查看个人角色列表与汇总统计。

Visit psl.lss.lol/profile to view your character list and summary stats.

图 2.2 — 角色档案页面Fig 2.2 — Profile page

刷图统计Map Records

访问 psl.lss.lol/maps 查看角色级刷图详情。

Visit psl.lss.lol/maps for character-level map run details.

图 2.3 — 刷图统计页面Fig 2.3 — Map Records page

常见问题 (FAQ)FAQ

G:\POE2\logs\Client.txt
F:\WeGameApps\rail_apps\流放之路：降临(2002052)\logs\Client.txt
Documents\My Games\Path of Exile 2\logs\Client.txt

更新日志Changelog