前言¶
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項目本身。
