handwritten-ocr

手写中文笔记和数学公式的图片，往往最容易被通用 OCR 服务忽略——要么识别率堪忧，要么必须把照片上传到第三方服务器，对隐私敏感的场景尤其不友好。handwritten-ocr 插件把整条识别链路搬到了本机：手写中文被还原为纯文本，数学公式被转换为 LaTeX 代码，最终统一输出为一份干净的 Markdown 文档。全程离线推理，图片与数据不出机器，无需联网即可完成识别。

底层由多个开源模型协作完成：Pix2Text MFD 1.5 负责公式区域检测，RapidOCR 处理中文文本行，UniMERNet 与 Pix2Text MFR 1.5 分别承担公式到 LaTeX 转换的主路径与兜底路径。推理后端支持 GPU（DirectML）、CPU 和 NPU 三种模式，所有可调参数集中在 settings.json 中，修改后保存即热加载生效，无需改动代码。调用方式灵活多样——可以用 FastAPI 服务配合浏览器管理面板操作，可以用命令行脚本批量处理，也可以作为 DSH 的 ocr_image 工具，让 LLM 在对话中直接接收图片链接并返回 Markdown 结果。

如果你平时习惯用笔记录课堂、会议或研究推导，又希望把纸质内容快速变成可搜索、可编辑的文本，这个插件就是为你准备的。它特别适合对数据隐私有要求的研究者、学生，以及希望在 DSH 等 LLM 工具框架中无缝集成手写识别能力的开发者。无需额外部署云端服务，一次安装后本地即开即用。