dsh-ppt-master：DSH「PPT 大師」模式

前言¶

DSH（DeepSeek Harness）採用「一切皆插件」的設計，將 Agent 能力拆解爲可組合的模塊。在文檔與演示場景中，直接調用大模型生成 PPTX 往往存在版式失控、格式混亂、圖片不自適應、圖表難以調整等問題。dsh-ppt-master 是一套面向 DSH 的「PPT 大師」會話模式與配套工具，通過模板化設計、聯網取材與 python-pptx 真渲染，把 PPT 生成從「拼圖片」變成「可編輯的原生對象」。

這是什麼¶

dsh-ppt-master 給 DSH 增加一個「PPT 大師」會話模式與五個工具，以及一套設計規範與模板庫。

裝完之後你得到：

一個會話模式：新建會話時選擇「PPT 大師」，擁有常駐人設、五步工作流與實時模板清單。
五個工具：ppt_research（聯網取材）、ppt_templates（模板庫）、ppt_build（生成 PPTX）、ppt_lint（設計審校）、ppt_doctor（環境自檢）。
一個技能：ppt-master 方法論手冊，包含版式選擇表、設計硬規則、反面清單與排障指南。
八套模板：靛藍商務、極簡素白、深空科技、暖陽人文、青瓷東方、數據亮色、石墨黑白、深海藍。
十六種版式：覆蓋封面、議程、KPI、圖表、表格、時間線、2×2 矩陣、對比、金句、全出血大圖等。
八類原生圖表：柱狀、條形、折線、面積、餅、環、堆疊、雷達、散點。
質量閘門：設計審校器（結論式標題/要點上限/數字進圖表/講稿齊備…）+ 渲染後結構自檢。

輸出是 python-pptx 真實渲染的原生對象（文字框、圖表、表格都能在 PowerPoint 裏繼續編輯），不是圖片拼貼。

安裝與啓用¶

前置條件¶

已安裝 DSH，且版本支持宿主插件與 bundle（dsh plugin 命令可用）。
Node.js ≥ 20（插件與工具走宿主 Node 運行）。
Python ≥ 3.10，並安裝 python-pptx>=1.0 與 pillow>=10：

python -m pip install "python-pptx>=1.0" "pillow>=10"

DSH 桌面版自帶 Python 運行時，插件會自動探測；也可以設置 DSH_PPT_PYTHON 指向任意可用的解釋器。

安裝插件¶

從本地目錄安裝（推薦：源碼目錄即唯一真源）：

dsh plugin add file:/absolute/path/to/dsh-ppt-master

發佈到 npm 之後也可以直接：

dsh plugin add dsh-ppt-master

安裝後重啓一次 DSH，新建會話時在模式選擇器裏選擇「PPT 大師」。

自檢¶

ppt_doctor        # Python / python-pptx / Pillow / 字體 / 模板目錄 / 各服務

模板畫廊與健康檢查（把 <DSH_WEB_ADDR> 換成你自己的 DSH Web 地址，如 http://127.0.0.1:52707）：

<DSH_WEB_ADDR>/plugins/dsh-ppt-master/gallery      # 8 套模板配色/氣質一屏看完
<DSH_WEB_ADDR>/plugins/dsh-ppt-master/templates    # 模板 JSON
<DSH_WEB_ADDR>/plugins/dsh-ppt-master/status       # 健康檢查

五個工具¶

工具	作用	關鍵點
`ppt_research`	聯網取材	`kind` = facts / images / palette / inspiration；`images` 會抓頁面 `og:image`，返回可直接填進 deck 的圖片 URL；無搜索密鑰時可用 `urls` 直抓
`ppt_templates`	模板庫	`list / get / save / delete`；`save` 支持 `baseOn` 派生，只覆蓋想改的字段
`ppt_build`	核心：生成 PPTX	內聯 deck JSON 或 `deckPath`；同時輸出全頁預覽 PNG；自動下載圖片、cover 裁切、字號回落防溢出、生成後結構自檢
`ppt_lint`	設計審校	給出 `score` 與「問題 → 改法」清單（必改 / 建議 / 可選）
`ppt_doctor`	環境自檢	Python / python-pptx / Pillow / 字體 / 模板目錄寫權限 / 各服務可用性

典型用法¶

說人話¶

在「PPT 大師」模式下，你可以用自然語言指揮 Agent：讓 Agent 按 ppt-master 方法論執行「定受衆/場合/決策目標 → 取材 → 立綱（標題句）→ 選模板 → 先出 3-5 頁小樣 → 補全 → 審校 → 交付」的流程。

示例：

用 PPT 大師模式，幫我把這份季度復盤做成 12 頁的彙報，先給提綱。

直接指揮工具¶

ppt_templates  action=list
ppt_research   query="2026 新能源汽車滲透率"  kind=facts
ppt_build      template="ocean-deep"  deck={...}  out="D:\\報告\\q3.pptx"
ppt_lint       deck={...}
ppt_doctor     {}

deck 速查¶

{
  "title": "2026 增長戰略", "subtitle": "董事會彙報", "author": "戰略部", "date": "2026-10",
  "template": "indigo-corporate",
  "slides": [
    { "layout": "cover", "kicker": "戰略規劃", "title": "把增長押在三個確定性上",
      "subtitle": "渠道結構 × 產品組合 × 組織效率", "image": "https://…jpg", "notes": "開場 30 秒" },

    { "layout": "agenda", "title": "今天只講三段",
      "agenda": [
        { "title": "現狀",  "desc": "渠道與產品結構", "page": "P03" },
        { "title": "打法",  "desc": "下半年三件事",   "page": "P06" },
        { "title": "要什麼", "desc": "回報與風險",     "page": "P14" }
      ] },

    { "layout": "kpi", "title": "三個數字定義今年的基線",
      "kpi": [{ "value": "12.4", "unit": "億元", "label": "全年營收", "delta": "+18%", "hint": "口徑：合併報表" }] },

    { "layout": "chart", "title": "增量幾乎全部來自渠道結構變化", "insight": "直營佔比 21%→38%，是主因",
      "chart": { "type": "bar", "categories": ["Q1", "Q2", "Q3", "Q4"],
                 "series": [{ "name": "直營", "values": [1.2, 1.9, 2.6, 3.4] }] } },

    { "layout": "chart", "title": "五個維度的能力對比", "insight": "短板在復購",
      "chart": { "type": "radar",
                 "categories": ["獲客", "轉化", "復購", "服務", "品牌"],
                 "series": [{ "name": "直營", "values": [9, 8, 5, 8, 9] },
                            { "name": "代理", "values": [6, 7, 6, 6, 5] }] } },

    { "layout": "chart", "title": "門店投入與回報的關係", "insight": "直營店回報更高",
      "chart": { "type": "scatter",
                 "series": [{ "name": "直營門店", "points": [{ "x": 420, "y": 3.1 }, { "x": 460, "y": 3.4 }] },
                            { "name": "聯營門店", "points": [[230, 4.2], [260, 4.5]] }] } },

    { "layout": "matrix", "title": "四類增長機會的優先級", "insight": "預算優先給左上象限",
      "matrix": { "xAxis": "投入", "yAxis": "回報",
        "quadrants": [
          { "title": "先做（高回報·低投入）", "items": ["直營擴店", "續費率提升"] },
          { "title": "重點投", "items": ["海外第二供應通道"] },
          { "title": "順手做", "items": ["包裝升級"] },
          { "title": "暫緩", "items": ["自建物流"] }
        ] } },

    { "layout": "bullets", "title": "下半年只做三件事", "insight": "資源聚焦在回報最高的兩件事上",
      "bullets": [{ "text": "直營門店從 180 家擴到 260 家", "level": 0 },
                  { "text": "把續費率從 78% 提到 85%", "level": 0 }] },

    { "layout": "end", "title": "要一個決定：批准 Q3 的 1.2 億擴張預算", "contact": "戰略部 · 王明" }
  ]
}

字段約定：

notes：講稿，寫進 PPT 備註（每頁 2-4 句）。
insight：這一頁的結論句（圖表/要點頁必填，觀衆不用自己猜）。
image：本地路徑或 http(s) URL（自動下載 + cover 裁切，不拉伸）。
agenda：3-6 條；{title, desc, page}，純字符串數組也可以。
matrix：必須 4 個象限，順序爲左上、右上、左下、右下；xAxis / yAxis 可選。
chart.type：bar｜column｜bar-h｜line｜area｜pie｜doughnut｜stacked｜radar｜scatter。
分類類圖表：categories 與每個 series 的 values 數量必須一致；
scatter：不要 categories，用 series[].points（[{x,y}] 或 [[x,y]]，每個系列 ≥ 2 個點），散點不支持數據標籤。

模板與自建¶

模板 id	氣質	適合
`indigo-corporate`	靛藍商務	彙報、融資、董事會
`minimal-paper`	極簡素白	學術、評審、白皮書
`deepspace-tech`	深空科技	技術發佈、產品架構
`warm-sunrise`	暖陽人文	品牌、文化、內部溝通
`celadon-cn`	青瓷東方	東方美學、政府/文化項目
`data-vivid`	數據亮色	數據看板式彙報
`graphite-mono`	石墨黑白	正式打印、省墨、黑白複印友好
`ocean-deep`	深海藍	深色科技感、發佈會

自建模板（baseOn 派生，只覆蓋想改的字段）：

ppt_templates action=save baseOn="minimal-paper" name="年度總結·墨綠" id="annual-ink"
  theme={"primary":"#2F6B5E","accent":"#C25E3A","bg":"#FBFAF7"}
  geometry={"marginX":1.0,"bodySize":16,"lineSpacing":1.4}
  decor={"style":"soft","coverPattern":"rule"}

單位：geometry 全部英寸、字號磅（pt）、顏色 #RRGGBB。
decor.style ∈ glow | grid | soft | ink | none；decor.coverPattern ∈ orbs | grid | rule | arc | seal | bars。
用戶模板存在 <DSH_HOME>/ppt-master/templates/*.json，同 id 覆蓋內置模板。

十六種版式¶

layout	用途	關鍵字段
`cover`	封面	title, subtitle, kicker, image, author, date
`section`	章節轉場	index, title, subtitle
`agenda`	議程/目錄	title, agenda[{title,desc,page}]
`bullets`	要點頁	title, bullets[], insight
`two-col`	左右兩欄	title, columns[{title,bullets[]}]
`cards`	卡片並列	title, cards[{title,body,icon,color}]
`kpi`	大數字	title, kpi[{value,unit,label,delta,hint}]
`timeline`	時間線	title, steps[{time,title,desc}]
`process`	流程/步驟	title, steps[{title,desc}]
`matrix`	2×2 象限	title, matrix{xAxis,yAxis,quadrants[{title,items[]}]}
`image`	圖文頁	title, image, variant(left/right/full), bullets[]
`quote`	金句頁	quote, author, role
`table`	表格	title, table{head[],rows[][],widths[]}
`chart`	圖表	title, chart{type,categories,series}, insight
`compare`	優劣對比	title, left{title,items[]}, right{title,items[]}
`end`	收尾	title, subtitle, contact

別名自動歸一：title→cover、toc/contents/outline→agenda、grid→cards、stats→kpi、
roadmap→timeline、flow→process、photo→image、quadrant/quadrants/2x2→matrix、
thanks→end 等。

示例與 Showcase¶

倉庫提供兩個示例 deck：

examples/demo-deck.json：9 頁，覆蓋常用版式，設計審校 100/100，是倉庫的「活文檔」。
examples/showcase-deck.json：18 頁，覆蓋全部 16 種版式與柱狀 / 雷達 / 散點三類圖表，使用 ocean-deep 模板。

適用場景與注意¶

適合：需要通過 DSH 快速生成結構清晰、版式規範的演示文稿，且希望在 PowerPoint 中繼續編輯內容的場景。

注意：插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證；確保 Node.js ≥ 20、Python ≥ 3.10，並正確安裝 python-pptx>=1.0 與 pillow>=10。

短結尾¶

dsh-ppt-master 把 DSH 的 Agent 能力與 python-pptx 真渲染結合，提供從取材、立綱、選模板到生成、審校、交付的一整套 PPT 工作流，適合需要快速產出可編輯 PPTX 的開發者與團隊。

插件目錄：https://www.skillhub.cn/plugins/weijianguizhou/dsh-ppt-master
GitHub：https://github.com/weijianguizhou/dsh-ppt-master