前言¶
在 DSH（DeepSeek Harness）裏讓智能體「上網找圖」，常見做法是模型自己拼 URL 或一次性把文件寫進工作區。前者容易拿到縮略圖、帶水印的素材站圖，或根本下不下來；後者則缺少「你看過再決定留哪幾張」的環節。下面介紹社區插件 dsh-search-picture（維護者 tuanzi0v0）：把搜索、清晰度篩選、預覽和寫入系統相冊拆成兩步工具，在用戶明確滿意之前，相冊裏不會出現任何文件。
這是什麼¶
dsh-search-picture 是 DSH 的聯網工具類插件，GitHub 倉庫 tuanzi0v0/dsh-search-picture，SkillHub 目錄頁見 plugins/tuanzi0v0/dsh-search-picture。一句話定位：智能體調工具多圖源搜索並下載到預覽區，把圖片讀進上下文供你挑選；你確認序號後，再調用第二個工具把選中項平鋪複製到系統 Pictures 下的固定相冊目錄。
兩步工作流¶
工作流是兩步的，這一點很重要：
- 你說「幫我找幾張 XX 的圖片」，智能體調用
search_picture：併發查詢多個免 key 圖源，按規則篩選與排序，下載到預覽區，並把圖片作爲附件提交給模型，逐張說明來源與是否建議保留。 - 你說「第 1、3 張滿意」，智能體調用
save_pictures：只把指定序號或文件名的圖片寫入相冊；其餘可從預覽區刪除。
在你確認之前，相冊裏不會出現任何東西。
目錄約定¶
預覽與相冊路徑分工如下（Windows 示例如 README 所述）：
downloads/ 下載根目錄（配置裏的 directory），只放預覽區
└── .staging/<批次 id>/ 預覽區：候選先落這裏
├── STAGING.md 本批清單（分辨率/來源/直鏈）
└── 查詢詞-01.jpg 候選文件
%USERPROFILE%\Pictures\dsh-search-picture\ 相冊：圖片平鋪，不建子文件夾
├── 查詢詞-01.jpg
└── 查詢詞-03.jpg
相冊是固定目錄、圖片平鋪；folder 參數已棄用。寫入是複製而非移動，確認過的圖仍留在預覽區。相冊內重名會自動追加 -2、-3，不覆蓋已有文件。新搜索開始前默認會清理上一批預覽（autoCleanPreview: false 可關閉）；當前批次不會被刪。
相冊在工作區之外。會話沙箱默認爲 workspace-write 時，寫入相冊需要一次放寬到完全訪問的批准（ask 策略下會彈窗確認）。
核心功能（已文檔說明部分）¶
| 環節 | 行爲摘要 |
|---|---|
| 搜索引擎圖 | 併發 Bing 圖片、百度圖片、360 圖片、嗶哩嗶哩圖文（專欄配圖與圖文圖片集，不用視頻封面），按圖片地址去重 |
| 相關站點 | 萌娘百科默認開啓（relatedSites），用 opensearch 找詞條、generator=images 取圖；可選 biligame，默認關閉（WAF 易返回 HTTP 567） |
| 官網素材 | 默認關閉（officialSite: true 可開）；README 實測說明官網首頁圖多爲活動主視覺，對「指定角色」用途噪聲較大 |
| 插畫源 | 可選 Safebooru（tags 參數）：標籤爲英文 romaji、下劃線連接；中文/自然語言查詢不會走該源 |
| 知乎偏好 | 不直連知乎站內（多入口 403/401）；通過百度等引擎命中 zhimg.com 後從圖牀取圖，且可標爲 hotlinkFriendly |
| 水印 | 無視覺模型，按域名黑名單（watermarkHosts 可追加）與 URL/文件名含 watermark、水印 等確定性規則在下載前剔除 |
| 清晰度 | 默認門檻約 720p（921600 px²）；下載後按解碼尺寸校驗面積、長邊、長寬比，不達標淘汰 |
| 展示 | 圖片進模型上下文；Client 側可渲染縮略圖畫廊與「保存結果」卡片（工具卡片默認摺疊） |
工具參數¶
search_picture（搜索到預覽區）¶
| 參數 | 必填 | 說明 |
|---|---|---|
query |
是 | 圖片內容描述，中英文均可 |
count |
否 | 張數，默認取配置 count，不得超過配置值 |
page |
否 | 結果頁碼（0 起） |
tags |
否 | Safebooru 標籤，下劃線連接，多標籤空格分隔；純中文查詢勿填 |
返回含 previewFolder、targetFolder（相冊路徑）、各圖 path/width/height/hotlinkFriendly 等，以及圖片塊本身。
save_pictures（確認後寫入相冊）¶
| 參數 | 必填 | 說明 |
|---|---|---|
keep |
是 | 要保留的序號（如 "2"、"#5"）或文件名 |
discard |
否 | 不要的圖片，從預覽區刪除 |
previewFolder / sourceFolder |
否 | 預覽區或下載根；默認用配置與當前批次 |
README 明確：只有用戶明確表示滿意之後才應調用 save_pictures。
安裝與啓用¶
推薦從 Releases 安裝 tarball（latest 直鏈始終指向最新版）。在 DSH 中使用插件管理器（GUI Plugins 頁或 Creator 模式下的 plugin_manager）：
plugin_manager action: install_bundle target: https://github.com/tuanzi0v0/dsh-search-picture/releases/latest/download/dsh-search-picture-0.4.9.tgz
也可指向倉庫（需本機可 git ls-remote 可達）：
plugin_manager action: install_bundle target: https://github.com/tuanzi0v0/dsh-search-picture
安裝後重啓 DSH 生效。命令行等價示例（開發者本地目錄，profile 以你環境爲準）：
dsh plugin --profile desktop add "$(pwd)"
插件以當前 DSH 進程權限運行；安裝前請自行查看倉庫源碼與 MIT 許可證。
配置¶
在 profile 的 cordis.patch.yml 中按插件 id 覆蓋（patch 會替換整份 config，需改鍵都要寫上）。資料片段示例：
- id: dsh-search-picture
name: dsh-search-picture
config:
directory: downloads # 下載根目錄（預覽區）；相對路徑按會話工作區解析
count: 6 # 每次默認張數
其餘鍵（如 officialSite、relatedSites、watermarkHosts、autoCleanPreview 等）見倉庫 README「配置」一節。
典型用法¶
- 在對話中描述需求，例如：「幫我找幾張某某角色的高清圖，不要明顯水印。」
- 智能體調用
search_picture，你在回覆裏查看縮略圖與說明，必要時讓智能體page翻頁。 - 回覆「保留第 1、3 張」，智能體調用
save_pictures，keep填對應序號。 - 需要畫師同人超大圖時，在合適查詢上補充 Safebooru 的
tags（英文標籤形式），不要對純中文 query 硬填tags。
適用場景與注意¶
- 適合：寫稿配圖、整理參考圖、希望「先看再存」且最終文件進系統相冊而非工作區雜散目錄的場景。
- 邊界：無法通用地識別畫面內水印；官網圖源不保證能命中「指定角色」；B 站搜索有匿名限流，插件內已做退避重試。
- 生態：DSH 社區插件目錄（如 SkillHub）由社區維護，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-search-picture 把聯網找圖做成「預覽 → 確認 → 平鋪入相冊」的固定流程，並集中處理了多引擎合併、清晰度門檻與寫入工作區外的授權問題。目錄與安裝包：
