11 代码导入与反向验证

抓抓测试通过后，可以把当前配置生成识别代码，再导入一个星链节点。导入是有意替换节点行为的操作，执行前必须确认目标节点。

生成代码做了什么

各调试页的 生成代码 会根据页面配置生成并复制一条命令：

• 比色(...)
• 找色(...)
• 找图(...)
• OCR(...)
• 识字(...)
• 找字(...)

生成代码只写入剪贴板，不会修改节点，也不会把找图模板写入项目资源。

导入前检查

1. 在抓抓中重新执行一次测试，确认当前图片、范围和结果正确。
2. 回到星链编辑器，选中真正要替换的节点。
3. 检查该节点现有识别、动作、条件和其他参数是否仍需保留。
4. 必要时先保存项目或选择另一个专用节点。
5. 再点击 节点配置 标题栏左上角的导入图标。

重要：导入成功会替换当前节点的完整行为数据。 导入后节点使用新识别，并设置为无动作；原动作参数、条件和其他参数会清空。它不是只把识别字段追加到原节点。

导入步骤

1. 在抓抓点击 生成代码。
2. 选中目标节点，打开 节点配置。
3. 点击标题栏中的 导入抓抓识别代码 图标。
4. 在弹窗中粘贴完整命令。
5. 再次确认目标节点无须保留旧行为。
6. 点击 导入，或按Ctrl+Enter确认。
7. 导入后检查节点识别类型、范围、精度、偏移和素材。

字段的完整含义以图色识别和OCR 识别为准。

找图模板资源落盘

导入找图(...)时，系统会读取命令引用且当前抓抓中可用的模板，并写入项目资源/图片/。节点保存的是项目资源中的相对模板名称，而不是用户磁盘绝对路径。

资源流转如下：

抓抓图片表模板
    -> 找图代码引用模板名称和对应偏色
    -> 导入时解析并写入项目 资源/图片/
    -> 节点引用项目模板资源

同名项目资源已经存在但内容不同、模板缺失、名称无效或保存失败时，导入整体失败，不会静默覆盖已有资源。

失败时节点保持不变

系统会先解析完整代码、校验参数、解析模板资源并完成必要保存，再一次性提交节点修改。因此：

• 代码格式错误时，原节点不变。
• 范围、偏移、精度或素材不合法时，原节点不变。
• 找图模板解析或写入失败时，原节点不变。
• 只有全部步骤成功后，节点完整行为才被替换。

看到失败提示后，应修复抓抓配置并重新生成代码，不要手工修改项目资源文件。

反向验证

找图、比色、找色、OCR 和点阵 OCR 节点支持右键 反向验证。它把节点中能够静态恢复的识别配置加载回抓抓，便于在当前图片上复测。

使用步骤：

1. 在星链画布右键目标节点。
2. 点击 反向验证。
3. 抓抓打开后，检查活动调试页、范围、偏移、颜色、模板、模型或字库。
4. 阅读结果区域中的“反向验证未完成项”。
5. 准备活动图片后重新执行测试。

反向验证读取找图项目模板时不会重写资源。单个模板无法读取时，会指出对应问题，其余可恢复素材仍可能加载。

反向验证的限制

节点中的静态值可以恢复；动态表达式或无法静态求值的数据不一定能还原为抓抓可直接测试的值。遇到这种情况，抓抓会保留原始文字并列出问题，不会假装恢复成功。

反向验证也不会替你选择正确的当前画面。范围和参数加载后，仍要确认活动图片与节点实际运行画面一致。

导入后复核

1. 识别类型与生成命令一致。
2. 原节点动作、条件和其他参数已经按预期清空。
3. 找图模板已成为项目资源，名称和偏色顺序一致。
4. OCR 模型或点阵字库仍可用。
5. 范围0,0,0,0仍表示运行时完整画面，边界偏移含义未混淆。
6. 运行前按运行与调试再做一次安全检查。

---

上一页：字库制作 | 下一页：完整示例与故障排查