文件搜索

工具名：search_files

按文件名模式搜索本地文件系统，支持通配符。适合在文件夹里翻 PSD、Blend 等工程文件，或批量列出某个类型的素材。

适用场景

• 项目文件夹里翻不到某个 PSD 或 Blend 文件
• 需要批量整理某个类型的素材
• 整理归档时列出特定文件夹下的所有图片

使用方式

通过 Agent 对话

• "在我文档里找所有 PSD 文件"
• "列出参考文件夹下的全部图片"
• "翻一下文件名带 backup 的文件"

Agent 会把你的描述转成通配符模式去搜索。默认从「文档」目录（~/Documents）开始，你也可以让它搜索个人目录下的其他位置。

常用搜索模式

结果怎么看

匹配结果以列表形式返回，只包含文件、不含文件夹。每条结果显示相对路径和文件大小。默认一次返回 10 条，最多 50 条；结果较多时会分页，Agent 可以继续翻下一页。

限制与注意事项

搜索范围被限制在你的个人主目录（~）之内，目录之外的路径会被安全拦截。这意味着：

• 无法访问 Windows 系统目录
• 无法访问 Nephele 安装目录
• 无法访问其他用户的个人目录
• 主目录以外的盘符位置（例如直接搜 D 盘）也在范围之外