前言¶
DeepSeek Harness (DSH) 的核心逻辑是「一切皆插件」。在进行智能体开发时，经常需要处理图像信息。如果使用远程大模型（VLM）的视觉能力，通常意味着网络请求和 API 调用；而在本地 Mac 设备上，Apple 的 Vision 框架提供了强大的计算机视觉能力，但缺乏直接接入 DeepSeek Harness 的接口。
是什么¶
dsh-maclens 是一个由 Harzva 维护的 DSH 插件。它的作用是将 macOS 系统原生的 Vision 框架封装为本地 DSH 工具。它不依赖任何网络服务，不需要 API Key，直接将 OCR、图像分类、人脸检测和文档布局解析转化为 DeepSeek Harness 可以调用的函数。
核心功能¶
插件提供了以下本地工具：
* OCR：读取图像中的文字。
* Image Classification：识别图像类型（如文档、图表、照片）。
* Face Detection：检测图像中的人脸。
* Document Layout：解析页面布局（如左右分栏）。
* Combined Read：一次性调用上述所有能力。
安装与启用¶
安装需要满足系统环境要求：macOS 14+ 且已安装 Xcode Command Line Tools（Swift 6+）。
- 执行官方安装命令：
dsh plugin --profile desktop add dsh-maclens
- 安装完成后，重启 DSH。
典型用法¶
安装成功后，可以直接调用 CLI 进行测试，也可以在 Agent 中调用对应的工具。
直接使用 CLI：
# OCR 识别
bin/maclens ocr --image /Users/me/Desktop/shot.png
# 图像分类（返回前 3 个类别）
bin/maclens classify --image /path/to/img.png --top 3
适用场景与注意事项¶
- 隐私与速度：所有像素处理均在本地 Mac 的 Neural Engine 上完成，无网络请求，无上传，无遥测数据。对于典型截图，OCR 识别速度通常在亚秒级。
- 语言支持：默认支持简体中文（zh-Hans）以及 30 多种其他识别语言。
- 依赖与环境：该插件通过 npm 发布，包含预编译的 Swift CLI，无需额外的构建步骤即可安装。它不使用守护进程或占用端口。
- 二进制解析顺序：插件运行时会按以下顺序查找
bin/maclens可执行文件：bin/maclens（包内）→$MACLENS_BIN环境变量 →swift/.build/release/MaclensBridge→ PATH 中的maclens。
总结¶
dsh-maclens 解决了在 Mac 环境下进行纯本地、隐私友好的图像处理需求。它让 Agent 能够在不触碰云端 API 的情况下，完成文字识别和基础视觉分析。更多细节可查看插件目录或 GitHub 仓库。
