Claude Skill Xiaoer Upscale — Development skill for Claude Code

小耳超分 · Mac 本地图片超分 + 右键 4K/8K

在 Mac 上把图片**本地放大 / 提清晰度**(超分辨率),并一键装好 **Finder 右键 → 快速操作 → 超分 4K / 8K**。

• 🖥️ 纯本地、离线:引擎是 OpenCV dnn_superres,在 CPU 上跑。装完拔网都能用。
• 💸 不用 API key、不花钱:不调任何云端 AI 服务,零账号、零额度。
• 🖱️ 两种入口:命令行 upscale + Finder 右键快速操作(后台跑、完成弹通知、不卡 Finder)。
• 📦 一键装好:自动建虚拟环境、下模型、装命令、生成右键;全用 $HOME,换台 Mac 照装即可。

唯一一次联网 = 安装时下载 3 个超分模型(~41MB)。

安装

git clone  xiaoer-upscale && cd xiaoer-upscale
bash scripts/install.sh

装完:

• 命令行:upscale 图片.jpg --8k(别名 超分)
• 右键:选图片 → 右键 → 快速操作 → 超分 4K / 8K / 极速4K

命令行

upscale 图.jpg              # 默认满血 4x
upscale 图.jpg --4k         # 目标长边 3840
upscale 图.jpg --8k         # 目标长边 7680
upscale 图.jpg --16k        # 目标长边 15360(源不够大时为插值)
upscale 图.jpg --long 5000  # 自定义长边
upscale 图.jpg --scale 2    # 相对原图 2 倍
upscale 图.jpg --model edsr # 换模型(默认 lapsrn)

三档模型(速度 / 质量 · CPU 无 GPU)

模型	右键档	速度(2K 源)	质量	用途
fsrcnn	极速4K	~0.5s	稍软	快速预览 / 批量
lapsrn	4K / 8K	~6 分钟	好	出片默认
edsr	仅 CLI	~8 分钟+	最好	极致质量少用

模型是 4x,真实细节上限 = 源图长边 ×4。**2K 源 → 4K/8K 是真提升;16K 基本是插值**。

右键在新 Mac 上不出现?

选图右键没看到「超分」→ **系统设置 → 搜「扩展 / Finder」→ 勾上 超分 4K / 8K / 极速4K**。 完整排障(通知权限 / quarantine / PATH / 旧版路径)见 [`SKILL.md`](./SKILL.md) 的「右键设置 & 排障」。

边界

**只处理图片,不处理视频**(CPU 逐帧超分不现实,10s 片要几十小时)。视频超分请走 GPU 方案(Real-ESRGAN / Topaz Video AI)。

致谢

超分模型来自 OpenCV `dnn_superres` 官方预训练权重: [Saafke/EDSR_Tensorflow](https://github.com/Saafke/EDSR_Tensorflow) · [Saafke/FSRCNN_Tensorflow](https://github.com/Saafke/FSRCNN_Tensorflow) · [fannymonori/TF-LapSRN](https://github.com/fannymonori/TF-LapSRN)。 详见 [`references/models.md`](./references/models.md)。

License

MIT · Copyright (c) 2026 Jane (@xiaoerzhan / 小耳)

---

如果这个仓库对你有帮助,欢迎关注我。后面我会持续更新更多 AI Skill、设计方法、网站美学和创意工作流。

If this repo helped you, follow me for more AI skills, design systems, web aesthetics, and creative workflows.

• X (Twitter): [@xiaoerzh