实战#办公套件

GenOffice 安装上手:从下载到让 AI 改你的 Word 文档

macOS 实测 GenOffice 全流程:下载验签、接本地模型、AI 生成修订 .docx、CLI 交给编码智能体,附三平台命令与翻车清单。

编辑部生成图:一扇敞开的门内透出暖光,门前的书桌上摊开一份文档,文档边缘正被几段发光的代码线条托起改写(编辑部生成图)

这篇教程结束时,你的电脑上会有三样东西:一个能原生读写 .docx、.xlsx、.pptx 的桌面办公套件;每个编辑器旁边一个可以接入自有模型(含本地模型)的 AI 智能体;以及一条能让 Claude Code、Codex、Cursor 直接创建和修改 Office 文件的 genoffice 命令行。全部免费,Apache-2.0 开源。以下步骤于 2026-10-11 在 Apple Silicon 的 macOS 上实测,版本 v0.11.505(2026-10-09 发布,三平台安装包均带签名);Windows 与 Linux 部分引用官方文档命令并单独标注。项目背景与十款平替的横向对比,见《Office 办公套件平替怎么选》。

要点

  • GenOffice v0.11.505 提供 macOS(Apple Silicon 与 Intel)、Windows(x64 与 ARM64)、Linux(deb/rpm/AppImage)签名安装包,系统门槛为 macOS 11+、Windows 10+、glibc 2.34+。
  • 在 macOS 实测自定义 OpenAI 兼容端点:填 Base URL 与密钥后点「Test connection」即通过,模型列表自动发现,密钥仅存本机。
  • 随应用安装的 genoffice 命令行实测可用:Markdown 转 .docx 中文内容往返完整,info 读回结构与标题,render 每页导出一张 PNG。

装完你会得到什么

系统要求先对表:macOS 11 及以上(Apple Silicon 与 Intel 双架构)、Windows 10/11(x64 与 ARM64)、Linux x86_64 且 glibc 2.34 及以上(Ubuntu 22.04、Fedora 35、RHEL 9 起步)。装好后是六个编辑器——文档、表格、幻灯片、PDF、Markdown、HTML——共用一个标签式主窗口,默认工作目录为 ~/Documents/GenOffice,所有打开、编辑、保存与格式转换都在本机完成,只有 AI 调用会出网。

AI 侧有三条路线,后面逐条展开:登录 Genspark 账号零配置;填任意一家预设供应商的密钥(Claude、OpenAI、Gemini、DeepSeek、GLM、Qwen、Kimi 等 26 家);或指向任意 OpenAI 兼容端点,本地推理服务也行。

三平台安装

macOS 安装实测

从 GitHub Releases 下载对应架构的 dmg(本机为 arm64,182MB),挂载、拷贝、验签一气呵成:

curl -L -o /tmp/GenOffice-0.11.505-arm64.dmg \
  https://github.com/genspark-ai/genoffice/releases/download/v0.11.505/GenOffice-0.11.505-arm64.dmg
hdiutil attach -nobrowse /tmp/GenOffice-0.11.505-arm64.dmg
cp -R "/Volumes/GenOffice 0.11.505-arm64/GenOffice.app" /Applications/
spctl -a -v /Applications/GenOffice.app
# 实测输出:accepted,source=Notarized Developer ID

装完占用约 518MB。首次启动会先看到三页欢迎引导(可点 Skip 跳过),随后可能弹出一个「要安装此 App 吗」的浏览器式对话框——这是应用内置更新通道的提示,点「取消」即可正常进入主界面,不影响任何功能。

首次启动:欢迎引导轮播与「要安装此 App 吗」对话框,点取消即可进入主界面

主界面左侧是最近文件、收藏与工作目录,中部「快速开始」列出六个 AI 编辑器与本地文件打开入口,底部搜索框对工作目录建全文索引(含中日韩分词)。

GenOffice 主界面:快速开始列出门类,左侧为工作目录与最近文件

Windows 与 Linux

Windows 下载 GenOfficeSetup-v0.11.505-x64.exe(ARM 设备取 arm64 版)双击安装,安装包带 DigiCert EV 签名。Linux 三种包型按发行版取用(以下为官方 README 给出的命令):

sudo apt install ./genoffice_0.11.505_amd64.deb     # Debian/Ubuntu
sudo dnf install ./genoffice-0.11.505.x86_64.rpm    # Fedora/RHEL
chmod +x GenOffice-0.11.505.AppImage && ./GenOffice-0.11.505.AppImage

AppImage 需要 FUSE 2 运行库(Ubuntu 24.04 的包名为 libfuse2t64)。

配置模型的三条路线

左下角「?」按钮进入设置,选「AI Model」。三条路线按省事程度排序:

路线一:登录 Genspark。 设置页顶部「Account」里点「Sign in with Genspark」,模型调用走 Genspark 代理(Claude、GPT、Gemini 家族),网页搜索、图片生成等云工具一并开通,代价是消耗 Genspark 额度。

路线二:预设供应商密钥。 Provider 下拉里选 26 家预设之一(Claude、OpenAI、Gemini、DeepSeek、Kimi、GLM、Qwen、Doubao、MiniMax、Grok、OpenRouter 等),粘贴密钥保存即用。注意网页搜索与图片生成是独立配置,在「AI Media & Search」页里另选 Serper、Tavily 等供应商。

路线三:自定义端点接本地模型(实测)。 Provider 选「Custom」,填名称、Base URL、API Key,模型下拉会自动列出该端点 /v1/models 返回的列表。本机测试把 Base URL 指向本地 OpenAI 兼容服务(http://127.0.0.1:8317/v1),38 个模型自动出现,选中 glm-5.3 后点「Test connection」,秒级返回 Connection OK。

AI Model 设置:Custom 端点实测,Base URL 指向本地服务,模型选 glm-5.3,Connection OK

三个细节:密钥只存本机(设置页明示);可以存多个端点随时切换(Endpoint 区的「Add endpoint」);「Max output tokens」默认 32768,思考型模型的推理过程会占用这份预算,嫌响应慢可以把数值调小或换非思考模型。

路线怎么选,看两件事。成本上,自带密钥就按 token 付费,先用小额度把常用供应商各试一轮再定主用哪家;轻度用户登录 Genspark 拿额度更省心。隐私上,涉及合同、财报这类不该出公司的文档,路线三是唯一全程可控的选项——端点在自己机器上,模型也在自己机器上。

让 AI 写第一份文档

主界面点「AI Docs」新建文档,右侧 AI 面板输入一句话需求,例如:

Draft a short project brief (under 200 words) for a 5-person team
migrating from Microsoft Office to an open-source office suite.
Include goal, scope, risks, timeline.

实测 glm-5.3 先进入数十秒的思考阶段(面板显示 Thinking),随后按标题层级一次成稿:目标、范围、风险、时间线四节,状态栏字数与页码同步更新,文件自动保存为 ~/Documents/GenOffice/ 下的真实 .docx,标签页标题也换成文档名。AI 回复下方挂着三个按钮:复制回复、重新生成、Roll back——每一轮 AI 操作都是一个可整体撤销的快照。

AI 生成的项目简报:四节结构完整,自动保存为真实 .docx,回复区带 Roll back 按钮

想让人工审阅更稳,先点亮 AI 面板输入框旁的「Track changes」,AI 的改动会以 Word 修订记录的形式落进文档,接受与否由你逐条决定。

让 AI 改现有文档

第二轮实测在同一份文档上继续下指令:

Add a short Budget section after Timeline with a small table
(item, cost, owner). Also fix the Goal line to mention GenOffice
instead of LibreOffice.

智能体分两步完成:先读文档结构,再在指定位置插入三列表格(软件、培训、应急三行合计 $800)、改写 Goal 行,并在回复里主动说明「Scope 一节仍写着 LibreOffice,需要的话我再改」。这种「报出自己没动哪里」的习惯,是它与传统查找替换工具拉开差距的地方。改完的 .docx 在 Word 里打开同样干净——保存时只重写被改动的块,其余字节原样写回。

第二轮指令:插入 Budget 表格、改写 Goal 行,AI 主动报告未触碰的段落

六个编辑器强在哪

编辑器一句话定位实测状态
文档 .docx修订式 AI 改稿,快照回滚本文实测
表格 .xlsxRust 引擎,AI 写活公式并引用单元格生成与结构实测,深度功能按官方文档
幻灯片 .pptx一句话生成整副幻灯片,画布逐页可改按官方文档与第三方评测
PDF页面内原地改字,本机转 Office 格式按官方文档
HTML设计简报先行,一句话生成单文件页面按官方文档
Markdown块编辑器,选段唤出 Ask AI按官方文档

一篇中文第三方实测评测(微信公众号文章,见文末来源)对幻灯片生成的评价是中等偏实用,对 HTML 页面生成的评价最高——这两个判断与官方演示的方向一致,重度使用前建议先用自己的素材各试一轮。

接给编码智能体

安装应用时 genoffice 命令行已自动链入 PATH(本机位于 ~/.local/bin/genoffice)。实测四条:

genoffice --version                     # 0.11.505
printf '# 笔记\n\n中文内容往返测试。\n' > note.md
genoffice convert note.md --to docx --out note.docx   # Markdown 转真实 .docx
genoffice info note.docx                # 读回块结构、标题、表格统计
genoffice render note.docx --out shots/ # 每页渲染一张 PNG 自检

convert 后的 .docx 用 info 读回:7 个块、1 个标题,中文逐字完整。给编码智能体装技能有两种方式:应用内 Settings → Integrations 会列出本机检测到的 Claude Code、Codex、Cursor 等并一键写入;或直接 npx skills add genspark-ai/genoffice。MCP 服务器则用一行命令注册进 Claude Code(官方口径):claude mcp add --transport stdio genoffice -- genoffice mcp,29 个工具覆盖创建、转换、读取、编辑与渲染。

常见翻车

  • 首启弹「要安装此 App 吗」:应用内置更新通道的提示,点取消即可,不必反复重装。
  • AI 面板没反应:先检查 Settings → AI Model 是否已保存可用模型,「Connection OK」是唯一可信信号;本地端点要带 /v1 后缀。
  • 思考型模型等太久:属于正常现象,推理在消耗输出预算;赶时间就换非思考模型或调小 Max output tokens。
  • 官方构建默认发送使用统计:设置里可以关闭;统计不包含文档内容、文件名与账号信息(官方隐私声明口径)。
  • 别拿它开关键任务文件:0.11.x 迭代密集,重要文档先备份或开启版本控制再让 AI 批量改。

往前一步

装好只是起点。想看它与 LibreOffice、OnlyOffice、WPS 免费版的同台对比与按人选型,读《Office 办公套件平替怎么选》;项目动态与更新跟踪见 GenOffice 条目。手上有重复性文档活(批量改合同、按数据出报告)的读者,可以把「接给编码智能体」一节再读一遍——CLI 与 MCP 才是这套工具放长线的部分。