osFoundry / Platform
笔记——图表
Mermaid 图表与源代码并排。一边编辑,一边渲染。
简介
Notes（图表）是 osFoundry 的 Notes 内置的 Mermaid 编写界面。Mermaid 图表以纯文本定义，包括流程图、时序图、类图、状态机、ER 图、甘特图，而此功能会把这段文本及其渲染出的图形保存在同一篇笔记里。你在一侧编辑源码，图表在另一侧渲染，定义与结果因此永远不会脱节。
由于图表是以源码而非导出的图片形式存储，它始终是笔记文本的一部分。你可以对它做 diff、复制、交给智能体，或粘贴到另一篇笔记，都不会失去可编辑性。任何内容都不会被压平成一张需要重画才能改动的截图。改动代码里的一个箭头，渲染立刻随之更新，这正是让图表迭代变得迅速而非繁琐的关键。
它位于 osFoundry 之中，这是一个自带密钥（BYOK）的桌面工作区，聊天、智能体、应用、代码与知识共享同一处空间。Notes 采用本地优先，因此你勾画出的图表（一套架构、一段流程、一个数据模型）除非你另作选择，否则会留在你的设备上。而且由于 osFoundry 能运行任何你自带密钥的模型，工作区中的智能体可以直接在笔记里起草或修改 Mermaid 源码，落笔的那一刻你就能看到它渲染出来。
主要功能
- 在一篇笔记中编写 Mermaid 图表，并排查看渲染结果：一侧是源码，另一侧是图形
- 对图表代码的改动会随你输入即时重新渲染，因此对某个流程或时序做迭代是即时的
- 图表以其文本源码形式存储，而非固化的图片，因此始终可编辑、可 diff、可复制
- 支持 Mermaid 涵盖的图表类型：流程图、时序图、类图、状态图、ER 图与甘特图
- 本地优先的 Notes 将图表源码保存在你的设备上；用你自带密钥运行的智能体可直接起草或修改 Mermaid
使用场景
- 工程师：将某项服务的请求流程记录为笔记中的 Mermaid 时序图，并随设计变化调整源码
- 技术文档撰写者：让架构流程图与解释它的文档内联在一起，直接编辑代码而不是重新导出图片
- 团队负责人：把项目时间线勾画为甘特图，并在日期变动时请工作区智能体更新 Mermaid 源码
常见问题
我可以渲染哪些 Mermaid 图表类型？
Mermaid 的标准集合：流程图、时序图、类图、状态图、实体关系图和甘特图。你用 Mermaid 的文本语法书写，笔记会实时渲染它们。
图表是保存为图片还是可编辑的文本？
保存为文本。Mermaid 源码存在笔记里，渲染结果由它生成。这意味着你随时可以回头编辑定义，而不必重画一张静态图片，复制笔记时源码也会一并带走。
AI 智能体能替我编写图表吗？
可以。osFoundry 是一个自带密钥的工作区，因此运行在你所连接模型上的智能体可以在笔记内生成或修改 Mermaid 源码。由于图表是源文本，智能体写下的内容会与你自己的编辑一样被渲染出来。