影刀RPA完全指南RPA团队知识库搭建与开发SOP标准模板团队有3个RPA开发了为什么还是一团乱我2019年刚开始用影刀的时候公司就我一个人做RPA。所有流程我自己写、自己维护、自己改bug脑子里记得住就行。到2020年中公司业务扩展RPA流程从5个涨到30多个团队也扩充到了3个人。然后问题就来了我开发的流程同事接手改的时候完全看不懂——变量命名全是我自己临时想的名字同事改了一个淘宝采集流程的XPath没告诉我三天后我的竞品分析流程也调用了同一个子流程直接崩了有一个流程写了三个月才稳定但中间踩过的坑、调过的参数没有记录。新人来问为什么这里要等8秒而不是5秒我只能凭记忆回答版本管理一片混乱桌面上有淘宝采集_v1.flow、“淘宝采集_v2.flow”、“淘宝采集_最终版.flow”、“淘宝采集_最终版_不改了.flow”痛定思痛我们花了大约两周时间把团队的知识库和开发规范搭建了起来。现在团队已经4个人维护50个流程每个人可以独立维护任何流程新人入职一周就能上手。这篇文章分享我们团队的RPA知识库搭建方法和开发SOP附带模板可以直接使用。知识库搭建方案整体结构我们用飞书知识库来承载所有RPA相关的文档。知识库结构如下 RPA开发知识库 ├── 01-开发规范 │ ├── 变量命名规范 │ ├── 流程编写规范 │ ├── XPath编写规范 │ └── Python代码规范 │ ├── 02-流程文档 │ ├── 按业务领域分文件夹 │ │ ├── 财务类 │ │ │ ├── 发票采集流程 │ │ │ └── 自动对账流程 │ │ ├── 电商类 │ │ │ ├── 淘宝竞品采集 │ │ │ ├── 拼多多订单采集 │ │ │ └── 库存同步 │ │ └── 行政类 │ │ ├── 简历自动筛选 │ │ └── 发票报销处理 │ └── 每个流程文档包含 │ ├── 流程概述 │ ├── 流程图 │ ├── 操作手册 │ ├── 依赖说明 │ ├── 常见问题 │ └── 变更记录 │ ├── 03-常见问题库 │ ├── 按异常类型分类 │ │ ├── 元素定位类 │ │ ├── 等待超时类 │ │ ├── Python报错类 │ │ └── 平台风控类 │ └── 每条问题现象→原因→解决→关联流程 │ ├── 04-版本管理 │ ├── 版本号规则 │ ├── 发布记录 │ └── 回滚记录 │ ├── 05-新人入职 │ ├── 第一周培训计划 │ ├── 影刀基础操作指南 │ ├── 常用XPath速查 │ └── 练习项目 │ └── 06-运维监控 ├── 流程运行状态监控规则 ├── 告警处理流程 └── 月度运维报告模板开发规范模板一、变量命名规范这是团队统一后效果最显著的一条。统一之前变量名五花八门a、temp、数据、结果1、df。统一后任何人看到变量名就知道它存的是什么。命名规则前缀含义示例str_字符串str_商品标题、str_登录URLint_整数int_页码、int_重试次数float_浮点数float_价格、float_折扣率bool_布尔值bool_是否登录成功、bool_需要重试list_列表/数组list_商品数据、list_发票信息dict_字典/对象dict_商品详情、dict_配置参数df_DataFramedf_订单数据、df_结算报表json_JSON字符串json_接口返回、json_识别结果path_文件路径path_导出目录、path_配置文件命名示例对比店群矩阵自动化突破运营极限❌ 不规范命名 数据、结果、temp、a、b、c、123、test、测试 ✅ 规范命名 list_淘宝商品列表、int_当前页码、str_搜索关键词、dict_发票识别结果二、流程编写规范流程文件命名[业务领域]_[功能描述]_v[主版本].[次版本].flow 示例 财务_发票批量采集_v2.1.flow 电商_淘宝竞品价格采集_v1.0.flow 行政_简历自动筛选_v3.0.flow流程内节点命名- 所有步骤节点都要有描述性名称不要留步骤1步骤2等默认名 - 名称格式[动作][对象]如打开发票查验平台搜索商品提取价格列表 - 分组框名称[阶段]-[操作]如登录阶段-输入账号数据处理-清洗价格注释要求- 每个分组框开头加注释说明本阶段目标、输入输出、异常处理方式 - 关键逻辑循环、条件判断、重试加注释说明为什么这样写、什么情况下会触发 - XPath旁边加注释说明定位的是什么元素、什么情况下可能失效 - Python步骤开头加注释说明输入变量、输出变量、依赖的库三、XPath编写规范# ❌ 不推荐的XPath写法依赖CSS类名容易失效 //div[classcontent-wrapper-QVTcU0M]//span[classprice-int] # ✅ 推荐的XPath写法使用文本内容/属性特征定位更稳定 # 1. 用文本匹配最稳定 //span[contains(text(),¥) and string-length(normalize-space()) 10] # 2. 用属性组合次稳定 //input[typetext and contains(placeholder,搜索)] # 3. 用相对位置较稳定 //div[classproduct-list]//div[contains(class,item)][1]//span # 4. 才用CSS类名最不稳定需要定期检查XPath注释模板# 定位商品标题文本 # 页面淘宝搜索结果页 # 更新日期2024-07-01 # 注意事项大促期间页面可能有促销标签影响定位  //div[contains(class,Card--doubleCardWrapper)]//div[contains(class,Title)]//span流程文档模板每个流程都要在知识库中有一份完整的文档。这是我们的标准模板# [流程名称] ## 基本信息 - **流程ID**: FLOW-YYMMDD-001 - **版本**: v2.1 - **创建人**: 林焱 - **创建日期**: 2024-03-15 - **最后更新**: 2024-07-01 - **业务领域**: 电商-竞品监控 - **运行频率**: 每日6:00 - **预计执行时间**: 15-25分钟 - **负责人**: 林焱 / 备份: 张三 ## 业务背景 [为什么要做这个流程解决什么问题业务价值是什么] ## 流程概述 [一段话描述流程做什么] ## 前置条件 - [ ] 影刀客户端版本 ≥ 3.5.0 - [ ] Chrome浏览器版本 ≥ 120 - [ ] 淘宝千牛账号已登录 - [ ] 飞书Base Token已配置 - [ ] 网络环境正常非VPN ## 流程图 [插入影刀流程图截图] ## 变量清单 | 变量名 | 类型 | 说明 | 来源 | |--------|------|------|------| | str_搜索关键词 | 字符串 | 搜索的关键词 | 配置文件读取 | | int_最大重试次数 | 整数 | API调用失败重试次数 | 流程内常量3 | | list_商品列表 | 列表 | 采集到的商品数据 | 提取步骤生成 | | path_导出路径 | 文件路径 | CSV导出位置 | 配置文件读取 | ## 依赖说明 ### 外部系统 - 淘宝千牛卖家中心 (https://myseller.taobao.com) - 飞书Base (Token: basetokenXXXX) - 飞书Webhook (https://open.feishu.cn/...) ### Python依赖 - requests ≥ 2.28.0 - pandas ≥ 1.5.0 - openpyxl ≥ 3.1.0 ## 操作手册 ### 日常运行 1. 检查影刀计划任务是否正常触发 2. 每日9:00查看飞书推送的运行结果 3. 如有告警按告警类型处理 ### 手动执行 1. 打开影刀客户端 2. 找到流程电商_淘宝竞品采集 3. 确认配置文件中的搜索关键词 4. 点击运行 ### 异常处理 | 异常 | 可能原因 | 处理方式 | |------|----------|----------| | 验证码弹窗 | 淘宝风控 | 手动输入验证码流程会自动继续 | | 元素定位失败 | 页面结构更新 | 检查并更新XPath见下方变更记录 | | 飞书写入超时 | API限流 | 检查API配额等待10分钟后重试 | ## 常见问题 Q1: 流程运行一半不动了 A: 可能碰到了验证码检查屏幕是否有验证码弹窗手动处理后流程会自动继续。 Q2: 为什么有时候采集到20个商品有时候只有15个 A: 淘宝搜索结果会受千人千面和实时竞价影响数据量有小幅波动是正常的。 ## 变更记录 | 日期 | 版本 | 变更人 | 变更内容 | |------|------|--------|----------| | 2024-07-01 | v2.1 | 林焱 | 更新淘宝搜索结果页XPath页面改版 | | 2024-05-15 | v2.0 | 林焱 | 增加飞书Base自动写入功能 | | 2024-03-15 | v1.0 | 林焱 | 初始版本 | ## 关联流程 - 拼多多竞品采集 (FLOW-240316-001) - 竞品数据对比分析 (FLOW-240401-001)常见问题库模板# RPA常见问题库 ## 问题ID: QA-001 ### 现象 - 流程报错等待元素超时未找到目标元素 - 报错位置淘宝搜索结果页 - 最近页面无改版 ### 发生条件 - 网络较慢时更容易出现 - 搜索词为大词时结果多加载慢 - 最近3天出现2次 ### 排查步骤 1. 检查目标元素是否在页面HTML中F12查看 2. 检查是否有iframe未切换 3. 检查元素是否被其他元素遮挡 4. 检查等待时间是否足够网络慢时可能需要延长 ### 解决方案 增加等待时间到20秒或改用等待元素可见替代等待元素出现 ### 关联流程 - 淘宝竞品采集 (FLOW-240315-001) - 拼多多订单采集 (FLOW-240320-002) ### 解决人/日期 林焱 / 2024-06-15版本管理规范版本号规则v主版本.次版本.修订号 主版本重大功能变更或不兼容的改动 次版本新增功能或较大的优化 修订号bug修复、XPath更新等小改动 示例 v1.0.0 - 初始版本 v1.1.0 - 新增飞书告警功能 v1.1.1 - 修复XPath失效问题 v2.0.0 - 重构整个流程架构版本管理操作清单发布前检查 □ 已在新版本文件名中标注版本号 □ 已在流程文档中更新变更记录 □ 已通知相关团队成员 □ 已备份旧版本移到archive文件夹 □ 已在计划任务中切换到新版本 □ 已运行一次测试验证新人培训SOP第一周时间内容产出Day 1影刀基础操作安装、界面介绍、创建第一个流程完成打开百度搜索的简单流程Day 2元素定位XPath基础、Chrome开发者工具、常见定位技巧完成淘宝搜索采集商品标题任务Day 3流程控制循环、条件判断、变量、子流程完成从Excel读取数据→循环搜索→保存结果任务Day 4Python步骤在影刀中使用Python、常用库、数据处理完成采集数据Python清洗写入Excel任务Day 5实战练习阅读一个已有的完整流程文档尝试修改一个小功能成功修改并运行一个现有流程新人上手检查清单□ 能独立创建包含循环和条件判断的流程 □ 能用Chrome开发者工具编写XPath并验证 □ 能阅读并理解现有的流程文档 □ 能使用Python步骤做基础数据处理 □ 知道遇到问题时去哪里查找答案常见问题库→流程图文档→问同事 □ 了解版本管理规则不会乱改生产流程常见问题速查问题1团队不愿意写文档怎么办现象要求每个流程写文档但大家口头上答应了实际上文档要么没写要么只写了标题。原因写文档确实需要额外的精力尤其是deadline紧的时候。解决方式把写文档作为流程上线的最后一步不写文档不允许发布到计划任务把文档模板做得足够简单5分钟就能填完核心信息自己先写几个范例让大家看到文档的价值新人入职培训时强调文档的重要性培养习惯从新人开始问题2知识库写了没人看变成僵尸文档现象知识库里一堆文档但大家遇到问题还是直接微信问。原因文档查找不方便或者文档内容已经过时了。temu店群自动化报活动案例解决方式把常见问题放到飞书知识库的显眼位置让群机器人支持关键词查询建立文档定期审查机制每季度一次过时的及时更新或标记团队内推广先查文档再提问的文化被问到文档里有答案的问题时回复文档第X章有答案问题3不同业务线的流程放在一起越来越混乱现象30多个流程放在一起什么类型都有。原因初始没规划好目录结构。解决方式按业务领域财务/电商/行政/HR一级分类每个领域内再按子业务分类建立已废弃文件夹不直接删除旧流程每个流程文件名严格遵循命名规范问题4怎么避免一个人离职RPA全线瘫痪现象某个核心RPA开发要离职了他写的流程只有他能维护。原因知识传承不足没有备份人机制。解决方式每个流程必须有主负责人和备份负责人定期每月做流程讲解分享轮流讲自己负责的流程离职交接时要求至少有一周的交叠时间实际演练一遍所有流程流程文档必须写得足够详细使得一个非原作者能看懂问题5影刀版本更新后部分流程不兼容现象影刀客户端更新后某些指令的配置方式变了流程无法正常运行。原因影刀的产品更新可能改变指令的参数或行为。解决方式不盲目升级影刀客户端先在一台测试机上验证兼容性关注影刀官方更新日志评估哪些会影响现有流程在知识库中维护影刀版本兼容性表记录每个流程适用的客户端版本问题6怎么评估一个流程值不值得做现象业务方提了一个需求RPA团队花了三天做出来结果发现这个流程一个月只用一次。原因缺乏需求评估机制。解决方式建立RPA需求评估公式ROI (节省人力小时数 × 每小时人力成本 × 月执行次数) / (开发时长 × 每小时开发成本) 阈值建议 - ROI 3: 高优先级立即开发 - ROI 1-3: 中优先级排期开发 - ROI 1: 低优先级建议暂缓或用更简单的方法替代推荐资源飞书知识库使用指南在企业飞书左侧导航栏 → 知识库 → 创建知识空间影刀RPA官方文档https://www.yingdao.com/document流程图绘制工具在飞书文档中直接用Mermaid画流程图版本管理工具如果团队技术能力够可以用Git管理流程文件.flow文件本身是JSON格式内容标签#影刀RPA #知识库 #SOP #团队管理 #开发规范 #版本管理 #新人培训 #飞书作者林焱| 影刀RPA深度使用者两年以上实操经验 | 专注于RPA团队建设与流程标准化