VisionCull Pro 是一款专为摄影师打造的桌面级 AI 选片工具。它利用本地运行的计算机视觉算法,在无需联网、不上传任何照片的前提下,毫秒级扫描海量摄影作品,自动剔除严重失焦、动态模糊的“废片”,将摄影师从枯燥的初筛工作中解放出来。
🌟 核心亮点
1. 🛡️ 100% 本地运算,隐私绝对安全
- 离线运行:基于 Node.js 与 Python 本地进程通信,所有数据处理均在本地完成。
- 商业级隐私保护:特别适合处理未发布的商业拍摄、人像写真或敏感题材,彻底杜绝云端泄露风险。
2. 🧠 精准 AI 视觉引擎
- Laplacian 方差检测:内置经典的拉普拉斯方差算法,通过计算图像梯度的变化率来量化清晰度。
- 智能识别:能精准定位画面中的失焦(Out-of-focus)与运动模糊(Motion Blur),过滤准确率极高。
3. 🎛️ 三档动态阈值调控
- 灵活适配:无论是手机随拍、单反直出,还是苛刻的内棚商业摄影,均可通过滑块自定义过滤锐度下限。
- 推荐标准日常单反使用 300 左右的阈值,可根据实际批次照片的质量分布微调。
4. 🛸 赛博极简美学 UI
- 沉浸式体验:暗黑模式工作台设计,视觉干扰极低,让注意力完全集中在照片本身。
- 原生交互:支持系统级文件夹拉起,操作流畅如原生客户端。
5. ⚡ 智能无损分发
- 源文件保护:判定合格的照片会自动拷贝至带时间戳的专属目录(如
Selected_Good_2024...),绝不移动或删除原始文件,确保数据万无一失。
🚀 快速启动指南
1. 环境准备
确保本地已安装:
- Node.js: v18 或以上版本
- Python: 3.10 或 3.11 版本
2. 初始化依赖
# 克隆仓库
git clone https://github.com/YuChiHuaCheng/vision-cull-pro.git
cd vision-cull-pro
# 安装前端依赖
npm install
# 创建并激活 Python 虚拟环境
python3 -m venv venv311
source venv311/bin/activate # Mac/Linux
# .\venv311\Scripts\activate # Windows
# 安装 Python 算法依赖
pip install -r requirements.txt
3. 点火运行
在项目根目录执行:
node server.js
随后打开浏览器访问:http://localhost:3000
💡 使用流程
- 选择文件夹:点击左侧配置面板的“浏览本地文件”,选择包含待筛选照片的文件夹。
- 设定阈值:拖动“清晰度阈值”滑块。建议先小批量测试,找到适合当前拍摄场景的标准(默认推荐 300)。
- 开始扫描:点击“开始执行扫描”,右侧终端将实时显示处理日志。
- 获取结果:扫描结束后,在源文件夹同级目录下查找名为
Selected_Good_[时间戳]的新文件夹,里面即为筛选后的优质成片。











评论