pingPPT

用户要 文件 → 调用 pingPPT API → 回复 .pptx 保存路径。

鉴权（当前）：API 暂不要求 PINGAI_PPT_API_KEY，curl 无需 Authorization 头。勿向用户索要密钥。

用户怎么说

把 report.pdf 做成 PPT，主题 kubernetes_blueprint_2026

把 /path/to/doc.pdf 做成幻灯片，主题 cangzhuo

把 手册.pdf 仅转换 成 PPT

把 contract.pdf 保持原样转成可编辑幻灯片

有哪些 PPT 主题？

问主题 → 发 ppt.siping.me 或贴下方主题表。

从用户消息提取

PDF 处理模式

用户说法 → mode 映射：

• 仅转换、convert only、保持原样、原样转换、不要主题 → convert_only
• 其余 → 默认 AI 主题排版

仅转换 技术要点（内部参考，勿原样甩给用户）：

• 整页渲染为背景（redact 去掉背景图里的文字，避免重影）
• cover 缩放铺满 16:9，裁切溢出，避免左右白边
• 文字按 PDF 坐标叠加为可编辑层

局限：扫描版 PDF（纯图片无文字层）暂不支持 OCR；复杂多栏版式可能有轻微偏差。

执行（上传 → 轮询 → 下载）

0. API 地址

API="${PINGAI_PPT_API_URL:-http://47.103.80.109:8080}"

1. 上传 → 记录 job_id

AI 主题排版（默认）：

THEME="kubernetes_blueprint_2026"
FILE="/path/to/source.pdf"
OUT="/path/to/output.pptx"

curl -sS \
  -F "file=@$FILE" \
  -F "theme=$THEME" \
  "$API/v1/jobs"

PDF 仅转换：

curl -sS \
  -F "file=@$FILE" \
  -F "mode=convert_only" \
  "$API/v1/jobs"

mode 也接受：仅转换

2. 轮询 — 每 15–30 秒一次，最长 30 分钟，直到 status 为 done

curl -sS "$API/v1/jobs/$JOB_ID"

3. 下载

curl -sS -o "$OUT" "$API/v1/jobs/$JOB_ID/download"

回复用户

AI 主题排版：

已生成：/path/to/report.pptx
主题：Kubernetes 蓝图 2026
预览：https://ppt.siping.me/viewer.html?theme=kubernetes_blueprint_2026

仅转换：

已生成：/path/to/手册.pptx
模式：仅转换（保留原页背景，文字可编辑）

勿堆砌 job_id、API 等技术细节。

内置主题（19 套）

theme= 填 id。预览：https://ppt.siping.me/viewer.html?theme=\x3Cid>

环境变量

出错时（内部处理，勿原样甩给用户）

对用户：生成失败，请稍后再试 + 简短原因。