前言¶

設計稿、截圖或素材往往只有網頁或屏幕分辨率，要進印刷或高清展示時，單純拉大像素只會糊。手工走 Photoshop 放大、再調 DPI，步驟多且難在 Agent 對話裏復現。SkillHub 社區 Skill「圖片擴大」（@user_8e8df319/image-upscale）把 Real-ESRGAN 與 LANCZOS 串成固定流程，支持 PSD/PNG/JPG，輸出帶 DPI 元數據的高分辨率 PNG，適合在 Cursor 等環境裏用自然語言驅動。

這是什麼¶

「圖片擴大」是 SkillHub 上分類爲 design-media 的社區 Skill，座標 @user_8e8df319/image-upscale，當前版本 1.0.0，發佈者 user_8e8df319。標籤標明 requires_api_key=false，不依賴外部 API Key。

一句話定位：基於 Real-ESRGAN 神經網絡做 4× AI 放大，再用 LANCZOS 插值拉到目標倍數，並把 DPI 寫入 PNG，供打印或高清交付使用。

核心功能¶

下面介紹已寫在官方 Skill 說明中的能力，不展開未在資料中出現的能力。

1. 輸入格式：PSD、PNG、JPG/JPEG；PSD 會合並圖層爲 RGB 並記錄原始尺寸。
2. 放大策略：先用 RealESRGAN_x4plus（約 63.9MB 權重）做 4× 放大與細節重建；若目標倍數大於 4×，剩餘倍數由 LANCZOS 插值完成。
3. 大圖與設備：支持分塊（tile）推理以控制顯存；有 CUDA 時優先 GPU，也可指定 CPU。
4. 輸出：高分辨率 PNG，默認命名 {basename}_{scale}x_{dpi}DPI_realesrgan.png；可單文件或批量目錄處理，已存在同名輸出會跳過。
5. DPI：可在流程中配置目標 DPI（Skill 內默認 300），並寫入 PNG 元數據。

Skill 簡介還約定 Agent 應在用戶提到 upscale、enlarge、magnify、提高分辨率、印刷 DPI、PSD 轉高清 PNG 或需要 AI 補細節時使用本 Skill。

安裝與啓用¶

通過 SkillHub CLI 安裝¶

先確認本機是否已有 skillhub：

command -v skillhub && skillhub --version

未安裝時，可按 SkillHub 安裝文檔執行完整安裝（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

安裝 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 且可能不被識別。常見路徑如下（摘自 SkillHub 安裝說明）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

對本 Skill 執行安裝（slug 需帶 @ 前綴）：

skillhub install '@user_8e8df319/image-upscale' --dir ~/.cursor/skills/

SkillHub 頁面也提供等價提示：讓 AI 根據 https://skillhub.cn/install/skillhub.md 安裝 @user_8e8df319/image-upscale。

運行依賴¶

Skill 內 scripts/upscale.py 標明依賴：PyTorch、Pillow、numpy、requests。首次運行若本地無模型，會從 Real-ESRGAN 官方 Release 自動下載 RealESRGAN_x4plus.pth 到 scripts/ 目錄，也可手動下載後放到同路徑。

典型用法¶

在 Agent 對話中觸發¶

安裝並加載 Skill 後，可先讓 Agent 按 Skill 的 Phase 0 與你確認兩項參數：放大倍數或目標尺寸（默認 10×，即邊長約變爲原來的 10 倍）和 目標 DPI（默認 300）。若你給出目標像素邊長，Agent 會按 scale = ceil(target / original) 推算倍數。

隨後 Agent 會按 Skill 工作流讀取原圖、執行 Real-ESRGAN 4×、LANCZOS 拉到目標倍數、寫入 DPI 並輸出 PNG。

直接調用腳本（可復現）¶

在 Skill 目錄下，可用 CLI 做單圖或批量處理：

# 單圖：10 倍放大，300 DPI
python scripts/upscale.py input.png -o output.png -s 10 -d 300

# 批量處理目錄
python scripts/upscale.py ./images/ --batch -s 10 -d 300

# 無 GPU 時指定 CPU
python scripts/upscale.py input.png --device cpu

Python 調用示例（與 SKILL 一致）：

from scripts.upscale import upscale_image, batch_upscale

result = upscale_image('input.psd', 'output.png', target_scale=10, target_dpi=300)
results = batch_upscale('./images/', target_scale=10, target_dpi=300)

適用場景與注意¶

適合誰

• 需要在對話裏把 PNG/JPG/PSD 放大到指定倍數或像素，並要打印級 DPI 的設計、運營或開發。
• 希望 4× 以內由 Real-ESRGAN 補紋理與邊緣，更大倍數由 LANCZOS 承接，而不是全程雙線性拉大。

限制與注意

• 大於 4× 的部分本質是插值，不是全程 AI 生成；倍數拉得過高，預期應接近「清晰放大」而非無限細節。
• 依賴 PyTorch 與可選 GPU；大圖分塊與批量時的顯存清理邏輯在 Skill 說明中有描述，機器內存/顯存仍可能成爲瓶頸。
• 模型首次下載約 63.9MB，需網絡可達 GitHub Release 地址。
• SkillHub 頁面統計（以社區頁與抓取資料爲準）：評分 100000，下載約 985 次；安裝與升級以 SkillHub 與本地 skillhub 爲準。

結尾¶

「圖片擴大」把 Real-ESRGAN、LANCZOS 與 DPI 元數據寫成可重複的 Agent Skill，並附帶 scripts/upscale.py 便於腳本化。需要安裝或查看說明時，可參考：

• Skill 資源：https://api.skillhub.cn/user_8e8df319/image-upscale
• SkillHub 介紹頁：https://www.skillhub.cn/skills/user_8e8df319/image-upscale