使用 Modify PDF Online – 在网页应用中直接注释、突出显示并使 PDF 可搜索：实用指南
如果您需要让用户在不离开浏览器的情况下对 PDF 内容进行注释、突出显示和搜索，Doconut 的 Modify PDF Online 功能正好满足此需求。它将完整的 PDF 查看器直接嵌入您的 .NET Web 应用，并提供用于审阅标记和 OCR 驱动搜索的服务器端 API——全部在一个安全组件中实现。
在接下来的章节中，我们将讨论整体架构、实现注释、突出显示和可搜索 OCR 所需的逻辑步骤，以及构建企业级解决方案的最佳实践模式。
为什么 Modify PDF Online 对企业 .NET 应用是改变游戏规则的利器
企业以文档为中心的解决方案——无论是 DMS、CRM 门户还是法律科技审阅平台——都必须满足三项相互竞争的需求：
- 用户体验 – 审阅者期望流畅的基于浏览器的 UI，感觉像桌面 PDF 编辑器。
- 安全与合规 – 文档通常包含机密数据，不能发送至第三方服务。
- 可扩展性 – 单个 API 调用可能需要在多个地区为数百名并发用户提供服务。
Doconut 通过一个在 服务器端 运行的库满足上述全部需求（因此文档永不离开您的基础设施），并向受支持的浏览器提供渲染内容。Modify PDF Online 功能基于同一渲染引擎，该引擎为 Doconut 的 Document Viewer Library 提供支持，确保 PDF、Office 文件和 CAD 图纸的像素级精确度。由于该功能内嵌于查看器，您可以在无需额外插件或外部服务的情况下添加、编辑和持久化注释。
对高级开发者和架构师的关键优势
| 优势 | 对您的解决方案的意义 |
|---|---|
| HTML5/JavaScript UI | 查看器在浏览器中运行，无需 ActiveX 或专有 PDF 插件。 |
| 受控打印 | 您可以直接在查看器界面中根据用户角色启用或禁用打印。 |
| 服务器端 OCR | 扫描的图像会转换为可搜索的文本，同时仍保留在您的数据中心内。 |
| 统一的 API 接口 | 相同的 Viewer 类负责打开、注释和搜索 PDF。 |
通过集中这些功能，您可以减少需要编写、维护和审计的自定义代码量——这对于医疗、金融和法律科技等受监管行业尤为重要。
在 Doconut 查看器中启用注释和高亮
当您启用 Modify PDF Online 时，Annotation Plugin 会自动可用。典型工作流包括四个逻辑步骤：
- 注册 Doconut 中间件 – 配置 ASP.NET Core 管道，使 Doconut 能够提供其静态资源（JavaScript、CSS、WebAssembly）并强制执行许可。
- 创建
Viewer实例 – 在作用域服务或控制器中实例化Viewer对象，传入诸如缓存和 HTTP 上下文访问器等所需服务。 - 打开 PDF 并获取文档令牌 – 调用查看器的文档打开方法，提供文件路径（或流）以及任何渲染选项（例如图像分辨率）。该方法返回唯一令牌，用于标识会话特定的文档。
- 使用注释管理器 – 获取要修改页面的注释管理器，添加高亮或评论对象，然后使用查看器的保存方法将生成的 XML 持久化回服务器。
前端只需使用令牌加载查看器并启用内置的注释工具栏。用户随后可以添加评论、绘制形状或放置印章，所有交互都会发送回同一 API 端点，使数据流保持简洁且可审计。
使用 Search Plugin 添加即时搜索和 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 相关事务。
- Per‑user token storage – 将文档令牌存储在与用户会话关联的安全缓存中（例如 Redis）。
- Permission checks – 在任何查看器操作之前执行业务规则检查。
- Stateless endpoints – 每个请求都包含令牌，允许服务水平扩展。
- Audit logging – 记录注释和搜索操作以满足合规报告需求。
结论
Doconut 的 Modify PDF Online 为您提供完整的服务器端 PDF 修改堆栈，涵盖注释、突出显示和 OCR 驱动的搜索——全部无需依赖第三方服务。遵循上述模式，您可以交付安全、高性能的 PDF 审阅体验，满足企业工作负载的可扩展性。
准备将强大的 PDF 编辑功能引入您的 .NET Web 应用吗？立即尝试 Doconut，看看您多快就能在浏览器中直接启用注释、突出显示和可搜索 PDF 功能。