DeepSeek Harness SimpleTex 專用 OCR 插件

在開發基於 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。