公文版配置概览

公文版的 AiEditorOfficialOptions 继承 Pro 的全部配置，并将默认文档样式、分页和公文产品扩展组合到一起。

安装与初始化

npm install aieditor @aieditor/pro @aieditor/official

import {AiEditorOfficial} from '@aieditor/official'
import 'aieditor/style.css'
import '@aieditor/pro/style.css'
import '@aieditor/official/style.css'

const editor = new AiEditorOfficial({
  element: '#editor',
  officialDocument: {compliancePanel: true},
})

默认会启用 gbt-9704 文档样式和分页预览，并注册红头、署名、版记菜单及对应 Bubble Menu。

专属选项

选项	类型	默认值	说明
documentStyle	DocumentStyleOptions | 'gbt-9704'	'gbt-9704'	公文版式、字体、版心网格和页码规则。
officialDocument	false | OfficialDocumentOptions	{}	公文合规 Surface 和信函首页页码联动。设为 false 不删除已有节点。
officialDocument.compliancePanel	boolean	true	显示实时确定性检查结果。
officialDocument.syncLetterPageNumbers	boolean	true	信函版式隐藏首页页码，其他版式显示首页页码。
officialSignature	OfficialSignatureMenuOptions	{}	预置印章图片和是否允许通过全局上传器上传。
pagination	boolean | PaginationConfig	true	在公文页面格式基础上覆盖分页字段。

Pro 的 trackChanges、comments、collaboration、translation、documentCompare 和 Core 的 toolbar、sidebar、uploader 等选项均可继续使用。

扩展注入

Official 会复制调用方的 productExtensions、productToolbarItems、productBubbleMenus 和 productSurfaces，再追加公文能力，不会修改调用方数组。默认菜单 ID 为：

菜单 ID	能力
red-header	插入或编辑红头版头
official-signature	选择或上传印章并插入署名组件
official-copy-container	插入版记/抄送容器

如需完全自定义工具栏，可在 Core 的 toolbar.menus 中显式排列这些 ID；Pro 的分页和格式标记菜单仍可按 Core/Pro 文档配置。

数据与分页边界

redHeader、officialSignature 和 officialCopyContainer 是结构化顶层节点；标题和正文仍是普通节点。公文分页器会将红头、标题、主送机关和第一段正文视为首页开篇，避免在开篇区域中间断页。

公文版会把 redHeader 加入 Unique ID 默认类型。协作、审阅和 DOCX 往返时不要丢弃这些节点的 attrs 或普通段落上的 documentRole。