GenOffice：免费开源的 AI 办公套件与 genoffice 命令行完整指南

【免费下载链接】genofficeFree, open-source AI Office suite: Docs, Sheets, Slides, PDF, Markdown and HTML editors with a built-in AI agent, plus a `genoffice` CLI and agent skill so Claude Code, Codex and Cursor can create and edit real .docx/.xlsx/.pptx files locally. Bring your own key. macOS, Windows & Linux.项目地址: https://gitcode.com/gh_mirrors/ge/genoffice

GenOffice 是一套免费开源的 AI 办公套件：Docs、Sheets、Slides、PDF、Markdown、HTML 六个编辑器内置 AI 代理，随附的 genoffice 命令行与 MCP 服务器让 Claude Code、Cursor 等编码代理在本地读写真实的 .docx/.xlsx/.pptx。读完这篇，你会知道如何安装、如何本地转换 PDF、如何生成演示文稿，以及怎么让编码代理替你改文件。

它解决什么问题

GenOffice 把 AI 直接放进文档工作流：AI 读的是你的.docx、.xlsx、.pptx原件，改完仍交给你一份能在 Microsoft Office 里正常打开的原件，而不是一份 Markdown 近似品。它采用 Apache-2.0 协议，对个人与团队都免费。

• 原生格式：打开并保存真实 Office 文件，编辑区按 Word 的排版渲染，页眉页脚、分节、批注都能处理。
• 字节级保留：只重写你动过的部分，其余内容往返后与原文件一致。
• 可审查的 AI：每轮修改是一个可一键回滚的快照，开启 Track changes 后以 Word 风格修订呈现。
• 本地优先：打开、编辑、保存、格式转换全部在本机完成，只有 AI 调用离开设备。
• 可脚本化：内置genoffice命令行、agent skill 与 MCP 服务器，编码代理不用开窗口也能干活。

快速上手：安装 GenOffice 并跑通第一条命令

桌面应用覆盖三个平台：macOS 11+（Apple Silicon 与 Intel 各有一个.dmg）、Windows 10/11+（-x64.exe与 ARM64 版-arm64.exe）、Linux（glibc 2.34+，提供.deb、.rpm、.AppImage三种包）。装好应用后genoffice命令行随之就位：macOS 首次启动会建立符号链接，Linux 的 deb/rpm 包会自动链接到/usr/bin/genoffice。

下面两条命令用来确认安装是否成功：

genoffice --version genoffice info report.docx --json

第一条打印 CLI 版本号；第二条读出文档的标题与块结构，输出一个 JSON 对象。看到status: "ok"就说明环境可用。如果提示命令不存在，运行一次genoffice install-cli；仍找不到时，应用每次启动都会把可执行目录写进~/.genoffice/launcher，读那行路径即可定位。

想从源码构建：需要 Node.js ≥ 22.12 与 npm ≥ 10，Sheets 还要求 PATH 上有cargo（用来编译 xlsx sidecar）。

npm install npm run fixtures # 生成测试用的 .docx npm test # 引擎与六个应用的单测

测试全部通过即说明构建成功。

按场景看功能

把 PDF 变成可编辑的 Word

PDF 应用支持页内编辑：Edit text 模式给每个文本块画框，内容流经 PDFium 按原始字体重写，而不是叠一层批注。PDF Converter 提供 PDF → Word，标题、统计行与段落都保留；扫描页在 macOS 与 Windows 上走系统 OCR，输出可编辑文本而非页面截图。对长报告提问，答案会带页码引用。

让 AI 直接修改真实文档

• Docs：AI 读取目标块树后改写段落、插入小节；每轮修改生成一个快照，面板里一键回滚，开启 Track changes 后修订以 Word 样式落进文件。
• Sheets：一句话建表，AI 写进去的是活的SUMIF公式与图表，不是贴死的数字；提问时附推理过程，用到的单元格以可点击的引用呈现。
• HTML：AI 先给设计简报（hook、调色板、字体方向），再产出自包含的.html；点击元素改样式、一条 Restyle 指令整体换风格，也能导出 PDF 或原生 Word。
• Markdown：选中任意文字弹出 Ask AI 气泡，Polish、Make more concise、Fix grammar 等指令可立即发送，也可把多条编辑排队一次执行；渲染产物写回仍是普通.md。

从一句话到一份可交付的 .pptx

给 Slides 一句提示词（例如"做一份 10 页的投资者演示文稿"），AI 规划故事线、补齐数据，逐页写到画布上，产出带统一字体与视觉风格的真实.pptx，收尾页还带行动号召。成品之后仍可用母版、版式、智能参考线继续编辑，或让 AI 面板换风格、重写、调顺序。

不开窗口的批量处理与代理工作流

无头模式（不打开界面、只在后台运行）由genoffice提供：应用能对文件做的检查、转换、创建、读取、编辑，终端里都能做。

下面三条命令演示"检查 → 转换 → 建表"的基本回路：

genoffice convert report.md --to pdf genoffice create --type xlsx --from table.json --out sales.xlsx genoffice render report.docx --out shots/

第一条把 Markdown 转成 PDF；第二条从 JSON 建工作簿，"=SUM(B2:B9)"这类单元格保持活公式；第三条把文档逐页渲染成 PNG 供肉眼验收。预期都能打印一行人类可读摘要，加--json则输出单个 JSON 对象。

编辑回路是docs read拿块索引、docs apply --ops edits.json落改动。这个循环是原子的：批内有 op 被拒，文件就保持原样。退出码约定固定：0成功、1用法或 op 被拒、2文件问题（不存在/输出已存在/文件在应用里打开）、3转换失败、4应用不可用。

编码代理则走分阶段流程，CLI 会逐阶段校验后才放行：

genoffice capabilities --json genoffice guide slides design genoffice slides check deck/pages/01.json --json genoffice create --type pptx --spec deck/pages --outline deck/outline.json --out deck/deck.pptx --json genoffice slides audit deck/deck.pptx --json

先确认云端能力是否配置好，再按设计指南写样式表、大纲与每页一个的 page spec；slides check逐页查溢出与重叠；create组装出 pptx；最后slides audit与slides render复核。全程没有模型调用——思考在代理侧完成，构建与检查由 CLI 完成。

进阶集成：CLI、agent skill 与 MCP 服务器

三种接入方式共用同一套引擎与同一份 JSON 结果契约，按你的使用位置选一种即可。

skill 教会代理何时该用genoffice、先读后写、如何自查成果；仓库里 skills/genoffice/SKILL.md 就是它的实际定义，metadata 声明 CLI 版本要求不低于 0.9.0。skill 发新版时，设置页会出现 Update 按钮。

stdio 接入在 Claude Code 里是一行命令：

claude mcp add --transport stdio genoffice -- genoffice mcp

Cursor 等客户端写一行 JSON 即可：{ "mcpServers": { "genoffice": { "command": "genoffice", "args": ["mcp"] } } }。预期效果是每个命令变成一个模型工具（docs_read、docs_apply、sheet_read等），外加deck_start → deck_page → deck_build → deck_replace的分阶段建稿流程，ops 与 Markdown 可内联传递，不依赖文件系统。远程模式用PUT /files/<name>上传文件、工具回传下载 URL，--token保护访问。

安全边界值得留意：

• GENOFFICE_ALLOWED_ROOTS把读写限制在你列出的目录树内（解析符号链接后检查），越界以退出码 2 拒绝；
• 单次文件传输上限 256 MB，条目超过 TTL 自动过期；
• 文件正在应用里打开时禁止原地改写，返回退出码 2，--force可强行写入；
• 每次执行向~/.genoffice/cli-audit.jsonl追加一行 JSON 审计记录，敏感参数写入前脱敏；
• 只有search、image、media会离开本机；无头主机做 PDF 转换与渲染需要安装应用并配虚拟显示（如xvfb-run）。

核心设计点：一个 .docx 文件从打开到保存的完整生命周期

GenOffice 的保存是字节级保留的，这是"未改动的内容原样不变"承诺的实现基础。

打开 docx ─► 原件按哈希归档（全程不再触碰） ─► word/document.xml 解析为块树，每个块锚定到原始 XML 编辑 ─► 手动与 AI 修改都落在 Tiptap 编辑器上，脏块被标记 保存 ─► 脏块重写为 OOXML 片段（只引用文档已有样式） ─► 未改的块按原字节拼回 document.xml ─► 重打 zip，其余条目逐字节复制 ─► 若什么都没改，直接返回原始文件字节

这段逻辑在 packages/docx-engine/src/patch.ts 的saveDocx中有逐行注释。工作簿走 packages/xlsx-gateway/：内存工作簿先校验再应用单元格、格式类 op，图表、筛选、条件格式等快照承载不了的部分变为声明式保存载荷；公式写入后由本地 sidecar 求值并缓存结果，所以sheet read看到的是数字而不是空单元格。

常见问题

GenOffice 收费吗？免费。Apache-2.0 协议，没有试用期，也没有付费层级。

能保存 Microsoft Office 能用的文件吗？能。它读写原生.docx、.xlsx、.pptx，未触碰的内容往返后逐字节一致。

可以离线用吗？文档的打开、编辑、保存、转换全程离线；只有 AI 功能（代理、搜索、图片）需要联网，走你配置的提供商。

AI 用谁家的模型？两种：登录 Genspark 免密钥；或自带密钥接入 Claude、OpenAI、Gemini、DeepSeek、Kimi、GLM、Qwen 等，自定义槽位可指向任意 OpenAI 兼容端点，包括本地模型服务器。

能从 Claude Code 或脚本驱动它吗？能。genoffice命令行无头运行同一批引擎，agent skill 与 MCP 服务器两种自动化入口都随应用内置，Settings → Integrations 里即可安装。

会收集数据吗？官方构建默认发送有限用量分析，可在 Settings → General 关闭；分析从不包含文档内容、文件名、路径或账户信息。

小结

GenOffice = 六个免费编辑器 + 字节级保留的保存 + 一套让编码代理动手改真实 Office 文件的工具链（CLI、skill、MCP）。下一步：下载对应平台的安装包，先用"PDF 转 Word"跑通一条转换；团队里有人用编码代理，就把 skill 装进 Claude Code 或 Cursor 试试。更多细节见仓库 docs/ 与 CLI 完整参考 packages/cli/README.md。

【免费下载链接】genofficeFree, open-source AI Office suite: Docs, Sheets, Slides, PDF, Markdown and HTML editors with a built-in AI agent, plus a `genoffice` CLI and agent skill so Claude Code, Codex and Cursor can create and edit real .docx/.xlsx/.pptx files locally. Bring your own key. macOS, Windows & Linux.项目地址: https://gitcode.com/gh_mirrors/ge/genoffice