前言¶
在 DeepSeek Harness(DSH)裏讓智能體生成演示稿時,一個常見問題是:結果可能是圖片、HTML 頁面或不可編輯的頁面,後續無法逐字修改。liustack/pptwise 針對這個問題,把演示內容渲染成真實 PPTX 文件,方便在 PowerPoint 中繼續編輯。
DSH 插件生態中的社區目錄是獨立站點,與 DeepSeek / 幻方無官方從屬關係。下面介紹 pptwise 的定位、安裝方式與基礎用法。
這是什麼¶
pptwise 是一個面向 DeepSeek Harness 的演示稿生成插件,維護者爲 liustack,許可證爲 MIT。
它的一句話定位是:生成真實 PowerPoint 文件,而非圖片或 HTML。它解決的問題是:讓 AI 產出的演示稿進入 PPTX 文件後,仍然可以打開並繼續修改。
核心功能¶
1、生成真實 PPTX:輸出可編輯的 PowerPoint 文件,而不是圖片、HTML 或不可編輯頁面。
2、可繼續編輯:支持在 PowerPoint 中打開,並繼續編輯標題、項目符號、圖表柱等元素。
3、本地渲染:支持本地渲染,無需賬號,渲染時無需 API key,渲染時不聯網。
4、運行環境:支持 Node 22.19+ 或 Bun 運行。
5、命令集:支持 validate、render、preview、serve、audit、themes、layouts、doctor 等命令。
6、IR JSON 渲染:支持將 IR JSON 渲染爲 PPTX,並輸出每頁 SVG 或預覽頁。
7、可選圖庫搜索:支持可選圖庫搜索,需要用戶自己的 Pexels key。
安裝與啓用¶
先確認本機滿足運行前提:Node 22.19+ 或 Bun。插件以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證;該插件許可證爲 MIT。
已覈實資料未提供可直接複製的 dsh plugin add 安裝命令。
在 DSH 中發送下面這句,讓智能體按 DSH 安裝說明執行,並彙報健康檢查結果:
Install pptwise following https://raw.githubusercontent.com/liustack/pptwise/main/INSTALL-dsh.md, then run the health check and tell me the result.
經過上面的步驟,安裝說明會被交給智能體處理。如果你需要使用可選圖庫搜索,準備自己的 Pexels key。
典型用法¶
準備一個演示稿 IR 文件 deck.json 後,先做校驗:
pptwise validate deck.json
校驗通過後,渲染爲 PPTX:
pptwise render deck.json -o out/hello.pptx
如果需要逐頁查看 SVG,運行:
pptwise preview deck.json -o out/svgs
如果不想安裝,也可以直接運行這條示例命令做校驗:
npx -y @liustack/pptwise validate deck.json
資料列出的命令還包括 serve、audit、themes、layouts、doctor,可按需運行。
適用場景與注意¶
適合在 DSH 中生成可繼續編輯的 PPTX,並且希望渲染過程不依賴賬號、API key 或聯網的使用者。
使用注意:
1、插件以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證。
2、運行前提爲 Node 22.19+ 或 Bun。
3、圖表和表格數值如需更改,需要讓 AI 重建該頁。
4、可選圖庫搜索需要使用用戶自己的 Pexels key。
鏈接與後續¶
GitHub 倉庫:https://github.com/liustack/pptwise。社區目錄可按 liustack/pptwise 查找;已覈實資料未提供可直接粘貼的目錄頁 URL。
經過上面的安裝和渲染步驟,就可以把 AI 生成的演示稿落到 PowerPoint 裏繼續編輯。