CLI 示例

DeckUse: 本地更新 PPTX 文本

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

安装后，该工作流完全在本地运行。无需登录、无需 API 密钥、无需后端任务、也无需上传文件。

DeckUse: 查看并编辑单张幻灯片

deckuse init roadmap.pptx --dir ./roadmap.deck
deckuse show slide ./roadmap.deck 3
deckuse get text ./roadmap.deck "slide:3/title"
deckuse set text ./roadmap.deck "slide:3/title" "2026 Product Roadmap"
deckuse set font-size ./roadmap.deck "slide:3/title" 28
deckuse commit ./roadmap.deck --output roadmap-updated.pptx

使用选择器表达式（例如 slide:3/title、shape[type=textbox] 或 slide:1/#6,9）来指定要修改的现有元素。

DeckUse: 带显式输出的直接 PPTX 输入

deckuse replace deck.pptx "OldBrand" "NewBrand" --output deck-brand-updated.pptx
deckuse set text deck.pptx "slide:1/title" "New Launch Plan" --output deck-title-updated.pptx

直接编辑原始 .pptx 路径（而不是初始化的工作区）时，请传入 --output 参数以为修改后的文件指定显式输出路径。

DeckOps: 登录和检查任务

deckops login
deckops task list --limit 10

DeckOps 将凭证存储在 ~/.deckops/config.json 中，并调用 DeckFlow 后端执行任务操作。

DeckOps: 生成幻灯片

deckops create \
  --input-text "Please write an API design document for developers" \
  --audience "Engineering Team" \
  --page-count 6

当需要基于已有材料生成幻灯片时，请使用参考文件：

deckops create refs.md refs.pdf \
  --input-text "Generate a summary based on the reference materials" \
  --audience "Management" \
  --page-count 8

DeckOps 允许为 create 传入最多两个参考文件。

DeckOps: 翻译文档

deckops translate handbook.docx \
  --from zh \
  --to en \
  --model Standard

deckops translate slides.pdf \
  --from ja \
  --to zh-hans \
  --model Pro \
  --image-translate true

翻译是一个云端任务，因此该命令需要有效的 DeckOps 令牌/空间以及网络连接。

DeckOps: 转换与渲染

deckops convert slides.pptx --to pdf
deckops convert slides.pptx --to video --timeout 900
deckops convert page.html --to pptx --width 1920 --height 1080 --need-embed-fonts true

使用 --no-wait 参数让任务在后台启动：

deckops convert slides.pptx --to pdf --no-wait --json
deckops task get <task-id> --json

DeckOps: 压缩、OCR 和合并

deckops compress presentation.pptx
deckops ocr screenshot.png --language en
deckops join cover.pptx chapter-1.pptx appendix.pptx --name combined-deck

组合工作流

如果修改是确定性且本地的，请先使用 DeckUse，然后在需要云端操作时使用 DeckOps：

deckuse init source.pptx --dir ./source.deck
deckuse replace ./source.deck "2025" "2026"
deckuse commit ./source.deck --output source-clean.pptx

deckops convert source-clean.pptx --to pdf
deckops translate source-clean.pptx --from zh --to en --model Standard

这种拆分能够使简单的结构化编辑保持在本地，同时将云端请求保留给渲染、翻译、OCR、生成和其他后端任务。

来源依据

• DeckUse GitHub: https://github.com/deckflow/deckuse
• DeckOps GitHub: https://github.com/deckflow/deckops