前言
在软件开发、系统设计与知识管理中，可视化图表是表达逻辑、梳理流程和传递思想的重要工具。然而，编写Mermaid这类基于文本的图表语法，对许多非技术用户而言仍存在门槛——即使它已足够简洁。
为此，我们推出Smart Mermaid：基于AI的文本到Mermaid图表生成器。
只需输入一段自然语言描述，Smart Mermaid即可智能解析语义，自动生成结构清晰、语法正确的Mermaid代码，并实时渲染为流程图、时序图、思维导图等可视化图形。无论是产品经理撰写需求流程，还是开发者记录系统架构，亦或是学生整理知识脉络，Smart Mermaid都能将“想法”一键转化为“图示”。
本项目融合大语言模型（LLM）与前端可视化技术，致力于降低图表创作成本，让每个人都能轻松实现“所想即所见”。
欢迎使用Smart Mermaid，开启高效、直观的思维表达之旅。
1.什么是Smart Mermaid？
Smart Mermaid是一个基于人工智能（AI）的工具，能够将用户输入的自然语言文本自动转换为Mermaid图表代码，并实时渲染成可视化图形（如流程图、时序图、思维导图等）。
核心功能
1.文本 → 图表 自动转换
- 你只需描述一段话，例如：
- “用户登录系统后，先验证身份，成功则进入主页，失败则提示错误。”
- Smart Mermaid 会自动生成对应的 Mermaid 流程图代码。
2.支持多种图表类型
- 流程图（Flowchart）
- 时序图（Sequence Diagram）
- 思维导图（Mindmap）
- 甘特图（Gantt）等（取决于 AI 模型能力）
3.无需记忆语法
- 免去手动编写Mermaid语法的繁琐，尤其适合非技术人员（如产品经理、教师、学生）快速生成专业图表。
4.实时预览与编辑
- 通常提供左右分栏界面：左侧输入文本，右侧即时显示图表，支持进一步调整和导出。
技术原理
- 利用大语言模型（如本地或云端 LLM）理解用户意图；
- 将语义结构映射为 Mermaid 的节点与连接关系；
- 通过 Mermaid.js 或类似渲染引擎在浏览器中展示图表；
- 可部署为 Web 应用（如使用 Docker 容器化运行）。
典型应用场景
- 编写技术文档时快速插入架构图
- 教学中将概念描述转为知识图谱
- 会议记录自动生成流程草图
- 个人笔记实现“文字+可视化”双模态整理
一句话总结
Smart Mermaid = 你的想法 + AI 理解 + Mermaid 可视化 = 零代码生成专业图表~
2.前提条件
2.1ssh远程连接到极空间
- 开启【SSH 服务】
- 使用终端（Windows PowerShell / Mac Terminal）登录：
ssh root@IP
没有ssh的小伙伴可以参考这篇文章：
连接成功：极空间别再吃灰了！开启SSH，秒变全能服务器！ – cpolar 极点云官网
2.2验证docker是否开启
使用命令：
docker -v
systemctl status -v
没有docker的小伙伴可以参考这篇文章：极空间开箱实录：从拆箱到远程访问保姆级教程，30分钟上手！ – cpolar 极点云官网
3.安装Smart Mermaid
从GitHub上下载smart-mermaid项目的源代码到本地：
# 克隆项目
git clone https://github.com/liujuntao123/smart-mermaid.git
执行后会在当前目录下创建一个名为smart-mermaid的文件夹，进入该文件夹：
cd smart-mermaid
使用docker-compose启动项目中定义的所有容器，并以后台模式运行：
docker-compose up -d
当服务成功启动后，你可以打开浏览器，输入这个URL来使用Smart Mermaid。
倘若3000端口和你端口冲突，你可以编辑docker文件来修改端口：
部署完成后，在浏览器中输入 http://极空间IP:3080 就能看到Smart Mermaid的界面：
4.为Smart Mermaid配置API
点击设置：
添加自己api相关信息：
本来是有5次体验机会，上传自己API后，变成无限量
5.使用Smart Mermaid
输入目标关键字，生成流程图：
这是一个简单的项目开发流程，包括需求分析、设计、编码、测试和部署五个阶段。需求分析阶段需要明确用户需求；设计阶段完成系统架构设计；编码阶段实现功能逻辑；测试阶段验证功能正确性；最后进行部署上线。
生成过程快速，后期不满意还可以自己修改：
可以用自己本地文件上传生成：
查看历史分析：
将Smart Mermaid与cpolar结合，可以轻松实现本地部署的Smart Mermaid服务安全、稳定地暴露到公网，无需公网IP或复杂网络配置。只需在启动Smart Mermaid后运行cpolar内网穿透命令（如cpolar http 3000），即可生成一个临时或固定的公网访问地址，让团队成员或外部用户随时随地通过浏览器访问你的文本转图表服务，极大提升了协作效率与使用灵活性。
6.安装cpolar实现随时随地开发
6.1 什么是cpolar？
cpolar是一款安全高效的内网穿透工具，无需公网IP或复杂配置，只需一条命令，即可将本地服务器、Web服务或任意端口映射到公网，让你随时随地远程访问内网应用，特别适合开发调试、远程运维和应急部署等场景。
6.2 部署cpolar
cpolar 可以将你本地电脑中的服务（如 SSH、Web、数据库）映射到公网。即使你在家里或外出时，也可以通过公网地址连接回本地运行的开发环境。
❤️以下是安装cpolar步骤：
使用一键脚本安装命令：
sudo curl https://get.cpolar.sh | sh
安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）
sudo systemctl status cpolar
Cpolar安装和成功启动服务后，在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面，使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：
打开浏览器访问本地9200端口，使用cpolar账户密码登录即可,登录后即可对隧道进行管理。
7.配置公网地址
登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道：
- 隧道名称：可自定义，本例使用了:mermaid，注意不要与已有的隧道名称重复
- 协议：http
- 本地地址：3080
- 域名类型：随机域名
- 地区：选择China Top
创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址，接下来就可以在其他电脑或者移动端设备（异地)上，使用地址访问。
访问成功。
8.保留固定公网地址
使用cpolar为其配置二级子域名（cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站），该地址为固定地址，不会随机变化。
点击左侧的预留，选择保留二级子域名，地区选择china Top，然后设置一个二级子域名名称，我使用的是，大家可以自定义。填写备注信息，点击保留。
登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道，点击右侧的编辑。
修改隧道信息，将保留成功的二级子域名配置到隧道中
- 域名类型：选择二级子域名
- Sub Domain：填写保留成功的二级子域名
- 地区: China Top
点击更新
更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。
最后，我们使用固定的公网地址在任意设备的浏览器中访问，可以看到成功访问的页面，这样一个永久不会变化的二级子域名公网网址即设置好了。
总结
Smart Mermaid：基于AI的文本到Mermaid图表生成器，致力于打破技术门槛，让图表创作变得人人可及。通过自然语言描述，用户无需掌握复杂的Mermaid语法，即可由AI自动解析语义并生成结构准确的流程图、时序图、思维导图等可视化内容。项目采用前后端分离架构，支持Docker一键部署，并可通过cpolar等工具轻松实现公网访问。无论是开发者梳理系统逻辑、产品经理绘制业务流程，还是学生整理知识体系，Smart Mermaid都能将“想法”高效转化为“图示”，真正实现 所思即所见，所见即所得。未来，随着AI能力的持续增强，Smart Mermaid将进一步提升图表理解的准确性与表现力，成为智能可视化领域的实用利器。
感谢您对本篇文章的喜爱，有任何问题欢迎留言交流。cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站
