用途：通过命令行与 Banana Slides 后端交互，创建、管理并导出 AI 生成的演示文稿，适合脚本化或批量生成幻灯片。
主要能力：项目创建与管理（支持短 ID 前缀匹配、设置工作项目）；工作流生成大纲、页面描述与配图（workflows outline/full，支持 --language、--pages）；导出 PPTX、PDF，带 --output 时自动下载到本地，否则返回服务端下载 URL；批量任务用 jobs.jsonl 驱动（run jobs）；支持对已有 PPTX 进行 renovation；--json 输出便于脚本处理。
必要用法：先确认后端可达：curl -sf http://localhost:5011/health，失败需按 references/setup.md 配置并启动后端。命令形式为 banana-cli <command> [options]；若不在 PATH，可在项目根目录用 uv run banana-cli，或 uv tool install . 全局安装。典型流程：projects create → projects use → workflows full → exports pptx --output ./slides.pptx。文件路径参数需绝对路径；异步任务默认等待并在 stderr 显示进度，可用 --no-wait 立即返回 task_id，--wait/任务可中断恢复。
限制：--pages 仅为 AI 提示，实际页数可能不同；配置优先级为 CLI 参数 > 环境变量 (BANANA_CLI_*) > TOML 配置 (~/.config/banana-slides/cli.toml) > 默认值。其余收费、平台与效果信息暂未提供。