Fast PPT

把 PDF/文档做成可编辑 PPTX（云端处理），完成后返回 ppt.siping.me 下载链接。上传前须告知用户文件会传到第三方服务器。PDF 支持 AI 主题或仅转换。触发：改成ppt、做成幻灯片、仅转换、fast-ppt。

用户要 文件 → 调用 pingPPT API（Fast PPT skill 后端）→ 回复 https://ppt.siping.me/... 下载链接（不是本地路径、不是 API IP）。

---

隐私与数据外传（Agent 必读）

本 skill 会把用户文件完整上传到第三方云端服务处理，内容会离开用户本机。 在用户第一次上传前，或文件可能含敏感信息时，必须先告知并取得同意，再调用 API。

须向用户说明的要点（用 plain language，不要省略）：

项	说明
处理位置	文件上传到 pingPPT 云端（API：47.103.80.109；用户可见下载域名：ppt.siping.me），在远程服务器解析、生成 PPTX，不是本地离线转换
谁可接触	文件与生成结果由 siping.me 运营方 的服务器处理；下载链接经 ppt.siping.me 对外提供
AI 主题模式	默认模式会把文档内容 送入 LLM 按主题重排；仅转换（convert_only）不走 LLM，但仍需上传 PDF 到云端
保留时间	上传文件与导出 PPTX 通常在服务器上 约 24 小时内清理（运维策略，不保证合规级留存期限；勿当作长期归档）
不适合	涉密、未公开商业、个人身份/医疗/财务、受监管或合同禁止外传的文档 —— 默认不要上传；若用户坚持，须明确风险提示后再执行

Agent 执行前检查：

1. 文件名/用户描述若含「机密 / 内部 / 合同 / 客户资料 / 身份证 / 病历」等 → 先问「该文件将上传到 siping.me 云端处理，是否继续？」
2. 用户未确认 → 不要上传；可建议本地工具或脱敏后再试
3. 用户已确认 → 再执行下方 curl 流程
4. 回复用户时 不要 声称「完全本地」「不上传服务器」

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

两套地址（必须分清）：

用途	地址
Agent 调 API（上传/轮询/内部下载）	http://47.103.80.109:8080
发给用户的下载链接	轮询 done 后 JSON 里的 download_url（https://ppt.siping.me/v1/jobs/{id}/download）

勿把 47.103.80.109、相对路径 /v1/jobs/... 或本地 .pptx 路径发给用户。

---

用户怎么说

text

把 report.pdf 做成 PPT，主题 kubernetes_blueprint_2026

text

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

text

把 手册.pdf 仅转换 成 PPT

text

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

text

有哪些 PPT 主题？

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

---

从用户消息提取

项	规则
文件	PDF / PPTX / DOCX / MD / TXT 等工作区路径
theme	用户写的主题 id；未写则用 kubernetes_blueprint_2026（仅转换模式可省略）
mode	见下方 PDF 处理模式

---

PDF 处理模式

模式	API mode	适用	效果
AI 主题排版（默认）	不传或 theme	PDF / Word / MD 等	转 Markdown → LLM 按主题重排幻灯片
仅转换	convert_only	仅 PDF	每页 PDF → 一页 PPT；背景/图片保留，文字可编辑；不用 LLM、不用主题

用户说法 → mode 映射：

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

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

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

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

---

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

0. API 地址

bash

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

1. 上传 → 记录 job_id

AI 主题排版（默认）：

bash

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 仅转换：

bash

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

mode 也接受：仅转换

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

bash

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

done 时响应示例：

json

{
  "job_id": "job_abc123",
  "status": "done",
  "download_url": "https://ppt.siping.me/v1/jobs/job_abc123/download"
}

status	处理
queued / processing	继续等
done	取 download_url 回复用户；可选再 curl 下载到本地
failed	用简单中文说明 error

3. 交付给用户

• 必须：把上一步 JSON 里的 download_url 原样发给用户（可点击下载 PPT）
• 可选：Agent 如需本地副本，用 API 直连下载（勿把此 URL 给用户）：

bash

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

---

回复用户

规则：只给 下载链接 + 简短说明；链接用 API 返回的 download_url，不要自己拼。

首次成功交付时（若此前未说明），补一句数据提示，例如：

说明：你的文件曾在 siping.me 云端处理；下载链接约 24 小时内有效，请勿用于长期存放敏感原件。

AI 主题排版：

你的 PPT 已生成。
主题：Kubernetes 蓝图 2026
下载：https://ppt.siping.me/v1/jobs/job_abc123/download
主题预览：https://ppt.siping.me/viewer.html?theme=kubernetes_blueprint_2026

仅转换：

你的 PPT 已生成（仅转换：保留原页背景，文字可编辑）。
下载：https://ppt.siping.me/v1/jobs/job_abc123/download

处理中：

正在生成 PPT，大约还需几分钟，完成后我会发下载链接。

禁止出现在用户回复里：job_id、API IP、/v1/jobs/... 相对路径、本地文件路径、报错 stack trace。

---

内置主题（19 套）

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

id	名称
brutalist_ai_newspaper_2026	AI 行业报纸 2026
building_effective_agents	构建高效 Agent
cangzhuo	藏拙
fashion_weekly_digest	时尚美学周鉴
general_dark_tech_claude_code_auto_mode	Claude Code 自动模式
glassmorphism_demo	毛玻璃风格演示
global_ai_capital_2026	全球 AI 资本 2026
high_rise_renewal	高层住宅「主动再生」
home_design_trends_2026	2026 家居设计趋势
image_text_showcase	图文范式展示
indie_bookstore_zine_guide	独立书店 Zine 指南
kimsoong_loyalty_programme	锦上客户忠诚计划
kubernetes_blueprint_2026	Kubernetes 蓝图 2026（默认）
lin_huiyin_architect	林徽因：当之无愧的建筑师
lin_huiyin_architect_revised	重识林徽因建筑师身份
liziqi_plant_dye_colors	李子柒植物染色彩
pritzker_2026	普利兹克奖 2026
sugar_rush_memphis	Sugar Rush 孟菲斯音乐节
swiss_grid_systems	瑞士网格系统

---

环境变量

变量	说明
PINGAI_PPT_API_URL	可选，默认 http://47.103.80.109:8080（Agent 调 API 用）
PINGAI_PPT_PUBLIC_URL	可选，默认 https://ppt.siping.me（返回给用户的下载链接前缀）
PINGAI_PPT_API_KEY	当前不需要；日后服务端开启鉴权时再配

---

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

现象	处理
401 / 403	服务端已开启鉴权，需配置 Key
503	服务未就绪
超时	换小文件或稍后重试
convert_only + 非 PDF	提示仅转换模式只支持 PDF

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