Skip to content
Skills Library
Documents & office · Conversion & formats

screen-ocr

/screen-ocr

读取用户给出的截图/图片文件,提取文字、表格转 Markdown、识别代码、公式转 LaTeX、解读报错。当用户说"读一下这张截图"、"把这个表格截图转成 Markdown"、"这段报错截图什么意思"、"把图里的代码抠出来"、"OCR this screenshot"、"extract this table from the image"时使用。只处理用户显式给出的图片文件,不做实时截屏。

Licence
MIT
Last repository change
31.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
1
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 31.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

读取用户给出的截图/图片文件,提取文字、表格转 Markdown、识别代码、公式转 LaTeX、解读报错。当用户说"读一下这张截图"、"把这个表格截图转成 Markdown"、"这段报错截图什么意思"、"把图里的代码抠出来"、"OCR this screenshot"、"extract this table from the image"时使用。只处理用户显式给出的图片文件,不做实时截屏。

Triggers from the description

读一下这张截图把这个表格截图转成 Markdown这段报错截图什么意思把图里的代码抠出来OCR this screenshotextract this table from the image
Original author description

读取用户给出的截图/图片文件,提取文字、表格转 Markdown、识别代码、公式转 LaTeX、解读报错。当用户说"读一下这张截图"、"把这个表格截图转成 Markdown"、"这段报错截图什么意思"、"把图里的代码抠出来"、"OCR this screenshot"、"extract this table from the image"时使用。只处理用户显式给出的图片文件,不做实时截屏。

How it works

  1. 何时用
  2. 前置检查
  3. 命令配方
  4. 输出解读
  5. 失败处理
  6. 红线
Original SKILL.md headings · 68 lines, 270 words
SKILL.md preview
---
name: screen-ocr
description: 读取用户给出的截图/图片文件,提取文字、表格转 Markdown、识别代码、公式转 LaTeX、解读报错。当用户说"读一下这张截图"、"把这个表格截图转成 Markdown"、"这段报错截图什么意思"、"把图里的代码抠出来"、"OCR this screenshot"、"extract this table from the image"时使用。只处理用户显式给出的图片文件,不做实时截屏。
---

# 图片读字:OCR / 表格 / 代码 / 报错

## 何时用

用户给出一张**图片文件路径**(截图、照片),要求提取其中文字、把表格
转成 Markdown/CSV/JSON、还原代码块、解释报错内容。离线本地 OCR,不上传。

## 前置检查

**仅 Windows 10 1809+**(用内置 Windows.Media.Ocr 引擎,需装中/英语言包)。

```bash
python -m screen_command providers
```

- 列出 `windows available=True` → 可用(适配 **screen_command 0.4.0**,
  Python 3.11–3.13)。按 README 安装后,在 screen-command 检出目录内以
  `.venv\Scripts\python -m screen_command ...` 运行(或把该 venv 的
  Scripts 目录加入 PATH)。
- 未安装 → 克隆 `https://github.com/HarryHeYu/screen-command` 后按其
  README 建 venv 并 `pip install -e .`;非 Windows 平台直接告知限制并停。

## 命令配方

```bash
python -m screen_command process <图片> --action ocr          # 提取纯文字
python -m screen_command process <图片> --action table --md   # 表格→Markdown
python -m screen_command process <图片> --action table --format CSV    # 表格→CSV
python -m screen_command process <图片> --action code --md    # 还原代码块
python -m screen_command process <图片> --action formula --md # 公式→LaTeX
python -m screen_command process <图片> --action explain      # 解读报错内容
python -m screen_command process <图片> --action markdown --md # 整理成 Markdown
python -m screen_command process <图片> --action ocr --language zh-Hans-CN  # 指定语言
python -m screen_command process <图片> --action ocr --output result.txt    # 结果落盘
```

action 专属参数用 `--opt KEY VALUE` 传递(如 save_image 的输出路径);
`--output` 只是把结果文本另存为文件。

## 输出解读

stderr 先后输出 INFO 日志与元信息头 `[ocr · windows-media-ocr ·
zh-Hans-CN · 147 ms]`(方括号开头,action · provider · 语言 · 耗时);
**stdout 只有正文,可直接解析/引用**。OCR 偶有错字(如 讠练/IOSS),
转述给用户时对明显错字做合理修正并提示"OCR 结果仅供参考";表格对齐
靠词框重建,比纯 OCR 可靠。

## 失败处理

- `WinError -2003292336 无法找不到组件` → 优先怀疑**图片本身损坏**(常见
  成因:图片被文本模式转存,字节 ≥0x80 处全变成 EF BF BD)。首要诊断用
  binary-anatomy skill 的 `python -m ffe info <图片>`(在其检出目录内运行):
  健康图返回 JSON `"ok": true`;损坏图只回一行 `Unrecognized format: <路径>`
  (退出码 1)。"换个正常图片就成功"的对照 OCR 仅在用户已给出或同意
  其他图片时做。
- 提示未识别到表格/公式 → 选区内容真没有表格结构,如实说明,可建议
  用户改用 `--action ocr` 拿纯文字。
- 给的路径不是图片(PDF/Word 等文档)→ 说明本 skill 仅支持图片文件,
  建议用户先转成图片再处理。
- 非 Windows、缺语言包、provider 全不可用 → 明确告知平台/环境限制,停。

## 红线

- 只处理用户**显式给出**的图片**文件**路径;不主动截屏(截屏需要真屏且
  用户在场,不属于 agent 自主行为),不替用户启动 GUI 模式。
- OCR 结果是推断不是事实,逐字引用原文时保留原样,不静默篡改。

Versions

The database has no other skills named screen-ocr.

Database snapshot: 13.11.2026 · package version 75f09ed37540 (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

  • 98local-ocr
    批量 OCR:处理较多页数的、以文本为主的扫描版 PDF(先渲染成图片再逐页识别),或批量纯文字图片(试卷/文档截图/书页照片等需要查看具体文字内容的图片)。注意是纯文字图片——只提取图中文字、公式(LaTeX)、表格(Markdown),不能理解几何图形和图表结构。当前模型无视觉能力而任务需要读图文字时也用它。触发词:OCR、识别图片、批量识别、提取文字、扫描件、读 PDF 内容。
  • 100pdf-ocr
    Parse PDF files to markdown using GLM-OCR via Ollama locally. Converts each page to an image, runs OCR, and outputs clean markdown. Use when the user wants to extract text from a PDF.
  • 100document-processing
    This skill should be used when the user says \"process documents\", \"extract text from PDF\", \"OCR this document\", \"convert PDF to markdown\", \"extract emails from documents\", \"parse document\", \"document conversion\", \"batch OCR\", \"extract structured data from PDF\",…
  • 100glmocr
    Extract text from images using GLM-OCR API. Supports images and PDFs with high accuracy OCR, table recognition, formula extraction, and handwriting recognition. Use this skill whenever the user wants to extract text from images, perform OCR on pictures, scan documents, convert…
  • 100unlimited-ocr-parse-document
    Parse an image, PDF, or directory into markdown with LaTeX formulas, HTML/markdown tables, and per-block layout bounding boxes, using baidu/Unlimited-OCR locally — free, offline, no API key, no upload quota. Runs on Apple Silicon via MLX (~2.4 s/image, ~5 GB) or an NVIDIA GPU…
  • 95ocr_kb
    使用多模态大模型逐页读取长文档图片,精确提取文本、LaTeX公式和独立科研配图。支持环境清理、断点恢复、全局编号管理、失败页标记与部分重跑。逐页生成DOCX并每两页核查质量。本 Skill 专用于 Pipeline A(OCR 管道),处理 PDF 输入。中间产物全部放在 resources/,最终交付物放在 outputs/。Pipeline B / C 定义在主 SKILL.md 中。

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.