DeepSeek Harness 採用插件化架構，擴展能力通常通過安裝包實現。在生成教學課件（Courseware）時，需要結合固定的模板樣式與動態生成的課程大綱。dsh-courseware 插件將 DeepSeek Harness 原生的 courseware 技能及 pptxgen 引擎打包爲官方插件，解決手動維護模板和渲染邏輯的問題。
插件定位¶
這是一個基於模板文件和課程大綱生成 PowerPoint 文件的 DSH 插件。由維護者 lnsdlszsqxxx 提供，核心作用是將 DeepSeek Harness 的 courseware 技能和 pptxgen 引擎封裝爲官方可安裝的插件包。安裝後，每個 agent 的技能目錄會出現 courseware 技能，用於處理模板合成與渲染。
安裝與啓用¶
前置條件：環境需已安裝 DeepSeek Harness 和 pnpm。
- 執行安裝命令。
dsh plugin --profile web add /路徑/到/dsh-courseware
安裝後重啓 profile（停掉並重新運行 dsh web）以生效。
- 驗證安裝。
dsh --profile web --dump-config
輸出中應出現 dsh-courseware 行。
- 卸載。
dsh plugin --profile web remove dsh-courseware
必須使用
dsh plugin形式安裝。直接使用npm install只會把包當普通庫裝進當前目錄，不會註冊進任何 profile，技能永遠不會被加載。
首次使用：初始化引擎¶
引擎需要 Python 3.10+，首次跑課件前需初始化虛擬環境。引擎目錄通常爲技能目錄的上兩級，也可通過環境變量 PPTXGEN_ENGINE_HOME 指定。
- 初始化虛擬環境。
python3 -m venv "<引擎目錄>/.venv"
- 安裝引擎依賴。
"<引擎目錄>/.venv/bin/pip" install -r "<引擎目錄>/requirements.txt"
配置與權限¶
該插件包內沒有任何 API key 或密鑰配置。用戶需自行在環境變量或配置文件中配置。引擎的圖片配置優先級：環境變量 > 課件 options.images > 用戶配置文件。
- 環境變量方式。
export PPTXGEN_IMAGE_BASE_URL="https://你的服務商/v1"
export PPTXGEN_IMAGE_MODEL="你的模型名"
export PPTXGEN_IMAGE_API_KEY="你自己的 key"
- 用戶配置文件方式（
~/.pptxgen/config.yaml）。
images:
base_url: https://你的服務商/v1
model: 你的模型名
api_key: 你自己的 key
注意事項¶
- 渲染依賴：
check --render與preview功能需要本機安裝 LibreOffice（macOS 路徑：/Applications/LibreOffice.app）。僅build命令不依賴它。 - 字體缺失：建議安裝常用中文字體，以防模板字體在目標機器上缺失導致字號退化。
- 包內內容：包內包含 pptxgen 引擎源碼，無額外加密或密鑰文件。
總結¶
該插件通過封裝 courseware 技能和 pptxgen 引擎，將課件生成流程標準化。只需提供模板和大綱，即可產出風格一致的 PPT 文件。更多細節與源碼可訪問 GitHub。
