dsh-courseware

把 DeepSeek Harness 的 courseware 技能（中小学课件生成）及其 pptxgen 引擎 打包成官方可安装的 DSH 插件包：dsh plugin --profile <名字> add <本包>。

安装后，profile 里每个 agent 的技能目录都会出现 courseware 技能： 拿用户自己的 .pptx 模板 + 一份课程大纲（教案/文档/纯文本），产出套用该模板 背景、配色、字体、页面骨架的课件 .pptx。

包内结构

dsh-courseware/
├── package.json          type:module + main:lib/index.js + dsh.bundle.patch（命门）
├── cordis.patch.yml      把本包插成一行，loader 才会加载它
├── lib/index.js          零依赖提供器：扫描 skills/ 注册进 ctx.skills
├── skills/courseware/    SKILL.md + workflows/ + references/
└── engine/               pptxgen 引擎源码 + pptxgen.sh + requirements.txt

安装

前置：已装 DeepSeek Harness + pnpm（dsh plugin 内部调用 pnpm）。

# 本地文件夹（pnpm 链接安装，改完重启 profile 即生效，适合开发）
dsh plugin --profile web add /路径/到/dsh-courseware

# 发布到 npm 后（推荐）
dsh plugin --profile web add dsh-courseware

# 或 GitHub / tarball
dsh plugin --profile web add https://github.com/你的账号/dsh-courseware.git
dsh plugin --profile web add /路径/to/dsh-courseware-0.1.0.tgz

安装后重启 profile（停掉重跑 dsh web，刷新浏览器），然后验证：

dsh --profile web --dump-config     # 输出里应出现 dsh-courseware 行

agent 的技能目录里应出现 courseware，可用 skill 工具加载。

卸载：

dsh plugin --profile web remove dsh-courseware

必须用 dsh plugin 形式安装。直接 npm install 只会把包当普通库装进当前 目录，不会注册进任何 profile，技能永远不会被加载。

首次使用：初始化引擎（一次性）

引擎需要 Python 3.10+，首次跑课件前初始化虚拟环境：

python3 -m venv "<引擎目录>/.venv"
"<引擎目录>/.venv/bin/pip" install -r "<引擎目录>/requirements.txt"

引擎目录 = 技能目录的上两级（agent 会自行按此规则定位）；也可用环境变量 PPTXGEN_ENGINE_HOME 指向自备引擎。

另外，check --render 与 preview 需要本机装有 LibreOffice（macOS： /Applications/LibreOffice.app）；仅 build 不依赖它。模板用到的字体 （如 华文琥珀/微软雅黑）在目标机器上缺失时，字号会退化，建议装齐常用中文字体。

图片后端配置 —— 本包不含任何密钥

包里没有任何 API key、也没有任何密钥配置（引擎源码只有占位符；~/.pptxgen/config.yaml 在用户侧，不在包内）。每个使用者装好后自己配：

方式一：环境变量

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

引擎的图片配置优先级：环境变量 > 课件 options.images > 用户配置文件。 生成配图时 agent 会先检查后端是否配好；没配就停下来提示你去配（不静默跳过）。

发布到 npm 的注意

• package.json 的 files 白名单已排除 .venv/、__pycache__/、.git/ 等； 发布前再跑一遍 npm pack --dry-run 确认包内没有任何密钥文件。
• 发布前先在干净的 profile 上本地安装验证一遍（上面"安装"节）。
• 包名 dsh-courseware 如与 npm 已有包冲突，可改成带 scope 的 @你的账号/dsh-courseware（改 package.json 的 name 与 cordis.patch.yml 的 name 两处即可）。
• 技能内容更新：改 skills/courseware/ 后重新发布即可，无需改代码 （提供器自动发现新技能/新文件）。
• 引擎更新：替换 engine/pptxgen/ 内容后重新发布。

License

MIT。技能内容与引擎源码版权归原作者。