在开发基于 DeepSeek Harness (DSH) 的智能体时，常需要将外部 OCR 能力接入。这款插件将 SimpleTex 的「公式识别」和「通用 OCR」接入了 DSH Web GUI。它注册了一个名为 simpletex_recognize 的模型工具，并提供了完整的输入交互组件。
插件介绍¶
- 名称：
dsh-simpletex-ocr - 作者：Huoer9527
- 许可证：MIT
- 仓库：https://github.com/Huoer9527/dsh-simpletex-ocr
安装与启用¶
安装插件需要联网，安装完成后需重启 Web 服务。
dsh plugin --profile web add https://github.com/Huoer9527/dsh-simpletex-ocr.git
dsh web
核心功能¶
插件主要解决 DSH 生态中图片识别能力不足的问题。它提供了以下能力：
- 工具注册：在 DSH Web GUI 中注册了
simpletex_recognize模型工具。 - 三件套交互：支持输入框拖图/粘贴、对话内缩略图、GUI 配置卡。
- 三种模式：
formula：返回 LaTeX 格式结果及置信度。text：返回 Markdown 格式结果。auto（默认）：根据question参数自动判断识别为公式还是文字。
- 安全校验：图片上传前会校验类型与大小。
- 安全存储：仓库不含任何密钥，API Key 仅写入凭证服务。
配置 API Key¶
使用前需要申请 SimpleTex 的 API Key（官网称为 Token，格式以 AT 开头）。
- 打开 SimpleTex 官网 注册并登录。
- 在账号/控制台申请 API Token（
AT开头）。 - 复制 Token。
在 DSH Web GUI 中配置：
打开 设置 → 插件配置 → SimpleTex OCR，将 Token 粘贴进密码框并保存。插件会将 Key 写入凭证服务 SIMPLETEX_TOKEN，不会落明文到设置文件。
工具用法¶
工具名为 simpletex_recognize，调用方式如下：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
image |
string | 是 | 本地图片路径、URL 或附件引用 |
task |
string | 否 | formula / text / auto，默认 auto |
question |
string | 否 | auto 模式下用于判断识别类型 |
示例：
// 识别公式
simpletex_recognize({ image: '公式.png', task: 'formula' })
// 默认自动识别
simpletex_recognize({ image: '截图.png' })
// 指定识别任务
simpletex_recognize({ image: '公式.png', task: 'auto', question: '把公式转成 LaTeX' })
返回格式：
* formula 模式：返回 { engine, task: 'formula', text: LaTeX, conf: 置信度 }
* text 模式：返回 { engine, task: 'text', text: Markdown }
生态与注意¶
- 更新生效：修改
settings.yaml或配置 API Key 后，必须重启dsh web才能生效。 - 权限与安全：插件以当前 dsh 进程权限运行，安装前建议检查源码与许可证。
- 目录索引：该插件已收录至社区目录 https://www.skillhub.cn/plugins/Huoer9527/dsh-simpletex-ocr。
