FlowForge

FlowForge — 通用 AI 工作流平台,让你轻松编排和执行 AI 驱动的自动化流程。

特性

• 可视化工作流编辑器 — 拖拽式步骤编排,直观易用
• MCP 工具集成 — 支持 Model Context Protocol 工具
• Skill 定制 — 自定义 AI Skill 的 Prompt 模板
• 版本管理 — 工作流修改后提示保存/另存为/放弃修改
• 历史记录 — 按工作流分文件夹存储执行记录
• 一键执行 — 按顺序自动运行整个工作流

快速开始

1. 安装依赖

npm install

2. 配置环境变量

复制 .env.example 到 .env 并填写配置:

cp .env.example .env

编辑 .env:

WORKSPACE_ROOT=/path/to/your/data
PORT=3000

3. 启动服务

npm start

访问 http://localhost:3000

目录结构

flowforge/
├── src/
│   ├── main/
│   │   └── server.js          # 后端服务
│   └── renderer/
│       ├── index.html         # 前端页面
│       ├── app.js             # 前端逻辑
│       └── styles.css         # 样式
├── data/                      # 数据目录(自动创建)
│   ├── workflows/             # 工作流定义
│   ├── history/               # 执行历史(按工作流分文件夹)
│   ├── mcp.json               # MCP 工具配置
│   ├── skills/                # Skill 定义
│   └── models.json            # 模型配置
├── package.json
├── .env.example
└── README.md

工作流示例

{
  "example-workflow": {
    "id": "example-workflow",
    "name": "示例工作流",
    "desc": "这是一个示例工作流",
    "steps": [
      {
        "id": "step-1",
        "name": "数据采集",
        "desc": "从外部源采集数据",
        "bindings": [
          { "type": "mcp", "name": "web-search" }
        ]
      },
      {
        "id": "step-2",
        "name": "内容生成",
        "desc": "使用 AI 生成内容",
        "bindings": [
          { "type": "skill", "name": "content-writer" }
        ]
      }
    ]
  }
}

MCP 工具配置

在 data/mcp.json 中配置 MCP 工具:

{
  "servers": {
    "example-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@example/mcp-server"],
      "enabled": true
    }
  }
}

Skill 定制

在 data/skills/{skill-name}/SKILL.md 中定义 Skill:

---
name: 内容写作
description: 生成高质量的内容
---

你是一个专业的内容写作助手...

版本管理

• 修改工作流后,标题会显示 * 表示未保存
• 退出编辑器时,会提示「保存 / 放弃修改 / 取消」
• 支持「另存为」创建工作流副本
• 支持「复制」快速复制工作流

历史记录

执行记录按工作流分文件夹存储在 data/history/{workflow-id}/:

data/history/
├── example-workflow/
│   ├── 1710000000000.json
│   └── 1710000001000.json
└── another-workflow/
    └── 1710000002000.json

开发

# 开发模式(自动重启)
npm run dev

# 生产模式
npm start

许可证

MIT

贡献

欢迎提交 Issue 和 Pull Request!