用途:这是一个文本到图片的网络搜索技能。通过内置命令行工具,按文本查询检索公开图片,返回图片定位地址和来源页面,用于信息流(Feed)、制品(Artifact)以及视觉参考素材的获取。
主要能力:支持用一句文本查询检索图片,可通过 --max-results 控制返回结果数量,并可通过 --language 指定结果语言。CLI 返回结构化结果,会自动省略不可用的字段;只返回带有 media_url 或 thumbnail_cdn_url 的结果。结果中 media_url 是公开图片地址,存在时优先用作完整图片 URL;thumbnail_cdn_url 是可渲染的 CDN 预览地址,在缺少 media_url 时作为后备,但应把它视为缓存地址,不能当作制品唯一持久的副本。page_url 是来源页面,可用于溯源或署名。media_handle 和 candidate_ref 是内部字段,不可渲染,不能抓取、显示或当作图片 URL 传递。
使用方式:基本命令为 /opt/hatch/bin/image-search "Golden Gate Bridge at sunset" --max-results 5;指定语言时可加 --language fr 等参数。应按请求选择最匹配的结果,不要直接取第一条。该技能只返回定位地址,不下载、不上传,也不会把图片转换为 Muse 媒体引用。对于制品需要持久本地副本的场景,先检查所有结果,优先选用不含 URL 凭据、查询字符串或片段的 HTTPS media_url,并保持结果顺序;然后按浏览器方式预检候选地址,携带跨域 referer 及有界的连接与总超时,逐个抓取,只接受最终状态为 2xx、内容类型和文件魔数均为图片的响应;再复制到制品自有存储。格式上优先 PNG 或 JPEG;WEBP 不应用于 Word 文档,AVIF 不应用于网页;HEIC 一律转为 JPEG。应拒绝防盗链、会过期、重定向、403/404、非图片、带水印或不稳定的 URL。若简单 media_url 均失败,可考虑带查询串的 media_url 或 thumbnail_cdn_url,使用时须逐字节保留原定位地址,不得改写查询字符串。
适用场景:适合为信息流选用合适的远程图片 URL,为需要持久本地副本的制品挑选可安全下载的图片,以及为视觉参考、素材检索提供图片来源与出处。
限制:这是文本到图片搜索,不是反向图片识别,不能用来从用户提供的照片中识别未知人物;不负责下载、上传或媒体引用转换。资料未说明具体收费、结果数量上限、支持的图片格式范围及服务可用性等信息。