storytold/deckcraft

选用指南

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

使用方式

可通过桌面应用或命令行工具使用，支持 CLI 和 MCP 服务器驱动。

查看 README 依据

Every action in DeckCraft is a command with a stable id, so people, scripts and AI agents use the same verbs: ```sh deckcraft-cli commands format. # list commands deckcraft-cli run --sample --cmd 'slide.new={"layout":"titleOnly","title":"Hello"}' --save hello.deckcraft deckcraft-cli mcp # MCP server over stdio (headless) deckcraft-cli mcp --connect 7990 # drive the running app (deckcraft --control 7990) deckcraft-cli mcp --automation-read-root DIR --automation-write-root DIR # confine the headless agent to folders ``` ## Roadmap

部署要求

Linux 构建需要 ALSA 头文件；字体可选用 craft-fonts 仓库，否则使用系统字体。

查看 README 依据

[`crates/pdf/README.md`](crates/pdf/README.md) for the dependency and validation requirements. ```sh git clone https://github.com/storytold/deckcraft cd deckcraft cargo run --release -p deckcraft-cli -- render --sample --all --scale 1 out/ ``` On Linux, the build also needs the ALSA headers for slide-show sound: `alsa-lib-devel` on Fedora, `libasound2-dev` on Debian and Ubuntu, `alsa-lib` on Arch. Without them it stops at `alsa-sys`. Fonts come from [craft-fonts](https://github.com/storytold/craft-fonts): clone it next to this repo

(`../craft-fonts`) and local builds pick it up automatically; without it DeckCraft uses your system fonts. Each [GitHub release](https://github.com/storytold/deckcraft/releases) has ready-made builds, on Linux as an AppImage, a `.deb`, an `.rpm` and a tarball. On Gentoo, the community [::snakebyte overlay](https://github.com/switch87/snakebyte-overlay) packages the Linux release as `app-office/deckcraft-bin` (not maintained by the DeckCraft team): ```sh eselect repository add snakebyte git https://github.com/switch87/snakebyte-overlay.git emaint sync -r snakebyte

已知限制

目前处于 alpha 阶段，覆盖 PowerPoint 约 84% 的功能，距离完全替代 PowerPoint 估计完成约 55%。

查看 README 依据

DeckCraft is in **alpha**. It covers **84% of PowerPoint's features by breadth** (92% of the core ones, measured) and is about **55% of the way to replacing PowerPoint for real work** (estimated). See [ROADMAP.md](ROADMAP.md) for the stage, numbers by dimension and what's next, [docs/target-app-parity.md](docs/target-app-parity.md) for the full assessment, [docs/gaps.md](docs/gaps.md) for every known shortfall and [docs/parity-checklist.md](docs/parity-checklist.md) for the feature-by-feature checklist. ## Downloads