影刀RPA实操指南操作留痕——关键动作截图与审计日志流程半夜跑挂了第二天你面对的只有一句机器人没跑完数据采了一半、改价改到第几条没人说得清。这种说不清的扯皮我做电商自动化第一年经历过太多次后来下决心给每条流程都装上行车记录仪之后再没为责任归属吵过架。这篇影刀RPA实操指南讲的就是操作留痕体系的完整搭法关键动作截图、审计日志、留痕文件管理。留痕不是多此一举它是流程出问题时你唯一的证据链。核心思路先记住一句每一次动了数据的操作都要留下时间、对象、结果三个要素。截图和日志缺一不可。安装与运行环境留痕前先把地基打好影刀RPA安装很简单官网下载客户端安装完成后会提示安装浏览器插件按提示装好即可。留痕体系对环境有两个要求磁盘规划提前建好D:\robot_logs\一类的目录下面分截图\、日志\、审计表\三个子文件夹别等截图满地乱飞再收拾版本选择社区版每天有运行时长限制留痕流程本身很轻社区版够用但如果任务量大、需要平台端看运行日志创业版以上的应用运行日志查询更方便留痕的三层设计日志、截图、审计表各管一段我踩过最大的坑是早期只写日志不截图——日志说点击成功但页面实际弹了个报错框日志里根本没有。所以现在我的留痕都是三层层载体记录什么频率第一层打印日志每个关键节点的开始/结束/参数值每个节点第二层截图动数据前的页面状态、异常现场关键动作异常第三层审计表谁在什么时间对什么对象做了什么每条操作一行三层各司其职。日志管过程回放截图管视觉证据审计表管汇总追责。少了任何一层都会出现说不清的灰色地带。元素定位四合一留痕流程里的定位技巧留痕流程一样离不开元素定位四种手段回顾一遍重点讲和截图相关的部分捕获元素点顶部工具栏捕获元素出现橙色边框时点击确认适合页面结构固定的操作目标XPath动态元素用模糊匹配是截到正确目标的前提CSS选择器class规整的按钮一行就能锁定正则表达式属性里带时间戳、随机数的元素用正则通配# 捕获元素订单列表的提交按钮截这个按钮的状态作为改价前留证 //button[contains(class,submit) and not(contains(class,disabled))] # 模糊匹配订单号所在单元格审计表要记录的单号来源 //*[contains(class,order-id)]/span[1] # 参照物定位通过提交文字定位它的父级按钮 //*[text()提交]/parent::button # 层级定位当前激活标签页的标题截图文件名里要带上 //div[contains(class,tab) and contains(class,active)]//span定位不准截图就是截了个寂寞——我早期截过一整版全是空白区域的图排查时完全没用。截图目标必须是能证明你做了什么的那个元素不是随手一个页面角落。变量与时间戳给每张截图一个可追溯的名字截图文件名混乱是留痕体系的隐形杀手。一百张img_001.png你根本没法查。正确做法是文件名里编码时间任务对象影刀里获取当前时间的指令在日期时间分类下把时间格式化成yyyyMMdd_HHmmss再用字符串拼接组成文件名。# 截图文件名的生成逻辑影刀字符串拼接对应写法# 输入任务名 task_name当前时间 now# 输出文件名 file_name形如 20260927_143012_改价_订单A1001时间戳格式化时间(现在(),yyyyMMdd_HHmmss)文件名时间戳_task_name_订单号 截图路径D:\\robot_logs\\截图\\文件名.png这样命名的直接好处按文件名排序就是按时间排序出问题时按时间点一翻就到现场。流程控制把留痕嵌进 Try-Catch 才不会漏留痕最怕正常的时候都记了出错的时候最需要留痕反而没记。解法是把留痕动作写进 Try-Catch 的对应块里Try 块业务指令 成功后写一条打印日志Catch 块先截图保存异常现场再打印日志记录报错信息最后决定重试还是跳过Finally 块写审计表无论成败都记一笔清理临时弹窗# 留痕与异常处理的配合逻辑# 输入网页对象 web_page# 输出审计表新增一行尝试:点击元素(web_page,提交按钮)打印日志(提交成功单号订单号)捕捉 异常 e:网页截图(网页可见区域,保存到D:\\robot_logs\\截图\\)打印日志(提交失败异常信息)飞书通知(改价流程异常见截图)最终:写入审计表(时间现在,操作提交改价,对象订单号,结果成功或失败)顺序别搞反Catch 块里截图必须放在最前面后面的流程一旦把弹窗关了现场就没了。我吃过这个亏——先写了关闭弹窗再截图截回来全是空页面。网页截图指令详解三种截图区域怎么选影刀的【网页截图】指令是网页留痕的主力配置项里有三个截图区域选择有讲究网页元素只截指定的元素区域比如只截提交前确认弹窗。文件最小指向性最强适合高频留痕网页可见区域截当前浏览器可视范围能看到整体页面状态。异常现场默认用这个因为报错可能在页面任何位置整个网页连滚动条以下的内容都截页面很长时文件大只在需要完整凭证时用其他关键配置保存文件夹选固定的截图目录勾选使用自动随机文件名会以时间戳命名但我更推荐按上一节的方案自己拼文件名任务名和对象名是时间戳给不了的。截图结果会输出截图保存位置变量一定要接住这个变量写进审计表这样审计表里每行都直接关联到截图文件查起来一条链。桌面与手机的截图指令网页之外的场景留痕不止网页影刀的三类截图指令覆盖全场景指令对象典型用途【网页截图】浏览器页面网页操作留证【元素截图(win)】桌面软件元素ERP、客户端软件操作留证【屏幕截图(手机)】手机画面ADB 手机自动化留痕【元素截图(win)】的使用方式先【获取窗口对象】拿到桌面软件窗口操作目标从元素库里选已捕获的元素输出同样是文件路径变量。老ERP没有操作记录功能截图就是唯一的操作凭证做内部系统补录的流程强烈建议配上。另外还有个【区域截图】指令截屏幕上指定坐标区域适合弹窗位置固定的场景。它对坐标敏感屏幕缩放一变就会截偏Windows 显示缩放不是100%的电脑要实测后再用。打印日志的规范写法让日志可搜索、可定位【打印日志】指令本身很简单难在写法规范。我的三层日志规范节点日志每个大步骤开始时打一行格式固定【节点】xxx 开始数据日志关键数据操作打参数值比如改价执行订单A1001 从89改到79异常日志报错信息原文 上下文一个字都不要省日志的量级要控制。官方文档确认过打印日志有字符串长度限制单条最大两万字符左右——够用但别把整张表格序列化了一股脑打进去日志会变得没法看。表格级别的记录交给审计表日志只记过程。数据处理审计表的结构设计与写入审计表是留痕体系的终点站建议直接用 Excel字段就五个字段示例说明时间2026-09-27 14:30:12精确到秒流程名改价流程_v3哪条流程操作对象订单A1001动了什么结果成功/失败结果截图路径D:\robot_logs\截图\20260927_…png证据链写入用【打开/新建Excel】【写入内容至Excel工作表】追加模式每天一个文件按日期命名避免单文件无限膨胀。审计表本身就是一张流水账事后做运行报告、复盘问题全靠它。系统联动日志归档与异常实时上报留痕数据多了以后要管起来两个自动化配套定时归档用影刀的计划任务功能每周日凌晨把上周的截图按周打包移动到归档目录本地只留最近两周防止磁盘撑爆异常上报Catch 块里截图完成后紧接着发飞书消息把截图文件路径和报错摘要发到值班群人不在电脑前也能第一时间知道通知和留痕打通之后整个体系才算闭环出了问题 → 飞书弹出通知 → 点开审计表定位时间点 → 按路径打开截图看现场。全程不超过两分钟。归档策略上再给一个参考值截图单张几百KB到几MB不等一条每天跑几百次动作的流程一个月能堆出十几个GB。所以本地保留窗口我定的是两周超过就归档压缩归档超过半年直接清理。这个参数不用照抄我按你的磁盘大小和回查频率定但一定要有明确数字以后再说的归档策略等于没有策略。工程化规范把留痕做成通用子流程最后是工程化。留痕逻辑千万不要在每个流程里复制粘贴拆成三个通用子流程99_留痕_写日志(节点名, 内容)统一日志格式99_留痕_截图存证(网页对象, 场景名)统一截图命名和目录99_留痕_写审计(流程名, 对象, 结果)统一审计表结构子流程通过流程参数传入变量任何主流程都能调用。命名用数字前缀是为了排序时永远排在最前面这个习惯我从带教第一个流程开始就保持。新版发布前先用一两个任务试跑留痕输出确认截图、日志、审计表三样都正常再放量。易错速查留痕体系的5个常见问题现象原因解决截图文件是空白页面未渲染完成截图前加等待网页加载完成异常现场没截到关弹窗写在截图前Catch块截图永远放第一步截图文件名重复覆盖未拼时间戳文件名强制带秒级时间日志太长被截断单条超两万字符大段数据改写入审计表审计表写入报文件占用Excel被人工打开流程加占用检测提示后重试还有一条经验计划任务执行、API调度执行时不能调试留痕就更要提前配好——线上流程唯一的眼睛就是这些日志和截图别等出事才想起装。学习资源与延伸阅读影刀官方帮助文档里如何调试影刀应用一篇把断点、变量面板和日志的关系讲得很透留痕体系设计前建议先读客户端内置指令市场搜截图“日志”能找到不少现成的封装指令本文留痕三件套日志子流程截图子流程审计表模板的完整源码我放在代码仓库 home.linyan.cloud可以直接参考改造接入你自己的采集或改价流程只要几分钟#影刀RPA #RPA自动化 #操作留痕 #审计日志 #运行监控 #电商作者林焱