12 完整示例与故障排查

以下示例使用虚构项目“识别练习”和无隐私测试窗口。每个示例都从可见操作开始，并以结果确认结束。

示例一：截图并保存

目标：把测试窗口当前画面保存到项目截图/。

1. 打开“识别练习”项目并绑定 PC 测试窗口。
2. 打开抓抓，原生连接选择合适的截图模式。
3. 保持次数1、间隔0 ms，点击 截图。
4. 确认中央出现新图片页签且画面正确。
5. 点击 保存。
6. 从标题栏打开截图文件夹，确认项目截图/中有 PNG。

结果确认：保存得到的是项目截图，不是找图模板；图片表和资源/图片/不应因这次保存自动增加内容。

示例二：制作并导入找图模板

目标：从画面中的虚构“开始”图案制作模板并导入专用节点。

1. 截图或加载包含“开始”图案的画面。
2. 切换到 图片 表，点击 裁剪添加 并框住稳定图案。
3. 把模板命名为开始按钮.png，保持偏色000000并勾选。
4. 在 图片调试 使用默认算法5、排序Score、精度0.90执行 查找测试。
5. 确认画布候选框落在目标图案上，点击 生成代码。
6. 在星链中选中一个允许完整替换行为的专用节点，打开导入弹窗并粘贴代码。
7. 确认后导入，再检查节点识别和项目模板资源。

结果确认：开始按钮.png在导入成功后写入项目资源/图片/；节点变为找图识别和无动作，旧动作与条件不再保留。

示例三：自动取色并生成比色和找色代码

目标：从一块虚构绿色状态区域制作颜色素材。

1. 在活动图片上设置覆盖状态区域的共享范围。
2. 选择 高饱和取点，点数设为8，点击 自动取色。
3. 在画布重新框住状态区域并点击 确定，再在颜色表检查结果，只保留并勾选稳定的绿色点。
4. 在 颜色调试 选择 比色，以精度0.90测试固定坐标并生成比色(...)。
5. 再选择 找色，保持排序Score、序号0、数量1、去重10和零偏移。
6. 执行测试，确认标记位于状态区域，再生成找色(...)。

结果确认：两条代码来自不同语义。比色使用绝对坐标，不使用共享范围；找色使用范围、排序、数量和去重。

示例四：OCR 测试与导入

目标：识别测试画面中的“开始”文字。

1. 选择包含文字的活动图片，框出文字所在范围。
2. 在 OCR 选择PP-OCRv6 Small（中英日多语种）对应模型。
3. 先把文本留空，以精度0.30执行 识别测试。
4. 确认候选中出现“开始”，再把文本设为^开始$复测。
5. 点击 生成代码，在确认过的专用节点中导入。
6. 检查节点 OCR 模型、文本、范围和精度，并确认旧行为已被替换。

结果确认：严格文本未命中但仍有候选时，应显示OCR未命中和候选框；模型调用失败则是另一类错误。

示例五：制作点阵字库并完成识字

目标：为固定点阵数字12制作项目字库并测试。

1. 截图或加载包含点阵数字的画面，设置有效范围。
2. 在颜色表勾选构成数字的颜色。
3. 在 点阵OCR 点击 字库制作。
4. 使用 自动裁剪并加载，按1行2列执行 行列切分。
5. 修正候选边界，分别标注1和2。
6. 新建项目字库数字.ddwf，匹配已有条目后把两个候选加入字库并保存。
7. 回到 点阵OCR，加载该字库，选择 识字、精度0.80、方向 左到右。
8. 执行 识别测试，结果正确后生成识字(...)。

结果确认：字库保存在项目资源/字库/，点阵 OCR 使用该字库和勾选颜色；普通 OCR 模型没有参与此示例。

按症状排查

可见症状	优先检查	处理
抓抓提示先打开项目	当前是否有活动项目	返回主窗口创建或打开项目后重试
截图提示窗口无效	PC 绑定是否仍指向当前窗口	重新绑定窗口，再回抓抓截图
DM 项目看不到原生截图模式	当前连接驱动	DM 沿用项目配置，这是预期行为
多次截图中途失败	进度和已完成页签	保留已完成页签，按错误提示修复后继续
保存后图片表没有模板	是否把保存当成模板操作	使用 裁剪添加 或 添加图片
裁剪后图片表没有新增	是否点击了 裁剪	裁剪 只建页签；改用 裁剪添加
测试提示范围部分越界	共享范围与当前图片尺寸	接受交集警告或重新框选范围
测试提示范围无交集	共享范围完全在图片外	改为有效范围或0,0,0,0全图
比色没有可用点	颜色表勾选状态	准备颜色并勾选需要的行
找色结果过多或重复	偏色、精度、数量、去重	先收紧偏色和范围，再调整精度与去重
找图提示没有模板	图片表内容和勾选状态	添加有效模板并勾选
找图位置不稳定	模板背景、偏色、范围和精度	重新裁剪稳定图案，逐项调整
统一偏色改了未勾选行	当前表和统一操作语义	这是预期行为；统一偏色作用于全部行
OCR 模型不可用	模型列表和当前桌面资源	选择可用公开模型；不可用时不能测试
重开抓抓后 OCR 模型没有重新加载	同一项目和模型的测试会话仍被复用	这是预期行为；切换模型会重建，退出项目会释放
OCR 显示未命中但有候选	文本或正则	查看候选，修正正则或目标文字
点阵 OCR 提示没有颜色	颜色表勾选状态	勾选构成点阵的颜色
点阵 OCR 提示没有字库	项目字库是否已创建并保存	制作或导入.ddwf后重新加载
字符内容正确但顺序相反	点阵 OCR 读取方向	改为正确方向后复测
导入代码失败	命令是否完整、参数和素材是否有效	回抓抓修正并重新生成，不手改项目文件
导入成功后旧动作消失	是否理解完整行为替换	这是预期行为；导入前应使用专用节点并确认
反向验证提示未完成项	节点是否含动态表达式或缺失资源	按提示补充静态值或资源，再手工复核
清除标记后表格仍有素材	点击的是 清除标记	要清表请切到目标表并用 清除所有

最终复核清单

在实际运行前确认：

1. PC 绑定仍有效，活动图片与运行画面具有代表性。
2. 范围、偏移、精度和排序均经过抓抓测试。
3. 颜色、模板、OCR 模型或点阵字库来源正确。
4. 找图模板已经通过成功导入进入项目资源。
5. 节点导入后的完整行为符合预期，没有误删需要保留的动作或条件。
6. 识别结果需要写入数据时，已按数据参考配置。
7. 交付项目时，已按项目打包与发布手册完成资源检查。

---

上一页：代码导入与反向验证 | 返回手册首页