WordCraft 项目解析:用纯 Rust 重写 Microsoft Word,一套代码跑遍桌面与浏览器

WordCraft 项目解析:用纯 Rust 重写 Microsoft Word,一套代码跑遍桌面与浏览器

前天
duguying
5 阅读
来源:GitHub

WordCraft 是 ArtCraft 团队用纯 Rust 从零实现的开源文字处理器,把 Word 的工作流——功能区、样式、表格、修订、引用与邮件合并——完整搬到 macOS / Windows / Linux / BSD 与浏览器上。它读写 .docx、导出真实可选中的 PDF、支持 9 种界面语言,全部 422 个操作都能被 AI Agent 通过 MCP 驱动;目前处于 alpha,最新版本 v0.5.0。

相关标签

#WordCraft#Rust#文字处理#docx#开源#MCP#跨平台

项目概览

WordCraft 是 ArtCraft 团队用纯 Rust 从零实现的开源文字处理器,定位是”Microsoft Word 的 clean-room 重写版”:不是兼容层、不是套壳,而是从公开规范与观察出发,把 Word 那套你已经熟悉的工作流——功能区(ribbon)、样式、表格、修订、引用、邮件合并——重新造一遍。

它读写 .docx,原生运行在 macOS、Windows、Linux 与 BSD 上,也能通过 WebAssembly 在浏览器里跑;界面使用原生 egui 渲染在 GPU 上,没有 Electron,也没有 Tauri。项目采用 MIT OR Apache-2.0 双许可,由 ArtCraft 团队维护。

截至 2026 年 10 月 11 日:仓库约 4,358 Star、1,335 Fork,主语言 Rust,最新发布版本为 v0.5.0(2026-10-11),仍处于 alpha 阶段。

为什么值得关注

  • 习惯不变。 Word 的功能区选项卡、分组、快捷键与行为都被保留:回车继续列表、Tab 降级列表项、Ctrl/⌘+B 加粗光标所在词、样式库实时预览、F4 重复上一步、F7 拼写检查、F8 扩展选区。
  • 文件是你的。 读写 .docx(OOXML),同时支持 .odt、.rtf、.html、.md、.tex(LaTeX)、.txt;可以打开 Word 97-2003 的 .doc;导出 PDF 时带真实可选中的文本、链接与书签。
  • 快。 段落布局做了缓存——在一份 188 页的文档里打字,重新排版大约只要 1.4 ms,页面按需渲染。
  • 无处不在。 一份 Rust 代码库同时覆盖 macOS、Windows、Linux、BSD 与 Web。
  • 为 Agent 而生。 每一个操作都是带 id 的命令,同一套 422 条命令同时驱动功能区、键盘快捷键、命令搜索、命令行工具、JSON 控制通道和 MCP 服务器。
  • 离线且开放。 拼写、语法在内的一切都在本地完成;代码清理过来源,所有素材均为原创或开放许可。

已经能做什么

项目给出了相当诚实的能力清单,按功能域划分:

领域 主要能力
书写 IME 输入、智能引号、自动更正、列表自动格式化(*、1.)、破折号;词/句/段选择、拖拽选择、带格式的剪贴板、撤销重做、正则查找替换
格式 字体字号、粗斜体下划线、删除线、上下标、大小写、高亮、颜色、字符间距、格式刷、更改大小写、清除格式
段落 对齐、缩进(标尺上可拖)、间距、行距、带前导符的制表位、边框底纹、与下段同页、孤行控制
样式 内置样式集、实时样式库、样式窗格、新建/修改/更新样式、样式集与主题
列表 项目符号、编号、多级列表、重新编号、设置起始值、自定义格式
表格 网格插入、合并拆分、带隔行底纹的表格样式、边框底纹、跨页重复表头、跨页断行、排序、公式、文本↔表格
页面 页边距、方向、纸张大小、分栏、分页/分栏/分节符、页眉页脚(首页、奇偶页)、页码、水印、页面边框、行号、垂直对齐、首字下沉、自动断词
对象 图片(缩放、裁剪、重新着色、亮度对比度、透明度、去背景、图片样式、旋转)、形状、文本框、浮动定位与文字环绕(四周、上下、衬于/浮于文字上方)
引用 目录、脚注尾注、引用与参考文献(APA、MLA、Chicago、IEEE)、题注、图表目录、交叉引用、索引、引文目录
审阅 拼写语法建议、同义词库、字数统计、页边批注气泡或窗格、修订、接受/拒绝、文档比较、限制编辑、可访问性检查、文档检查器
邮件 从 CSV 邮件合并、合并域、地址块、问候语、规则、预览、合并到文档;信封与标签
视图 页面视图、Web 视图、草稿、阅读模式、专注模式、缩放、单页/多页、页宽、导航窗格、标尺、网格线、深色模式;界面支持 English、简体中文、繁體中文、日本語、Português (Brasil)、Español、Українська、Српски / Srpski、Eesti(默认跟随系统语言)
文件 .docx 读写(Word 可打开)、Word 97-2003 .doc 导入、PDF 导出、.odt/.rtf/.html/.md/.tex/.txt 导入导出、页面图像

README 也附了逐项对照的诚实评估:ROADMAP.md、与目标应用的差距评估 和自动生成的功能清单。

为人和 AI 同时设计

WordCraft 的设计前提是:它既要被人类用,也要被 AI Agent 驱动。

claude mcp add wordcraft -- wordcraft-cli mcp                  # headless documents
wordcraft --control 7981 &                                     # or drive the running app
claude mcp add wordcraft-app -- wordcraft-cli mcp --connect 127.0.0.1:7981

MCP 工具包括 list_commands、execute、batch、type_text、select_text、inspect_document、render_page、save_document;连接运行中的桌面应用后还可使用 screenshot、click 和 key。Agent 可以通过 inspect_document 直接检查自己的改动结果,而不必依赖截图比对。宏可以记录任意命令序列并回放(tools.recordMacro、tools.macros)。

架构

项目按层组织,共 7 层加应用层,界面被刻意做成可替换的:

层 Crate 职责
L0 wordcraft-geom 单位与度量
L1 wordcraft-doc、wordcraft-fonts、wordcraft-proof 文档模型与编辑;字体与整形;拼写、语法、断词
L2 wordcraft-layout、wordcraft-docx、wordcraft-formats 断行、分页、表格、注释、命中测试;OOXML;ODT/RTF/HTML/Markdown/TXT
L3 wordcraft-render、wordcraft-pdf 光栅化(vello_cpu);PDF(krilla)
L4 wordcraft-engine 会话、撤销、422 条命令、Word 功能目录
L5 wordcraft-mcp MCP 服务器
L6 wordcraft-ui-egui Word 风格前端(可替换)
apps wordcraft、wordcraft-cli、wordcraft-web 桌面、命令行、浏览器

cargo xtask ci 会跑格式化、clippy、约 800 个测试、素材归属检查、分层检查和 wasm 构建。

快速上手

git clone https://github.com/storytold/wordcraft
cd wordcraft
cargo run --release -p wordcraft -- --sample
cargo run --release -p wordcraft -- report.docx

命令行工具做格式转换与结构检查:

wordcraft-cli convert report.docx report.pdf
wordcraft-cli text report.docx
wordcraft-cli inspect report.docx
wordcraft-cli run --template sample --cmd 'select.text={"text":"Membership"}' --cmd format.bold --save out.docx

浏览器版本:

cd apps/wordcraft-web && trunk serve

然后打开 http://127.0.0.1:8771/?sample。

项目状态与路线图

WordCraft 目前是 alpha。README 给出的量化判断是:命令层面已覆盖 Word 功能区功能的 88%;把实现深度、文件保真度、稳定性等因素一并计入,估计相当于”真正替代 Word 完成实际工作”的约 60%、完成”典型专业人士每周工作”的约 55%、完成”日常必需”的约 63%。

项目自己列出了进入 Beta 前还需要解决的事:用真实世界里的 .docx 文件做测试、让图表与 SmartArt 在往返存取中保持完整、分页结果更贴近 Word、一次稳定性清扫,以及原生打印。

下载与许可

最新版本 v0.5.0 的产物覆盖得很全:Windows(x64 / arm64 / x86,均含 MSI 安装包与便携版)、macOS(通用二进制 DMG 与命令行工具,已签名并公证)、Linux(AppImage、Flatpak、deb、rpm、tar.gz,x86_64 与 aarch64,另有 riscv64 tar.gz)、FreeBSD x86_64,以及可直接托管在任意静态服务器上的 WebAssembly 静态站点。安装包与可执行文件均已代码签名,SHA256SUMS.txt 提供每个文件的校验和。

许可方面,WordCraft 采用 MIT 或 Apache-2.0 双许可,可任选其一,版权归 ArtCraft Team 与贡献者所有。捆绑的字体、图标、图片等素材各自保留自己的开放许可,逐项列在 ATTRIBUTION.md 中;拼写词典与断词数据来自 Grady Ward 的公有领域 Moby Hyphenator II 词表;示例文档与模板是为 WordCraft 原创撰写的文本。ArtCraft 名称与标识属于 ArtCraft Team 的商标,不在代码许可范围内。

需要说明的是:WordCraft 是独立开源项目,与 Microsoft 及 Adobe 均无隶属、赞助或背书关系,相关商标仅用于描述它所兼容的工作流。

获取与了解

WordCraft 是 ArtCraft 旗下 Crafting Apps 系列的一员——同系列还包括 PhotoCraft(图像编辑,支持真实 PSD)、VectorCraft(矢量插画)、FilmCraft(视频剪辑)、LightCraft(照片库与 raw 冲印)、PdfCraft(PDF 阅读与整理)、EffectCraft(动态图形与视觉特效)与 DesignCraft(页面排版与出版),全部用 Rust 从零编写,且每个都能独立使用。

返回列表

更多资讯

想看更多优质内容?

浏览所有资讯