Skip to content

README.md

Latest commit

 

History

History
370 lines (257 loc) · 16.9 KB

README.md

File metadata and controls

370 lines (257 loc) · 16.9 KB
Raw

APIWorkflowCanvasDesignNet — 图形化 API 流程编排平台（AI 驱动）

「积木」+「魔法」——像积木一样灵活，像魔法一样强大，让 AI 替你写接口、跑流程、做报表。

License: MIT .NET 8 Vue 3 Element Plus GitHub last commit GitHub commit activity GitHub stars Docker Build Stack

👉 中文 | English

📖 简介

APIWorkflowCanvasDesignNetJuggle 原名 Juggle（积木 + 魔法）是一个可视化 API 流程编排平台，通过拖拽式画布将多个接口串联成完整业务流程，支持 AI 对话自动生成流程、智能体多轮对话与工具调用、生图/生视频、报表设计等。

后端基于 .NET 8 + EF Core 8，前端 Vue 3 + Element Plus + @vue-flow/core，内置 SQLite（可切换 MySQL / PostgreSQL / SQLServer）。系统已稳定运行，提供 Docker 一键部署方案，默认账号 juggle / juggle，监听 9127 端口。

✨ 功能特性

能力 说明
🎨图形化流程编排 14 种节点：START / END / METHOD / CONDITION / MERGE / ASSIGN / CODE / MYSQL / SUB_FLOW / LOOP / DELAY / PARALLEL / NOTIFY / AI
🤖AI 智能编排 对话描述需求 → 大模型自动生成完整流程（含入参/出参定义 + 节点连线 + 条件分支），预览确认后入库
🧠AI 智能体对话 多轮对话、工具调用（接口直调/流程递归），最多 4 轮；支持生图/生视频模型（通义万相 / OpenAI）
🎛️模型助手 自定义助手（名称/提示词/输入输出参数），绑定技能/接口/流程/工具能力；支持温度/最大输出/随机种子/深度思考
🏪内置应用市场 发现 / 导入 / 收藏 / 下载 / 发布，支持 GitHub PR 分享条目
📊报表设计器 数据视图 + 报表设计（行列编辑 / 公式引擎 SUM / IF / 分页预览）
📈监控模块 API 拓扑图（健康检查 / 访问统计 / DB 调用连线）+ 告警规则 + 告警记录
🔐多租户 + JWT 认证 严格/宽松双隔离策略，RBAC 角色权限
🗄️多数据库 系统库：SQLite / MySQL / PostgreSQL / SQLServer；业务数据源再加 Oracle / 达梦

🏗️ 架构总览

flowchart LR
    subgraph FE["前端 JuggleNet6.Frontend"]
        Vue["Vue 3 + Vite"]
        EP["Element Plus"]
        VF["@vue-flow/core 画布"]
        Monaco["Monaco Editor"]
    end

    subgraph API["后端 Juggle.Api"]
        Controllers["Controllers\n/api/ · /open/"]
        Middleware["JWT中间件\n租户上下文"]
    end

    subgraph App["Juggle.Application"]
        FlowSvc["FlowExecutionService\n编排器"]
        AiSvc["AiService\nAI 调用"]
        JwtSvc["JwtService"]
    end

    subgraph Domain["Juggle.Domain"]
        Engine["FlowEngine\n流程执行引擎"]
        Nodes["13+1 节点执行器\nSTART/END/METHOD/CONDITION等"]
        Entities["实体 / DTO"]
    end

    subgraph Infra["Juggle.Infrastructure"]
        DbContext["JuggleDbContext\nEF Core"]
        JsonHelper["JsonHelper / Md5Helper"]
    end

    subgraph DB["数据库"]
        SQLite["SQLite（默认）"]
        MySQL["MySQL"]
        PG["PostgreSQL"]
        SS["SQLServer"]
    end

    subgraph AI["外部 AI 服务"]
        OpenAI["OpenAI / DeepSeek"]
        Qwen["通义千问 / 万相"]
        Kimi["Kimi / GLM / Ollama"]
    end

    Vue --> Controllers
    Controllers --> Middleware
    Controllers --> FlowSvc
    Controllers --> AiSvc
    FlowSvc --> Engine
    Engine --> Nodes
    FlowSvc --> DbContext
    AiSvc --> OpenAI & Qwen & Kimi
    DbContext --> SQLite & MySQL & PG & SS
Loading

🚀 快速开始

Docker 一键启动

docker run -d \
  --name juggle \
  -p 9127:9127 \
  -v juggle_data:/data \
  pythonhuang/juggle-net8:v1.0

或使用 docker-compose：

docker-compose up -d

访问 http://localhost:9127，默认账号 juggle / juggle

本地开发

# 后端
cd Juggle.Api && dotnet run

# 前端
cd JuggleNet6.Frontend && npm install && npm run dev

# 生产构建
cd JuggleNet6.Frontend && npm run build  # → Juggle.Api/wwwroot/

构建状态：dotnet build 0 errors · vue-tsc 通过

📸 界面预览

流程编排 AI 智能编排
流程编排 [多条件分支，中午、并行流程
流程编排 [对话描述需求，AI 自动生成流程节点与连线]
监控仪表盘 报表设计器
API 拓扑图 + 告警规则 数据视图 + 公式引擎

📌 更多截图见仓库 images/ 目录。

🛠️ 技术栈

层级 技术
后端 ASP.NET Core 8 · EF Core 8 · Juggle.Api / Application / Domain / Infrastructure 四层
前端 Vue 3 · Vite · Element Plus · Pinia · @vue-flow/core · Monaco Editor
数据库 SQLite（默认）/ MySQL / PostgreSQL / SQLServer · 业务源支持 Oracle / 达梦
容器 Docker multi-stage build · GitHub Actions CI/CD
认证 JWT Bearer · RBAC 角色权限 · 多租户HasQueryFilter

🔍 竞品对比

项目 Juggle（本项目） n8n Dify FastGPT / Coze
核心定位 API 流程编排 + AI 辅助生成 工作流自动化 LLM 应用开发 RAG / Bot
自研接口 套件/接口管理 + 批量导入 + cURL 复制 无 无 无
SQL/DB节点 ✅ 内置 MySQL/SQLite/PG/SS ⚠️ 需要节点 ❌ ❌
SOAP/WSDL ✅ 自动生成 + 调用 ❌ ❌ ❌
多租户 ✅ JWT Claims 驱动 ❌ ❌ ❌
私有化部署 ✅ Docker 一键 ✅ ✅ ❌
AI 生成流程 ✅ 对话→完整编排+预览 ⚠️ 仅部分 ⚠️ 仅提示词 ⚠️ 仅提示词
生图/生视频 ✅ 对话模型自动切换 ❌ ❌ ✅（平台内）
应用市场 ✅ 内置 + GitHub PR 分享 ❌ ❌ ❌

一句话差异：Juggle 是面向后端开发者的 API 编排 + AI 自动生成工具，补齐了 n8n/Dify 在接口管理、SOAP、SQL、多租户、私有化部署方面的空白。

📋 最近更新（v1.8）

  • 🎨 生图/生视频：模型名关键词自动识别类型（chat/image/video），通义万相走 DashScope 异步轮询，OpenAI 兼容走 images/generations，气泡内渲染图片/视频带下载按钮
  • 🤖 助手模型参数：温度 / 最大输出 / 随机种子 / 深度思考开关（透传到 API）
  • 🎯 折叠侧边栏：220px → 64px，子菜单悬停弹出，状态持久化到 localStorage
  • 📊 监控模块：API 拓扑图 + 告警规则 + 告警记录
  • 🛒 应用市场：接口/流程/助手/Skills/报表五类条目，GitHub PR 分享机制
  • 🧠 知识库 + Skill：KB_SEARCH 节点支持 RAG 问答；Skill 管理支持 JSON/markdown 导入

🤝 参与贡献

欢迎提交 Issue 和 Pull Request！

  1. Fork 本仓库
  2. 创建特性分支 git checkout -b feature/xxx
  3. 提交变更 git commit -m "feat: xxx"
  4. 推送到分支 git push origin feature/xxx
  5. 开 Pull Request

📄 许可证

MIT License

🙏 致谢

本项目基于 Juggle（Java 版）的设计思路与架构进行 .NET 8 重写。

感谢 @somta 及原项目团队！

如果觉得这个项目对你有帮助，欢迎 ⭐ Star 支持！你的 star 是我持续维护的最大动力 💪


Juggle — Visual API Flow Orchestration Platform (AI-Powered)

中文 | English

📖 Overview

Juggle means "building blocks" and "magic" in Chinese — flexible like LEGO, powerful like magic. It's a visual API flow orchestration platform that lets you string multiple APIs together via drag-and-drop canvas, with AI-assisted flow generation, agent multi-turn chat, image/video generation, and report design built in.

Built with .NET 8 + Vue 3 + Element Plus, ships with SQLite out of the box (MySQL / PostgreSQL / SQLServer supported). One-click Docker deployment, default credentials juggle / juggle, listening on port 9127.

✨ Features

Feature Description
🎨Visual Flow Orchestration 14 node types: START / END / METHOD / CONDITION / MERGE / ASSIGN / CODE / MYSQL / SUB_FLOW / LOOP / DELAY / PARALLEL / NOTIFY / AI
🤖AI Flow Generation Describe requirements in chat → LLM auto-generates complete flow (inputs/outputs + node wiring + conditionals), preview and confirm to save
🧠AI Agent Chat Multi-turn dialogue with tool calling (direct API / recursive flow), up to 4 rounds; image/video generation model support (Tongyi Wanxiang / OpenAI)
🎛️Model Assistants Custom assistants with system prompt / I/O params; bind skills/APIs/flows/tools; model params: temperature, max tokens, seed, thinking mode
🏪Built-in Marketplace Discover / import / favorite / download / publish; share to official GitHub via PR
📊Report Designer Data views + report builder (row/col editing / formula engine SUM & IF / paginated preview)
📈Monitoring API topology map (health check / visit stats / DB call edges) + alert rules + alert records
🔐Multi-tenant + JWT Strict/loose isolation viaHasQueryFilter, RBAC role permissions
🗄️Multi-DB System: SQLite / MySQL / PostgreSQL / SQLServer; business sources also support Oracle / Dameng

🚀 Quick Start

Docker One-Click

docker run -d \
  --name juggle \
  -p 9127:9127 \
  -v juggle_data:/data \
  pythonhuang/juggle-net8:v1.0

Local Development

# Backend
cd Juggle.Api && dotnet run

# Frontend
cd JuggleNet6.Frontend && npm install && npm run dev

Build status: dotnet build 0 errors · vue-tsc passes

🛠️ Tech Stack

Layer Tech
Backend ASP.NET Core 8 · EF Core 8 · 4-layer DDD
Frontend Vue 3 · Vite · Element Plus · Pinia · @vue-flow/core · Monaco Editor
Database SQLite (default) / MySQL / PostgreSQL / SQLServer · Oracle / Dameng for business
Container Docker multi-stage · GitHub Actions CI/CD
Auth JWT Bearer · RBAC · Multi-tenantHasQueryFilter

🔍 vs Competitors

Juggle n8n Dify FastGPT / Coze
Focus API orchestration + AI generation Workflow automation LLM app dev RAG / Bot
Self-hosted APIs ✅ Suite/API mgmt + bulk import ❌ ❌ ❌
SQL/DB nodes ✅ ⚠️ ❌ ❌
SOAP/WSDL ✅ Auto-gen ❌ ❌ ❌
Multi-tenant ✅ JWT Claims ❌ ❌ ❌
AI generate flows ✅ Full flow + preview ⚠️ Partial ⚠️ Prompt only ⚠️ Prompt only
Image/Video gen ✅ Auto-switch by model ❌ ❌ ✅ In-platform
Marketplace ✅ + GitHub PR sharing ❌ ❌ ❌

One-liner: Juggle fills the gap for backend devs who need API management, SOAP, SQL, multi-tenancy, and private deployment — things n8n/Dify don't cover.

📋 Recent Updates (v1.8)

  • 🎨 Image/Video generation: Model name keywords auto-detect type (chat/image/video), DashScope async polling for Tongyi Wanxiang, OpenAI images/generations for URL/b64_json
  • 🤖 Assistant model params: Temperature / max tokens / seed / thinking switch forwarded to API
  • 🎯 Collapsible sidebar: 220px → 64px, hover popup, localStorage persisted
  • 📊 Monitoring module: API topology + alert rules + alert records
  • 🛒 Marketplace: 5 entry types, GitHub PR sharing workflow
  • 🧠 Knowledge base + Skills: KB_SEARCH node for RAG; Skill CRUD with JSON/markdown import

🤝 Contributing

Issues and PRs welcome!

  1. Fork the repo
  2. git checkout -b feature/xxx
  3. git commit -m "feat: xxx"
  4. git push origin feature/xxx
  5. Open a Pull Request

📄 License

MIT License

🙏 Acknowledgments

This project is a .NET 8 reimplementation of the original Juggle Java project.

Thanks to @somta and the original team!

If you find this project helpful, please give it a ⭐ Star! Your support keeps this project going 💪