使用 Modify PDF Online – 在网页应用中直接注释、突出显示并使 PDF 可搜索：实用指南
如果您需要让用户在不离开浏览器的情况下对 PDF 内容进行注释、突出显示和搜索，Doconut 的 Modify PDF Online 功能正好满足此需求。它将功能完整的 PDF 查看器直接嵌入您的 .NET 网页应用，并提供服务器端 API 用于审阅标记和基于 OCR 的搜索——全部在单一安全组件中完成。
在接下来的章节中，我们将讨论整体架构、启用注释、突出显示和可搜索 OCR 所需的逻辑步骤，以及构建企业级解决方案的最佳实践模式。
为什么 Modify PDF Online 对企业 .NET 应用是颠覆性技术
面向文档的企业解决方案——无论是 DMS、CRM 门户，还是法律技术审阅平台——都必须满足三项相互竞争的需求：
- 用户体验 – 审阅者期待流畅的浏览器 UI，感觉就像桌面 PDF 编辑器。
- 安全与合规 – 文档常包含机密数据，不能发送到第三方服务。
- 可扩展性 – 单个 API 调用可能需要为数百名并发用户在多个地区提供服务。
Doconut 通过一个在 服务器端 运行的库同时满足上述三点（因此文档永远不离开您的基础设施），并将渲染内容交付给受支持的网页浏览器。Modify PDF Online 功能基于同一渲染引擎——该引擎为 Doconut 的 文档查看器库 提供支持，确保 PDF、Office 文件和 CAD 图纸的像素级精确呈现。由于该功能内嵌在查看器中，您可以在无需额外插件或外部服务的情况下添加、编辑并持久化注释。
对高级开发者和架构师的关键优势
| 优势 | 对您的解决方案意味着什么 |
|---|---|
| HTML5/JavaScript 用户界面 | 查看器在浏览器中运行，无需 ActiveX 或专有 PDF 插件。 |
| 受控打印 | 可以直接在查看器界面中根据用户角色启用或禁用打印。 |
| 服务器端 OCR | 扫描图像在保持在您数据中心内部的同时转换为可搜索文本。 |
| 统一的 API 接口 | 同一个 Viewer 类负责打开、注释和搜索 PDF。 |
通过集中这些能力，您可以减少需要编写、维护和审计的自定义代码量——这对医疗、金融和法律技术等受监管行业尤为重要。
在 Doconut 查看器中启用注释和高亮
Annotation Plugin 在启用 Modify PDF Online 时会自动可用。典型工作流包括四个逻辑步骤：
- 注册 Doconut 中间件 – 配置 ASP.NET Core 管道，使 Doconut 能够提供其静态资源（JavaScript、CSS、WebAssembly）并强制执行许可证。
- 创建
Viewer实例 – 在作用域服务或控制器中实例化Viewer对象，传入诸如缓存和 HTTP 上下文访问器等所需服务。 - 打开 PDF 并获取文档令牌 – 调用查看器的文档打开方法，提供文件路径（或流）以及渲染选项（例如图像分辨率）。该方法返回唯一令牌，用于标识会话专属的文档。
- 使用注释管理器 – 获取要修改页面的注释管理器，添加高亮或评论对象，然后使用查看器的保存方法将生成的 XML 持久化回服务器。
前端只需使用令牌加载查看器并启用内置的注释工具栏。用户随后可以添加评论、绘制形状或放置印章，所有交互都会回传到同一 API 端点，保持数据流简洁且易于审计。
使用搜索插件添加即时搜索和 OCR
可搜索的 PDF 对任何知识密集型门户都是必不可少的。Doconut 的 Search Plugin 与 Modify PDF Online 紧密协作。文档打开时，查看器会自动索引其文本层；如果文件是扫描图像，服务器端 OCR 引擎会先运行，将光栅图像转换为可搜索文本。
要向客户端公开搜索功能，通常需要：
- 在文档打开时启用 OCR – 在 PDF 配置中设置相应标志，使 OCR 引擎处理扫描页。
- 暴露搜索端点 – 实现轻量级 API 方法，接收令牌和查询字符串，将请求转发给查看器的搜索例程，并返回匹配的页码和高亮坐标。
- 在 UI 中显示结果 – 查看器会自动高亮匹配项；前端可以提供前后翻页控制，而无需完整页面重新加载。
由于注释以 XML 形式存储，搜索高亮可以干净地叠加在已有标记之上，为审阅者在添加评论时提供完整上下文。
将 Modify PDF Online 集成到安全的 API 层
企业通常通过位于身份验证、基于角色的访问控制和审计日志之后的 RESTful API 暴露文档功能。Doconut 的设计使这种集成变得直接：每个操作（打开、注释、搜索、打印）都是对 Viewer 对象的单一方法调用，库原生支持 IDistributedCache 和 IHttpContextAccessor。
推荐的做法是将所有查看器交互封装在 DocumentService 类中。该服务负责验证调用者权限、打开文档、添加高亮、执行 OCR 支持的搜索并返回结果。控制器只调用服务方法，使控制器代码保持轻量，专注于 HTTP 关注点。
实现安全、可扩展方案的关键要点：
- 按用户存储令牌 – 将文档令牌存入安全缓存（如 Redis），并与用户会话关联。
- 权限检查 – 在任何查看器操作之前强制业务规则。
- 无状态端点 – 每个请求都携带令牌，便于水平扩展服务。
- 审计日志 – 记录注释和搜索操作，以满足合规报告需求。
结论
Doconut 的 Modify PDF Online 为您提供了完整的服务器端 PDF 修改堆栈，涵盖注释、突出显示和基于 OCR 的搜索——全部无需依赖第三方服务。遵循上述模式，您即可交付安全、高性能的 PDF 审阅体验，轻松支撑企业级工作负载。
准备好将强大的 PDF 编辑功能引入您的 .NET 网页应用了吗？立即尝试 Doconut，看看如何快速在浏览器中直接启用注释、突出显示和可搜索的 PDF 能力。