前言¶
在全國大學生職業規劃大賽（第四屆）材料鏈裏，生涯報告可以用 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 保證後續改稿可重跑。目錄與源碼：
