写XPath定位元素是最头疼的事。遇到复杂层级、动态ID、影子DOM，调半天也定位不准。 影刀魔法指令3.0用自然语言描述你要操作什么元素，它会自动生成对应的流程代码。
核心功能：在指令框输入“点击商品标题”“提取价格数字”这种大白话，魔法指令自动转换成影刀指令和XPath。
一、魔法指令3.0是什么？
它是影刀内置的AI功能，位于右侧指令面板的顶部搜索框旁边。 不需要自己写XPath，不需要记住指令名称，用中文描述你要做什么就行。
支持的操作类型：
- 元素操作：点击、输入、获取文本、获取属性
- 数据提取：从列表提取、从表格提取
- 条件判断：是否存在、是否包含
- 流程控制：等待、循环
社区版/创业版差异： 魔法指令3.0在社区版中每天有免费调用次数限制（约20-30次），创业版和企业版不限次。
二、基础用法：一句话生成指令
操作步骤
- 在左侧指令面板搜索框旁边，找到魔法棒图标（或按快捷键
Ctrl + Shift + M） - 在弹出的输入框里，用自然语言描述你要做什么
- 魔法指令生成对应的影刀指令，直接插入画布
示例输入输出：
| 你说的 | 魔法指令生成的内容 |
|---|---|
| “点击登录按钮” | 点击元素指令，自动捕获了登录按钮的XPath |
| “获取商品标题的文本” | 获取元素文本指令 + 自动定位标题元素 |
| “等待搜索结果加载完成” | 等待元素出现指令 + 自动识别结果列表 |
| “在搜索框输入‘手机’并搜索” | 输入文本 + 点击搜索按钮两个指令 |
# 你输入：点击拼多多商品详情页的“立即购买”按钮
# 魔法指令自动生成：
点击元素：//button[contains(text(),'立即购买')]
等待时间：0.3秒
注意： 魔法指令生成的XPath是基于当前页面的实时结构。页面改版后需要重新生成，不能完全依赖。
三、进阶用法：多步流程一句话生成
魔法指令3.0支持生成多个连续指令。
示例1：登录流程
你说：“打开淘宝登录页，输入账号abc@123.com，输入密码123456，点击登录按钮”
生成结果：
- 打开网页：
https://login.taobao.com - 输入文本：账号输入框，内容
abc@123.com - 输入文本：密码输入框，内容
123456 - 点击元素：登录按钮
示例2：采集列表数据
你说：“采集搜索结果页所有商品的标题、价格和销量，存入表格”
生成结果：
- 获取相似元素列表：商品容器
- 循环元素列表
- 在当前元素下查找标题、价格、销量
- 获取文本并写入Excel
容易踩的坑： 魔法指令生成的流程比较“模板化”，复杂业务逻辑需要自己调整。比如它可能不知道你要存到哪个Excel文件的哪个sheet。
四、魔法指令 vs 传统写XPath 对比
| 维度 | 传统方式 | 魔法指令3.0 |
|---|---|---|
| 上手门槛 | 需要懂XPath语法 | 零门槛，说中文 |
| 定位稳定性 | 手工写的XPath更精确 | 生成的XPath可能偏宽泛 |
| 动态元素 | 需要手写contains/starts-with | 自动处理动态ID |
| 调试难度 | 用XPath Helper验证 | 生成的指令可能找不到元素 |
| 学习成本 | 2-3天入门 | 5分钟上手 |
我的建议： 新手先用魔法指令生成框架，再手工优化XPath。老手用魔法指令快速搭建原型，节省找元素的时间。
五、魔法指令的3个隐藏技巧
技巧1：用“捕获元素”辅助魔法指令
魔法指令自动捕获元素时，可能抓错位置。 先用“捕获元素”按钮手动选中目标，再打开魔法指令说“对当前捕获的元素做xxx”，它会基于你选中的元素生成XPath。
技巧2：重新生成和微调
生成的结果不满意，点击魔法指令生成的指令块右上角的魔法棒小图标，可以重新生成或修改描述。
技巧3：复用生成结果
魔法指令生成的XPath可以复制出来，用在其他指令里。 右键点击生成的“点击元素”指令，选择“复制XPath”，贴到别的指令里用。
六、魔法指令常见失败场景
| 你说的话 | 可能失败的原因 | 解决方案 |
|---|---|---|
| “点击那个蓝色的按钮” | “蓝色”是视觉描述，不是元素属性 | 改说“点击提交按钮”或“点击class包含primary的按钮” |
| “获取第一行第二列的数据” | 页面没有表格结构 | 先明确元素是什么，比如“获取价格表格中第2行第3列的文本” |
| “等待页面加载完” | 加载完成的标志不明确 | 改为“等待购物车图标出现” |
| “滚动到底部” | 魔法指令可能生成滚动指令但位置不对 | 手动用“滚动到页面底部”指令代替 |
七、完整实战：用魔法指令搭建小红书采集流程
第1步：打开小红书搜索页 在魔法指令输入：“打开小红书网站，搜索‘影刀RPA’”
第2步：等待结果加载 “等待笔记列表加载完成”
第3步：采集笔记信息 “获取所有笔记卡片的标题、作者和点赞数，存入列表”
第4步：翻页 “点击下一页按钮，重复采集直到没有下一页”
魔法指令会自动生成20-30个指令。 你需要做的只是：
- 检查生成的XPath是否准确（运行前测试一下）
- 调整等待时间（魔法指令默认可能太短）
- 加上数据写入Excel的指令（魔法指令可能不知道你要存哪里）
# 魔法指令生成后，手动补充写入Excel的指令
Excel Workbook打开：文件"小红书结果.xlsx"，自动创建
写入行数据到表格：起始"A1"，行数据["标题","作者","点赞数"]
循环列表：采集到的笔记列表
追加行到表格：行数据={当前笔记}
Excel Workbook保存并关闭
八、魔法指令3.0 vs 传统指令 效率对比实测
| 任务 | 传统方式耗时 | 魔法指令耗时 | 适用场景 |
|---|---|---|---|
| 捕获一个简单按钮 | 10秒 | 5秒 | 都很快 |
| 定位复杂的动态弹窗元素 | 3-5分钟（调试XPath） | 20秒 | 魔法完胜 |
| 采集相似元素列表 | 1分钟（手写XPath） | 15秒 | 魔法完胜 |
| 精确匹配某类特定元素 | 30秒 | 可能生成不准确的XPath | 传统胜 |
| 维护已有流程 | 直接修改 | 重新生成可能破坏逻辑 | 传统胜 |
结论： 魔法指令适合快速原型和一次性采集任务。长期维护的流程建议手工优化XPath。
九、易错速查表
| 错误现象 | 原因 | 解决方法 |
|---|---|---|
| 生成的指令找不到元素 | 魔法指令捕获的XPath太宽泛 | 手工改用contains或增加父级限定 |
| 魔法输入框打不开 | 快捷键冲突或版本过低 | 升级影刀到最新版，或用顶部按钮 |
| 社区版提示“今日次数已用完” | 免费次数限制 | 改用传统方式，或升级创业版 |
| 生成的流程逻辑不对 | 描述不够精确 | 把一句话拆成多句，分步生成 |
| 点击了错误的位置 | 页面有多个相似元素 | 在描述里加限定，如“左侧的登录按钮” |
推荐资源
- 影刀官方魔法指令教程：在帮助中心搜索“魔法指令3.0”有视频演示
- 我的经验：魔法指令生成后，一定用“测试”按钮跑一次，不要直接放流程里运行
- 进阶：魔法指令+手工XPath混合使用——让魔法指令生成基础XPath，你再手动加
contains()或and条件
作者：林焱
本文为《影刀RPA学习手册》系列文章之一，内容源于实操经验的整理与分享。