前言¶

在 DeepSeek Harness（DSH）裏讓智能體使用「網上的圖」，常見做法是直接 fetch 某個 URL。HTTP 200 並不等於拿到有效位圖：同意頁、限流頁、防盜鏈跳轉或縮略圖地址，都可能被當成「下載成功」。image-scout 由社區維護者 2039108952x-lab 提供，在 DSH 中作爲「聯網工具」類插件，把搜索圖庫、下載文件與 magic bytes / 尺寸校驗串成一條 CLI 工作流，並附帶同名 agent skill，便於在 harness 流程裏按步驟調用。

下面介紹插件定位、核心命令、安裝方式與可復現示例。

這是什麼¶

image-scout 是 DeepSeek Harness 社區插件（npm 包名 dsh-image-scout，當前資料記載最新版爲 2.0.2）。它打包一份零 npm 依賴的 Node.js CLI（skills/image-scout/scripts/image-scout.mjs）和一份 skill 說明，用於回答：某個 URL 是否真是照片、下載結果是否可信。

• 維護者：2039108952x-lab
• 分類：聯網工具（SkillHub 目錄：image-scout）
• 源碼與文檔：GitHub - 2039108952x-lab/image-scout
• 許可證：MIT
• 運行環境：package.json 要求 Node ^22.19.0 || >=24.0.0
• 無需 API key；README 寫明無守護進程、無緩存目錄、無配置文件

插件爲社區作品，非 DeepSeek 官方產品，亦與 Wikimedia、Openverse 無隸屬關係。

核心功能¶

CLI 暴露四條子命令，README 用表格歸納其保證事項：

search 默認源爲 Wikimedia；可通過 --source openverse 切換。download 在信任鏈上比「裸 fetch」多一步溯源：你提供的圖片 URL 必須出現在你命名的頁面上下文中（查詢串與 Wikimedia 縮略圖尺寸會做規範化，以便接受全尺寸等價 URL）。

安裝與啓用¶

在 DSH 的 web profile 下，README 推薦的註冊表安裝方式爲（帶完整性元數據，適配 DSH 常用的 nodeLinker: hoisted）：

dsh plugin --profile web add dsh-image-scout@2.0.2

若需固定 Git 標籤以保證可重現安裝，可使用：

dsh plugin --profile web add github:2039108952x-lab/image-scout#v2.0.2

安裝後重啓 profile 或等待 skill watcher。插件通過 skill-filesystem 提供者註冊自帶 skills/ 目錄，image-scout skill 即可用，無需複製到 ~/.dsh/skills。確認是否加載：

dsh --profile web --dump-config | grep image-scout

卸載：

dsh plugin --profile web remove dsh-image-scout

注意 skill 名稱衝突： DSH 中 customSkillDirs 優先級（300）高於插件內置 skill（600）。若本地已有同名 image-scout skill，會遮蔽插件版本；可改 frontmatter 名稱或移出 customSkillDirs。

安裝前請自行審閱 倉庫源碼 與 LICENSE；插件按當前 DSH 進程權限執行，聯網下載會訪問外部站點。

典型用法¶

在圖庫中搜索並下載¶

先用 search 查關鍵詞，再從結果裏取 image 直鏈做 download（建議帶上許可字符串便於側車元數據）：

$ image-scout search --query "red telephone box" --limit 3

$ image-scout download --from search --image-url "https://upload.wikimedia.org/…/Red_Telephone_Box_Defibrillator.jpg" \
    --out output/reference/red-telephone-box-01.jpg --license "CC BY-SA 4.0 - Sebastiandoe5"

成功時 CLI 會輸出 VERIFY_OK（格式、尺寸、字節數）、SAVED 路徑，以及可選的 .json 元數據側車（META:）。

使用 Openverse¶

$ image-scout search --query "cat portrait" --source openverse --limit 3

選定結果後同樣走 download --from search。

從網頁列舉候選再下載¶

對已有頁面 URL，用 list 抽候選圖，再用 download 時同時傳入 --page-url 與 --image-url，讓工具校驗 URL 與頁面的歸屬關係：

$ image-scout list --page-url "https://commons.wikimedia.org/w/index.php?search=cat&title=Special:MediaSearch&type=image" --limit 5

$ image-scout download --page-url "https://commons.wikimedia.org/w/…" \
    --image-url "https://upload.wikimedia.org/wikipedia/commons/…/Cat.jpg" --out output/reference/cat-02.jpg

僅校驗本地文件¶

對已下載文件可單獨執行 verify，複用與 download 相同的 magic bytes、尺寸與大小檢查（細節見倉庫 README）。

適用場景與注意¶

適合誰： 需要在 agent 工作流中引用可覈實來源的參考圖（例如寫作配圖、ComfyUI 參考圖等 README 關鍵詞場景），且希望避免「下到 HTML 錯誤頁仍當圖片用」的 harness 集成者。

不適合替代： 私有圖牀、需登錄或付費 API 的素材庫；本插件面向 Wikimedia Commons 與 Openverse 等公開檢索路徑。

環境： Windows 上若用裸 tarball URL 安裝可能觸發 ERR_PNPM_MISSING_TARBALL_INTEGRITY，README 建議改用上述 npm 或 github: 形式。經代理訪問 GitHub 時，需使用小寫的 https_proxy / http_proxy。

安全與合規： 遵守各圖庫許可與署名要求；download 輸出的 --license 字符串應來自搜索結果，勿隨意編造。

結尾¶

image-scout 把「搜圖 → 下載 → 證明是位圖」收成零依賴 CLI，並以 DSH 插件形式註冊 skill，補上了智能體不擅長的一環：在後續流程碰文件之前先驗 URL 與字節內容。更多命令參數與發佈說明見倉庫 README；安裝與分類信息亦可對照 SkillHub 目錄頁與 GitHub 倉庫。

• SkillHub：https://www.skillhub.cn/plugins/2039108952x-lab/image-scout
• GitHub：https://github.com/2039108952x-lab/image-scout