前言¶
做技術彙報或項目答辯時，常見的做法是把內容丟給模型，讓它生成一份 PPT，結果要麼頁面文字堆疊、要麼中文字體回退成方塊，導出的 PPTX 格式也常不可編輯。wangzw928/career-pptagent 面向的是另一條路徑：本地 Skills + 工作流，先產出 HTML 源稿，再渲染檢查、構建可編輯 PPTX、導出複查，最終按 finalize 驗收交付。它由 WangZW928 維護，來源是 icip-cas/PPTAgent 的 Skill 版本（基準提交 833cda553b343be0e486a93b0b57cac962cdd566），不是上游官方發行版。
這套插件屬於 DSH 的工作流分類，適合需要在 Linux（含 WSL）或 macOS 上批量產出中文技術演示稿、並把流程固定下來的開發者。
這是什麼¶
一句話定位：把「HTML 源稿 → 逐頁檢查 → 可編輯 PPTX → 導出複查 → finalize 驗收」這條鏈封裝成 DSH 插件，同時附帶一套 concise-business-ppt-style 簡潔商業風格規則，默認收斂爲白底、深藍標題、兩到三檔字號層級。
它解決的問題具體有三個：
- 中文場景下的字體、換行、回退和頁碼問題有統一檢查項，而不是手工調。
- 交付物是可編輯 PPTX，不是圖片或只讀文件。
- 風格規則內置，模型不需要臨場發揮設計，避免口號堆疊和裝飾填充。
倉庫不包含個人 PPT 或項目數據，只保留通用技能、風格規則和運行工具。上游原始說明和 MIT 許可證保留在 .agents/skills/pptagent/。
核心能力¶
下面這些能力都有文檔支撐，不是推測。
本地工作流特化。 統一 Linux / macOS 啓動入口，隔離不同平臺的運行依賴，保留 HTML 源稿、可編輯 PPTX、逐頁渲染檢查、導出複查和 finalize 驗收流程。
簡潔商業風格特化。 通過 concise-business-ppt-style skill 收斂默認設計：白底深藍、單行摘要標題、少量字號層級、規整對齊、真實證據圖，減少宣傳式口號與裝飾。機制用流程圖，結果用真實曲線、表格、雲圖或代碼，不用插畫填充空白。保留數據口徑、個人貢獻邊界和實驗限制。
平臺適配。 支持 DSH 0.2.1-rc.5 / 0.2.1、Node.js 22+、Linux / WSL 與 macOS。Windows 原生環境請用 WSL。插件提供 Host 級技能，無需前端構建，不修改用戶的共享技能目錄。
繪圖與連接能力。 倉庫結構裏除了核心 PPTAgent skill，還包含 agentdraw（可編輯視覺圖解）、opendiagram（架構、流程、時序和 ER 圖）、colorfigures（交互式機制插畫）、comfyui（ComfyUI 圖像生成連接）、paper2any（Paper2Any 工作流連接）、agent-reach（只讀內容檢索）和 humanizer-zh（中文文案自然化複覈）。
安裝與啓用¶
插件的安裝命令來自 README 原文，安裝的是發佈版的 .tgz。
dsh plugin --profile web add https://github.com/WangZW928/Career-PPTagent/releases/download/v0.1.0/dsh-career-pptagent-0.1.0.tgz
按宿主提示啓用插件後，新會話調用 career-pptagent（獨立入口），即可選擇本插件的簡潔商業演示工作流。Desktop 用戶請在應用實際使用的 profile 中安裝，而不是盲目使用 web。已有項目或用戶目錄中的同名 pptagent 技能優先，插件不會覆蓋它們。
安裝插件不會自動下載 Python、Chromium 或其他大體積依賴。首次使用需要先裝好系統級前提：LibreOffice 和中文字體，再顯式初始化。對於標準 web profile，依次執行：
PLUGIN="${DSH_HOME:-$HOME/.dsh}/profiles/web/node_modules/dsh-career-pptagent"
node "$PLUGIN/plugin/cli.js" setup
node "$PLUGIN/plugin/cli.js" pptagent doctor --workspace "$PWD"
node "$PLUGIN/plugin/cli.js" pptagent init --workspace "$PWD/presentation" --slides 8 --language zh
node "$PLUGIN/plugin/cli.js" pptagent scaffold --workspace "$PWD/presentation"
setup 準備運行環境，doctor 檢查環境是否就緒，init 創建任務，scaffold 生成初始 HTML。其他 profile 請替換路徑中的 web。
插件模式的本地依賴放在版本隔離的用戶緩存裏：Linux 默認 ~/.cache/dsh-career-pptagent/0.1.0/<platform>，macOS 默認 ~/Library/Caches/dsh-career-pptagent/0.1.0/<platform>。可以用絕對路徑 PPTAGENT_RUNTIME_HOME 覆蓋。
如果繪圖或 diagram 工作流也需要，補兩步初始化：
node "$PLUGIN/plugin/cli.js" setup-illustrations
node "$PLUGIN/plugin/cli.js" setup-opendiagram
插件不自動配置 ComfyUI、Paper2Any 或任何 API 憑據，密鑰需要通過運行環境傳入。離線運行需要提前完成依賴安裝。
典型用法¶
初始化完成後，後續流程由宿主 Agent 編輯 HTML，然後執行逐頁檢查、構建、導出複查和 finalize，最終以 final-report.json 中 complete=true 作爲交付依據。
也可以直接對編碼助手說：
使用 pptagent 和 concise-business-ppt-style，製作一份 8 頁中文項目答辯 PPT。
原倉庫方式（不走插件）也可以跑通，適合想先看效果的場景。先安裝依賴並診斷：
bash scripts/setup-pptagent.sh
./bin/pptagent doctor --workspace "$PWD"
再創建任務並生成初始 HTML：
./bin/pptagent init --workspace "$PWD/outputs/presentation" --slides 8 --language zh
./bin/pptagent scaffold --workspace "$PWD/outputs/presentation"
驗證環節可以跑完整測試：
source scripts/runtime-env.sh
"$PPTAGENT_PYTHON" -m pytest tests .agents/skills/pptagent/tests
標準驗收包括 HTML 渲染、逐頁視覺檢查、可編輯 PPTX 構建與實際導出檢查、中文 glyphs 與字體回退檢查、連接器測試，生成物保存在本地 outputs/。
適用場景與注意¶
適合：需要在 Linux / macOS 上產出中文技術彙報、項目答辯或商業演示稿，並且希望可編輯 PPTX 是真實能用的，流程要可復現的團隊或個人。倉庫明確說明上游許可證爲 MIT，其他第三方技能的許可證在各自目錄。
需要留意的地方：
- 插件以當前 dsh 進程權限運行。安裝前應檢查源碼與許可證，確認命令和腳本符合自身環境要求。
- 插件不自動下載運行時依賴，首次使用必須先裝好 LibreOffice 和中文字體，否則
doctor會報告缺失。 - Windows 原生暫未支持，只能用 WSL。
- 項目或用戶目錄下的同名技能優先於插件，
career-pptagent是顯式選擇本插件的入口；想強制走插件時要注意命名衝突。 - 卸載在宿主插件管理頁移除即可（CLI 可用
dsh plugin --profile web remove dsh-career-pptagent），不會刪除用戶 PPT 工作區或版本緩存。 - 升級版本需要再次初始化新版本緩存，舊緩存不自動刪除，也不會自動清理。
結尾¶
這套插件的價值在於把可復現的中文演示稿流程和一套固定風格捆綁在一起，減少了每次重新約定版式和檢查口徑的成本。目錄頁在 https://www.skillhub.cn/plugins/WangZW928/Career-PPTagent ，倉庫在 https://github.com/WangZW928/Career-PPTagent 。
