前言¶
手里只有别人发来的 PPT 截图、会议录屏里的单页画面，或 PDF 导出的图片时，常见做法是整页贴进新幻灯片里当背景图。文字改不了、版式动不了，后续微调成本很高。若希望 Agent 按画面结构写出可编辑的 .pptx，而不是只堆图片，可以装一个面向「截图/图片 → PPTX」的 Skill。下面介绍 SkillHub 社区技能 ppt截图转文档-简陋版（坐标 @user_057c4a74/pptpic-to-ppt）的定位与用法。
这是什么¶
ppt截图转文档-简陋版 是 SkillHub 上的社区 Skill（来源 community，发布者 user_057c4a74），当前版本 1.0.2，分类为 office-efficiency。官方简介：将 PPT 截图/图片高保真还原为可编辑的 PPTX。
技能包内 SKILL.md 对外的逻辑名称为 ppt-painter，说明文档标题为「PPT Painter」。实现思路是：Agent 读取截图后，用 PptxGenJS 和包内脚本助手生成 Node.js 代码并执行，输出 .pptx；强调自动检测依赖、缩短视觉分析输出，走「快路径」执行。平台标签标明 requires_api_key=false，安装与按文档跑流程时不需要单独配置 API Key。
SkillHub 页面统计（以平台展示为准）：评分 100000，下载 1107 次。
核心功能¶
以下能力均来自已安装的 SKILL.md 与技能包脚本，未超出官方说明。
- 输入：用户提供的 PPT 幻灯片截图或其它图片。
- 输出：可编辑的
.pptx文件（16:9，宽 10 inch、高 5.625 inch）。 - 环境：执行前在工作区检测
node_modules/pptxgenjs，缺失则npm install pptxgenjs；可按需安装sharp等依赖。 - 版式模板：
- 默认：暖色商务风，参考scripts/warm-business-template.js，主色含#E84536、#F2943A、#FFC000。
- 仅当用户明确要求冷色/蓝色时：参考scripts/quick-start-template-light.js。 - 编码约束：网格与安全边距（
x + w <= 9.8，y + h <= 5.4）、行列对齐、字号区间、十六进制颜色、文本用反引号包裹；可require('./pptx-helpers.js')复用组件。 - 触发词（技能元数据）：图片转 PPT、截图转 PPT、
ppt-painter、screenshot to ppt、图片还原 PPT 等。
技能名称带「简陋版」，表示这是社区作者的轻量实现，复杂版式或像素级还原需自行评估效果。
安装与启用¶
方式一：SkillHub CLI¶
先确认本机是否已有 skillhub（未安装可参考 SkillHub 安装说明）。安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。
skillhub install pptpic-to-ppt --namespace user_057c4a74 --dir <你的 Agent skills 目录>
常用目录示例（来自官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
方式二：让 Agent 按文档安装¶
SkillHub 技能页给出的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_057c4a74/pptpic-to-ppt`。
安装完成后，在支持 Skills 的客户端中启用该技能，对话时用上文触发词或自然语言描述「把这张 PPT 截图做成可编辑 PPTX」即可路由到本 Skill。
典型用法¶
技能定义的是 Agent 执行流程，而不是单独的 CLI 子命令。用户侧可复现的步骤如下。
- 准备好一张或多张 PPT 页面截图（路径或附件交给 Agent）。
- 在已启用
@user_057c4a74/pptpic-to-ppt的对话中说明需求；若需要蓝色冷色模板，需明确写出，否则会走默认暖商务模板。 - Agent 按
SKILL.md执行：
- Stage 0：Bash 检查并安装pptxgenjs。
- Stage 1：静默完成版面与结构理解，不输出冗长视觉分析报告。
- Stage 2：编写 Node.js 生成脚本（可参考包内scripts/generate-example.js等示例）。
- Stage 3：运行node 脚本名.js，生成.pptx并交付文件。
环境检测示例（与技能文档一致）：
if [ ! -d "node_modules/pptxgenjs" ]; then
npm install pptxgenjs
fi
生成阶段示例：
node your-slide-script.js
具体脚本名由 Agent 在工作区创建，以实际运行成功的文件为准。
适用场景与注意¶
适合：手头只有图片、需要在 PowerPoint 里改字改表；愿意接受「代码生成幻灯片」的方式；本机或 Agent 沙箱允许 npm install 与 node 执行。
限制与注意：
- 还原质量取决于截图清晰度与版面复杂度；技能自述追求速度，并限制 Agent 长篇分析，精细字体/特效可能与原稿有偏差。
- 依赖 Node.js 与
pptxgenjs；网络受限时需允许安装 npm 包。 - 技能要求排版不越界、同列
x、同行y对齐，复杂重叠图层需人工在 PPT 里再调。 - 名称中的「简陋版」应理解为功能边界说明，不是 SkillHub 官方产品名。
结尾¶
ppt截图转文档-简陋版 把「只有截图」的场景接到可编辑 PPTX：通过 PptxGenJS 与包内模板脚本，由 Agent 写代码、跑脚本、出文件，且无需 API Key。需要安装或查看版本时，以 SkillHub 为准。
- 技能页：https://www.skillhub.cn/skills/user_057c4a74/pptpic-to-ppt
- API 坐标：https://api.skillhub.cn/user_057c4a74/pptpic-to-ppt
