核心功能
Beauty Diagram 是一款面向技术团队的图表美化工具，通过 bd CLI 将 Mermaid 和 PlantUML 源代码转换为 presentation-ready 的 SVG 或 PNG。核心工作流包括： beautify（本地渲染）、export（消耗配额的可下载文件）、share（生成公共链接）、ai generate（文本描述转图表）以及 batch/extract（批量处理目录或 Markdown 中的图表）。
显著优点
- 零本地状态：CLI 为 thin client，引擎托管于云端，无需维护本地渲染环境
- AI 辅助生成：付费用户可通过自然语言描述直接生成 Mermaid 源码，降低图表制作门槛
- 灵活的嵌入策略：支持内联 URL（匿名、带水印）与 sidecar SVG（本地文件、Pro/Premium 无水印），适配 GitHub README、Notion、博客等多种场景
- 批量与自动化：
bd batch支持并行渲染目录内所有图表文件，bd extract可自动替换 Markdown 中的代码块为图片引用 - 版本可控：始终保留原始
.mmd/.puml源文件，SVG 仅作为派生产物
潜在局限
- 网络依赖：所有渲染走云端 API，离线环境不可用
- AI 功能付费墙：
bd ai generate需 Pro/Premium 订阅及ai:write权限的 API Key - 配额限制：匿名用户每日仅 1 次 export，免费计划每月 3 次，高频率使用需付费升级
- 样式控制受限：AI 生成仅负责"文本→图表"，视觉风格（主题、颜色、字体）需通过
--theme参数或 web 编辑器调整，无法通过自然语言指令微调 - SVG 重写策略：为保证 presentation 效果，输出 SVG 会重写布局，不适合需要像素级精确控制原始 Mermaid 输出的场景
适合人群
- 技术写作者：需要将架构图、流程图嵌入 README、ADR、RFC
- 产品经理与工程师：快速生成汇报所需的 polished 图表
- DevOps/SRE：批量渲染监控流程、部署流水线文档
- 需要分享可公开访问图表链接的协作者
常规风险
- 配额耗尽：批量操作前建议运行
bd usage检查剩余额度 - 认证失效：
not_authenticated/scope_missing需重新登录或创建带正确 scope 的 API Key - GitHub 缓存延迟：分享链接嵌入 README 后，更新可能延迟数小时显示
- 动画不渲染：
<img>标签加载的 SVG 不支持动画，需提前告知用户 - 源文件误删：需保留原始
.mmd，SVG 不可编辑