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

快速上手

dsh-windows-ocr

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-windows-ocr

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

— 源: plugins.install

关键要点

• 不需要改任何模型配置——不用在 settings.yaml 里给模型加 input: [text, image]。
• 对 dsh 里的任何 provider/模型通用；默认所有附件图片在出站前都会先 OCR。
• 视觉模型透传是可选开启的（passthrough: true）。
• 默认安全（fail-closed）：插件没加载时，模型保持纯文本，图片附件会被拒绝——不存在静默泄漏；缺失 attachment 的图片块会被替换为拒绝文本，绝不会以原始 image 块保留。
• Windows 10/11（自带 Windows PowerShell 5.1，无需安装任何东西）

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件是不是只支持 Windows？

是。它会调用 powershell.exe 加载 WinRT 的 Windows.Media.Ocr 引擎（lib/ocr.ps1），Windows 之外的系统没有等价接口，因此 macOS / Linux 上无法工作。

默认会把原图发到服务商吗？

不会。passthrough 默认 false，所有图片在出站前先本机 OCR，序列化时只生成 text 内容块。要让真正的视觉模型接收原图才需要把 passthrough 显式设为 true。

中文图片识别不出来怎么办？

OCR 可用语言取决于系统装的 Windows 语言包。英文通常自带，中文需要装"中文（简体）"语言包（OCR-capable）。language 字段默认空，会用当前用户配置语言；指定中文配 language: zh-Hans 即可。

报 duplicate loader entry id: windows-ocr 启动失败？

dsh 0.1.0-rc.8 的 cordis-plugin-loader 1.0.2 拒绝重复 loader id。npm bundle 安装会自己插入 windows-ocr 这行，不要再在 profile 的 cordis.patch.yml 里手插同名 row；想改配置就用按 id 覆盖（- id: windows-ocr + config）方式。

OCR 失败时图片会不会原样外发？

不会。失败的图片块会被替换为"(OCR: failed to recognize this image)"占位文本；连缺失的 attachment 也会被替换成"(OCR: missing attachment — image refused)"。插件设计为 fail-closed，绝不让 raw image 块流到适配器。

怎么卸载？

用 npm 方式装的用 dsh plugin remove；手动方式装的删掉 profile 的 cordis.patch.yml 里 id: windows-ocr 那几行然后重启即可。卸载时插件会把 llm.resolveModelInfo / listModels 和适配器 stream 恢复成原始实现。

反复发同一张图会不会每次都跑 OCR？

不会按 attachment id 缓存，dsh 进程生命周期内同一附件只 OCR 一次。缓存上限由 maxCacheEntries 控制，默认 200 条，超出会按 Map 插入顺序淘汰最旧条目。

升级 dsh 后要不要重启？

建议完整重启。热重载（HMR）会替换适配器，本插件会监听 llm/adapters-updated 自动重新包装新适配器，但 dsh 整体升级后彻底重启最稳妥。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.8+（README 称在该版本上验证；package.json 未声明）
• Node: >=20

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则