前言¶
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 版本，并注意平台兼容性。
