# duan-slides

AI 演示文稿全流程制作工具：内容结构化 → 设计选型 → AI 插画/HTML 构建 → PPTX 导出。

支持 17 种视觉风格（漫画/极简/数据叙事/国风），可编辑 HTML 与全 AI 视觉两条路径自由选择。

## 功能

- **html2pptx**: 将 HTML 幻灯片转换为 PPTX
- **create-slides**: 从图片创建 PPT
- **gen-image**: 使用 Gemini AI 生成图片

## 安装

```bash
# 使用 npx 直接运行（无需安装）
npx duan-slides help

# 或全局安装
npm install -g duan-slides
```

## 使用方法

### 1. HTML 转 PPTX

```bash
npx duan-slides html2pptx slide-01.html slide-02.html -o output.pptx
```

### 2. 图片转 PPT

```bash
npx duan-slides create-slides slide-01.png slide-02.png -o output.pptx
```

### 3. AI 图片生成

```bash
# 设置 API Key
export GEMINI_API_KEY="your-api-key"

# 生成图片
npx duan-slides gen-image --prompt "A beautiful sunset" --filename sunset.png

# 使用参考图生成
npx duan-slides gen-image -i style-sample.png --prompt "Same style, different content" --filename output.png
```

## 视觉风格

支持 17 种风格：
- Snoopy 漫画、Neo-Pop、浮世绘、敦煌壁画
- xkcd 白板、Neo-Brutalism、Ligne Claire
- NYT Magazine、Pentagram 编辑、Fathom 数据
- 苏联构成主义、孔版印刷、像素画
- 温暖叙事、、学習漫画、Takram 思辨

详见 [references/proven-styles-gallery.md](./references/proven-styles-gallery.md)

## 环境要求

- Node.js >= 18
- Python >= 3.10
- uv (推荐) 或 pip

## License

MIT