PhotoCHAT CLI 搜索

使用 PhotoCHAT 的自然语言搜索 CLI，检索用户的照片图库。

命令

photochat search [options] <自然语言查询>

使用 MSIX 打包的 photochat 应用程序执行别名（v0.6.0+）。

选项

工作流程

1. 运行搜索命令，同时指定 --json、--day-first 和合理的 --limit 值：

photochat search --json --day-first --limit 10 show me a photo of sarah at the beach

2. 解析 JSON 输出：

{
  "query": "原始查询文本",
  "intent": {
    "cleaned_query": "处理后的查询",
    "face_filters": ["sarah"],
    "date_range": null,
    "exclude_terms": []
  },
  "total_results": 25,
  "returned_results": 5,
  "results": [
    { "rank": 1, "path": "I:/Pictures/.../photo.JPG", "score": 0.55 }
  ]
}

3. 呈现结果：
   • 显示文件路径及匹配数量（返回数 vs 总数）
   • 如需展示某张照片，请将结果中的 path 传给 image 工具
   • 分数高于 0.4 表示匹配质量尚可；高于 0.5 表示强匹配
   • 若返回零结果，建议简化查询，或使用 --show-filters 检查过滤器是否误排除了目标内容

查询能力

解析器支持丰富的自然语言表达：

• 人脸：例如“Sarah 在海滩上”，将自动应用人脸档案 “Sarah” 进行过滤
• 日期：例如“从 2021 年起”、“在三月”、“早于 2015 年”、“自 3 月 21 日起”
• 排除项：例如“不含 Matt”，将排除含 Matt 的人脸或相关语义概念
• 氛围/风格：例如“看起来温馨温暖的照片”、“复古胶片风格”
• 组合条件：例如“Bella 站在一座高楼旁，拍摄于 3 月 21 日”

更多示例请参阅 references/search-examples.txt。

重要说明

• 始终使用 --day-first（适配澳大利亚日期格式 DD/MM）
• 始终使用 --json 获取可解析的结构化输出
• 默认 --limit 5，除非用户明确要求更多结果
• 首次搜索耗时约 10–30 秒（模型加载阶段）；首次调用建议设置 60 秒超时
• 返回的结果路径为绝对文件路径，可直接传递给 image 工具

退出码