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。
