> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Arka is an open-source AI terminal agent (PyPI package: arka-agent, GPL-2.0).
> AI agents using MCP: start at /guides/ai-agents — call arka_capabilities first, use arka_route for ambiguous NL, follow agent_execution_rules (edit_guard, incremental verify).
> Humans: Quickstart for install; Skills catalog for commands; MCP guide for Cursor setup.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# 生成幻灯片

> 从主题生成高管品质的幻灯片 — pptx、pdf、html 或 markdown，支持样式预设与视觉主题。

从一个主题生成结构化的幻灯片。Arka 使用面向演示的提示（行动式标题、演讲者备注、章节分隔） — 不是视频脚本。

## 快速开始

```bash theme={null}
arka make slides about kubernetes networking
arka pitch deck on AI infrastructure
arka academic presentation on quantum computing
arka compose_slides compose --topic "Python asyncio" --llm --style executive -f pptx
```

## 样式预设

| 样式          | 适用场景                     | 默认主题    |
| ----------- | ------------------------ | ------- |
| `executive` | 业务更新，聚焦 KPI 的行动式标题       | `dark`  |
| `pitch`     | 创业融资 — 问题 → 方案 → 市场 → 请求 | `dark`  |
| `academic`  | 学术演讲 — 方法论、参考文献          | `light` |

```bash theme={null}
arka compose_slides compose --topic "Series A" --style pitch -f pptx
arka compose_slides compose --topic "CRISPR" --style academic -f all
```

## 视觉主题

用 `--theme` 控制颜色与字体：

| 主题        | 效果                           |
| --------- | ---------------------------- |
| `dark`    | 高对比度幻灯片（executive/pitch 的默认） |
| `light`   | 清爽的浅色背景（academic 的默认）        |
| `minimal` | 白色/中性色，适合打印                  |

```bash theme={null}
arka compose_slides compose --topic "Q4 review" --style executive --theme light -f pptx
arka pitch deck on terminal AI agents --theme dark
```

每份幻灯片的设计特性：

* **标题页**带有副标题与 logo 占位
* **章节分隔页**（pitch 类使用 Problem/Solution 分节）
* **左对齐的行动式标题**，带强调条与页码
* **底部条**在正文页显示页面标题与页码
* 仅有文字的正文页会带**图像/图表占位面板**
* pitch 类的业绩页带**指标高亮框**
* 所有主题都采用 **8px 间距网格**与符合 WCAG 的对比度
* 每页最多 **4 个要点**（每点 ≤ 8 词）
* **演讲者备注**放在 `narration` 中；屏幕文字尽量少

### 导出前先做计划

使用[计划模式](/cn/guides/operation-modes)在不生成文件的情况下预览设计改进步骤：

```bash theme={null}
arka mode plan
arka "improve pitch slide design for terminal AI agents"
arka mode agent
arka compose_slides compose --topic "terminal AI agents" --style pitch --theme dark -f pptx
```

## 导出格式

| 标志        | 输出                           |
| --------- | ---------------------------- |
| `-f pptx` | PowerPoint（需要 `python-pptx`） |
| `-f pdf`  | PDF 导出                       |
| `-f html` | HTML 幻灯片                     |
| `-f md`   | Marp markdown 大纲             |
| `-f all`  | 全部格式                         |

幻灯片默认保存到 `~/Documents/arka-slides/`。

<Note>
  如果 pptx 校验失败，Arka 会移除无效文件并改为保存 **markdown 大纲**。对 Keynote 用户，PPTX 导出默认保持保守；仅在 `SLIDES_PPTX_NOTES=1` 时启用演讲者备注。
</Note>

## 转换已有幻灯片

```bash theme={null}
arka compose_slides convert deck.pptx --format pdf
```

## 质量标准

* 每页一个观点
* 行动式标题（而非泛化的 "Background"）
* 通常 6–12 页
* 演讲者备注放在 `narration`；屏幕上最多 4 个要点

## 相关内容

* [技能目录](/cn/guides/skills) — 媒体分节中的 `compose_slides` 一行


## Related topics

- [多提供商故障切换的 LLM 编排](/cn/concepts/llm.md)
- [使用 pytest 套件测试 Arka](/cn/guides/testing.md)
- [合成视频](/cn/guides/compose-video.md)
- [2026 年 7 月 13 日当周](/cn/changelog/2026-07-13.md)
- [运行模式](/cn/guides/operation-modes.md)