摘要

攻击命中时，游戏会在目标上方弹出伤害数字和图标（“飘字”），例如拳头图标加 −314。Perception（截图识别模块）提出把这些读到的飘字作为“候选附件”保存进 Battle App（玩家用来回看战斗分析的应用）。本记录是 Simulator 负责方对这份提案做的只读审阅：核对 Battle App 现有代码会怎样消费它。

结论：认可“独立、显式、带版本号的附件”这个方向；但这只是审阅，不批准尚未定义的公共格式，没有改 Battle App、Perception、SE 或存档，也没有发起新的识别。

要回答的问题

如果加入飘字候选附件，现有的截图路由、会话、快照保存、视频导入和 HTML 回看分别会受什么影响？最小的安全落点在哪里？

核查结论

  • 截图路由的消息校验对根字段很严格，往现有消息里加字段会被拒绝，所以应做成独立附件。
  • 现有会话里截图、场景尝试和输入版本已有固定含义，飘字读取不应占用它们。
  • 当前快照只保存明确列出的 SE 结果、请求、简报和会话头；只在工作目录旁写附件，不会自动进入快照。
  • 视频导入依赖唯一且存在的原视频，时间只来自显式的提交关联；不能从文件名或采集时钟猜。
  • 回看只在原图路径明确且文件存在时给图片链接；候选数值可保留，媒体缺失要单独标出。

因此，保存、重开、导入、HTML 回看四处都要明确消费附件，不能只加一个运行时小面板就声称保存恢复完成。

建议的最小落点

  • 由 App 持有独立的附件目录和严格索引，每次显式读取都保存一个新的序号文件；先完整写附件，再提交索引。
  • 新快照要固定它接受的那批附件，回看时不追随工作会话里后来的附件；只复制小型候选数据，不复制原图或视频。
  • 旧快照没有附件就显示“未运行”，未知附件版本显示“不支持”。
  • 主行只显示提供方明确接受的数值；原始识别尝试和拒绝原因放在详情里，不能因为两次尝试相同就由界面升级为接受值。
  • 可见状态区分：未运行、不支持、已运行未检出、图标已见但数字未知、已接受、运行错误；“媒体已失效”是独立状态，不能把已接受的结果改写成未检出。
  • 与 SE 的“攻击证据”分开：不填攻击者、目标或事件编号，不把相邻帧合并为攻击次数。

正式合同还需写清的六件事

  1. 精确来源绑定：引用哪张截图、哪次读取，不靠同名图、相近时间或识别内容猜关联。
  2. 时间：媒体解码时间、取帧时间、处理时间分开，缺失或冲突时保持未知。
  3. 几何：保存原图实际宽高和像素框，不能把 2560×1440 写成所有帧的永恒坐标。
  4. 接受值与尝试：给出接受值或空、图标种类、读数字面、拒绝原因。
  5. 资源与错误：附件大小、条数上限，未知版本、损坏文件、缺原图和进程异常的行为；禁止无声覆盖旧结果。
  6. 生产入口：新的公开接口，App 不导入私有实现。

建议的验收

例如：带附件与不带附件的同一份 SE 请求必须得到完全相同的推断（信息隔离，不是识别准确率）；同帧拳头 −314 与骷髅 −5 分开显示；一个接受的 −1200 与一个被拒绝的 −899 只显示前者为主行；“未检出”和“数字未知”都不能显示成“0 伤害”。

局限

这是一份文档审阅，没有运行任何新测试或识别；它不阻塞当时的 AI 任务，也不授权逐帧识别、安装或重启产品。