# 三个编辑器接入

共享工作台和渲染器，分别由结构化文档与 Markdown 源码宿主持久化。

独立绘图库和工作台都不依赖三个产品。Classic、Block、MSFE / MD Editor 在各自宿主中接入同一份公开能力，文档格式和保存策略仍由产品决定。

| 宿主 | 接入位置 | 正文保存形式 |
| --- | --- | --- |
| Classic | `@quirekit/classic-text-diagram` 提供插入区入口 | `textDiagram` 原子节点中的完整对象，源码与 PNG 一起保存 |
| Block | 默认 preset 安装 `@quirekit/extension-text-diagram`，块插入入口打开工作台 | 同一结构化节点 |
| MSFE / MD Editor | `Mermaid` / `TextDiagrams` 处理围栏，MD Editor 提供插入弹窗 | `mermaid`、`plantuml` / `puml`、`dot` / `graphviz` 标准围栏 |

## Classic 与 Block

`@quirekit/extension-text-diagram` 提供 schema、命令、编辑目标映射和预览展示。`@quirekit/classic-text-diagram` 增加 Classic 工具栏接线；Block 的 preset 已配置打开工作台的宿主函数，可通过 preset 的 `textDiagram: false` 关闭。

修改通过各自的文档命令提交，成为一次可撤销操作。取消不写正文；编辑期间目标被删、变成只读或基线被更新，会拒绝过期提交并保留草稿。不要从工作台中直接修改节点视图 DOM。

这些编辑器集成包有自己的许可层（文本绘图的 Canvas 扩展为 AGPL，Classic 集成属于 QuireKit 商业组件），不改变独立绘图库与工作台的 MIT 许可。

## MSFE 与 MD Editor

独立 MSFE 宿主安装 `@quirekit/msfe-markdown-extras` 的 `Mermaid` 和 `TextDiagrams` 扩展。前者负责 `mermaid`，后者负责 PlantUML 与 DOT 别名；未知 DSL 继续作为源码，不会猜测引擎。

MD Editor 默认安装这些扩展，“插入 → 文本绘图”打开工作台。`features.extras.mermaid` 与 `features.extras.textDiagram` 分别控制两组能力。保存仍是标准围栏；在宿主里编辑围栏源码也能更新预览。

围栏、配置和自定义 ECharts 扩展示例继续由 [MSFE 图表文档](http://127.0.0.1:3210/extensions/diagrams)维护；[MD Editor 接入](http://127.0.0.1:3210/guide/md-editor)说明产品配置。以上为固定端口的本地预览入口。

## 导出边界

预览图片可进入固定排版。结构化 Word 导出以 PNG 展示，并通过受控元数据保留源码；不是 Word 原生可编辑的 UML 图形或连接线。再次编辑能力取决于格式是否保留该元数据，不能从普通 PNG 反推出源码。Markdown 围栏的导出转换由对应产品负责。