用途:Pretty Mermaid 用于创建或渲染 Mermaid 图表,输出主题化 SVG、PNG 或 ASCII/Unicode 文本,适合架构文档、README、PR、终端、聊天与 CI 场景。工作目录以本文件所在目录为 skill-root,脚本在该目录运行或用绝对路径调用;用户源文件与渲染结果保存在用户指定位置,不把渲染器复制进项目。
主要能力:支持多种图表类型,包括 flowchart、sequenceDiagram、stateDiagram-v2、classDiagram、erDiagram、xychart-beta。输出格式可选 SVG(可缩放、支持透明)、PNG(聊天与仅栅格场景,无需外部转换器)、Unicode(现代终端默认)、纯 ASCII(加 --use-ascii)以及 ANSI 彩色文本(--color-mode)。内置 15 个主题,并可配合显式颜色参数调整。
使用方式:先确定用户是否提供 Mermaid 源码或需根据文字撰写图表;选择图表类型与输出格式;新建源码保存为 .mmd;用命名主题或显式颜色渲染;检查结果并修正语法、裁剪、拥挤布局或标签不清后重新渲染;最后返回源文件与输出路径、格式与主题。示例命令:node scripts/themes.mjs 列出主题;node scripts/render.mjs --input diagram.mmd --output diagram.svg --theme tokyo-night;终端文本加 --format ascii --color-mode none;PNG 加 --format png --width 1200;批量用 node scripts/batch.mjs --input-dir ./diagrams --output-dir ./rendered --format svg --theme github-dark --workers 4。
适用场景与限制:三个以上图表或需统一目录选项时用批量渲染。命名主题可被显式颜色细化;打印用浅色主题并核对背景对比。渲染后确认命令成功、输出非空,SVG 以 <svg 开头、PNG 可正常打开、文本含可见内容;关注长标签、中日韩文字、断开组件与 XY 图表。变更本技能或脚本需运行 npm test 与 npm run validate。缺失依赖在 skill-root 运行 npm install;未知主题用 themes.mjs 的精确名称;解析错误参考 references/DIAGRAM_TYPES.md 并逐步还原;拥挤时增大 --node-spacing、--layer-spacing 或 --component-spacing;PNG 自定义色不能用未解析的外部 CSS 变量;重定向输出出现转义码用 --color-mode none。不要在用户未要求时覆盖已有源文件或输出文件,遇到渲染器不支持的语法应报告而非静默丢弃。