mcpField
U
unblind

unblind

github.com/santazukiAgent 工作流2494 次安装21 周前更新
代码仓库

关于 unblind

unblind 是一个 Claude 技能，通过视觉 API 处理图像并返回文本。它支持图像描述、OCR、界面评审、图表数据、目标检测和图像比较，并要求使用随附脚本。

主要功能

  1. 01通过视觉 API 处理图像
  2. 02描述图像并提取文字
  3. 03评审界面布局与 UX
  4. 04分析图表并检测目标
  5. 05比较图像

适用场景

  1. 01从图像中提取文字
  2. 02评审屏幕布局
  3. 03描述图像或比较图像

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/santazuki/unblind --skill unblind

安装后在 Claude Code 中输入/unblind确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
LICENSE
README.md
TEST.md
install.sh
.github/workflows/
publish.yml
ci.yml
display/
2026-05-30-provider-v3-protocol-driven-design.md
provider-optimization.md
docs/test-results/
gpt-rebuttal-report.md
step1-logger-errorHandler.md
step15-validation-tests.md
step11-health-config.md
step10-cache.md
step14-phase0-silent.md
step13-openai-provider.md
step12-cache-granularity.md
step16-ci-circuitbreaker-fix.md
step17-phase3-chain-registry.md
step18-phase5-test.md
step3-credentialManager.md
step19-gemini-provider.md
step2-config.md
step6-provider-mimo.md
step4-retry.md
step7-orchestrator.md
step5-imageProcessor.md
step9-regression.md
step8-cli.md
resources/
troubleshooting.md

详细介绍

Unblind

将图像发送到视觉 API。绝不假装看到了。绝不读取或编辑 settings.json。

铁律

  1. 每次调用都必须执行 Phase 0
  2. 绝不读取或编辑 ~/.claude/settings.json
  3. 通过 CLI（--config、--set-model）或 node -e 配置，绝不通过工具配置
  4. 绝不添加开场白。绝不产生幻觉。始终调用捆绑脚本。
  5. 工具会自动从环境变量读取 API 密钥

快速开始

用户发送图像 → Unblind 将其发送到 Mimo/OpenAI → 返回文本。 OCR → 提取所有文本。ui-review → 评审布局/UX。describe → 详细描述。

Phase 0：自我修复

0.1 健康检查
node -e "const fs=require('fs');const os=require('os');const p=require('path').join(os.homedir(),'.claude','settings.json');const s=JSON.parse(fs.readFileSync(p,'utf8'));const issues=[];if(!s.env?.MIMO_API_KEY) issues.push('KEY_MISSING');if(!s.env?.MIMO_VISION_MODEL||s.env.MIMO_VISION_MODEL==='mimo-v2.5-pro') issues.push('MODEL_MISSING');const a=s.permissions?.allow||[];if(!a.some(x=>x.includes('unblind'))) issues.push('PERM_MISSING');if(issues.length) console.log(issues.join(' '));" 2>/dev/null
  • 为空 → 健康，跳到 Phase 1
  • KEY_MISSING → 0.3 | MODEL_MISSING → 0.5 | PERM_MISSING → 0.4
0.2 版本检查
cd ~/.claude/skills/unblind && git fetch 2>/dev/null && behind=$(git rev-list HEAD..origin/master --count 2>/dev/null) && [ "$behind" -gt 0 ] && echo "NEEDS_UPDATE $behind"
  • NEEDS_UPDATE <N> → 🐌 unblind 有 N 个更新没拿... git pull 一下嘛~（不阻塞）
0.3-0.9 修复 → Phase 1

参见 resources/phase0-details.md。全部健康 → Phase 1。

Phase 1-4：分析

  1. 检测 [Image: source: <path>] 中的图像路径。必须是绝对路径、扩展名受支持，且不含 shell 元字符。
  2. 分类模式：describe（默认）、ocr、ui-review、chart-data、object-detect、compare。
  3. 执行：node ~/.claude/skills/unblind/scripts/unblind.mjs '<path>' <mode> —— 不添加开场白。
  4. 报告：打印标准输出。API 密钥错误 → 返回 0.3。

资源

  • resources/phase0-details.md — 完整的 Phase 0 流程、CLI 参考、边缘场景
  • resources/troubleshooting.md — 修复命令、常见错误、Node.js 配置
  • resources/best_practices.md — 模型选择、token 优化、调试
  • README.md — 安装指南、安全验证

评论

支持 Markdown