name: beautiful-mermaid-ascii description: 在终端中将Mermaid图表渲染为可读的ASCII/Unicode艺术（从.mmd/.mermaid文件、标准输入或Markdown ```mermaid代码块）。当安装或使用lukilabs/beautiful-mermaid、创建Mermaid到ASCII输出的CLI渲染器、在终端中预览Mermaid图表或从Markdown文件中提取/渲染Mermaid块时使用。
美丽Mermaid ASCII渲染
使用lukilabs/beautiful-mermaid（一个JS库，不是CLI）将Mermaid图表转换为终端友好的ASCII/Unicode艺术。
快速开始
渲染Mermaid文件：
skills/beautiful-mermaid-ascii/scripts/mermaid-ascii path/to/diagram.mmd
在您的PATH上安装干净的mermaid-ascii命令（默认符号链接到~/.local/bin）：
skills/beautiful-mermaid-ascii/scripts/install-mermaid-ascii
从标准输入渲染：
cat path/to/diagram.mmd | skills/beautiful-mermaid-ascii/scripts/mermaid-ascii
从Markdown渲染第一个Mermaid代码块：
skills/beautiful-mermaid-ascii/scripts/mermaid-ascii --md README.md
选择不同的代码块（基于1的索引）：
skills/beautiful-mermaid-ascii/scripts/mermaid-ascii --md README.md --block 2
安装方法（此技能如何“处理安装”）
scripts/mermaid-ascii在需要时自动将beautiful-mermaid安装到可写缓存目录（默认$XDG_CACHE_HOME/beautiful-mermaid-ascii或/tmp/beautiful-mermaid-ascii），然后运行渲染器。
如果您想在PATH上有一个“真实”的命令，建议使用符号链接安装器：
skills/beautiful-mermaid-ascii/scripts/install-mermaid-ascii
您还可以将此文件夹安装为本地/全局npm包（如果您的~/.npm不可写，请使用可写npm缓存）：
# 从仓库根目录
NPM_CONFIG_CACHE=/tmp/npm-cache npm install -g --prefix ~/.local ./skills/beautiful-mermaid-ascii
如果当前项目中已安装beautiful-mermaid，请使用：
skills/beautiful-mermaid-ascii/scripts/mermaid-ascii --pkg-dir . path/to/diagram.mmd
故障排除
- 如果由于
~/.npm或~/Library/Caches中的权限错误导致安装失败，请使用可写缓存目录运行：skills/beautiful-mermaid-ascii/scripts/mermaid-ascii --cache-dir /tmp/bm-cache ...
- 如果输出为空，请验证Mermaid文本是否有效并以图表类型（
flowchart、sequenceDiagram等）开头。 - 对于Markdown中的多个图表，使用
--list枚举代码块并使用--block选择一个。
捆绑资源
skills/beautiful-mermaid-ascii/scripts/mermaid-ascii: Shell包装器，确保依赖项可用，然后渲染。skills/beautiful-mermaid-ascii/scripts/mermaid-ascii.mjs: Node CLI，提取Mermaid（原始或从Markdown代码块）并调用renderMermaidAscii。skills/beautiful-mermaid-ascii/references/notes.md: 关于Mermaid输入和常见模式的小笔记。