ppt-delivery

name	ppt-delivery
description	Convert HTML slide deck to PDF and send to Feishu user. Use when the user asks to generate a PPT/presentation and deliver it as a PDF file via Feishu message. Triggers on: "做PPT", "做个演示", "生成PPT", "做幻灯片", "发送PDF", "转PDF", "做报告", or when a PPT/slide task is completed and needs delivery. This skill covers the full pipeline: HTML slides → font scaling → PDF conversion → Feishu file upload & send.

PPT Delivery — HTML 演示文稿转 PDF 并发送飞书

完整流程：生成 HTML 幻灯片 → 放大字体 → 转 PDF → 上传飞书发送给用户。

前置依赖

• chromium-browser（已安装）
• puppeteer-core（全局 npm 包）
• pdf-lib（全局 npm 包）
• Python 3 + requests（已安装）
• 飞书机器人已配置（openclaw.json 中有 APP_ID/SECRET）

工作流程

Step 1: 生成 HTML 幻灯片

使用 frontend-slides 或 jobs-style-ppt-generator skill 生成 HTML 文件。

Step 2: 字体放大（必须）

用户通常反馈字体太小，默认执行两轮放大：

第一轮放大（CSS 修改）：

• body font-size → 22px
• 所有 ≤1rem → ×1.25
• 所有 1~1.5rem → ×1.35
• 所有 clamp() 值 → ×1.2
• 卡片 padding → ×1.2

第二轮放大（如用户仍嫌小）：

• body font-size → 26px
• 所有字号 → 再 ×1.2
• clamp() 值 → 再 ×1.15
• 卡片 padding → 再 ×1.15

始终保持标题/正文层级关系。

Step 3: HTML 转 PDF

使用脚本逐 slide 截图嵌入 PDF，保证视觉一致性：

NODE_PATH=$(npm root -g) node <skill_dir>/scripts/html2pdf.cjs <input.html> <output.pdf>

参数：

• --width 1920（默认）
• --height 1080（默认）

输出：多页 PDF（每页一张幻灯片截图）。

Step 4: 发送飞书文件

将 PDF 通过飞书 Bot API 发送给用户：

python3 <skill_dir>/scripts/send_file_feishu.py <pdf_path> <user_open_id>

user_open_id 从消息的 inbound metadata sender_id 获取。

完整示例

1. UI agent 生成 /root/projects/report.html
2. 字体放大（两轮）
3. NODE_PATH=$(npm root -g) node ppt-delivery/scripts/html2pdf.cjs /root/projects/report.html /root/projects/report.pdf
4. python3 ppt-delivery/scripts/send_file_feishu.py /root/projects/report.pdf ou_xxxxx
5. 回复用户："PDF 已发送 📎"

注意事项

• PDF 文件大小通常 1-3MB（5-10 页）
• 如果 chromium 截图有渲染问题，检查字体是否加载完成（脚本内置 3 秒等待）
• 飞书发送需要 bot 有 im:message:send_as_bot 权限
• 文件类型支持：pdf、doc、xls、ppt、mp4、opus