dsh-courseware

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

引擎需要 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 会先检查后端是否配好；没配就停下来提示你去配（不静默跳过）。