AI & agents · Analysis
read-image
/read-image
读取图片内容并返回文字,支持本地路径和 URL;用于看图、描述截图、OCR 提取文字、读图表数值、分析界面布局。当用户提供图片或要求识别图片内容,而主模型没有视觉能力时使用。
- Author
- ren-qianxiao ↗
- Repository
- read-image ↗
- Licence
- MIT
- Last repository change
- 28.10.2026
Assessment and security
100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
- Files in this package
- 6
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 1
Deprecation
No signals detected. Repository changed on 28.10.2026, without references to retired models or APIs.
Licence
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
读取图片内容并返回文字,支持本地路径和 URL;用于看图、描述截图、OCR 提取文字、读图表数值、分析界面布局。当用户提供图片或要求识别图片内容,而主模型没有视觉能力时使用。
Original author description
读取图片内容并返回文字,支持本地路径和 URL;用于看图、描述截图、OCR 提取文字、读图表数值、分析界面布局。当用户提供图片或要求识别图片内容,而主模型没有视觉能力时使用。
How it works
- 何时使用
- 标准流程
- 引导配置 API Key
- 排错
- 不要做
Original SKILL.md headings · 105 lines, 233 words
SKILL.md preview
---
name: read-image
description: 读取图片内容并返回文字,支持本地路径和 URL;用于看图、描述截图、OCR 提取文字、读图表数值、分析界面布局。当用户提供图片或要求识别图片内容,而主模型没有视觉能力时使用。
---
# read-image
主模型没有视觉通道时,所有图片内容都必须通过 `read_image` 工具获取。不要假装看到了图。
## 何时使用
- 用户给出图片路径或链接,要求描述、总结或识别
- 需要从截图里提取文字(OCR)
- 需要读取图表里的数值
- 需要分析界面布局
- 用户说「看看这张图」「这张图里是什么」「把图里的字提取出来」
## 标准流程
### 第一步:确认配置
首次使用、或任何工具报错时,先调用:
```
read_image_doctor
```
根据结果分支:
- 显示「配置可用」→ 直接读图
- 显示没有 API Key → 进入下面的【引导配置】
- 显示接口不可达 → 提示检查网络/代理,不要继续重试
### 第二步:读图
调用 `read_image`:
| 参数 | 怎么填 |
|---|---|
| `paths` | 用户的图片路径列表,支持本地路径和 http(s) |
| `question` | 用户的具体问题;没有明确问题时用"描述这张图" |
| `mode` | 描述整体用 `describe`;提文字用 `ocr`;看界面用 `ui`;读图表用 `data` |
| `detail` | 细节密集的截图用 `high`,普通图片用 `auto` |
### 第三步:回答
把返回的文字整理成自然语言。只依据工具返回的内容回答,不要补充图中不存在的细节。
---
## 引导配置 API Key
当 `read_image_doctor` 显示未配置 Key 时,**不要一次性甩一大段说明**,按下面的节奏一步一步来:
### 1. 说明需要什么
告诉用户:
> 需要智谱的 API Key。打开 https://open.bigmodel.cn/usercenter/apikeys ,注册后创建一个,复制那串 Key。
### 2. 请求用户粘贴
> 把 Key 粘贴到这里,我会写入本机的配置文件,不会上传到别处。
### 3. 写入配置
收到 Key 后调用:
```
read_image_setup(api_key="用户提供的Key")
```
可选参数:`model` 指定默认模型,`base_url` 指定其他 OpenAI 兼容网关。
### 4. 验证
调用 `read_image_doctor` 确认:
- 成功 → 告诉用户「配置完成」,并用一张图片实际读一次
- 失败 → 根据错误提示处理(见下表)
### 配置过程中的规矩
- **不要在回复里回显完整 Key**,只显示前 6 位 + 后 4 位
- 用户不想粘贴 Key 时,给两个替代方案:
1. 自己创建 `~/.claude/read-image.json`,内容为 `{"api_key": "..."}`
2. 设置环境变量 `ZHIPU_API_KEY`
- Key 无效(401)时提示重新申请,不要反复重试同一个 Key
- 不要把 Key 写进代码、日志或 git 仓库
---
## 排错
| 现象 | 处理 |
|---|---|
| `找不到图片文件` | 让用户确认路径;注意 Windows 反斜杠 |
| `401 Unauthorized` | Key 错误,重新引导配置 |
| `429` | 限流或额度用完,提示稍后再试或充值 |
| 模型不可用 | 服务会自动降级;可用 `read_image_doctor` 看可用模型 |
| 请求超时 | 检查网络或代理;可设 `READ_IMAGE_TIMEOUT` |
| 工具本身不存在 | 插件没连上:让用户执行 `/mcp` 检查 `vision` 是否为 connected,必要时重启 Claude Code |
## 不要做
- 不要在没有调用工具的情况下描述图片内容
- 不要在回复中泄露完整 API Key
- 不要跳过 `read_image_doctor` 直接猜测配置状态
Files in this package (6)
- .gitignore 1 KB
- .mcp.json 1 KB
- LICENSE 1 KB
- README.md 4 KB
- SKILL.md 3 KB
- requirements.txt 1 KB
Versions
The database has no other skills named read-image.
Database snapshot: 13.11.2026 · package version 02863288c556 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 98vision
Give the agent vision when the model itself is text-only (no image input). Use this skill whenever the user asks you to look at, analyze, describe, read, or OCR any image — a screenshot, a photo, a diagram, a UI, a chart, an error dialog, a pasted picture, or anything visual.… - 98linkfox-multimodal-recognize-image
基于多模态AI的图片识别与分析。当用户想分析、描述、从图片URL中提取信息、image recognition, image analysis, image description, image content understanding, OCR text recognition, visual Q&A时触发此技能。当用户提到图片识别、图片分析、图片描述、识别图片内容、分析产品图、从图片中读取文字、描述图片、提取视觉内容或理解照片内容时触发。当用户提供图片URL并就其视觉内容提问时,即使未明确说"图片识别",也应触发此技能。 - 100analyze-images
Read, describe and answer questions about images (screenshots, renders, photos) using the vision MCP server backed by the three.ws vision pipeline. Use when the user wants OCR, a caption, alt text or a visual critique of an image URL or base64 image. - 100image-analysis
Analyze an image — screenshot, diagram, UI mockup, or chart — with Claude's vision. Triggers on: analyze this image, look at this screenshot, what's in this diagram, read this mockup, describe this picture, analyze image. - 100screen-ocr
读取用户给出的截图/图片文件,提取文字、表格转 Markdown、识别代码、公式转 LaTeX、解读报错。当用户说"读一下这张截图"、"把这个表格截图转成 Markdown"、"这段报错截图什么意思"、"把图里的代码抠出来"、"OCR this screenshot"、"extract this table from the image"时使用。只处理用户显式给出的图片文件,不做实时截屏。 - 98local-ocr
批量 OCR:处理较多页数的、以文本为主的扫描版 PDF(先渲染成图片再逐页识别),或批量纯文字图片(试卷/文档截图/书页照片等需要查看具体文字内容的图片)。注意是纯文字图片——只提取图中文字、公式(LaTeX)、表格(Markdown),不能理解几何图形和图表结构。当前模型无视觉能力而任务需要读图文字时也用它。触发词:OCR、识别图片、批量识别、提取文字、扫描件、读 PDF 内容。