外观
AIEditor Java SDK
aieditor-java-sdk 是给业务后端使用的 Java 17 文档转换 SDK。它把编辑器中的 Tiptap JSON、可处理的文档模型和 Word 文件连接起来：
text
DOCX <-> Document IR <-> Tiptap JSON
DOC -> Document IR -> 新 DOCX典型用途是：用户在 AiEditor 中打开或编辑文档，服务端负责导入、保存、审阅、资源解析和导出。业务代码通常只需要 tech.aiflowy.docs.DocsSdk，不需要了解 OOXML 包结构，也不需要在服务器安装 Word 或 LibreOffice。
你可以用它做什么
| 业务问题 | SDK 能力 | 从这里开始 |
|---|---|---|
| 让 AiEditor 编辑已有 Word 文件 | DOCX 导入、Tiptap JSON 转换、DOCX 导出 | 编辑器与 DOCX 往返 |
| 修改后尽量保留原文件中的复杂对象 | DocxPreservationContext 高保真上下文 | 已有 DOCX 的高保真编辑 |
接收老系统产生的 .doc | Word 97-2003 只读导入并转成新 DOCX | 旧版 Word 文档迁移 |
| 处理编辑器中的远程图片 | 显式 ResourceResolver 和安全边界 | 图片与远程资源 |
| 生成公文、保留修订和批注 | 公文节点、GB/T 9704 布局、审阅数据 | 公文与审阅数据 |
能力边界
- 支持段落、标题、字符与段落格式、列表、表格、图片、链接、分页/分栏符、页面设置和分节。
- 支持 AiEditor 的
textStyle、行高、缩进、上下标、字间距，以及 Pro/公文版使用的修订、批注和公文节点。 - 未支持的正文对象和未修改的 DOCX package parts 可以在高保真上下文中保留；这不等于所有对象都可编辑。
.doc只支持读取，不能原样写回旧二进制格式；导出时会生成新的.docx。- SDK 不隐式联网、不替业务下载资源，也不计算两个任意文档之间的结构 diff。