Community影像github.com

海報技能

從 PPT 模板建立可編輯、可縮放的 HTML 投影片,適用於 TRAE 網頁 PPT 工作:母版提取、cqw/cqh 版式、視覺 QA、響應式投影片或 8K 匯出。

海報技能 是什麼?

此技能專門用於將高校、學院或企業的 PowerPoint 模板轉換為高品質、可縮放的 HTML 投影片。它遵循一套嚴謹的工作流程,從拆解模板、建立母版、逐頁生成到視覺質檢與高清匯出,形成完整閉環。支援透過容器查詢單位 (`cqw/cqh`) 實現等比縮放,並能利用無頭瀏覽器(如 Edge)輸出高達 7680×4320 解析度的 8K PNG 圖片。此技能適用於 Cursor、Claude Code、Codex 等開發工具,尤其適合 TRAE 的網頁 PPT 專案,確保最終交付的 HTML 投影片在風格、佈局和素材引用上保持一致且專業。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CanFlyhang/poster-skills/tree/HEAD

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

TRAE 網頁 PPT 製作流程

將高校、學院或企業 PPT 模板轉化為可編輯、可等比縮放、可高清匯出的 HTML 投影片。透過「母版約束 + 逐頁版式 + 截圖質檢 + 無頭瀏覽器匯出」形成完整閉環。

適用場景

  • 根據 PPT 模板、參考截圖或現有 HTML 母版製作網頁 PPT。
  • 統一整套投影片的 Banner、LOGO、色彩、字型和網格。
  • 使用 TRAE 逐頁生成、改版、修復遮擋或調整文案。
  • 將 HTML 投影片批量匯出為高清 PNG,包括 7680×4320 的 8K 圖片。

如果使用者要求的是物件層級可編輯的 .pptx,應使用 PPTX 工具,不要把 HTML 圖片冒充為可編輯 PowerPoint。

開始前確認

優先讀取使用者既有材料,不要重複索取工作區中已有的資訊。

  1. 模板依據:PPT、參考圖、HTML 母版頁或品牌規範。
  2. 頁面內容:大綱、每頁標題、要點、資料、圖片和參考文獻。
  3. 固定規範:頁面比例、主色、字型、LOGO、頁首頁尾及必須保留的元素。
  4. 交付形式:HTML 原始檔、本地素材、預覽圖、8K 圖片或匯出入口。

缺少非關鍵資訊時採用合理預設值:16:9、系統字型、本地素材、1920×1080 質檢。只有缺失內容會阻塞製作時才追問。

核心原則

  1. 先拆母版,再寫頁面:不要邊生成邊猜風格。
  2. 母版元素是不變量:Banner、LOGO、主色、標題位置和內容區網格不得逐頁飄移。
  3. 版式尺寸相對化:定位、寬高、字級和間距使用 cqw/cqh,不要混用固定 px 控制版式。
  4. 一頁一種主要表達結構:相鄰頁面避免無意義地重複「左圖右文」;對比頁等特殊情況除外。
  5. 素材本地化:不依賴臨時圖床;真實照片需來源明確,概念圖優先內聯 SVG。
  6. 每頁截圖驗收:程式碼無報錯不代表畫面正確,必須看渲染結果。
  7. 最小範圍修改:修復單頁問題時,不隨意重排其他模組或改動整套母版。

標準工作流

第一步:拆解模板,建立不變量

從參考模板中提取並記錄:

類別需要確認的內容
Banner背景、LOGO 位置、標題位置、裝飾線、固定高度
色彩主色、輔助色、正文色、灰階、強調色使用規則
字型標題字型、正文字型、字級層級、字重
網格左右安全邊距、內容區起點、欄間距、頁尾位置
可變項每頁標題、副標題、正文結構、圖片與圖表

優先使用系統自帶字型,避免外部字型在不同電腦上失效。參考圖需要復刻時,把「位置、尺寸、字型、配色與參考一致」寫成硬約束,而不是只寫「風格類似」。

第二步:搭建 16:9 技術底座

所有頁面共享同一容器邏輯:

/* 投影片容器:保持 16:9,並啟用容器查詢尺寸單位。 */
.slide {
  width: min(100vw, calc(100vh * 16 / 9));
  aspect-ratio: 16 / 9;
  position: relative;
  overflow: hidden;
  container-type: size;
}

/* 頁面元素:相對容器定位,視窗縮放時保持比例。 */
.title {
  position: absolute;
  top: 6.5cqh;
  left: 4cqw;
  font-size: 2.5cqw;
}

container-type: size 是 cqw/cqh 生效的關鍵。在 1920×1080 畫布中,1cqw = 19.2px,1cqh = 10.8px。視窗縮小、投影放大或高倍匯出時,版式比例保持一致。

第三步:製作母版頁

先完成少量基準頁,再批量生成其餘頁面:

  • 封面頁:主標題、報告人、單位、日期及品牌視覺。
  • 正文母版頁:固定 Banner、標題區、內容網格和頁尾。
  • 收尾頁:結論、致謝或參考文獻,根據內容需要區分用途。

母版驗收通過後,將其作為後續頁面的結構與樣式依據。修改已有頁面前必須先讀取檔案,不能憑檔案名稱猜測結構。

第四步:逐頁生成,匹配內容結構

每次生成新頁都寫清五項:

  1. 參考哪個母版頁,哪些元素保持不變。
  2. 頁面比例、檔案名稱和儲存位置。
  3. 本頁標題、要點、資料及結論。
  4. 本頁採用的版式,以及與前面頁面的差異。
  5. 圖片來源、本地化要求和版權約束。

可按內容選擇版式,不要為了新穎而犧牲資訊表達:

內容類型推薦結構
封面居中大標題、品牌橫幅、單張主視覺
並列物件等寬卡片陣列、分欄對比
流程與階段階梯、時間線、遞進橫幅
因果關係鏈條、箭頭流程、中心輻射
核心概念中心圖解 + 四周註解
結構與原理剖面圖、SVG 示意圖 + 要點
資料與儀表圖表、指標卡、對開面板
多維資訊2×2 網格、矩陣、分組卡片
結論中心論點、豎軸收束、少量關鍵數字
參考文獻文獻封面或來源截圖 + 規範列表
致謝大字級短文案 + 主視覺,減少模組堆疊

第五步:選擇配圖方式

按以下優先級選擇:

  1. 真實照片:優先使用者提供或授權明確的素材;公開素材需核對許可並記錄來源。
  2. 內聯 SVG:適合晶格、缺陷、剖面、流程、因果鏈等無法直接拍攝的概念。
  3. CSS 圖形:適合階梯、譜條、徽章、指標底色等簡單裝飾性資訊圖。

所有圖片儲存到本地並核對引用路徑。不得使用與內容無關的 AI 氛圍圖填充版面。

第六步:逐頁視覺質檢

Windows 可呼叫 Edge 無頭模式生成 1920×1080 質檢圖。按實際瀏覽器路徑和檔案路徑調整:

$edge = "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe"
& $edge --headless=new --disable-gpu --hide-scrollbars `
  --virtual-time-budget=6000 --window-size=1920,1080 `
  --screenshot="_chk.png" "file:///absolute/path/to/page.html"

逐頁檢查:

  • 頁面完整顯示為 16:9,沒有意外捲動條。
  • 無元素溢位、裁切、重疊或模組間距過近。
  • 所有圖片成功載入,無空白佔位和破圖。
  • 標題、正文、圖註層級清晰,無孤字和異常換行。
  • Banner、LOGO、色彩和網格與母版一致。
  • 資料、單位、年份、術語和參考文獻口徑一致。
  • 縮小視窗後仍等比縮放,沒有固定像素元素破壞佈局。

發現問題後先定位根因,只修改相關樣式或元素,再次截圖複核。刪除角標、頁首等元素時,同時檢查對應 HTML、CSS 和頁面標題,避免殘留。

第七步:匯出高清圖片

使用 1920×1080 視口配合 4 倍裝置縮放匯出 7680×4320 PNG:

& $edge --headless=new --disable-gpu --hide-scrollbars `
  --virtual-time-budget=6000 --window-size=1920,1080 `
  --force-device-scale-factor=4 `
  --screenshot="export/page.png" "file:///absolute/path/to/page.html"

該方式讓瀏覽器按高倍比例重新渲染文字、CSS 和 SVG,不是把低解析度點陣圖拉伸為 8K。

批量匯出時優先複用專案已有腳本。行程結束後仍需確認檔案存在、尺寸正確且寫盤完成,不能只憑指令退出碼判斷成功。

第八步:整理交付物

推薦保持清晰、可複用的目錄:

project/
├── 001.html ... NNN.html
├── assets/
│   ├── images/
│   └── logos/
├── export/
└── html2img_8k.py        # 專案已有或使用者要求時提供

交付時列出原始檔、素材目錄、匯出目錄及尚未由使用者補充的資訊,不將臨時質檢截圖混入正式成果。

可複用提示詞

生成新頁

請基於【母版頁路徑】生成【新頁面檔案名稱】:
1. 保持 16:9、Banner、LOGO、字型、色彩和網格不變;
2. 標題為【標題】,內容包含【要點 A】【要點 B】【要點 C】;
3. 採用【指定版式】,與相鄰頁面的結構有所區別;
4. 頁面內定位、尺寸、字級和間距使用 cqw/cqh;
5. 圖片本地化並註明來源,完成後進行 1920×1080 截圖質檢。

修復視覺問題

請定位【頁面路徑】中【具體模組】出現【遮擋/溢位/破圖/換行】的根因,
只修復相關問題,保持其他模組和母版不變,修改後重新截圖核驗。

調整文案

將【頁面路徑】中的【原文】替換為【新文案】,
保持現有版式,檢查單行顯示、孤字、溢位和模組間距。

常見問題

問題優先檢查
cqw/cqh 不生效容器是否設定 container-type: size,元素是否位於該容器內
換電腦後字型變化是否使用外部字型或未安裝字型,改用系統字型堆疊
圖片空白或 404檔案名稱、大小寫、相對路徑、特殊字元及零寬空格
檔案名稱含零寬空格 U+200B重新命名檔案,或將字元 URL 編碼為 %E2%80%8B
模組撞入標題區內容區起點、模組高度、階梯抬升量是否過大
段落出現孤字先最佳化文案,再微調字級或容器寬度
頁面風格逐漸飄移是否繞過母版自由發揮,重新核對不變量
8K 圖片模糊是否使用 4 倍裝置縮放重新渲染,而非放大已有截圖
匯出檔案不完整是否等待頁面渲染及檔案寫盤穩定

完成標準

只有在以下條件全部滿足後才算完成:

  • 母版與全套頁面風格一致,內容頁結構服務於資訊表達。
  • 所有新增或修改頁面均經過實際渲染檢查。
  • 圖片、字型、LOGO 和腳本引用可用,素材已本地化。
  • 匯出圖片尺寸符合要求,8K 輸出為 7680×4320。
  • 交付目錄清晰,臨時檔案與正式成果分離。

相關技能