黑流树海记牌器 明日方舟集成战略的战斗情报悬浮窗

演示实录（第三版），约 4 分钟，带配音：右侧窄窗是记牌器，左侧是游戏窗口，战斗中游戏画面上的标注来自记牌器的叠加层。这里是压缩到 720p 的版本。配音为 AI 语音合成（高松灯社区语音模型，CC BY-NC-SA 4.0）。

概览

明日方舟 PC 端集成战略「沉沦者的黑流树海」的置顶悬浮窗。它只看游戏画面，自动记下藏品、资源和走过的节点；更重要的是战斗情报——进关前告诉你这一关会来什么，战斗中告诉你下一波什么时候、从哪个口、来什么，我方干员的技能能打多少，打完记下漏了谁。

集成战略里一场战斗翻车，整局就白打了。社区已经有解决“地图怎么走”的工具，这个项目解决的是另一半：这一仗怎么不翻车。

设计原则：只给信息，不给打法

这类工具最容易越界，所以先把边界定死：

• 只读画面：用 PrintWindow 截取游戏窗口。不读内存、不抓包、不注入，也不向游戏发送任何输入。PC 端有反作弊，内存类工具有封号风险
• 只给信息，不给打法：不推荐部署位置，不代打。“哪里该放谁”仍然是玩家自己的判断
• 低占用：玩家开着它打游戏，它不能把游戏拖慢

第三条决定了很多技术选择：非战斗时画面静止才做整图识别；进入战斗后只以 5 fps 读几个小区域；OCR 限 2 个线程并关掉忙等。

战前情报与敌人资料卡

在地图上点开一个作战节点，记牌器识别出关卡名，自动切到“情报”页：敌人总数（有随机组时给出区间）、波次、地形缩略图、需要注意的敌人（精英、不可阻挡、飞行、隐匿等特性，首次出现的波次、时间和入口）、普通 / 紧急作战的差异、这一关我自己打过的记录。数值按保密等级、藏品和紧急作战的倍率换算。

鼠标悬停任意一个敌人，弹出资料卡：上半部分仿游戏的任务简报，下半部分仿图鉴，列出等级、出现波次与入口、换算后的属性和能力。

战斗中：出怪条与游戏画面叠加层

进入战斗，悬浮窗自动切换成出怪条：当前波次、击杀计数、下一批敌人的倒计时与入口；同一组敌人间隔出现时显示“每 N 秒 1 个”。

同时，一个透明、鼠标穿透、不抢焦点的叠加层盖在游戏画面上：每个出怪口上方直接显示下一批敌人和倒计时，不用把视线移到窗外。

把标注画在出怪口上，需要知道地图格子在屏幕上的位置。这里移植了开源项目 Arknights-Tile-Pos（MIT）的相机模型；它没有黑流树海关卡的相机数据，所以从常见的几组相机位置里，按画面上出怪口红框和保护点蓝框的位置自动挑出对得上的那一组，并按关卡保存。

我方干员：技能 DPS 与总伤

拿起干员卡或点击场上干员时，游戏左侧会出现干员面板。记牌器在这一刻读一次面板：攻击力、技能名和技能描述。把技能描述的模板代入每一级的数值，和面板上的数字比对，就能认出技能等级；再按本关敌人防御 / 法抗的中位数，估算技能期间的 DPS 和总伤。聚焦视角下，估算值直接标在技能按钮旁边。

实测发现面板攻击力已经包含藏品加成（玛恩纳的 530 正好是基础值 × 1.4），也包含随时间变化的天赋——不攻击时会从 583 涨到 1007，所以估算的是“读到那一刻”的值。这是通用公式的估算，不含天赋、模组特效和攻击动画，界面上也这样标明。

难点：从截图里读出游戏内时间

倒计时要准，前提是知道“游戏里现在是第几秒”。但游戏会暂停、会开 2 倍速、拿起干员卡时会进入慢动作，现实时间完全不可用。

我找到的时钟是费用条：费用按游戏时间自然回复，费用条的进度随游戏时间连续增长。

• 只用进度的增量：部署扣费、技能回费、先锋产费都是跳变，不影响连续的那一部分；异常读数直接剔除
• 费用到 99 封顶后进度条不动了，就改看倍速按钮（1X / 2X / 无字样即选人慢动作）按倍速外推，并在界面上给出误差上限
• 波次用击杀计数推进，同一读数连续两帧才采信；关卡用战前识别到的关卡名加战斗首帧的敌人总数相互核对

实测：在 180 秒的脚本（1X、暂停、2X、费用封顶）里，5 fps 实时跟踪的时钟误差不超过 0.35 秒；按 2 秒间隔回放三段录像，误差在 ±2 秒内。

战后复盘与个人关卡档案

战斗结束后记下这一场：关卡、胜负、掉了几点生命、漏怪发生在第几波第几秒，以及推测漏的是谁；失败结算会回填这一仗的结果。这些记录累积成个人关卡档案：每关打过几次、输过几次、平均掉多少血、通常漏在哪一波，下次进同一关时出现在战前情报里。

记牌

非战斗时它也在记：开局识别分队与招募；目标生命、护盾、希望、源石锭、行动力自动读取；239 件藏品按图鉴分类显示已获得和未出现，并汇总当前藏品对全体 / 近战 / 某职业的属性加成；三条结局线的条件进度。所有变化写进本局时间线，可以删除、Ctrl+Z 撤销。

怎么做的

开发按阶段推进：数据管线 → 战斗时钟 → 战前情报 → 出怪条 → 复盘与档案 → 打磨发布 → 叠加层与干员估算。

踩过的坑

• 光标停在倍速按钮上会让 1X 图标变宽，被误判成 2X → 要求同时识别到“2”字样
• 拿起干员卡时费用面板上移，进度条读成 0 → 没有亮像素就当作“读不到”
• 每波的击杀阈值没算随机组，会提前跳到下一波 → 与总数同口径，并用画面上的总数收紧
• 出怪口红框是半透明的暗红，最初按亮色写阈值，一个像素都没匹配上，悄悄回退到了默认相机 → 按实测颜色重写
• 录演示时，开局敌人正好压在出怪口红框上，相机选错，技能按钮的位置跟着算错 → 聚焦视角改为逐个候选相机检测技能按钮旁的技力图标，命中哪个用哪个

已知限制

• 只在 1918×1009 / 1920×1080 窗口验证过；其他分辨率按比例换算，未实测；不支持模拟器
• 第 2 层以后的关卡、紧急作战、领袖战还没有实机验证
• 漏怪来源只是推测：敌人受伤后退、被阻挡、技能位移都会改变抵达时间，离线无法精确预测
• 干员 DPS 是通用公式估算：不含天赋、模组特效和攻击动画
• 敌人血条跟随暂不可行：需要逐帧检测每个敌人，而游戏只画血条不显示数值，不读内存无法得到准确血量
• 选人慢动作只在费用未封顶时能精确计时；封顶后按估计速率外推，界面会提示误差