CLI 安装指南

DeckUse

DeckUse 是一款本地优先的命令行工具。它用于在本地文件和本地工作区中对 PPTX 进行结构化操作。

npm install -g deckuse
deckuse --help

虽然 GitHub 仓库的 README 中目前显示使用 npm install -g @deckflow/deckuse 进行安装，但经 2026-05-27 检查，公开的 npm 注册表中暴露的包名实际为 deckuse；当时在公开注册表中无法下载命名空间包 @deckflow/deckuse。

若想直接运行 GitHub 仓库源码，可从源码编译安装：

git clone https://github.com/deckflow/deckuse.git
cd deckuse
pnpm install
pnpm build
pnpm link --global
deckuse --help

DeckUse 的核心工作流不需要登录、API 密钥、空间 ID 或后端 URL。常规工作流如下：

deckuse init company.pptx --dir ./company.deck
deckuse list slides ./company.deck
deckuse replace ./company.deck "2025" "2026"
deckuse commit ./company.deck --output company-2026.pptx

DeckOps

DeckOps 是一款基于云端的任务命令行工具。它将文件上传到 DeckFlow 后端，创建任务，并可选择是否等待任务完成，同时在本地存储身份验证信息。

npm install -g deckops
deckops --help

若想直接运行 GitHub 仓库源码，可从源码编译安装：

git clone https://github.com/deckflow/deckops.git
cd deckops
npm install
npm run build
node dist/cli.js --help

使用浏览器登录流程进行身份验证：

deckops login

login 命令会自动打开浏览器，并默认在 http://localhost:3737 接收回调。凭证将存储在：

~/.deckops/config.json

常见的配置文件字段：

{
  "token": "your-auth-token",
  "spaceId": "your-space-id",
  "apiBase": "https://app.deckflow.com/v1"
}

您也可以手动配置 DeckOps：

deckops config set-token <token>
deckops config set-space <space-id>
deckops config set-api-base https://app.deckflow.com/v1
deckops config show

大多数 DeckOps 命令需要网络连接和有效的凭证。如果凭证缺失，调用 API 的命令会触发登录流程。如果后端返回 401，DeckOps 将尝试重新登录并重试任务。如果后端返回 402，它会在继续执行前打开收银台（付款）流程。

安装选择决策

当您需要进行本地、离线友好的 PPTX 编辑，且不希望将文件发送到云端服务时，只需安装 deckuse。

当您需要使用 DeckFlow 后端功能（如生成、翻译、渲染、OCR、压缩、文件转换或长时间运行的任务管理）时，请安装 deckops。

很多工作流会同时使用两者：先使用 DeckUse 进行本地结构清理，再使用 DeckOps 进行云端渲染或翻译。

来源依据

• DeckUse GitHub 仓库：https://github.com/deckflow/deckuse
• 2026-05-27 检查的 DeckUse npm 包：https://www.npmjs.com/package/deckuse
• DeckOps GitHub 仓库：https://github.com/deckflow/deckops
• 2026-05-27 检查的 DeckOps npm 包：https://www.npmjs.com/package/deckops