dsh-ocr-example
在终端中运行以下命令:
dsh plugin install Fe2-Plus/dsh-ocr-example
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install Fe2-Plus/dsh-ocr-example,或从 https://github.com/Fe2-Plus/dsh-ocr-example 按 README 以 link 方式装入 profile 并配置 DEEPSEEK_API_KEY 后重启 DSH。
插件介绍
如果你在 DeepSeek Harness 里想让智能体读懂本地的 PDF、Word、幻灯片或扫描图,又不想自己从零接 HTTP 和写工具注册逻辑,这个仓库就是一个能直接跑起来的起点。它注册名为 ocr_read 的工具:把指定路径上的单个文件交给 DeepSeek 的 OCR 服务,把识别结果落成 UTF-8 文本,并返回页数、字数、输出路径和一段预览,边界清晰——只读一个文件、只调一次接口、只写一个文件。
能力上支持常见办公格式与常见图片后缀;当路径没有扩展名时,会按文件头嗅探类型,这一点对 DSH 附件落盘很有帮助。purpose 可在默认的 text_recognition(偏快、适合日常抽字)与 rich_layout_recognition(版面更细、更慢更贵)之间切换;out 可自定义,省略则写到源文件旁的 .ocr.md。README 还刻意记录了手写工具定义时容易踩的坑(例如 output.schema 不能写成 type: json、以及不宜在插件里直接 import @deepseek-ai/dsh-tools),方便你照着改自己的插件时不至于「装上了却不生效」。
它适合两类人:需要在 DSH 里快速打通「本地文档 → 可读文本」链路的用户,以及正在写第一个或第二个 DSH 插件、想对照一份约 200 行的最小范例的开发者。需要强调的是:功能完全依赖 DeepSeek 在线 OCR,没有本地回退,离线不可用;识别结果仍可能有形近字错误,商用或严谨场景请结合原文核对。
使用场景
- 把本地 PDF 或 Office 文档转成可供智能体阅读的 UTF-8 文本
- 处理无扩展名的 DSH 附件文件并识别其中的文字
- 对照最小范例学习手写工具定义与注册流程
适合人员
- 在 DSH 中需要在线 OCR 读文档的用户
- 正在开发第一个 DeepSeek Harness 插件的开发者
- 要快速验证 ocr_read 工具是否加载成功的维护者