astron-rpa

官方中文正文为项目官方提供的中文文档（原文转载），本站未作翻译、未改动文字，仅剔除图片与无关章节。

AstronRPA

📋 概述

AstronRPA 是一款企业级机器人流程自动化（RPA）桌面应用。通过可视化设计器支持低代码/无代码开发，用户能快速构建工作流，实现桌面软件和浏览器页面的自动化。

Astron Agent 是本项目原生支持的 Agent 平台，用户可在 Astron Agent 中直接调用 RPA 流程节点，也可在 AstronRPA 中使用 Agent 的工作流，实现自动化流程与智能体系统的高效协同，赋能更广泛的业务自动化场景。

🎯 为什么选择 AstronRPA？

• 🛠️ 全面自动化支持：全面覆盖 Windows 桌面各类软件与浏览器页面的自动化，支持包括 WPS、Office 等常用办公软件，金蝶、用友、SAP 等财务及 ERP 系统，以及 IE、Edge、Chrome 等多种浏览器，实现跨应用的端到端自动化。
• 🧩 高度组件化：内置 300 余项常用原子能力，覆盖 UI 操作、数据处理、系统交互等常见场景，支持图形化编排与自定义组件扩展，具备高度的灵活性与可维护性。
• 🏭 企业级安全协同：内置卓越中心、团队市场等企业级模块，提供终端监控，调度模式，机器人团队共享等协作功能。构建完整的企业级自动化管理生态，有效保障流程安全、权限管控与跨团队协作。
• 👨‍💻 开发体验友好：提供低代码、可视化的流程设计与调试环境，通过直观的拖拉拽方式即可快速构建自动化流程，大幅降低开发门槛，提升搭建效率，赋能业务人员参与自动化创建。
• 🤖 原生 Agent 赋能：深度集成 Astron Agent 平台，支持自动化流程与 AI 智能体的双向调用与能力融合，实现任务推理、决策判断与自动化执行的无缝衔接，拓展自动化边界。
• 🌐 多渠道触发集成：支持直接运行、计划任务、调度模式、API 调用及 MCP 服务等多种执行方式，轻松对接各类业务场景。具备灵活的接入能力，可快速响应第三方系统集成需求，轻松嵌入各类复杂业务场景。

🚀 快速开始

系统要求

• 💻 客户端操作系统：Windows 10/11（主要支持）
• 🧠 RAM >= 8 GiB

服务端: 使用 Docker

推荐使用 Docker 进行快速部署：

自托管部署需要自行准备服务器和域名，在域名当前的权威 DNS 服务商处添加网关与认证子域名的解析记录，并申请覆盖两个域名的证书。注册商显示的 NS 仅表示由谁提供 DNS 服务，不等于已经配置应用的 A/CNAME 记录；无需为了本项目额外更换 NS。部署者负责域名解析、私钥保管、开放端口和证书续期。启动前请参阅 DNS 与 HTTPS 部署说明，将下方 example.com 示例替换为自己的域名。

# 克隆项目
git clone https://github.com/iflytek/astron-rpa.git
cd astron-rpa

# 进入 docker 目录
cd docker

# 复制 .env
cp .env.example .env

# 在 .env 中配置公网 HTTPS 域名
RPA_SERVER_NAME="rpa.example.com"
CASDOOR_SERVER_NAME="auth.example.com"
RPA_HTTPS_REDIRECT_AUTHORITY="rpa.example.com"
CASDOOR_HTTPS_REDIRECT_AUTHORITY="auth.example.com:8443"
CASDOOR_EXTERNAL_ENDPOINT="https://auth.example.com:8443"

# 将覆盖上述两个域名的证书和私钥分别复制到
# docker/certs/tls.crt 和 docker/certs/tls.key

# 🚀 启动所有服务
# 初始化本部署独立的 Casdoor 凭据（详见 docker/HTTPS_DEPLOYMENT.md 1.3）
docker compose up -d mysql casdoor
# 等待 Casdoor 初始化完成
python3 scripts/sync-casdoor-credentials.py
docker compose up -d

# 📊 检查服务状态
docker compose ps

• 等服务都启动后，在浏览器访问 https://rpa.example.com/api/rpa-auth/user/login-check
• 如果显示 {"code":"900001","data":null,"message":"unauthorized"}，则表示部署正确且能正常连通。
• 在浏览器访问 https://auth.example.com:8443
• 如果显示 Casdoor 的登录页面，则表示 Casdoor 部署正确。
• 生产部署及安全加固请参考 部署文档

客户端: 源码部署/安装包部署

环境依赖

具体的依赖安装方式以及常见问题请参考 构建文档。

直接下载（推荐）

使用最新的 Release 安装包

一键构建

1. 准备 Python 环境

   # 准备一个 Python 3.13.x 安装目录（可以是本地文件夹或系统安装路径）
   # 脚本会复制该目录来创建 python_core

2. 运行构建脚本

   # 在项目根目录执行完整构建（引擎 + 前端 + 桌面应用）
   ./build.bat --python-exe "C:\Program Files\Python313\python.exe"
   
   # 或使用默认配置（如果 Python 在默认路径）
   ./build.bat
   
   # 等待操作完成
   # 当控制台显示 "Full Build Complete!" 时表示构建成功

   注意： 请确保指定的 Python 解释器为纯净安装，未安装额外第三方包，以减小打包体积。

   构建流程包含：

   1. ✅ 检测/复制 Python 环境到 build/python_core
   2. ✅ 安装 RPA 引擎依赖包
   3. ✅ 压缩 Python 核心到 resources/python_core.7z
   4. ✅ 安装前端依赖
   5. ✅ 构建前端 Web 应用
   6. ✅ 构建桌面应用

3. 📦 安装打包完成的客户端安装包

⚙️ 安装好后在安装目录下的 resources/conf.yaml 中修改服务端地址：

```yaml
remote_addr: https://rpa.example.com/
skip_engine_start: false
```

🏗️ 架构概览

本项目采用前后端分离架构，前端基于 Vue 3 + TypeScript 与 Electron 构建桌面应用；后端以 Java Spring Boot 与 Python FastAPI 构建微服务，支撑业务与 AI 能力；引擎层基于 Python，集成 20+ RPA 组件，支持图像识别与 UI 自动化；整体通过 Docker 部署，具备高可观测性与扩展性，专为复杂 RPA 场景设计。

📦 组件生态

核心组件包

• astronverse.system：系统操作、进程管理、截图
• astronverse.browser：浏览器自动化、网页操作
• astronverse.gui：图形界面自动化、鼠标键盘操作
• astronverse.excel：Excel 表格操作、数据处理
• astronverse.vision：计算机视觉、图像识别
• astronverse.ai：AI 智能服务集成
• astronverse.network：网络请求、API 调用
• astronverse.email：邮件发送和接收
• astronverse.docx：Word 文档处理
• astronverse.pdf：PDF 文档操作
• astronverse.encrypt：加密解密功能

执行框架

• astronverse.actionlib：原子操作定义和执行
• astronverse.executor：工作流执行引擎
• astronverse.picker：工作流拾取元素引擎
• astronverse.scheduler：引擎调度器
• astronverse.trigger：引擎触发器

共享库

• astronverse.baseline：RPA 框架核心
• astronverse.websocketserver：WebSocket 通信
• astronverse.websocketclient：WebSocket 通信
• astronverse.locator：元素定位技术

📚 文档链接

• 📖 使用指南
• 🚀 部署指南
• 📖 API 文档
• 🔧 组件开发指南
• 🐛 故障排除
• 📝 更新日志

🤝 参与贡献

我们欢迎任何形式的贡献！请查看 贡献指南

开发规范

• ✅ 遵循现有代码风格
• ✅ 添加必要的测试用例
• ✅ 更新相关文档
• ✅ 确保所有检查通过

贡献步骤

1. 🍴 Fork 本仓库
2. 🌿 创建您的特性分支 (git checkout -b feature/AmazingFeature)
3. 💾 提交您的更改 (git commit -m 'Add some AmazingFeature')
4. 🚀 推送到分支 (git push origin feature/AmazingFeature)
5. 📝 打开一个 Pull Request

🌟 Star 历史

如果 AstronRPA 帮你省下了时间，欢迎点一个 ⭐——这是支持项目最简单的方式，也能让更多自动化开发者发现它。

📞 获取帮助

• 📧 技术支持: cbg_rpa_ml@iflytek.com
• 💬 社区讨论: GitHub Discussions
• 🐛 问题反馈: Issues
• 👥 企业微信群:

📄 开源协议

本项目基于 开源协议 开源。