Unblind

一个不会悄无声息挂掉的视觉 skill

👁️ 自愈配置 · 熔断重试 · 安全沙箱 · 零依赖
🛠️ 全程 Claude Code 开发 · 自研双 Pipeline 多 Agent 协作模式

English | 中文

---

✨ 这是什么

Unblind 是给 AI Agent 用的视觉后端——不是面向人类的 App，而是面向 Agent 的基础设施。把图片路由到视觉 API，返回文字描述，让没有多模态能力的模型（如 DeepSeek）能够"看图"。

和大多数视觉 skill 不同的是，它不是一层薄薄的 API 封装。每一步都有防御：

用户发图 → Phase 0 自检（静默）→ 魔数校验 → 缓存查询 → Provider → 返回描述
                                                       （配几个用几个，失败自动切）

🚀 快速开始

# AI 安装
"帮我安装 unblind skill，npx skills add Santazuki/unblind，然后运行 install.sh"

# 手动安装
npm install -g @santaz-io/unblind
unblind-install           # install.js 部署到 ~/.claude/skills/

npm 包 26 文件 80KB，`install.js` 只部署核心（scripts/、SKILL.md、README.md）。

首次运行自动检测缺失配置并修复。

**开发者**：

git clone https://github.com/Santazuki/unblind.git && cd unblind
node --test tests/test-*.js   # 零依赖

⚙️ 工程特性

特性	说明
🩺 Phase 0 自愈	每次调用静默检查环境，配置缺失当场修复，不打断用户
🔌 熔断 + 指数退避	每 Provider 独立 CircuitBreaker，5 次失败熔断 60s
💾 SHA256 持久化缓存	内容寻址，TTL + LRU 1000，跨进程命中，--no-cache 跳过
🔀 Provider 故障转移	7 个 Provider 链式轮换，UNBLIND_PROVIDER_ORDER 自定义顺序
🛡️ 魔数文件校验	读取文件头字节，拒绝伪装成图片的攻击文件
🔒 安全沙箱	零 exec / child_process，API Key 不在任何输出中暴露
📐 结构化输出	`--format json
💬 过程反馈	📖读取 → 🚀调用 → ✅