前言¶
在 DeepSeek Harness（DSH）裏做演示文稿，常見做法是：讓會話改 Markdown 或腳本，再另開 PowerPoint 覈對版式；或者把 .pptx 丟給通用工具，結果被重排到模板裏，和原稿對不上。DSH 社區插件 dsh-ppt-studio（維護者 p8054076283-del）把「文稿數據、16:9 預覽、就地改字、原樣導入、同屏 AI 對話」收進左側欄 PPT 工作臺，工作區裏的真源是 <workspace>/.ppt-studio/deck.json。
下面按定位、能力、安裝、用法和限制說明；安裝前請自行查看倉庫源碼與 MIT 許可證。插件與當前 DSH 進程同權限運行，導入腳本會讀寫工作區路徑。
這是什麼¶
dsh-ppt-studio 是面向 DeepSeek Harness 的客戶端類插件：在側邊欄註冊 PPT 工作臺，把 deck.json 渲染成真實 16:9 縮略圖與大預覽（DOM 佈局，不是截圖），支持點擊文本/表格單元格就地編輯並寫回文件；可通過聊天欄附件觸發 /import，用 python-pptx 按元素幾何導入 .pptx；中間列綁定當前會話，可 Markdown 展示、附件進 .ppt-studio/inbox，並讓 AI 直接改寫 deck.json。
分類上屬於 DSH 生態裏的客戶端插件；社區目錄頁在 skillhub.cn，與 DeepSeek / 幻方無官方從屬關係，DSH 本身也遵循「一切皆插件」的擴展方式。
核心功能¶
實時 16:9 預覽¶
縮略圖條與大預覽都是對 deck.json 的 DOM 渲染。座標以英寸計，畫布爲 13.333 × 7.5；渲染器再換算爲百分比與 cqw 字號，容器縮放時幻燈片同比縮放。
所見即所得編輯¶
在預覽上點擊文本塊或表格單元格即可輸入；點到別處保存，Esc 取消。編輯器儘量保留原字號、字重、對齊與顏色。表格是一等元素，可逐格編輯。
PPTX 導入（非重排版）¶
/import 調用 scripts/import-pptx.py，逐頁逐元素複製絕對幾何、主題 XML 解析後的顏色（含 lumMod/lumOff/tint/shade）、漸變與透明度、圓角與橢圓、按內容哈希去重的圖片、表格、組合變換，以及版式/母版上的裝飾。README 說明混合 run 樣式（spans）與圓角卡片在導入後仍可保留。
含圖表、SmartArt 或 OLE 的頁整頁經 LibreOffice → PDF → PNG 柵格化爲全幅嵌入圖，視覺保真；這類頁只讀。
AI 對話欄¶
中間列對接當前 Harness 會話：Markdown、粘貼/拖拽/選擇器附件（落入 .ppt-studio/inbox）、實時 process 頁展示工具調用與耗時，以及一鍵提示詞。會話可重寫 deck.json。
文件監聽與其它¶
面板輪詢 deck.json；外部修改會高亮變更頁，面板自身保存不會誤標爲「AI 改過」。單比例分割條佔滿頁面，窗口縮放時兩側仍可用。
安裝與啓用¶
插件以單個 tarball 分發，無運行時 npm 依賴；導入 .pptx 需要 Python 3 與 python-pptx、lxml。圖表頁柵格化可選 LibreOffice 與 pdftoppm（poppler）。Python 解釋器查找順序：DSH_PPT_PYTHON → 桌面應用捆綁運行時 → ~/.dsh/dsh-runtimes → PATH 上的 python / python3 / py。
官方安裝命令（來自倉庫 README）：
dsh plugin --profile web add \
https://github.com/p8054076283-del/dsh-ppt-studio/releases/latest/download/dsh-ppt-studio.tgz
本地構建並安裝 tarball 時：
node build2.mjs && npm pack
dsh plugin --profile web add file:$(pwd)/dsh-ppt-studio-<version>.tgz
首次安裝後需重啓應用一次，側邊欄會出現 PPT 工作臺。package.json 標明插件版本 1.0.1、Node >=20。
典型用法¶
- 打開已含
.ppt-studio/deck.json的工作區，或點擊 新建示例文稿。倉庫提供examples/demo-deck.json，可複製到<workspace>/.ppt-studio/deck.json試面板，無需動自己的 deck。 - 在幻燈片上點擊文字編輯；
Esc取消，點其它區域保存。 - 將
.pptx拖入聊天欄，在附件芯片上點 導入，用元素保真導入替換當前 deck。 - 在對話欄描述修改需求，由會話直接改寫
deck.json。
deck.json 結構要點（節選，字段含義見 README）：
{
"version": 1,
"theme": { "bg": "#FFFFFF", "fg": "#1F2328", "accent": "#2F6FED", "font": "Microsoft YaHei" },
"meta": { "title": "Quarterly review" },
"slides": [
{
"id": "s1",
"layout": "imported",
"title": "Cover",
"elements": [ /* shape | image | text | table，x/y/w/h 爲英寸 */ ]
}
]
}
Host 側在 loopback 提供 /ppt-studio 下路由（如 /health、/import、/deck PUT 等），客戶端註冊 sidebar.panellist（id ppt-studio）與 main 頁 ppt-studio。
適用場景與注意¶
適合：在 DSH 工作區內維護演示稿 JSON、需要和 AI 同屏改稿、希望 .pptx 導入後儘量保持原幾何而非模板重排、接受 chart/SmartArt 頁以只讀整頁圖呈現的場景。
已知限制（README Known limitations）：
- 不支持陰影、發光、3D、旋轉、WordArt、動畫；形狀以矩形、圓角矩形、橢圓或漸變繪製。
- 文本框可有
spans混排，但就地編輯會把混排壓成基礎樣式。 - 4:3 deck 會縮放進 16:9 畫布。
- 圖表 / SmartArt / OLE 頁爲圖片，不可編輯。
- 再次導入
.pptx會覆蓋面板內編輯，因真源是導入結果文件。
安裝插件前請閱讀 GitHub 倉庫 源碼與 MIT 許可證，並確認 Python/LibreOffice 依賴是否符合你的環境。插件以當前 DSH 進程權限訪問工作區，勿在不可信工作區盲目導入外部 .pptx。
結尾¶
dsh-ppt-studio 把 deck.json 的 live 預覽、就地編輯、元素級 PPTX 導入和會話側 AI 欄合成一個左側欄工作臺，適合在 Harness 裏把演示稿和智能體迭代放在同一工作區。問題反饋可走倉庫 Issues。
