前言¶
DeepSeek Harness (DSH) 提供了插件化的擴展能力。針對代碼審查或文檔處理中的 OCR 場景，dsh-ocr-review 插件通過封裝外部 CLI 工具，將其轉化爲 DSH 可調用的模型工具與設置卡片。
插件定位¶
該插件將 open-code-review（ocr CLI）封裝爲 5 個模型工具和 1 個 Web 設置卡片。它負責參數驗證、配置注入以及結構化摘要的返回，解決宿主服務不處理參數形狀和類型檢查的問題。
核心功能¶
- 工具封裝：註冊了 5 個工具，包括
ocr-review-routing和ocrReview。 - 設置卡片：提供 1 個 Web 設置卡片，用於從宿主設置服務選擇 provider/model。
- 參數驗證：插件負責驗證工具參數的形狀和類型。
- 配置管理：聲明瞭 6 個
.volatile()設置字段（命名空間ocr-review），從宿主讀取 provider/model 並寫入外部 CLI 配置。 - 結構化輸出：返回結構化的 OCR 摘要。
依賴與安裝¶
在使用此插件前，需要滿足宿主環境和外部 CLI 的要求。
宿主環境要求¶
- DeepSeek Harness 版本必須
>= 0.2.1-rc.2。 - 需要安裝版本匹配的
@jayyuen66/dsh-plugin-shared。
外部 CLI 安裝¶
插件不包含 OCR 庫，僅通過進程調用外部 CLI。必須手動安裝以下版本：
# 使用 Homebrew 安裝（無法指定版本，使用最新穩定版）
brew install open-code-review
# 使用 npm 安裝（指定 1.13.0 版本）
npm i -g @alibaba-group/open-code-review@1.13.0
使用說明¶
- 配置 Provider/Model：通過 Web 設置卡片從宿主服務的 provider 清單中選擇模型。
- 執行任務：使用封裝好的工具執行 OCR 任務。
- 獲取結果：插件返回結構化摘要，包含 OCR 發現的內容和運行覆蓋情況。
注意事項¶
- 平臺限制：僅支持 macOS 和 Linux。
- Windows 風險：在 Windows 上運行時，若主進程異常退出，OCR 進程可能成爲孤兒進程。
- 版本匹配：外部 CLI 必須安裝 1.13.0 版本，否則工具會拒絕執行。
- 參數合併：
--exclude和--path參數會被合併爲逗號分隔的字符串。 - 格式限制：
--format參數僅接受/text/sarif。
結語¶
該插件通過標準化封裝，將現有的 OCR CLI 工具接入 DSH 生態。使用前請確認宿主版本和 CLI 版本，並注意平臺兼容性。
