影刀RPA实操指南流程文档怎么写——让接手的人少问你用影刀RPA搭流程的人都有过这种经历自己请了假接手的同事一天打五个电话问你那个循环为什么用For次数循环不用相似元素循环问你某个XPath为什么这么写。我两年前接过别人一个半成品流程作者早就离职了文档就一行采集拼多多商品价格我靠逐行打断点猜逻辑猜了整整两天。从那以后我给自己定了个规矩流程写完不算完文档配套才算交付。这篇就把我在影刀RPA上沉淀下来的一套流程文档写法摊开讲从结构模板到每部分写什么全部来自真实交付。一份合格流程文档的五个组成部分我的文档模板固定五块流程概述、运行环境、逻辑说明、维护指引、变更记录。顺序不能乱因为接手的人是按这个顺序看的。流程概述这个流程做什么、给谁用、多久跑一次三句话说清运行环境影刀RPA版本、浏览器及插件、Python第三方库、账号要求逻辑说明主流程和每个子流程在干什么关键判断的依据维护指引常出什么错、怎么排查、日志在哪、找谁变更记录每次改动的时间、内容、原因最重要的原则只有一条文档写给半年后的自己看。你现在觉得这不 obviously 吗的地方半年后你自己都会忘。从搭建阶段就顺手留下文档素材很多人是流程写完了再补文档那是最痛苦的方式。正确做法是搭建的时候就按工程化规范来文档素材自然就有了。第一是子流程命名。我的习惯是编号加动宾结构01_登录并验证、02_搜索商品关键词、03_循环采集列表页、04_写入Excel并通知。编号解决执行顺序一目了然动宾结构解决这个子流程干嘛的不用点进去看。第二是每个子流程开头放一条【打印日志】指令。日志类型选信息内容写清楚进入哪个子流程、关键输入是什么比如# 进入采集子流程打印本次任务的关键参数# 输入keyword(字符串商品关键词)、max_pages(数字最大翻页数)# 输出item_list(列表采集到的商品信息)开始采集keyword计划翻页数str(max_pages)这条日志在运行日志里就是现成的逻辑说明接手的人看一次运行记录就能对上号。第三是关键指令加注释。影刀RPA里右键指令可以添加备注尤其是这几种地方必须写写死的URL、判断条件、魔法数字比如循环99次为什么要是99。元素和定位信息必须登记进文档流程文档里最值钱的部分是把每个核心元素的定位方式和位置写清楚。这部分做扎实了元素失效时接手的人五分钟就能修好不用从头捕获。我在文档里固定用一张定位登记表子流程元素用途定位方式失效备用方案02_搜索搜索输入框XPath修复元素重新捕获03_列表页商品循环项相似元素For次数循环下标取值04_写入Excel区域单元格坐标改用追加一行XPath具体写法也要贴进文档带场景注释# 捕获元素商品列表循环项相似元素用于循环采集 //*[classgoods-list]//div[contains(class,goods-item)] # 模糊匹配查找包含下一页文本的翻页按钮 //*[contains(text(),下一页)] # 参照物定位价格标签前的兄弟节点商品标题页面改版时比class更稳 //*[contains(class,price)]/preceding-sibling::*[1]写XPath的时候顺带说明为什么选这个属性。官方文档里反复强调的坑是某些属性运行时会变化比如评论数、时间戳捕获时要取消勾选会变的属性改用href这类稳定属性定位。这句话原样抄进文档接手的人会感谢你。流程控制逻辑要画出来或列出来流程控制是文档里最容易语焉不详的部分。For次数循环、相似元素循环、While条件循环、无限循环各有什么区别用在哪文档里要用一张表讲死循环类型使用场景文档里要写清的点For次数循环翻页次数可控次数来源、为什么是这个数相似元素循环列表逐项操作网页刷新时改用下标方案While条件循环不确定总页数退出条件、防死循环上限无限循环常驻监控必须写退出机制判断逻辑同理。每个If条件判断要写清楚判断的是什么、两条分支各干什么。比如判断元素是否存在购物车弹窗存在就点关闭不存在继续采集一句话写进备注比十段文字都清楚。Try-Catch异常处理块要单独说明。我固定写三样Try里放了哪些可能出错的指令、Catch里【打印日志】记录了什么日志类型选错误、Finally里做了什么清理动作关弹窗、关网页。这些是别人最难从流程图上看出来的东西。运行环境部分新手最容易漏的四样运行环境这一节写不细接手的人换台电脑就会翻车。四样东西必须写全。影刀RPA版本社区版每天有运行时长限制要长期无人值守跑就得说明用哪个版本我踩过社区版跑夜间任务跑到一半停掉的坑浏览器及插件Chrome版本至少64以上影刀RPA插件要在扩展管理里确认已启用且勾选在所有网站上有权访问Python第三方库如果流程里用了第三方库客户机要重新安装版本号写进文档账号与登录态哪些网站需要登录、Cookie有效期多久、登录失效后的处理方式如果是图像识别兜底的流程还要写明屏幕分辨率要求图像识别对分辨率变化很敏感。用手机自动化的ADB方案则要写清手机型号、系统版本、开发者选项设置。维护指引把出错了怎么办写成速查表维护指引的核心是一张易错速查表把我真实踩过的坑按现象—原因—处理三列写现象常见原因处理方法报未找到元素元素属性运行时变化元素编辑器里校验取消勾选变化属性报网页已被关闭弹窗打开了新窗口用【获取已打开的网页对象】重新获取Excel时间少8小时datetime类型按UTC写入转成字符串再写入或加8小时定时任务没跑应用未发版或被删除检查我获取的应用重新发版速查表之外再写清三件事运行日志怎么看快捷键WinR输入%localappdata%\ShadowBot\log按时间倒序找最新文件流程里【打印日志】的关键节点含义异常通知走哪个渠道我的流程统一用【飞书群通知】指令Catch块里触发群里对应维护人。需求背景与平台差异也要写逻辑说明里别漏了需求背景为什么采集这些字段、频率谁定的、数据给谁用。半年后有人质疑为什么要采这个文档能救你。做多平台采集的平台差异单独列一节。比如拼多多和淘宝的列表结构不同、翻页逻辑不同风控策略也不同同一套子流程在两个平台上的参数差异要写清楚。这也是我自己复用流程时最依赖的部分。变更记录三列就够但要真填变更记录固定三列日期、改了什么、为什么改。每次发版前花两分钟填一行。这节的最大价值是防止改了A坏了B。有一次我把翻页等待从3秒改成1秒想提速结果第二天采集量掉了一半查变更记录才想起来改过这里。没有变更记录的流程文档等于没写。易错速查文档写作本身的四个坑只写怎么做不写为什么接手的人不敢动你的流程因为你没写判断依据贴截图不贴文字页面改版截图就废了关键信息必须文字化文档和流程不同步发版不改文档比没文档更害人全文无日志位置说明出问题第一反应是看日志这个路径必须写在最显眼处延伸阅读与源码这篇里提到的文档模板、子流程命名规范和速查表我都做成了可直接套用的文件。完整流程源码我放在代码仓库 home.linyan.cloud可以直接参考改造把里面02_搜索商品关键词这类子流程换成你自己的业务就行。文档这件事没有技术含量全靠习惯。你今天多写的十分钟是接手的人少问你的十通电话。#影刀RPA #RPA自动化 #流程设计 #开发规范 #工程化作者林焱