前言¶

在 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}。

三个生命周期工具¶

三个工具均 venv 感知；user / breakSystemPackages 仅在系统模式下生效，venv 模式下会被忽略并在返回中注明。

可选 venv 与工具可见范围¶

插件声明 cordis Config，可通过 插件页 → 已安装 → dsh-ppt-master-wrapper 的配置卡片保存，走 volatile 快路径，保存后免重启生效（三个工具每轮现读配置）。也可编辑 profile 的 cordis.patch.yml，但保存后须重启 DSH。

venv 相关键：

工具可见范围：

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 后缀）。

安装与启用¶

前置依赖¶

安装到 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 的首次使用顺序操作：

1. 调用 ppt_master_check_env，确认 python3、完整性门与依赖状态。
2. 调用 ppt_master_setup_deps（幂等），或手动执行：

pip3 install -r skills/ppt-master/requirements.txt

3. 若需上游图像生成脚本，在会话工作目录（.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 开始安装与自检。

• 目录页：https://www.skillhub.cn/plugins/SAXEM1997/dsh-ppt-master-wrapper
• GitHub：https://github.com/SAXEM1997/dsh-ppt-master-wrapper