前言¶
DeepSeek Harness 的核心设计理念是「一切皆插件」。在使用 AI 生成原生 PowerPoint 的场景中，ppt-master 是一个常用的上游项目。本插件旨在解决手动克隆和维护源码的繁琐问题，实现开机即用和持续更新，确保 Agent 能够随时调用最新的 PPT 生成能力。
插件定位¶
这是一个由 sol5766 维护的 DeepSeek Harness 插件，负责自动安装并持续更新 ppt-master 项目。
- 许可证：MIT
- 核心价值：自动维护 ppt-master 源码，免去手动 git 操作。
- 仓库地址：https://github.com/sol5766/ppt-master-cloner
核心能力¶
- 自动安装与克隆：插件激活后，自动将 ppt-master 克隆到本地默认目录（通常为
$DSH_HOME/ppt-master）。 - 自动检测更新：每 6 小时自动检测上游仓库变更，发现新提交时自动进行 fast-forward 合并。
- 工具注册：为 Agent 注册
ppt_master工具，使其能够直接调用 ppt-master 的技能。 - 状态管理与控制：支持查看同步状态（本地/远端 HEAD、最近错误等），并支持手动强制更新。
- 浅克隆支持：默认使用浅克隆以加快首次安装速度。
安装与启用¶
使用官方命令行工具进行安装。
dsh plugin --profile web add https://github.com/sol5766/ppt-master-cloner.git
安装完成后，务必重启 DeepSeek Harness 以使插件生效。首次启动时，插件会在后台自动克隆源码（默认浅克隆），克隆完成前工具状态可能显示 not checked。
配置与使用¶
插件安装后，Agent 可以通过自然语言指令调用 ppt_master 工具。
基本命令¶
- 查看状态：
用 ppt_master 工具查看状态 - 强制更新：
用 ppt_master 工具强制更新
配置项说明¶
插件支持通过配置文件（patch 层）调整行为：
| 配置项 | 默认值 | 说明 |
|---|---|---|
targetDir |
$DSH_HOME/ppt-master |
ppt-master 本地检出路径 |
repoUrl |
https://github.com/hugohe3/ppt-master.git |
上游仓库地址 |
checkIntervalMs |
21600000 (6h) |
自动更新检查间隔，设为 0 可关闭 |
autoPull |
true |
检测到更新时是否自动拉取 |
cloneOnInstall |
true |
激活时是否自动克隆 |
shallow |
true |
是否使用浅克隆（加快速度） |
典型工作流¶
插件本身只负责拉取和维护 ppt-master 源码，实际的 PPT 生成逻辑依赖于 ppt-master 项目的技能与脚本。
在 Agent 会话中，可以直接下达如下指令：
用 ppt-master 把这份文档做成 12 页 PPT
模型会自动加载本地的 ppt-master 技能，执行资料收集、设计规格定义、SVG 设计和最终导出 PPTX 的流程。
注意事项¶
- 无外部依赖：插件本身无遥测、无外部服务，唯一的出站流量是对 GitHub 的 git 操作。
- 权限与网络：首次克隆可能需要几分钟，建议检查网络连通性。
- 职责边界：插件仅负责源码的拉取和维护，生成 PPT 的具体能力属于
ppt-master项目本身。
