Hearthstone-Script 炉石传说脚本安装配置指南

Hearthstone-Script 是一款开源的炉石传说脚本工具，作为专业的 Hearthstone自动化工具，能够帮助玩家实现卡组策略配置与自动化对战。本指南将详细介绍 Windows 系统下的安装配置流程，帮助新手用户快速上手这款游戏辅助工具，轻松掌握自动化卡组管理技巧。

1. 环境准备与兼容性检测

1.1 系统要求

[!NOTE] 目前仅支持 Windows 操作系统，已在 Windows 10 和 Windows 11 环境下完成测试。

1.2 必备组件

• JDK 21：脚本运行的基础环境，若未安装，首次启动时将自动下载安装
• 炉石传说客户端：需提前安装并能正常运行

1.3 兼容性检查

✅ 系统版本确认：按下 Win + R，输入 winver 检查 Windows 版本
✅ 硬件加速设置：确保显卡驱动已更新，禁用可能影响游戏窗口识别的屏幕缩放
✅ 安全软件配置：暂时关闭或添加例外规则，避免拦截脚本文件操作

2. 软件获取与安装

2.1 下载软件包

⚠️ 注意：请通过官方渠道获取软件，避免下载第三方修改版本导致安全风险。

1. 访问项目仓库，下载最新版 hs-script.zip 文件
2. 验证文件完整性（如有提供校验值）

2.2 解压安装

1. 选择非系统盘（如 D:\Program Files）创建安装目录
2. 使用解压工具将 hs-script.zip 解压至目标文件夹
3. 确认解压后根目录包含以下关键文件：

   hs-script.exe      # 主程序
   force-stop.exe     # 强制关闭工具
   config/            # 配置文件目录
   log/               # 日志文件目录
   

3. 卡组与策略配置

3.1 游戏内卡组准备

1. 启动炉石传说客户端
2. 将待使用的卡组移动至一号卡组位
3. 确认卡组包含脚本支持的卡牌类型

3.2 策略选择与配置

1. 双击运行 hs-script.exe 启动程序
2. 在主界面选择游戏模式（如标准模式/狂野模式）
3. 从策略列表中选择适配卡组的自动化策略：
   • ⚡ 秒投策略：快速投降完成任务
   • 🏹 基础策略：通用卡组适配，无特殊卡牌逻辑
   • 🔥 激进策略：优先释放法术和战吼随从
   • 🤖 MCTS 策略：智能决策，需较高CPU性能

4. 脚本启动与运行管理

4.1 启动脚本

1. 在软件主界面点击「开始」按钮，或使用快捷键 Ctrl + P
2. 首次运行将检查 JDK 环境，缺失时自动下载安装
3. 程序启动后可关闭主窗口，脚本将在系统托盘后台运行

4.2 运行状态监控

🖥️ 托盘图标状态：

• 绿色：正常运行中
• 黄色：暂停状态
• 红色：发生错误

4.3 停止脚本

⚠️ 注意：请勿直接结束进程，可能导致配置数据丢失。

1. 方法一：双击运行 force-stop.exe
2. 方法二：使用快捷键 Alt + P
3. 方法三：右键点击系统托盘图标，选择「退出」

5. 高级配置与优化

5.1 热键自定义

1. 打开软件安装目录下的 config/hotkey.ini 文件
2. 修改对应功能的快捷键组合，格式示例：

   [Hotkeys]
   START_PAUSE=Ctrl+P
   FORCE_STOP=Alt+P
   

3. 保存后重启软件生效

5.2 性能优化设置

[!NOTE] 低配置电脑建议降低策略复杂度以避免卡顿。

1. 在「设置」→「高级选项」中：
   • 降低 MCTS 策略的迭代次数
   • 关闭「实时数据分析」功能
   • 调整鼠标移动速度参数

5.3 开机自启配置

1. 打开软件设置界面
2. 勾选「系统设置」→「开机自动启动」选项
3. 确认 Windows 任务管理器的启动项中已添加脚本程序

6. 安全使用与风险提示

6.1 使用规范

[!WARNING] 本工具仅供学习交流使用，请勿用于商业用途或违反游戏协议的场景。

1. 合理控制使用频率，避免账号风险
2. 不修改内存或游戏客户端文件
3. 定期更新至最新版本以获取安全补丁

6.2 数据安全

1. 定期备份 config 目录下的配置文件
2. 敏感操作前导出卡组配置
3. 日志文件包含游戏行为记录，请注意隐私保护

7. 故障排除与支持

7.1 常见问题速查表

问题现象	可能原因	解决方案
启动无响应	缺少运行库	安装 Visual C++ Redistributable
注入失败	权限不足	右键以管理员身份运行程序
卡组识别错误	卡组位置错误	确认卡组已放置在一号卡组位
鼠标移动异常	分辨率问题	将游戏窗口设置为原生分辨率

7.2 获取技术支持

1. 收集故障信息：
   • log 目录下的最新日志文件
   • 炉石客户端 Logs 文件夹中的游戏日志
2. 通过项目的 issue 系统提交问题报告
3. 描述问题时需包含：
   • 操作系统版本
   • 软件版本号
   • 问题复现步骤
   • 相关截图或录屏

7.3 手动更新程序

1. 下载新版 hs-script.zip 文件
2. 关闭正在运行的脚本
3. 删除旧版 new_version_temp 文件夹（如有）
4. 将新版压缩包放置在软件根目录
5. 双击运行 update.exe 完成更新

8. 附录

8.1 目录结构说明

Hearthstone-Script/
├── config/            # 配置文件目录
├── doc/               # 文档资料
├── hs_cards.db        # 卡牌数据库
├── hs-script.exe      # 主程序
├── force-stop.exe     # 强制关闭工具
├── log/               # 日志文件
└── static/            # 静态资源

8.2 常用配置参数

在 config/settings.ini 中可调整以下参数：

[Game]
WINDOW_TITLE=炉石传说    # 游戏窗口标题
DETECT_INTERVAL=500     # 窗口检测间隔(ms)

[Strategy]
MAX_THINK_TIME=3000     # 最大思考时间(ms)
RANDOM_DELAY=500-1500   # 随机操作延迟范围(ms)

8.3 快捷键一览

• Ctrl + P：启动/暂停脚本
• Alt + P：停止脚本
• Ctrl + L：打开日志目录
• F1：显示帮助文档

图：Hearthstone-Script 主界面及策略选择区域