Mermaid 图表生成服务器

这是一个使用 Flask 构建的简单服务器，它通过 mermaid-cli 从 Mermaid 语法生成图表。

预备条件

• Python 3.7+
• Node.js 和 npm（用于 mermaid-cli）
• 全局安装 mermaid-cli：npm install -g @mermaid-js/mermaid-cli

安装

1. 克隆此仓库
2. 安装 Python 依赖项：

   pip install -r requirements.txt
   

3. 确保全局安装了 mermaid-cli：

   npm install -g @mermaid-js/mermaid-cli
   

运行服务器

启动服务器：

python server.py

默认情况下，服务器运行在 http://localhost:5000。

临时文件

服务器会在项目文件夹中创建一个名为 temp_files 的本地目录来存储临时文件。这种方法：

• 避免了系统临时目录的权限问题
• 在虚拟环境中表现更好
• 自动清理超过30分钟的文件

API 使用

Web 接口

打开浏览器并导航到 http://localhost:5000 使用 Web 接口。

API 端点

发送一个 POST 请求到 /generate，请求体包含你的 Mermaid 图表的 JSON 数据：

{
  "mermaid": "graph TD\nA[Client] --> B[Load Balancer]\nB --> C[Server1]\nB --> D[Server2]",
  "theme": "default",  // 可选：default, dark, forest, neutral
  "background": "white" // 可选：white, transparent
}

服务器将返回渲染后的图表的 PNG 图像。

使用 curl 的示例：

curl -X POST http://localhost:5000/generate \
  -H "Content-Type: application/json" \
  -d '{"mermaid":"graph TD\nA[Client] --> B[Load Balancer]"}' \
  --output diagram.png

测试

运行包含的测试脚本来验证一切是否正常工作：

python test.py

这将生成一个样本图表，并将其保存为 output_diagram.png。

故障排除

如果你遇到错误：

1. 确保 mermaid-cli (mmdc) 已安装并且可以在 PATH 中访问
2. 检查服务器日志以获取具体的错误信息
3. 确保你的 Mermaid 语法有效
4. 验证 temp_files 目录存在且具有适当的权限