本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-ocr-local

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-ocr-local

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• Web：在输入框里按 Ctrl+V / Cmd+V
• TUI：按粘图键（见下表）

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

首次使用报错「环境未就绪/缺少依赖」怎么办？

对 agent 说「用 ocr_setup 工具安装 OCR 环境」会自动建 venv、装依赖、下模型；也可手动执行 setup.py。整个流程幂等，可重复运行。

模型下载很慢或失败？

设镜像前缀后重跑：DSH_OCR_MODELS_MIRROR=https://ghproxy.com/ python ocr/setup.py。下载带 sha256 校验，损坏会自动重下。

TUI 端粘贴图片没反应？

先确认终端能读到剪贴板图片：Windows/macOS 开箱即用；Linux Wayland 需装 wl-clipboard，X11 需 xclip，否则粘贴会静默失败。

Web 端粘贴图片没反应？

确认插件装到了 web profile、配置 pasteToPath 不是 false，且重启过 dsh web。浏览器控制台看 [dsh-ocr] 报错。

识别结果有错字？

看输出里的 ⚠ 标注，字太小或置信度低的行会被标记。把原图放大一点，或让 agent 把对应行再确认一遍。

升级插件后功能没变化？

重启 dsh 让插件重新加载。TUI 端升级后若粘图失效（插件文件被覆盖），重跑安装脚本 install.sh / install.ps1 即可（幂等）。

系统提示 pip externally-managed-environment（PEP 668）？

不要加 --break-system-packages，直接跑 ocr/setup.py，它会自动建虚拟环境，绕开系统 Python 的限制。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明（通过 @deepseek-ai/cordis ^4.0.1 + @deepseek-ai/dsh-tools ^0.0.1-rc.1 集成）
• Node: 未声明（包内未声明 engines 字段，宿主 dsh 提供 Node 运行时）

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则