slides-generator

从 Markdown 内容生成 Hummingbot 品牌风格的 PDF 格式演示文稿，支持双栏布局及 Mermaid 图表渲染，适用于技术架构图与流程图。

工作流

步骤 1：获取 Markdown 内容

请用户提交一个 Markdown 文件，或直接粘贴 Markdown 内容。内容需遵循以下格式：

# 演示文稿标题

## 1. 第一张幻灯片标题

第一张幻灯片的内容，可包含：
- 项目符号列表
- **粗体文本** 和 *斜体文本*
- 代码块

## 2. 第二张幻灯片标题

此处为更多内容。

## 3. 第三张幻灯片标题

依此类推……

格式规范：

• # 标题 = 演示文稿总标题（可选，将作为封面页）
• ## N. 幻灯片标题 = 新建幻灯片（N 为序号）
• 每个 ## 标题下的内容即为该幻灯片正文
• 支持标准 Markdown 格式：列表、粗体、斜体、代码块、链接等

步骤 2：解析并确认

在生成 PDF 前，先解析 Markdown 并向用户展示摘要信息：

📊 幻灯片大纲：

1. 第一张幻灯片标题
2. 第二张幻灯片标题
3. 第三张幻灯片标题
...

总计：X 张幻灯片

请确认是否继续生成 PDF，或提供修改意见。

等待用户明确确认后，再执行后续操作。

步骤 3：生成 PDF

运行生成脚本：

bash <(curl -s https://raw.githubusercontent.com/hummingbot/skills/main/skills/slides-generator/scripts/generate_slides.sh) 
  --input "" 
  --output ""

若用户提供的是内联 Markdown 内容，则需先保存至临时文件：

# 将内容保存至临时文件
cat > /tmp/slides_content.md << 'SLIDES_EOF'

SLIDES_EOF

# 生成 PDF
bash <(curl -s https://raw.githubusercontent.com/hummingbot/skills/main/skills/slides-generator/scripts/generate_slides.sh) 
  --input /tmp/slides_content.md 
  --output ~/slides_output.pdf

步骤 4：交付结果

生成完成后，向用户说明：

• PDF 文件的保存路径
• 共生成多少张幻灯片
• 如需，可协助打开或预览该 PDF 文件

编辑已有幻灯片

若用户希望修改此前已生成的 PDF 对应的幻灯片：

1. 读取原始 Markdown 文件（如有）或查看当前 PDF以了解现有内容
2. 询问用户希望进行哪些修改：
   • 编辑某张幻灯片的具体内容
   • 新增幻灯片
   • 删除幻灯片
   • 调整幻灯片顺序
3. 对 Markdown 源文件应用相应修改
4. 重新生成 PDF

如仅需更新部分幻灯片，可使用 --edit 参数避免全量重生成：

bash <(curl -s https://raw.githubusercontent.com/hummingbot/skills/main/skills/slides-generator/scripts/generate_slides.sh) 
  --input "" 
  --output "" 
  --edit

图表

用户可通过自然语言描述图表，并使用 mermaid: 前缀标识。**你必须将这些自然语言描述翻译为合法的 Mermaid 代码**，方可完成 PDF 渲染。

用户输入格式

用户输入类似如下描述：

mermaid: 一个流程图，展示用户界面连接至 Condor 和 MCP Agents，二者均连接至 Hummingbot API（高亮），再连接至 Client，最后连接至 Gateway

翻译为 Mermaid 代码

将上述描述转换为符合语法规范的 Mermaid 代码：

```mermaid
flowchart TB
    A[User Interface] --> B[Condor]
    A --> C[MCP Agents]
    B --> D[Hummingbot API]
    C --> D
    D --> E[Hummingbot Client]
    E --> F[Gateway]
    style D fill:#00D084,color:#fff
```

图表类型

• flowchart TD — 自上而下的流程图
• flowchart LR — 自左向右的流程图
• sequenceDiagram — API 调用与交互时序图
• classDiagram — 面向对象设计类图
• erDiagram — 数据库实体关系图

高亮显示

使用 style NodeName fill:#00D084,color:#fff 实现 Hummingbot 绿色高亮效果。

依赖要求

Mermaid 图表渲染依赖 Mermaid CLI 工具：

npm install -g @mermaid-js/mermaid-cli

代码块

使用标准的三重反引号 ``` 包裹 ASCII 图、代码片段或预格式化文本：

```
Price
  ^
  |  [BUY] --- Level 3
  |  [BUY] --- Level 2
  |  [BUY] --- Level 1
  +-------------------> Time
```

代码块将以等宽字体、灰色背景渲染。

双栏布局

当某张幻灯片同时包含项目符号列表和图表时，系统将自动启用双栏排版：

• 左栏：文字内容
• 右栏：图表

## 4. 工作原理

核心特性：
- 自动化订单提交
- 动态仓位管理
- 风控驱动的执行逻辑
- 实时监控能力

mermaid: 流程图展示市场数据 → 策略 → 订单

经翻译后：

## 4. 工作原理

核心特性：
- 自动化订单提交
- 动态仓位管理
- 风控驱动的执行逻辑
- 实时监控能力

```mermaid
flowchart TD
    A[Market Data] --> B[Strategy]
    B --> C[Orders]
    style B fill:#00D084,color:#fff
```

Markdown 示例

# Q4 产品更新

## 1. 概览

今天我们将介绍：
- 产品里程碑
- 关键指标
- 路线图预览

## 2. 架构

系统组成模块：
- 面向用户的接口
- 核心 API 层
- 交易所连接层

mermaid: 流程图展示 UI → API（高亮）→ Gateway

## 3. 关键指标

| 指标 | Q3 | Q4 | 变化 |
|--------|----|----|--------|
| 用户数 | 10K | 15K | +50% |
| 收入 | $100K | $150K | +50% |

## 4. Q1 路线图

1. 移动端 App 上线
2. 企业级服务套餐
3. 国际市场拓展

## 5. 提问环节？

谢谢！

联系邮箱：team@example.com

将 mermaid: 描述翻译后：

## 2. 架构

系统组成模块：
- 面向用户的接口
- 核心 API 层
- 交易所连接层

```mermaid
flowchart TD
    A[UI] --> B[API]
    B --> C[Gateway]
    style B fill:#00D084,color:#fff
```

依赖项

脚本将自动检测并按需安装以下依赖：

• Python 3
• fpdf2 Python 包（用于 PDF 生成）

故障排查

脚本清单