前言¶
在 DeepSeek Harness（DSH）裏做幻燈片，常見做法是各用一類插件：有的擅長從流水線生成，生成後不好改；有的擅長在界面裏改，卻不好從零建稿或導入；還有的只能在外部 .pptx 上打補丁，不能在同一項目裏走完創建到交付。若你希望文本仍是可編輯文本、圖表仍是帶內嵌數據工作簿的可編輯圖表、而不是整頁柵格圖，並且導出前能留下「檢查了哪些門、針對哪份字節、用什麼引擎」的回執，就需要一套把創建、精修、交付放在同一修訂模型上的工具。dsh-deckforge（Deckforge）由社區維護者 DSH-Extensions-list 發佈，分類爲工作流，面向 Harness 提供演示文稿工作室能力。
這是什麼¶
Deckforge 是 DeepSeek Harness 的 presentation layer：在一個項目裏跑三條閉環——創建（create）、精修（refine）、交付（deliver），並用質量門證明文件能打開、能讀對。它編譯出原生 PowerPoint deck（OOXML），同時可導出離線可用的自包含 HTML、PDF、分頁圖片以及可復現的 bundle。倉庫爲純 ESM、僅依賴 Node 內置模塊，無編譯器、無 Python、無 native 模塊；LibreOffice 與 pdftoppm 爲可選，隻影響渲染門（render gate）。
維護與源碼： GitHub — DSH-Extensions-list/dsh-deckforge；社區目錄頁： skillhub.cn 插件頁。許可證 MIT（package.json 版本 1.0.0）。DSH 生態理念是「一切皆插件」；社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
三條閉環與工具面¶
README 給出的主流程爲：
deck_new → deck_plan → deck_write → deck_check → deck_render → deck_export
工具與職責如下（摘自官方 README 表格）：
| 工具 | 作用 |
|---|---|
deck_new |
按主題、場合與時長槽創建項目 |
deck_plan |
由場合與時長生成幻燈片預算與分 beat 計劃 |
deck_write |
用結構化內容追加頁面；佈局可推斷或顯式命名 |
deck_edit |
帶語義 diff 的原子操作：移動、改樣式、對齊、增刪、重排 |
deck_import |
導入 .pptx 或 Markdown，輸出項目並附損耗報告 |
deck_patch |
對外部 .pptx 做文本、圖片、順序、備註等手術式修改 |
deck_splice |
替換單頁並證明其餘部分字節級一致 |
deck_check |
無渲染器下的 schema、佈局、內容與兼容性門 |
deck_render |
對真實文件柵格化，報告像素統計與視覺 diff |
deck_review |
修復計劃（僅提議，不自動應用） |
deck_export |
導出 pptx、html、pdf、png、notes、bundle，各帶 receipt |
deck_status |
修訂號、頁數、receipts、引擎、演講時長等 |
deck_verify |
對文件重算哈希，判斷 receipt 是否仍成立 |
項目結構與主題¶
項目目錄約定（README）：
deck/
deck.yaml # title, size, theme, meta, page order
pages/01-cover.yaml # elements: text | shape | line | image | table | chart
theme.json # palette, type scale, spacing, radius
assets/ # images
manifest.json # revision, hashes, receipts, export history
revisions/ # append-only snapshots
export/ # pptx, html, pdf, png, bundle
規則要點：1 px = 1 pt，原點左上，默認 960×540；頁順序即 z-order；元素 id 在導入與再導出間保持；manifest.revision 作樂觀鎖；每次 export 記錄產出字節的 SHA-256。
內置八套設計系統：slate、paper、midnight、ember、forest、mono、ocean、sand；主題數據由 PowerPoint、HTML 與工作臺共用同一文件。
質量門（G1–G6）¶
| 門 | 檢查內容 | 是否阻斷 export |
|---|---|---|
| G1 schema | 類型、id、邊界、主題引用 | 是 |
| G2 layout | 越界、溢出、重疊（含聲明例外）、對比度、安全區、設計預算 | 錯誤時阻斷 |
| G3 content | 演講時長相對 slot、重複標題、無來源數字 | 建議性 |
| G4 render | LibreOffice 柵格真實文件、空白頁檢測 | 記錄；無渲染器時 skip，不算 pass |
| G5 diff | 相對上次渲染的 ΔE | 建議性 |
| G6 compat | 功能所需的最低 Office 版本 | 建議性 |
每個門寫入 receipt：{ gate, engine, engineVersion, input, output, findings, skipped, at }。缺少渲染器時記爲 skipped，不會當作通過。
Deck Studio 工作臺¶
安裝並在 Harness 中刷新後，側欄會出現 Deck Studio：頁條、矢量畫布與檢查器。可拖拽移動對象、就地改文本與樣式、增刪重排頁面、切換主題、跑門並導出。寫入與工作臺共用與 CLI 工具相同的路由，共享同一 revision 與鎖。README 註明：語義類請求明確 defer 到 chat；2026-10-31 的手動驗證覆蓋了側欄、空 deck、加頁、切換項目、選中文本、快速編輯、檢查器刷新、歷史恢復、檢查與 PowerPoint/HTML 導出等，但不等於已驗證 Microsoft PowerPoint 的全部兼容性——在 PowerPoint 中打開導出文件仍需單獨人工確認。
兼容與語言¶
- PowerPoint 2010 及以後可讀編譯器發出的全部特性；2007 除 WebP 外均可讀。
- HTML deck 演示時不依賴網絡：圖片內聯，圖表爲 inline SVG。
- 倉庫設計爲 English-only：工具、skills、錯誤、文檔、模板、測試均英文；
npm run check:english對任意 CJK 碼點失敗。模型仍可按用戶語言回答，產品界面與工具面爲英文。
安裝與啓用¶
官方 README 給出的安裝步驟如下。插件以當前 dsh 進程權限運行，安裝前應自行審閱源碼與 MIT 許可證。
# Clone the extension and install the checkout
git clone https://github.com/DSH-Extensions-list/dsh-deckforge.git
cd dsh-deckforge
dsh plugin install "$PWD"
安裝完成後刷新 Harness 窗口，在側欄查找 Deck Studio。
開發環境要求 Node.js 22.19 或更高（package.json 中 "node": ">=22.19"）。倉庫無需 npm install 或構建步驟；本地可運行：
npm run check
GitHub Actions 在 Node.js 22 與 24 上跑英文檢查與測試套件。
典型用法¶
下面示例來自 README「Sixty seconds」一節，演示從建項目到導出 pptx 與 html（命令面爲 JSON 形參，由 Harness 工具路由調用）。
先創建目錄與元數據：
deck_new { "dir": "decks/q3-review", "title": "Q3 review", "theme": "midnight", "minutes": 12, "venue": "conference" }
deck_plan { "venue": "conference", "minutes": 12 }
寫入結構化頁面（含 cover 與 chart 佈局）：
deck_write { "dir": "decks/q3-review", "pages": [
{ "layout": "cover", "title": "Latency fell 40%", "subtitle": "Platform review, Q3", "notes": "Open with the number." },
{ "layout": "chart", "title": "p95 fell every quarter", "chart": { "kind": "column", "categories": ["Q1","Q2","Q3","Q4"], "series": [{ "name": "p95 ms", "values": [210,180,140,126] }] }, "source": "Source: billing export" }
] }
檢查並導出：
deck_check { "dir": "decks/q3-review" }
deck_export { "dir": "decks/q3-review", "formats": ["pptx", "html"] }
預期產物包括 decks/q3-review/export/q3-review-r2.pptx（README 稱 PowerPoint 打開時不應出現修復提示），以及可用方向鍵翻頁、按 S 看備註、按 Ctrl+P 打印的 HTML deck。
適用場景與注意¶
適合需要在 DSH 對話與工作臺之間共用同一 deck 項目、既要 agent 結構化寫頁又要人工精修、且希望在 export 前留下 gate receipt 鏈路的開發者或團隊。若工作流以「只生成一次、不再改模型」或「只改外來 pptx、不從零編譯」爲主，可繼續用生態裏更專一的插件；Deckforge 的定位是單項目、單修訂模型、單 receipt 鏈上的三閉環合一。
注意：G4 依賴本機 LibreOffice（若安裝）；無渲染器時 export 仍可繼續，但 render 門爲 recorded skip。倉庫 README 爲 English-only，界面與錯誤信息以英文爲準。插件安裝與運行權限等同於當前 dsh 進程，請勿在未審閱代碼的情況下在生產環境盲目安裝。
結尾¶
dsh-deckforge 把原生 pptx 的創建、導入、精修、檢查與多格式導出收進一個 Harness 項目，並用 G1–G6 與 receipt 說明「驗了什麼、驗的是哪份文件」。進一步瞭解可訪問 社區目錄頁 與 GitHub 倉庫。
