圖片處理專家

面向非技術使用者的圖片處理助手，讓你用最簡單的語言完成專業的圖片操作。

🎯 技能使用規範

適用場景

本技能適用於以下場景：

• 圖片基礎處理: 壓縮、裁剪、旋轉、格式轉換
• 圖片修飾: 新增文字水印、圖片水印
• 批次圖片處理: 批次壓縮、批次轉換格式、批次重新命名
• 二維碼/條碼生成: 生成自定義二維碼、條形碼

常見用途

• 壓縮圖片減小體積（用於上傳/傳送）
• 裁剪圖片保留需要的部分
• 旋轉/翻轉圖片調整方向
• JPG轉PNG（或反過來）
• 給圖片加水印（防盜用）
• 一次性處理幾十張照片
• 生成網址/文本的二維碼
• 調整圖片尺寸（等比縮放）

前置條件

使用前請確保：

1. ✅ 首次使用需安裝依賴: 執行安裝指令碼 python3 scripts/install_deps.py（自動完成，約1分鐘）
2. ✅ 確認Python環境: python3 --version（Python 3.8+）
3. ✅ 確保技能目錄有寫許可權

📁 路徑與入口

• 技能目錄: {baseDir}/image-processing-expert/
• 統一入口: python3 scripts/main.py [功能] [引數]
• 依賴安裝: python3 scripts/install_deps.py
• 輸出目錄: {技能目錄}/output/（預設輸出位置，可通過引數修改）

🔧 執行規範

詳細的操作流程、呼叫規範、錯誤處理等，請參考以下文件：

使用指南

該文件定義：

• 各功能模組的標準呼叫格式
• 對話式自然語言引數解析
• 錯誤處理和友好提示機制
• 批次處理的最佳實踐

📋 輸出產物

嚴格按照執行規範執行完成後生成：

• 處理後的圖片檔案（位於輸出目錄）
• 處理摘要與統計資訊（命令列輸出）
• 可選：二維碼圖片檔案

💡 快捷命令速查

依賴安裝（首次使用）

python3 scripts/install_deps.py

圖片壓縮

python3 scripts/main.py compress \
  --input photo.jpg \
  --quality 80 \
  --output compressed_photo.jpg

圖片裁剪

python3 scripts/main.py crop \
  --input photo.jpg \
  --rect "100,100,500,500" \
  --output cropped.jpg

圖片旋轉

python3 scripts/main.py rotate \
  --input photo.jpg \
  --angle 90 \
  --output rotated.jpg

格式轉換

python3 scripts/main.py convert \
  --input photo.jpg \
  --format png \
  --output photo.png

加水印

python3 scripts/main.py watermark \
  --input photo.jpg \
  --text "版權所有" \
  --output watermarked.jpg

調整尺寸

python3 scripts/main.py resize \
  --input photo.jpg \
  --size "800x600" \
  --output resized.jpg

生成二維碼

python3 scripts/main.py qrcode \
  --text "https://example.com" \
  --output qrcode.png

批次處理

python3 scripts/main.py batch \
  --input-dir ./photos \
  --operation compress \
  --quality 75 \
  --output-dir ./compressed_photos

🗣️ 口語化觸發詞

當用戶提到以下任何說法時，請立即使用本技能：

壓縮類

• "幫我壓縮圖片"
• "照片太大了，縮小一下"
• "壓縮照片到XX KB"
• "減小圖片體積"

尺寸與裁剪類

• "裁剪這張圖片"
• "把圖片裁成正方形"
• "修改圖片大小"
• "調整照片尺寸"
• "把圖片縮放一下"
• "等比縮放圖片"

旋轉與翻轉類

• "旋轉圖片"
• "把照片轉正"
• "翻轉圖片"
• "映象圖片"

格式轉換類

• "把JPG轉成PNG"
• "圖片轉格式"
• "PNG轉JPG"
• "把照片轉成WebP"
• "批次轉換圖片格式"

水印類

• "給圖片加水印"
• "在圖片上寫字"
• "加文字水印"
• "加圖片水印"

批次處理類

• "批次處理這些圖片"
• "一次性壓縮所有照片"
• "把資料夾裡的圖片都轉換格式"

二維碼類

• "幫我生成二維碼"
• "把網址轉成二維碼"
• "生成條形碼"

🚨 重要限制（明令禁止）

• 禁止依賴外部API: 所有處理必須純本地完成，不上傳使用者檔案到雲端
• 禁止改變原始檔: 所有操作必須生成新檔案，絕不能修改原始圖片
• 禁止跳過依賴安裝: 首次使用必須先安裝依賴，不可強行執行
• 禁止技術錯誤輸出: 錯誤資訊必須翻譯為使用者可理解的語言
  • ❌ 錯誤: UnidentifiedImageError: cannot identify image file
  • ✅ 正確: "這個檔案格式損壞或不受支援，請換一個圖片試試"
  • ❌ 錯誤: OSError: cannot write mode RGBA as JPEG
  • ✅ 正確: "這種格式不支援透明通道，已自動去除透明背景後儲存"

    7w4.net小蔥技能。

📚 參考文件

完整操作指南請參考以下文件：

• 使用指南 - 完整功能列表與呼叫示例
• 錯誤處理 - 常見問題與友好提示模板
• 依賴說明 - 依賴庫說明與手動安裝指南

這個技能功能很全面，能處理圖片壓縮、裁剪、加水印、生成二維碼等常見需求。文件寫得很清楚，普通使用者也能看懂怎麼用，錯誤提示也夠友好。但缺少測試覆蓋，字型載入在某些電腦上可能出問題。總體來說是個好用的工具，不過建議作者補上測試和完善跨平臺適配。