独立绘图库和工作台都不依赖三个产品。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 图表文档维护;MD Editor 接入说明产品配置。以上为固定端口的本地预览入口。
导出边界
预览图片可进入固定排版。结构化 Word 导出以 PNG 展示,并通过受控元数据保留源码;不是 Word 原生可编辑的 UML 图形或连接线。再次编辑能力取决于格式是否保留该元数据,不能从普通 PNG 反推出源码。Markdown 围栏的导出转换由对应产品负责。