ONLYOFFICE Personal

ONLYOFFICE Personal 是一个完全运行在浏览器端的离线文档编辑解决方案。它利用 x2t.wasm 技术在客户端完成文档的解析、转换与渲染，无需部署 Document Server 或任何后端服务。用户只需打开一个静态 HTML 页面，即可在本地环境中直接编辑 Word、Excel、PPT 及 PDF 文件，所有数据全程保留在本地，不经过任何网络传输。

核心特性

• 纯静态与无服务器架构：整个应用由静态资源构成，可托管于任意静态服务器（如 Nginx、GitHub Pages）或直接集成到前端工程中。文档的打开、编辑、导出均在浏览器内存中完成，彻底杜绝了文件上传带来的隐私泄露风险。
• 广泛的格式支持：
  • 办公文档：完整支持 .docx、.xlsx、.pptx 及其对应的开放文档格式（ODF）。
  • 其他格式：支持 CSV 表格编辑。
  • PDF 处理：支持 PDF 文件的注释添加、表单填写以及基础的文本编辑功能。
• 本地存储与持久化：演示入口 office.html 集成了 IndexedDB，能够自动保存最近打开的文件记录，支持将编辑后的内容直接下载回本地磁盘。
• 易于集成：提供了一套基于 postMessage 的通信协议。开发者可以通过 iframe 嵌入 onlyoffice.html，实现文档流的注入与提取，轻松将其整合进现有的 Web 应用中。

技术实现

该项目基于 ONLYOFFICE 9.3 版本的编译产物构建。其核心突破在于将原本依赖后端的 x2t 文档转换引擎移植到了 WebAssembly (x2t.wasm) 上，使得复杂的二进制文档解析与生成逻辑能够在浏览器沙箱中高效执行。

快速开始

你可以通过以下几种方式在本地启动演示环境：

1. 使用 Python

python -m http.server 8000

2. 使用 Node.js

npx http-server -p 8000

3. 使用 PHP

php -S localhost:8000

启动后，在浏览器中访问 http://localhost:8000/office.html 即可体验新建文档、打开本地文件、编辑及保存等功能。

集成指南

若需将 ONLYOFFICE Personal 集成到自己的系统中，请遵循以下步骤：

1. 资源部署：将仓库中的 onlyoffice.html、产物目录（如 9.3.0.133-*）、assets/ 及 blank/ 文件夹放置在前端工程的静态资源目录下。
2. Iframe 嵌入：在主应用中通过 iframe 加载 onlyoffice.html。
3. 通信交互：
   • 注入文档：通过 postMessage 向 iframe 发送包含文档二进制流或网络链接的消息。
   • 提取结果：监听 iframe 发出的消息，获取编辑后的文件流。由于离线版没有传统的保存回调，需参考项目文档中关于从 x2t.downloadFile 提取字节流的说明。
4. 配置选项：支持通过 docConfig 进行详细配置，包括文件名重命名、另存为逻辑以及 Automation API 连接器等。项目还提供了一份 Vue 组件封装示例，方便主流框架用户快速上手。

适用场景

• 隐私敏感型应用：适用于医疗、法律、金融等对数据隐私有极高要求的行业，确保文档内容绝不离开用户设备。
• 离线工作环境：适合需要在无网络或弱网环境下进行文档处理的场景，如野外作业、航空航海等。
• 轻量级前端集成：对于不希望维护复杂后端文档服务的中后台系统，提供了一个即插即用的前端编辑能力。

ONLYOFFICE Personal 证明了现代 Web 技术已经具备处理复杂办公文档的能力，为构建安全、轻量且独立的在线办公工具提供了新的技术路径。