前言¶
在文檔、運營素材或自動化腳本里，常見需求是把 PNG 轉成 WebP、把演示視頻截一段做成 GIF，或把多份 PDF 合成一份。大模型對話本身改不了二進制文件，通常要你自己找 Sharp、FFmpeg、pdf-lib 再寫腳本。下面介紹 SkillHub 社區 Skill「文件格式轉換器 (File Converter)」：把上述能力寫成 Agent 可遵循的 SKILL.md，並附帶 Node.js 命令行入口 converter.js，由 Agent 在對話中按步驟調用本地命令完成轉換。
這是什麼¶
文件格式轉換器 (File Converter) 是面向 design-media 場景的 Agent Skill，座標爲 @user_8509461a/file-converter-new，當前版本 1.0.0，來源爲 community，發佈者爲 user_8509461a（SkillHub 頁面標註作者爲蜀企投管（四川省）企業管理有限公司）。SkillHub 分類爲 design-media，標籤 requires_api_key=false，即不依賴額外 API Key。
官方簡介：專業的文件格式轉換工具，支持圖片格式轉換/壓縮、視頻轉 GIF、PDF 合併處理，基於 Sharp 和 FFmpeg 高性能處理引擎。SkillHub 上該 Skill 評分 100000，下載 1297 次（統計以 SkillHub 頁面爲準）。
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_8509461a/file-converter-new
- 資源地址：https://api.skillhub.cn/user_8509461a/file-converter-new
核心功能¶
以下能力與安裝包內 SKILL.md、converter.js 一致，Agent 安裝後應優先按 Skill 說明調度 node converter.js。
圖片¶
- 格式互轉：PNG、JPG、WebP、GIF 等（
convert子命令，可調寬度、高度、質量）。 - 單張壓縮：
compress，通過-q指定質量。 - 目錄批量：
batch，用-f指定目標格式（如 jpg、png、webp）。
視頻轉 GIF¶
- 輸入常見容器格式（幫助信息列出 mp4、avi、mov 等；
formats子命令還列出 mkv、webm、flv）。 video2gif支持起始時間-s、時長-t、寬度-w、幀率-fps。
PDF¶
- 合併：
merge，將多個 PDF 合併爲一個輸出文件（實現基於 pdf-lib）。 - 轉圖片：
pdf2img；運行時會提示需系統安裝 poppler-utils，並給出pdftoppm用法說明。 - Skill 文檔中還提到 PDF 拆分；
converter.js幫助裏含有split說明，但當前主命令分發邏輯未接入該子命令，實際拆分需自行擴展或改用系統工具。
輔助¶
info：查看文件信息。formats：列出工具聲明支持的圖片、視頻擴展名。
技能在文檔層面還暴露編程接口名（如 convertImage、videoToGif、mergePdf 等），與 converter.js 導出函數對應，便於 Agent 生成調用示例。
安裝與啓用¶
1. 安裝 SkillHub CLI（若尚未安裝）¶
按 SkillHub 安裝說明 檢查或安裝 CLI：
command -v skillhub && skillhub --version
未安裝時可執行完整安裝腳本（文檔推薦 CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 將 Skill 裝進當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被加載。常用路徑（摘自官方安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
命令行安裝示例（與 skillhub search 結果一致）：
skillhub install file-converter-new --namespace user_8509461a --dir ~/.cursor/skills
也可在對話中讓 AI 按 SkillHub 指引安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_8509461a/file-converter-new`。
安裝完成後，技能目錄一般爲 .../@user_8509461a/file-converter-new/，內含 SKILL.md 與 converter.js。
3. 安裝 Node 依賴¶
進入技能目錄後安裝 package.json 中的依賴（sharp、fluent-ffmpeg、pdf-lib）：
cd ~/.cursor/skills/@user_8509461a/file-converter-new
npm install
SKILL.md 亦給出等價寫法：npm install sharp fluent-ffmpeg pdf-lib。首次運行若缺包，converter.js 會嘗試在技能目錄內執行 npm install <包名>。
4. 系統依賴¶
- 視頻轉 GIF：本機需可用的 ffmpeg（fluent-ffmpeg 調用系統 ffmpeg）。
- PDF 轉圖片：按技能內提示安裝 poppler-utils（如 Debian/Ubuntu：
sudo apt-get install poppler-utils），再使用pdftoppm或後續版本完善後的pdf2img流程。
典型用法¶
以下示例均來自官方 SKILL.md，在技能目錄下執行。先把工作路徑切到已安裝的 @user_8509461a/file-converter-new。
單張圖片格式轉換：
node converter.js convert input.png output.jpg
批量轉 JPG：
node converter.js batch ./images -f jpg
壓縮並指定質量：
node converter.js compress input.png -q 80
視頻轉 GIF（默認從 0 秒起、時長 10 秒，可用 -t 調整）：
node converter.js video2gif input.mp4 output.gif -t 10
截取片段並限制寬度：
node converter.js video2gif input.mp4 output.gif -s 5 -t 10 -w 480
合併 PDF：
node converter.js merge file1.pdf file2.pdf output.pdf
PDF 轉圖片（輸出目錄可選）：
node converter.js pdf2img document.pdf ./output/
在 Agent 會話中的典型流程是：用戶給出本地文件路徑與目標格式 → Agent 讀取 SKILL.md → 在終端執行對應 node converter.js ... → 回傳輸出路徑或錯誤信息。無需配置 API Key。
適用場景與注意¶
適合誰
- 需要在 Cursor、Claude Code、Codex 等支持 Skills 的客戶端裏，用自然語言驅動圖片/WebP 優化、短視頻 GIF、PDF 合併等本地批處理。
- 已接受 Node.js 運行時，並願意在技能目錄維護
npm依賴。
限制與注意
- 處理的是用戶機器上的文件路徑，大文件或批量任務要注意磁盤空間與 ffmpeg 耗時。
pdf2img當前實現以提示安裝 poppler 爲主，不能假設一鍵出圖；合併 PDF 以pdf-lib爲準，複雜版式需自行驗證。- 與 SkillHub 上名稱相近的其他「file-converter」Skill（如文本 JSON/YAML 類）座標不同，安裝時請確認命名空間 user_8509461a 與 slug file-converter-new。
- 修改 skills 目錄後，部分客戶端需要重啓或重新加載會話才能識別新 Skill（以各客戶端文檔爲準）。
結尾¶
文件格式轉換器 (File Converter) 把圖片 Sharp 管線、視頻 FFmpeg 轉 GIF、PDF 合併等常見媒體操作收斂進一份社區 Skill，通過 SKILL.md 約束 Agent 行爲，並用 converter.js 提供可復現命令。若你的 workflow 以 design-media 類本地文件處理爲主，可從 SkillHub 安裝 @user_8509461a/file-converter-new，配好 Node 與 ffmpeg 後即可在對話裏按路徑驅動轉換。
官方入口：https://www.skillhub.cn/skills/user_8509461a/file-converter-new
