melody-autocli

v0.0.6

Published

3 months ago

Melody RPA CLI Tool

Downloads

0High
0Medium
0Low

metalheart

Melody CLI

Melody RPA 自动化脚本的命令行开发工具，用于构建、运行和打包 Melody RPA 脚本项目。

功能特性

📱 设备管理 - 连接 Android 设备进行调试
📦 项目构建 - Browserify 打包 + 依赖分析
🎁 MPK 打包 - 生成可安装的 RPA 脚本包
🚀 真机运行 - 快速部署到设备运行测试
🛠️ 任务队列 - 添加任务到设备执行队列

环境要求

| 工具 | 版本要求 | |------|----------| | Node.js | >= 16.0.0 | | npm | >= 8.0.0 | | ADB | >= 1.0.40 |

快速开始

1. 安装

# 方式一：全局安装
npm install -g melody-autocli

# 方式二：本地运行
cd <项目目录>
npm install
npm run build

2. 连接设备

# 列出已连接设备
melody devices

3. 创建项目

# 交互式创建
melody create

# 参数式创建
melody create --template=empty --name=my-script --path=./my-script

4. 构建与运行

# 构建项目
melody build <project-path>

# 打包 MPK
melody package <project-path>

# 构建并运行到设备（默认等待10秒收集日志）
melody run <project-path> --auto

# 运行并等待30秒
melody run <project-path> --auto --wait=30000

# 运行并等待5秒
melody run <project-path> --auto --wait=5000

命令参考

| 命令 | 说明 | 示例 | |------|------|------| | devices | 列出设备 | melody devices | | create | 创建新项目 | melody create --template=empty | | build | 构建项目 | melody build ./my-script | | package | 打包 MPK | melody package ./my-script | | run | 构建并运行 | melody run ./my-script --auto | | run --wait | 运行并等待日志 | melody run ./my-script --auto --wait=30000 | | stop | 停止运行 | melody stop --device=xxx | | addTask | 添加任务 | melody addTask ./my-script --mode=last | | uninstall | 卸载脚本 | melody uninstall ./my-script | | dump | 输出窗口信息 | melody dump --device=xxx |

项目结构

melody-cli/
├── src/                  # 源代码
│   ├── commands/        # 命令实现
│   ├── connect/         # 设备连接
│   ├── flows/           # 业务流程
│   ├── plugin-utils/   # 工具类
│   └── utils/          # 辅助工具
├── dist/                # 编译输出
├── icons/               # 证书图片
├── templates/           # 项目模板
├── docs/                # 文档
│   ├── guide/          # 开发指南
│   ├── bug/            # Bug修复记录
│   └── experience/     # 开发经验
└── package.json

文档指南

环境配置 - 开发环境搭建
开发规范 - 开发规范和流程
CLI 交接文档 - 完整的功能说明
CLI 使用说明 - 用户使用指南
RPA 开发指南 - RPA 脚本编写指南

常见问题

Q: 运行提示"小应用文件读取失败"

A: 检查项目路径是否包含特殊字符或中文，尝试将项目移到纯英文路径。

Q: 设备连接失败

A: 确保手机已开启开发者模式中的 USB 调试，并授权此电脑。

Q: 脚本运行报错

A: 使用 melody dump --device=xxx 查看手机当前页面结构，检查脚本逻辑。