avdergh/poe2-exile-architect

Name: avdergh/poe2-exile-architect
Author: avdergh

Plugin插件 ⭐ 8 MIT Memory & Knowledge记忆与知识库

Research, create, and understand Path of Exile 2 builds with AI agents and Path of Building.

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

Exile Architect is a Model Context Protocol (MCP) server built to help AI agents research, create, and understand Path of Exile 2 character builds. It works with three popular AI agent hosts: Codex, OpenCode, and DeepSeek Harness, connecting the agent to local game data, a custom build knowledge base, and a headless instance of the Path of Building (PoB) calculation engine. The AI agent handles build design decisions, while PoB supplies accurate numerical calculations and build validation checks, with all core operations running locally on the user’s machine. No remote services are required for core functionality, so all your build data stays private on your own device.

It offers three distinct workflows that users can run independently of each other. The research workflow extracts useful knowledge about mechanics, synergies, and requirements from existing builds, saving findings to the local knowledge base for future use. The create workflow pulls relevant existing knowledge from the base to design a new build for a given class, skill, and target level, then runs validation checks via PoB. The learning workflow generates a navigable HTML guide with diagrams and explanations to help users understand how an existing build works.

To install Exile Architect, you first need to install Git, uv, Python 3.11+, and LuaJIT 2.1, then check out the source code from GitHub and configure it for your chosen agent host. All research data and generated build files are stored locally on your machine, and the project is released under the open-source MIT license. Currently, the tool only generates builds for a specified target level, not a full leveling guide, and any mechanics not covered by PoB are explicitly called out in results.

这是一个为《流亡黯道2》（Path of Exile 2）配装设计打造的MCP服务器，支持Codex、OpenCode和DeepSeek Harness三款AI代理，可将AI代理连接到本地游戏数据库、自建配装知识库和无界面Path of Building（PoB）计算引擎。AI代理负责配装设计决策，PoB提供伤害、防御等数值计算和配装校验，所有核心操作都在用户本地运行，不依赖第三方远程服务。

它提供三种工作流：从现有配装提取知识存入本地知识库的研究流、基于已有知识设计新配装并输出校验结果的创建流、生成带图解说明的HTML配装学习指南的学习流。三种工作流可独立使用，研究积累的知识能帮助创建流设计出更合理的新配装，适合POE2玩家研究配装、设计流派玩法使用。

安装需要先准备Git、uv、Python 3.11+、LuaJIT 2.1，检出源码后按照对应代理的安装步骤配置即可。所有配装研究和生成文件都存储在本地，项目采用MIT许可，不支持生成完整升级指南，仅输出目标等级的配装方案，未被PoB覆盖的机制会单独标注说明。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：poe2-exile-architect（avdergh/poe2-exile-architect）
仓库：https://github.com/avdergh/poe2-exile-architect
本站详情页：https://www.yhbd.top/plugins/avdergh-poe2-exile-architect/
本站登记：类型 plugin · 归类 多平台兼容工具（非 DSH 原生） · 许可证 MIT · ⭐ 8 · 最近提交 2026-09-18 · 主语言 Python · 未检测到 DSH 插件清单

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意

Only 8 stars - very few users, little community feedback星标只有 8，几乎没人在用，遇到问题缺少社区反馈
No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单：可能只是打了 dsh-plugin 话题，安装方式要现场确认
Not DSH-native: a multi-platform tool that may require Node / Electron or another runtime first非 DSH 原生，是多平台兼容工具：可能要先装 Node / Electron 等运行时

DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add github:avdergh/poe2-exile-architect

把 avdergh/poe2-exile-architect 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

16.8 KB · 缓存于 2026-09-18 19:38:21 · 16.8 KB

Exile Architect

English · 简体中文

Research, create, and understand Path of Exile 2 builds with your AI agent.

Exile Architect connects Codex, OpenCode, and DeepSeek Harness to Path of Exile 2 game data, a local build knowledge base, and Headless Path of Building (PoB). Your agent makes the design decisions; PoB supplies the calculations and the build checks.

Install · Usage · Showcase · FAQ · Contributing

Local knowledge base and PoB validation

Local knowledge base

Research turns mechanics, component interactions, and usage conditions from existing builds into research records stored on your computer. The knowledge carries across conversations, and Create retrieves relevant records when designing a new build, reusing earlier research.
Local execution

Game data queries, knowledge storage, and PoB calculations run on your machine, and build files are saved locally. The model uses your agent host's existing configuration; whether online research and model calls use remote services depends on the task and host settings.
PoB validation

The equipment, skills, and passives designed by the agent are written into PoB before damage, defense, and resource data are read back. The numbers correspond to a specific build and combat configuration and can be checked. Mechanics that PoB does not cover are documented separately, and estimates are shown separately from calculated results.

Three workflows

I want to…	Use	What I get
Extract useful knowledge from an existing build	Research · `poe-bd-research`	Saved explanations of mechanics, component synergies, requirements, and failure cases that future builds can draw on
Design a build for a class, skill, and target level	Create · `poe-bd-create`	Skill, equipment, and passive choices; PoB checks; local build files and a playstyle explanation
Understand how an existing build works	Learning · `poe-bd-learn`	An HTML learning guide with component icons, combat-loop diagrams, explanations, navigation, and search

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要，完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

渲染基于仓库 avdergh/poe2-exile-architect 的 README.md。在 GitHub 查看原文 →