ChaosRecipeEnhancer应用指南：从安装到精通

核心功能概览：这款工具能为你解决什么问题？

ChaosRecipeEnhancer（简称CRE）是一款专为《Path of Exile》玩家设计的辅助工具，主要解决三大核心痛点：自动识别混沌配方所需物品、实时标记储物箱中的目标装备、提供可视化界面追踪收集进度。通过智能覆盖层技术，它能在游戏画面中直接标注物品类别和状态，让玩家无需切换窗口即可高效完成配方收集。

[!TIP] 混沌配方是游戏中稳定获取混沌石的重要途径，但手动收集6件不同部位稀有装备的过程繁琐且容易出错。CRE将这一过程自动化，平均可节省30%的整理时间。

环境准备：如何搭建运行环境？

🔧 系统要求

• 操作系统：Windows 10/11（64位）
• 运行时：.NET Framework 4.8 或更高版本
• 游戏版本：Path of Exile 3.20+

🔧 安装步骤

1. 克隆项目仓库：git clone https://gitcode.com/gh_mirrors/en/EnhancePoEApp
2. 进入项目目录：cd EnhancePoEApp
3. 运行启动脚本：scripts/start.ps1

📌 重要提示：首次运行需通过Windows Defender SmartScreen验证，选择"更多信息"→"仍要运行"。

快速上手：3分钟完成首次配置

🔧 账号授权

1. 启动程序后，在登录界面输入Path of Exile账号信息
2. 完成OAuth授权流程（约15秒）
3. 验证成功后自动跳转至主界面

🔧 基础设置

配置项	默认值	推荐值
覆盖层透明度	70%	85%（兼顾可见性与游戏体验）
物品扫描频率	2秒/次	1秒/次（高端配置）
音效提示	开启	仅稀有物品提示

深度配置：打造个性化工作流

🔧 过滤规则自定义

通过"Filter Styles"标签页调整物品高亮样式：

• 颜色编码：可将武器设置为黄色，护甲设置为蓝色
• 图标大小：根据屏幕分辨率调整（推荐120%缩放）
• 显示优先级：设置稀有度权重，让传奇物品始终置顶显示

🔧 热键设置

在"Hotkeys"面板配置：

• 快速扫描：默认F5
• 切换覆盖层：默认Ctrl+Shift+O
• 自动整理：默认Alt+R

[!TIP] 建议将"自动整理"热键与游戏内"移动物品"热键区分开，避免误操作。

扩展开发：如何参与功能改进？

🔧 架构概览

CRE采用客户端-服务器架构，核心组件包括：

• 桌面客户端（C# WPF）：负责游戏画面捕捉与用户交互
• API网关：处理与游戏服务器的通信
• 认证服务：管理用户授权与会话

🔧 本地开发环境

1. 安装Visual Studio 2022（需.NET桌面开发 workload）
2. 打开解决方案：ChaosRecipeEnhancer.sln
3. 设置启动项目为ChaosRecipeEnhancer.UI

常见问题速查表

Q: 覆盖层不显示怎么办？
A: 检查游戏是否以窗口化模式运行，分辨率是否与CRE设置匹配，尝试按下Ctrl+Shift+O重置覆盖层。

Q: 物品识别不准确如何解决？
A: 在设置中提高"扫描精度"至90%，或在Settings.xml中调整ItemRecognitionThreshold参数。

Q: 会被游戏官方视为作弊吗？
A: 不会。CRE仅读取游戏画面并提供辅助显示，不修改游戏内存或发送额外网络请求。

社区资源导航

• 官方文档：[DocumentationAssets/Wiki Files/User Guide.md](https://gitcode.com/gh_mirrors/en/EnhancePoEApp/blob/1af2f00e1a4a9353c186705e06c46d6ebf2450f0/DocumentationAssets/Wiki Files/User Guide.md?utm_source=gitcode_repo_files)
• 贡献指南：CONTRIBUTING.md
• 问题反馈：AGENTS.md