baoyu-compress-image

圖片壓縮工具

使用最佳可用工具（sips → cwebp → ImageMagick → Sharp）壓縮圖片。

腳本目錄

腳本位於 scripts/ 子目錄。{baseDir} = 此 SKILL.md 的目錄路徑。解析 ${BUN_X} 執行環境：若已安裝 bun → bun；若可用 npx → npx -y bun；否則建議安裝 bun。請將 {baseDir} 和 ${BUN_X} 替換為實際值。

腳本	用途
scripts/main.ts	圖片壓縮命令列工具

偏好設定（EXTEND.md）

依優先順序檢查 EXTEND.md — 第一個找到的優先使用：

優先順序	路徑	範圍
1	.baoyu-skills/baoyu-compress-image/EXTEND.md	專案
2	${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-compress-image/EXTEND.md	XDG
3	$HOME/.baoyu-skills/baoyu-compress-image/EXTEND.md	使用者家目錄

若未找到，則使用預設值。

EXTEND.md 支援：預設格式、預設品質、保留原始檔偏好。

使用方式

${BUN_X} {baseDir}/scripts/main.ts <input> [選項]

選項

選項	簡寫	說明	預設值
<input>		檔案或目錄	必填
--output	-o	輸出路徑	相同路徑，副檔名變更
--format	-f	webp, png, jpeg	webp
--quality	-q	品質 0-100	80
--keep	-k	保留原始檔	false
--recursive	-r	處理子目錄	false
--json		JSON 輸出	false

範例

# 單一檔案 → WebP（取代原始檔）
${BUN_X} {baseDir}/scripts/main.ts image.png

# 保留 PNG 格式
${BUN_X} {baseDir}/scripts/main.ts image.png -f png --keep

# 目錄遞迴處理
${BUN_X} {baseDir}/scripts/main.ts ./images/ -r -q 75

# JSON 輸出
${BUN_X} {baseDir}/scripts/main.ts image.png --json

輸出：

image.png → image.webp (245KB → 89KB，減少 64%)

擴充支援

透過 EXTEND.md 自訂設定。請參閱偏好設定章節了解路徑與支援的選項。