convez.ai
MCP ServerAutomaçãoIntermediário
CarGuo

Image Eye Checker

CarGuo/image_eye_checker

Classificador offline de fotos por estado dos olhos com detecção de múltiplos defeitos

Ver no GitHub
InicialPluginScore · de 0 a 100

Ferramenta 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_checker

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
2

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

本地、离线、跨平台的照片"闭眼废片"批量筛选器

把一个装满照片的目录拖进来,自动识别每张图里的人是 睁眼 / 眯眼 / 闭眼,按分类导出。婚礼摄影筛废片、证件照初审、合影补拍前置筛查的典型工具。

Platform Flutter MediaPipe OpenCV YuNet License


能干什么

  • 一键把目录里所有照片按 睁眼 / 眯眼 / 闭眼 / 不确定 / 失败 五桶分类导出。
  • 同时识别模糊、过曝、欠曝、不看镜头、侧脸等专业摄影筛废副信号。
  • 跨图近重复(连拍 / 重复保存)pHash 聚类,可一键收敛每组只留一张。
  • 完全本地推理,零联网、零云上传、零账号、零费用,支持 JPG / PNG / HEIC / RAW。
  • macOS dmg 内嵌 Python 与全部依赖,零配置开箱即用。

安装

平台包说明
macOS (Apple Silicon / Intel).dmg内嵌 Python 零配置,详见 docs/install.md
Windows.msix (+ .cer)首次需信任随附证书
Linux.AppImagechmod +x 后直接运行

最新版本在 GitHub Releases。从源码运行 / 打包脚本同样见 docs/install.md。

接入 AI Agent

核心识别管线被同时打包成三个跨 agent 通用入口,OpenClaw / Hermes / Claude Desktop / Cursor / Continue 等任何会调用工具的 LLM 都可以直接用。

入口形态文档
桌面 App「为 AI Agent 配置」按钮一键打印本机绝对路径示例命令docs/agent_skills.md
CLI Skillskills/image_eye_checker_skill/ 每行 stdout 一个 JSON 事件skills/image_eye_checker_skill/SKILL.md
MCP Servermcp/eye_mcp_server.py 暴露 detect_eyes + export_bucketsdocs/agent_skills.md

OpenClaw 端到端教程:docs/openclaw_setup.md。

文档

文档内容
docs/install.md安装、源码运行、三平台打包脚本、xattr 解释
docs/algorithm.mdEAR / Blendshape 双信号融合、ISO/TR 21959-1 头姿门控、pHash 跨图去重、两阶段人脸召回,全部含论文出处
docs/parameters.md全部可调参数(CLI flag、MCP inputSchema、Skill yaml、Flutter UI 四端对齐),含按标签子集导出
docs/agent_skills.mdCLI 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

Ver o original no GitHub

Bom para

Relacionados