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（一个JavaScript库，不是命令行界面）将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: 提取Mermaid（原始或从Markdown块）并调用renderMermaidAscii的Node CLI。skills/beautiful-mermaid-ascii/references/notes.md: 关于Mermaid输入和常见模式的小笔记。