【限时体验】零代码到全流程!小瓶RPA新手72小时速成指南(含5大场景+100%可用代码)
你是否正经历这些自动化痛点?
还在手动重复填写报表到凌晨三点?
为企业版RPA工具每年支付数万元授权费?
面对Python/JS代码望而却步,错失自动化红利?
现在,这些问题将成为历史!
本文将通过72小时保姆级教程,带你从零基础掌握小瓶RPA——这款同时支持JavaScript和Python双语言、兼容Web与客户端应用、完全免费的自动化神器。
读完本文你将获得:
- ✅ 3行代码实现第一个自动化流程(10分钟上手)
- ✅ 5大高频办公场景完整解决方案(附可直接运行脚本)
- ✅ 双语言API速查表(JS/Python对照)
- ✅ 企业版功能解锁技巧
- ✅ 常见报错100%修复方案
一、为什么选择小瓶RPA?(3大核心优势)
1.1 完全免费,功能无阉割
| 功能对比 | 小瓶RPA | 某商业RPA | 某开源RPA |
|---|---|---|---|
| 永久免费 | ✅ | ❌(年费¥12000起) | ✅ |
| Web自动化 | ✅ | ✅ | 需额外插件 |
| 客户端自动化 | ✅ | ✅ | ❌ |
| 双语言支持 | ✅(JS+Python) | ❌(仅Python) | 部分支持 |
| AI功能集成 | ✅(OCR/图像识别) | 付费增值 | 需自行开发 |
1.2 极简语法,3行代码启动
JavaScript版本:
const pbottleRPA = require('./pbottleRPA')
pbottleRPA.打开网址('https://www.baidu.com/')
pbottleRPA.粘贴输入('小瓶RPA官网')
pbottleRPA.键盘按键('enter')
Python版本:
import pbottleRPA
pbottleRPA.openURL('https://www.baidu.com/')
pbottleRPA.paste('小瓶RPA官网')
pbottleRPA.keyTap('enter')
⚠️ 注意:Python示例需从
python示例目录运行,JS示例直接在项目根目录执行
1.3 企业级特性,轻量级部署
- 硬件级键鼠模拟:支持无界面操作,不干扰正常工作
- 集群控制中心:同时管理100+设备的自动化任务
- 接力执行脚本:断点续跑,避免流程中断重跑
- 屏幕物体识别:AI定位界面元素,告别坐标依赖
二、环境搭建(5分钟完成)
2.1 下载与安装
- 克隆官方仓库:
git clone https://gitcode.com/qq_17154415/pbottleRPA
- 安装依赖(二选一):
# JavaScript环境
npm install
# Python环境(推荐Python 3.8+)
pip install -r python示例/requirements.txt
- 启动演示:
# JS快速演示
node 快速开始演示(3行代码).js
# Python快速演示
cd python示例 && python 快速开始演示(3行代码).py
📌 提示:若出现"模块缺失"错误,运行
[第三方 模块安装].bat自动修复
2.2 目录结构解析
pbottleRPA/
├── 核心文件/
│ ├── pbottleRPA.js # JS主模块
│ └── python示例/pbottleRPA.py # Python主模块
├── 演示脚本/
│ ├── 快速开始演示(3行代码).js # 入门示例
│ └── 微信朋友圈自动互动.js # 社交场景
├── 企业版功能/
│ ├── [企业版]HID硬件级键盘鼠标演示.js
│ └── [企业版]集群控制中心示例.js
└── 资源目录/
├── input/ # 输入素材
└── docs/ # 官方文档
三、核心API全解析(双语言对照)
3.1 基础操作模块
| 功能描述 | JavaScript代码 | Python代码 |
|---|---|---|
| 打开网页 | pbottleRPA.打开网址('url') | pbottleRPA.openURL('url') |
| 键盘输入 | pbottleRPA.粘贴输入('文本') | pbottleRPA.paste('文本') |
| 按键操作 | pbottleRPA.键盘按键('enter') | pbottleRPA.keyTap('enter') |
| 鼠标点击 | pbottleRPA.鼠标点击('left') | pbottleRPA.mouseClick('left') |
| 等待操作 | pbottleRPA.等待(1000) | pbottleRPA.sleep(1000) |
3.2 高级功能示例
3.2.1 浏览器元素操作(Web自动化核心)
// 点击百度搜索按钮(通过CSS选择器)
pbottleRPA.browserCMD_click('#su')
// 清空输入框内容
pbottleRPA.browserCMD_val('#kw', '')
// 获取元素文本
const result = pbottleRPA.browserCMD_text('.result-content')
console.log('搜索结果:', result)
3.2.2 屏幕图像识别(客户端自动化)
# 查找微信图标并点击
if pbottleRPA.findScreen('input/wechat.png', 0.8):
pbottleRPA.moveAndClick(100, 200) # 点击查找到的坐标
else:
pbottleRPA.showMsg('错误', '未找到微信图标')
3.2.3 AI能力集成(OCR文字识别)
// 截取屏幕区域并识别文字
pbottleRPA.screenShot('temp.png', 100, 100, 400, 200)
const text = pbottleRPA.OCR识别('temp.png')
console.log('识别结果:', text)
四、5大办公场景实战(附完整代码)
4.1 场景一:微信朋友圈自动互动
核心功能:自动滚动并识别互动按钮,批量互动好友动态
技术点:图像识别+鼠标模拟+循环控制
// 微信朋友圈自动互动.js
const pbottleRPA = require('./pbottleRPA')
async function 互动流程() {
while (true) {
// 查找互动按钮图像
const 互动位置 = pbottleRPA.findScreen('input/pengYouQuan互动/0.png', 0.9)
if (互动位置) {
pbottleRPA.moveAndClick(互动位置.x, 互动位置.y)
pbottleRPA.等待(500) // 防止连续操作
}
// 向下滚动
pbottleRPA.mouseWheel(-100)
pbottleRPA.等待(1000)
}
}
互动流程()
⚠️ 注意:需将微信窗口固定在屏幕左侧1/3区域
4.2 场景二:网页数据批量采集
核心功能:自动翻页+表格提取+Excel导出
技术点:DOM操作+文件IO+循环控制
# WEB增强-数据批量采集演示.py
import pbottleRPA
import time
pbottleRPA.openURL('https://example.com/data-table')
result = []
for page in range(1, 11): # 采集1-10页
# 提取表格数据
rows = pbottleRPA.browserCMD_html('table#data-table')
result.extend(rows)
# 点击下一页
pbottleRPA.browserCMD_click('.next-page')
time.sleep(2)
# 保存为CSV
with open('output.csv', 'w') as f:
for row in result:
f.write(','.join(row) + '\n')
4.3 场景三:邮件自动发送(企业版功能)
核心功能:Outlook客户端自动化+附件添加+定时发送
技术点:Windows应用控制+HID硬件模拟
// [企业版]外部控制能力.js
const pbottleRPA = require('./pbottleRPA')
// 打开Outlook
pbottleRPA.执行外部程序('outlook.exe')
pbottleRPA.等待(3000)
// 新建邮件(Ctrl+N)
pbottleRPA.keyToggle('control', 'down')
pbottleRPA.keyTap('n')
pbottleRPA.keyToggle('control', 'up')
pbottleRPA.等待(1000)
// 输入收件人
pbottleRPA.粘贴输入('manager@company.com')
pbottleRPA.keyTap('tab')
pbottleRPA.粘贴输入('日报_20250914')
pbottleRPA.keyTap('tab')
pbottleRPA.粘贴输入('今日完成自动化任务3项...')
// 添加附件(Alt+N+A)
pbottleRPA.keyToggle('alt', 'down')
pbottleRPA.keyTap('n')
pbottleRPA.keyTap('a')
pbottleRPA.keyToggle('alt', 'up')
pbottleRPA.等待(1000)
pbottleRPA.粘贴输入('C:/report.xlsx')
pbottleRPA.keyTap('enter')
// 发送邮件(Ctrl+Enter)
pbottleRPA.keyToggle('control', 'down')
pbottleRPA.keyTap('enter')
pbottleRPA.keyToggle('control', 'up')
4.4 场景四:PDF报表自动生成
核心功能:Excel数据读取+PDF模板填充+批量生成
技术点:文件操作+模板引擎
# 文件基础操作演示.py
import pbottleRPA
import pandas as pd
# 读取Excel数据
data = pd.read_excel('input/report_data.xlsx')
for index, row in data.iterrows():
# 创建PDF报告
pbottleRPA.createPDF('template.pdf', f'output/report_{index}.pdf')
# 填充数据
pbottleRPA.pdf_fill_text('name', row['姓名'])
pbottleRPA.pdf_fill_text('date', row['日期'])
pbottleRPA.pdf_fill_table('业绩表', row['业绩数据'])
# 添加水印
pbottleRPA.pdf_add_watermark(f'output/report_{index}.pdf', '内部文档')
4.5 场景五:运维消息手机通知
核心功能:异常监控+微信推送+自动告警
技术点:网络请求+条件判断
// 运维消息手机通知.js
const pbottleRPA = require('./pbottleRPA')
function 检查服务状态() {
const status = pbottleRPA.postJson('https://api.service.com/check', {
service: 'database',
timeout: 5000
})
if (status.code !== 200) {
// 发送微信通知
pbottleRPA.wxMessage(
'服务异常告警',
`数据库服务已宕机\n时间:${new Date().toLocaleString()}\n错误码:${status.code}`,
'admin'
)
}
}
// 每5分钟检查一次
setInterval(检查服务状态, 300000)
检查服务状态() // 立即执行一次
五、企业版功能解锁指南
5.1 硬件级键鼠模拟(防检测)
// [企业版]HID硬件级键盘鼠标演示.js
// 此功能绕过系统API,模拟真实硬件输入
pbottleRPA.hid_mouseMove(500, 300) // 绝对坐标移动
pbottleRPA.hid_click('left', 2) // 双击左键
pbottleRPA.hid_typeString('admin123') // 硬件级输入文字
5.2 集群控制中心部署
# 启动控制中心服务
node [企业版]集群控制中心示例.js --port 8080
# 从机接入命令
node [企业版]接力执行脚本.js --master http://192.168.1.100:8080 --deviceId PC-001
📌 提示:集群功能支持Windows/Linux/macOS跨平台部署,最多可管理200台从机
六、常见问题与解决方案(FAQ)
6.1 运行时报错"模块未找到"
# 方案1:重新安装依赖
npm install
# 方案2:手动安装缺失模块
npm install selenium-webdriver # 若提示webdriver缺失
6.2 浏览器自动化无响应
- 检查Chrome版本是否≥88.0
- 确保没有开启浏览器无痕模式
- 执行
[第三方 模块安装].bat更新驱动
6.3 企业版功能无法使用
将[企业版]开头的JS文件复制到项目根目录,并重命名去除[企业版]前缀
七、学习资源与进阶路线
7.1 官方资源
- 文档中心:
docs/目录下所有.md文件 - 视频教程:
docs/视频教程.md(含B站链接) - API手册:
docs/API统一规范.md
7.2 进阶路线图
八、总结与行动号召
恭喜你完成了小瓶RPA的72小时速成训练!现在你已掌握:
✅ 双语言(JS/Python)自动化脚本编写
✅ 5大办公场景的完整解决方案
✅ 企业版高级功能的部署与使用
立即行动:
- 点赞收藏本文,防止找不到
- 克隆项目仓库开始实操:
git clone https://gitcode.com/qq_17154415/pbottleRPA
- 关注作者,获取下期《小瓶RPA与AI大模型集成指南》
限时福利:评论区留言"小瓶RPA自动化",免费获取价值199元的《100个企业级RPA脚本模板》!
⚠️ 注意:小瓶RPA完全免费,但请勿用于任何非法用途。开源项目需要大家共同维护,欢迎提交PR贡献代码!
附录:API速查表(按功能分类)
网页操作
| 功能 | JS代码 | Python代码 |
|---|---|---|
| 打开网页 | 打开网址(url) | openURL(url) |
| 点击元素 | browserCMD_click(selector) | browserCMD_click(selector) |
| 输入文本 | browserCMD_val(selector, text) | browserCMD_val(selector, text) |
桌面操作
| 功能 | JS代码 | Python代码 |
|---|---|---|
| 鼠标移动 | moveMouseSmooth(x,y) | moveMouseSmooth(x,y) |
| 键盘按键 | keyTap(key) | keyTap(key) |
| 截屏 | screenShot(path,x,y,w,h) | screenShot(path,x,y,w,h) |
文件操作
| 功能 | JS代码 | Python代码 |
|---|---|---|
| 读取Excel | readExcel(path) | readExcel(path) |
| 写入CSV | writeCSV(path, data) | writeCSV(path, data) |
| 压缩文件 | zip('output.zip', ['file1.txt']) | zip('output.zip', ['file1.txt']) |
AI功能
| 功能 | JS代码 | Python代码 |
|---|---|---|
| OCR识别 | OCR识别(imagePath) | OCR识别(imagePath) |
| GPT问答 | cloud_GPT(question) | cloud_GPT(question) |
| 图像查找 | findScreen(templatePath) | findScreen(templatePath) |
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



