作者:互联网 时间: 2026-07-23 11:20:01
yiqxie/ppt-agentskill 这条标题的原名入口是 yiqxie/ppt-agent,真实下载页是 https://github.com/yiqxie/ppt-agent。旧地址 https://github.com/yiqxie/ppt-agentskill 不是可用仓库页,不能继续写成 404 等待稿。
PPT Slide Agent 是一个端到端 Web 应用,用来把 PPT 每页变成可复用的 prompt 模板。它会上传 PPT、把每页渲染成截图,用 Azure OpenAI GPT-4o 视觉模型提取风格、配色、字体、布局和配图信息,再把截图、prompt JSON、tag 和结构化样式存进 Azure Blob 与 PostgreSQL。

git clone https://github.com/yiqxie/ppt-agent.gitbackend/、frontend/、infra/、Dockerfile 和 .env.example。后端进入 backend 后创建 Python 虚拟环境,安装 requirements.txt,复制 .env.example 为 .env,至少填写 PostgreSQL、Azure Storage、Azure OpenAI endpoint、API key 和 vision deployment,然后用 uvicorn app.main:app --reload --port 8000 启动。
前端进入 frontend,执行 npm install,复制 .env.example,再运行 npm run dev。Vite 会把 /api 和 /ws 代理到 http://localhost:8000,浏览器访问 http://localhost:5173。

准备 2 到 3 页 PPTX,上传后看四个信号:任务进度能通过 WebSocket 更新,每页能渲染成截图,prompt JSON 能落到存储,UI 能搜索、预览、编辑标题摘要和 tag。文件上传、Blob、数据库、Azure OpenAI 任一项缺配置,都会在这一轮露出来。
这个仓库更像 PPT 设计素材库和 prompt 管理系统,不是命令行里一条提示生成整套 PPT。要部署到 Azure,可以走 README 里的 Bicep 和 Docker 流程;本地试跑先用小文件,别一上来上传大型素材库。