使用指南

1. 安装插件

方式 A:插件市场安装(推荐)

本仓库已收录进 dsh 插件市场(topic: dsh-plugin)。打开 DeepSeek Harness 网页界面的插件市场,搜索 ppt-master,找到 ppt-master-cloner 一键安装,重启 dsh 生效。

方式 B:命令行安装

dsh plugin --profile web add https://github.com/sol5766/ppt-master-cloner.git

# 使用运行时 Python(系统 Python 可能缺依赖)
/vol1/@appcenter/trim.hermes/runtime/python/bin/python3.11 \
  skills/ppt-master/scripts/svg_to_pptx.py projects/
 \
  -o projects/
/exports/
.pptx

快速路径(无 SVG 管线时): 直接 python-pptx 生成,复用模板框架 skills/ppt-master/templates/pptx_framework.py(深蓝+金金融风设计令牌 + 常用组件 helper)。

完整的 PPT 制作流程、坑位记录与 QA 方案,以技能文档 ~/.dsh/ppt-master/skills/ppt-master/SKILL.md 为准。

4. 查看与强制更新

需求	对 Agent 说
查看当前状态	`用 ppt_master 工具查看状态`
强制立即更新	`用 ppt_master 工具强制更新`
关闭自动更新	在配置里设 `checkIntervalMs: 0`

配置

插件行支持以下配置(编辑安装后 profile 的 patch 层):

键	默认值	说明
`targetDir`	`$DSH_HOME/ppt-master`	ppt-master 本地检出路径
`repoUrl`	`https://github.com/hugohe3/ppt-master.git`	上游仓库地址(可指向 fork)
`checkIntervalMs`	`21600000` (6h)	自动更新检查间隔;`0` 关闭
`autoPull`	`true`	检测到更新时自动 fast-forward;`false` 只报告不拉取
`cloneOnInstall`	`true`	激活时是否自动 clone;`false` 仅初始化
`shallow`	`true`	浅克隆/浅 fetch(`--depth 1`),首次安装快;`false` 全量克隆

示例(patch 层):

- id: ppt-master-updater
  name: dsh-ppt-master
  config:
    targetDir: /vol1/data/ppt-master
    checkIntervalMs: 3600000

常见问题

Q:安装后 ppt_master 工具显示 not checked / last check: never? 首次克隆在后台进行,大仓库(含示例 deck)可能需要几分钟。稍等后再次查询即可。若长时间不变,检查网络能否访问 GitHub,或手动执行一次"强制更新"。

Q:克隆很慢? 默认已开启浅克隆(--depth 1),只拉取最新提交,大幅减少下载量。若仍慢,大概率是网络到 GitHub 的带宽问题;可把 repoUrl 指向可达的镜像/fork。

Q:更新时提示 error: git fetch ... failed? 一般是网络问题或上游仓库暂时不可用,不影响已克隆的版本;下次自动检查会重试。

Q:想完全自己控制 ppt-master 版本,不让它自动更新? 设置 autoPull: false(只报告不拉取)或 checkIntervalMs: 0(关闭自动检查),需要时手动强制更新。

Q:这个插件和"PPT 模式"是什么关系? 本插件负责让 ppt-master 源码常驻最新;"PPT 模式"是 dsh 的 agent 预设,负责让 Agent 带着 PPT 专属 persona 和技能目录工作。两者配合使用:装好本插件,再用"PPT 模式"新建会话做 PPT。

安全与合规

无遥测、无外部服务;唯一的出站流量是对 repoUrl 的 git fetch/clone。
插件自身无任何隐藏行为;所有源码见 src/index.ts。

配置