HermesOffice
免费开源的 AI 办公套件：本地编辑 Word/Excel/PPT/PDF/Markdown，AI 直接改文档。
- Star 数
- ★ 606
- 最近更新
- 11 天前
- License
- Apache-2.0
- 主语言
- TypeScript
- FA 评分
- 57/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 需要在 Word 里往返编辑 .docx、又担心套件改写文件导致排版错乱的法务或文控人员：HermesOffice 只重写被改动的段落，其余字节不动。
- 不适合
- 只想用浏览器、不愿装桌面客户端的用户
- 要求所有构建产物都已签名与公证的企业
- 源码审查
- 57/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
HermesOffice 是面向 macOS、Windows、Linux 的开源办公套件，用 Electron 把六个应用（Docs、Sheets、Slides、PDF、Markdown 与套件外壳 shell）组合在一起，共享同一层引擎包。它能打开并保存真正的 Microsoft Office 格式（.docx/.xlsx/.pptx），也能编辑 PDF 与 Markdown。其核心设计是「原文件即真相」：打开时按哈希归档原始文件，只有被改动的块会被重新生成 OOXML 片段并拼回 document.xml，未触碰的部分逐字节保留，因此文件回到 Word 中不会走版。AI 能力是一等公民：Docs 提供块级编辑、快照与 diff，其余应用提供对工作簿/幻灯片/PDF 状态做工具调用的 agent。AI 后端可走 Genspark 设备码登录（无需 API key），也支持 BYOK 接入 Claude、OpenAI、Gemini、DeepSeek 等以及任意 OpenAI 兼容端点。
六个应用各司其职：apps/docs 读写 .docx 并做字节级段落补丁（paragraph patch），带分页视图、修订、批注与公式；apps/sheets 基于 Univer 核心加上自研扩展，.xlsx 的导入导出通过 Rust sidecar（calamine + IronCalc）完成，图表用 Konva 渲染，支持数据透视表、切片器和条件格式；apps/slides 用自研 .pptx 解析/渲染/编辑引擎处理母版、版式、图表与裁剪；apps/pdf 基于 pdf.js、pdf-lib，并通过 PDFium wasm 重写页面内容流实现真正的文字与图片编辑（保留原字体、子集内嵌），支持批注、表单、签章、页面操作与打印；apps/markdown 用 Tiptap 把纯 Markdown 文件当块编辑器来写。packages/pdf2docx 做纯本地 PDF→DOCX 转换（PDFium 字符级抽取 + 纯几何版面分析），同一套分析也驱动 PDF 导出 PPTX 与 XLSX，macOS/Windows 上还能用系统 OCR 处理扫描页。packages/agent-core、ai-provider、ai-search 组成共享的 agent 循环、模型流式抽象与网页/图像搜索工具。
- 需要在 Word 里往返编辑 .docx、又担心套件改写文件导致排版错乱的法务或文控人员：HermesOffice 只重写被改动的段落，其余字节不动。
- 手上有扫描版或原生 PDF 合同、论文，想本地转成可编辑 .docx/.pptx/.xlsx 且不愿上传云端的人。
- 要求 PDF 真编辑而非贴图遮盖的编辑：改字后仍保留原字体，适合标书、表单与出版校对场景。
- 已经在用 Claude、OpenAI 或本地推理服务，希望把这些模型接进文档处理流程、用自己 API key 计费的团队。
- 需要一套免费替代 Microsoft Office 的 macOS 用户：下载 .dmg 一次点击即可安装，符合 macOS 11+、Apple Silicon。
- 想在 Electron 应用里嵌入文档编辑或复用引擎层的开发者：docx-engine、pptx-engine、pdf2docx 都是无 Electron 依赖的纯 TypeScript 包。
如何安装或部署这个 Agent？
最省事的路径是 macOS（Apple Silicon）直接用官方发布包，链接永远指向最新构建：
# macOS Apple Silicon（.dmg）
https://github.com/criptogus/HermesOffice/releases/latest/download/HermesOffice-arm64.dmg
# macOS Apple Silicon（.zip）
https://github.com/criptogus/HermesOffice/releases/latest/download/HermesOffice-arm64-mac.zip该 macOS 包为 ad-hoc 签名、未公证，首次启动需右键应用 → 「打开」，或在「系统设置 → 隐私与安全性」中放行。
macOS Intel、Windows 以及各 Linux 发行版目前没有发布产物，需要从源码构建，先安装依赖并生成测试夹具：
npm install
npm run fixtures # 生成测试用 .docx fixtures
npm test # 引擎与应用单元测试
npm run typecheck # 对每个 workspace 执行 tsc --noEmit打包各平台产物（Sheets 需要 cargo 在 PATH 中，构建时会自动编译 Rust sidecar）：
npm run dist:mac # 打包 macOS dmg（会重新生成第三方声明）
npm run dist:win # 打包 Windows nsis 安装包
npm run dist:linux # 打包 Linux AppImage + deb + rpmLinux 若已有 deb/rpm/AppImage 产物，可按发行版安装：
sudo apt install ./hermesoffice_<version>_amd64.deb
sudo dnf install ./hermesoffice-<version>.x86_64.rpm # Fedora / RHEL 系列
sudo zypper install ./hermesoffice-<version>.x86_64.rpm # openSUSE
# AppImage 需要 FUSE 2 运行时
sudo apt install libfuse2
chmod +x HermesOffice-<version>.AppImage
./HermesOffice-<version>.AppImageAI 功能需要凭据：默认走 Genspark 设备码登录（无需模型 API key），或在 AI 设置中填入自己的 key（Claude、OpenAI、Gemini、DeepSeek、Kimi、GLM、Qwen、Doubao、MiniMax、Grok、Mistral、OpenRouter，或任意 OpenAI 兼容端点的 base URL + key）。
如何使用这个 Agent？
启动套件 shell 后进入首页，用标签页打开 Docs / Sheets / Slides / PDF / Markdown 五个编辑器；文档的打开、编辑与保存都在本地完成。
开发阶段可一次起全部编辑器，或只起单个应用：
npm run dev # 五个编辑器 + shell，对接 Vite dev server
npm run dev:docs # 只起 Docs本地 UI/e2e 验收脚本（Playwright + Electron，默认不入库）位于 scripts/drivers/。
典型的 AI 编辑流程：在任意应用中打开 AI 面板 → 若未登录则完成 Genspark 设备码登录，或在 AI 设置中选择 BYOK 供应商并填入 key → 在 Docs 中让 AI 执行块级改写，改动会生成快照与 diff 供回滚；在 Sheets / Slides / PDF 中则由 agent 通过工具调用读写当前工作簿、幻灯片或页面状态。
这个 Agent 有哪些优点和局限？
- 字节保留的 .docx 往返：只重写脏段落（paragraph patch），未改动内容逐字节写回，回 Word 不易走版；Sheets、Slides 遵循同一「原文件即真相」策略。
- PDF 是真编辑而非遮盖：通过 PDFium wasm 重写页面内容流，保留原字体并做子集内嵌，可改文字与图片。
- PDF → Word/PowerPoint/Excel 全本地转换，配合 macOS/Windows 系统 OCR 覆盖扫描页，文档不需要上传云端。
- 模型侧不锁定：既支持 Genspark 设备码登录（无需 key），也支持 BYOK 接入十余家供应商以及任意 OpenAI 兼容端点，包含本地模型服务。
- 引擎层解耦：docx-engine、pptx-engine、pptx-render、pdf2docx、agent-core、ai-provider 等均为无 Electron 依赖的纯 TypeScript 包，且有单元测试。
- 许可宽松：Apache-2.0（仅 ee/ 目录预留给未来企业模块，适用单独的企业许可）。
- 已发布产物仅有 macOS Apple Silicon（arm64）的 .dmg/.zip；Windows、Linux 与 macOS Intel 都要自行从源码构建。
- macOS 包为 ad-hoc 签名、未公证，首次启动必须手动放行，企业批量分发需要额外处理。
- AI 功能需要网络：默认走 Genspark 登录或其代理，BYOK 也需调用各家模型 API，纯离线只能使用不含 AI 的编辑能力。
- 从源码构建的依赖较重：Node.js 工具链之外，Sheets 还需要 Rust/cargo 编译 sidecar，Linux AppImage 还需要 FUSE 2。
- 官方打包版本默认开启有限的使用分析（可在设置中关闭），对数据上报敏感的环境需要先行配置。
- 品牌与商标归 Mainfunc, Inc.，Apache-2.0 不授予商标使用权，分支需自行更换品牌。
这个 Agent 与同类方案有什么区别？
README 明确把 HermesOffice 定位为 Microsoft Office 的免费开源替代，并说明其与 Microsoft Word/Excel/PowerPoint 文件格式的兼容性；同时列出多个被复用的上游开源项目（Electron、Univer、PDFium、pdf.js、pdf-lib、Tiptap/ProseMirror、Konva、HarfBuzz、calamine、IronCalc），但这些是依赖而非竞品。除此之外，源材料没有点名其他同类办公或 AI 文档 agent 产品，因此不作竞品对比。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| HermesOffice 当前 | 57 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 606 | 11 天前 | TypeScript | OpenAI API · Claude API |
| NextClaw | 58 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 260 | 今天 | TypeScript | Codex · Claude Code |
| MyAgents | 57 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 918 | 2 天前 | TypeScript | Codex · Claude Code · Claude API |
| GenOffice | 82 · 表现良好 | 桌面应用免费 + 模型费 | ★ 9.1k | 今天 | TypeScript | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
SECURITY.md 明确说明所有窗口启用 contextIsolation、nodeIntegration:false、sandbox:true，IPC 经 schema 校验，外部链接走 safeExternalUrl 协议白名单，AI 布局脚本用 Acorn 解析并由受限 AST 解释器执行而非 eval，HTML 导出在无 preload 的隐藏窗口中渲染——最小权限与敏感数据处理有实质证据（2）。但 AI 编辑会直接改写文档、插入图片/图表，未见逐次用户确认机制，仅靠快照/差异与撤销，故 user_confirmation 仅 1；外部效应（联网搜索、图片抓取、Genspark 代理、默认遥测）虽有披露但缺少细粒度开关说明，external_effects 1；回滚仅提及版本快照与差异，未见明确的一键恢复或备份策略，rollback 1。依赖安全方面有 npm licenses 检查、cargo-deny、SHA 固定 action、nanoid override，但未提供 SBOM 或漏洞扫描证据，故 2。来源归属在 README 致谢与第三方声明中较完整（2）。
CI 覆盖 format/lint/typecheck/单测/e2e，并有字节保持兼容性门禁与 fixture 漂移检查，自洽性有证据（2）。依赖可用性方面 engines 固定 Node>=22.12、npm>=10，Rust 工具链与系统字体在 CI 中显式安装，依赖可获得性较好（2）。失败信息在测试中体现为明确错误（如 'edited by the user'、'empty points of a native chart cannot be written'、'4 blocks'），但未展示面向最终用户的错误文案体系，故 2。
README 面向 macOS/Windows/Linux 用户与开发者，场景与受众清晰（2）。能力边界说明较充分：本地编辑 vs 联网 AI、BYOK 与 Genspark 登录、OCR 仅 macOS/Windows、Intel/Windows/Linux 暂无发布产物（2）。触发精度方面，AI 工具调用依赖模型选择，未见对触发条件的严格约束或误触发防护说明，故 1。环境适配有明确系统要求与构建步骤（2）。
信息架构清晰（Apps 表、Engine packages、Development、FAQ、Architecture notes）（2）。安装说明详尽，含 dmg/deb/rpm/AppImage 与首次启动确认（2）。命名稳定，包名与工作区一致（2）。示例与 FAQ 丰富（2）。已知限制有列出（未公证、部分平台需自行构建、OCR 平台限制）（2）。许可证为 Apache-2.0 且 ee/ 目录另有企业许可，说明清楚（2）。版本与变更日志仅见 0.1.0 与 Releases 链接，无 CHANGELOG 文件，故 1。维护责任方面署名 Mainfunc, Inc. 与商标声明，但无治理/维护者承诺或 SLA，且发布者身份未验证，故 1。
输出可用性有测试支撑：块级编辑、图表补丁、评论线程、选区冻结等均验证可用（2）。边际价值明确：本地 PDF 转换、字节保持 docx、BYOK 多模型（2）。成本收益方面，免费开源、本地处理减少云成本，但默认遥测与 Genspark 代理可能带来隐性成本/依赖，故 2。
claim_traceability：README 声称与代码/测试部分对应，但许多强声明（'世界首个全功能'、'Word 从不察觉'）缺少可追溯证据，故 1。cross_source_corroboration：README、SECURITY、CI、测试之间有交叉印证，但缺少独立第三方验证，故 1。fact_inference_separation：文档中事实与营销语言混杂，未明确区分推断与事实，故 1。
- 发布者身份未经验证，且仓库 URL 在 package.json 中指向 genspark-ai/hermesoffice，与给定仓库 criptogus/HermesOffice 不一致，需核实来源。
- 默认启用遥测，且 AI 功能默认经 Genspark 代理，可能涉及数据外发，建议审查 PRIVACY.md 并确认可完全关闭。
- AI 编辑会直接修改文档并插入外部图片/图表，缺少逐次用户确认，建议在敏感文档中启用快照/备份。
- 仅 macOS Apple Silicon 有发布产物，其他平台需自行构建，且 macOS 包未公证，首次启动需手动放行。
- 无 CHANGELOG 文件，版本仅 0.1.0，长期维护与更新路径不明确。