Path of Building PoE2 离线BD规划器完整指南：从安装到跑通第一个 Build
【免费下载链接】PathOfBuilding-PoE2项目地址: https://gitcode.com/GitHub_Trending/pa/PathOfBuilding-PoE2
Path of Building PoE2 是《流放之路2》（Path of Exile 2，简称 PoE2）的离线BD规划器：天赋加点、装备搭配、技能宝石和伤害计算全放在一个窗口里完成，所有计算都在本地跑，不碰你的正式角色，改多少遍都不心疼。它最适合两类人——想先想清楚再开荒的新手，和想快速验证某件装备、某个节点值不值得换的老手。
流程很短：不需要自己编译，也不用装游戏运行环境，解压即用。哪怕今天只跑通"一个会变的数字"，这个工具对你就已经立住了。
从安装到第一次读数：让 Path of Building PoE2 跑起来看到第一个变化的数字
先说结论：从下载到你看到第一个实时变化的数字，十分钟以内。
去项目的 Releases 页面拿安装向导或免安装 zip，解压到一个你记得住的目录。如果你习惯从源码入手，git clone https://gitcode.com/GitHub_Trending/pa/PathOfBuilding-PoE2后直接运行runtime目录下的可执行文件，它会自动进入开发模式，方便后面调试。
启动后停在构建选择界面：按Ctrl + N新建一个 build，选好职业、升华和等级。切到技能页（Ctrl + 2），放入一个主技能宝石，悬停宝石会弹出详情面板：
侧栏的属性总览和计算页会立刻给出该技能的伤害、命中速率等数字。只要这个数字会随你的每次改动实时变化，你就算完成了"第一次有效操作"。
完整实战：给法师配主技能并验证理论 DPS
一句话任务：给一个法师角色把主技能配齐，确认理论 DPS 是否合理。
开始前备齐：职业与升华已选定；一个主技能宝石加若干辅助宝石（精准、元素穿透这类）；一件武器或防具。
操作走一遍：
- 天赋页规划基础节点。天赋树是环形轨道结构，按住 Shift 悬停一串节点再点击，整条路径一次性点完，比逐点快得多。
- 技能页先加主技能，再逐个上辅助宝石；光环、诅咒、buff 类支持技能可随时开关，方便单独看某一条的加成。
- 装备页加入武器：直接粘贴游戏内文本，或从物品数据库里选一件独特物品，手动挑选每条前缀/后缀的数值。
- 切到计算页读数。
最终看到什么：侧栏给出生命、护盾、抗性等生存数值；计算页给出主技能的伤害、命中、DoT，而且能看到数字是怎么一步步算出来的。
容易走偏的地方：主技能若是攻击型，计算会区分主手和副手两条输出路径，结果要对到正确的武器上再下结论；出现红色修饰词，说明该效果尚未纳入计算，此时的伤害可能偏乐观也可能偏保守。
结果怎么读：蓝红标注、逐项拆解与主手副手输出路径
核心看法：侧栏是"总览"，计算页是"明细账"，下结论前两边都要过一遍。
生命、能量盾、抗性在侧栏属性总览里汇总；计算页的逐项拆解展示每个数字是怎么推出来的。修饰词颜色是最重要的信号：蓝色表示计算已覆盖，红色表示暂不支持。看到红色别急着下结论，先翻计算页确认这个效果是否碰到了你的最终数字。
还有两个细节决定数字可信度：
- 宝石插进装备后，孔位附带的修饰词、物品赠送的辅助宝石都会自动应用，不用你逐条手输；
- 攻击型技能主手、副手分开算，换装后记得看对应那件武器的那一行。
从游戏里粘贴装备文本时，未损坏物品的品质也会自动补上，粘完就能直接用。
分享码怎么用：存档、方案对比与队友核对配置
一句话：分享码就是这套工具的"存档位"。
每个 build 都能生成一个分享码——在 Import/Export 标签页先点 Generate，再点 Share，即可发给别人或自己留存。它的用法不止"发给朋友"：
- 存档与复现：之后发现数字不对，把码发出去，对方能精确还原当时的状态；
- 对比方案：同一个方向的两版方案各存一个码，回来对照着比谁更优；
- 与队友核对：辅助向玩法里逐个切换光环、诅咒、充能 buff，确认每条都真实生效、生效多少。
排错手册：四个常见现象的快速对照
按"现象 → 可能原因 → 处理办法"查，基本够覆盖日常踩坑。
修饰词显示红色→ 该效果暂未被解析或支持。先在计算页逐项拆解里确认它是否影响了你的结论；做开发的话，按 docs/addingMods.md 补一条解析规则，并记得重新生成修饰词缓存。
换了装备数字却没变→ 多半是主技能组没选对，或天赋链接没真正生效。回天赋页确认路径连通，再到技能页确认当前生效的是哪个技能组。
Linux 下双击 exe 起不来→ 可执行文件仍是 Windows 程序。用 wine 启动即可。
想调试却找不到入手点→ 从源码启动会进入开发模式：F5原地重启，Ctrl + ``呼出控制台，按住Alt悬停可查看修饰词的内部解析细节。
深入阅读：代码模块索引、文档清单与贡献入口
想改代码，先看这几处核心：
- 输出与防御计算：src/Modules/CalcOffence.lua、src/Modules/CalcDefence.lua
- 天赋树交互：src/Classes/PassiveTree.lua；装备解析：src/Classes/Item.lua
- 游戏数据（基础物品、独特物品、技能宝石）：src/Data/；导数脚本：src/Export/
docs/ 里的文档建议按顺序读：rundown.md 代码结构总览、addingMods.md 新增修饰词解析、calcOffence.md 输出计算原理、modSyntax.md 修饰词语法、addingSkills.md 技能添加。
版本历史在 CHANGELOG.md；贡献流程、bug 报告规范（先确认已是最新版本、尽量附上受影响的分享码）以及 MIT 许可都在 CONTRIBUTING.md。测试基于 Busted 框架，位于 spec/System/，本地跑一遍docker-compose up即可验证改动没破坏既有行为。
【免费下载链接】PathOfBuilding-PoE2项目地址: https://gitcode.com/GitHub_Trending/pa/PathOfBuilding-PoE2
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
