从零开始：HSTracker完整安装与高效使用指南

想在macOS上轻松管理《炉石传说》卡组并自动跟踪对战？本指南将带你完成HSTracker的全部部署流程，从环境准备到高级功能配置，让你快速掌握这款强大工具的使用技巧，提升游戏体验。

📋 准备工作：系统要求与文件获取

在开始安装前，请确保你的设备满足以下条件：

• 操作系统：macOS 10.10或更高版本
• 存储空间：至少100MB可用空间
• 已安装《炉石传说》客户端

获取HSTracker有两种方式：

1. 直接下载：访问官方发布页面获取最新版压缩包
2. 源码编译：通过Git克隆仓库后自行构建

   git clone https://gitcode.com/gh_mirrors/hs/HSTracker
   

⚠️ 注意：Windows用户请选择"Hearthstone Deck Tracker"，HSTracker专为macOS设计。

🚀 快速部署：从安装到首次启动

基础安装步骤

1. 解压下载的压缩包（若从源码构建请先完成编译）
2. 将HSTracker.app拖入/Applications目录
3. 首次启动时可能需要允许"来自不明开发者"的应用运行（系统偏好设置→安全性与隐私）

启动前配置

1. 确保《炉石传说》已安装但未运行
2. 打开HSTracker应用，首次启动会显示欢迎向导
3. 按照提示完成初始设置，包括权限授予和语言选择

HSTracker的卡组跟踪界面，实时显示剩余卡牌和对战信息

💡 核心功能：卡组管理与对战跟踪

卡组管理系统

HSTracker提供直观的卡组管理功能：

• 新建卡组：点击"Deck Manager"→"+"按钮，选择职业和格式
• 导入卡组：支持从剪贴板粘贴卡组代码或导入文件
• 卡组分类：可按标准/狂野、职业或自定义标签组织卡组

卡组管理器界面，支持批量操作和详细统计查看

对战跟踪功能

启动对战跟踪只需：

1. 先打开HSTracker，再启动《炉石传说》
2. 进入对战后，程序会自动识别卡组并开始跟踪
3. 对战界面显示：
   • 双方剩余卡牌数量
   • 已使用卡牌记录
   • 随从和法术效果监控
   • 胜率统计和历史对战数据

🔧 高级设置：个性化与数据同步

偏好设置调整

在应用菜单中打开"偏好设置"，可自定义：

• 界面外观：调整窗口透明度、卡牌显示大小
• 跟踪选项：选择是否显示对手卡牌、自动记录对战
• 热键设置：为常用功能配置键盘快捷键

HSReplay.net集成

要启用游戏数据同步：

1. 在偏好设置中找到"HSReplay.net"选项卡
2. 使用HSReplay账号登录（或创建新账号）
3. 启用"自动上传对战记录"选项
4. 上传的对战可在HSReplay.net查看详细分析

高级配置文件

对于开发人员或高级用户，可通过Config.xcconfig文件调整编译参数，该文件位于项目根目录，包含预处理器宏和编译器设置。

❓ 常见问题与解决方案

跟踪功能失效

• 确保HSTracker在《炉石传说》之前启动
• 检查"安全性与隐私"中是否授予了辅助功能权限
• 尝试重启应用和游戏客户端

卡组导入问题

• 确认卡组代码格式正确（以"AAEBA"开头的字符串）
• 检查网络连接（在线卡组需要网络加载）
• 使用"文件导入"功能尝试导入.deck格式文件

数据同步失败

• 验证HSReplay账号是否正常登录
• 检查防火墙设置是否阻止HSTracker联网
• 查看应用日志（菜单→窗口→日志）获取详细错误信息

📚 更多帮助资源：

• 项目贡献指南：CONTRIBUTING.md
• 许可证信息：LICENSE
• 社区支持：通过Discord获取帮助

所有《炉石传说》相关资产均为Blizzard Entertainment的注册商标，本工具仅供个人非商业使用。