前言¶

在 DSH（DeepSeek Harness）里让智能体「上网找图」，常见做法是模型自己拼 URL 或一次性把文件写进工作区。前者容易拿到缩略图、带水印的素材站图，或根本下不下来；后者则缺少「你看过再决定留哪几张」的环节。下面介绍社区插件 dsh-search-picture（维护者 tuanzi0v0）：把搜索、清晰度筛选、预览和写入系统相册拆成两步工具，在用户明确满意之前，相册里不会出现任何文件。

这是什么¶

dsh-search-picture 是 DSH 的联网工具类插件，GitHub 仓库 tuanzi0v0/dsh-search-picture，SkillHub 目录页见 plugins/tuanzi0v0/dsh-search-picture。一句话定位：智能体调工具多图源搜索并下载到预览区，把图片读进上下文供你挑选；你确认序号后，再调用第二个工具把选中项平铺复制到系统 Pictures 下的固定相册目录。

两步工作流¶

工作流是两步的，这一点很重要：

1. 你说「帮我找几张 XX 的图片」，智能体调用 search_picture：并发查询多个免 key 图源，按规则筛选与排序，下载到预览区，并把图片作为附件提交给模型，逐张说明来源与是否建议保留。
2. 你说「第 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 策略下会弹窗确认）。

核心功能（已文档说明部分）¶

工具参数¶

search_picture（搜索到预览区）¶

返回含 previewFolder、targetFolder（相册路径）、各图 path/width/height/hotlinkFriendly 等，以及图片块本身。

save_pictures（确认后写入相册）¶

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「配置」一节。

典型用法¶

1. 在对话中描述需求，例如：「帮我找几张某某角色的高清图，不要明显水印。」
2. 智能体调用 search_picture，你在回复里查看缩略图与说明，必要时让智能体 page 翻页。
3. 回复「保留第 1、3 张」，智能体调用 save_pictures，keep 填对应序号。
4. 需要画师同人超大图时，在合适查询上补充 Safebooru 的 tags（英文标签形式），不要对纯中文 query 硬填 tags。

适用场景与注意¶

• 适合：写稿配图、整理参考图、希望「先看再存」且最终文件进系统相册而非工作区杂散目录的场景。
• 边界：无法通用地识别画面内水印；官网图源不保证能命中「指定角色」；B 站搜索有匿名限流，插件内已做退避重试。
• 生态：DSH 社区插件目录（如 SkillHub）由社区维护，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-search-picture 把联网找图做成「预览 → 确认 → 平铺入相册」的固定流程，并集中处理了多引擎合并、清晰度门槛与写入工作区外的授权问题。目录与安装包：

• SkillHub：https://www.skillhub.cn/plugins/tuanzi0v0/dsh-search-picture
• GitHub：https://github.com/tuanzi0v0/dsh-search-picture