ZIZIYI Office:本地优先的浏览器端 Office 文档预览与编辑方案
ZIZIYI Office(仓库 baotlake/office-website)是一个基于 Web 的 Office 文档预览与编辑应用,支持在浏览器中打开和编辑 .docx、.xlsx、.pptx 文件。项目以“本地优先”为核心理念,文件在浏览器本地处理,不上传数据,并使用 IndexedDB 做本地文件管理。技术栈为 Next.js 15+、Zustand、Radix UI、Lucide Icons、idb,底层借助 ONLYOFFICE x2t WASM 实现浏览器内文档转换,部署于 Cloudflare Pages,采用 AGPL v3 许可证。
社区作者 · zZz
它解决什么问题
ZIZIYI Office 定位为一套现代化的、本地优先(local-first)的 Office 文档预览与编辑解决方案,目标是在浏览器中直接提供接近桌面级的 Word、Excel、PowerPoint 编辑体验,同时保证文档的私密与安全。项目提供在线体验入口:全球节点 office.ziziyi.com(部署在 Cloudflare Pages,推荐亚太以外用户使用),以及亚太优化节点 o.ziziyi.com(部署在 EdgeOne,域名更短易记,面向中国、日本、新加坡等亚太地区用户访问更快)。
页面还提供快速创建入口:Word、Excel、PowerPoint。
核心特性包括:多格式支持,可打开和编辑 .docx、.xlsx、.pptx 文件;本地优先,文件在浏览器本地处理以保障数据隐私;基于 Next.js 15+ 构建,强调快速与响应;集成较丰富的编辑工具能力;使用 IndexedDB 实现本地文件持久化存储;通过 Uppy 实现云盘文件选择集成(Google Drive、Dropbox、OneDrive)。
技术栈方面:框架为 Next.js,状态管理为 Zustand,UI 组件使用 Radix UI 与 Lucide Icons,数据库为 IndexedDB(通过 idb),部署平台为 Cloudflare Pages。项目在致谢中说明其实现依赖于 ONLYOFFICE Web Apps、OnlyOffice x2t WASM(浏览器内高性能文档转换)、ONLYOFFICE SDKJS 以及 Office Converters 等开源项目。
适用对象:需要在浏览器内查看与编辑 Office 文档、且对数据不外传有要求的个人与团队;希望自建或二次开发私有 Office 在线编辑能力的开发者;关注 WebAssembly 文档转换与本地优先架构的前端工程师。需要注意,来源未说明后端协同、账号体系、版本历史等能力,相关能力待核验。
— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
准备环境:
- 安装 Node.js 22 或更高版本。
- 安装 pnpm(推荐使用的包管理器)。
安装步骤(按顺序执行):
- 克隆仓库:
git clone <repository-url>cd website说明:来源中仓库地址以占位符 <repository-url> 给出,实际克隆地址请根据仓库页面的 Clone 按钮获取(对应仓库为 baotlake/office-website)。
- 安装依赖:
pnpm install- 启动开发服务器:
pnpm dev- 首次运行:在浏览器中打开 http://localhost:3000 即可访问应用。
部署(项目已针对 Cloudflare Pages 配置):
生产构建:
pnpm build部署到生产环境:
pnpm deploy部署预览环境:
pnpm deploy:preview常见问题与提示:
若 pnpm 未安装,需先完成 pnpm 的全局安装再执行
pnpm install。
- Node.js 版本低于 22 可能导致安装或构建失败,请先升级版本。
- 仓库克隆后需进入 website 目录再执行安装与启动命令。
- 部署命令依赖 Cloudflare Pages 配置,需具备对应的账号与项目配置后方可生效;具体配置项来源未说明,待核验。
- 页面中未提供 Docker、离线包等其他安装方式。
配图 1 为项目 logo(Office App Logo),可用于在本地部署后确认应用标识是否正常加载。