应该使用哪一个 CLI
| CLI 工具 | 执行模型 | 最适合场景 | 网络与凭证要求 |
|---|---|---|---|
deckuse | 本地优先，直接操作 PPTX 文件空间 | 本地检查与修改 PPTX 结构、替换文字、设置标题或字号、移动形状、提交回 .pptx | 安装后执行本地文件操作；不需要登录、API 密钥或云端请求 |
deckops | 云端支持的 DeckFlow 任务运行器 | Create、Translate、Compress、OCR、Convert、Extract、Join、任务管理和批量自动化 | 需要登录或 Token；会上传文件并请求 DeckFlow 后端；持续运行任务需要有效的密钥、空间和配额 |
DeckUse 更适合“打开一个现有 PPTX，在本地做可控结构修改”的场景。它把 .pptx 解包成工作区（workspace），命令直接作用在本地目录里的 Office Open XML 结构上，最后再通过 commit 提交回 PPTX。它的定位是开源、可本地安装、可本地执行；只要依赖已安装，日常处理不需要网络请求。
DeckOps 更适合“把文件交给 DeckFlow 后端执行转换、生成、翻译或 OCR”的场景。它负责上传文件、创建任务、轮询任务状态，并支持 --json 输出给脚本或 Agent 解析。由于任务在云端执行，DeckOps 必须有可用的 Token/空间，且需要网络连接。
能力对比图
| 能力范围 | DeckUse | DeckOps |
|---|---|---|
PPTX 本地结构读取 | list slides、show slide、get text | 不作为核心能力 |
PPTX 本地结构修改 | set text、set font-size、move、replace、commit | 不作为核心能力 |
PPTX 安全边界 | 尽量修改现有 XML 节点、文本、变换与样式；避免默认改 rel/media/package topology | 由云端任务系统处理 |
| 演示文稿生成 | 不负责生成新的幻灯片内容 | create |
| 文档翻译 | 不负责云端翻译 | translate |
| 文件压缩 | 不负责 | compress |
| OCR | 不负责 | ocr |
| 格式转换/渲染 | README 明确建议使用 DeckOps 进行渲染与转换 | convert |
| 多个 PPTX 合并 | 目前非核心命令 | join |
| 任务查询/删除 | 无需任务系统 | task list、task get、task delete |
| 智能体/CI 输出 | 本地命令可通过脚本链式调用 | --json、--no-wait、--timeout、repl |
推荐的使用场景划分
当输入和输出文件都需要保留在本地计算机上时，优先使用 DeckUse。例如：批量替换公司年份、重命名特定的幻灯片标题、移动已有的形状、读取幻灯片/标题/文本结构，或允许编程智能体对 PPTX 文件进行渐进式的本地编辑。
当任务本身需要云端能力时，使用 DeckOps。例如：根据提示词/参考文件生成演示文稿、翻译 PPTX/PDF/DOCX/XLSX/KEY 文件、将 PPTX 转换为 PDF/视频/图片、压缩大文件、对图片进行 OCR，或将后台任务集成到 CI/智能体流水线中。
来源依据
- DeckUse GitHub 仓库：https://github.com/deckflow/deckuse
- DeckUse README/手册/源码入口：
README.md、manual.md、src/cli.ts - 2026-05-27 检查的 DeckUse npm 元数据：公共包为
deckuse，二进制文件为deckuse，Node 版本要求为>=18.0.0 - DeckOps GitHub 仓库：https://github.com/deckflow/deckops
- DeckOps README/源码入口：
README.md、src/cli.ts、src/commands/* - 2026-05-27 检查的 DeckOps npm 元数据：公共包为
deckops，二进制文件为deckops，最新 npm 版本为0.4.2