# ultra-editor

**Repository Path**: clawrobot/ultra-editor

## Basic Information

- **Project Name**: ultra-editor
- **Description**: UltraEditor - 奥特曼团队打造的通用编辑器框架
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-02
- **Last Updated**: 2026-03-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# UltraEditor

✨ **奥特曼团队打造的通用可视化编辑器框架**

[![Version](https://img.shields.io/badge/version-2.3-blue.svg)](https://gitee.com/clawrobot/ultra-editor)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)

---

## 🎯 项目简介

UltraEditor 是一个融合了 Node-RED、draw.io、FUXA、ComfyUI 优点的**可视化节点编辑器**，支持：

- 🎨 **节点拖拽编辑** - 可视化编排工作流
- 📊 **大屏图表展示** - 实时数据可视化
- 🎮 **3D 场景搭建** - Three.js 集成
- ⚡ **工作流引擎** - 后端执行支持
- 💾 **云端同步** - SQLite 持久化存储

---

## 🦸 开发团队

| 成员 | 职责 |
|------|------|
| **迪迦** | 架构统筹 + 前端开发 |
| **盖亚** | 后端服务 + 数据库 |
| **戴拿** | 前端 UI + 图表组件 |
| **赛文** | 代码审查 + 安全 |
| **高斯** | 性能优化 + 重构 |

---

## 🚀 快速开始

### 前置要求

- Node.js >= 18
- npm >= 9
- 浏览器 (Chrome/Edge/Firefox)

### 安装

```bash
# 克隆仓库
git clone https://gitee.com/clawrobot/ultra-editor.git
cd ultra-editor

# 安装后端依赖
cd packages/server
npm install

# 启动后端服务
npm start
# 或：node index.js
```

### 启动前端

```bash
# 方式一：Python 简单服务器
cd demo
python3 -m http.server 8080

# 方式二：Node.js 服务器
npx serve ../demo
```

### 访问

- **前端:** http://localhost:8080/index-v2.3.html
- **后端 API:** http://localhost:3002
- **健康检查:** http://localhost:3002/health

---

## 📁 项目结构

```
ultra-editor/
├── demo/                      # 前端演示
│   ├── index-v2.3.html       # 前后端完整版
│   ├── index-v2.2.html       # 右键菜单版
│   └── ...
├── packages/
│   ├── core/                 # 核心引擎
│   │   ├── src/
│   │   │   ├── UltraEditor.ts
│   │   │   ├── graph/
│   │   │   ├── node/
│   │   │   └── utils/
│   │   └── optimization/
│   ├── server/               # 后端服务
│   │   ├── index.js
│   │   ├── src/
│   │   │   ├── routes/
│   │   │   └── models/
│   │   └── database/
│   ├── plugins/              # 插件系统
│   │   ├── dashboard/
│   │   ├── workflow/
│   │   └── scene3d/
│   └── tools/                # 开发工具
│       ├── benchmark/
│       └── harmony/
├── tasks/                    # 任务卡片
├── docs/                     # 文档
└── README.md                 # 本文件
```

---

## 🔧 功能特性

### 前端 (v2.3)

- ✅ 节点拖拽编辑
- ✅ 贝塞尔曲线连接
- ✅ 智能对齐辅助线
- ✅ 右键菜单
- ✅ 属性面板 (可折叠)
- ✅ 快捷键系统
- ✅ 搜索过滤
- ✅ 分组功能
- ✅ 项目管理 (云端保存)
- ✅ WebSocket 实时通信

### 后端 (v1.0)

- ✅ REST API (项目 CRUD)
- ✅ SQLite 数据库
- ✅ WebSocket 服务
- ✅ 工作流执行接口
- ✅ 健康检查端点

---

## 📡 API 接口

### 项目管理

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/projects` | 获取项目列表 |
| POST | `/api/projects` | 创建项目 |
| GET | `/api/projects/:id` | 获取项目详情 |
| PUT | `/api/projects/:id` | 更新项目 |
| DELETE | `/api/projects/:id` | 删除项目 |

### 工作流

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/api/workflows/:id/run` | 运行工作流 |
| GET | `/api/workflows/:id/status` | 获取运行状态 |

### 系统

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/health` | 健康检查 |
| WS | `/ws` | WebSocket 连接 |

---

## 🎯 快捷键

| 快捷键 | 功能 |
|--------|------|
| `Del` | 删除选中节点 |
| `Ctrl+Z` | 撤销 |
| `Ctrl+Y` | 重做 |
| `Ctrl+D` | 复制节点 |
| `Ctrl+S` | 保存项目 |
| `/` | 搜索聚焦 |
| `G` | 切换网格 |

---

## 🛠️ 开发

### 添加新节点类型

1. 在 `demo/index-v2.3.html` 的节点库中添加
2. 定义节点的颜色和图标
3. 实现节点的渲染逻辑

### 添加新 API

1. 在 `packages/server/src/routes/` 创建路由文件
2. 在 `index.js` 中注册路由
3. 测试 API 功能

---

## 📝 更新日志

### v2.3 (2026-03-02)
- ✨ 前后端完整版
- ✨ 项目管理功能
- ✨ WebSocket 实时通信
- 🔧 后端 API 集成

### v2.2 (2026-03-02)
- ✨ 右键菜单完全体
- ✨ 属性面板增强
- ✨ 颜色选择器
- ✨ 配置复制粘贴

### v2.1 (2026-03-02)
- ✨ 完整快捷键系统
- ✨ 搜索功能增强
- ✨ 分组功能

### v2.0 (2026-03-02)
- ✨ 贝塞尔曲线连接
- ✨ 对齐辅助线
- ✨ 网格吸附

### v1.0 (2026-03-01)
- ✨ 初始版本
- ✨ 基础编辑器功能

---

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

---

## 📄 开源协议

MIT License - 详见 [LICENSE](LICENSE) 文件

---

## 🔗 链接

- **Gitee 仓库:** https://gitee.com/clawrobot/ultra-editor
- **问题反馈:** https://gitee.com/clawrobot/ultra-editor/issues
- **文档:** /docs/

---

**✨ UltraEditor - 让可视化编辑更简单！**