Sign X PDF · 指南
基于浏览器的 PDF 工具如何工作
浏览器 PDF 工具可以在不把文档提交到应用服务器的情况下编辑文件。站点脚本与资源加载后，所选 PDF 通过浏览器文件 API 读取，并用客户端库（有时加上 WebAssembly）在标签页内处理。Sign X PDF 的签署、合并、压缩、重排与删页流程即建立在这一模式上。
说明反映 Sign X PDF 预期的浏览器架构。功能与网络行为请按您的威胁模型在实际站点上核实。
本地处理 ≠「完全没有网络」
本地文档处理是指：您选择的 PDF 字节不会作为工具流程的一部分，被上传到 Sign X PDF 服务器进行转换或存储。这并不表示浏览器从不使用网络。
与任何网站一样，打开应用时仍会下载 HTML、JavaScript、字体、图片与 WASM 二进制。完成暖加载后，编辑主要依赖这些已获取的资源以及您的本地文件。
打开 PDF 时会发生什么
您通过浏览器文件选择器或拖放选择文件。页面获得 File（或 Blob）引用，并将其读入内存（例如 ArrayBuffer）。渲染与编辑在页面或 Worker 中对该内存副本进行，而不是对服务器上的文档副本进行。
- 输入：浏览器 File / Blob API
- 预览：客户端 PDF 渲染（pdf.js 类流程）
- 编辑：客户端库重写或重组 PDF 结构
- 输出：将新文件下载到您的设备
Sign X PDF 中的库与角色
Sign X PDF 将重型引擎拆分，使爬虫与首次绘制不必加载完整 PDF 运行时。工具页是预渲染的 HTML 外壳；您使用工具时，交互式编辑器才以客户端 island 形式加载。
- pdf.js — 浏览器内页面渲染 / 预览
- pdf-lib — 多项组装与导出操作（JavaScript）
- QPDF（WebAssembly）— 部分密码与结构保留操作（经 Worker）
- 签名板 / 图像工具 — 创建可见签名素材后再放置
Worker 与 WebAssembly
部分工作在 Web Worker 中运行，以保持界面线程响应。QPDF 被编译为 WebAssembly 并作为资源加载；下载后在浏览器进程中执行，而不是作为远程 PDF 服务。
因为 WASM 与 worker 脚本是普通静态资源，它们会出现在网络面板中，这是预期行为，与把机密 PDF 上传到 API 端点不同。
如何自行核查隐私声明
打开浏览器开发者工具，在打开并导出带独特文件名的测试 PDF 时观察网络面板，确认文档没有被提交到 Sign X PDF 应用端点。Sign X PDF 维护自动化隐私检查，对可疑请求模式（包括测试环境中的部分 beacon、WebSocket 与 service worker 流量情形）采取失败即关闭策略。
第三方浏览器扩展、操作系统服务或未来功能仍可能改变本应用控制范围之外的网络行为——若威胁模型严格，请务必自行复核。
实际限制
客户端处理受设备内存与 CPU 限制。极大的扫描件、同时打开多个文件，或内存较低的手机可能变慢或失败。受密码保护的 PDF 在合并或编辑前可能需要打开密码。压缩质量取决于内容（图像型 PDF 与文字型 PDF 表现不同）。
我们如何验证
隐私网络 e2e（Playwright）
Result: 签署／合并导出测试中，未观察到 PDF 文档字节上传到应用上传端点
Scope: CI／本地浏览器套件中的自动化 fixture PDF
Limits: 无法证明所有浏览器扩展或操作系统行为；也不单独覆盖第三方广告框架
Source: tests/e2e/privacy-no-upload.mjs
架构／客户端 island
Result: PDF 引擎在 SSR 外壳之后以客户端 island 加载；首页不预加载 pdf.worker 或 QPDF WASM
Scope: 构建时清单与代码分割回归测试
Limits: 清单度量的是构建产物，不是每一条运行时路径
Source: tests/build/performance-phase2.test.ts
常见问题
浏览器 PDF 工具会上传我的文件吗？
有些会。Sign X PDF 的设计是让所选 PDF 在浏览器中处理，而不是上传到 Sign X PDF 服务器进行工具处理。对任何处理机密文档的站点，请用网络工具自行核实其声明。
为什么仍会看到网络请求？
站点资源（HTML、JS、字体、WASM）会通过网络加载。本地处理指的是您的文档字节，不是网站本身零流量。
WebAssembly 在这里做什么？
QPDF 以 WebAssembly 形式分发，使高级 PDF 操作可在二进制下载后在设备上运行。它不是远程转换服务器。
这等同于离线模式吗？
不会自动等同。离线使用需要浏览器已缓存应用资源，且产品路径在暖加载后经过验证。在您自己的设备上测试之前，请勿假设飞行模式可用。