前言¶
報告、對賬單、導出頁這類內容，很多團隊先用 HTML 排版：改樣式快、和 Web 棧一致。真要發給客戶或走打印流程時，往往還要再出一版 PDF。自己接 headless 瀏覽器或排版引擎，要處理字體、分頁和 CSS 差異，維護成本不低。若你已經在 Cursor、Claude Code 等環境裏用 Skills 擴展 Agent 能力，可以把「HTML → PDF」交給專門技能，用對話描述輸入輸出即可。
下面介紹 SkillHub 社區技能 HTML轉PDF（通用版）（座標 @user_e60b9cd9/html-to-pdf-pro），說明它解決什麼問題、如何安裝，以及使用時需要留意的邊界。
這是什麼¶
HTML轉PDF（通用版） 是 SkillHub 上的社區技能（來源：community，分類：office-efficiency），當前版本 1.0.0，由發佈者 user_e60b9cd9 維護。
官方簡介中的定位是：將 HTML 文件轉換爲高質量 PDF；支持中文、CSS 樣式保留、A4 頁面設置；適用於報告、文檔、發票等需要打印或分享的場景；當需要將 HTML 轉換爲 PDF 時使用此技能。
技能標籤標明 requires_api_key=false，即按 SkillHub 公示信息，不依賴額外 API Key 即可使用。
核心功能¶
以下能力均來自 SkillHub 頁面與抓取資料中的簡介，未在公開頁展開的實現細節（例如具體依賴哪套渲染引擎）不在本文中臆測。
- HTML 輸入 → PDF 輸出：以 HTML 文件爲源，生成 PDF 文件。
- 中文與樣式：說明中明確支持中文，並儘量保留 CSS 樣式，便於版式與 Web 預覽接近。
- 頁面規格：默認面向 A4 頁面設置，貼合常見打印與歸檔習慣。
- 場景導向：面向報告、文檔、發票等需要打印或分發的內容。
安裝與啓用¶
SkillHub 官方頁面給出的安裝提示是：按 SkillHub 安裝文檔 安裝座標 @user_e60b9cd9/html-to-pdf-pro。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查本機是否已有 skillhub：
command -v skillhub && skillhub --version
若未安裝，可按安裝文檔執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝本技能到當前 Agent 的 skills 目錄¶
安裝文檔要求：安裝時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄，否則默認會裝到 ./skills/，Agent 可能識別不到。
常見路徑示例（以安裝文檔爲準）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
在 Cursor 中安裝本技能可執行：
skillhub install user_e60b9cd9/html-to-pdf-pro --dir ~/.cursor/skills/
Claude Code、Codex 等環境將 --dir 換成上表中對應路徑即可。安裝後若 Agent 未立刻加載新技能，按你所用客戶端的說明重啓或重新打開會話。
也可將官方安裝句發給 AI，讓其按文檔代爲執行：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_e60b9cd9/html-to-pdf-pro`。
典型用法¶
公開 SkillHub 詳情頁未附帶獨立的命令行示例或腳本片段；技能以通用 SKILL.md 形式向 Agent 提供操作指引。啓用後，用法本質是：在已安裝技能的 Agent 會話中，說明 HTML 源路徑與期望的 PDF 輸出。
可復現的交互方式示例（路徑請換成你本機真實文件）：
請使用 HTML轉PDF 技能，把 /path/to/report.html 轉成 PDF，輸出到 /path/to/report.pdf，保持現有 CSS，按 A4 排版。
若 HTML 引用了相對路徑的圖片或樣式表，建議在提示中寫明工作目錄或要求 Agent 先檢查資源是否可被正確加載，避免 PDF 缺圖或樣式丟失——這與「CSS 樣式保留」目標一致，但具體行爲以技能內說明及 Agent 執行環境爲準。
適用場景與注意¶
適合誰
- 需要在 Agent 工作流裏快速把 HTML 導出爲 PDF，又不想每次手寫渲染腳本的同學。
- 輸出以中文報告、文檔、發票類版式爲主，且希望頁面規格貼近 A4 的場景。
使用上可留意的點
- 技能爲 community 來源，安裝前可按 SkillHub 慣例自行確認版本與說明；當前公示版本爲 1.0.0。
- 複雜 CSS（多欄、固定定位、自定義字體）在不同渲染後端上表現可能不一致；若版式極敏感，應對照生成的 PDF 做一次目視驗收。
- 抓取資料顯示該技能 requires_api_key=false；若你所在環境對出站網絡或本地二進制有沙箱限制，轉換步驟仍可能受環境影響，需在真實項目中試跑一次。
結尾¶
HTML轉PDF（通用版） 把「HTML 文件 → 帶中文與樣式、A4 取向的 PDF」收斂成一條 Agent 技能，適合報告、文檔、發票等打印與分享場景。安裝走 SkillHub CLI，座標 @user_e60b9cd9/html-to-pdf-pro，無需 API Key（按 SkillHub 標籤）。
- SkillHub 頁面：https://www.skillhub.cn/skills/user_e60b9cd9/html-to-pdf-pro
- API 條目：https://api.skillhub.cn/user_e60b9cd9/html-to-pdf-pro
- 安裝說明：https://skillhub.cn/install/skillhub.md
