影刀RPA进阶教程_自定义指令封装指南把常用的五步操作变成一个指令

原创于 2026-06-16 14:10:34 发布 · 222 阅读

4 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

影刀RPA新手指南

该文章已生成可运行项目，

影刀RPA进阶教程：自定义指令封装——把常用的五步操作变成一个指令

影刀RPA自定义指令是效率跃迁的关键。每次都要写"等待元素→点击→等待→输入→再等待"这五步操作，不仅写得手酸，还容易遗漏某一步导致流程不稳定。封装成自定义指令后，一行调用搞定，出错率降到零。

作者：林焱 | 影刀RPA进阶系列

在这里插入图片描述

为什么要封装自定义指令

以最常见的"安全输入"为例——看起来只是在输入框里输入文字，实际上要考虑：

输入框是否已加载（等待元素可见）
框里是否有旧内容（先清空）
输入方式要不要模拟人工（延时/逐字）
输入后要不要按回车确认
失败后要不要重试

这些细节每次都要重写，不仅代码臃肿，不同流程写法还不一样，维护灾难。

封装成自定义指令 安全输入 后，整个流程只需要：

安全输入(选择器="#search-box", 内容="关键词", 清空=是, 回车=是, 重试次数=3)

店群矩阵自动化突破运营极限！

在这里插入图片描述

封装案例一：带重试的安全点击

# 影刀「执行Python」指令
def safe_click(selector, wait_time=3000, retry=3, delay=500):
    """
    安全点击：等待元素出现 → 点击 → 失败重试
    参数：
      selector: CSS/XPath选择器
      wait_time: 最长等待毫秒
      retry: 重试次数
      delay: 重试间隔毫秒
    """
    import time
    
    for attempt in range(retry):
        try:
            # 等待元素出现
            等待元素可见(selector, wait_time)
            
            # 额外稳定等待（元素可见不等于可点击）
            time.sleep(delay / 1000)
            
            # 执行点击
            点击元素(selector)
            
            # 返回成功
            return {'success': True, 'attempt': attempt+1}
            
        except Exception as e:
            if attempt < retry - 1:
                print(f"点击失败(第{attempt+1}次)，{delay}ms后重试... 原因：{e}")
                time.sleep(delay / 1000)
            else:
                # 所有重试用完，截图留证据
                截图保存(f"error_click_{selector.replace('#','')}.png")
                return {'success': False, 'error': str(e), 'attempt': attempt+1}

# 使用示例
result = safe_click('#login-btn', wait_time=5000, retry=3)
if not result['success']:
    发送告警(f"登录按钮点击失败: {result['error']}")

封装案例二：智能表单填充

在这里插入图片描述

def smart_fill_form(form_data, wait_between=300):
    """
    智能填表：根据字段类型自动选择填充方式
    form_data 格式：
    [
        {'selector': '#name', 'value': '张三', 'type': 'input'},
        {'selector': '#city', 'value': '上海', 'type': 'select'},
        {'selector': '#date', 'value': '2026-06-11', 'type': 'date'},
        {'selector': '#agree', 'value': True, 'type': 'checkbox'},
        {'selector': '#file-upload', 'value': 'C:/图片.jpg', 'type': 'file'},
    ]
    """
    import time
    
    results = []
    
    for field in form_data:
        try:
            selector = field['selector']
            value = field['value']
            ftype = field.get('type', 'input')
            
            if ftype == 'input':
                safe_click(selector)
                time.sleep(0.1)
                清空并输入(selector, value)
            
            elif ftype == 'select':
                safe_click(selector, wait_time=2000)
                time.sleep(0.3)
                # 在下拉列表中找到并点击选项
                设置下拉框值(selector, value)
            
            elif ftype == 'date':
                # 用JS绕过日历组件
                执行JS(f"""
                    document.querySelector('{selector}').value = '{value}';
                    document.querySelector('{selector}').dispatchEvent(new Event('change'));
                """)
            
            elif ftype == 'checkbox':
                # 先检查状态
                current_state = 获取元素属性(selector, 'checked')
                target_state = 'true' if value else 'false'
                if current_state != target_state:
                    点击元素(selector)
            
            elif ftype == 'file':
                # 拖拽上传
                拖拽文件到元素(value, selector)
            
            results.append({'field': selector, 'status': 'ok'})
            time.sleep(wait_between / 1000)
            
        except Exception as e:
            results.append({'field': selector, 'status': 'error', 'error': str(e)})
    
    # 返回填充结果
    success_count = sum(1 for r in results if r['status'] == 'ok')
    failed_fields = [r for r in results if r['status'] == 'error']
    
    return {
        'total': len(form_data),
        'success': success_count,
        'failed': failed_fields
    }

封装案例三：智能翻页器

def smart_pagination(extract_func, max_pages=100, page_indicator=None):
    """
    智能翻页：自动翻页并采集每页数据
    参数：
      extract_func: 单页数据提取函数
      max_pages: 最大翻页数
      page_indicator: 页码指示器选择器（用于判断是否有下一页）
    """
    all_data = []
    page = 0
    
    while page < max_pages:
        page += 1
        
        # 检查页面加载状态
        wait_for_page_ready()
        
        # 提取当前页数据
        try:
            page_data = extract_func()
            all_data.extend(page_data)
            print(f"第{page}页：提取 {len(page_data)} 条数据")
        except Exception as e:
            print(f"第{page}页提取失败: {e}")
            # 截图留证，继续下一页
            continue
        
        # 判断是否有下一页
        if not has_next_page(page_indicator):
            print(f"已到最后一页（共{page}页）")
            break
        
        # 点击下一页
        try:
            click_next_page()
            random_delay(1000, 2000)  # 翻页间隔
        except:
            print(f"翻页失败，终止于第{page}页")
            break
    
    return all_data


def has_next_page(indicator_selector=None):
    """判断是否有下一页"""
    if indicator_selector:
        return 元素存在(indicator_selector)
    
    # 通用判断方式
    next_btn_selectors = [
        '.next:not(.disabled)',
        '.pagination-next:not(.disabled)',
        'a[rel="next"]',
        'button:has-text("下一页"):not([disabled])',
    ]
    
    for selector in next_btn_selectors:
        if 元素存在(selector):
            return True
    
    return False

如何组织自定义指令库

推荐的文件结构：

自定义指令库/
├── 元素操作/
│   ├── safe_click.py         # 安全点击
│   ├── safe_input.py         # 安全输入
│   ├── safe_scroll.py        # 安全滚动
│   └── wait_page_ready.py    # 等待页面就绪
├── 数据处理/
│   ├── smart_fill_form.py    # 智能填表
│   ├── parse_count.py        # 数量格式解析（1.2万→12000）
│   └── clean_text.py         # 文本清洗
├── 流程控制/
│   ├── smart_pagination.py   # 智能翻页
│   ├── retry_wrapper.py      # 通用重试装饰器
│   └── login_guard.py        # 登录保护
└── 通知/
    ├── send_wecom.py         # 发送企微消息
    └── send_email.py         # 发送邮件

命名规则：动词+名词，一眼知道干什么。

在这里插入图片描述