基础概念

编辑器与渲染器

SkyNoteEditor 装配引擎和常用基础插件，提供创建内容、视口、历史与事件接口。LeaferAdapter 把平台中立模型绘制到浏览器画布。自己的按钮和面板由应用宿主提供。

文档保存节点、连线与资产引用。会话保存当前选区、视口、工具和主题等本地交互状态。移动视口不会修改文档，也不会进入撤销历史。

媒体文件通过资产适配器管理，文档节点保存 assetId 引用，不把二进制写进文档。

节点通过 nodeType 选择内容与能力。连线可连接节点，也可拥有自由端点。子节点的坐标相对于父容器，根节点坐标相对于世界。

画框提供有边界的组织空间，分组表达逻辑归属。自定义节点应使用明确的类型化字段表达专有状态。

创建和修改实体通过编辑器或文档的语义命令提交。不要直接给实体对象赋值。documentStore.batch() 可以将一组操作合并成一步撤销；高频连续编辑应按交互会话使用历史分组。

插件通过公开上下文读取几何、提交命令和注册能力。宿主管理 DOM、产品 UI、资产和高级插件的开放范围。扩展方式见插件开发。