OCR 工具箱 · 截图图片文字提取
把图片里的字，变成能复制的文本。
这是什么
| 常见做法 | 问题 |
|---|---|
| 截图后手动打字 | 慢、错、累 |
| 在线 OCR 网站/API | 图片要上传，隐私风险 |
| 本 OCR 工具箱 | 本地离线识别，图片不出本机 |
什么时候用
- 把截图里的报错信息提出来搜解决方案
- 扫描件 / 拍照文档 转成文字
- 网页截图里的文字批量提出（几十张一次跑完）
- 聊天截图转成可编辑文本
快速上手
macOS 用户无需安装任何东西（用的是系统自带引擎）：
cd scripts
# 单张图片
python3 ocr_toolbox.py 截图.png
# → 生成 截图.txt
# 整个目录（含子目录）
python3 ocr_toolbox.py ~/Desktop/发票/ -r
# 输出 CSV 方便贴 Excel
python3 ocr_toolbox.py 批量图片/ --csv
# 英文图片
python3 ocr_toolbox.py 英文图.png -l en
# 先看效果（虚构样张离线演示）
python3 ocr_toolbox.py --demo
支持的引擎
| 引擎 | 平台 | 安装成本 | 中文效果 |
|---|---|---|---|
| macOS Vision（默认） | macOS | 零（系统自带） | ★★★★★ |
| tesseract + chi_sim | Linux / Windows / macOS | brew install tesseract tesseract-lang |
★★★☆ |
> 自动检测：有 Vision 用 Vision，没有就找 tesseract，都没有就打印安装指引。
参数速查
| 参数 | 说明 |
|---|---|
-r |
目录递归扫描子目录 |
-l en |
切英文识别（默认 zh-Hans 简体中文） |
--csv |
输出 CSV（原图路径 + 识别文字 + 行数） |
--check-env |
诊断当前系统 OCR 引擎可用性，并给出本平台安装引导 |
--demo |
生成虚构样张并完整演示 |
支持格式
png / jpg / jpeg / webp / bmp / tif / tiff / heic
安全与隐私
- 100% 本地识别，图片一个字节都不上传
--demo只生成虚构样张（示例超市/138-0000-0000/demo@example.com），绝不触碰真实文件
