SuperAPI AI 工具集

cull

设计与创作

查看项目

更新于 10-15 21:53

技能介绍

用途:Cull 是本地 AI 艺术图库应用,用于导入文件夹、浏览、评分/决策、建立收藏集、运行视觉与质量分析、通过嵌入向量查找相似图,以及导出/发布。

主要能力:同一套操作通过四种方式暴露——cull CLI、cull:// URL scheme、GUI 和 MCP 服务器,均为同一 Rust 核心的薄封装。默认使用 CLI + URL scheme,无需 MCP 连接且不受应用重启影响;仅在需要无头接口尚未实现的交互式控制时才用 MCP。

使用方式:二进制位于 /Applications/Cull.app/Contents/MacOS/cull,可先设置 CULL="/Applications/Cull.app/Contents/MacOS/cull"。无子命令时启动 GUI,带子命令则无头运行并退出,写入运行中应用读取的同一图库数据库;加 --json 输出机器可读结果。常用流程:先 $CULL --json import_folder --folder_path "/abs/path/to/batch" 导入,再用 open -a /Applications/Cull.app "cull://open?path=/abs/path/to/batch&view=grid" 在前台展示(view=loupe 为单图详情)。重复导入安全,已导入文件会跳过。已实现的 CLI 子命令包括 import_folder、import_files、list_folders、list_images、list_collections、get_library_stats、list_export_presets、export_images、get_embedding_model_download_info、download_embedding_model、generate_embeddings、analyze_image_quality、get_image_quality、get_quality_count,以及通用入口 call_tool <tool> --params_json '{…}'。URL scheme 动作为即发即忘、无返回值,需要结果时用 CLI(--json)或 MCP。

适用场景:批量审阅与评分、质量分析、相似图检索、导出精选、发布静态包等。

限制:核心规则是展示或审阅图片必须用 Cull,不要用 open 或 Preview 打开图片文件。URL scheme 调用务必带 -a /Applications/Cull.app,否则可能路由到旧副本。MCP 工具名为 mcp__cull__<tool>,在 Claude Code 中为延迟加载,调用前需 ToolSearch "select:mcp__cull__…";Cull 重启会断开 MCP,需用户通过 /mcp 重连。嵌入、分析和大导出为异步任务,需轮询而非假定完成。破坏性操作(delete_collection、prune_audit_log)需明确确认;令牌操作(create_token、rotate_token、revoke_token)属管理权限,非用户明确要求不要触碰。参数不确定时查看 cull <command> --help 或读取 MCP 工具 schema。