PhotoCHAT Photo Search_内容创作 skill-PHP中文网

PhotoCHAT Photo Search

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

通过CLI使用自然语言在PhotoCHAT中搜索照片。当用户请求使用PhotoCHAT查找、搜索或定位照片/图片/图像时使用。

PhotoCHAT CLI 搜索

功能概述

PhotoCHAT CLI 搜索是一项面向实际任务的技能，主要用于使用 PhotoCHAT 的自然语言搜索 CLI.；Command. 使用 MSIX 包式光聊天应用执行别名( v0. 6. 0+). . options. 6.；

核心要点

Flag.；
Purpose.；
Defa.。

使用与执行

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

结果检查与注意事项

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

PhotoCHAT CLI 搜索

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

命令

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

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

选项

标志	用途	默认值
`--json`	输出机器可读的 JSON 格式结果	关闭
`--limit N`	最大返回结果数	5
`--show-filters`	打印已解析的人脸/日期/排除项过滤器	关闭
`--show-scores`	在纯文本输出中包含相似度分数	关闭
`--profile NAME`	强制包含指定的人脸档案	无
`--day-first`	将含糊的日期解析为 DD/MM 格式	关闭
`--dry-run`	仅解析查询，跳过实际检索	关闭

工作流程

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

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

解析 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 }
  ]
}

呈现结果：
- 显示文件路径及匹配数量（返回数 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 工具

退出码

代码	含义
0	成功（包括零结果的搜索）
2	参数或用法错误
3	运行时错误 / 模型初始化失败
4	存储初始化或访问失败
5	未预期的异常失败