Godot

🚀 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 引擎交互的各種任務，提升開發效率並簡化工作流程。