Install
openclaw skills install @andapeng/flowchart-gen将自然语言描述转换为流程图图片(Mermaid语法),支持DeepSeek API智能生成、多种图表类型、丰富的模板库和智能错误处理
openclaw skills install @andapeng/flowchart-gen将自然语言描述或Mermaid代码转换为高质量的流程图图片,支持DeepSeek API智能生成、多种图表类型和丰富的模板库。
# Windows (PowerShell)
.\install.ps1
# Linux/macOS
chmod +x install.sh
./install.sh
# 1. 安装Mermaid CLI(必需)
npm install -g @mermaid-js/mermaid-cli
# 2. 安装Python依赖(推荐)
pip install pillow requests
# 3. 验证安装
mmdc --version
python -c "import requests; print('依赖检查通过')"
如果安装Mermaid CLI时卡在Chromium下载(常见于Windows),请使用以下命令跳过Chromium下载,使用系统Chrome:
# Windows (CMD/PowerShell)
set PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=1
set PUPPETEER_EXECUTABLE_PATH="C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
npm install -g @mermaid-js/mermaid-cli
# 或者使用PowerShell
$env:PUPPETEER_SKIP_CHROMIUM_DOWNLOAD="1"
$env:PUPPETEER_EXECUTABLE_PATH="C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
npm install -g @mermaid-js/mermaid-cli
# Linux/macOS
export PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=1
npm install -g @mermaid-js/mermaid-cli
注意:如果Chrome安装在其他路径,请相应修改 PUPPETEER_EXECUTABLE_PATH。
# 使用DeepSeek API生成流程图(自动从OpenClaw配置读取API密钥)
python scripts/generate.py "用户登录认证流程" -o login.png
# 强制使用模板匹配(无API调用)
python scripts/generate.py "订单处理流程" --no-llm -o order.png
# 生成甘特图(项目时间计划)
python scripts/generate.py "项目开发时间计划" -o project_gantt.png
# 生成类图(系统设计)
python scripts/generate.py "电商系统类图设计" -o class_diagram.png
# 使用SVG格式(矢量图,无需Chrome)
python scripts/generate.py "API调用序列" -o api.svg -f svg -t dark
# 直接输入Mermaid代码(跳过AI转换)
python scripts/generate.py --raw "graph TD; A[开始]-->B[结束]" -o simple.png
# 调试模式(保留临时文件,详细输出)
python scripts/generate.py "复杂流程" -o output.png --debug --verbose
# 查看所有可用模板(31个)
python scripts/generate.py --list-templates
# 使用特定模板
python scripts/generate.py --use-template login -o login_template.png
python scripts/generate.py --use-template gantt-project -o gantt.png
# 环境依赖检查
python scripts/generate.py "测试" --verbose
本技能支持多种LLM API配置方式,按优先级自动选择(从高到低):
命令行参数(优先级最高)
python scripts/generate.py "描述" --api-key sk-xxx --api-provider deepseek
--api-key: 手动指定API密钥--api-provider: 提供商(deepseek 或 openai,默认 deepseek)--api-base-url: 自定义API基础URL环境变量(推荐用于持久化配置)
# Windows
set DEEPSEEK_API_KEY=sk-xxx
# 或
set OPENAI_API_KEY=sk-xxx
# Linux/macOS
export DEEPSEEK_API_KEY=sk-xxx
export OPENAI_API_KEY=sk-xxx
OpenClaw配置文件(自动读取,适合OpenClaw用户)
~/.openclaw/openclaw.json 读取 DeepSeek 配置模板匹配(无API调用)
--no-llm 参数禁用LLM,使用模板匹配--use-template 指定预置模板--raw 直接输入Mermaid代码--api-key, --api-provider, --api-base-url)DEEPSEEK_API_KEY, OPENAI_API_KEY)~/.openclaw/openclaw.json)首次运行或缺少配置时,脚本会提供详细的配置指引,帮助用户快速设置。
| 图表类型 | 语法 | 用途 |
|---|---|---|
| 流程图 | graph TD / graph LR | 业务流程、工作流程 |
| 序列图 | sequenceDiagram | 系统交互、API调用 |
| 甘特图 | gantt | 项目时间规划、进度跟踪 |
| 类图 | classDiagram | 面向对象设计、系统架构 |
| 状态图 | stateDiagram-v2 | 状态机表示、状态转换 |
| 饼图 | pie | 数据比例、统计图表 |
| 用户旅程图 | journey | 用户体验、服务蓝图 |
| 时间线图 | timeline | 历史事件、发展历程 |
--debug 选项保留临时文件usage: generate.py [-h] [-o OUTPUT] [-f {png,svg,pdf}] [-t THEME] [--raw]
[--verbose] [--no-llm] [--debug] [--list-templates]
[--use-template USE_TEMPLATE]
prompt
生成流程图 - 将自然语言描述或Mermaid代码转换为流程图图片
positional arguments:
prompt 流程图描述(自然语言)或Mermaid代码(使用--raw时)
options:
-h, --help 显示帮助信息
-o OUTPUT, --output OUTPUT
输出文件路径 (默认: flowchart.png)
-f {png,svg,pdf}, --format {png,svg,pdf}
输出格式 (默认: png)
-t THEME, --theme THEME
主题: default, dark, forest, neutral (默认: default)
--raw 直接使用输入作为Mermaid代码(跳过AI转换)
--verbose 显示详细输出
--no-llm 禁用LLM API,强制使用模板匹配
--debug 调试模式:保存临时文件,显示更详细的信息
--list-templates 列出可用模板
--use-template USE_TEMPLATE
使用预置模板(输入模板名称)
示例:
generate.py "用户登录认证流程" -o login.png
generate.py "API调用序列" -o api.svg -f svg -t dark
generate.py --raw "graph TD; A[开始]-->B[结束]" -o simple.png
generate.py "购物流程" --verbose --debug
脚本会自动从以下位置读取DeepSeek API配置:
~/.openclaw/openclaw.jsonDEEPSEEK_API_KEYOpenClaw配置示例:
{
"models": {
"providers": {
"custom-api-deepseek-com": {
"apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"baseUrl": "https://api.deepseek.com/v1",
"models": [
{"id": "deepseek-chat"},
{"id": "deepseek-reasoner"}
]
}
}
}
}
"未找到Mermaid CLI (mmdc)"
# 重新安装Mermaid CLI
npm uninstall -g @mermaid-js/mermaid-cli
npm install -g @mermaid-js/mermaid-cli
# Windows用户使用
mmdc.cmd --version
Puppeteer/Chrome相关错误
# 安装Chrome浏览器
# 或使用SVG格式(不需要Chrome)
python scripts/generate.py "描述" -o output.svg -f svg
API调用失败
# 使用模板匹配(无API调用)
python scripts/generate.py "描述" --no-llm -o output.png
# 检查OpenClaw配置
python scripts/generate.py "测试" --verbose
语法错误
# 在线检查语法
# 访问 https://mermaid.live
# 简化测试
python scripts/generate.py --raw "graph TD; A[开始]-->B[结束]" -o test.png
# 完整调试命令
python scripts/generate.py "你的描述" -o output.png --debug --verbose
# 环境检查
python scripts/generate.py --list-templates
mmdc --version
node --version
FAQ.md 获取详细解答flowchart-gen/
├── SKILL.md # 技能说明文档(本文件)
├── TODO.md # 改进计划(已完成所有任务)
├── FAQ.md # 常见问题解答
├── 进度报告-2026-03-17.md # 开发进度报告
├── scripts/
│ └── generate.py # 主生成脚本(2400+行代码)
├── templates/ # 模板目录(如果需要文件模板)
└── references/ # 参考文档
编辑 scripts/generate.py 文件:
TEMPLATES 字典中添加新模板template_keywords 中添加关键词映射call_deepseek_api() 函数支持其他API欢迎提交:
flowchart-gen/FAQ.md--debug --verbose 参数请提供以下信息:
MIT License
状态: ✅ 生产就绪 主要特性:
新增文档:
修复问题:
状态: 🔄 已升级 特性:
当前版本: 1.0.0
发布日期: 2026-03-17
最后更新: 2026-03-17
状态: ✅ 生产就绪
版本验证:
# 查看版本信息
python scripts/generate.py --version
# 查看版本文件
cat VERSION
# 查看变更日志
cat CHANGELOG.md | head -50