GenOffice 开源 AI 办公套件技术指南:Docs/Sheets/Slides/PDF 真格式编辑、genoffice CLI 与 MCP 智能体集成
发布时间:2026/9/27 21:25:51来源:尧图网络
人工智能AI 应用桌面应用AI AgentMCP 服务AI 技能【免费下载链接】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 是面向 macOS、Windows 与 Linux 的免费开源 AI 办公套件直接打开、编辑并保存原生.docx、.xlsx、.pptx文件同时支持 PDF、Markdown 与 HTML并为每个文档内置一位 AI 智能体——它不是贴在侧边的聊天窗口而是会读取文件、执行修改并精确展示改动内容的编辑器。本文以 docs/i18n/README.cs.md捷克语官方 README为主体结合 packages/cli/README.md、skills/genoffice/SKILL.md 与 CONTRIBUTING.md 等仓库源码级资料完整梳理其核心能力、CLI/Agent Skill/MCP 三种自动化接入方式、字节级保留的引擎原理与安装开发流程。读完本文你将掌握如何在本地用 AI 编辑真实 Office 文件以及如何让 Claude Code、Codex、Cursor 等编码智能体通过命令行或 MCP 协议在无窗口环境下创建、转换、读取和编辑这些文件。项目定位本地优先的开源 AI Office 套件GenOffice 的核心承诺可以概括为四条真实格式、字节级保留。只有你编辑的内容会被重写文件中其余部分按字节原样保留因此文档在 Word、Excel、PowerPoint 中依然正常工作。AI 可审查。编辑以“修订/差异”形式呈现支持一键回滚表格写入的是活公式而非粘贴的数字演示文稿与网页直接生成到画布上保持完全可编辑。本地是设计原则。文件在本机完成打开、编辑、保存与转换PDF → Word/Excel/PowerPoint、Markdown → Word、HTML → Word 全部在设备端执行。离开机器的只有 AI 调用且发往你自己选择的提供商。脚本化且面向智能体。应用内置genoffice命令行与 Agent Skill编码智能体可以在不打开任何窗口的情况下创建、转换、读取和编辑真实 Office 文件。六个编辑器 一个 AI 面板Docs.docx按 Word 的排版还原文件——双栏章节、通栏图片、着色表格、页眉页脚、基于 Word 行距度量的分页样式、批注、修订、公式与墨迹笔记原样往返。AI 只读取需要的块改写段落并插入新章节每个 AI 回合都是可回滚的快照开启“修订”后编辑以 Word 风格修订呈现。Sheets.xlsxAI 用真实SUMIF公式按地区与类别新增 Summary 表插入柱状图43 处改动作为一个可撤销批次一次应用对工作簿提问会返回推理过程与可点击引用的具体单元格。底层是自研 Rust.xlsx引擎见 apps/sheets/native/xlsx-engine、数据透视表、切片器、条件格式与公式追踪。Slides.pptx一句话输入——“为 Aurora Home 创建 10 页投资人演示文稿”——AI 规划叙事线、核实数据并把每张幻灯片草绘为真实.pptx输出保持统一的字体排印、图片与行动号召可继续用母版、版式、智能参考线和非破坏性裁剪编辑。PDF就地编辑模式为每个文本块描边直接输入替换内容流经 PDFium 以原始字体重写而非覆盖式批注。PDF Converter → PDF to Word在设备端产出可编辑.docx标题、统计行与段落完整Excel 与 PowerPoint 目标同理扫描页走系统 OCR。HTML先由 AI 提出设计简报钩子、调色板、字体排印与风格方向再据此生成单个自包含.html文件一次Restyle请求即可交换简报令牌令整页换风格所有章节与文案原样保留。内置“个人仪表盘”“数据报告”等起始模板可导出 PDF 或原生可编辑 Word 文档。Markdown基于纯.md的 Tiptap 块编辑器渲染标题、列表、表格、图片、代码块与 Mermaid 图写回仍是干净.md选中任意段落出现Ask AI芯片可输入指令或选建议润色、精简、扩写、修语法立即发送或排入队列批量执行。该入口在每款应用中一致存在。AI 后端登录 Genspark 或自带密钥通过 Genspark 登录则无需任何配置模型调用经由 Genspark 代理Claude、GPT、Gemini 系列智能体自动获得网页与图片搜索、图片生成、图片/音频/视频分析能力。或使用自带密钥。设置 → AI 提供 Claude、OpenAI、Gemini、DeepSeek、Kimi、GLM、Qwen、Doubao、MiniMax、Grok、Mistral、OpenRouter、Requesty 以及 OpenCode Zen/Go另有自定义槽位可填任意 OpenAI 兼容 endpointbase URL 密钥包括本地模型服务器。搜索与媒体能力在AI Media Search下按能力独立配置网页搜索可选 Serper 或 Tavily图片、图片生成与图片/视频分析可选 OpenAI、Gemini、Doubao/Seedream、GLM、Grok、Qwen、MiniMax 或任意 OpenAI 兼容 endpoint。整套套件提供浅色、深色与跟随系统三种外观。外观只改变屏幕显示导出、打印与保存的文件始终保留文档自身的颜色——这一约束在 CLAUDE.md 中被列为强制主题规则文档内容页面底色、单元格填充、幻灯片内容、PDF 页位图、导出/打印样式表等永不随主题重写。genoffice 命令行与 Agent Skill应用在图形界面之外能对文件做的一切genoffice命令行在终端里都能做查看、转换、创建、读取和编辑 Word、Excel、PowerPoint、PDF、Markdown 与 HTML使用与图形界面相同的引擎无图形界面。它随 GenOffice 一起安装不需要独立运行时并且从不把任何文档发送到任何地方。配合随附的Agent Skill可以把编码智能体变成“文档工作者”产出真实 Office 文件而非 Markdown 仿制品。开箱即用支持Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode 与 Windsurf任何能读取 skill 的智能体均可通过 MCP 服务器还可服务 Claude Desktop 与任意 MCP 客户端。Skill 安装的三种方式方式效果应用内设置 → 集成列出本机发现的智能体一键把 skill 写入所选每个智能体GenOffice 新版本带来更新的 skill 时会显示更新按钮同页下载为 zip得到 claude.ai、Claude 桌面应用等助手接受的上传格式npx skills add genspark-ai/genoffice从本仓库安装到任意支持 skill 的智能体安装后开启新会话并索要文档即可。skill 会教智能体何时调用genoffice、编辑前如何读取文件、以及如何自查工作。当前仓库中的 skill 定义位于 skills/genoffice/SKILL.mdversion: 2.51.0要求cli 0.9.0。终端快速开始genoffice --version genoffice info report.docx --json # 标题与块结构sheets/slides/pages 同理 genoffice convert report.md --to pdf # md/html/docx/xlsx/pptx → pdfpdf → docx/xlsx/pptx… genoffice create --type docx --from notes.md --out notes.docx genoffice create --type xlsx --from table.json --out sales.xlsx # SUM(B2:B9) 单元格保持活公式 genoffice docs read report.docx --range 0-9 --json # 然后 docs apply --ops edits.json 原地编辑 genoffice render report.docx --out shots/ # 每页一张 PNG用来查看产出 genoffice open sales.xlsx # 把结果交给编辑器每个命令默认输出一行人类可读摘要加--json则输出单个 JSON 对象。编辑是原子的被拒绝的操作会让文件保持原样并返回带指引的错误信息。genoffice help列出当前命令集完整参考在 packages/cli/README.md。智能体实际执行的流程从一句话到八页演示文稿前文“太阳系演示文稿”示例正是由 Claude Code 中的单一 prompt 生成的。智能体按 skill 中的分阶段工作流推进CLI 在每一阶段开始前完成校验genoffice capabilities --json # GenOffice 配置了哪些云工具 genoffice guide slides design # 演示文稿工作流与版式库 genoffice image the eight planets in a row … --aspect 16:9 --out deck/assets/cover.jpg genoffice slides check deck/outline.json --json # 8 页无问题 genoffice slides check deck/pages/01.json --json # 构建一页并审计溢出与重叠 … # 每张幻灯片一个页面文件直到每项检查干净 genoffice create --type pptx --spec deck/pages --outline deck/outline.json --out deck/solar-system.pptx --json genoffice slides render deck/solar-system.pptx --out deck/shots --json genoffice slides audit deck/solar-system.pptx --json # 8 张幻灯片无版式问题 genoffice slides replace deck/solar-system.pptx --slide 4 --spec deck/pages/05.json --json genoffice open deck/solar-system.pptxgenoffice内部不发起任何模型调用智能体负责思考CLI 负责构建与校验结果作为普通.pptx在 GenOffice 或 PowerPoint 中打开。智能体驱动的演示文稿设计全流程guide slides design→style.mdoutline.json→ 逐页slides check→create --spec→render --grid→slides audit在 skills/genoffice/SKILL.md 中有完整分步说明。CLI 输出契约与错误处理程序化调用请始终加--jsonstdout 上是单个 JSON 对象成功为{ status: ok | partial, command, summary, output_path?, warnings?, detail? }失败为{ status: error, code, error, message, suggestion?, detail? }。退出码0成功、1用法错误或操作被拒、2文件不存在/输出已存在/文件正在 GenOffice 中打开、3转换失败、4应用不可用。error是稳定的机器可读原因unknown_op、target_not_found、out_of_range、sheet_not_found、file_open_in_gui等suggestion给出下一步对一字之差会提示did you mean …?detail以字段形式携带重试所需事实可用 id、有效范围、工作表名、用法行——规范要求永远不要解析message。成功结果仍可能携带warnings[]如formulas_not_cached、images_dropped、output_renamed应按其提示处理而非重试。apply默认原子一批操作中任何一个被拒整个批次不写入。--best-effort/--stop-on-error会写入已应用部分并返回status: partial退出码 0因此程序必须检查status而非仅看退出码。完整的“哪个命令处理哪种任务”对照表与逐错误恢复建议见 skills/genoffice/SKILL.md。环境变量与安全边界GENOFFICE_ALLOWED_ROOTSPATH 风格目录列表把genoffice的读写限制在指定目录树内符号链接会在检查前解析越界退出码 2。GENOFFICE_AUDIT_LOGpath重定向审计日志默认~/.genoffice/cli-audit.jsonl每条命令追加一行 JSON2 MB 轮转off则禁用。GENOFFICE_USER_DATA指向非默认 GenOffice 配置目录打开文档注册表、AI 设置。GENOFFICE_APP_BIN指定可执行文件PDF 与 HTML 相关转换需要 GenOffice 应用或其无头导出模式。唯一把数据发出机器的命令是search、image、media且仅发往 GenOffice 中配置的提供商~/.genoffice/auth.json与 AI 设置中的 provider 路由。MCP 服务器Model Context Protocol 接入同一批命令也可作为 Model Context Protocol 工具提供给无法运行终端、或你不想授予终端权限的助手。两条路径均可在设置 → 集成 → MCP找到即拷即用的配置片段路径说明A ·genoffice mcp推荐stdio 服务器由助手自行启动GenOffice 无需打开。每个命令一个工具info、convert、create_docx、create_xlsx、create_pptx、create_pdf、docs_read/docs_apply/docs_check、sheet_*、slides_*、render、guide、search、image、media、open外加分阶段建稿流程deck_start→deck_page→deck_build→deck_replace共 29 个工具并把操作参考手册作为genoffice://guide/*资源发布。操作、规格与 Markdown 直接内联在参数中传递无文件系统的客户端也能工作B · 本地 HTTP 服务器运行在 GenOffice 应用内部地址http://127.0.0.1:3093/mcpStreamable HTTP兼容旧版 SSE。其工具操控可见的 Word 编辑器标签页create_session、insert_content、replace_blocks、apply_ops、read_document、save_session——你可以看着文档被生成。默认关闭在同一设置面板开启# Claude Code claude mcp add --transport stdio genoffice -- genoffice mcp// Cursor、Claude Desktop 或任意 MCP 客户端 { mcpServers: { genoffice: { command: genoffice, args: [mcp] } } }此处的genoffice是应用内置的 CLImacOS 位于/Applications/GenOffice.app/Contents/Resources/cli/genoffice设置面板会列出你安装的具体路径。服务器自带工作流指令并以genoffice://guide/*资源暴露操作参考因此无需 skillskill 与 MCP 服务器可以共存助手任选其一。云功能search、image、media仍走 GenOffice 中配置的提供商其余全部本地运行GENOFFICE_ALLOWED_ROOTS把每个工具限制在你指定的目录内。反向代理场景下可设GENOFFICE_TRUST_PROXY_HEADERS1genoffice mcp --http port [--host addr] [--token secret]则对跨机器客户端提供 Streamable HTTP文件随调用以PUT /files/name上传并返回 URL。上文中“可再生能源”演示文稿就是只连接genofficeMCP 服务器的 Claude Code 在一次 prompt 下的真实协议轨迹capabilities · guide(slides, spec) · guide(slides, design) search(query) ×4 → IEA、BNEF 与 IRENA 数据 search(query, images) ×7 · media(url, ask) ×7 → 候选图片每一张都经 media 确认为真实照片 deck_start(dir, style, outline) → 大纲通过检查需写 8 页 deck_page(dir, 0, page) … deck_page(dir, 7, page) → 每页对照大纲与调色板校验其中一页重新提交 deck_build(dir, out) → renewables-2026.pptx无图片失败 slides_audit(file) · slides_render(file, out) → 无版式问题8 张 PNG 以图片内容返回 deck_replace(dir, n, page) ×3 · slides_render(file, out) → 查看渲染图后修复三页38 次工具调用、约 13 分钟助手全程未触碰 shell图片、照片核查、指南、校验与渲染全部以 MCP 工具调用结果的形式往返。只有search与media离开本机发往 GenOffice 中配置的提供商。下图展示了 CLI 工作流的产物——八页太阳系演示文稿在 GenOffice Slides 中打开左侧缩略图条与 AI 面板清晰可见下载与安装平台要求安装包macOS— Apple Silicon (arm64)macOS 11.dmg(arm64)macOS— Intel (x64)macOS 11.dmg(x64)Windows(x64多数 PC)Windows 10Intel/AMD-x64.exe安装器Windowson Arm (ARM64)Windows 11 on ArmSnapdragon X 等-arm64.exe安装器Linux— Debian / Ubuntux86_64glibc 2.34Ubuntu 22.04 或更新.debLinux— Fedora / RHEL / openSUSEx86_64glibc 2.34Fedora 35、RHEL 9、Leap 15.6.rpmLinux— 其他发行版x86_64glibc 2.34FUSE 2.AppImage所有构建产物均出自main分支macOS 与 Windows 安装器已签名。Linux 安装示例# Debian / Ubuntuapt 安装自动拉取依赖并加入应用菜单 sudo apt install ./genoffice_version_amd64.deb # Fedora / RHEL 系 / openSUSE改用 rpm sudo dnf install ./genoffice-version.x86_64.rpm # Fedora / RHEL 系 sudo zypper install ./genoffice-version.x86_64.rpm # openSUSE # AppImage就地运行先装 FUSE 2 运行时 sudo apt install libfuse2 # Ubuntu 24.04 的包名是 libfuse2t64 chmod x GenOffice-version.AppImage ./GenOffice-version.AppImage工作原理字节级保留的引擎架构七个 Electron 应用Docs、Sheets、Slides、PDF、Markdown、HTML 与标签式 shell共享同一层由纯 TypeScript 包组成的引擎外加为.xlsx准备的 Rust sidecar。原始文件永远是事实来源编辑以窄补丁的形式应用编辑器未触及的一切在保存后原样存活。open docx ─► 按哈希归档原始文件永不触碰 ─► 解析 word/document.xml 为块树每个块锚定到其原始 XML ─► Tiptap 编辑器手动 AI 编辑脏追踪 save ─► 脏块 → OOXML 片段仅引用已有样式 ─► 拼回原始 document.xml未触碰的块保留其原始字节 ─► 重新打包 zip其余每个条目逐字节复制这套哲学同样适用于 sheets 与 slides。逐包导览docx/pptx 引擎、pdf2docx、html2docx、agent 核心与提供商见 CONTRIBUTING.mdpackages/docx-engine负责 docx 解析为块树、OOXML 片段生成与字节级段落补丁packages/pptx-engine/packages/pptx-render负责 pptx 模型与渲染packages/pdf2docx通过 PDFium 字符级提取与纯几何版式分析实现本地 PDF → DOCX同一分析还驱动 PDF 应用的 PowerPoint/Excel 导出packages/html2docx在应用自带 Chromium 中渲染页面、归约为文档意图树并写成原生 OOXML另有 packages/agent-core、packages/ai-provider、packages/ai-search 构成 AI 侧基础。genofficeCLI 本身位于 packages/cli运行在应用自带 Node 运行时上ELECTRON_RUN_AS_NODE无需额外安装Word/Markdown 命令经 jsdom 引导packages/cli/README.md 中的src/dom.ts工作簿写入走genoffice/xlsx-gateway即应用保存路径写公式后用 xlsx sidecar 求值并缓存结果因此sheet read与普通阅读器看到的是数值而非空值。开发与构建npm install npm run fixtures # 生成测试用 .docx fixtures npm test # 引擎 应用单元测试docs/sheets/slides 无需显示器 npm run typecheck # 全工作区 tsc --noEmit npm run dev # 六个编辑器 shell 对 Vite dev server npm run dev:docs # 单独运行一个应用每个工作区同模式 npm run dist:mac # 打包 macOS dmg会重新生成第三方声明 npm run dist:win # 打包 Windows nsis 安装器 npm run dist:linux # 打包 Linux AppImage deb rpmsheets 应用额外需要 Rust 工具链cargo在 PATH 上来编译 xlsx sidecarnpm run build -w genoffice/sheets会自动编译。必须通过的检查format:check、lint、typecheck、test、licenses与 PR 合入流程见 CONTRIBUTING.md。常见问题GenOffice 免费吗是。Apache-2.0 开源无试用期应用本身无付费档位。能打开 Microsoft Word/Excel/PowerPoint 文件吗能原生打开并保存.docx、.xlsx、.pptx保存字节保留未触及部分原样写回文档在 Microsoft Office 中照常工作。离线可用吗文档编辑完全本地打开、编辑、保存与转换都不离开电脑。AI 功能智能体、搜索、图片工具需要网络经 Genspark 登录或自带模型 API 密钥。能编辑 PDF 吗能——真正的文本与图片就地编辑重写页面内容流并保留原始字体而非覆盖式批注。能把 PDF 转成 Word/Excel/PowerPoint 吗能完全设备端PDFium 字符级提取 基于几何的版式分析无云服务、无上传扫描页在 macOS/Windows 上经系统 OCR 转为可编辑文本。能用自有 AI 模型或 API 密钥吗能。除无密钥的 Genspark 登录外支持 Claude、OpenAI、Gemini、DeepSeek、Kimi、GLM、Qwen、Doubao、MiniMax、Grok、Mistral、OpenRouter、Requesty、OpenCode Zen/Go 以及任意 OpenAI 兼容 endpoint含本地服务器搜索、图片生成与图片/视频分析在 设置 → AI Media Search 下单独配置密钥。能把 HTML 转成 Word 吗能——HTML 应用中的Export as Word在设备端生成原生可编辑.docx页面在自带 Chromium 中渲染归约为真实 Word 结构标题、段落、列表、表格、选项卡、KPI 行、表单字段、页面背景无 Word 对应物的纯视觉元素图表、图标、装饰框以图片插入。能从 Claude Code、Codex、Cursor 或脚本控制 GenOffice 吗能。genoffice命令行以无图形界面方式运行同一批引擎从终端或脚本查看、转换、创建、读取与编辑文档支持--json输出随附 Agent Skill 教 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode、Windsurf 如何使用它在设置 → 集成安装。GenOffice 收集数据吗官方打包版本默认发送有限的使用分析可在 设置 → 常规 随时关闭分析从不发送文档内容、文件名、文件路径、账户身份或邮箱。完整事件清单与数据披露见 PRIVACY.md。安全、许可与致谢进程级安全立场renderer 沙箱、IPC 校验、外部链接过滤与 AI 生成内容的威胁模型见 SECURITY.md。GenOffice 以 Apache License 2.0 授权唯ee/目录保留给未来企业模块适用 GenOffice Enterprise LicenseApache-2.0 授权不包含使用 GenOffice/Genspark 名称与标识的许可fork 应使用自有品牌。其核心组件来自多个开源项目Electron 运行时、UniverSheets UI 内核Apache-2.0、PDFiumPDF 内容流引擎经 embedpdf/pdfium 打包、pdf.js 与 pdf-libPDF 渲染与组装、Tiptap/ProseMirrorDocs 与 Markdown 块编辑器、CodeMirrorHTML 源码视图、KonvaSlides 画布与 Sheets 图表、HarfBuzz wasm复杂字体文本整形度量、calamine 与 IronCalcRust xlsx sidecar 的读取与计算层、libeotPowerPoint 嵌入字体的 MicroType Express 解码已移植到 TypeScript、React、Mermaid 与 KaTeXMarkdown/Docs 的图表与数学、opentype.js、JSZip 与 fast-xml-parserOOXML 容器与 XML、Fluent UI System Icons、electron-updater以及随附的 Liberation/Carlito/Caladea/Noto CJK 字体。npm run notices可重新生成第三方许可证汇总tools/gen-third-party-notices.mjs全部运行时依赖均在 MIT/Apache-2.0/BSD-3-Clause/OFL 许可白名单内。赞分享人工智能AI 应用桌面应用AI AgentMCP 服务AI 技能【免费下载链接】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 办公套件技术指南字节保真的 Office 编辑、genoffice CLI 与 MCP Agent 集成GenOffice 开源 AI 办公套件技术指南字节保真的 Office 编辑、genoffice CLI 与 MCP Agent 集成 本文基于仓库内的印地人工智能AI 应用桌面应用AI AgentMCP 服务AI 技能Astryx Lightbox 组件契约解析解剖结构、主题化所有权与行为不变式Astryx Lightbox 组件契约解析解剖结构、主题化所有权与行为不变式 Lightbox 是 Astryx 设计系统中用于全视口展示单张图片或单个视频人工智能AI 应用桌面应用AI AgentMCP 服务AI 技能OpenCodeReview 官网 Landing Page 开发指南基于 TypeScript、React、Webpack 与 Tailwind 的构建实践OpenCodeReview 官网 Landing Page 开发指南基于 TypeScript、React、Webpack 与 Tailwind 的构建实践人工智能AI 应用桌面应用AI AgentMCP 服务AI 技能上一篇dbus-broker核心功能解析从安全机制到性能优化的完整指南下一篇FerretDB v2.7 Docker 部署指南生产、开发与评估镜像的安装、连接与升级实战创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网