ModLens — Cầu nối thị giác
Giúp các mô hình chỉ xử lý văn bản 'đọc' được hình ảnh: chỉ cần đường dẫn ảnh, skill gọi CLI modlens và trả về JSON có OCR, bố cục và ngữ nghĩa.
Tiện íchTrung cấp★ 699⑂ 22Điểm AI 9/10Cập nhật lần cuối: 13 thg 8, 2026
Nó làm được gì
- Tự kích hoạt khi trong hội thoại xuất hiện đường dẫn/URL ảnh (
.png,.jpg,.webp,.heic...) hoặc placeholder dán ảnh như[Image #1],[Unsupported Image]. - Không tự dựng OCR, không dùng PIL/tesseract: gọi CLI
modlensđể nhận JSON gồm toàn bộ văn bản, vùng bố cục, ngữ nghĩa và danh sách điểm chưa chắc chắn. - Chạy
modlens guardtrước lần đọc đầu tiên để kiểm tra mô hình hiện tại có thị giác gốc hay không, tránh gọi thừa. - Hướng dẫn cài đặt và chuyển đổi nhà cung cấp: khóa Gemini API, endpoint tương thích OpenAI, Claude API hoặc Claude Code CLI.
- Có thứ tự dò runtime (
modlenstrên PATH →npx→bunx) và quy tắc thử lại khi lệch schema hoặc hết thời gian chờ.
Phù hợp với ai
- Người làm việc với ảnh chụp màn hình, sơ đồ, hóa đơn trong môi trường mô hình chỉ có văn bản.
- Lập trình viên dùng quy trình CLI/terminal không hỗ trợ đính kèm ảnh.
- Nhóm muốn cấu hình nhiều nhà cung cấp thị giác theo chuỗi dự phòng ổn định.
Ví dụ sử dụng
- Dán đường dẫn
~/shots/error.png; skill chạymodlens -i ~/shots/error.pngvà trích dẫn nguyên văn thông báo lỗi. - Đưa ảnh mockup UI kèm
--prompt "tập trung vào nhãn nút và bố cục"để lấy các vùng layout phục vụ viết đặc tả giao diện. - Lần đầu dùng và cấu hình còn trống: yêu cầu "cấu hình khóa Gemini cho modlens", skill sẽ theo tài liệu onboarding và chỉ bật đúng nhà cung cấp bạn chọn.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/liustack/modlens/HEAD/skills/modlens/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục skills/modlens từ repo GitHub liustack/modlens vào ~/.claude/skills/modlens/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/liustack/modlens.git /tmp/modlens && mkdir -p ~/.claude/skills && cp -r /tmp/modlens/skills/modlens ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal.
- Cài Node.js 22.13+ (https://nodejs.org) hoặc Bun (https://bun.sh); kiểm tra bằng
node -v. - Tải mã nguồn:
git clone https://github.com/liustack/modlens.git /tmp/modlens - Sao chép skill:
mkdir -p ~/.claude/skills && cp -r /tmp/modlens/skills/modlens ~/.claude/skills/ - Khởi động lại Claude Code và kiểm tra thư mục
~/.claude/skills/modlens. - Kiểm tra môi trường:
npx --yes --package @liustack/modlens@3.11.0 modlens doctor - Thêm khóa nhà cung cấp (ví dụ Gemini API key); nếu chưa biết cách, hãy nhờ Claude "giúp cấu hình modlens".
- Dán thử một đường dẫn ảnh để xác nhận hoạt động.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT