1、重建索引：打开Piti插件设置，点击数据库管理中的重建索引按钮，等待完成扫描与索引生成后测试搜索功能。2、检查关键词匹配规则：避免使用非法符号，尝试简短关键词并启用精确匹配，确认标签正确关联。3、更新插件版本：访问官网下载适配macOS Sonoma的最新版，覆盖安装后重启软件。4、手动导入图片并添加元数据：通过导入功能添加本地图片，填写标题、描述和关键词，选择分类目录后用元数据验证搜索可查性。
如果您在使用Piti插件时发现图片库搜索功能无法返回预期结果，可能是由于索引异常或查询条件不匹配导致。以下是处理该问题的具体流程：
本文运行环境：MacBook Pro，macOS Sonoma
一、重建图片库索引
索引损坏可能导致搜索功能失效，通过重建索引可恢复数据的可检索性。
1、打开Piti插件主界面，进入“设置”选项卡。
2、点击“数据库管理”模块中的“重建索引”按钮。
3、确认操作后等待系统完成扫描与索引生成，此过程可能持续数分钟。
4、完成后尝试重新执行图片搜索，验证是否恢复正常。
二、检查搜索关键词匹配规则
Piti插件默认采用模糊匹配机制，但特殊字符或格式错误会影响查询精度。
1、确保输入的搜索词不含非法符号，如*、?、|等。
2、尝试使用更简短的关键词进行测试，例如仅输入文件名中的核心词汇。
3、勾选“启用精确匹配”选项以排除相似项干扰，查看结果变化。
4、若使用标签搜索，请确认目标图片已正确关联相应标签。
三、更新插件至最新版本
旧版本可能存在搜索逻辑缺陷，升级可修复已知问题并提升稳定性。
1、访问Piti插件官方网站，查找“下载中心”区域。
2、下载适用于macOS Sonoma系统的最新版安装包。
3、关闭宿主应用后运行安装程序，覆盖现有版本。
4、重启软件并登录账户，再次测试图片库搜索功能。
四、手动导入图片并添加元数据
对于未被自动识别的图片，手动导入可确保其纳入搜索范围。
1、点击“导入”按钮，选择需要加入图库的本地图片文件。
2、在导入向导中为每张图片填写标题、描述和关键词。
3、选择合适的分类目录，完成导入流程。
4、使用刚输入的元数据字段作为搜索词，验证图片是否可被查出。
