
WordCraft 项目解析:用纯 Rust 重写 Microsoft Word,一套代码跑遍桌面与浏览器
WordCraft 是 ArtCraft 团队用纯 Rust 从零实现的开源文字处理器,把 Word 的工作流——功能区、样式、表格、修订、引用与邮件合并——完整搬到 macOS / Windows / Linux / BSD 与浏览器上。它读写 .docx、导出真实可选中的 PDF、支持 9 种界面语言,全部 422 个操作都能被 AI Agent 通过 MCP 驱动;目前处于 alpha,最新版本 v0.5.0。
相关标签
项目概览
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 均无隶属、赞助或背书关系,相关商标仅用于描述它所兼容的工作流。
获取与了解
- 仓库与 README:https://github.com/storytold/wordcraft
- 最新版本:v0.5.0(2026-10-11),https://github.com/storytold/wordcraft/releases/tag/v0.5.0
- 产品主页:https://getartcraft.com/apps/wordcraft
- 社区:Discord https://discord.gg/artcraft
- MCP 文档与控制协议:docs/mcp.md、docs/control-protocol.md
WordCraft 是 ArtCraft 旗下 Crafting Apps 系列的一员——同系列还包括 PhotoCraft(图像编辑,支持真实 PSD)、VectorCraft(矢量插画)、FilmCraft(视频剪辑)、LightCraft(照片库与 raw 冲印)、PdfCraft(PDF 阅读与整理)、EffectCraft(动态图形与视觉特效)与 DesignCraft(页面排版与出版),全部用 Rust 从零编写,且每个都能独立使用。
更多资讯
想看更多优质内容?
浏览所有资讯