YT-Proteus-bot/MineAgent

选用指南

AI 根据 README 整理 · 2026/11/5 22:07:03

使用方式

通过浏览器访问本地服务，使用画布拖拽节点、连线、配置模型，保存后生成独立 Python 项目，并可点击运行执行。

查看 README 依据

# MineAgent · Agent 编排画布 > Agent 定制自由化，Agent 流程可视化，降低普罗大众使用 Agent 的门槛。 一个本地运行的前后端分离项目：在浏览器里用画布搭出工业级 Agent 流程，选框架自动生成架构图， 拖节点、连线、写代码、配模型，点「保存」就把整张画布编译成**一个可独立运行的 Python Agent 项目**， 点「运行」直接在你的机器上真实执行并流式回传每一步。 - 前端：React 18 + TypeScript + React Flow + Vite - 后端：Python FastAPI + SQLite（零 ORM、零额外依赖） - 存储：SQLite 存画布与配置；`projects/<画布名>/` 存生成出来的 Agent 项目 - 启动：双击 `start.bat`（或 `.\start.ps1`），一个端口，一个地址 最近新增： - 🧩 **社区模板**：一键把画布提成 GitHub PR，也能在应用里加载别人分享的模板 - ⚡ **流式运行**：模型输出逐 token 回显，执行到哪个节点哪个节点高亮，每个节点的输出都留在运行日志里 - 🎯 **33 个推理模式模板**：选一个模式直接生成对应架构，不用从空白画布搭 - 🎨 画布默认改成**纸白**底色，长时间看画布不刺眼 --- ## 快速开始

| 顶部「⚠ 约束」 | 编排约束面板：内置规则 + 自定义规则，违规节点在画布上标红 | | 顶部「运行」 | 编译并真实执行当前画布，执行过程流式回显到节点和运行面板 | | 右上角「选择模式」 | 框架**左边**的下拉，列出该框架支持的推理模式（ReAct / CoT / Plan-and-Execute / 群聊…），选中后作为画布默认，新建 agent 节点会用它 | | 右上角下拉 | 选择 Agent 框架（LangChain/LangGraph、AutoGen、CrewAI…），切换后重建架构图 | | 右上角「模型」 | 配置**这个画布**用的大模型与 API Key | | 右上角「用户中心」 | 账户与配置下拉：GitHub 账户 / 模型配置 / 公共模板 | | 运行按钮右侧「☁ 上传模板」 | 把当前画布和项目文件贡献成社区模板，自动创建 GitHub PR（不含任何密钥） | | 右键空白画布 | 弹出节点面板，110 种细粒度节点任选（带搜索）；新增后**按约束自动连线** | | 鼠标划过节点面板条目 | 右侧弹出该节点的「概念 / 解释 / 用途 / 编码建议」 | | 右键任意节点 | 编辑代码逻辑 / 编辑属性参数 / 重命名标识 / 复制 / 删除 |

部署要求

需要 Python 3.9 或更高版本，以及 Node.js 和 npm 用于前端构建；启动脚本自动处理依赖。

查看 README 依据

```powershell # 方式一：双击 start.bat # 方式二：命令行 .\start.ps1 # 指定端口 / 开发模式（前端 5173 热更新 + 后端 8000） .\start.ps1 -Port 8080 .\start.ps1 -Dev ``` 脚本会自动完成：Python 虚拟环境 → 后端依赖 → 前端依赖 → 前端构建 → 启动服务 → 打开浏览器。 默认地址 `http://127.0.0.1:8000`，同一局域网内其他设备可用 `http://<你的内网IP>:8000` 访问。 首次启动如果没有任何画布，会自动创建一张 LangChain 架构图。 **没有 API Key 也想跑通？** 另开一个窗口： ```powershell .\.venv\Scripts\python.exe tools\mock_llm.py --port 8012 ``` 然后在「用户中心 → 模型配置」把 Base URL 填 `http://127.0.0.1:8012/v1`、模型填 `mock-model`、Key 随便填， 整条链路（画布 → 代码 → 运行 → 事件流）就能完整跑起来。 --- ## 界面与功能 

`Agent` + `Task` + `Crew` 的原生写法。 自包含这块做了几件具体的事： - `runtime_sdk.py` 与 `runner.py` 都复制进项目目录，只用 Python 标准库， **只要机器上有 Python 3.9+ 就能零依赖预览运行**，不需要 pip 装任何东西 - 执行器设置了 `sys.dont_write_bytecode`，跑完目录里不会冒 `__pycache__` - 每次保存都会清掉残留的 `__pycache__`，目录始终是可直接打包的状态 - `skills/`、`outputs/` 带 `.gitkeep`，进 git 或压缩后目录结构不会丢 单独运行： ```powershell cd "projects\竞品调研智能体" # ① 零依赖预览：不装任何框架，用 runner 按图跑一遍 .\run.ps1 "帮我调研一下国产 Agent 编排平台" # ② 真正跑原生代码：先装框架依赖，再走 agent.py .\run.ps1 -Install .\run.ps1 -UseFramework "帮我调研一下国产 Agent 编排平台" # 或者手动 python agent.py --input "..." ```

已知限制

部分框架（如 MetaGPT、Agno 等）仅生成架构图与代码骨架，暂不支持原生执行；节点数上限为 200。

查看 README 依据

| CrewAI | ✅ 可运行 | 节点映射为 `Agent` / `Task` / `Crew` | | MetaGPT、Agno、SmolAgents、Semantic Kernel、OpenAI Agents SDK、Dify Workflow | 🎨 架构图 | 选中后生成对应风格的架构图与代码骨架，暂不接原生执行 | ### 各框架支持的推理 / 协作模式 顶部「选择模式」下拉会按当前框架列出可选模式，33 个模式按框架的能力挑配：  | 框架 | 模式（个数） | | --- | --- | | LangChain / LangGraph | 单次调用、CoT、函数调用、ReAct、Plan-and-Execute、ReWOO、反思、目标驱动、自洽投票、Tree-of-Thoughts、主管调度、分治汇总（12） | | AutoGen | 单次调用、函数调用、双人对话、群聊、顺序接力、嵌套对话、辩论、反思、代码行动、移交、群体交接、护栏校验（12） | | CrewAI | 单次调用、顺序接力、层级分派、并行处理、共识投票、辩论、分治汇总（7） | | MetaGPT | 标准作业流程、顺序接力、辩论、Plan-and-Execute、反思（5） |

画布不是随便连的。顶部「⚠ 约束」会跑一整套规则，违规节点在画布上标红并带 ⚠ 角标：  **内置规则（18 条）**，分三类： | 类别 | 规则 | | --- | --- | | 结构 | 有且只有一个输入节点、至少一个输出、输入不能有入边、输出不能有出边、无孤立节点、所有节点都能从输入到达、都能通向输出、不能自环、多入边需能合并 | | 语义 | 分支节点两条出边都要连、循环节点必须有退出出口、有环就要有循环控制、工具节点应挂在 agent 下游、用工具的 agent 要连到 tool、技能节点必须有内容、命令执行前建议加护栏 | | 数量 | 单画布节点数不超过 200 | 级别分三档：`error` 会**拦住运行**，`warn` 只提示，`info` 纯告知。 **自定义规则**（跟着画布保存）支持四种： - **顺序约束**：某节点必须在某节点之后 / 之前 - **必须包含**：画布必须出现某类节点 - **禁止出现**：不允许出现某类节点 - **数量上限**：某类节点最多几个 每条可以选「拦截」或「提示」。内置规则是回边感知的——循环里 router 指回 agent 的那条边 不会被误判成「多入边」。 三个触发点：