OfficeIMO Document Tools

OfficeIMO — 面向 .NET 的 Office 和文档库

PowerShell：PSWriteOffice 由本仓库维护。有关引擎和模块的问题、功能请求及贡献，请使用 OfficeIMO issues。

OfficeIMO 是一系列不依赖 COM 的 .NET 库，可用于创建、读取、编辑、转换和导出 Office 及文档格式。它可在服务、桌面应用、构建 Agent、容器和自动化主机中运行，无需 Microsoft Office、Excel、PowerPoint、Visio 或 LibreOffice 自动化。

这并不是一个将一组互不相关的文档库包装起来的统一外观层。OfficeIMO 自行实现 OneNote、PDF、Markdown、RTF、OpenDocument、AsciiDoc、LaTeX、OPML、DocBook、CSV、EPUB、ZIP、绘图、Apple iWork 源文件、旧版 Word .doc、旧版 Excel .xls，以及旧版 PowerPoint .ppt/.pot/.pps 格式。Word、Excel 和 PowerPoint 使用 Open XML SDK 处理包机制；HTML 提供自有的文档和提供程序契约，同时保留 AngleSharp 用于解析和 CSS 执行。转换器组合使用同一套第一方对象模型，这些模型也用于原生包；如果目标格式无法容纳源文件的全部内容，转换器会返回诊断信息。

应用应让 OfficeIMO 包保持在同一协调版本。转换器会组合由各包拥有的文档模型；如果调用方需要保真度诊断，还可使用会返回结果的 API。

对于通过 ODBC 导入的现有 Windows x64 应用，OfficeIMO.Odbc 可将有界 .xlsx 工作簿快照作为只读 SQL 表公开。它独立于 .NET 文档包进行构建和部署。

要升级现有应用？OfficeIMO 迁移指南介绍了各类格式在包、API 和行为方面的变更。发布历史和可下载的构建产物可通过 GitHub Releases 获取。

如果 OfficeIMO 为您节省了时间，请考虑通过 GitHub Sponsors 或 PayPal 支持这项工作。PowerShell 用户可从 PSWriteOffice 开始。

Sponsors

See all sponsors

依赖模型

OfficeIMO 将文档引擎保留为第一方组件，并将可选集成隔离开来。下表列出了与包选择相关的、直接依赖的非 OfficeIMO 运行时依赖项；对于较旧的目标框架，仍会使用 Microsoft/BCL 兼容性包来支持平台 API。

包系列	直接外部运行时依赖项	OfficeIMO 自有功能
Drawing、OneNote、Markdown、RTF、OpenDocument、AsciiDoc、LaTeX、OPML、DocBook、CSV、EPUB、ZIP	无第三方文档引擎	解析、对象模型、写入、渲染基元、安全限制和诊断
CAB 和被动 MSI 提取	无	托管 Cabinet 解码、嵌入式 MSI 负载映射、有限提取和路径验证
JavaScript 和浏览器资源	无	严格的 TypeScript 文档层、流式 XLSX/CSV 和嵌入式可移植脚本
Apple iWork 源文件读取	无第三方文档引擎	有限的包、Snappy/IWA、protobuf 封装、记录保留，以及 Pages/Numbers/Keynote 投影层
Word、Excel、PowerPoint	Open XML SDK	流畅且可编辑的对象模型、生命周期、验证、转换、托管图像导出，以及第一方 .doc/.xls/.ppt 支持
HTML 文档契约（OfficeIMO.Html.Core）	无	自有节点、不可变快照、编辑，以及解析器/字符集契约
HTML 语法提供程序（OfficeIMO.Html.AngleSharp）	AngleSharp 和 System.Text.Encoding.CodePages	转换为自有节点、选择器/序列化服务，以及字符集提供程序集成
HTML 转换和渲染	AngleSharp 和 AngleSharp.Css	资源策略、媒体筛选、布局场景，以及 PNG/JPEG/TIFF/SVG/WebP 输出；选择性启用的桥接可添加 RTF、MHTML、电子邮件图像和 PDF 工作流
PDF	无第三方 PDF 或加密依赖项	PDF 解析/写入/渲染、密码安全、签名结构、保留策略、限制和诊断
电子邮件、电子邮件存储和通讯录	System.Text.Encoding.CodePages	EML/MIME、MSG/OFT、TNEF、mbox、PST/OST、OLM、EMLX、Outlook OAB、MAPI 投影、受保护封装保留、限制和诊断
可选 Security 提供程序	Bouncy Castle 和 System.Security.Cryptography.Xml	在单个类型化提供程序后编排 CMS/S/MIME/RFC 3161/X.509/XML DSig，并由调用方显式提供给 Word、PDF 或 Email
可选 ChartForgeX 桥接	ChartForgeX	矢量优先的可视化产物转换、OfficeDrawing 保真度报告，以及 Word、Excel、PowerPoint 和 PDF 放置
Visio	System.IO.Packaging	VSDX/VSTX/VSSX 和启用宏的包模型、有限的旧版二进制导入、图表构建器、编辑、验证、拓扑，以及 PNG/JPEG/TIFF/SVG/WebP 导出
Reader.Yaml	YamlDotNet	Reader 投影、分块、限制、位置和诊断
MarkdownRenderer.Wpf	Microsoft WebView2	渲染外壳、预设、插件模型和 WPF 主机契约
可选文档 AI	OfficeIMO.AI 和 IntelligenceX 适配器	基于有限源证据提供只读问答、摘要、字段提取和建议结构；使用 .NET 10，并由调用方选择模型执行
可选 OCR 提供程序	调用方提供的可执行文件或已安装的 Tesseract CLI	中立的请求/结果/几何契约、有限的提供程序执行，以及选择性启用的 Reader/PDF 集成
Google Workspace 包	System.Text.Json 和平台 HTTP/加密功能	凭据抽象、请求/重试逻辑、Drive 放置、翻译计划和报告；不依赖 Google 客户端 SDK
上文未列出的转换器包	仅其所连接的 OfficeIMO 格式包	功能映射、限制、损失报告和目标 API

概览

范围	当前仓库支持情况
现代 Office 文档创作与编辑	.docx、.xlsx、.pptx、.vsdx、.vstx、.vssx、.vsdm、.vstm、.vssm
一方旧版二进制格式支持	Word 97–2003 .doc、Excel BIFF8 .xls、PowerPoint 97–2003 .ppt/.pot/.pps
一方 Apple iWork 支持	基于现代 IWA 的 .pages、.numbers 和 .key 读取/检查，以及可编辑或视觉回退投影；无需模板的 Keynote 文本/图像/表格幻灯片、Pages 正文文档和 Numbers 标量表格电子表格，支持范围有限
一方离线 OneNote 支持	桌面版/FSSHTTP .one、.onetoc2、.onepkg
托管式 PNG/JPEG/TIFF/WebP/SVG 文档导出	Drawing；Word、Excel、PowerPoint、HTML、OneNote、Visio 和 PDF；基于 HTML 的电子邮件和 EPUB；通过 Office 适配器处理 ODT/ODS/ODP

复选框准确标明支持级别：创作、编辑、读取、保留、检查、转换或导出。勾选的检查或保留项并不代表支持完整创作。

OfficeIMO Studio

OfficeIMO Studio 将 OfficeIMO 引擎整合到应用中：读取、搜索、批注和填写 PDF，整理页面，让扫描件可搜索，将 Office 文档转换为 PDF，并保护和签署结果。文档在你自己的设备上处理；连接文档助手与模型是可选的。

• **Windows 和 Linux：**桌面工作区，可从 Microsoft Store 获取，也可从 GitHub Releases 获取适用于 x64 和 Arm64 的已签名 MSI、Debian 软件包或便携式 ZIP。它还提供评论串、涂黑、内容编辑、表单创作、从 PDF 转换、比较和文档助手。请参阅 Studio README。
• **Mac、iPad 和 iPhone：**基于同一引擎的原生应用，正在开发中，包含系统文档处理、Apple Pencil 批注、文档相机、通过 Vision 在设备端进行文本识别，以及 Shortcuts。请参阅 Apple 应用 README。

Studio 页面上的功能表展示了 Studio 在各系统上的功能以及计划中的功能。

OfficeIMO 命令行工具可通过脚本执行相同的转换、提取和工作流，并通过 MCP 将这些功能提供给 AI Agent。

面向 AI Agent 的 OfficeIMO

Claude Code、Codex、集成 GitHub Copilot 的 VS Code、Cursor 和其他 MCP 客户端可使用 OfficeIMO 检查、搜索、获取和转换本地 Word、Excel、PowerPoint、PDF 和邮件文件，并生成独立的 PDF 输出。OfficeIMO Document Tools 插件提供两个 Agent Skills 和 MCP 服务。该服务在你的计算机上运行，只会打开你授权的文件夹：

claude plugin marketplace add EvotecIT/OfficeIMO
codex plugin marketplace add EvotecIT/OfficeIMO --ref master --sparse .agents/plugins

AI Agent 页面提供 VS Code 和 Cursor 的一键安装方式、其他客户端的配置、服务提供的全部工具，以及列出 OfficeIMO 的目录。

软件包和工具

下面每个勾选项都已实现。详细行为、示例和保真度边界请参阅各项目的 README。

原生格式与共享基础组件

OfficeIMO.Core

• 在各种格式间通用的 Save、SaveAsync、SaveCopy、ToBytes 和 ToStream 生命周期契约
• 不可变 RGBA 颜色、命名颜色、十六进制解析、调色板和跨格式视觉主题
• 图像识别、尺寸、MIME 元数据、适配模式、投影、裁剪和变换辅助工具
• 有界异步远程图像加载，支持 URL 策略、字节数限制、媒体检查和诊断信息
• 字体描述符、确定性文本测量、TrueType 字体发现和字形轮廓读取
• 统一的文本整形提供程序契约，包含依赖精简的托管核心阿拉伯文／TrueType 实现和明确的回退诊断
• 形状、路径、渐变、阴影、裁剪、变换、矢量场景和文本块
• 通用图表类型、图表快照、系列数据、渲染器和视觉质量报告
• 无依赖的栅格缓冲区、绘图画布、合成、图案、数据条和迷你图
• 一流的 PNG／JPEG 识别、解码、编码和栅格导出流程
• 明确选择合成 GIF 帧，或拒绝动画并提供类型化损失证据
• 无依赖的 TIFF 输出，支持未压缩、PackBits 或 Deflate 条带；确定性无损 WebP 编码，并支持常见栅格导出选项
• 通用 SVG 基元写入和可缩放绘图导出
• 单张及批量图像导出构建器，包含尺寸、源元数据和诊断信息
• 可复现且经过输出验证的识别、解码、编码、调整尺寸和放置优化基准测试；选择性启用的库对比与运行时包隔离

依赖情况： 零第三方运行时依赖。

OfficeIMO.Archives

• 有界 ZIP 元数据遍历，提供导入警告，并在内存中验证成员读取
• 托管 ZIP 解压，验证路径、声明大小、解码长度和 CRC
• 使用 Store、MSZIP 和 LZX 压缩格式进行托管的单 CAB 解压
• 被动式 MSI 解压通过编写的 Directory、Component、File 和 Media 表映射嵌入的 CAB 成员
• 选择性输出、路径和冲突验证、有限资源限制、取消操作以及原子化目标发布

依赖情况： 仅依赖 OfficeIMO.Core；解压不会执行安装程序或自定义操作。不支持 CAB 文件集、外部 MSI 有效负载以及依赖操作的安装布局；请参阅支持矩阵。

OfficeIMO.IWork

• 读取有界 ZIP、目录包、嵌套 Index.zip、Snappy 帧格式 IWA、ArchiveInfo、MessageInfo 和 protobuf 信封
• 检测应用程序、制作方构建历史、发现栅格/PDF 预览、以防御性方式访问包条目，并保留主要和辅助 IWA 负载
• 扩展语义投影：Pages 的丰富内容/布局/图像/表格；Numbers 的稀疏类型化单元格/公式/合并单元格/表格元数据；以及 Keynote 的定位富文本/图像/表格/备注
• 可选的 OfficeIMO.Word.IWork、OfficeIMO.Excel.IWork 和 OfficeIMO.PowerPoint.IWork 适配器，提供可编辑重建与视觉回退报告
• 来自 Pages 14.1/14.5、Numbers 11.1–15.1 历史版本及 Keynote 8.1/14.5/15.2.1 的独立来源语料证据
• 无需模板即可创建原生 Keynote 幻灯片，支持富文本、PNG/JPEG 图像和标量表格；创建带页面设置和富文本段落的原生 Pages 正文文档；提供独立解码以及针对特定夹具的 Apple 重新打开/导出/编辑证据
• 无需模板即可创建原生 Numbers 标量表格电子表格，并提供独立解码及原生打开/编辑/保存/导出证据
• 支持保留原内容的原生未更改保存；通过基于不可变源快照的独立会话，直接移动/调整 Keynote 图像大小，以及编辑现有 Numbers 数值/布尔单元格；明确接受视觉缓存并提供操作报告

_依赖项：_仅需 OfficeIMO.Core；软件包和 IWA 读取器均为第一方实现。除非显式安装 iWork 适配器，否则 Word、Excel 和 PowerPoint 仍可独立使用。

OfficeIMO.Data.Arrow

• 从任意仅向前读取的 DbDataReader 获取有界的同步和异步 Apache Arrow 记录批次
• 原生 Boolean、数值、十进制、时间、GUID、二进制和文本数组，并明确规定不支持类型的处理策略
• 为 OfficeIMO Excel、CSV 和常规 ADO.NET 提供程序提供共享适配器，不将 Arrow 添加到它们的运行时依赖图中

依赖项：OfficeIMO.Core 和 Apache.Arrow；Excel 和 CSV 仍可独立使用。

OfficeIMO.Data.Generators

• 编译时 RowMapper<T> 配置，可供 Excel、CSV 和其他 DbDataReader 数据源共用
• 主列名、别名、继承的可写属性，以及针对不支持的模型结构的构建诊断
• 在 NativeAOT 消费者中验证无反射生成映射

_依赖项：_仅限构建时使用的 Roslyn 分析器；应用程序不会部署生成器程序集。

OfficeIMO.Drawing.HarfBuzz

• 通过共享的 IOfficeTextShapingProvider 契约，提供可选的完整 OpenType GSUB/GPOS 整形
• 为 TrueType 和 OpenType/CFF 字体提供稳定的逻辑簇映射和定位后的字形前进量
• 将 Windows、Linux、macOS 和 WebAssembly 原生资产排除在依赖精简的 Drawing 和 PDF 核心之外

依赖项：OfficeIMO.Core、HarfBuzzSharp 及其平台原生运行时资产。

OfficeIMO.Drawing.CodeGlyphX

• 提供从 CodeGlyphX QR、矩阵和线性条码符号到可复用 OfficeDrawing 场景的可选类型化桥接
• 中立的 SVG 交接方式，不让任一核心软件包依赖另一个
• 可搜索的条码标签文本和明确列出的不支持导入数量

_依赖项：_仅需 OfficeIMO.Core 和 CodeGlyphX；两个核心软件包均可独立使用。

OfficeIMO.ChartForgeX

• 可选地将每个 ChartForgeX VisualArtifact 转换为可复用的 SVG 和 OfficeDrawing 表示形式
• 在 Word、Excel 和 PowerPoint 中以原生矢量方式放置，并通过 OfficeIMO.Drawing 原生合成 PDF
• 以磅为单位标准化尺寸，支持辅助功能文本、区域元数据，以及明确指定保留矢量、回退到栅格或要求使用矢量的策略
• 将 CFX 拓扑、流程和时序语义原生投影为可编辑的 Visio 图形，包括容器、形状数据、超链接、消息、注释、激活条和片段
• ChartForgeX 水印和渲染选项会沿用相同的转换流程，而文档／页面水印仍由 OfficeIMO 管理

依赖项： ChartForgeX 以及 OfficeIMO Word、Excel、PowerPoint、PDF、Visio 和 Core 包。现有格式包仍可独立使用，且不依赖 ChartForgeX。

OfficeIMO.ChartForgeX.Markdown

• 可选地在 Markdown 转 Word、PDF、HTML 和 PowerPoint 的工作流中静态渲染 Mermaid 代码围栏
• 为文档嵌入 PNG 图片，为 HTML 使用独立的 SVG 图片，并支持标题、辅助功能文本、诊断信息和源内容回退

依赖项： ChartForgeX.Markup.Mermaid 和 OfficeIMO.MarkdownRenderer。文档核心和 Markdown 核心仍可独立使用。

OfficeIMO.Word

• 创建、加载、编辑、追加、检查并保存 .docx 文档
• 读取、写入并转换受支持的原生 Word 97–2003 .doc 子集，并预先检查内容丢失情况
• 丰富的文本片段、字体、颜色、突出显示、边框、底纹、制表位、间距、换行符和自定义段落样式
• 项目符号、编号、图片项目符号、嵌套列表、起始值、克隆和列表样式检测
• 支持样式、边框、单元格边距、合并／拆分、嵌套表格、重复标题行、宽度、高度和分页控制的表格
• 从文件、流、字节、Base64 和 URL 插入图片，并支持替代文本、裁剪、透明度、文字环绕、旋转、翻转和定位
• 原生图表、形状、线条、文本框、公式、嵌入式文档／对象，以及 SmartArt 检查／修改助手
• 域、目录、书签、超链接、交叉引用、文档变量、参考文献来源和域更新报告
• 分节、页面大小、方向、页边距、分栏、页面／背景颜色、水印和页码
• 默认、首页和偶数页页眉与页脚，包括多分节继承和清理
• 脚注、尾注、批注、修订、修订跟踪助手、比较／修订报告和文档合并
• 用于文本、复选框、日期、列表、图片、富文本和重复节的内容控件
• 邮件合并、保留格式的域替换、条件模板块、自定义 XML 绑定和表单映射验证
• 宏的添加／提取／移除、文档保护、加密包、数字签名检查、清理、修复和功能预检
• 将文档导出为 PNG、JPEG、TIFF、无损 WebP 和 SVG；启用可选转换包后，还可导出为 PDF、HTML、Markdown、RTF、ODT 和 Google Docs

依赖项： Open XML SDK 和 OfficeIMO.Core；旧版 .doc 支持和图片导出由 OfficeIMO 实现。Apple Pages 导入需通过 OfficeIMO.Word.IWork 选择启用。

OfficeIMO.Excel

• 创建、加载、编辑、检查和保存 .xlsx 工作簿
• 读取、写入和转换受支持的第一方 BIFF8 .xls 子集，并进行损失预检
• 工作表、单元格、区域代数、合并单元格、可变表架构、完整筛选状态、冻结窗格、超链接、本地/工作簿名称和命名样式
• 对象、字典、DataTable、DataSet、行、流和类型化模型的导入/导出，并支持可编辑行工作流
• 流式读取、直接包写入器、并行计算/应用阶段、进度、取消和大型工作簿控制
• 字体、填充、边框、对齐、数字格式、富文本、主题、行/列尺寸调整和可复用报表样式
• 事务性行/列/单元格移动，以及复制/移动/转置；支持试运行、回滚预算、引用重映射和包诊断
• 数据验证、条件格式、图标集、数据条、色阶、允许编辑区域管理、忽略错误元数据保留和迷你图生命周期管理
• 共享的 A1/R1C1 公式/引用语法、公式感知搜索和状态诊断、依赖关系图，以及用于报表函数的有界计算引擎
• 支持常见的二维/三维、饼图、雷达图、股价图、曲面图、组合图、次坐标轴、趋势线、仪表板和原生 ChartEx 场景的图表
• 数据透视表，支持字段、布局、样式、筛选器、分组、计算字段、共享缓存和原生切片器/时间线视图
• 原生查询驱动的表，支持由调用方托管执行、显式安全策略、有界事务性刷新、取消和结构重映射
• 模板，支持标记绑定、重复行、重复工作表、可选区域、格式化程序、图像绑定和预检诊断
• 传统批注，以及线程化批注/人员元数据检查和保留
• 工作表/工作簿保护、加密 OOXML 包、文档属性和兼容性验证
• 打印区域、分页符、页面设置，以及支持图像的首页/奇数页/偶数页页眉和页脚
• 原生单元格内图像，以及功能检查和关系保留式往返处理；支持宏、外部链接、自定义 XML、嵌入式包、签名、控件和无所有者的导入部件
• 显式文件支持的编辑，具备大小/部件预算和确定性取消，同时不改变既有的直接写入、流式读取或未更改包快速路径
• 将工作簿、工作表和区域导出为 PNG、JPEG、TIFF、无损 WebP 和 SVG；适配器还支持 PDF、HTML、ODS 和 Google Sheets
• 可复现的读取、写入、编辑、包大小和丰富功能跨库基准测试套件，支持输出验证和平台来源信息

依赖项： Open XML SDK 和 OfficeIMO.Core；传统 .xls 支持和图像导出由 OfficeIMO 实现。Apple Numbers 导入可通过 OfficeIMO.Excel.IWork 选择启用。

OfficeIMO.PowerPoint

• 创建、加载、编辑、检查和保存可编辑的 .pptx 演示文稿
• 通过版本化功能契约和损失预检，读取、创作、编辑、保留、加密和转换 .ppt、.pot 和 .pps
• 创建、复制、删除和重新排序幻灯片，以及管理分节、演示文稿尺寸、版式、占位符和模板
• 文本框、富文本片段、段落、项目符号、对齐、间距、自动适应、超链接和主题感知排版
• 从文件和流中插入 PNG/JPEG/SVG 图片，并支持裁剪、替换、验证、定位和效果
• 支持合并、单元格格式、边框、填充、分页辅助功能和数据驱动创建的表格
• 共享图表创作、数据绑定、格式设置、标记、坐标轴、组合图表、次坐标轴和图表更新
• 自动形状、自定义几何图形、线条、分组、对齐、分布、网格、尺寸、锚点、堆叠和效果
• 背景、渐变、叠加层、主题、颜色变换、切换效果、演讲者备注、备注母版、元数据和媒体检查
• 语义化演示文稿规划，以及可复用的高管摘要、图表叙事、对比、截图、附录、架构和结尾版式
• 对密度、重复、长分节、版式平衡和缺少结尾进行演示文稿预检和节奏分析
• 功能/包检查、验证、修复、无障碍元数据、SmartArt 检查和注重保留内容的编辑
• 加密演示文稿的保存/加载，以及只读、基于流、分离加载和显式持久化生命周期
• 将幻灯片导出为 PNG、JPEG、TIFF、无损 WebP 和 SVG，并支持导出整个演示文稿的图片；适配器还支持 PDF、HTML 和 ODP

依赖项： Open XML SDK 和 OfficeIMO.Core；旧版二进制格式支持、版式组合、编辑、图表和托管图片导出均由 OfficeIMO 实现。可通过 OfficeIMO.PowerPoint.IWork 选择启用 Apple Keynote 导入。

OfficeIMO.Visio

• 无需自动化 Visio，即可创建、加载、编辑、检查和保存绘图、模板、模具及启用宏的 Open XML Visio 包
• 通过同一模型显式导入/导出 VDX/VSX/VTX XML，并支持有界加载和保真度报告
• 多页文档、页面设置、缩放、背景、元数据、文档设置，以及流/文件生命周期
• 矩形、椭圆、菱形、三角形、标注、自定义/母版几何图形、分组和形状复制
• 连接线、连接点、箭头、路由、线条跨越、端点查询和拓扑检查
• 形状文本、文本样式、填充、线条、主题、样式表、形状数据、超链接、评论和保护
• 图层、容器、背景页、页面实例，以及流畅的选择/查询辅助功能
• 内置和学习所得的母版、模具配置、母版编辑、替换，以及迁移计划/产物
• 流程图、块图、架构图、网络图、拓扑图、泳道图、组织结构图、时序图、时间线、依赖关系图和图形构建器
• 已加载图表的编辑、布局、选择、验证、包检查、桌面兼容性验证和视觉质量分析
• 无头导出单个页面为 PNG、JPEG、TIFF、无损 WebP 和 SVG，并支持整个文档的批量导出
• 通过 OfficeIMO.Visio.Pdf 转换为可搜索 PDF，并提供明确的语义回退诊断

依赖项： System.IO.Packaging 和 OfficeIMO.Core；VSDX 模型和渲染器由项目自主实现，PDF 转换则复用共享的 Reader/PDF 投影。

OfficeIMO.Invoicing

用于编写、解析和编辑类型化发票与贷项通知单，并进行有限范围的 CII/UBL 转换。所有数量、调整项、VAT 和应付总额均由同一套十进制计算负责。重写之前会报告不受支持的源数据。核心没有外部运行时依赖。

OfficeIMO.Invoicing.Validation 提供哈希固定的 XSD 和 Schematron 版本，涵盖所有五种 Factur-X 1.09.2 配置文件、EN 16931、XRechnung 和 UBL Peppol BIS，并附带固定版本的独立语料库证据。业务规则执行需要显式配置本地 Java/Saxon 运行时。OfficeIMO.Invoicing.Pdf 可渲染本地化或多语言布局，并通过 PdfInvoiceDocument 附加精确捕获的 XML。原生波兰 FA(3) 读取和有限范围的编写功能将国家声明与 EN 总额分开，并提供离线固定版本的架构验证器和官方样例。OfficeIMO.Invoicing.KSeF 负责令牌身份验证、加密在线提交、状态和 UPO 检索。提交引用、接受状态、回执绑定和回执架构结果彼此独立。

OfficeIMO.Pdf

• 创建 PDF，支持页面设置、富文本、TrueType/OpenType-CFF 子集化、受限的托管式阿拉伯语及塑形提供程序定位、多语言字体回退、词典连字符处理、混合内嵌视觉元素、类型化业务配方、页面感知组件、样式化多页容器、均衡分栏的块流、表格和图像
• 条件式且可重放的流、位置捕获、语义分节、生成的目录、命名目标、纲要和生成的可选内容图层
• 矢量绘图、图表场景、背景、页面装饰、页眉、首页/偶数页页脚、水印、元数据和查看器偏好设置
• AcroForm 创建、字段值、选择字段、外观生成、填充、扁平化和验证
• 批注、书签/纲要、命名目标、附件/关联文件、可选内容图层和结构化/带标签的输出
• 通过验证器验证精确成品，生成符合 PDF/A-2b、PDF/A-3b、PDF/UA-1、Factur-X 和 ZUGFeRD 标准的文件及证明；对于其他正式配置文件，提供失败即关闭的就绪状态分析
• 按页面/范围提取文本、感知布局的 Markdown、逻辑段落/标题/列表/表格、链接、表单、图像和导航
• 检查页面、边界框、字体、图像、附件、纲要、表单、操作、图层、标签、目录元数据、安全性、签名和修订版本
• 提取、拆分、合并、导入、裁剪、删除、复制、重新排序、移动、旋转以及叠加/衬垫完整源页面
• 编辑元数据、表单、批注、书签、附件和安全设置；盖印文本/图像并应用水印
• 搜索/应用/验证涂黑内容、净化、优化、OCR 接口和文档理解管道
• 标准和现代加密 PDF 的读写，以及签名变更和权限分析
• 在源结构允许时进行增量对象更新和仅追加式批注处理
• 将页面托管式渲染为 PNG、JPEG、TIFF、无损 WebP 和 SVG，并支持页面选择、像素/页面限制、功能诊断和出错后继续的批处理
• 由规范预检/规划器和生成的功能注册表提供支持的共享变更组合与渲染兼容性评估
• 有界流序列化，提供每次保存的峰值保留、溢出、缓冲和直通证据
• 精确嵌入 TrueType 轮廓，并在受支持时共享托管式 CMYK、Lab、XYZ 和校准颜色转换
• 为 PDF 转 Word、PDF 转 Excel、PDF 转 PowerPoint 和 PDF 转 RTF 适配器提供逻辑恢复
• 转换证明、视觉比较、外部验证器接口，以及关于警告、阻断项和结构偏移的重写保留报告

依赖项： 仅依赖 OfficeIMO.Core；不依赖第三方 PDF 解析器、编写器、渲染器、OCR 或加密库。仅在需要识别扫描页面并生成可搜索输出时安装 OfficeIMO.Pdf.Ocr；仅在需要其内置 CMS/X.509/RFC 3161 适配器时安装 OfficeIMO.Security。

OfficeIMO.Invoicing.Pdf

• 仅捕获一次类型化发票，即可生成可见 PDF 内容及其嵌入的 CII XML
• 渲染包含行项目、增值税明细、付款详情、标识符和总计的发票与贷项通知单
• 将后续模型编辑与现有快照分开
• 使用英语、德语、波兰语、法语或自定义多语言包本地化生成的标签
• 通过嵌入式字体回退和精确的 XML/PDF 一致性检查，保留包含多种文字的长描述

依赖项： OfficeIMO.Invoicing 和 OfficeIMO.Pdf。仅在需要将 XML 发票引擎与 PDF 生成结合使用时安装此可选适配器。

OfficeIMO.Pdf.Ocr

• 在有界渲染 PDF 页面上使用任意 IOcrEngine，无需 Reader 或提供方依赖
• 在源分辨率下识别独立栅格图像，并提供可复用的文本／表格重建和审阅快照，供可编辑格式适配器使用
• 将像素、点和归一化几何坐标投影到裁剪和旋转后的视觉 PDF 坐标中
• 过滤置信度和与原生文本的重叠内容，然后进入规范的语言中立 PDF 理解管道
• 输出可搜索的不可见文本，并提供逐页的提供方、模型、语言、单词、拒绝内容和诊断证据

依赖项： 仅需 OfficeIMO.Ocr 和 OfficeIMO.Pdf；提供方和原生运行时仍由应用显式选择。

OfficeIMO.Security

• 对分离式和封装式 CMS 签名进行签署与验证，支持有界解析和结构化发现结果
• RSA 和 ECDSA 验证、平台 X.509 证书链／吊销策略，以及 RFC 3161 时间戳验证
• 针对 S/MIME 接收方的 CMS EnvelopedData 加密／解密
• 为格式自有签名工作流提供有界 XML Digital Signature 创建、验证和规范化
• 使用平台 RSA 签名而不导出私钥，包括兼容 CNG/HSM 的密钥句柄
• 由调用方显式提供一个强类型提供方，供精简的格式包安全适配器使用

依赖项： OfficeIMO.Core 契约，以及 BouncyCastle.Cryptography 和 System.Security.Cryptography.Xml；不依赖 Word、PDF、Email 或其他格式包。格式包不依赖 Security。

格式包	无提供方时的安全支持	可选的提供方支持操作
OfficeIMO.Word	OPC/VBA 签名发现、证据报告和故障安全的修改策略	OPC XML 签名创建／验证，以及 VBA CMS／信任／时间戳验证
OfficeIMO.Pdf	签名字典、字节范围、外部签名方钩子、保留和修改策略	内置 CMS 签名、X.509 验证和 RFC 3161 处理
OfficeIMO.Email	MIME 解析、S/MIME 载体发现和受保护源内容保留	针对 RFC 5322/MIME 输出的 CMS 签名、加密、验证、解密和先签名后加密
OfficeIMO.Excel	OPC/VBA 签名检查和故障安全的修改策略	OPC/VBA 签名创建、验证和信任评估
OfficeIMO.PowerPoint	OPC、旧版和 VBA 签名检查，以及故障安全的修改策略	OPC/VBA 签名创建、验证和信任评估
OfficeIMO.Visio	OPC 签名检查和故障安全的修改策略	OPC 签名创建和验证
OfficeIMO.OpenDocument	第一方密码加密／解密、签名发现和故障安全的修改策略	有界 XML 包清单签名创建和验证
OfficeIMO.Epub	IDPF/Adobe 字体去混淆、签名发现和诊断	有界 XML 包清单签名创建和验证

仅在使用提供方支持操作的应用中安装 OfficeIMO.Security。因此，其加密依赖项不会改变普通格式使用方的还原依赖关系图、修剪根或 NativeAOT 表面。

OfficeIMO.OpenDocument

• 原生支持 ODT、ODS、ODP 和 ODG 的包及扁平 XML 加载、编辑、检查和确定性保存
• 支持 ODT 段落、标题、文本片段、样式、列表、表格、链接、书签、分节、页面布局、页眉/页脚、图像和修订
• 支持 ODS 稀疏/重复单元格、类型化值、公式、样式、合并、尺寸、可见性、名称、验证和打印范围
• 支持 ODP 幻灯片、母版/版式、文本、形状、组、图像、裁剪、表格、备注、背景、切换效果和基本动画元数据
• 支持 ODG 页面、组、基本形状、文本和图像编辑、FODG 转换，以及供共享导出器使用的绘图投影报告
• 保留未知 XML 和包部件，并提供明确的损失和功能报告
• 无依赖的 AES-256-CBC 密码加密/解密，具备有界的聚合 KDF 工作量，以及通过哈希固定的 LibreOffice 互操作证据

依赖项： 仅需 OfficeIMO.Core；无需 OpenDocument SDK，也无需 LibreOffice 运行时。

OfficeIMO.Publisher

将 Publisher 出版物原生恢复为定位页面、带样式的文本内容、表格单元格和嵌入式图像资源，并支持 SVG 导出和明确的保真度报告。OfficeIMO.Publisher.Pdf 通过共享绘图和 PDF 引擎添加多页 PDF 转换功能。支持合同列明了配置文件和渲染限制。读取器仅引用 OfficeIMO.Core，无需 Publisher。Reader 适配器保留完整文本内容、物理页面清单和图像描述符，以供语义导入使用。

OfficeIMO.Chm

读取已编译的 HTML Help，支持精确提取条目、主题、嵌入式资源、分层目录和关键字索引。可选的 Markdown、EPUB 和 PDF 适配器复用现有转换引擎，并提供保真度报告。Reader 导入保留存档哈希和主题引用。有关 ITSF/LZX 覆盖范围和导出限制，请参阅支持的配置文件。加载过程不会执行任何操作，也不需要 Windows 帮助查看器。

OfficeIMO.DjVu

以托管方式读取 DjVu 扫描书籍、存储的 UTF-8 文本和词语几何信息，支持有界页面渲染和源文档导航。OfficeIMO.DjVu.Pdf添加可搜索的扫描页面 PDF，并支持对缺失文本进行显式 OCR；OfficeIMO.Reader.DjVu将原生文档投影到 Reader。请参阅编解码器和独立认证合同。

OfficeIMO.Xps

可移植地读取 XPS/OpenXPS 包、编辑原生页面并写入文件，支持嵌入字体、路径、图像和明确的转换诊断。SVG 和光栅导出复用共享绘图引擎；OfficeIMO.Xps.Pdf添加矢量 PDF 导出功能。渲染和保留范围另行说明。OfficeIMO.Reader.Xps添加有界的 Unicode、逻辑顺序和页面导入功能。核心包仅引用 OfficeIMO.Core。

OfficeIMO.Rtf

• 有界 RTF 词法分析器和解析器，提供无损语法树，并可精确往返输出未更改的源内容
• 可编辑的语义模型，支持段落、文本运行、样式、列表、表格、节、页眉/页脚、注释、字段、图像、形状、对象、评论和修订
• 规范模式和保留模式写入，并提供结构化的解析器、绑定和转换诊断
• HTML 桥接，以及专用的 Markdown、PDF 和 Word 工作流适配器

依赖项： System.Text.Encoding.CodePages 和 OfficeIMO.Core；不依赖第三方 RTF 解析器。

OfficeIMO.Markdown

• 类型化 Markdown AST 和流式构建器，支持标题、段落、列表、任务、表格、代码、提示框、详情、定义、前置元数据、脚注、目录和语义围栏代码块
• 原生解析，支持源范围、锚点、稳定的块标识、转换和诊断
• HTML 片段/文档渲染，支持 CSS 配置文件以及可选的 Prism、Mermaid、图表和数学公式外壳资源
• 面向 AOT 的类型化选择器和 DTO 风格 AST 投影，适用于编辑器、聊天、转录和文档宿主

依赖项： 仅依赖 OfficeIMO.Core；Markdown 解析和写入均为一方实现。

OfficeIMO.Adf

• 无损 Atlas Document Format JSON 模型，保留未知节点、标记、属性和扩展属性
• 结构验证，以及带明确保真度诊断的 Markdown 和 HTML 投影
• 通过 OfficeIMO 现有的文档引擎导入 Markdown 和 HTML

依赖项： OfficeIMO Markdown、Markdown.Html 和 HTML；兼容目标还依赖 System.Text.Json；不依赖 Atlassian SDK。

OfficeIMO.Html.Core

• 自有 HTML 节点、属性、文档模式、源偏移量和独立的模板内容
• 不可变快照、独立编辑、稳定的节点 ID 和分离节点所有权
• 解析器、选择器/序列化和字符集契约，不依赖图形或浏览器

OfficeIMO.Html.AngleSharp

• 惰性的完整文档解析，支持源内容限制和协作式取消
• 在自有节点上进行选择和序列化，并在编辑过程中保留解析器的错误恢复行为
• 通过可替换的提供程序支持现有 Web 编码别名和代码页

OfficeIMO.Html

• 规范的 HtmlConversionDocument，统一管理 DOM、基础 URI、媒体、资源和 URL 策略
• 支持 CSS 的布局场景，可供 PNG、JPEG、TIFF、SVG、WebP、PDF 和 Office 适配器共享
• HTML 转 PDF，以及由 PDF 生成的分页图像，支持共享字体和页边距框
• 直接输出 PNG、JPEG、TIFF、SVG 和无损 WebP，并提供结构化诊断和有界的本地/远程资源加载
• 有界 CSS 数学运算、确定性的媒体偏好、调用方样式表、分页运行字符串、共享的 CSS/SVG 颜色解析、WOFF 1 和感知 Unicode 范围的字体选择
• 稳定的 HTML 契约，可供 Office、Markdown、Reader、PDF 和可选的跨格式桥接重复使用

依赖项： 一方实现的 Core、Html.Core、Html.AngleSharp 和 Pdf，以及 AngleSharp 和 AngleSharp.Css。Email、RTF 和 MHTML 仍是独立适配器。

OfficeIMO.Html.Rtf

• 语义化的 HTML 转 RTF 和 RTF 转 HTML，并提供结构化保真度诊断
• 保留现有的 OfficeIMO.Html 转换命名空间，同时明确软件包归属

依赖项： OfficeIMO.Core、OfficeIMO.Html 和 OfficeIMO.Rtf。

OfficeIMO.Mhtml

• 加载 MHTML/MHT，并通过 HTML 根节点选择实现确定性保存
• 通过共享的 HTML 资源策略解析 CID 和 Content-Location 资源

依赖项： OfficeIMO.Core、OfficeIMO.Html，以及用于 MIME 解析的 OfficeIMO.Email。

OfficeIMO.Email.Html

• 统一且安全的 HTML/RTF/文本正文选择约定，默认对不可信内容进行清理并阻止远程资源
• 通过有界的操作级读取解析 CID、Content-Location、绝对位置和文件名资源
• 由 OfficeIMO.Email.Image 和 OfficeIMO.Reader.Email 使用共享的预处理投影

依赖项范围： OfficeIMO.Email、OfficeIMO.Html 和 OfficeIMO.Html.Rtf；基础 Email 包不依赖 HTML。

OfficeIMO.Email.Image

• 通过 HTML 图像管线导出电子邮件正文，并提供纯文本和 RTF 回退
• 内嵌 MIME/CID 资源、页面选择、诊断信息和有界输出

依赖项范围： OfficeIMO.Core、OfficeIMO.Email、OfficeIMO.Email.Html 和 OfficeIMO.Html。

OfficeIMO.Mhtml.Pdf

• 将 MHTML 转换为 PDF，设有处理边界，支持内嵌 MIME 资源并提供组合诊断信息
• 提供一流的 PDF 文档、字节、流、路径、同步和异步结果路径

依赖项范围： OfficeIMO.Core、OfficeIMO.Mhtml、OfficeIMO.Html.Pdf 和 OfficeIMO.Pdf。

OfficeIMO.AsciiDoc

• 无依赖、保留源内容的 AsciiDoc 解析器、类型化树、语义模型和写入器
• 标题、段落、列表、定义、警示块、定界块、表格、图像、锚点、属性和 STEM 内容
• 保留原文和规范化输出模式，并提供源位置诊断信息
• 显式限制处理范围，并采用根目录约束的包含策略；解析过程绝不执行指令

依赖项范围： 仅依赖 OfficeIMO.Core；不需要 Asciidoctor 进程或解析器包。

OfficeIMO.Latex

• 保留源内容的解析器，支持范围受限的 LaTeX2e 互操作配置
• 词元、分组、命令、环境、注释、标题、列表、插图、表格、标签、引用、引文、定理和数学内容
• 精确写回未更改的源内容，并以可见形式保留未知命令和环境
• 可选择启用范围受限的扩展，用于安全的文档内简单宏

依赖项范围： 仅依赖 OfficeIMO.Core；不依赖 TeX 运行时、编译器或解析器。

OfficeIMO.Bibliography

• 与格式无关的引文键、条目类型、贡献者、日期、标识符、出版字段、关键词、注释和有序原生扩展
• 支持 BibTeX/BibLaTeX、CSL JSON、RIS、NBIB/MEDLINE 和 EndNote XML 的保留源内容读取、编辑、确定性写入和重新打开工作流
• 精确保留未更改的文本和已加载字节，并在编辑后安全保留同格式未知字段
• 跨格式转换报告，并严格拒绝近似转换或遗漏数据
• 有界的文件、流、文本、同步和异步 API，支持取消，并以非执行方式处理 XML/TeX

依赖项范围： 兼容目标平台依赖 System.Text.Json 和 System.Text.Encoding.CodePages；不依赖其他 OfficeIMO 包、Word、Open XML、TeX、EndNote、渲染或网络客户端。

OfficeIMO.Opml

• 支持创建、读取、编辑、验证、转换和确定性写入 OPML 1.0/2.0
• 嵌套大纲、订阅属性、限定扩展属性，以及精确保留未更改的源内容输出
• 明确限制大小、字符数、深度、大纲和属性数量，并禁用 DTD 处理

依赖项范围： 仅依赖 OfficeIMO.Core；不依赖外部解析器或运行时。

OfficeIMO.Project

• 创建、读取、编辑和验证 Microsoft Project XML，并支持保存时保留源内容
• 创建和编辑符合条件的 MPP/MPT 8、9、12 和 14 文件，支持文档模板、MPX 4 交换及经评估的格式转换
• 提供类型化任务、日历、资源、分配、基线、自定义字段和轻量级流式构建器
• 支持显式计算分配/进度/成本、资源调配、挣值、受限公式/查找，以及由调用方解析外部计划
• 提供可移植的项目视图和映射表；还可通过 OfficeIMO.Workflows 生成 PDF/HTML/图像报告及可编辑的 Office 报告
• 支持明确的输入限制、取消操作、稳定标识和损失评估

原生生成器配置文件、不透明记录保留、计划排程、旧版格式和渲染各自具有独立的操作边界。

依赖项： 仅依赖匹配的协调版本 OfficeIMO.Core；文件操作不依赖 COM、外部解析器或网络。

OfficeIMO.DocBook

• 创建、读取受限内容、编辑、验证、转换和写入 DocBook 4.5 和 5.2 文章/书籍
• 为元数据、章节、列表、表格、代码、链接、注释、媒体和索引提供类型化常见结构
• 无损保留扩展，并使用精确的架构标识符，但不声称可全面验证词汇表

依赖项： 仅依赖 OfficeIMO.Core；可识别外部架构，但运行时不会下载。

OfficeIMO.CSV

• 提供以表头/行作为一等对象的文档模型，支持文件、流、文本、内存和只进流式处理生命周期
• 支持单字符和多字符分隔符，以及区域性、编码、换行符、引号、转义、空白、注释和空值标记控制
• 支持重复/空白表头策略、W3C #Fields:、静态元数据列、行长度策略和自定义日期格式
• 支持读写 Gzip、deflate、Brotli 和 zlib CSV，并依据扩展名检测格式
• 支持添加/移除/转换列和行、筛选、排序、物化，以及区域性兼容的保存工作流
• 支持架构推断和验证，包括必需/可选的类型化列、默认值、转换委托和自定义规则
• 支持无需反射的类型化对象映射，适用于剪裁和对 NativeAOT 敏感的使用方
• 支持 DataTable、IDataReader/DbDataReader、类型化读取器、类 SQL/批量复制、可复用行、字段跨度和可信文本路径
• 支持有序且受限的并行行投影，并为解码文本提供基于 .NET 8 span 的瞬态记录路径
• 支持取消、进度、收集解析错误、引号规范化、字段/输入限制、字符串驻留和确定性诊断
• 支持电子表格公式注入转义，并为数据导入边界提供明确的畸形输入策略
• 提供跨库 BenchmarkDotNet 覆盖，并检查行数和负载，确保各测试路径不会因少读数据而占优

依赖项： 仅依赖 BCL 兼容性包；不依赖第三方 CSV 解析器

OfficeIMO.JavaScript.Assets

• 从同步或异步 JavaScript 行迭代器导出仅含值的表格型 XLSX 和 CSV
• 当前视图投影、多工作表、列样式、日期格式、冻结表头和自动筛选
• 平台原始 deflate 压缩，支持存储式 ZIP 回退、协作式让出执行、进度报告和取消
• CSV 公式防护，使用共享的 .NET/JavaScript 字节向量
• @evotecit/officeimo 下的严格 TypeScript 库，编译后的 ES 模块和生成的声明
• 公共 core、ZIP、XML、OPC、XLSX 和 CSV 子路径，可复用的样式注册表、自定义列写入器和包部件
• 内嵌 .NET 资源，使用内容哈希名称，并提供单文件/捆绑示例

依赖占用： 无 JavaScript 或第三方 .NET 运行时依赖。

OfficeIMO.Email

• 读取、创建、编辑和写入 MIME/EML 消息
• 原生 Outlook MSG/OFT/MAPI 模型，包含消息、模板、联系人、约会、任务、附件、收件人、属性和命名属性
• TNEF/winmail.dat 和 mbox 的读写，支持嵌套及嵌入项
• 独立的 iCalendar/ICS 和 vCard/VCF 读取、写入、变更、验证、无损扩展、重复规则、时间、联系人组及旧版语法支持
• RTF 和压缩 RTF 正文处理、MIME 兼容性、安全限制、诊断信息和包检查
• 跨单条消息、日历、联系人、存储及离线通讯簿的统一混合制品发现 API
• 结构化制品写入证据，涵盖保留/重新生成源的选择、附件生命周期、诊断代码和严格的损失处置
• 显式提供程序的 S/MIME 验证/解密，支持信任策略诊断，并按先解密后验证的顺序执行

Store API

• 完全托管的惰性 PST 和 OST 会话，支持有界页面缓存、选择性摘要、查询和显式读取项目
• 有界 Outlook for Mac OLM、单条 EMLX、统一 Mbox、惰性 Apple Mail 树、Maildir 和 EML/MIME 目录导入
• 使用通用的 OfficeIMO.Email.EmailDocument 投影，而非另一套消息或 Outlook 项目模型
• 可恢复的语义内容搜索、特殊文件夹角色、离线内容可用性和延迟读取的附件流
• 检查、有界 PST/OST 结构验证、孤立项发现、EML/MSG/OFT/TNEF 目录导出、流式 mbox 导出，以及原生 Maildir/EMLX 输出
• 托管式 Unicode PST 创建，支持文件夹、类型化项目、收件人、附件、嵌入消息、命名属性和多值 MAPI 属性
• 将 OST/PST/OLM/EMLX/Mbox/邮箱目录可恢复地转换为单独且经过验证的 PST，绑定源数据并包含项目来源信息及明确的部分结果策略
• 通过锁定、验证且可选备份的原子重写事务，变更现有 Unicode PST 文件夹/项目
• 可配置源、缓存、树、项目、附件、存档、XML、目录和递归限制，并提供结构化诊断信息

AddressBook API

• 有界 Outlook OAB 组件发现，支持 v4、显示模板以及旧版 v2/v3 角色检查
• 延迟枚举 v4 Full Details 条目和通讯组列表，支持动态架构并保留原始属性
• 在姓名、地址、组织、电话、邮政字段、备注和成员关系中进行精确偏移、可恢复的搜索
• 基于种子数据的 CRC、记录分帧和完整架构验证，支持进度报告、取消和明确的限制
• 使用共享的 EmailAddress、OutlookContact、MapiProperty 和诊断模型，而非重复定义目录基础类型

依赖项： System.Text.Encoding.CodePages，以及第一方 OfficeIMO Drawing 和 RTF。S/MIME 签名、加密、验证和解密可选使用 OfficeIMO.Security，不会通过传递依赖引入；无需安装 Outlook，也不需要原生库或第三方邮件、存储或 OAB 解析器。

OfficeIMO.OneNote

• 以托管方式读取、创建、编辑、保存并往返写入桌面版和经 FSSHTTP 编码的 .one 分区
• 原生 .onetoc2 笔记本层级结构，以及托管 Cabinet .onepkg 读写
• 页面/子页面、丰富内容、布局、OCR/媒体元数据、可编辑的原生墨迹/识别结果和结构化数学内容、冲突、版本、修订及不透明数据
• 共享 Drawing 画布，支持 PNG/JPEG/TIFF/SVG/WebP，以及保留位置的可视化 HTML/PDF 和语义转换路径
• 正确的半英寸图像几何尺寸、网页图片回退，以及保留未解析图像关系且不丢失信息
• 延迟加载资源、有界且抗损坏的解析、结构化诊断、合规的桌面版/FSSHTTP/手写内容测试样本、基准测试，以及 Microsoft OneNote 打开/编辑/保存/重新打开的互操作性验证

依赖项： 仅依赖第一方 OfficeIMO.Core；运行时不依赖任何第三方，也不需要 Microsoft Graph、GraphEssentialsX、COM、已安装的 OneNote 或商业 SDK。

OfficeIMO.Epub

• 解析 EPUB 容器、OPF 包、清单、脊柱、导航和 NCX
• 提取元数据和按脊柱顺序确定性排列的章节
• 提取 XHTML/XML 文本，并可选择保留原始 HTML
• 有界访问资源载荷，提供警告以及单资源/总量限制

依赖项： 仅依赖 OfficeIMO.Core；不使用第三方 EPUB 引擎。

OfficeIMO.Epub.Image

• 通过共享 HTML 渲染场景直接将章节导出为图像
• 保留 EPUB 资源，支持章节选择、连续或分页输出、取消、批处理预算和保真度策略
• 支持 PNG、JPEG、TIFF、无损 WebP 和 SVG，并采用与其他文档类型相同的结果、诊断、保存和进度约定

依赖项： 仅依赖第一方 OfficeIMO EPUB、HTML 和 Drawing 包；不需要浏览器或第二套 EPUB 引擎。

OfficeIMO.GoogleWorkspace

• 由应用管理的 OAuth/服务账号凭据抽象，并支持全网域委派
• 共享会话、安全感知的重试、超时、诊断、范围、标准化错误和故障分类
• Drive 文件夹、共享云端硬盘和现有文件的目标定位约定
• Docs、Sheets 和 Slides 转换器共享的保真度预检与转换报告

依赖项： System.Text.Json 和平台 HTTP/加密功能；不依赖 Google 客户端 SDK。

OfficeIMO.GoogleWorkspace.Drive

• 类型化文件、文件夹、元数据、功能、共享云端硬盘、复制/移动/删除和权限
• 导入/导出发现、下载/导出、分段/可恢复上传、进度和取消
• 评论/回复、修订、变更令牌，以及带清理报告的临时公开内容租约

依赖项范围： 仅需 OfficeIMO GoogleWorkspace，以及兼容性目标上的 System.Text.Json。

OfficeIMO.GoogleWorkspace.Auth.GoogleApis

• 可选的 GoogleCredential、UserCredential 和 ITokenAccess 适配器
• 使用 PKCE 的已安装应用授权
• 由应用负责的令牌存储边界；默认不会以明文持久化刷新令牌

依赖项范围： Google 身份验证库和 OfficeIMO GoogleWorkspace；核心包不需要此项。

OfficeIMO.GoogleWorkspace.Sync

• 消费用户和各共享云端硬盘的变更馈送，并独立推进检查点
• 最小化游标和稳定的身份/版本凭据，不存储文档内容
• 试运行、有损审批、冲突、取消以及项目级部分失败结果

依赖项范围： 仅需 OfficeIMO GoogleWorkspace 和 Drive。

转换与云端桥接

OfficeIMO.Confluence

• Confluence Cloud v2 页面读取、游标列表、创建、更新、试运行请求计划和乐观版本契约
• 附件列表/下载，以及不重试的上传/版本管理、取消、超时和由调用方负责的凭据
• ADF、Markdown、HTML 和存储格式转换，支持保真度报告和通过标记分隔的托管区段替换

依赖项范围： 仅需 OfficeIMO ADF 和 Markdown，以及平台 HTTP 和兼容性目标上的 System.Text.Json；不需要 Atlassian SDK。

OfficeIMO.Word.Html

• Word 转 HTML，以及 HTML 转可编辑 Word
• 标题、段落、样式、列表、表格、题注、链接、图像/SVG、表单控件、注释、批注、分节、页眉和页脚
• CSS、基础 URI、本地/远程资源策略、限制、语言元数据和转换诊断

依赖项范围： OfficeIMO Word、HTML 和 Drawing，以及 Word 已使用的 Open XML SDK；无需单独的转换引擎。

OfficeIMO.Word 中的其他旧版文字处理格式

• 用于 WordPerfect、WordStar、Ami Pro、Lotus Word Pro、Microsoft Works/Write 和部分 Word for DOS 配置文件的有界只读适配器
• 结构化或抢救式质量、明确的损失报告、惰性活动内容，以及常规可编辑的 WordDocument 输出
• 直接输出 DOCX 和纯文本，并通过现有 Word 转换器包输出 ODT、HTML、Markdown 和 PDF

依赖项范围： 已包含在 OfficeIMO.Word 中；无需单独的包、本机 Office 应用程序、进程执行或第三方解析器运行时。

OfficeIMO.Word.Markdown

• 将 Word 转换为适用于 GitHub 的 Markdown，支持标题、列表、任务、表格、图像、链接、代码和脚注
• 将类型化 Markdown AST 转换为可编辑的 Word
• 图像布局策略和选定的内联 HTML 格式保留

依赖项范围： 仅需 OfficeIMO Word、Markdown、HTML 和 Drawing 包。

OfficeIMO.Word.Pdf

• Word 转 PDF，支持分节、分栏、页眉/页脚、表格、链接、图像、形状、控件、注释和目录链接
• PDF 转可编辑 Word，恢复解析器支持的文本、标题、列表、表格、链接、目标位置、图像和表单占位符
• 按页码范围导入，并提供结构化的导出/导入保真度报告

_依赖项范围：_仅需 OfficeIMO Word、PDF 和 Drawing 包；无需浏览器、原生渲染器或商业 PDF SDK。

OfficeIMO.Word.OpenDocument

• Word 与 ODT 双向转换
• 正文块顺序、标题、格式、链接、列表、表格/合并单元格、嵌入式图像、页面布局、书签以及默认页眉/页脚
• 为近似转换、跳过和不支持的内容生成特性映射报告

_依赖项范围：_仅需 OfficeIMO Word 和 OpenDocument 包。

OfficeIMO.Word.Rtf

• RTF 转可编辑 Word，以及 Word 转语义化 RTF
• 段落、富文本片段、表格、图像、注释、分节、样式、编号、链接、书签、修订和批注
• 使用 Word 引擎执行邮件合并、查找/替换、字段更新、合并和比较工作流，并返回结果

_依赖项范围：_仅需 OfficeIMO Word 和 RTF 包。

OfficeIMO.Word.GoogleDocs

• 规划、创建、按标签页感知且可安全处理修订的替换、原生导入，以及通过 Drive 回退使用 DOCX
• 核心 Word 结构、链接、批注、由渲染器负责的回退方案，以及明确的不支持特性策略
• 特定格式的检查点/差异计划，以及 Drive 位置管理和结构化诊断信息

_依赖项范围：_需要 OfficeIMO Word 和 GoogleWorkspace，以及 System.Text.Json；无需 Google 客户端 SDK。

OfficeIMO.Excel.Csv

• CSV 与 Excel 双向转换
• 导入文件、流、解码后的文本和实例化的 CsvDocument
• 将工作表和区域导出为 CSV 文本、文件、流或 CsvDocument
• 提供规范的 CSV 解析、架构、压缩和写入选项，不重复实现解析器

_依赖项范围：_仅需 OfficeIMO Excel 和 CSV 包。

OfficeIMO.Excel 中的其他旧版电子表格格式

• 为 Lotus 1-2-3、Quattro Pro、Multiplan 和部分 Microsoft Works 电子表格配置文件提供有界只读适配器
• 结构化恢复 WK 记录，并明确报告数据抢救、缓存公式、名称、图表元数据和数据丢失情况
• 通过常规工作簿输出 XLSX，并通过现有 Excel 转换器包输出 ODS、CSV、HTML 和 PDF

_依赖项范围：_已包含在 OfficeIMO.Excel 中；无需单独安装包，宏、嵌入对象和外部连接均保持非活动状态。

OfficeIMO.Excel.Html

• Excel 与 HTML 语义化双向转换
• 工作表名称/可见性、已用区域、类型化值、公式、批注、合并单元格、图像和图表清单
• 可导入的语义化表格，以及表格跨距受限、用于视觉审查的 HTML

_依赖项范围：_仅需 OfficeIMO Excel、HTML 和 Drawing 包。

OfficeIMO.Excel.Pdf

• Excel 转 PDF，支持打印区域、页面设置、分页符、重复标题、页眉/页脚和图像
• 单元格显示值、数字格式、填充、字体、对齐方式、边框、合并单元格、链接、条件格式视觉效果、表格、工作表图像和图表快照
• 将 PDF 逻辑表格恢复为可编辑的 Excel 输出，并生成结构化转换报告

_依赖项范围：_仅需 OfficeIMO Excel、PDF 和 Drawing 包。

OfficeIMO.Excel.OpenDocument

• Excel 与 ODS 双向转换
• 工作表、类型化值、公式、链接、合并单元格、行列布局、名称和基本样式
• 有界稀疏扩展，以及针对跳过内容的功能映射报告

依赖项： 仅 OfficeIMO Excel 和 OpenDocument 包。

OfficeIMO.Excel.GoogleSheets

• 规划、创建、安全替换版本、原生/区域导入，以及 Drive XLSX 回退
• 公式策略、值批处理、样式、验证、筛选器、保护、条件规则、图表、数据透视表、大纲和表格（均在文档说明的支持级别内）
• 格式专用检查点/差异计划，以及 Drive 位置配置和结构化诊断

依赖项： OfficeIMO Excel 和 GoogleWorkspace，另加 System.Text.Json；不需要 Google 客户端 SDK。

OfficeIMO.PowerPoint.GoogleSlides

• 规划、创建、模板复制、安全替换修订版本、原生导入，以及 Drive PPTX 回退
• 可编辑文本、表格、图片、基本形状、背景、链接和演讲者备注
• 复杂内容采用由渲染器负责的整页回退，并提供明确的支持目录和差异计划

依赖项： OfficeIMO PowerPoint、GoogleWorkspace 和 Drive；兼容性目标框架另需 System.Text.Json；不需要 Google 客户端 SDK。

OfficeIMO.PowerPoint.Html

• PowerPoint 与 HTML 之间的语义化往返转换，生成的 PowerPoint 可编辑
• 幻灯片顺序/可见性、绘制顺序、几何形状、变换、备注、表格合并、图片和图表数据
• 可导入的语义化幻灯片，以及带有界表格跨距、用于视觉审阅的定位式 HTML

依赖项： 仅 OfficeIMO PowerPoint、HTML 和 Drawing 包。

OfficeIMO.PowerPoint.Pdf

• 幻灯片、备注页和讲义 PDF 配置
• 背景、文本框、超链接、图片、表格、图表和基本自动形状
• 共享视觉快照，用于生成忠实的 PDF、PNG/SVG 和审阅用 HTML，并提供转换诊断

依赖项： 仅 OfficeIMO PowerPoint、PDF 和 Drawing 包。

OfficeIMO.PowerPoint.OpenDocument

• PowerPoint 与 ODP 双向转换
• 幻灯片尺寸/顺序、隐藏幻灯片、文本、图片、表格/合并单元格、基本形状、背景、切换效果和备注
• 针对高级几何形状、图表、SmartArt、媒体、动画、母版和不支持的切换效果提供功能报告

依赖项： 仅 OfficeIMO PowerPoint 和 OpenDocument 包。

OfficeIMO.Visio.Pdf

• 面向文档的 ToPdf、ToPdfDocument 以及路径/流保存入口
• 通过共享 Reader 投影实现可搜索的图表文本和拓扑结构
• 提供明确的预览与语义回退诊断，不声称具备 Visio 原生渲染保真度

依赖项： OfficeIMO Visio、Reader.Visio、Reader.Pdf 和 PDF；转换行为仍由共享 Reader/PDF 管道负责。

OfficeIMO.OpenDocument.Odt.Pdf

• 通过 Word 语义引擎实现 ODT 与 PDF 双向工作流
• 路径、流、同步、异步及带结果的入口
• 结合 OpenDocument 功能映射和 PDF 转换诊断

依赖项： Word、Word OpenDocument、PDF 和原生 OpenDocument；不依赖 Excel 或 PowerPoint 技术栈。

OfficeIMO.OpenDocument.Ods.Pdf

• 通过 Excel 语义引擎实现 ODS 和 PDF 双向工作流
• 可编辑的检测表格恢复，并报告非表格页面内容的丢失情况
• 综合 OpenDocument 功能映射和 PDF 转换诊断

依赖范围： 仅依赖 Excel、Excel OpenDocument、PDF 和原生 OpenDocument；不依赖 Word 或 PowerPoint 技术栈。

OfficeIMO.OpenDocument.Odp.Pdf

• 通过 PowerPoint 语义引擎实现 ODP 和 PDF 双向工作流
• 默认重建视觉页面，并提供明确的可编辑表格模式
• 综合 OpenDocument 功能映射和 PDF 转换诊断

依赖范围： 仅依赖 PowerPoint、PowerPoint OpenDocument、PDF 和原生 OpenDocument；不依赖 Word 或 Excel 技术栈。目前的软件包依赖图中没有涵盖所有格式的总括包，也没有桥接专用的 Core 包。

OfficeIMO.Markdown.Html

• 将 HTML 转换为类型化 Markdown
• 支持标题、列表、引用、代码、表格、图表、详情、定义、链接、图片和选定的内联 HTML
• 支持 Base-URI 解析、视觉宿主提示以及自定义块级/内联转换器注册

依赖范围： 仅依赖 OfficeIMO HTML 和 Markdown 软件包；AngleSharp 仍独立保留在 OfficeIMO.Html 中。

OfficeIMO.Markdown.Pdf

• 将 Markdown 转换为 PDF，支持元数据、纲要、标题、富文本、链接、列表/任务、表格、代码、提示框、详情、定义、脚注和目录
• 支持共享视觉主题、Unicode/字体回退策略、页面装饰和结构化转换警告
• 通过一方维护的 Markdown、PDF 和 Drawing 引擎直接实现 Markdown 到 PDF 的工作流

依赖范围： 仅依赖 OfficeIMO Markdown、PDF 和 Drawing 软件包。

OfficeIMO.OneNote.Markdown

• 为 OneNote 层级结构、富文本、列表、表格、链接、资源、数学公式、冲突和版本历史提供共享语义投影
• 输出 Markdown 文本、UTF-8 字节和类型化的 MarkdownDoc
• 安全地规范化 RichEdit、控件和非字符内容，而不更改原生模型
• 对层级结构、相关页面和递归内容进行有界的循环、共享实例和深度验证

依赖范围： 仅依赖 OfficeIMO OneNote 和 Markdown；它是 Reader 以及语义 HTML/PDF 路径使用的唯一语义投影所有者。

OfficeIMO.OneNote.Html

• 支持独立 HTML 文档、可嵌入片段、字节、流以及同步/异步保存路径
• 通过共享的 OneNote 投影和一方维护的 Markdown HTML 渲染器进行离线渲染
• 基于共享 OneNote Drawing 画布，生成保留位置的响应式 SVG 页面 HTML，并可选提供辅助文本

依赖范围： OfficeIMO OneNote.Markdown、Markdown 和 Drawing。

OfficeIMO.OneNote.Pdf

• 支持 PDF 文档、字节、流以及同步/异步保存路径，并提供一方维护的转换诊断
• 通过共享的 Markdown 投影渲染 OneNote 层级结构和语义内容
• 基于共享 OneNote Drawing 画布生成保留位置的图像型 PDF 页面，栅格缩放比例可配置且有上限
• 默认支持多语言系统字体回退，并可明确选择不启用严格字体模式

依赖范围： OfficeIMO OneNote.Markdown、Markdown.Pdf、PDF 和 Drawing。

OfficeIMO.Html.Pdf

• PDF 到 HTML 的逻辑投影，并提供包含诊断信息的结果
• 支持定位式审阅 HTML，并明确限制字体、图片和页面外观

HTML 到 PDF 的转换以及 PDF 页面图像支持包含在 OfficeIMO.Html 中。

依赖范围： 仅依赖 OfficeIMO HTML、PDF 和 Drawing 软件包；不需要浏览器进程或原生 HTML 渲染器。

OfficeIMO.Html.Pdf.Browser

• 为实时网站、JavaScript 渲染的页面和浏览器布局提供显式 Chromium 捕获
• 由 HtmlTinkerX 负责生命周期、导航、就绪状态、身份验证和网络策略
• 提供标准 PdfDocumentConversionResult 输出，包含浏览器诊断，以及常用的 OfficeIMO 提取、检查、预检和修改 API

依赖范围： OfficeIMO Core、PDF 和 HtmlTinkerX。此可选包不会改变托管的 OfficeIMO.Html.Pdf 依赖关系图。

OfficeIMO.Workflows

• 提供有类型且有界的转换、PDF 健康检查、页面导出、组装、打印和跨格式溯源工作流
• 为溯源检查、综合评估和严格选择性移除提供规范的格式所有者路由
• 支持协作式取消、冲突策略、暂存后重新打开验证、原子发布和有界顺序批处理

依赖范围： 仅包含 OfficeIMO 第一方格式和转换包；不包含托管服务、浏览器进程、供应商检测器或捆绑的溯源可执行文件。

OfficeIMO.Workflows.IWork 增加可选的 Pages 转 Word、Numbers 转 Excel 以及 Keynote 转 PowerPoint ZIP/流路由，支持有类型的保真度证据、完整预览验收、源快照，以及相同的验证发布约定。它不会将 iWork 纳入默认工作流依赖关系图。

OfficeIMO.Tool

• 使用一个 officeimo 可执行文件，提供明确的 html、reader、markup、workflow、provenance、agent 和 mcp 命令类别
• 提供有界的 HTML/MHTML 转 PDF、文档提取、功能发现、Markup 验证、代码生成和 Office 导出
• 为文档和邮件存储提供精简的检查/搜索/获取操作，并为 Codex 和其他客户端提供本地 STDIO MCP 服务
• 提供共享的帮助、退出代码、打包、NativeAOT 和流约定，避免重复实现所属库中的文档逻辑

依赖范围： 第一方 HTML/PDF、Reader.All 和 Markup 导出器依赖关系图；不包含浏览器进程、托管提供商或独立转换引擎。

OfficeIMO.Rtf.Markdown

• 支持语义化的 RTF 转 Markdown 和 Markdown 转 RTF
• 支持丰富的行内格式、列表、表格、链接、图片、脚注和尾注
• 提供可见的扁平化/省略诊断和 RequireNoLoss() 工作流

依赖范围： 仅包含 OfficeIMO RTF、Markdown 和 Drawing 包。

OfficeIMO.Rtf.Pdf

• 支持 RTF 转 PDF，涵盖页面设置、分节、段落布局、制表位、列表、表格/合并单元格、图片、注释、批注以及首页/偶数页页眉和页脚
• 支持将 PDF 恢复为可编辑的 RTF，保留解析器支持的元数据、标题、列表、段落和分页
• 提供结构化转换警告，以及用于 WMF/EMF 栅格化的可选回调

依赖范围： 仅包含 OfficeIMO RTF、PDF 和 Drawing 包。

OfficeIMO.AsciiDoc.Markdown

• 支持 AsciiDoc 转有类型的 Markdown，以及 Markdown 转规范 AsciiDoc
• 支持行内格式、元数据、列表/定义、警示块、表格/跨列单元格、图片、代码元数据、锚点和 STEM 映射
• 为不具备安全等效表示的结构提供带源位置的诊断和显式回退

依赖范围： 仅包含 OfficeIMO AsciiDoc 和 Markdown 包。

OfficeIMO.AsciiDoc.Pdf

• 基于现有的可感知损失的 Markdown 投影，提供直接的 AsciiDoc 转 PDF 流程
• 提供原生解析器、语义投影和 PDF 诊断的综合结果
• 共享 Markdown PDF 资源、字体、布局、校验、流所有权和取消约定

依赖范围： 仅包含 OfficeIMO AsciiDoc.Markdown 和 Markdown.Pdf；不增加其他渲染器或外部依赖。

OfficeIMO.Latex.Markdown

• 有界配置的 LaTeX 到类型化 Markdown，以及 Markdown 到规范 LaTeX 的转换
• 前置元数据、标题、格式、链接、列表/定义、图、表格、定理、原文/代码和数学内容的传输
• 确定性转义/标签，以及对无法表示的 TeX 布局或包行为提供诊断信息

依赖范围： 仅依赖 OfficeIMO LaTeX 和 Markdown 包。

OfficeIMO.Latex.Pdf

• 基于现有的保留损失的 Markdown 投影，直接实现有界配置的 LaTeX 到 PDF 生命周期
• 集成原生解析器、语义投影和 PDF 诊断
• 明确说明数学内容、引文、包行为和源文件回退的限制，不执行 TeX

依赖范围： 仅依赖 OfficeIMO Latex.Markdown 和 Markdown.Pdf；不需要额外的渲染器或外部依赖。

统一读取器系列

OfficeIMO.Reader.Core

• 轻量依赖的契约、架构、路由、限制、处理器和不可变的实例级读取器
• 规范化的 Markdown/文本块、表格、视觉内容、资源、位置、哈希、元数据、诊断信息和丰富结果
• 显式注册处理器，提供稳定的能力清单和 OfficeIMO/Custom 来源
• 纯文本和未知负载回退，无需依赖格式引擎

依赖范围： 不依赖 OfficeIMO 格式引擎；仅在兼容目标上依赖 System.Text.Json。

OfficeIMO.Reader.All

• 仅用于组合的 AddAllOfficeIMOHandlers() 预设，适用于本地可选读取器格式
• 为各适配器单独配置选项，无需重复解析器、提供程序、模型或全局注册状态
• 明确排除 OCR 引擎和其他由宿主选择的外部进程
• 明确提供完整的本地托管依赖图，排除 OCR 引擎和外部提供程序

依赖范围： 选择性引入 OfficeIMO.Reader.* 适配器包；此预设本身不添加解析器或原生运行时。

OfficeIMO.Reader.AsciiDoc

• 注册 .adoc、.asciidoc 和 .asc
• 按块划分内容，并提供源文件行号、标题路径、表格、复合列表和类型化 Markdown 投影
• 提供解析器和转换警告，不重复实现原生 AsciiDoc 解析器

依赖范围： 仅依赖 OfficeIMO.Reader.Core、AsciiDoc 和 AsciiDoc.Markdown。

OfficeIMO.Reader.Csv

• 支持 CSV/TSV 的表格感知内容块，包含行位置和确定性标识符
• 支持路径/流输入、大小限制、可配置的内容块行数、表头和 Markdown 预览

依赖范围： 仅依赖 OfficeIMO.Reader.Core 和 CSV。

OfficeIMO.Reader.Dbf

• 通过 DbaClientX 编解码器处理有界 DBF/xBase 表格内容块
• 可选启用路径备忘录旁文件，提供物理记录位置和惰性的 Base64 二进制值
• 通过编解码器的类型化读取器和现有导出器转换为 CSV/XLSX

依赖范围： OfficeIMO.Reader.Core 和 DBAClientX.Dbf；不需要数据库驱动程序。

OfficeIMO.Reader.DocBook

• 专门注册 .dbk 和 .docbook，通用 .xml 仍由 Reader.Xml 处理
• 生成带有章节路径和配置文件警告的常见结构有界内容块

依赖范围： 仅依赖 OfficeIMO.Reader.Core 和 DocBook。

OfficeIMO.Reader.Email

• 一个适配器包，支持 EML、MSG/OFT、TNEF、Mbox/MBX、iCalendar、vCard、PST/OST/OLM/EMLX、邮箱目录和 OAB
• 专用 MHT/MHTML 注册，通过精简版 HTML Reader 投影归档资源
• 稳定的制品/存储区/文件夹/项目逻辑路径、类型化元数据、语义正文、附件、哈希和丰富结果
• 有界的选择性存储区和通讯录投影，提供清晰可见的截断提示，并支持选择性启用完整源哈希
• 嵌套附件仅委托给宿主配置的 Reader 处理程序

依赖项范围： OfficeIMO.Reader.Core、OfficeIMO.Email、OfficeIMO.Mhtml 和 OfficeIMO.Reader.Html；Store 和 AddressBook 不会增加 NuGet 依赖层。

OfficeIMO.Reader.Word

• 通过所属 Word 引擎提取 DOCX/DOCM 和旧版 DOC
• 可选的旧版 Word 处理程序，基于所属的 OfficeIMO.Word 导入器，不重复解析或转换
• 丰富的标题、表格、图片、元数据、诊断信息，以及支持密码的检测

依赖项范围： OfficeIMO.Reader.Core、OfficeIMO.Word 和 OfficeIMO.Core。

OfficeIMO.Reader.Excel

• 通过所属 Excel 引擎提取 XLSX/XLSM/XLSB 和旧版 XLS
• 可选的旧版电子表格处理程序，基于所属的 OfficeIMO.Excel 导入器，不重复解析或转换
• 丰富的工作簿、表格、图片、元数据和诊断信息投影，并支持密码

依赖项范围： OfficeIMO.Reader.Core、OfficeIMO.Excel 和 OfficeIMO.Core。

OfficeIMO.Reader.PowerPoint

• 通过所属 PowerPoint 引擎提取 PPTX/PPTM 和旧版 PPT/POT/PPS
• 幻灯片、备注、表格、图片、元数据和诊断信息投影，并支持密码

依赖项范围： OfficeIMO.Reader.Core 和 OfficeIMO.PowerPoint。

OfficeIMO.Reader.Publisher

完整提取原生 .pub 故事文本、项目符号标记和实体页面清单，并可选择保留嵌入的图片负载，同时明确指出语义投影中的损失。

依赖项范围： OfficeIMO.Reader.Core 和 OfficeIMO.Publisher。

OfficeIMO.Reader.Markdown

• 类型化 Markdown 解析，支持源代码跨度、标题路径、表格和受支持的可视代码围栏
• 确定性的有界分块，不依赖文档格式

依赖项范围： OfficeIMO.Reader.Core 和 OfficeIMO.Markdown。

OfficeIMO.Reader.Epub

• 按章节对齐的文本和 Markdown 分块，带有虚拟 EPUB 源路径
• 页面、HTML 块、表格、链接、表单、清单中的图片资源、元数据和解析器诊断信息
• 路径/流分发、非定位流、限制设置和传递的 EPUB 警告

依赖项范围： 仅包括 OfficeIMO.Reader.Core、Reader.Html 和 EPUB。

OfficeIMO.Reader.IWork

• 通过所属 iWork 源模型注册 Pages、Numbers 和 Keynote 包
• 包含文本、表格、链接、图片和诊断信息的逻辑文档、工作表和幻灯片页面
• 有界的表格投影，并可选择保留图片负载

依赖项范围： 仅包括 OfficeIMO.Reader.Core 和 OfficeIMO.IWork。

OfficeIMO.Reader.Html

• 将 HTML/HTM/XHTML 转换为 Markdown 分块，并按标题拆分
• 表格、图示、链接、表单、媒体视觉内容、元数据和有界的 data URI 资源
• 透传 HTML 配置、转换、转换器和视觉往返选项

依赖项范围： OfficeIMO.Reader.Core、OfficeIMO.Html 和 OfficeIMO.Markdown.Html；Email、RTF 和 MHTML 不属于 HTML Reader 依赖图。

OfficeIMO.Reader.Image

• 独立注册 PNG、JPEG、GIF、BMP、TIFF、SVG、EMF、WMF、ICO、PCX 和 WebP
• 在标头级别提取格式、尺寸、DPI、资源、视觉内容和 OCR 候选项
• 可选保留载荷，无需解码像素或执行 OCR

依赖项： OfficeIMO.Reader.Core 和 OfficeIMO.Core；不依赖像素解码或 OCR 包。

OfficeIMO.Reader.Json

• 将 JSON AST 遍历为路径／类型／值行
• 分块输出结构化内容，并可选择生成 Markdown 表格
• 路径／流分派及格式错误警告

依赖项： System.Text.Json 和 OfficeIMO.Reader.Core。

OfficeIMO.Reader.Latex

• 导入 .tex 文件，无需编译 TeX 或加载包
• 为标题、段落、列表、图、表、定理和数学内容生成带源位置的分块
• 对有界文档配置文件之外的内容提供可见的源代码回退和警告

依赖项： 仅依赖 OfficeIMO.Reader.Core、LaTeX 和 LaTeX.Markdown。

OfficeIMO.Reader.Notebook

• 有界地提取 Jupyter .ipynb 中的 Markdown、原始和代码单元格
• 文本、Markdown、流和错误输出均设有明确的数量与字符限制
• 确定性导入，不启动内核或执行单元格

依赖项： 仅依赖 OfficeIMO.Reader.Core；JSON 来自 Reader 既有的运行时依赖关系图。

OfficeIMO.Reader.Opml

• 注册 .opml 文件，每个嵌套大纲可生成一个或多个有界分块
• 稳定 ID、层级路径和 OPML 验证警告

依赖项： 仅依赖 OfficeIMO.Reader.Core 和 OPML。

OfficeIMO.Reader.OneNote

• 离线导入 .one、.onetoc2 和 .onepkg 路径／流，支持异步、不可寻址流、取消和输入限制
• 页面／子页面层级、分块、表格、链接、资源、元数据、冲突／版本计数、诊断信息、哈希值以及 Markdown／文本投影
• 默认仅处理当前内容；可显式选择处理冲突／版本／回收站内容，并提供未解析图像的元数据
• 在遍历分块、表格、资源、链接和元数据之前，验证完整图结构的投影
• 基于原生 OneNote 引擎和共享的 OneNote.Markdown 投影进行轻量注册

依赖项： 仅依赖 OfficeIMO.Reader.Core、OneNote 和 OneNote.Markdown。

OfficeIMO.Reader.OpenDocument

• 按段落、标题和表格对齐的 ODT 分块
• 有界的 ODS 工作表／表格分块，带有工作表和 A1 范围位置
• ODP 幻灯片分块，包含表格和可选的演讲者备注

依赖项： 仅依赖 OfficeIMO.Reader.Core 和 OpenDocument；不依赖 LibreOffice 运行时。

OfficeIMO.Ocr

• 与格式无关的 IOcrEngine、请求、结果、能力、几何信息、层级、置信度、来源和诊断信息契约
• 为光栅图像、页面、幻灯片、工作表图像及未来的源集成明确指定像素、点和归一化坐标单位
• 为应用自有的原生、托管或云端识别实现提供回调适配器

依赖项： 无；不依赖 Reader、PDF、进程、网络或原生运行时。

OfficeIMO.Ocr.Process

• 为调用方配置的 OCR 可执行文件提供版本化 JSON 请求／响应协议
• 无 Shell 的进程启动、隔离的请求目录、超时／输出边界以及进程树隔离
• 中立的 OCR 结果和诊断信息，并支持配置输入、输出和运行时限制

依赖项： OfficeIMO.Ocr；旧版目标框架还需 System.Text.Json；OCR 可执行文件由应用提供。

OfficeIMO.Ocr.Tesseract

• 为已安装的 Tesseract CLI 提供可选的 IOcrEngine
• 运行时、语言和版本发现；页面分割选项；以及 TSV 解析
• 为精选目录提供可选的不可变 tessdata_fast 配置，并验证长度和 SHA-256
• 提供带边界、归一化置信度、超时和结构化失败信息的词语/行跨度

依赖范围： OfficeIMO.Ocr.Process 加外部 Tesseract 安装；不包含捆绑的原生二进制文件或默认语言载荷。

OfficeIMO.Reader.Ocr

• 对模块化 Reader 适配器提供的图像候选执行有界、确定性的 OCR
• 候选项与资源/哈希验证、超时、并发控制、结果限制和诊断映射
• 原生加 OCR 的增强处理会保留每项中立的提供方结果及来源关联

依赖范围： 仅依赖 OfficeIMO.Ocr 和 OfficeIMO.Reader.Core；不依赖提供方、格式包、PDF 引擎、进程运行器、云 SDK 或原生运行时。

OfficeIMO.Reader.Pdf

• 提供按页面划分的文本和 Markdown 分块，包含逻辑表格以及置信度/诊断信号
• 元数据、大纲、链接、表单、注释、图层、附件、标签、安全/签名及被动操作摘要
• 在 PDF 解析器可恢复时提供图像占位符、视觉几何信息和类型化字段
• 将归一化文档投影为 PDF 的来源中立处理，明确页面、资源、链接和表单策略，并合并来源/PDF 证据

依赖范围： 仅依赖 OfficeIMO.Reader.Core、OfficeIMO.Core 和 OfficeIMO 第一方 PDF 引擎。

OfficeIMO.Reader.Rtf

• 段落、列表、表格、注释、页眉/页脚、对象、形状和图像分块
• 语义块、链接、字段、图像/对象资源、元数据以及结构化解析器/绑定器诊断
• 提供扁平化、省略和阻止的 RTF 功能的共享报告

依赖范围： 仅依赖 OfficeIMO.Reader.Core 和 OfficeIMO 第一方 RTF 引擎。

OfficeIMO.Reader.Subtitles

• 导入本地 SubRip（.srt）和 WebVTT（.vtt）
• 按来源顺序排列的提示分块，包含行位置和机器可读的时间元数据
• 有界提示解析，并可选择剥离标记；无需媒体或转录工具

依赖范围： 仅依赖 OfficeIMO.Reader.Core 和平台 API；不依赖音频编解码器、下载器或模型。

OfficeIMO.Reader.Visio

• 按页面提取 .vsdx、.vstx、.vssx、.vsdm、.vstm 和 .vssm，并正确处理无页面模板
• 页面、形状、连接线、超链接、形状数据表和预览元数据
• 提供点几何信息和逐页拓扑可视化，供图结构感知型使用方使用

依赖范围： 仅依赖 OfficeIMO.Reader.Core 和 Visio。

OfficeIMO.Reader.Web

• 通过现有 Reader 实例显式注入调用方提供的 HTTP(S) 传输
• 响应字节数、超时、主机、私有目标、元数据隐私和并发限制
• 复用现有处理程序和处理器，不隐式注册网络

依赖范围： 仅依赖 OfficeIMO.Reader.Core 和框架 System.Net.Http；不依赖 HTTP SDK、浏览器、进程、模型或提供方。

OfficeIMO.Reader.Xml

• 将元素/属性树遍历为路径行
• 分块结构化输出，并可选择生成 Markdown 表格
• 路径/流分派及格式错误输入警告

依赖范围： OfficeIMO.Reader.Core 加平台 XML API。

OfficeIMO.Reader.Yaml

• 将 YAML 表示遍历为路径／类型／值行
• 支持多文档流、分块输出和可选的 Markdown 表格
• 支持路径／流分派和格式错误警告

依赖项： YamlDotNet 和 OfficeIMO.Reader.Core。

OfficeIMO.Reader.Zip

• 安全枚举 ZIP 条目，并尽力将其提取为 Reader 分块
• 有界遍历嵌套归档，并支持不可定位流
• 对已拒绝、受限或处理失败的条目生成警告分块

依赖项： 仅 OfficeIMO.Reader.Core 和 Zip。

Markdown 渲染和 OfficeIMO Markup

OfficeIMO.MarkdownRenderer

• 为 Markdown 界面提供完整的浏览器／WebView HTML 外壳和正文片段
• 支持增量更新脚本和适合流式处理的输出
• 提供严格、可移植、精简、宽松和对话记录预设
• 支持 AST 转换、规范化、HTML 后处理和插件注册

依赖项： OfficeIMO Markdown／Markdown.Html 和 System.Text.Json；Mermaid、图表、数学公式和 Prism 支持保留在可选外壳资源中。

OfficeIMO.MarkdownRenderer.Wpf

• 承载 OfficeIMO Markdown 外壳的 WPF／WebView2 控件
• 支持预设、CSS 覆盖、渲染器选项、链接处理和剪贴板消息
• 支持预渲染的正文 HTML，并显式释放 WebView2 资源

依赖项： Microsoft WebView2 和 OfficeIMO MarkdownRenderer。

OfficeIMO.MarkdownRenderer.IntelligenceX

• 提供 IntelligenceX 对话记录和桌面外壳预设
• 提供对话记录视觉别名和兼容性转换
• 为渲染和 HTML 往返流程提供共享注册机制

依赖项： 仅 OfficeIMO MarkdownRenderer 和 Markdown.Html。

OfficeIMO.MarkdownRenderer.SamplePlugin

• 演示第三方风格的渲染器资源注册
• 演示 Markdown 文档转换和匹配的 HTML 往返提示
• 将特定产品的视觉样式保留在通用渲染器之外

依赖项： OfficeIMO MarkdownRenderer／Markdown.Html 和 System.Text.Json；这是一个示例包，不属于协调发布集。

OfficeIMO.Markup

• 受 Markdown 启发的语义创作模型，适用于演示文稿、文档和工作簿
• 支持 Front Matter、容器、幻灯片、分节、工作表、图表、Mermaid、范围、公式、表格、文本框、分栏和卡片
• 提供类型化验证和面向目标的属性，并由轻量 Office 导出器进行映射

依赖项： 仅 OfficeIMO Markdown 和 Drawing；此包目前不属于协调发布集。

OfficeIMO.Markup.Word

• 将标记语言中的标题、段落、列表、表格和图像导出为可编辑的 .docx
• 支持分页符、分节、页眉、页脚、目录指令和原生图表输出
• 根据标记语言输入路径解析相对资源

依赖项： 仅 OfficeIMO Markup、Word 和 Drawing；目前不属于协调发布集。

OfficeIMO.Markup.Excel

• 将工作表、范围、公式、表格和单元格样式导出为可编辑的 .xlsx
• 根据内嵌 CSV、范围或命名表创建仪表板图表
• 提供安全的工作簿默认设置、定义名称修复和验证控件

依赖项： 仅 OfficeIMO Markup 和 Excel；目前不属于协调发布集。

OfficeIMO.Markup.PowerPoint

• 将幻灯片、真实分节、文本、列表、表格、图片和背景导出为可编辑的 .pptx
• 原生渐变、叠加层、备注、切换效果和图表
• 可选：通过调用方安装的 Mermaid CLI 将 Mermaid 导出为图片

_依赖项：_仅依赖 OfficeIMO Markup、PowerPoint 和 Drawing；Mermaid CLI 为可选外部依赖。

OfficeIMO.Markup.VSCode

• 为 .omd 和 .office.md 提供语法高亮、代码片段、行内验证和实时预览
• 在编辑器中生成 C# 或 PowerShell，并导出 Word、Excel 和 PowerPoint
• 为 Windows、Linux 和 macOS 的 x64 与 arm64 提供捆绑的独立 CLI 构建版本

_依赖项：_VS Code 和捆绑的 officeimo markup 命令；Mermaid CLI 集成为可选项。

OfficeIMO.Examples

• 可运行的 Word、Excel、PowerPoint、Visio、OneNote、PDF、OpenDocument、Markdown、Markup、Reader 和转换示例
• 用于展示 PDF、演示文稿、OpenDocument 和 Visio 示例产物的专用开关
• 机器可读摘要和可浏览图库，便于查看生成的输出

_依赖项：_对所演示 OfficeIMO 库的项目引用；此可执行文档项目不是运行时包。

转换图

原生包是唯一可信来源。适配器包负责连接它们，不会创建第二套解析器或文档模型。

flowchart LR
    Word["Word: DOC/DOCX"] <--> HTML["HTML"]
    Word <--> Markdown["Markdown"]
    Word <--> RTF["RTF"]
    Word <--> ODT["OpenDocument: ODT"]
    Word -->|"layout export"| PDF["PDF"]
    PDF -->|"semantic recovery"| Word
    Excel["Excel: XLS/XLSX"] <--> HTML
    Excel <--> ODS["OpenDocument: ODS"]
    Excel -->|"layout export"| PDF
    PDF -->|"logical tables only"| Excel
    PowerPoint["PowerPoint: PPT/POT/PPS/PPTX"] <--> HTML
    PowerPoint <--> ODP["OpenDocument: ODP"]
    PowerPoint -->|"layout export"| PDF
    PDF -->|"editable objects, visual pages, hybrid, or tables"| PowerPoint
    OneNote["OneNote: ONE/ONETOC2/ONEPKG"] -->|"semantic adapter"| Markdown
    OneNote -->|"semantic adapter"| HTML
    OneNote -->|"semantic or visual adapter"| PDF
    OneNote -->|"visual projection"| DrawingCanvas["Drawing canvas"]
    EPUB["EPUB"] -->|"retained chapter HTML/resources"| HTML
    DrawingCanvas --> Images["PNG/JPEG/TIFF/SVG/WebP"]
    DrawingCanvas --> HTML
    DrawingCanvas --> PDF
    Markdown <--> HTML
    Markdown <--> RTF
    Markdown <--> AsciiDoc["AsciiDoc"]
    Markdown <--> Latex["LaTeX"]
    Markdown --> PDF
    AsciiDoc -->|"direct PDF adapter"| PDF
    Latex -->|"direct PDF adapter"| PDF
    HTML <--> RTF
    HTML --> PDF
    RTF -->|"layout export"| PDF
    PDF -->|"semantic recovery"| RTF

固定布局 PDF 导入必然是语义转换，无法做到视觉上的无损转换。返回结果的 API 会提供警告和功能报告，供应用决定接受、拒绝或审核转换结果。

安装

只安装应用所需的原生包和适配器。未指定版本的 dotnet add package 命令会选择当前稳定版 NuGet 发布版本。

dotnet add package OfficeIMO.Word
dotnet add package OfficeIMO.Word.Pdf

dotnet add package OfficeIMO.Excel
dotnet add package OfficeIMO.Excel.Html
dotnet add package OfficeIMO.Excel.Pdf

dotnet add package OfficeIMO.Epub
dotnet add package OfficeIMO.Epub.Image

dotnet add package OfficeIMO.Adf
dotnet add package OfficeIMO.Confluence

dotnet add package OfficeIMO.Reader.Pdf

# Add every Reader adapter only when a broad ingestion host genuinely needs all formats.
dotnet add package OfficeIMO.Reader.All

dotnet add package OfficeIMO.OneNote
dotnet add package OfficeIMO.OneNote.Markdown
dotnet add package OfficeIMO.OneNote.Html
dotnet add package OfficeIMO.OneNote.Pdf
dotnet add package OfficeIMO.Reader.OneNote

同一应用中的 OfficeIMO 包引用应使用相同的已发布版本。

使用 dotnet tool install --global OfficeIMO.Tool 安装统一 CLI。请参阅 OfficeIMO.Tool 指南，了解全局和存储库本地安装、常用命令及贡献者用法。

常见工作流

创建、重新打开并转换离线 OneNote 分区

using OfficeIMO.OneNote;
using OfficeIMO.OneNote.Html;
using OfficeIMO.OneNote.Markdown;
using OfficeIMO.OneNote.Pdf;

var section = new OneNoteSection { Name = "Planning" };
var page = new OneNotePage { Title = "Release" };
var paragraph = new OneNoteParagraph();
paragraph.Runs.Add(new OneNoteTextRun { Text = "Validate the packed artifact" });
page.DirectContent.Add(paragraph);
section.Pages.Add(page);

section.Save("Planning.one");
OneNoteSection reopened = OneNoteSectionReader.Read("Planning.one");
File.WriteAllText("Planning.md", reopened.ToMarkdown());
reopened.SaveAsHtml("Planning.html");
reopened.SaveAsPdf("Planning.pdf");
reopened.SaveAsVisualHtml("Planning-visual.html");
reopened.SaveAsVisualPdf("Planning-visual.pdf");
reopened.Pages[0].ToImage().AtDpi(144).AsPng().Save("Planning-page-1.png");

创建带有页面变体的 Word 文档

using OfficeIMO.Word;

using var document = WordDocument.Create("report.docx");
document.AddParagraph("Quarterly report").Style = WordParagraphStyles.Heading1;
document.AddParagraph("Created without Microsoft Office automation.");

document.HeaderDefaultOrCreate.AddParagraph("Internal");
document.HeaderFirstOrCreate.AddParagraph("Quarterly report");
document.FooterDefaultOrCreate.AddParagraph().AddPageNumber();
document.FooterEvenOrCreate.AddParagraph("Confidential — even page");

document.Save();
document.SaveAsPng("report-preview.png");

创建 Excel 报告并导出区域图片

using OfficeIMO.Excel;

using var workbook = ExcelDocument.Create("sales.xlsx");
var sheet = workbook.AddWorksheet("Sales");

sheet.CellValue(1, 1, "Product");
sheet.CellValue(1, 2, "Revenue");
sheet.CellValue(2, 1, "Alpha");
sheet.CellValue(2, 2, 120);
sheet.CellValue(3, 1, "Beta");
sheet.CellValue(3, 2, 92);
sheet.AddTable("A1:B3", hasHeader: true, name: "SalesTable", style: ExcelTableStyle.TableStyleMedium2);
sheet.AutoFitColumns();

workbook.Save();
sheet.Range("A1:B3").SaveAsSvg("sales-preview.svg");

将 Word 导出为 PDF 并附带转换依据

using OfficeIMO.Word;
using OfficeIMO.Word.Pdf;

using var document = WordDocument.Load("proposal.docx");
var result = document.SaveAsPdf("proposal.pdf");

foreach (var warning in result.Warnings) {
    Console.WriteLine(warning);
}

读取、拆分、合并和加盖印章的 PDF

using OfficeIMO.Pdf;

PdfDocument source = PdfDocument.Load("packet.pdf");
PdfDocumentReadResult firstPage = source.Read(new PdfReadOptions {
    PageSelection = PdfPageSelection.Parse("1")
});
string firstPageText = string.Join('\n', firstPage.Pages[0].TextBlocks.Select(block => block.Text));
source.Pages.Extract("1-3").Save("packet-summary.pdf");

PdfDocument.Load("packet.pdf")
    .MergeWith("appendix.pdf")
    .Pages.Delete("2")
    .Stamp.Text("Reviewed")
    .Save("packet-final.pdf");

PdfAnalysisReport health = PdfDocument
    .Load("packet-final.pdf")
    .Analyze();

Console.WriteLine($"Readable: {health.CanRead}; rewrite safe: {health.CanRewrite}");

提取规范化内容以供索引或 RAG 使用

using OfficeIMO.Reader;
using OfficeIMO.Reader.Pdf;
using OfficeIMO.Reader.Zip;

OfficeDocumentReader reader = new OfficeDocumentReaderBuilder()
    .AddPdfHandler()
    .AddZipHandler()
    .Build();

var chunks = reader.ReadFolder("KnowledgeBase",
    new ReaderFolderOptions {
        Recurse = true,
        MaxFiles = 500,
        DeterministicOrder = true
    },
    new ReaderOptions {
        MaxChars = 8_000,
        ComputeHashes = true
    }).ToList();

文档生命周期

OfficeIMO 在可变文档包中使用统一的术语：

意图	API
保存到关联的目标位置	Save() / SaveAsync()
保存并关联路径	Save(path) / SaveAsync(path)
仅写入一次到调用方拥有的流	Save(stream) / SaveAsync(stream)
写入副本而不更改关联的目标位置	SaveCopy(path) / SaveCopyAsync(path)
生成字节而不更改文档状态	ToBytes()
生成一个定位在起始位置的新流	ToStream()
在内存中转换	To{Format}() 或 To{Format}Result()
写入另一种格式	SaveAs{Format}() / SaveAs{Format}Async()

保存到调用方拥有的流不会替换文档关联的路径或源流。之后调用不带参数的 Save() 时，会使用现有关联项；如果文档没有关联项，则会抛出异常。调用方拥有的流会保持打开状态。可定位的输入流会恢复到原始位置。纯内存转换仍为同步操作；涉及实际 I/O 和远程资源解析时则使用异步 API。

目标框架和平台支持

大多数已发布的库以 netstandard2.0、net8.0 和 net10.0 为目标。许多库在 Windows 上构建时还会包含 net472。OfficeIMO.MarkdownRenderer.Wpf 还添加了 Windows 专用目标，而 Markup CLI 则以现代 .NET 为目标。请查看软件包 README 或项目文件，了解确切的目标框架矩阵。

• 不使用 COM 自动化
• 不要求安装 Microsoft Office、Excel、PowerPoint、Visio 或 LibreOffice
• 使用跨平台原生引擎和转换器，但明确仅限 Windows 的 WPF 托管除外
• OCR 和 Mermaid 渲染的可选外部工具由调用方控制

更多文档

• 文档索引
• OfficeIMO 路线图
• 示例
• 图像导出功能矩阵
• 文本格式支持矩阵
• PDF 当前状态
• PDF 转换支持矩阵
• HTML 渲染器支持矩阵
• Word/HTML 支持矩阵
• RTF 支持矩阵
• 电子邮件支持矩阵
• AsciiDoc 支持矩阵
• LaTeX 支持矩阵
• 来源追溯支持矩阵
• Markdown 兼容性矩阵
• OneNote 当前状态
• 迁移指南
• GitHub 版本发布