Mermaid 图表

代理写的 Mermaid 图表,
直接画出来,而不是输出成代码

让 Claude Code 或 Codex 画一张图,它会写出 Mermaid:一段终端只能原样输出的文本。AgentsRoom 在您阅读代理所写内容的任何地方把它画出来,代码也只需一键即可查看。

对话视图、Markdown 文件、计划审查中的计划、笔记、项目记忆和待办工单:每个 mermaid 代码块都会变成图表,跟随应用的浅色或深色主题,在 macOS、Windows 和 Linux 上都可用。无需安装任何东西,不需要技能,也不需要 MCP 服务器。

一个代码块,两种读法
在终端里
```mermaid
flowchart LR
  A[Login] --> B{Token valid?}
  B -->|yes| C[Dashboard]
  B -->|no| A
```
在 AgentsRoom 里显示代码

同一个 mermaid 代码块:终端输出的样子,和 AgentsRoom 画出的样子。

问 Claude Code 一个请求如何在您的应用中流转,或者让 Codex 勾勒一次迁移涉及的表,您常常会收到一个以 mermaid 开头的代码块:流程图、时序图或实体关系图,都是以文本写成的。终端只能原样输出它,于是您只能读着用短横线拼成的箭头,在脑子里把方框画出来。

AgentsRoom 读取同样的 Markdown,并把它画出来。代码块滚动进入视野时就会变成图表,悬停时出现的“显示代码”按钮可以调出源码,“显示图表”则回到图形。如果代理写出了语法错误,代码会留在屏幕上,并附一行说明图表无法绘制,所以您永远不会丢失它写的内容。

绘制不依赖于 CLI:它由应用的 Markdown 阅读器根据文本完成。Codex 写在 README 里的图表、Claude Code 写在计划里的图表,或者其他任何代理写在工单里的图表,都以同样的方式绘制。

阅读代理时有什么不同

应用中所有显示 Markdown 的地方都遵循同一条规则:mermaid 代码块以图表形式显示。

在您阅读代理的每个地方

对话视图、文件预览和文件标签页中的 Markdown 文件、计划审查中的计划、笔记、项目记忆笔记、待办工单及其评论,以及“私下提问”的回答。

代理边写边画

代理是一行一行地写图表的。AgentsRoom 会等文本稳定片刻再绘制,同时把上一个有效的图表保留在屏幕上,所以代码块不会在代码和图形之间闪烁。

源码一键可见

悬停在图表上并点击“显示代码”,即可阅读生成它的 Mermaid 文本,再点击“显示图表”返回。源码从不会被替换,只是换一种方式显示。

出错的图表依然可读

当 Mermaid 无法解析代码块时,代码会留在屏幕上,下方附一行“无法绘制此图表:已改为显示其代码。”您可以原样把它交还给代理。

Mermaid 11 的所有图表

流程图、时序图、类图、状态图、实体关系图、甘特图、思维导图、Git 图:Mermaid 11 能画的,AgentsRoom 都能画。

屏幕外的不绘制

图表只有在接近屏幕时才会布局,一次一个,结果会被保留。一段满是图表的长对话,对于您还没滚动到的图表不产生任何开销。

docs/checkout-flow.md 的 AgentsRoom 文件预览:AI 编程代理写的 mermaid 流程图被画成图表,从购物车经过库存和支付检查,直到发送确认邮件,旁边有 Show code 按钮
从“文件”标签页打开的 Markdown 文件:代理写的 mermaid 代码块被画了出来,Show code 按钮(中文版应用中为“显示代码”)可调出它的源码。

如何使用

无需开启任何设置。从提问到图表,只需四步。

  1. 1

    请求一张图表

    对任意代理用平常的话提出:把登录流程画成 Mermaid 流程图,或者把这个 API 调用展示成时序图。通常只要提到 Mermaid,代理就会用 mermaid 代码块回答。

  2. 2

    在对话视图中阅读

    把代理的面板切换到对话视图:代码块会以图表形式出现在代理的回答中。下面的终端不会改变,仍然显示文本。

  3. 3

    或者打开它写的文件

    当代理把图表放进 Markdown 文件(README、架构说明、计划)时,可以通过它回答中的文件链接、右侧面板的“文件”标签页,或者 文件 > 打开文件(macOS 上按 Cmd O,Windows 和 Linux 上按 Ctrl O)打开:预览和文件标签页会绘制其中的每一张图表。

  4. 4

    检查源码

    悬停在图表上并点击“显示代码”来阅读或复制 Mermaid 文本,再点击“显示图表”回到图形。

终端、GitHub 和 Mermaid 技能已经能做什么

Claude Code 和 Codex CLI 运行在终端里,而终端输出的是字符,不是图形:mermaid 代码块显示为源码。这不是 CLI 少了某个设置,终端本来就是这样。

所以人们会去找 Claude Code 的 Mermaid 技能、插件或 MCP 服务器。它们帮助代理写出有效的图表,或把它导出为图片文件。但要阅读图表,您仍然得把代码粘贴到能绘制它的地方:GitHub 会绘制 Markdown 文件和评论中的 mermaid 代码块,mermaid.live 会绘制您粘贴的任何内容,编辑器的 Markdown 预览则借助 Mermaid 扩展来绘制。

AgentsRoom 并不取代这些工具。它省掉的是您本来就在阅读代理时的复制粘贴:图表直接画在对话、计划或您已经在代理旁边打开的文件里。

限制

  • 代理的原始终端仍然显示源码:绘制发生在对话视图和 Markdown 阅读器中,而不是在终端网格里。
  • 对话视图适用于 AgentsRoom 能读取其会话记录的 CLI:Claude Code、Codex、Grok Build、Mistral Vibe、oh-my-pi、Pi 和 Antigravity CLI。使用其他 CLI 时,请打开代理写的 Markdown 文件。
  • 图表使用 Mermaid 的 dark 和 neutral 主题,与应用的浅色或深色主题相匹配。它们不会采用您的强调色。
  • 图表中的链接只会打开 http 或 https 地址,和 Markdown 链接一样。指向本地文件的链接不会有任何反应。
  • 标签都是纯文本:图表中的 HTML 和脚本会被移除,图表里写的配置行也无法改变这一点。
  • 没有导出按钮:如果想把图表保存为 PNG 或 SVG 文件,请让代理用 Mermaid 的命令行工具导出。

常见问题

Claude Code 能渲染 Mermaid 图表吗?

在终端里不能。Claude Code 把 Mermaid 图表写成代码块,终端只能把它作为文本输出。在 AgentsRoom 中运行同一个代理,并把它的面板切换到对话视图:代码块会在回答中被画成图表,“显示代码”按钮可以调出源码。

如何预览代理写在 Markdown 文件中的 Mermaid 图表?

在 AgentsRoom 中打开该文件:点击代理回答中的文件链接,在右侧面板的“文件”标签页中选择它,或者使用 文件 > 打开文件(macOS 上按 Cmd O,Windows 和 Linux 上按 Ctrl O)。Markdown 预览,以及以标签页打开时的文件标签页,会绘制文件中的每个 mermaid 代码块。

它支持 Codex 和其他代理 CLI 吗?

支持。无论是哪个 CLI 写的,图表都由应用的 Markdown 阅读器根据文本绘制,所以来自 Codex、Claude Code 或其他任何代理的图表,在文件、计划、笔记和工单中都以同样方式绘制。对话视图会在回答到达时就把它们画出来,支持 Claude Code、Codex、Grok Build、Mistral Vibe、oh-my-pi、Pi 和 Antigravity CLI。

我需要 Mermaid 技能或 MCP 服务器吗?

阅读图表不需要。技能或 MCP 服务器可以帮助代理写出有效的 Mermaid,或把它导出为图片。AgentsRoom 只负责绘制已经写好的内容,所以两者可以配合使用:技能让图表更好,AgentsRoom 把它展示出来。

会绘制哪些图表类型?语法错误怎么办?

Mermaid 11 能绘制的一切:流程图、时序图、类图、状态图、实体关系图、甘特图、思维导图、Git 图,以及它目录中的其余类型。Mermaid 无法解析的代码块会保持为代码,下方附一行说明图表无法绘制。让代理修正它:修正后的代码块就会被绘制出来。

您可能还喜欢

把代理的图表当图表来读

下载适用于 macOS、Windows 或 Linux 的 AgentsRoom,让代理画一张 Mermaid 图表,并把它的面板切换到对话视图。

免费下载 AgentsRoom

配套应用:随时随地监控你的 Agent

使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。

获取扩展程序
Chrome Web Store

把 Bug 和需求直接发送到您的公开待办清单。

多项目管理
多供应商
多代理运行
实时状态
文件差异与提交
移动应用
实时预览
代理团队
浏览器自动化
Backlog 驱动开发
提示词库
技能库
查看所有功能