原生 macOS 炉石传说助手。进入竞技场选牌时，自动识别待选内容，
展示胜率、热度等数据，辅助你做选择。
A native macOS Hearthstone helper. During Arena drafting, it recognizes your
choices and shows win rates, popularity, and more to help you pick.
系统要求：macOS 13+ · Apple Silicon（M 系列）
安装：打开 DMG → 把 HearthMate.app 拖到「应用程序」
Requirements: macOS 13+ · Apple Silicon (M-series)
Install: open the DMG → drag HearthMate.app to Applications
当前构建为 ad-hoc 签名（尚未公证）。首次打开若被拦截：
右键点击 App →「打开」→ 再点「打开」；
或在「系统设置 → 隐私与安全性」中允许运行。
This build is ad-hoc signed (not notarized). If macOS blocks the first launch:
right-click the app → Open → Open again;
or allow it under System Settings → Privacy & Security.
1功能概览Features
职业选择Hero pick识别三张英雄/职业，展示职业胜率、选择热度、7 胜以上比例、排名。Recognizes three heroes/classes and shows class win rate, pick rate, 7+ wins, and rank.
卡牌三选一Card pick识别待选三张卡，展示卡组/抽到/打出胜率、出现热度、套牌均拷。Recognizes three draft cards and shows deck/drawn/played win rates, popularity, and avg copies.
高亮对比Highlights同指标最高标绿、最低标红，方便快速判断。Best values in green, worst in red for quick comparison.
悬浮窗 UIOverlay UI置顶悬浮窗，宽屏横向、窄屏纵向自动布局；菜单栏常驻。Always-on-top overlay: horizontal on wide panels, vertical on narrow; menu bar status item included.
检测方式：读取炉石日志判断是否在竞技场选卡；截取炉石窗口并用 Vision OCR 识别卡名/职业。
胜率配置由本站自动同步，无需你手动下载数据。
Detection: reads Hearthstone logs to detect Arena drafting, captures the game window,
and uses Vision OCR for card/class names. Win-rate configs sync automatically from this site.
2安装与权限Install & Permissions
下载上方 DMG 或 ZIP，将 HearthMate.app 拖到「应用程序」文件夹。Download the DMG or ZIP above and drag HearthMate.app into Applications.
首次启动：若系统提示无法验证开发者，按上方「右键 → 打开」处理。First launch: if Gatekeeper complains, use right-click → Open as noted above.
打开 系统设置 → 隐私与安全性 → 屏幕录制，勾选
HearthMate。
Open System Settings → Privacy & Security → Screen Recording and enable
HearthMate.
完全退出 HearthMate 后重新打开（授权后必须重启 App 才生效）。Fully quit and relaunch HearthMate (required after granting permission).
没有「屏幕录制」权限时，无法识别卡牌，悬浮窗会提示截屏失败。
每次重新编译/替换 App 后，若截屏突然失效，请重新开关一次屏幕录制权限。
Without Screen Recording permission, card recognition will fail.
After rebuilding/replacing the app, re-toggle Screen Recording if capture stops working.
炉石可正常写日志目录 /Applications/Hearthstone/Logs。Hearthstone can write logs under /Applications/Hearthstone/Logs.
本机可访问配置服务（默认本站），用于后台同步最新胜率。Network access to this config host for background win-rate sync.
3使用方法How to Use
先启动 HearthMate，再打开（或已打开）炉石传说。Launch HearthMate first, then open Hearthstone (or keep it already open).
进入 地下城竞技场 / Underground Arena 选卡流程。Enter an Underground Arena draft.
职业选择阶段：悬浮窗显示左 / 中 / 右三个职业的胜率相关指标。Hero pick: the overlay shows left / middle / right class metrics.
卡牌三选一阶段：显示三张待选卡的名称与胜率指标。Card pick: shows the three card names and their stats.
离开选卡界面后，悬浮窗回到「等待进入竞技场选卡界面…」状态。After leaving draft UI, the overlay returns to the idle “waiting for draft” state.
识别失败时不会用空白覆盖已识别结果（粘性展示）。若某一格偶发 OCR 漏识，会尽量保留上一轮正确结果。
Failed OCR will not wipe good results (sticky display). Occasional misses keep the last good slot when possible.
小提示Tips
尽量让炉石窗口完整可见、卡面/职业名清晰（避免严重遮挡）。Keep the Hearthstone window fully visible with clear card/class names.
悬浮窗可拖动、缩放；可随时通过菜单栏隐藏/显示。Drag and resize the overlay; toggle it from the menu bar anytime.
建议在竞技场选牌时把悬浮窗放到不挡牌面的位置。Place the overlay where it does not cover the draft cards.
4指标说明Metrics
卡牌三选一Card pick
指标Metric
含义Meaning
卡组胜率Deck win rate
包含该卡的套牌整体胜率Win rate of decks that include the card
抽到胜率Drawn win rate
抽到该卡时的胜率表现Win rate when the card is drawn
打出胜率Played win rate
打出该卡时的胜率表现Win rate when the card is played
出现热度Popularity
该卡在选牌池中的出现/热度How often the card shows up in drafts
套牌均拷Avg copies
平均每套牌携带张数Average copies kept per deck
职业选择Hero pick
指标Metric
含义Meaning
职业胜率Class win rate
该职业在竞技场中的胜率Arena win rate for the class
选择热度Pick rate
玩家选择该职业的比例How often players pick the class
7 胜以上7+ wins
达到 7 胜及以上的比例Share of runs that reach 7+ wins
职业排名Class rank
职业综合排名（数字越小越好）Overall class rank (lower is better)
数据来源：HSReplay 公开 Arena 统计（职业约 LAST_1_DAY，卡牌约 LAST_7_DAYS），
由本站每小时拉取并发布；客户端只访问本站，不直连 HSReplay。
Source: public HSReplay Arena stats (classes ≈ LAST_1_DAY, cards ≈ LAST_7_DAYS),
fetched hourly by this host. The client talks only to this server, not HSReplay.
5菜单栏操作Menu Bar
菜单栏图标（或「HM」）提供：The menu bar icon (or “HM”) provides:
菜单项Item
快捷键Shortcut
作用Action
显示/隐藏悬浮窗Show/Hide Overlay
⌘O
切换悬浮窗可见性Toggle overlay visibility
立即刷新Refresh Now
⌘R
立刻重新读取日志并尝试识别当前画面Re-read logs and re-run recognition immediately
检查配置更新Check Config Update
⌘U
马上向服务器核对胜率配置是否有更新Check the server for a newer win-rate config
退出 HearthMateQuit HearthMate
⌘Q
退出应用Quit the app
6配置与数据更新Config & Data Updates
启动时：先用本地缓存 / 内置数据立刻可用，同时后台检查更新。On launch: use local cache / bundled data immediately while checking for updates in the background.
之后每 10 分钟 自动比对远端 manifest；有变化才下载配置包。Then every 10 minutes, compare the remote manifest and download only if it changed.
也可随时用菜单「检查配置更新」。You can also run “Check Config Update” from the menu anytime.
网络不可用时：继续使用本地缓存或 App 内置兜底数据，不阻塞选牌。If offline: keep using local/bundled data so drafting is not blocked.