炉石团长｜macOS 安装与使用指南
适用于未经过 Apple 公证的安装包

适用设备
• macOS 13 或更高版本。
• Apple Silicon（M 系列芯片）Mac；此包不适用于 Intel Mac。
• 安装文件：发布者提供的炉石团长 DMG 安装包（扩展名为 .dmg）。
• 可在左上角苹果菜单 →「关于本机」查看芯片和系统版本。

本包尚未经过 Apple 公证。请只使用可信发布者提供的安装文件。
安装和使用本应用不需要注册应用账号或登录 Apple 账号。

一、安装到「应用程序」

1. 下载完成后，打开「访达」→「下载」，先双击 ZIP 压缩包解压，再双击其中的 DMG 文件。同一文件夹内附有安装使用指南和开发者验证修复指南。
2. 如果是在更新旧版：先等待正在执行的重连结束，再从菜单栏图标选择「退出」，或在配置窗口点击「退出助手」。只关闭配置窗口并不代表已经退出。首次安装可直接进行下一步。
3. 在打开的安装窗口中，将「炉石团长」拖到「Applications／应用程序」图标上，等待复制完成。更新旧版时，按提示替换旧应用。
4. 复制完成后，在访达侧栏找到刚才打开的安装磁盘，点击旁边的弹出按钮。
5. 从「访达」→「应用程序」打开「炉石团长」。日常使用请从这里启动。

二、首次打开时出现安全提示

如果提示无法验证开发者，或 Apple 无法检查应用是否包含恶意软件：

1. 先关闭提示窗口。
2. 确认安装文件来源可信后，打开苹果菜单 →「系统设置」→「隐私与安全性」。
3. 向下找到与「炉石团长」对应的阻止提示，点击「仍要打开」。
4. 按系统要求验证身份，再确认打开。

系统会为该应用保存打开例外。首次打开确认与下面的运行授权是两件事。

如果看不到「仍要打开」：从「应用程序」再尝试打开一次，然后返回设置查看。单位管理的 Mac 可能需要管理员协助。
如果提示应用已损坏、会损坏电脑或检测到恶意软件，请停止打开，联系发布者核验文件；不要按普通未公证提示处理。

无需关闭系统安全保护，也无需执行终端命令。

三、进入应用后完成运行授权

1. 打开后可通过悬浮按钮的齿轮进入配置窗口。若当前只允许点击「更新」，先完成更新，再启动助手。
2. 点击「启动」，等待 macOS 的管理员授权窗口出现。
3. 在系统窗口中输入本机管理员密码。这里需要的是 Mac 管理员密码，不是 Apple 账号密码。
4. 授权窗口可能显示「osascript」。这是当前版本调用系统授权的方式；应用不会读取或保存密码。
5. 完成授权后，等待界面显示助手已连接或等待游戏／对局。
6. 打开炉石传说并进入对局。确认界面已识别到对局后，再按需要点击悬浮按钮「重连」。

当前安装包采用本次运行授权，不需要在「登录项与扩展」里开启常驻后台服务。
关闭配置窗口后，悬浮按钮和已授权助手仍会运行。
完全退出应用后，本次授权结束；下次启动使用时需要重新完成运行授权。

四、应用更新

• 游戏对局进行中不显示更新入口和提示，也不会安装或重启应用，可正常使用助手。
• 对局外发现功能版本或大版本更新时，悬浮窗只允许点击「更新」，其他操作暂不可用；仍可退出应用。
• 修订版本（patch）更新为可选，对局外可从悬浮窗的小箭头或配置窗口进行更新。
• 下载完成后，点击更新安装并重启。下载失败时可点击「重试更新」。
• 连接短暂中断不会立即显示更新；确认对局结束后才显示。
• 完全重启后，本包的临时运行授权会结束；需要时请点击「启动」重新完成系统授权。

五、遇到问题时

• 授权窗口被取消：再次点击「启动」即可重试。
• 没有本机管理员权限：请联系这台 Mac 的管理员完成授权。
• 助手未连接：在配置窗口点击「修复助手」。加载动画至少持续 3 秒，随后查看各项检查结果和当前整体情况；如弹出系统授权窗口，请按提示完成。
• 显示等待游戏或等待对局：先启动炉石并进入对局，等待状态刷新。
• 提示后台组件缺失或版本不匹配：退出应用，使用完整安装包重新安装。
• 持续连接失败：打开「高级设置与诊断」，点击「导出日志 TXT」，将日志和错误提示提供给发布者排查。

六、确认安装完成

□ 应用已复制到「应用程序」，可以从该目录打开。
□ 配置窗口可以正常打开。
□ 点击「启动」并授权后，助手显示已连接或等待游戏／对局。

Apple 官方参考
在 Mac 上安全地打开 App：
https://support.apple.com/zh-cn/102445

本说明适用于采用本次运行授权方式的炉石团长 macOS 未公证安装包。
不同 macOS 版本的按钮文字可能略有区别，请以系统实际提示为准。
