前言¶
在全国大学生职业规划大赛（第四届）材料链里，生涯报告可以用 zgs-review、问答可以用 zgs-qa 辅助，但现场播放的路演 PPT 往往仍靠手工排版：页型不统一、页数与组别规则对不齐、改一版就要在 PowerPoint 里逐页改。DeepSeek Harness（DSH）把能力拆成可安装的插件；John-20260101/zgs-ppt 针对「生涯发展展示 / 求职综合展示」这一路演稿，把散材料收成结构化大纲，经确认后再渲染可编辑 .pptx，并附带双层审计与可选 PDF 预览。下面介绍它的定位、流程与安装用法。
这是什么¶
zgs-ppt 是 maintainer John-20260101 发布的 DSH/Claude 技能（GitHub 仓库 John-20260101/zgs-ppt，当前 package 版本 0.4.3，MIT 许可证）。社区目录分类为工作流；SkillHub 上架名为「职规赛路演PPT制作」（@user_3b69e11c/zgs-ppt）。
成品按阅读型版面组织：页数按组别约 15–20 页（示例成稿为 13 页起），强调「不看人讲也能读懂」；写大纲前会对照上一届（第三届）金奖项目的结构规律（见仓库 references/awarded-cases.md）。
核心功能¶
与同类材料的分工¶
职规赛「三件套」里，本插件补的是现场放的 PPT 这一段：报告、问答另有技能，本包专注 deck 生成与版式自检。
主流程（SKILL.md）¶
- 把用户材料收成素材卡（18 字段，见
references/material-intake.md）。 - 按组别套用七段式页面骨架（成长 / 就业 / 职教三套 13 页骨架，见
references/page-skeletons.md）。 - 先出逐页大纲供确认，再进入渲染；大纲以
outline.json为唯一事实源，大纲 md 为其视图——改内容只改 JSON，再重跑渲染，不直接改.pptx（否则下次重跑会丢改动）。 - 自检通过后渲染可编辑
.pptx。 - 交付时附审计报告：溢出、压字、页数、维度覆盖、素材缺口等。
页型与脚本¶
- 17 种页型的字段与文案上限见
references/slide-types.md。 scripts/build_pptx.py：outline.json→.pptx，含估算审计，可导出 PDF。scripts/verify_pptx.py：渲染复核（转 PDF 查越界、压字、过小字号）。scripts/check_deck.py：文件级检查（页数、尺寸、备注）。scripts/extract_content.py：从 docx/pptx/pdf/md/txt 抽取材料（带页码锚点）。- 内置 3 套主题色（
assets/themes.json：academic/tech/warm）。
双层审计¶
一层在渲染前做估算布局审计；一层在成稿后做渲染复核。审计还会关注每页字数（少于 90 字报「信息量偏少」，多于 520 字建议拆页）。缺图会画占位框并在审计里列出；不生成图片素材。
安装与启用¶
插件以当前 DSH 进程权限运行，安装前建议浏览仓库源码与 LICENSE，确认符合你的使用环境。
方式一：DSH 插件（README 推荐）¶
dsh plugin --profile default add github:John-20260101/zgs-ppt
包内通过 dsh.bundle（cordis.patch.yml + lib/index.js）注册；装好后 SKILL.md 出现在会话技能目录。修改 SKILL.md 后 provider 会热刷新，无需重装插件。
依赖：Node.js >= 18（插件层）；Python 3.9+ 及 python-pptx、python-docx、Pillow（渲染层）。可选：pdftotext（读 PDF 材料）、soffice（导出 PDF）。
pip3 install python-pptx python-docx Pillow
方式二：SkillHub¶
skillhub install zgs-ppt --namespace user_3b69e11c
或在网页复制安装提示词：请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3b69e11c/zgs-ppt。
Skill 页面：https://skillhub.cn/skills/user_3b69e11c/zgs-ppt。
自检¶
node scripts/smoke_plugin.mjs
python3 scripts/build_pptx.py examples/case-wang/王某某-outline.json --audit-only
发布包不含 .pptx / .pdf / .docx，但保留示例 outline.json 与大纲/审计文档；装好后可直接复现 13 页成稿：
python3 scripts/build_pptx.py examples/case-wang/王某某-outline.json
典型用法¶
对 agent 用自然语言说明赛道、组别与材料即可，README 中的示例包括：
- 「帮我用这份生涯发展报告做职规赛 PPT，就业赛道职教组」
- 「我是成长赛道高教组，目标岗位芯片测试工程师，先出个 PPT 大纲」
- 「这套大纲可以，套我们学校模板生成，要 PDF」
经过上面的步骤，你会先拿到可确认的逐页大纲，再得到 .pptx 与审计说明；PDF 预览主要用于查版式，字体替换取决于本机字体环境，最终外观请在 PowerPoint 确认。
适用场景与注意¶
适合：参加第四届全国大学生职业规划大赛、需要按组别产出阅读型路演 PPT 的选手或辅导老师；已在用 DSH 或 SkillHub 技能链、希望与 zgs-review / zgs-qa 并列补齐 PPT 环节的团队。
注意：
- 内置版式是结构优先的通用版面（17 种页型），不做花哨动画/图表；精细视觉可再接
pptx/office-pptx等技能美化。 - 阅读型不等于塞满文字；审计会约束单页信息量。
- DSH 社区目录（如 SkillHub 插件页）为独立站点，与 DeepSeek / 幻方无官方从属关系；生态理念是「一切皆插件」，按需选用即可。
结尾¶
zgs-ppt 把职规赛路演 PPT 从「手工堆页」收成「素材卡 → 确认大纲 → 渲染 + 双层审计」的可重复流程，并以 outline.json 保证后续改稿可重跑。目录与源码：
