🚀 Godot 机器人流程自动化 (RPA) 服务器

Godot RPA 服务器借助命令行接口（CLI）与 Godot 引擎进行交互，能够实现一系列功能，如检测和启动 Godot 实例、获取项目信息、操作文件和数据库、修改配置文件等，极大提升了与 Godot 引擎交互的效率。

🚀 快速开始

Godot RPA 服务器可帮助你自动化处理与 Godot 引擎交互的各类任务。以下是使用前的安装与配置步骤：

1. 安装 Node.js 和 npm

确保已安装 LTS 版本的 Node.js 和 npm：

curl -o- https://raw.githubusercontent.com/nvm-sh/install/v0.39.5/install.sh | bash
nvm install --lts
npm install -g npm

2. 克隆仓库并构建

git clone https://github.com/yourusername/godot-rpa.git
cd godot-rpa
npm install

3. 设置环境变量

• GODOT_PATH：设置为你的 Godot 可执行文件路径（可选）
• DEBUG：设为 "true" 启用详细日志记录（可选）

使用示例

# 最简单的使用方式
npm start

# 以调试模式运行
DEBUG=true npm start

# 指定 Godot 路径
GODOT_PATH=/path/to/godot npm start

✨ 主要特性

• 零临时文件：所有操作通过内存完成，无需写入磁盘
• 内置错误处理：自动捕获并报告 Godot CLI 错误
• 可扩展架构：支持添加新的命令处理器
• 异步执行：多个操作可以并发运行
• 详细日志记录：提供调试信息以解决问题

📦 安装指南

1. 安装 Node.js 和 npm

确保已安装 LTS 版本的 Node.js 和 npm：

curl -o- https://raw.githubusercontent.com/nvm-sh/install/v0.39.5/install.sh | bash
nvm install --lts
npm install -g npm

2. 克隆仓库并构建

git clone https://github.com/yourusername/godot-rpa.git
cd godot-rpa
npm install

3. 设置环境变量

• GODOT_PATH：设置为你的 Godot 可执行文件路径（可选）
• DEBUG：设为 "true" 启用详细日志记录（可选）

💻 使用示例

基本用法

# 最简单的使用方式
npm start

# 以调试模式运行
DEBUG=true npm start

# 指定 Godot 路径
GODOT_PATH=/path/to/godot npm start

高级用法

# 以下是一些高级使用场景示例
# 例如，结合不同的环境变量和参数进行操作
GODOT_PATH=/path/to/godot DEBUG=true npm start

📚 详细文档

命令参考

基本命令

• launch

  godot-rpa launch [--project-path PATH] [--]
  

  启动 Godot 编辑器。可指定项目路径，-- 表示传递额外 CLI 参数。

• run

  godot-rpa run [-p|--project-path] PATH [-m|--monitor] 
  

  运行 Godot 项目。支持监控模式（自动重新加载）。

文件操作

• create-folder

  godot-rpa create-folder [-p|--parent] PATH NAME
  

  创建新文件夹。

• delete-folder

  godot-rpa delete-folder PATH
  

  删除文件夹。

🔧 技术细节

架构概述

服务器使用命令处理器模式，每个操作由专门的处理器处理。复杂任务通过链式调用多个处理器完成。

命令处理器

• FileOperationsProcessor：处理与文件系统相关的所有操作。
• ProjectInfoProcessor：提取和修改项目信息。
• DatabaseProcessor：执行数据库相关操作。
• ConfigurationProcessor：管理配置文件。

📚 故障排除

1. Godot 未检测到

• 确保 Godot 可执行文件存在并可执行
• 设置 GODOT_PATH 环境变量指向正确路径

2. 权限问题

• 检查文件和目录的权限设置
• 使用 chmod 命令调整权限

3. 日志不足

• 启用调试模式 (DEBUG=true)
• 查看 debug.log 文件获取更多信息

4. 性能问题

• 优化操作顺序
• 考虑增加资源限制

📄 许可证

本项目遵循 MIT 许可证。查看 LICENSE 文件获取详细信息。

通过 Godot RPA 服务器，你可以自动化处理与 Godot 引擎交互的各种任务，提升开发效率并简化工作流程。