botty完全指南：从入门到精通的智能辅助系统自动化流程解决方案

botty是一款基于像素识别技术的暗黑破坏神2重制版智能辅助系统，通过先进的图像识别和智能决策技术，实现游戏流程的自动化操作。本文将带您全面了解botty的系统架构、核心功能、场景实践和深度优化方法，帮助您从入门到精通，提升游戏效率，解放双手，专注于策略与收集的乐趣。

一、基础认知：构建系统知识框架

1.1 系统架构解析：了解botty的工作原理

功能价值：掌握系统架构可帮助您理解各模块协同工作机制，为后续配置和优化奠定基础。

botty采用分层架构设计，主要包含以下核心模块：

• 图像采集层：负责实时捕捉游戏画面，为后续处理提供原始数据。
• 识别分析层：运用模板匹配和OCR技术，识别游戏元素如角色、怪物、物品、地形等。
• 决策逻辑层：基于有限状态机，根据识别结果做出下一步行动决策。
• 执行控制层：模拟鼠标键盘操作，实现游戏内的移动、攻击、拾取等动作。

上图展示了系统如何将显示器坐标转换为游戏窗口内的相对坐标，这是实现精确定位和操作的基础。左侧为显示器坐标系统，右侧为游戏窗口内的相对坐标系统，通过这种转换，botty能够准确识别和交互游戏内元素。

1.2 前置条件配置：打造稳定运行环境

功能价值：正确配置前置条件是系统稳定运行的保障，可避免90%以上的初期问题。

目标：搭建满足botty运行需求的软硬件环境。

环境检查：

• 操作系统：64位Windows 10/11
• 内存：基础值8GB×角色数量系数（单角色建议8GB，多角色建议16GB及以上）
• 显卡：支持DirectX 11，确保图像捕捉流畅
• Python环境：3.10版本

执行命令：

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/bo/botty

# 进入项目目录
cd botty

# 创建并激活虚拟环境
conda env create -f environment.yml
conda activate botty

⚠️ 风险提示：请确保使用conda创建虚拟环境，避免与系统Python环境冲突。

✅ 结果验证：成功激活虚拟环境后，命令行提示符前会显示"(botty)"。

1.3 游戏环境设置：确保图像识别准确性

功能价值：优化游戏设置可使识别准确率提升至95%以上，是系统正常工作的关键。

目标：配置游戏参数以匹配botty的图像识别要求。

环境检查：

• 游戏分辨率是否为1280×720
• 画面质量是否设为"低"
• 游戏语言是否为英文
• 是否启用窗口化全屏模式

操作步骤：

1. 启动暗黑破坏神2重制版
2. 进入游戏设置界面
3. 调整显示设置：
   • 分辨率：1280×720（720p）
   • 画面质量：低（关闭抗锯齿和特效）
   • 语言：英文
   • 窗口模式：窗口化全屏
4. 保存设置并重启游戏

为什么需要这些设置？因为botty的图像识别模板是基于720p分辨率制作的，不同分辨率会导致识别坐标偏移；关闭特效可以减少画面干扰，提高识别准确率；英文语言设置确保物品名称识别正常。

✅ 结果验证：启动游戏后，确认游戏窗口分辨率为1280×720，画面无复杂特效。

1.4 核心配置文件解析：定制系统行为

功能价值：理解配置文件结构可实现个性化系统设置，满足不同角色和场景需求。

botty的主要配置文件位于config目录下，包括：

• params.ini：系统核心参数配置
• game.ini：游戏相关设置
• shop.ini：商店相关配置
• 职业配置文件（如paladin.ini、sorceress.ini等）

以params.ini为例，关键配置项说明：

配置项	推荐值	作用机制	调整策略
game_window_title	"D2R"	用于识别游戏窗口	确保与游戏窗口标题一致
screen_width	1280	游戏窗口宽度	与游戏分辨率保持一致
screen_height	720	游戏窗口高度	与游戏分辨率保持一致
notification_enabled	True	是否启用通知提示	新手建议开启，熟悉后可关闭

思考问题：为什么建议新手开启通知提示功能？

二、核心功能：掌握系统关键能力

2.1 图像识别系统：botty的"眼睛"

功能价值：了解图像识别原理可帮助您解决识别不准确问题，提升系统可靠性。

技术原理解析： botty采用模板匹配和OCR（光学字符识别）相结合的图像识别技术。系统将实时捕捉的游戏画面与预定义的图像模板进行比对，识别出角色、怪物、物品等元素的位置和属性。OCR技术则用于识别物品名称、血量、魔法值等文本信息。

传统方案与botty识别技术对比：

识别方案	传统内存读取	botty像素识别
实现方式	读取游戏内存数据	分析屏幕像素信息
安全性	高风险，易被检测	低风险，模拟人工视觉
兼容性	受游戏版本限制	与游戏版本无关
配置复杂度	高，需修改游戏	低，仅需设置游戏参数

上图展示了botty的图形调试界面，左侧为识别数据面板，中间为游戏画面实时分析，右侧为物品识别结果。通过这个工具可以直观地看到系统如何"理解"游戏画面，帮助您调试和优化识别效果。

2.2 路径规划系统：智能导航的核心

功能价值：掌握路径规划原理可优化刷图效率，减少角色卡住情况。

技术原理解析： botty的路径规划系统基于预定义的地图节点和动态路径计算。系统将游戏场景划分为多个节点，通过识别场景特征判断当前位置，然后选择最优路径到达目标点。对于随机生成的地图，系统会根据模板匹配识别地图布局，选择对应的导航策略。

上图展示了混沌避难所的路径规划系统，不同颜色的线条代表不同布局的最优路径。系统通过识别地图特征来判断当前布局类型，然后选择对应的导航路径，确保角色高效到达目标位置。

性能基准测试：

• 标准测试场景：崔凡克
• 测试方法：连续运行10次，记录平均完成时间和路径偏差率
• 优化目标：平均完成时间<2分钟，路径偏差率<5%

2.3 战斗策略系统：自动化战斗的大脑

功能价值：合理配置战斗策略可提升刷图效率30%，降低角色死亡风险。

技术原理解析： 战斗策略系统基于有限状态机设计，包含以下状态：

1. 探索状态：寻找怪物和目标区域
2. 战斗状态：攻击怪物，使用技能和药水
3. 拾取状态：收集掉落物品
4. 恢复状态：回城补给，修理装备

每个状态都有明确的转换条件和行为规则，例如当生命值低于设定阈值时，系统会自动切换到恢复状态。

配置示例：

[skills]
primary_attack = 1          ; 主要攻击技能热键
secondary_attack = 2        ; 次要攻击技能热键
buff_skill = 3              ; 增益技能热键

[combat]
attack_range = 10           ; 攻击距离（近战角色5-10，远程角色15-20）
aggressive_level = 7        ; 进攻积极性（1-10，越高越激进）
health_potion_threshold = 40 ; 生命值低于此百分比时使用药水（%）
mana_potion_threshold = 30   ; 魔法值低于此百分比时使用药水（%）

调整策略：根据角色职业和build调整参数。例如，法师应设置较大的攻击距离和较低的进攻积极性，保持安全输出位置；圣骑士则可以设置较小的攻击距离和较高的进攻积极性，发挥近战优势。

2.4 物品拾取系统：智能筛选战利品

功能价值：优化拾取规则可避免背包被垃圾物品填满，提升目标物品获取效率。

技术原理解析： botty的物品拾取系统使用BNIP（Botty物品拾取）规则，通过配置文件定义拾取策略。系统识别物品后，根据物品类型、品质、属性等特征，结合BNIP规则决定是否拾取。

配置示例：

// 拾取所有符文
Rune = *

// 拾取稀有以上品质的戒指和项链
Ring = Rare, Unique, Set
Amulet = Rare, Unique, Set

// 忽略白色物品
Normal = !*

// 拾取特定暗金物品
Unique = "Tal Rasha's Guardianship", "Mavina's True Sight"

常见误区：设置过于宽松的拾取规则会导致背包频繁填满，反而降低刷图效率。建议根据角色目标和当前需求，精准配置拾取规则。

三、场景实践：将技术应用于游戏

3.1 崔凡克刷图配置：高效获取符文

功能价值：掌握崔凡克场景配置可实现每小时20+次稳定刷图，高效获取高级符文。

目标：配置botty自动刷崔凡克议会成员。

环境检查：

• 角色：圣骑士（推荐祝福之锤build）
• 装备：至少250%MF（魔法装备获取率）
• 游戏难度：地狱

操作步骤：

1. 配置职业文件：

   cd config
   copy paladin.ini my_paladin.ini
   

2. 编辑my_paladin.ini，设置技能和战斗参数：

   [skills]
   primary_attack = 1  ; 祝福之锤
   secondary_attack = 2  ; 专注光环
   buff_skill = 3  ; 活力光环
   
   [combat]
   attack_range = 15
   aggressive_level = 6
   health_potion_threshold = 50
   

3. 配置刷图路径： 打开src/run/trav.py文件，调整路径节点和循环次数。

上图为崔凡克场景的路径节点示例，绿色圆圈为关键目标点，蓝色数字标记为路径节点。系统通过依次移动到这些节点实现自动导航。

执行命令：

python src/main.py --char paladin --run trav

✅ 结果验证：系统启动后，观察角色是否能正确导航至崔凡克，攻击议会成员，并拾取物品。

3.2 牛场 farming 配置：海量怪物高效清场

功能价值：优化牛场配置可实现每小时8-10次牛场清理，获取大量装备和符文。

目标：配置botty自动进入牛场并清理所有怪物。

环境检查：

• 角色：法师（推荐暴风雪build）
• 装备：至少200%MF，40%以上快速施法
• 钥匙：已获取赫拉迪姆方块和怀特之腿

操作步骤：

1. 配置法师职业文件：

   [skills]
   primary_attack = 1  ; 暴风雪
   secondary_attack = 2  ; 冰尖柱
   buff_skill = 3  ; 能量护盾
   
   [combat]
   attack_range = 20
   aggressive_level = 5
   health_potion_threshold = 30
   mana_potion_threshold = 40
   

2. 设置牛场入口识别参数： 在src/run/cows.py中调整牛场入口识别模板和阈值。
3. 配置回城补给条件： 在config/params.ini中设置：

   [inventory]
   town_chicken_health = 20  ; 生命值低于20%回城
   town_full_inventory = True  ; 背包满时回城
   

执行命令：

python src/main.py --char sorceress --run cows

⚠️ 风险提示：牛场怪物密集，确保角色有足够的生存能力，建议先手动测试几次再开启自动运行。

3.3 商店刷新配置：自动购买目标物品

功能价值：配置商店刷新可自动获取特定暗金、绿色装备或符文之语底材，节省手动刷新时间。

目标：配置botty自动刷新特定NPC商店，购买目标物品。

环境检查：

• 角色：任何职业（推荐法师，有传送技能）
• 游戏难度：地狱
• 目标NPC：例如，第三幕的奥玛斯（出售法杖和珠宝）

操作步骤：

1. 配置商店刷新参数： 编辑config/shop.ini：

   [shop]
   npc = "ormus"  ; 目标NPC名称
   refresh_interval = 30  ; 刷新间隔（秒）
   max_refreshes = 100  ; 最大刷新次数
   
   [items]
   ; 购买所有2孔法师单手杖
   staff = "2os, +3暴风雪, +3冰尖柱"
   ; 购买特定珠宝
   jewel = "+30%ED, +15%IAS"
   

2. 配置角色移动路径： 编辑src/shop/ormus.py，设置从传送点到奥玛斯的路径。

执行命令：

python src/main.py --char sorceress --shop ormus

✅ 结果验证：系统启动后，观察角色是否能正确到达NPC处，刷新商店，并购买符合条件的物品。

3.4 多角色轮换配置：最大化资源获取效率

功能价值：配置多角色轮换可实现24小时不间断刷图，资源获取效率提升300%。

目标：设置多个角色自动轮换刷图。

环境检查：

• 多个游戏账号
• 不同职业角色（如圣骑士、法师、死灵法师）
• 已配置好各角色的刷图方案

操作步骤：

1. 创建账号配置文件： 在config目录创建accounts.ini：

   [account1]
   username = "user1"
   password = "pass1"
   char_name = "paladin_trav"
   run_type = "trav"
   run_count = 20  ; 运行20次后切换
   
   [account2]
   username = "user2"
   password = "pass2"
   char_name = "sorceress_cows"
   run_type = "cows"
   run_count = 15
   

2. 配置轮换参数： 编辑config/params.ini：

   [rotation]
   enable_rotation = True
   rotation_interval = 3600  ; 每小时轮换一次
   

执行命令：

python src/main.py --rotation accounts.ini

思考问题：多角色轮换时，如何避免被游戏服务器检测？（提示：合理设置轮换间隔，避免过于规律的操作模式）

四、深度拓展：优化与进阶技巧

4.1 性能优化：提升系统运行效率

功能价值：通过性能优化，可使系统CPU占用率降低40%，内存占用减少30%，运行更流畅。

技术原理解析： botty的性能优化主要从以下几个方面入手：

• 图像缓存：减少重复识别相同区域，降低CPU占用
• 多线程处理：分离识别和决策过程，提高并行处理能力
• 动态调整：根据电脑性能自动调整识别频率和图像处理精度

优化参数配置： 编辑config/params.ini：

[performance]
detection_fps = 20  ; 识别频率（默认30，低配电脑可降低至15-20）
render_scale = 0.8  ; 渲染缩放（默认1.0，可降低至0.8提高速度）
thread_count = 4  ; 线程数量（根据CPU核心数调整，建议设置为核心数的一半）
image_cache_size = 50  ; 图像缓存大小（MB）

性能基准测试方法：

1. 启动系统并运行目标场景30分钟
2. 使用任务管理器记录CPU和内存占用率
3. 修改优化参数后再次测试
4. 比较各项指标，找到最佳配置

优化目标：CPU占用率<50%，内存占用<2GB，识别准确率>95%。

4.2 自定义路径编辑：适应复杂场景

功能价值：掌握自定义路径编辑可使系统适应各种复杂地图布局，提高刷图效率。

技术原理解析： botty的路径系统基于节点坐标和连接关系。每个场景由一系列节点组成，节点间通过路径连接。系统通过依次移动到这些节点实现导航。

操作步骤：

1. 启动路径录制工具：

   python src/utils/node_recorder.py
   

2. 在游戏中手动移动角色，按F1记录路径节点
3. 按F2保存路径文件，命名为custom_path.json
4. 在对应场景的运行文件中加载自定义路径：

   # 在src/run/custom.py中
   from utils.path_loader import load_path
   
   path_nodes = load_path("custom_path.json")
   

路径优化技巧：

• 关键转折点添加节点，提高导航精度
• 避免节点过于密集，减少计算负担
• 战斗区域适当增加节点，确保怪物清理彻底

4.3 问题诊断与优化：解决常见故障

功能价值：掌握问题诊断方法可快速定位和解决系统运行中的各种问题，减少停机时间。

常见问题及解决方案：

1. 识别不准确

   • 症状：物品认错、目标丢失
   • 原因：游戏设置不正确、图像干扰
   • 解决方案：

     # 重新生成识别样本
     python src/utils/gen_ocr_samples.py
     

     确保游戏分辨率为1280×720，关闭特效，语言设为英文。

2. 角色卡住

   • 症状：角色在某个位置反复移动或停止不动
   • 原因：路径节点配置不合理、地形识别错误
   • 解决方案： 调整config/params.ini中的参数：

     [movement]
     stuck_recovery = 3  ; 增加卡住恢复次数
     movement_speed = 1.2  ; 调整移动速度系数
     

     检查并优化路径节点。

3. 系统崩溃

   • 症状：程序意外关闭
   • 原因：依赖库版本问题、资源不足
   • 解决方案：

     # 查看错误日志
     cat logs/error.log
     
     # 重新创建conda环境
     conda env remove -n botty
     conda env create -f environment.yml
     

日志分析工具：

python src/utils/log_analyzer.py --log_file logs/bot.log

该工具可自动分析日志文件，识别常见问题并给出解决方案建议。

4.4 进阶学习路径：成为botty专家

功能价值：通过系统学习，可深入理解botty的工作原理，实现自定义功能开发和高级优化。

学习路径图：

1. 基础阶段：

   • 熟悉配置文件结构
   • 掌握基本场景配置
   • 学习日志分析方法

2. 进阶阶段：

   • 研究路径规划算法
   • 学习图像识别原理
   • 掌握性能优化技巧

3. 专家阶段：

   • 开发自定义插件
   • 优化核心算法
   • 参与社区贡献

社区资源：

• 项目文档：development.md
• 代码仓库：项目源代码目录
• 问题讨论：项目issue跟踪系统
• 知识分享：社区论坛和Discord群组

通过本指南，您已经全面了解了botty智能辅助系统的基础认知、核心功能、场景实践和深度拓展知识。随着使用经验的积累，您可以不断优化配置，打造最适合自己的自动化方案。记住，技术是为游戏体验服务的，合理使用辅助工具，享受游戏的乐趣！祝您游戏愉快，收获满满！