项目介绍
Smart Excalidraw Next 把文字描述转换成 Excalidraw 画布上的节点、文本和连接线。它适合先生成流程图、系统架构图或思维导图草稿,再手动修正排版;生成结果中的每个对象都可以继续编辑。
模型负责理解描述和组织图形,Excalidraw 负责编辑与展示。能打开页面,只说明前端运行正常;真正生成图表还需要可用的模型连接。项目支持填写自己的模型配置,也支持管理员配置模型后向使用者提供访问密码。
核心功能
| 功能 | 说明 |
|---|---|
| 自然语言生成 | 输入节点、关系和判断条件,生成流程、架构或思维导图草稿。 |
| 可编辑画布 | 生成对象保留为 Excalidraw 元素,可以继续拖动、改字和调整样式。 |
| 连接线布局 | 自动连接图形,复杂分支可在画布中继续修正。 |
| 模型配置 | 填写自己的模型连接,或使用管理员配置的访问密码。 |
功能示意

图 1:自制功能示意图,概括本文的使用要点。

项目信息
| 项目 | 说明 |
|---|---|
| 类型 | 项目指南 |
| 分类 | 知识与效率 |
| 项目仓库 | liujuntao123/smart-excalidraw-next |
| 整理日期 | 2026-11-14 |
安装与运行
在开发电脑或 Linux/WSL 准备 Node.js 与 pnpm。当前官方提供源码运行方式,下面不使用猜测的 Docker 镜像。
1. 安装和初始化
git clone https://github.com/liujuntao123/smart-excalidraw-next.git
cd smart-excalidraw-next
pnpm install
if [ ! -e .env.local ]; then cp .env.example .env.local; fi
pnpm dev
2. 第一次使用
按 .env.example 的变量说明填写自己的模型服务参数,再启动开发服务器;改动环境文件后重新启动。打开终端显示的地址,先生成一个只有三个节点的流程图,检查文字、连线和可编辑性,再导出 Excalidraw 原文件。
pnpm dev 用于本地试用。长期运行前需执行项目的生产构建与启动流程,并处理 HTTPS、访问控制与进程守护;模型密钥只能保存在服务端配置中。
常见问题
- 命令不存在:确认依赖已安装,关闭并重新打开终端,再检查实际使用的环境。Python 虚拟环境与系统 Python、Windows 与 WSL 的工具路径各自独立。
- 下载依赖失败:先查看具体失败的仓库和包名,检查该终端的网络;浏览器能访问不代表命令行已使用同一代理。
- 配置后仍报错:从当前项目目录启动,检查配置文件名、变量名和日志。真实账号与 API Key 放在本机私有配置中,不复制到公开教程或截图。
更新与备份
更新前保存项目配置、输入资料和输出结果。源码项目记录当前提交与依赖锁文件,比较新版本说明后再更新;安装包项目保留可回退的版本号。服务账号的授权与模型账单在对应平台管理,删除本地目录不会自动撤销授权。