前言¶
DeepSeek Harness (DSH) 採用插件化架構。在使用 dsh-ocr 插件時，官方適配器中存在三個需要手動修復的細節，且這些修復位於 profile 之外。當執行全局升級（npm i -g @deepseek-ai/dsh）或插件重裝時，這些補丁會被覆蓋。dsh-ocr-seam-guard 旨在解決這一問題，作爲守護進程自動檢測並恢復這些補丁。
這是什麼¶
dsh-ocr-seam-guard 是一個由 DosterBool 維護的管理安全類插件。它作爲 dsh-ocr 插件的自我修復守衛，能在啓動時自動檢查並重新應用被升級擦除的本地補丁，確保服務環境的一致性。
核心功能¶
- 自動修復擦除的補丁：針對 dsh-ocr 插件依賴的三個關鍵位置進行監控，自動重新應用被
npm i -g @deepseek-ai/dsh升級或插件重裝擦除的本地補丁。 - 檢查三個關鍵位置：
* 適配器 seam（位於@deepseek-ai/dsh-llm-deepseeklib/index.js）。
* Python OCR 子進程的 UTF-8 stdout 強制執行。
* rapidocr API 的接口修正（1.2.3 版本text_det→text_detector等）。 - 錨定字符串替換：使用精確的錨定字符串進行替換，確保補丁內容的完整性。
- 模塊驗證與回滾：通過子
node進程驗證補丁後的模塊是否可正常加載，若失敗則自動回滾文件並報錯。 - 錨點漂移容錯：如果上游代碼錨點發生漂移，插件會跳過補丁並記錄日誌，避免錯誤應用。
安裝與啓用¶
- 執行安裝命令：
dsh plugin --profile web add github:YOURNAME/dsh-ocr-seam-guard
- 安裝後重啓 dsh 以激活補丁。
配置¶
| 環境變量 | 默認值 | 用途 |
|---|---|---|
DSH_OCR_ADAPTER_FILE |
自動檢測 | 覆蓋適配器文件路徑，僅支持 npm 全局安裝的 DSH 環境。 |
適用場景與注意¶
- 環境限制：僅支持 npm 全局安裝的 DeepSeek Harness。
- 激活時機：補丁激活前需要重啓 dsh。
- 異常處理：如果上游代碼錨點漂移，補丁將被跳過，需要人工介入檢查。
- 權限與安全：插件以當前 dsh 進程權限運行，使用前請檢查源碼與許可證（MIT）。
結語¶
該插件通過自動化手段解決了插件維護中的補丁易失問題，確保 OCR 服務的穩定性。更多詳情請查閱插件目錄或 GitHub 倉庫。
