sophhub 0.1.4 → 0.2.0

package/README.md

@@ -59,6 +59,34 @@ sophhub download --type builtin -o ./skills
 sophhub download --type store -o ./skills
 ```
 
+### 查看 Skill 详细信息
+
+查看某个 Skill 的完整元数据（版本、类型、描述、changelog 等）：
+
+```bash
+sophhub info flight-booking
+```
+
+输出示例：
+
+```
+  Skill:        flight-booking
+  Version:      1.1.0
+  Types:        builtin
+  Created:      2026-04-09
+  Updated:      2026-04-09
+
+  Changelog:
+    v1.1.0 (2026-04-09)
+      - 初次提交
+```
+
+以 JSON 格式输出完整 `skill.json` 内容：
+
+```bash
+sophhub info aippt --json
+```
+
 ### 查看版本
 
 ```bash
@@ -71,6 +99,7 @@ sophhub --version
 sophhub --help
 sophhub list --help
 sophhub download --help
+sophhub info --help
 ```
 
 ## 配置

package/bin/sophhub.js

@@ -4,6 +4,7 @@ import { createRequire } from 'node:module';
 import { Command } from 'commander';
 import { registerListCommand } from '../src/commands/list.js';
 import { registerDownloadCommand } from '../src/commands/download.js';
+import { registerInfoCommand } from '../src/commands/info.js';
 
 const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
@@ -17,5 +18,6 @@ program
 
 registerListCommand(program);
 registerDownloadCommand(program);
+registerInfoCommand(program);
 
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sophhub",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "SophHub CLI - Manage and download AI Agent skills",
   "type": "module",
   "bin": {

package/skills/aippt/skill.json

@@ -0,0 +1,20 @@
+{
+  "name": "aippt",
+  "version": "1.0.0",
+  "types": [
+    "store"
+  ],
+  "displayName": "AI PPT 生成",
+  "description": "根据主题、文件、网址或大纲自动生成演示文稿",
+  "changelog": [
+    {
+      "version": "1.0.0",
+      "date": "2026-04-09",
+      "changes": [
+        "初次提交"
+      ]
+    }
+  ],
+  "createdAt": "2026-04-09",
+  "updatedAt": "2026-04-09"
+}

package/skills/didi-ride/skill.json

@@ -0,0 +1,20 @@
+{
+  "name": "didi-ride",
+  "version": "1.0.0",
+  "types": [
+    "store"
+  ],
+  "displayName": "滴滴出行",
+  "description": "打车、路线规划、周边搜索、订单查询",
+  "changelog": [
+    {
+      "version": "1.0.0",
+      "date": "2026-04-09",
+      "changes": [
+        "初次提交"
+      ]
+    }
+  ],
+  "createdAt": "2026-04-09",
+  "updatedAt": "2026-04-09"
+}

package/skills/flight-booking/skill.json

@@ -0,0 +1,20 @@
+{
+  "name": "flight-booking",
+  "version": "1.1.0",
+  "types": [
+    "builtin"
+  ],
+  "displayName": "国内机票预定",
+  "description": "",
+  "changelog": [
+    {
+      "changes": [
+        "初次提交"
+      ],
+      "date": "2026-04-09",
+      "version": "1.1.0"
+    }
+  ],
+  "createdAt": "2026-04-09",
+  "updatedAt": "2026-04-09"
+}

package/skills/flyai/skill.json

@@ -0,0 +1,20 @@
+{
+  "name": "flyai",
+  "version": "1.0.10",
+  "types": [
+    "store"
+  ],
+  "displayName": "飞猪旅行",
+  "description": "机票、酒店、景点门票、旅行搜索与预订",
+  "changelog": [
+    {
+      "version": "1.0.10",
+      "date": "2026-04-09",
+      "changes": [
+        "初次提交"
+      ]
+    }
+  ],
+  "createdAt": "2026-04-09",
+  "updatedAt": "2026-04-09"
+}

package/skills/image-classify/skill.json

@@ -0,0 +1,42 @@
+{
+  "name": "image-classify",
+  "version": "1.0.3",
+  "types": [
+    "store"
+  ],
+  "displayName": "照片分类器",
+  "description": "通过人脸识别对照片进行分类、搜索和管理",
+  "changelog": [
+    {
+      "changes": [
+        "脚本内 pathlib 全部改为 os.path（递归列举图片、复制与打包等路径处理）；list_images_pathlib 重命名为 list_images_recursive"
+      ],
+      "date": "2026-04-10",
+      "version": "1.0.3"
+    },
+    {
+      "changes": [
+        "配置文件读写统一使用 UTF-8 编码（open 显式指定 encoding）"
+      ],
+      "date": "2026-04-10",
+      "version": "1.0.2"
+    },
+    {
+      "changes": [
+        "1.添加了上传图片的支持",
+        "2.添加默认的工作路径"
+      ],
+      "date": "2026-04-10",
+      "version": "1.0.1"
+    },
+    {
+      "changes": [
+        "初次提交"
+      ],
+      "date": "2026-04-10",
+      "version": "1.0.0"
+    }
+  ],
+  "createdAt": "2026-04-10",
+  "updatedAt": "2026-04-10"
+}

package/skills/image-classify/src/SKILL.md

@@ -0,0 +1,375 @@
+---
+name: image-classify
+description: 照片分类器。通过人脸识别对照片进行分类、搜索和管理。当用户说「用照片分类器查找/搜索 xxx」「对 xx 文件夹进行分类」「添加 xx 到照片分类器」「从照片分类器删除 xx」时使用。
+---
+
+# 📸 照片分类器
+
+基于人脸 embedding 相似度的照片分类系统。支持注册用户人脸、按用户搜索照片、一键全量分类、删除用户；搜索/分类结束后**先自动生成下载链接**，再**询问是否复制到指定文件夹**。
+
+## Processing Mode
+
+**STRICT SERIAL PROCESSING ONLY** — 单次顺序执行，不拆分子任务、不并行。
+
+**子会话（耗时任务）**：`search`、`quick-search`、`classify` 在**独立子会话**中执行。**子命令结束（成功或失败）后，须立即关闭并删除该子会话**，不得保留空壳会话。后续步骤——向用户展示结果表格、执行 `pack`、询问是否 `copy`——一律在**当前主会话**中完成。
+
+## Prerequisites
+
+- Python 3.10+、uv
+- 依赖：`requests`, `opencv-python`, `numpy`, `sophnet_tools`（项目内置）
+- 配置文件：`{baseDir}/references/config.json`
+
+## 核心概念
+
+- **`{baseDir}`**：本 skill 根目录，即 `skills/image-classify`，调用时替换为实际绝对路径。
+- **配置文件**：`{baseDir}/references/config.json`，存储所有注册用户的名称、照片路径及人脸 embedding 向量。
+- **脚本入口**：`{baseDir}/scripts/face_search.py`，通过 `uv run` 以子命令方式调用。
+- **所有命令输出均为 JSON 格式**，方便解析结果。
+
+## 通用调用格式
+
+```bash
+uv run {baseDir}/scripts/face_search.py [-c CONFIG_PATH] <command> [args...]
+```
+
+`-c` / `--config` 可选，指定配置文件路径，默认为 `references/config.json`（相对于执行目录）。建议始终传入绝对路径 `{baseDir}/references/config.json`。
+
+## 可用命令一览
+
+| 命令 | 用途 | 示例 |
+|------|------|------|
+| `check <name>` | 检查用户名是否已注册 | `check 张三` |
+| `add <name> <image>` | 注册新用户 | `add 张三 /path/photo.jpg` |
+| `replace <name> <image>` | 替换用户照片（删除旧照片） | `replace 张三 /path/new.jpg` |
+| `append <name> <image>` | 为已有用户追加一张照片 | `append 张三 /path/extra.jpg` |
+| `rename <old> <new>` | 修改用户名 | `rename 张三 李三` |
+| `delete <name>` | 删除用户 | `delete 张三` |
+| `search <name> <dir>` | 在目录中搜索某用户的相似人脸 | `search 张三 /home/photos` |
+| `quick-search <image> <dir>` | 直接用照片搜索相似人脸（不注册） | `quick-search /tmp/face.jpg /home/photos` |
+| `classify <dir>` | 一键分类：遍历所有用户搜索全部照片 | `classify /home/photos` |
+| `copy <target> [--name N]` | 将搜索结果复制到文件夹 | `copy /output --name 张三` |
+| `pack [--name N] [--timeout T]` | 压缩结果为 zip 并上传获取下载链接 | `pack --timeout 120` |
+| `upload <file> [--timeout T]` | 上传文件获取 URL | `upload /path/file.zip` |
+| `init-today-folder` | 创建并返回待搜索目录当天子目录 | `init-today-folder` |
+| `upload-image <file...>` | 将一张或多张图片串行剪切到待搜索目录 `images/当天日期(YYYYMMDD)` | `upload-image /tmp/a.jpg /tmp/b.jpg` |
+| `list-date-folders` | 列出待搜索根目录 `images` 下全部 `YYYYMMDD` 子文件夹（新→旧），供未指定目录时选择 | `list-date-folders` |
+
+> ⚠️ 注意：如果用户发送的图片格式为 `![image](xxx.jpg)`，需要先执行 `upload` 命令将其转换为 URL 格式后再处理。
+
+## Usage
+
+根据用户意图匹配以下操作流程：
+
+### 未指定搜索目录时（`search` / `quick-search` / `classify` 共用）
+
+待搜索根目录由脚本内 `get_images_path()` 解析（通常为仓库上级 `images`）。其下按日期命名的子目录（`YYYYMMDD`）为可选搜索范围。
+
+若用户**未说明**搜索目录（或只说「默认目录」「最近上传的」等），**不要猜测路径**，先执行：
+
+```bash
+uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json list-date-folders
+```
+
+输出 JSON 字段说明：
+- `folders`：全部合法日期文件夹，`{ "name": "20260410", "path": "/绝对路径/20260410" }`，已按日期**从新到旧**排序
+- `preview` / `preview_n`：默认只向用户展示**最近 `preview_n` 个（默认 3 个）**即可
+- `total`：总数；若大于 `preview_n`，用户可说「更多」「全部」「列出全部」——此时用 Markdown 列出剩余项（**只展示 `name`**，不罗列每条 `path`），再请用户回复**序号**或**日期名（YYYYMMDD）**；用户若粘贴目录路径则按路径解析
+
+选定目录后，将解析出的**绝对路径**作为 `<dir>` 传入 `search` / `quick-search` / `classify`。
+
+若 `folders` 为空，提示用户在 `images` 下先上传或创建日期目录（可用 `init-today-folder`、`upload-image`），或**手动提供**任意搜索目录路径。
+
+**向用户展示候选目录时（示例模版）** — 用 Markdown 呈现，**只展示日期文件夹名**，不要把磁盘绝对路径列给用户：
+
+- 📅📂 **最近可用的日期文件夹（任选其一）**
+  - 1️⃣ 📁 `20260410`
+
+  - 2️⃣ 📁 `20260409`
+
+  - 3️⃣ 📁 `20260408`
+- 💬 请回复**序号**或**日期名**；需要查看更多请说「更多」。内部调用命令时仍使用 JSON 里的 `path` 字段。✨
+
+### 1. 添加/注册用户
+
+**触发词**：「添加 xxx 到照片分类器」「注册 xxx」「把这张照片记为 xxx」
+
+**流程**：
+
+1. 获取用户提供的**用户名**和**照片路径**
+2. 检查用户名是否已存在：
+```bash
+uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json check "张三"
+```
+输出：`{"exists": true/false, "name": "张三"}`
+
+3. **如果不存在** → 注册新用户：
+```bash
+uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json add "张三" "/path/to/photo.jpg"
+```
+输出：`{"success": true/false, "message": "...", "name": "张三", "image_url": "https://..."}`
+   - `success: true` → 提示：`🎉✨ **注册成功** · xxx`，并使用返回的 `image_url` 展示照片：`![image](image_url)`
+   - `success: false` → 提示：`❌🙈 照片中未发现有效的人脸信息，注册失败！`
+
+4. **如果已存在** → 提示用户选择操作：
+   ```
+   ⚡👤 用户名已存在，请选择操作：
+   1️⃣ 🔄 更新照片（替换主照片）
+   2️⃣ ✏️ 重新命名
+   3️⃣ ➕ 同时保留多张照片
+   ```
+   - **更新照片**：
+   ```bash
+   uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json replace "张三" "/path/to/new.jpg"
+   ```
+     输出包含 `image_url` 字段。
+     - 成功：`✅🔄 **照片已更新** · xxx`，使用 `image_url` 展示照片：`![image](image_url)`
+     - 失败：`❌🙈 照片中未发现有效的人脸信息，更新失败！`
+   - **重新命名**：
+   ```bash
+   uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json rename "张三" "李三"
+   ```
+     - 提示：`✏️📛 **用户名已更新** · xxx → yyy`
+   - **保留多张**：
+   ```bash
+   uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json append "张三" "/path/to/extra.jpg"
+   ```
+     输出包含 `image_url` 字段。
+     - 成功：`✅➕ **新照片已追加** · xxx`，使用 `image_url` 展示照片：`![image](image_url)`
+     - 失败：`❌🙈 照片中未发现有效的人脸信息，添加失败！`
+
+### 2. 搜索用户照片
+
+**触发词**：「用照片分类器在 yy 文件夹下查找 xxx」「搜索 xxx 的照片」
+
+**流程**：
+
+1. 从用户表述中提取**用户名**和**搜索目录**。若**未指定搜索目录**，先按上文「未指定搜索目录时」列出最近 3 个日期文件夹供选择（支持「更多」展示全部），得到 `<dir>` 后再继续。
+2. 检查用户名是否存在（`check` 命令），不存在则提示：`❌🔍 **未找到该用户** · 请确认姓名后重试`
+3. 使用**子会话**执行搜索（可能耗时较长）：
+```bash
+uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json search "张三" "<dir>"
+```
+（`<dir>` 为用户指定路径，或从 `list-date-folders` 选中的 `path`。）**命令返回后立刻关闭并删除该子会话。**
+输出：
+```json
+{"name": "张三", "count": 3, "results": [{"image_path": "...", "face_index": 0, "similarity": 0.85}, ...]}
+```
+4. 将结果通知到当前会话，以表格形式展示：
+   ```
+   🔎✨ **人脸搜索结果** · 👤 <用户名>
+   ───────────────────────
+   ```
+   | 🖼️ 照片路径 | 📊 相似度 |
+   |:----:|:----:|
+   | /path/to/photo.jpg | 0.85 |
+5. 展示结果后按「结果导出」流程处理：先 `pack` 生成下载链接，再询问是否复制到文件夹（见 §6）
+
+### 3. 直接搜索（不注册）
+
+**触发词**：「用这张照片搜索 yy 文件夹」「直接用照片查找」「不注册直接搜」
+
+**流程**：
+
+1. 获取用户提供的**照片路径**和**搜索目录**。若**未指定搜索目录**，先按「未指定搜索目录时」列出最近 3 个日期文件夹供选择（支持「更多」），得到 `<dir>` 后再继续。
+2. 使用**子会话**执行搜索（先提取人脸 embedding，再匹配，可能耗时较长）：
+```bash
+uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json quick-search "/path/to/face.jpg" "<dir>"
+```
+**命令返回后立刻关闭并删除该子会话。**
+输出：
+```json
+{"success": true/false, "count": 3, "results": [...], "message": "..."}
+```
+   - `success: false` → 表示照片中未检测到有效人脸，提示：`❌🙈 **未检测到人脸** · 无法搜索`
+3. 将结果通知到当前会话，以表格形式展示：
+   ```
+   🪪🖼️ **直接搜索**（未注册）· 已用查询图匹配
+   ───────────────────────
+   ```
+   | 🖼️ 照片路径 | 📊 相似度 |
+   |:----:|:----:|
+   | /path/to/photo.jpg | 0.85 |
+4. 展示结果后按「结果导出」流程处理：先 `pack` 生成下载链接，再询问是否复制到文件夹（见 §6）
+
+### 4. 一键分类
+
+**触发词**：「用照片分类器对 xx 文件夹进行分类」「一键分类」「对这些照片按人分类」
+
+**流程**：
+
+1. 从用户表述中提取**搜索目录**。若**未指定搜索目录**，先按「未指定搜索目录时」列出最近 3 个日期文件夹供选择（支持「更多」），得到 `<dir>` 后再继续。
+2. 使用**子会话**执行分类（可能耗时较长）：
+```bash
+uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json classify "<dir>"
+```
+**命令返回后立刻关闭并删除该子会话。**
+输出：
+```json
+{"user_count": 2, "users": {"张三": {"count": 3, "results": [...]}, "李四": {"count": 1, "results": [...]}}}
+```
+   - `user_count: 0` → 提示：`❌👥 **暂无注册用户** · 请先注册人脸后再分类`
+3. 将结果通知到当前会话，对每个用户分别展示：
+   ```
+   🗂️✨ **一键分类完成** · 共 👥 N 位注册用户参与匹配
+   ───────────────────────
+   ```
+   对每个有匹配结果的用户：
+   ```
+   👤✅ **张三** · 📸 匹配 M 张
+   ```
+   | 🖼️ 照片路径 | 📊 相似度 |
+   |:----:|:----:|
+   | /path/to/photo.jpg | 0.85 |
+
+   无匹配结果的用户：
+   ```
+   👤💤 **王五** · 本轮暂无匹配
+   ```
+4. 展示结果后按「结果导出」流程处理：先 `pack` 生成下载链接，再询问是否复制到文件夹（见 §6）
+
+### 5. 删除用户
+
+**触发词**：「删除照片分类器中 xxx 的信息」「把 xxx 从照片分类器移除」
+
+**流程**：
+
+1. 从用户表述中提取**用户名**
+2. 检查用户名是否存在（`check` 命令），不存在则提示：`❌🔍 **未找到该用户** · 请确认姓名后重试`
+3. 提示确认：`⚠️🗑️ **确认删除用户 xxx？** · 此操作不可撤销`
+   - 用户确认 →
+   ```bash
+   uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json delete "张三"
+   ```
+   提示：`🗑️✨ **用户已删除** · xxx`
+   - 用户取消 → 提示：`↩️👋 **已取消删除**`
+
+### 6. 结果导出（搜索/分类完成后）
+
+搜索或分类完成后，结果已保存在 `config.json` 中。展示匹配结果表格后，**不要先弹出菜单**，按下面顺序执行。
+
+#### 第一步：直接生成下载链接
+
+立即执行 `pack`（压缩包可能较大，超时默认 120 秒），将返回的链接展示给用户：
+
+- **单用户 `search`**（指定 `--name`）：
+```bash
+uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json pack --name "张三" --timeout 120
+```
+输出：`{"success": true, "url": "https://...", "zip_path": "/tmp/.../search_results.zip"}`  
+成功提示：`📦🔗 **下载链接已就绪** ✨` → `<url>`
+
+- **`quick-search`（直接搜索）**：结果存于 `quick_search_result`，执行 **不带 `--name`** 的 `pack`（与仅含直接搜索结果时一致）：
+```bash
+uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json pack --timeout 120
+```
+成功提示：`📦🔗 **下载链接已就绪** ✨` → `<url>`
+
+- **一键 `classify`**（不指定 `--name`，**每位用户单独打包**）：
+```bash
+uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json pack --timeout 120
+```
+输出示例：
+```json
+{"success": true, "user_urls": {"张三": "https://...", "李四": "https://..."}, "errors": null}
+```
+成功提示：逐用户展示链接，例如：
+```
+📦✨ **各用户独立下载包**
+───────────────────────
+👤 张三 📎 <url>
+👤 李四 📎 <url>
+```
+部分失败：列出已成功链接，并对失败用户提示：`⚠️❌ **<用户名>** · 下载包生成失败：<原因>`。全部失败：`❌📦 下载链接全部失败`（仍进入第二步询问复制，便于用户落盘）。
+
+#### 第二步：再询问是否复制到指定文件夹
+
+下载链接处理完毕后，询问用户：
+
+```
+💾📂 **要不要把匹配照片复制到本地？**
+  ✅ 需要 → 💬 请发目标文件夹路径
+  👋 不用了 → 到这里结束 ✨
+```
+
+用户选择**需要**时，再问 `📂✏️ 请输入目标文件夹路径：` 并执行：
+
+- **单用户 `search`**（注册用户搜索结果）：
+```bash
+uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json copy "/output/folder" --name "张三"
+```
+
+- **`quick-search`**（结果为列表、无注册用户名）：**不带** `--name`：
+```bash
+uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json copy "/output/folder"
+```
+
+- **一键 `classify`**（不指定 `--name`，按用户名自动建子目录）：
+```bash
+uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json copy "/output/folder"
+```
+
+输出：`{"success": true, "copied": 5, "failed": 0, "target": "/output/folder"}`  
+- 成功：`✅📁 **复制完成** · 共 N 张 → /path/to/target/`  
+- 部分失败：`⚠️📋 **复制结束** · 成功 N 张 · 失败 M 张`
+
+用户选择**不需要**则结束，无需再执行 `copy`。
+
+### 7. 上传图片到待搜索目录
+
+**触发词**：「上传这张图片到待搜索目录」「上传这些图片到待搜索目录」「上传这些照片」「把图片放到今天目录供搜索」「把图片移到待搜索目录」
+
+**流程**：
+
+1. 获取用户提供的**图片路径**（支持单张或多张）
+2. 直接执行：
+```bash
+uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json upload-image "/path/to/a.jpg" "/path/to/b.jpg"
+```
+3. 单张时输出：`{"success": true/false, "folder_path": "/abs/path/to/images/YYYYMMDD", "file_path": "/abs/path/to/images/YYYYMMDD/a.jpg", "failed": []}`
+4. 多张时输出：`{"success": true/false, "folder_path": "/abs/path/to/images/YYYYMMDD", "uploaded": [...], "failed": [...]}`
+5. 成功后提示：`✅📤 **已放入待搜索目录** → <folder_path> ✨`；如果有失败文件，提示：`⚠️ 部分失败：` 并列出项。
+
+## Example Workflow
+
+- 用户：「把这张照片添加为张三」
+  1. `uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json check "张三"`
+  2. 不存在 → `uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json add "张三" "/path/to/photo.jpg"`
+  3. 提示：`🎉✨ **注册成功** · 张三`
+
+- 用户：「用照片分类器在 /home/photos 下查找张三」
+  1. `uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json check "张三"` → 存在
+  2. 子会话执行 `uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json search "张三" "/home/photos"`
+  3. 展示结果表格 → **直接** `pack --name "张三" --timeout 120` 生成链接 → 再问是否 `copy`（见 §6）
+
+- 用户：「用这张照片在 /home/photos 里找找有没有类似的」
+  1. 子会话执行 `uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json quick-search "/tmp/face.jpg" "/home/photos"`
+  2. 成功 → 展示表格 → **直接** `pack --timeout 120`（不带 `--name`）→ 再问是否 `copy`；失败 → 提示未检测到有效人脸
+
+- 用户：「用照片分类器对 /home/album 进行分类」
+  1. 子会话执行 `uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json classify "/home/album"`
+  2. 展示各用户结果 → **直接** `pack --timeout 120`（多用户各一链接）→ 再问是否 `copy`
+
+- 用户：「删除照片分类器中李四的信息」
+  1. `uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json check "李四"` → 存在
+  2. 提示确认 → 用户确认 → `uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json delete "李四"`
+  3. 提示：`🗑️✨ **用户已删除** · 李四`
+
+- 用户：在搜索/分类完成后表示「要复制到 /output」（§6 第二步）
+  1. `uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json copy "/output"`（按需加 `--name`，与 §6 一致）
+  2. 提示：`✅📁 **复制完成** · N 张 → /output/`
+
+- 用户：「把这些图片放到待搜索目录」
+  1. `uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json upload-image "/tmp/a.jpg" "/tmp/b.jpg"`
+  2. 全部成功后提示：`✅📤 **已放入待搜索目录** → <folder_path> ✨`
+
+## Notes
+
+- 建议始终通过 `-c` 传入 `{baseDir}/references/config.json` 的绝对路径，避免相对路径导致找不到配置文件。
+- `search`、`quick-search` 和 `classify` 可能耗时较长（取决于搜索目录中的图片数量），应在**子会话**中执行；**结束后立即关闭并删除该子会话**，再将结果与后续 `pack` / `copy` 交互放在**主会话**中完成。
+- `images/` 目录用于存放待搜索图片；`upload-image` 内部会创建当天目录并串行逐张处理图片。
+- 搜索过程中会在图片所在目录下创建 `.embedding` 隐藏目录缓存 embedding 结果，后续搜索同一目录会自动跳过已处理的图片。
+- `copy` 和 `pack` 命令依赖 `config.json` 中保存的搜索结果（`search_result` 或 `quick_search_result` 字段），必须先执行 `search`、`classify` 或 `quick-search` 后才能使用。
+- 结果导出顺序：**先**执行 `pack` 生成下载链接，**再**询问用户是否需要 `copy`（见 §6）。
+- `pack` 的压缩文件存放在系统临时目录中，上传完成后可忽略清理。上传超时默认 120 秒，文件特别大时可通过 `--timeout` 增大。
+- `config.json` 中的 `query_threshold`（默认 0.7）控制人脸检测置信度阈值，`search_similarity_threshold`（默认 0.3）控制搜索匹配的最低相似度。
+- `{baseDir}` 指本 skill 根目录（如 `skills/image-classify`），调用时替换为实际绝对路径。

package/skills/image-classify/src/references/config.json

@@ -0,0 +1,4 @@
+{
+    "query_threshold": 0.7,
+    "search_similarity_threshold": 0.3
+}