SuperAPI AI 工具集

mermaid-render

通用与其它

查看项目

更新于 10-16 02:37

技能介绍

用途:在 iTerm2 或 Ghostty 终端中把 Mermaid 图表渲染为 PNG 并内联显示,便于快速视觉迭代。触发于创建、编辑或迭代 Mermaid 图的工作。

主要能力:把 Mermaid 代码写入 .mmd 文件后调用脚本渲染为 PNG;支持 iTerm2 的 imgcat 和 Ghostty 的 kitten icat 显示;提供主题、宽度、背景色、自定义 CSS、输出路径等参数;内置 Mermaid 语法速查,覆盖流程图、时序图、状态图、ER 图、类图等。

使用方式:先确认 mmdc 可用:which mmdc || echo "MISSING: Run 'npm install -g @mermaid-js/mermaid-cli'"。写图:cat > /tmp/mermaid-diagram.mmd << 'MERMAID' ... MERMAID。渲染:"${CLAUDE_SKILL_DIR}/scripts/render.sh" /tmp/mermaid-diagram.mmd。脚本输出 Rendered: <path> 和 View: <command>,需把 View: 命令打印给用户复制执行,因为 Bash 工具捕获 stdout,内联图不会自动显示。首次使用检查 mmdc,显示命令按 $TERM_PROGRAM 自动检测,两者都无则回退到 open。

参数示例:--theme dark、--width 2400、--output ~/Desktop/diagram.png,默认主题 default、宽度 1200、背景透明、输出替换 .mmd 为 .png。

迭代规则:每次修改后立即更新 .mmd 并重新渲染;每次变更后展示 View: 命令;同一会话保持 .mmd 路径一致;若 mmdc 报语法错误,先展示错误并修复代码再重试。

限制:依赖 mmdc 与终端内联图片能力;Claude Code 的 Bash 捕获 stdout 导致图片不会自动显示,需用户手动执行 View 命令。其他平台或缺失依赖情况暂未提供。