dsh-ocr-seam-guard

The dsh-ocr plugin on DeepSeek Harness relies on three hand-stitched patches that live outside the profile: an OCR service seam in the official dsh-llm-deepseek adapter, a UTF-8 stdout enforcement for the Python OCR subprocess, and a rapidocr 1.2.3 API compatibility fix. Any npm global upgrade or plugin re-installation silently wipes these patches, and the resulting OCR failure often produces misleading downstream errors that are painful to track down.

dsh-ocr-seam-guard inspects all three sites on every harness boot. When a patch is missing it re-applies the fix via anchored string replacement — every anchor must match exactly once, otherwise the entire site is skipped to guarantee no partial patch. After patching, the module is import-verified in a child node process; a failed verification rolls the file back and surfaces the error. If the upstream code shape has drifted and no anchors match, the guard simply logs and leaves the code untouched for human review.

If you run dsh-ocr on Harness and regularly perform dsh upgrades or plugin reinstalls, this guard turns every boot into an automatic health check: patches in place means a silent pass, a missing patch is re-applied in seconds with a one-restart notice, and drifted anchors trigger an explicit alert — keeping the silent post-upgrade OCR breakage out of your production path.