# 支持范围

各项 Word 功能在读取（parseDocx）与生成（generateDocx）两个方向上的支持情况。

“读取”指 `parseDocx` 把它转成有语义的节点；“生成”指 `generateDocx` 能从节点写出它。“原样写回”表示内容能保留到输出文件，但不能通过 LitAST 新建或修改。

| 功能 | 读取 | 生成 |
| --- | --- | --- |
| 段落：对齐、间距、缩进、制表位 | ✅ | ✅ |
| 文字格式：粗体、斜体、下划线、删除线、上下标、字号、颜色、字体、高亮 | ✅ | ✅ |
| 标题、引用、代码块、水平线 | ✅ | ✅ |
| 列表与多级编号 | ✅ | ✅ 自动生成编号定义 |
| 表格：合并单元格、列宽、底纹、边框、标题行 | ✅ | ✅ |
| 图片：嵌入、浮动、裁剪、超链接 | ✅ | ✅ |
| 文本框与形状 | ✅ | 原样写回 |
| 分节、页面设置、页眉页脚（含首页、奇偶页） | ✅ | ✅ |
| 域：页码、日期、目录与复杂域 | ✅ | ✅ |
| 内容控件：文本、复选框、日期、下拉列表、重复节、数据绑定、图片 | ✅ | ✅ |
| 批注与回复 | ✅ | ✅ |
| 修订：插入、删除、格式修改、移动 | ✅ | ✅ |
| 脚注与尾注 | ✅ | ✅ |
| 书签、编辑权限区域、分页符、分栏符 | ✅ | ✅ |
| 文档属性与文档变量 | ✅ | ✅ |
| 文档保护 | ✅ | ✅ |
| 公式（OMML） | 原样保留 | 原样写回 |
| 图表 | 原样保留 | 原样写回，不能新建 |
| 水印 | ✅ | 原样写回 |
| 样式定义 | 用于计算格式，原始部件保留 | 原样写回，不能通过 LitAST 新建样式 |
| 拼音指南（ruby） | ✅ 基文、注音及属性 | ✅ 新建、修改、写回；见[生成示例](/guide/generating#拼音指南) |

## 已知限制

- `generateDocx` 根据 LitAST 重建整个包，文档部件库（glossary）与自定义 XML 部件不会写回，见[往返与保留](/guide/round-trip)。
- 加密的 DOCX 与旧版 `.doc` 无法读取，会抛出 `DocxPackageError`。
- 不负责排版与渲染：lit-docx 只处理文件结构，不计算分页，也不把文档画出来。
- 拼音指南不会自动推断汉字读音。支持两层文字及格式、六种对齐值、字号、抬升量、语言与 `dirty`；复杂嵌套域/批注/修订的完整生命周期尚未验收。不符合 ruby 内容模型的节点会拒绝导出，不会无声丢弃。