GenOffice 详细部署与安装教程

GenOffice 是一款完全免费、开源的 AI 办公套件，可作为 Microsoft Office 的替代方案，支持编辑 Word (.docx)、Excel (.xlsx)、PowerPoint (.pptx)、PDF 和 Markdown 文件。本教程将涵盖直接安装使用和从源码构建开发环境两种方式，您可以根据需求选择。

📋 部署前准备

最终用户（直接安装）准备

  • 一台运行 macOS 11+、Windows 10+ 或 Linux 的电脑。
  • Linux 系统需注意：需要 glibc 2.34+（如 Ubuntu 22.04 或更新版本）。

开发者（从源码构建）准备

如果您想从源代码构建或参与开发，环境要求如下：

依赖项 最低版本 验证命令 用途说明
Node.js 22.12+ node -v 核心运行环境与 npm 工作区支持（版本硬性要求）
npm 10+ npm -v 包管理器
Rust 工具链 stable cargo --version 编译 Sheets 应用所需的 .xlsx 引擎附属程序
Git 2.x git --version 克隆仓库

🚀 方式一：直接安装使用（推荐大多数用户）

对于绝大多数用户，这是最简单、最快捷的方式。您可以从 GitHub Releases 页面下载对应系统的安装包。

1. 下载与安装

操作系统 下载文件类型 操作步骤
macOS (Apple Silicon) .dmg (arm64) 下载后双击挂载，将 GenOffice.app 拖入 Applications 文件夹即可
macOS (Intel) .dmg (x64) 同上
Windows .exe 安装程序 双击运行，按提示完成安装，安装后可在开始菜单找到
Linux (Debian/Ubuntu) .deb 包 使用 sudo apt install ./genoffice_<版本>_amd64.deb 安装
Linux (Fedora/RHEL) .rpm 包 使用 sudo dnf install ./genoffice-<版本>.x86_64.rpm 安装
Linux (通用发行版) .AppImage 赋予执行权限后直接运行：chmod +x GenOffice-<版本>.AppImage && ./GenOffice-<版本>.AppImage

2. 启动与配置

安装完成后，您可以直接启动 GenOffice。

  • 纯编辑功能：完全离线可用，无需登录或配置即可打开、编辑和保存本地文件。
  • AI 功能：需要网络连接。您可以选择两种方式：
    1. Genspark 账号登录：无需 API 密钥，登录后即可使用内置的 AI 代理（调用 Claude、GPT 等模型）。
    2. 自带密钥 (BYOK)：在 AI 设置中，填入您自己的 OpenAI、Claude、Gemini、DeepSeek 等服务的 API 密钥。

🛠️ 方式二：从源码构建与开发部署

如果您是开发者，希望修改代码或构建自定义版本，请参照以下步骤。

1. 克隆仓库与安装依赖

1
2
3
git clone https://github.com/genspark-ai/genoffice.git
cd genoffice
npm install  # 该命令会安装所有工作区的依赖[citation:5][citation:6]

注意：由于此仓库的提交历史较为特殊（通过压缩快照同步），外部贡献者的 PR 会被合并，但会在 GitHub 上显示为“已关闭”而非“已合并”。

2. 生成测试固件（可选）

如果您计划运行测试，需要先生成 .docx 测试文件：

1
npm run fixtures

3. 运行开发服务器

您可以通过以下命令启动所有或单个应用的开发环境：

  • 运行所有应用（Docs, Sheets, Slides, PDF, Markdown + Shell）：

    1
    npm run dev

    运行后，Shell 主界面默认在 http://localhost:5199 可访问，各编辑器位于不同端口（如 Docs 在 5173）。

  • 仅运行单个应用（例如，只开发 Docs）：

    1
    npm run dev:docs   # 同样模式适用于 :sheets, :slides 等

4. 运行测试与代码检查

在提交代码前，建议（且 CI 会强制）运行以下质量检查：

1
2
3
4
5
npm run format:check   # 检查代码格式 (Prettier)
npm run lint           # ESLint 检查 (必须 0 错误)
npm run typecheck      # TypeScript 类型检查 (tsc --noEmit)
npm test               # 运行所有单元测试（含 Rust 附属程序测试）
npm run licenses       # 检查生产依赖许可证合规性

5. 构建安装包

您可以在根目录执行以下命令，构建分发的安装包。注意：若无官方签名证书，构建出的产物将是未签名的版本。

1
2
3
npm run dist:mac     # 构建 macOS .dmg
npm run dist:win     # 构建 Windows .exe 安装程序
npm run dist:linux   # 构建 Linux 的 .AppImage, .deb 和 .rpm 包[citation:1]

针对 Linux 构建的特别说明：
项目通过 npm run dist:linux 命令统一构建 AppImage、deb 和 rpm 三种格式。AppImage 格式旨在解决不同 Linux 发行版的碎片化问题，因为它自带了所需的 glibc 运行时环境。

📝 常见问题

  • GenOffice 是免费的吗？
    是的。GenOffice 在 Apache-2.0 许可证下发布，完全免费且开源，没有试用期或付费层级。
  • AI 功能必须联网吗？
    是的。AI 代理、搜索、图像生成等功能需要网络连接。但基础的文档编辑功能完全离线工作，文件不会离开您的电脑。
  • 如何禁用使用统计？
    官方构建版本默认会发送有限的匿名使用数据，您可以在 设置 → 通用 中随时关闭此功能。
  • 能打开和保存微软 Office 格式吗？
    可以。GenOffice 原生支持打开和保存 .docx、.xlsx 和 .pptx 文件，并采用“字节级保真”策略——未修改的部分会原样保留，确保在 Microsoft Office 中打开时不会破坏版面。

通过以上任一方式，您都可以成功部署并使用 GenOffice。对于普通用户，推荐直接下载安装；对于希望深度定制或参与贡献的开发者，则可以选择从源码构建。