前言¶
在 DeepSeek Harness（DSH）里做 AI 演示文稿，常见做法是自行把上游技能目录拷进工作区、手写注册与依赖说明。上游 ppt-master 本身是一套完整工作流（生成、重构、美化 PPTX，以及 Brand·Style·Layout·Deck 工作区与原生模板填充），但它与 DSH 的插件模型、解释器隔离和配置入口并不天然对齐。
dsh-ppt-master-wrapper 由维护者 SAXEM1997 发布，分类为工作流类插件。它的定位是包装层：把上游技能集逐字节 vendor 进插件，不改写内容，负责在 DSH 里注册技能、暴露生命周期工具，并可选提供 venv 解释器隔离与插件页配置卡片。
这是什么¶
一句话来说，这是 DeepSeek Harness 插件，把上游 ppt-master 技能集忠实封装进宿主：vendor 目录与上游 release 逐字节一致，包装层零改写、插件运行时无 npm 依赖，并支持用 scripts/sync-upstream.mjs 一键同步上游。
宿主侧可见 2 个技能（vendor 的 ppt-master 与一个内存合成、不落盘的入口技能 ppt-master-env）和 3 个生命周期工具，另带插件页配置卡片（需 DSH ≥ 0.2.0-rc.2；更早版本会安静降级为无卡片，其余功能不受影响）。
核心功能¶
零改写的上游技能¶
skills/ppt-master/ 与上游 release 逐字节一致，可通过上游 attribution_guard.py 完整性门。技能由 index.js 经 ctx.skills 注册；DSH 通过 resourceBase 注入技能目录绝对路径，供 agent 代入上游约定的 ${SKILL_DIR}。
三个生命周期工具¶
| 工具 | 作用 |
|---|---|
ppt_master_info |
只读：插件版本、上游版本、SKILL_DIR 绝对路径与上游仓库链接 |
ppt_master_check_env |
只读：python3 就绪、完整性门、Python 依赖状态、.env 是否存在 |
ppt_master_setup_deps |
幂等安装 requirements.txt，完成后自动复跑自检；唯一有副作用的工具（venv 的创建/删除只发生在它） |
三个工具均 venv 感知；user / breakSystemPackages 仅在系统模式下生效，venv 模式下会被忽略并在返回中注明。
可选 venv 与工具可见范围¶
插件声明 cordis Config，可通过 插件页 → 已安装 → dsh-ppt-master-wrapper 的配置卡片保存，走 volatile 快路径，保存后免重启生效（三个工具每轮现读配置）。也可编辑 profile 的 cordis.patch.yml，但保存后须重启 DSH。
venv 相关键：
| 键 | 默认 | 说明 |
|---|---|---|
venv.enabled |
false |
是否启用 venv 解释器隔离 |
venv.path |
~/.ppt-master/venv |
venv 目录（绝对路径或 ~ 前缀） |
venv.oldPathPolicy |
keep |
改路径后旧 venv：keep / delete |
工具可见范围：
| 键 | 默认 | 说明 |
|---|---|---|
scope.mode |
global |
global 或 selected（仅名单内工作区可见） |
scope.workspaceIds |
[] |
工作区 id 字符串数组 |
selected 模式下依赖宿主注入 agents / workspaceRegistry 与 tools.restrict / tools.guard；已知限制是只收窄工具、不收窄技能条目。
同步上游¶
维护者可用 node scripts/sync-upstream.mjs 从默认上游 https://github.com/hugohe3/ppt-master.git 下载、过完整性门、替换 skills/ 并 bump 版本。结构变化时会停下并写 sync-report.txt（退出码 2），需人工确认后以 --confirm-structural 重跑。
当前插件版本（package.json）：6.7.1-r3（版本策略为镜像上游版本，包装层自身变更追加 -rN 后缀）。
安装与启用¶
前置依赖¶
| 依赖 | 备注 |
|---|---|
| DeepSeek Harness | 配置卡片需 DSH ≥ 0.2.0-rc.2 |
| Node.js ≥ 20 | 插件与工具运行时，无 npm 运行时依赖 |
| python3 ≥ 3.10 | 上游脚本与完整性门；建议 python3-venv 可用 |
| pip3 | venv 模式下使用 <venv>/bin/pip3 |
| git / tar | 仅同步上游时需要 |
安装到 DSH¶
# 方式一：GitHub 直接安装（推荐）
dsh plugin --profile <name> add https://github.com/SAXEM1997/dsh-ppt-master-wrapper.git
# 方式二：本地路径 link（开发机）
dsh plugin --profile <name> add link:/path/to/dsh-ppt-master-wrapper
安装后重启会话，ppt-master 技能即对 agent 可见。客户端半边（配置卡片）须宿主重启一次才首次装载；之后卡片保存配置即免重启生效。
典型用法¶
经过上面的安装，建议按 README 的首次使用顺序操作：
- 调用
ppt_master_check_env，确认 python3、完整性门与依赖状态。 - 调用
ppt_master_setup_deps（幂等），或手动执行：
pip3 install -r skills/ppt-master/requirements.txt
- 若需上游图像生成脚本，在会话工作目录（
.env查找顺序第 1 位）按需配置：
cp skills/ppt-master/.env.example .env
按 .env.example 内注释填写 IMAGE_BACKEND 与对应 key/model；也可用进程环境变量。插件工具不读取、不回显 .env 内容。
日常诊断可先调用 ppt_master_info 核对版本与 SKILL_DIR，再用 ppt_master_check_env 看环境是否就绪，然后在 agent 会话中使用 ppt-master 技能按上游 SKILL.md 工作流操作 PPTX。
适用场景与注意¶
适合谁：已在 DSH 中运行 agent、希望直接使用 ppt-master 全套演示文稿能力、又不想自己维护 vendor 与注册逻辑的开发者。
权限与安全：插件以当前 dsh 进程权限运行；ppt_master_setup_deps 会安装 Python 包并可能创建 venv。安装前应阅读仓库源码与 MIT 许可证，确认符合你的环境与合规要求。
配置与重启：卡片改 venv.* / scope.* 不需重启；改 package.json 的 dsh.client 声明或手工编辑 profile patch 需要重启。合成入口技能 ppt-master-env 的正文为注册期快照，改 venv 后实时状态以 ppt_master_info / ppt_master_check_env 为准。
生态说明：DSH 社区插件目录（如 SkillHub 上的条目）是独立站点，与 DeepSeek / 幻方无官方从属关系；本文事实以插件 GitHub README 与 package.json 为准。
结尾¶
dsh-ppt-master-wrapper 的价值在于：把上游 ppt-master 原样装进 DSH，用三个工具管环境与依赖，用配置卡片管 venv 和工具可见范围，维护者还可脚本同步上游。若你要在 Harness 里稳定跑 PPT 工作流，可从目录页或仓库 README 开始安装与自检。
