前言¶
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 倉庫。
