# Univer PDFs 简介

> Univer PDFs 提供浏览器端 PDF 查看器与编辑器，支持持久化文档数据、Facade API、导入导出、协作和打印。

- Human documentation: [https://docs.univer.ai/zh-CN/guides/pdfs](https://docs.univer.ai/zh-CN/guides/pdfs)

- Agent Markdown: [https://docs.univer.ai/zh-CN/guides/pdfs.md](https://docs.univer.ai/zh-CN/guides/pdfs.md)

- Requested language: `zh-CN`

- Content language: `zh-CN`

- Documentation version: `1.0.0-rc.0`

- Source: [pdfs/index.zh-CN.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/pdfs/index.zh-CN.mdx)

---

## Univer PDFs 是什么

Univer PDFs 是 Univer Office SDK 中的 PDF 产品。它将 PDF 表示为正式的 `UNIVER_PDF` 单元，保留导入的源文档，并将已接受的编辑存储在独立的持久化编辑层中。浏览器 UI 会将这两层渲染为一份连续文档。

Univer Office SDK 包含三个 SDK：[Web SDK](https://docs.univer.ai/zh-CN/guides/sheets.md) 提供嵌入式编辑器和无头内容处理能力，[Server SDK](https://docs.univer.ai/zh-CN/server.md) 提供协同与文件导入导出能力，[AI SDK](https://docs.univer.ai/zh-CN/ai.md) 提供 Agent 工作流能力。

当应用需要创建或打开 PDF、添加可编辑内容、保持导入 PDF 的保真度、协同修改、导出结果，或将当前文档交给浏览器打印流程时，可以使用 Univer PDFs。

> [!WARNING: 仅支持插件模式]
> PDF 目前没有预设包。请显式注册 PDF 模型、UI 以及可选的功能插件。

## 浏览器兼容性

Web SDK 的编译目标是 Chrome 88，但这并不意味着 Web SDK 能够完全支持所有主流环境。我们会尽力确保 Web SDK 在以下浏览器和 Node.js 环境中能够正常运行：

| Edge | Firefox | Chrome | Safari | Electron |
| ---- | ------- | ------ | ------ | -------- |
| >=88 | >=90    | >=88   | >=14.1 | >=12     |

> [!WARNING]
> Web SDK 依赖 `Intl.Segmenter`，如果你的浏览器或运行时环境暂不支持它，请先补充对应的 polyfill。我们推荐使用
> `@formatjs/intl-segmenter`。

如果遇到无法兼容的情况，请先借助对应的 polyfill 来解决，如果仍然无法解决，请[提交 issue](https://github.com/dream-num/univer/issues/new/choose)。

## Node.js 兼容性

> [!WARNING]
> 以下仅适用于在 Node.js 环境中运行 Web SDK 的情况，并不适用于那些基于 Node.js 使用构建工具在浏览器中运行 Web SDK 的情况。

Web SDK 可以在 Node.js 环境中运行，支持的版本为 v18.17.0 及之后的版本。

## 主要功能

* **PDF Unit 模型**：在 `IPdfUnitData` 中存储源文档、页面结构、资源和持久化编辑意图。
* **页面与元素操作**：支持页面导航和插入，以及可编辑的文本、列表、表格、图像、分隔线和批注。
* **浏览器工作台**：提供 PDF 页面渲染、缩略图、选择、编辑控件、剪贴板行为和检查器界面。
* **命令管线**：通过持久化命令和变更批次应用已接受的修改，使保存、撤销和重做共享同一模型。
* **Facade API**：通过 PDF、页面、元素和原生文本对象创建、查找、编辑和保存 PDF Unit。

## 如何使用这些文档

在屏幕的左侧是文档导航栏。文档页面按从基础到高级的顺序组织，你可以按照这个顺序循序渐进地了解 Web SDK，或者跳到你感兴趣的章节。你还可以在侧边栏的顶部切换 Univer PDFs 的文档。

屏幕的右侧是当前页面的大纲。如果你需要快速找到页面，可以使用顶部的搜索栏或搜索快捷键（Ctrl+K 或 Cmd+K）。

我们推荐从 [快速开始](https://docs.univer.ai/zh-CN/guides/pdfs/getting-started/installation.md) 出发了解 Web SDK。

## 前置知识

尽管我们已经尽力使得文档对新手也易于理解，但是我们必须假设你在开始阅读之前已经了解了一些基础知识，以便我们的文档可以专注于 Web SDK。

为了充分利用我们的文档，建议你对 JavaScript 及其生态系统有基本的了解。

如果你有兴趣在 Node.js 上运行 Web SDK，你还应该对 Node.js 有基本的了解。

如果你想尝试高级功能并部署 Univer Server，我们建议你对 Linux、Docker 和 Docker Compose（或 Kubernetes）有基本的了解。

## 扩展 Univer PDFs

在设计之初，Web SDK 就被设计为高度可扩展的，因此你可以根据自己的需求来定制它。

- [快速开始](https://docs.univer.ai/zh-CN/guides/pdfs/getting-started/installation.md)

- [许可证配置](https://docs.univer.ai/zh-CN/guides/license.md)

- [功能一览](https://docs.univer.ai/zh-CN/guides/pdfs/features/core.md)

- [API 参考](https://docs.univer.ai/zh-CN/reference/classes/univer.md)