storytold/wordcraft

选用指南

AI 根据 README 整理 · 2026/10/16 22:16:33

适用场景

适合需要处理 Word 文档（.docx）的用户，支持打开和保存多种格式，并导出 PDF。

查看 README 依据

Tab demotes it, Ctrl/⌘+B bolds the word under the caret, the Styles gallery previews styles live, F4 repeats, F7 checks spelling, F8 extends the selection. - **Your files.** Opens and saves .docx (OOXML), and also .odt, .rtf, .html, .md, .tex (LaTeX), .txt; opens Word 97-2003 .doc; exports PDF with real, selectable text, links and bookmarks. - **Fast.** Paragraph layout is cached, so typing in a 188-page document re-lays it out in about 1.4 ms; pages render on demand. - **Everywhere.** One Rust codebase for macOS, Windows, Linux, BSD and the web. No Electron, no

使用方式

可通过桌面应用、命令行工具或 Web 版本使用，也支持通过 MCP 协议驱动。

查看 README 依据

Command line: ```sh wordcraft-cli convert report.docx report.pdf # docx, pdf, odt, rtf, html, md, tex, txt, png wordcraft-cli text report.docx # plain text wordcraft-cli inspect report.docx # structure as JSON wordcraft-cli run --template sample \ --cmd 'select.text={"text":"Membership"}' --cmd format.bold --save out.docx ``` Web: `cd apps/wordcraft-web && trunk serve`, then open <http://127.0.0.1:8771/?sample>. ## For agents: CLI and MCP WordCraft was designed to be driven by people *and* by AI agents. ```sh

claude mcp add wordcraft -- wordcraft-cli mcp # headless documents # confine the agent to folders: wordcraft-cli mcp --automation-read-root DIR --automation-write-root DIR wordcraft --control 7981 & # or drive the running app… claude mcp add wordcraft-app -- wordcraft-cli mcp --connect 127.0.0.1:7981 ``` Tools include `list_commands`, `execute`, `batch`, `type_text`, `select_text`, `inspect_document`, `render_page`, `save_document`, and, with a running app, `screenshot`, `click` and `key`. Agents

部署要求

支持 macOS、Windows、Linux、BSD 和 Web 平台，需要 Rust 环境从源码构建，或使用预编译安装包。

查看 README 依据

tables, track changes, references and mail merge. It reads and writes .docx, runs natively on macOS, Windows, Linux and BSD, and in the browser via WebAssembly.<br> <i>By the ArtCraft team.</i> </p> <p align="center"> <img alt="Written in Rust" src="https://img.shields.io/badge/written%20in-Rust-2b47b5?style=flat-square&logo=rust&logoColor=white"> <img alt="Runs on macOS, Windows, Linux, BSD and the web" src="https://img.shields.io/badge/runs%20on-macOS%20%C2%B7%20Windows%20%C2%B7%20Linux%20%C2%B7%20BSD%20%C2%B7%20Web-3b5bdb?style=flat-square">

| **Files** | .docx read/write (opens in Word), Word 97-2003 .doc import, PDF export, .odt, .rtf, .html, .md, .tex, .txt import/export, page images | The honest picture, area by area, is in [ROADMAP.md](ROADMAP.md), the [parity assessment](docs/target-app-parity.md) and the generated [feature checklist](docs/parity-checklist.md). ## Quick start ```sh git clone https://github.com/storytold/wordcraft cd wordcraft cargo run --release -p wordcraft -- --sample # the desktop app with the sample document cargo run --release -p wordcraft -- report.docx # open a document ```

已知限制

目前处于 alpha 阶段，估计约 60% 完成度，尚不支持图表和 SmartArt 的完整往返。

查看 README 依据

| L6 | `wordcraft-ui-egui` | the Word-style front end (swappable) | | apps | `wordcraft`, `wordcraft-cli`, `wordcraft-web` | desktop, command line, browser | `cargo xtask ci` runs formatting, clippy, ~800 tests, the asset-attribution check, the layering check and the wasm build. Contributor and agent instructions: [AGENTS.md](AGENTS.md). ## Roadmap WordCraft is in **alpha**. It covers 88% of Word's ribbon features with commands today; counting depth, file fidelity, stability and the rest, we estimate it is about 60% of the way to replacing

all of Word for real work, about 55% for a typical professional's weekly work and about 63% for everyday essentials. Beta needs testing against real-world .docx files, keeping charts and SmartArt through a round trip, pagination closer to Word's, a stability sweep and native printing. Details and estimates: [ROADMAP.md](ROADMAP.md) and [where we fall short](docs/gaps.md). ## Downloads