影刀RPA新手教程：流程模板设计完全指南——可复用框架、命名规范与团队协作

我们团队有五个人写影刀流程，各写各的，命名风格五花八门——有人用拼音"caiji"，有人用英文"get_data"，有人用中文"采集数据"。变量名也是乱七八糟，接手别人的流程跟读天书一样。后来我搞了一套流程模板规范，统一了命名和架构，团队协作效率翻倍。这篇就以"团队级电商运营自动化框架"为主线，把流程模板设计方法和十二大核心知识全讲清楚。

影刀安装与团队协作基础

官网下载影刀安装。团队协作的关键是版本选择——社区版是个人版没有团队功能，创业版支持基本的团队协作，企业版有完整的权限管理和流程共享。五人团队建议至少创业版，流程能共享到团队空间，别人能直接复用。

浏览器插件必装。团队协作时统一用同样的浏览器环境，避免插件版本不一致导致元素捕获行为不同。

元素定位四合一：模板中的定位规范

模板中的元素定位要考虑复用性——不同人不同项目都要用同一套定位方案。

元素捕获是最基本的，但模板里我更推荐用XPath和CSS，因为更可读、可维护。模板里的元素定位统一用XPath：

//input[@id='search-box']

或CSS选择器：

#search-box

模板里定义两种定位方式——主定位用元素捕获或CSS，备用定位用XPath文本匹配。元素失效时自动切换备用定位。正则表达式用于数据提取模板——从价格文本提取数字：

(\d+\.?\d*)

XPath和CSS选型写进团队规范——属性稳定用CSS，文本匹配用XPath。每个人写的定位方式统一，接手的人一眼看懂。

变量与数据类型：模板的配置化设计

模板的核心思想是"配置化"——把变化的部分抽成变量，不变的是流程逻辑。

配置字典统一管理可变参数：

config={"shop_name":"旗舰店","platform":"taobao","max_products":50,"output_dir":"D:/reports/",[video(video-k9dpMAFA-1782838133732)(type-csdn)(url-https://live.csdn.net/v/embed/525000)(image-https://v-blog.csdnimg.cn/asset/23da3fe1f67a47106d725406cfde9a97/cover/Cover0.jpg)(title-拼多多店群自动化上架方案)]"notification_webhook":"https://open.feishu.cn/..."}

列表存储批量数据。字典存储结构化数据。JSON作为配置文件格式——启动时json.loads读取配置文件，运行中用配置值，修改后json.dumps写回。

数字类型用于计数和阈值。字符串用于路径和名称。字典键不存在用get方法兜底。

模板里所有变量统一前缀命名——配置变量用cfg_开头，临时变量用tmp_开头，输出变量用out_开头。一眼看出变量用途。

流程控制：模板的标准流程骨架

模板的标准流程骨架分五段：初始化-数据采集-数据处理-结果输出-通知收尾。

初始化段——读配置、检查环境、初始化变量。For次数循环用于已知步骤。相似元素循环用于网页批量操作。ForEach列表循环遍历数据。While条件循环用于不确定次数的场景。

每段之间用Try-Catch隔离，一段出错不影响其他段。If条件判断处理分支。模板里的流程控制结构统一，不搞花式写法。

网页自动化：模板的网页操作标准

模板里的网页操作统一用三段式：打开页面-操作-关闭页面。

等待策略三种标配——元素等待为主，固定等待兜底，条件等待处理Ajax。每个网页操作前先元素等待。

弹窗处理五步标准流程写进模板。盲点弹窗用Try-Catch兜底。翻页用disabled class判断。懒加载用滚动+index去重。iframe切换和窗口切换有标准代码块。

数据处理：模板的数据层设计

模板的数据层分三部分——输入数据、中间数据、输出数据。

Excel读写有标准模板——读取用"读取Excel区域"到列表，处理用Python，写入用"写入Excel区域"。文本提取清洗有标准函数库。JSON解析有标准代码块。数据库连接有标准模板——连接-查询-处理-关闭，五步不走完不算完。

数据库五个常见报错写进模板的异常处理里——连接超时重试、权限检查、SQL语法打印、字符集指定utf8、连接数超限用连接池。

鼠标键盘图像自动化：模板的兜底方案

模板里把鼠标键盘图像作为元素定位的兜底方案。元素捕获定位不到时按顺序尝试：XPath→CSS→图像识别→坐标点击。

模拟模式和驱动模式的选择写进规范——需要后台运行用驱动模式，需要可视化用模拟模式。图像识别的wait_appear/click/hover/dblclick封装成标准子流程。锚点9位置加偏移量定位有标准代码块。OCR识别有标准参数配置。

进阶技能：模板的扩展能力

HTTP请求封装成标准子流程——“发送API请求”，参数是URL、method、headers、body，返回响应数据。内部处理超时重试和异常。

Python协同写公共函数库——数据清洗、格式转换、日期处理等常用函数封装成模块，跨流程调用：

# common_utils.pydefclean_price(text):"""清洗价格文本，返回浮点数"""importrematch=re.search(r'([\d,]+\.?\d*)',text)ifmatch:returnfloat(match.group(1).replace(',',''))return0.0defformat_date(date_str,from_format="%Y-%m-%d",to_format="%m月%d日"):"""日期格式转换"""fromdatetimeimportdatetime dt=datetime.strptime(date_str,from_format)returndt.strftime(to_format)

OCR和ADB封装成标准子流程，参数化输入输出。

平台实战：多平台模板的统一架构

电商运营框架覆盖多平台——淘宝、拼多多、抖音、小红书、TEMU。

每个平台的上架、采集、订单处理逻辑封装成独立子流程。主流程根据配置选择平台：

If 平台 == "淘宝" → 调用淘宝子流程 Else If 平台 == "拼多多" → 调用拼多多子流程 Else If 平台 == "抖音" → 调用抖音子流程

子流程接口统一——输入参数是商品数据字典，输出参数是结果字典。换平台只改配置，不改主流程。

系统联动：模板的通知层

通知层统一封装。飞书消息通知——标准子流程，参数是消息内容和@人。飞书多维表格——标准子流程，参数是表格ID和数据。邮件发送——标准子流程，参数是收件人、主题、正文、附件。定时任务——标准配置模板，时间+流程+参数。

工程化与规范：模板设计的核心

这是这篇的重头戏。

命名规范——团队六条铁律

第一条：流程名用"动词-名词-场景"格式。如"采集-商品信息-淘宝"“发送-日报-飞书”。

第二条：变量名用小写+下划线。如product_list、order_count、is_success。不用拼音不用驼峰。

第三条：子流程名和主流程名保持一致的命名风格。调用流程时按名称排列，结构清晰。

第四条：常量全大写。如MAX_RETRY=3、TIMEOUT=15。

第五条：临时变量加tmp_前缀。如tmp_index、tmp_str。

第六条：输出变量加out_前缀。如out_result、out_status。

子流程封装规范

官方文档说得很清楚——“子流程内指令的编写，与主流程的编写方法完全一致”“命名尽量规范，比如使用ABC，流程都会按顺序排列下来”。我再加几条：

每个子流程必须有输入参数和输出参数的定义文档。参数传递要类型匹配——主流程传字符串子流程就别期望列表。子流程内部不能依赖全局变量，所有数据通过参数传入。单个子流程不超过30条指令，超了就继续拆。

调试规范

调试时打断点一行行排查。每个子流程可以单独运行测试。日志格式统一：

print(f"[{timestamp}] [{module}] [{level}]{message}")

模板化设计

把通用逻辑抽成模板，新项目基于模板创建。模板包含——标准流程骨架、标准子流程库、标准命名规范、标准异常处理框架。新项目只需写业务逻辑，不用重复造轮子。

官方文档提到的导出应用功能也很有用——“当任务包含大量应用，且复用率较高时，可以导出为excel文件”。团队间共享流程配置用这个功能。注意导出后不能修改应用uuid，修改会导致导入失败。

版本选择

社区版够个人学习用，但不支持团队协作。创业版支持团队空间和流程共享，适合5-10人团队。企业版有权限管理、集中日志、远程调试，适合大规模团队。

速查表与常见报错

命名不一致——建立团队规范文档，code review检查。子流程参数不匹配——定义参数类型文档，调用时检查。全局变量污染——子流程不用全局变量，全通过参数传。

模板更新后旧流程不兼容——版本化管理，模板改版本号。调试找不到问题——子流程单独运行测试。日志不够详细——统一日志格式，包含时间模块级别信息。

Excel"Array to String"——列表先join。日期偏移——Excel多2天。内存不足——流式读取。循环报错——Try-Catch包住。元素定位失败——备用定位方案。

团队协作模板和命名规范文档我放在了 home.linyan.cloud ，直接下载就能用。

#影刀RPA #流程模板 #团队协作 #RPA教程

作者：林焱