Image Eye Checker
CarGuo/image_eye_checker
Classificador offline de fotos por estado dos olhos com detecção de múltiplos defeitos
Ver no GitHubFerramenta local e offline para classificar fotos em lote por estado dos olhos (aberto/fechado/piscando) usando MediaPipe Face Landmarker e OpenCV YuNet. Perfeita para fotógrafos profissionais descartar fotos ruins, validar documentos e fazer pré-triagem de grandes volumes. Funciona como app desktop (macOS/Windows/Linux), Skill para agentes IA e MCP Server para Claude.
Instalação
npx convez-ai CarGuo/image_eye_checker1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Filtrar fotos de casamento/eventos descartando as com olhos fechados
- Pré-triagem de certificados e documentos de identidade
- Agrupamento de fotos repetidas (burst) com pHash e exportação automática
- Detecção secundária de desfoque, superexposição e falta de contato visual
Veredito

Solução robusta e bem-documentada que ataca um problema real em fotografia profissional com precisão. A integração com ecossistema Claude (MCP Server + Skills) o torna imediatamente útil em workflows de IA, sem dependências cloud ou custos de API.
README
A tradução para o português deste README ainda está na fila.
Image Eye Checker
本地、离线、跨平台的照片"闭眼废片"批量筛选器
把一个装满照片的目录拖进来,自动识别每张图里的人是 睁眼 / 眯眼 / 闭眼,按分类导出。婚礼摄影筛废片、证件照初审、合影补拍前置筛查的典型工具。
能干什么
- 一键把目录里所有照片按
睁眼 / 眯眼 / 闭眼 / 不确定 / 失败五桶分类导出。 - 同时识别模糊、过曝、欠曝、不看镜头、侧脸等专业摄影筛废副信号。
- 跨图近重复(连拍 / 重复保存)pHash 聚类,可一键收敛每组只留一张。
- 完全本地推理,零联网、零云上传、零账号、零费用,支持 JPG / PNG / HEIC / RAW。
- macOS dmg 内嵌 Python 与全部依赖,零配置开箱即用。
安装
| 平台 | 包 | 说明 |
|---|---|---|
| macOS (Apple Silicon / Intel) | .dmg | 内嵌 Python 零配置,详见 docs/install.md |
| Windows | .msix (+ .cer) | 首次需信任随附证书 |
| Linux | .AppImage | chmod +x 后直接运行 |
最新版本在 GitHub Releases。从源码运行 / 打包脚本同样见 docs/install.md。
接入 AI Agent
核心识别管线被同时打包成三个跨 agent 通用入口,OpenClaw / Hermes / Claude Desktop / Cursor / Continue 等任何会调用工具的 LLM 都可以直接用。
| 入口 | 形态 | 文档 |
|---|---|---|
| 桌面 App「为 AI Agent 配置」按钮 | 一键打印本机绝对路径示例命令 | docs/agent_skills.md |
| CLI Skill | skills/image_eye_checker_skill/ 每行 stdout 一个 JSON 事件 | skills/image_eye_checker_skill/SKILL.md |
| MCP Server | mcp/eye_mcp_server.py 暴露 detect_eyes + export_buckets | docs/agent_skills.md |
OpenClaw 端到端教程:docs/openclaw_setup.md。
文档
| 文档 | 内容 |
|---|---|
| docs/install.md | 安装、源码运行、三平台打包脚本、xattr 解释 |
| docs/algorithm.md | EAR / Blendshape 双信号融合、ISO/TR 21959-1 头姿门控、pHash 跨图去重、两阶段人脸召回,全部含论文出处 |
| docs/parameters.md | 全部可调参数(CLI flag、MCP inputSchema、Skill yaml、Flutter UI 四端对齐),含按标签子集导出 |
| docs/agent_skills.md | CLI Skill、MCP Server、Claude Desktop / OpenClaw / Cursor 接入配置 |
| docs/openclaw_setup.md | 下载 dmg → 在 OpenClaw 里注册并调用 的端到端教程 |
仓库结构
image_eye_checker/
├─ lib/ Flutter UI(macOS / Windows / Linux)
├─ assets/scripts/ Python 检测脚本 + MediaPipe / YuNet 模型
├─ skills/image_eye_checker_skill/ CLI Skill(Claude Skills / OpenClaw / Hermes / AGENT.md)
├─ mcp/eye_mcp_server.py MCP Server(stdio JSON-RPC)
├─ tools/ 一键打包脚本(make_dmg / make_msix / make_appimage)
├─ docs/ 文档与截图
└─ pubspec.yaml
License
MIT