sophhub 0.2.1 → 0.2.3

package/skills/feishu-notes-assistant-universal/src/scripts/openclaw_notes_crud_test.py

@@ -0,0 +1,181 @@
+import json
+import stat
+import subprocess
+import sys
+import tempfile
+import textwrap
+import unittest
+from pathlib import Path
+
+
+SCRIPT = Path(__file__).resolve().parent / "openclaw_notes_crud.py"
+
+
+def write_fake_cli(path: Path) -> None:
+    body = """#!/usr/bin/env python3
+import json
+import sys
+
+args = sys.argv[1:]
+
+def out(obj):
+    print(json.dumps(obj, ensure_ascii=False))
+
+if args[:2] == ["docs", "+create"]:
+    out({"ok": True, "data": {"doc_id": "dox_new", "doc_url": "https://feishu.example/docx/dox_new"}})
+elif args[:2] == ["docs", "+fetch"]:
+    out({"ok": True, "data": {"doc_id": "dox_read", "doc_url": "https://feishu.example/docx/dox_read", "markdown": "# read"}})
+elif args[:2] == ["docs", "+update"]:
+    out({"ok": True, "data": {"doc_id": "dox_update", "doc_url": "https://feishu.example/docx/dox_update", "args": args}})
+elif args[:2] == ["docs", "+search"]:
+    out({"ok": True, "data": {"items": [{"title": "note-1", "obj_token": "dox_1"}], "has_more": False}})
+elif args[:2] == ["docs", "+media-insert"]:
+    out({"ok": True, "data": {"document_id": "dox_media", "file_token": "file_x", "args": args}})
+elif args[:2] == ["docs", "+media-download"]:
+    out({"ok": True, "data": {"saved_path": "/tmp/downloaded.png", "content_type": "image/png", "args": args}})
+elif args[:2] == ["drive", "+add-comment"]:
+    out({"ok": True, "data": {"comment_id": "cmt_1", "args": args}})
+elif args[:2] == ["api", "DELETE"]:
+    out({"code": 0, "msg": "success", "data": {"deleted": True}})
+else:
+    sys.stderr.write("unexpected args: " + " ".join(args) + "\\n")
+    sys.exit(2)
+"""
+    path.write_text(textwrap.dedent(body), encoding="utf-8")
+    path.chmod(path.stat().st_mode | stat.S_IEXEC)
+
+
+class OpenClawNotesCrudTest(unittest.TestCase):
+    def run_cmd(self, args: list[str]) -> dict:
+        with tempfile.TemporaryDirectory() as tmpdir:
+            fake_cli = Path(tmpdir) / "fake_cli.py"
+            write_fake_cli(fake_cli)
+            cmd = [
+                sys.executable,
+                str(SCRIPT),
+                "--lark-cli-bin",
+                str(fake_cli),
+            ] + args
+            proc = subprocess.run(cmd, capture_output=True, text=True)
+            self.assertEqual(proc.returncode, 0, proc.stderr)
+            return json.loads(proc.stdout)
+
+    def test_create(self):
+        out = self.run_cmd(
+            ["--op", "create", "--title", "t", "--markdown", "# hello"]
+        )
+        self.assertTrue(out["ok"])
+        self.assertEqual(out["op"], "create")
+        self.assertEqual(out["data"]["doc_id"], "dox_new")
+
+    def test_read_update_search(self):
+        read_out = self.run_cmd(["--op", "read", "--doc", "dox_read"])
+        self.assertTrue(read_out["ok"])
+        self.assertEqual(read_out["data"]["doc_id"], "dox_read")
+
+        update_out = self.run_cmd(
+            [
+                "--op",
+                "update",
+                "--doc",
+                "dox_update",
+                "--mode",
+                "append",
+                "--markdown",
+                "new content",
+            ]
+        )
+        self.assertTrue(update_out["ok"])
+        self.assertEqual(update_out["data"]["doc_id"], "dox_update")
+
+        search_out = self.run_cmd(["--op", "search", "--query", "note"])
+        self.assertTrue(search_out["ok"])
+        self.assertEqual(search_out["data"]["items"][0]["obj_token"], "dox_1")
+
+    def test_media_comment_and_section_update(self):
+        media_insert_out = self.run_cmd(
+            [
+                "--op",
+                "media-insert",
+                "--doc",
+                "dox_doc",
+                "--file",
+                "/tmp/test.png",
+                "--media-type",
+                "image",
+                "--caption",
+                "demo",
+            ]
+        )
+        self.assertTrue(media_insert_out["ok"])
+        self.assertEqual(media_insert_out["data"]["file_token"], "file_x")
+
+        media_download_out = self.run_cmd(
+            [
+                "--op",
+                "media-download",
+                "--token",
+                "file_x",
+                "--output",
+                "/tmp/downloaded",
+                "--overwrite",
+            ]
+        )
+        self.assertTrue(media_download_out["ok"])
+        self.assertEqual(media_download_out["data"]["saved_path"], "/tmp/downloaded.png")
+
+        comment_out = self.run_cmd(
+            [
+                "--op",
+                "comment",
+                "--doc",
+                "dox_doc",
+                "--comment",
+                "请补充这段说明",
+                "--selection-with-ellipsis",
+                "旧内容...结束",
+            ]
+        )
+        self.assertTrue(comment_out["ok"])
+        args = comment_out["data"]["args"]
+        content = args[args.index("--content") + 1]
+        self.assertEqual(json.loads(content)[0]["text"], "请补充这段说明")
+
+        section_out = self.run_cmd(
+            [
+                "--op",
+                "section-update",
+                "--doc",
+                "dox_doc",
+                "--section-title",
+                "## 计划",
+                "--section-mode",
+                "replace",
+                "--markdown",
+                "新的章节内容",
+            ]
+        )
+        self.assertTrue(section_out["ok"])
+        section_args = section_out["data"]["args"]
+        self.assertIn("replace_range", section_args)
+        self.assertIn("## 计划", section_args)
+        markdown = section_args[section_args.index("--markdown") + 1]
+        self.assertTrue(markdown.startswith("## 计划\n\n"))
+
+    def test_delete(self):
+        out = self.run_cmd(
+            ["--op", "delete", "--doc", "https://x.feishu.cn/docx/dox_delete123"]
+        )
+        self.assertTrue(out["ok"])
+        self.assertEqual(out["data"]["deleted_doc_token"], "dox_delete123")
+
+    def test_delete_invalid_url(self):
+        out = self.run_cmd(
+            ["--op", "delete", "--doc", "https://x.feishu.cn/wiki/wiki_token"]
+        )
+        self.assertFalse(out["ok"])
+        self.assertEqual(out["error"]["code"], "validation")
+
+
+if __name__ == "__main__":
+    unittest.main()

package/skills/feishu-notes-assistant-universal/src/scripts/run_meeting_minutes.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+"""Cross-platform entrypoint for meeting minutes flow."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import subprocess
+import sys
+from pathlib import Path
+from urllib.parse import urlparse
+
+from _resolve_lark_cli import resolve_bundled_cli
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(
+        description="Run meeting-minutes flow from Feishu minutes URL or token."
+    )
+    parser.add_argument("minutes_url_or_token", help="minutes URL or minute_token")
+    parser.add_argument(
+        "--output-dir",
+        default=str(Path.home() / ".openclaw" / "workspace" / ".meeting-minutes"),
+        help="artifact output dir",
+    )
+    parser.add_argument("--job-id", help="optional custom job id")
+    return parser.parse_args()
+
+
+def extract_token(raw: str) -> str:
+    if raw.startswith("http://") or raw.startswith("https://"):
+        parsed = urlparse(raw)
+        token = parsed.path.rstrip("/").split("/")[-1]
+        return token
+    return raw.strip()
+
+
+def main() -> int:
+    args = parse_args()
+    token = extract_token(args.minutes_url_or_token)
+    if not token:
+        print(
+            json.dumps(
+                {"status": "failed", "error_message": "missing minute_token"},
+                ensure_ascii=False,
+            )
+        )
+        return 1
+
+    script_dir = Path(__file__).resolve().parent
+    base_dir = script_dir.parent
+    cli_bin = resolve_bundled_cli(base_dir)
+    runner = script_dir / "openclaw_meeting_minutes.py"
+    job_id = args.job_id or f"meeting-minutes-{token}"
+
+    proc = subprocess.run(
+        [
+            sys.executable,
+            str(runner),
+            "--lark-cli-bin",
+            str(cli_bin),
+            "--minute-token",
+            token,
+            "--job-id",
+            job_id,
+            "--output-dir",
+            args.output_dir,
+        ],
+        capture_output=True,
+        text=True,
+    )
+    if proc.stdout:
+        sys.stdout.write(proc.stdout)
+    if proc.stderr:
+        sys.stderr.write(proc.stderr)
+    return proc.returncode
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/skills/feishu-notes-assistant-universal/src/scripts/run_meeting_minutes.sh

@@ -0,0 +1,5 @@
+#!/bin/sh
+set -eu
+
+SCRIPT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"
+exec python3 "$SCRIPT_DIR/run_meeting_minutes.py" "$@"

package/skills/feishu-notes-assistant-universal/src/scripts/run_note_crud.py

@@ -0,0 +1,32 @@
+#!/usr/bin/env python3
+"""Cross-platform entrypoint for note CRUD flow."""
+
+from __future__ import annotations
+
+import subprocess
+import sys
+from pathlib import Path
+
+from _resolve_lark_cli import resolve_bundled_cli
+
+
+def main() -> int:
+    script_dir = Path(__file__).resolve().parent
+    base_dir = script_dir.parent
+    cli_bin = resolve_bundled_cli(base_dir)
+    runner = script_dir / "openclaw_notes_crud.py"
+
+    proc = subprocess.run(
+        [sys.executable, str(runner), "--lark-cli-bin", str(cli_bin), *sys.argv[1:]],
+        capture_output=True,
+        text=True,
+    )
+    if proc.stdout:
+        sys.stdout.write(proc.stdout)
+    if proc.stderr:
+        sys.stderr.write(proc.stderr)
+    return proc.returncode
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/skills/feishu-notes-assistant-universal/src/scripts/run_note_crud.sh

@@ -0,0 +1,5 @@
+#!/bin/sh
+set -eu
+
+SCRIPT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"
+exec python3 "$SCRIPT_DIR/run_note_crud.py" "$@"

package/skills/flight-booking/skill.json

@@ -1,12 +1,19 @@
 {
   "name": "flight-booking",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "types": [
     "builtin"
   ],
   "displayName": "国内机票预定",
   "description": "",
   "changelog": [
+    {
+      "changes": [
+        "修正票务网关基址为 https://www.sophnet.com/api，避免请求落到 /v1/api 导致 405 或非 JSON 响应"
+      ],
+      "date": "2026-04-16",
+      "version": "1.1.1"
+    },
     {
       "changes": [
         "初次提交"
@@ -16,5 +23,5 @@
     }
   ],
   "createdAt": "2026-04-09",
-  "updatedAt": "2026-04-09"
+  "updatedAt": "2026-04-16"
 }

package/skills/flight-booking/src/scripts/flight_booking.py

@@ -14,7 +14,7 @@ import requests
 
 # API 配置（新版网关，Bearer API_KEY 鉴权）
 
-GATEWAY_BASE_URL = "https://www.sophnet.com/v1/api"
+GATEWAY_BASE_URL = "https://www.sophnet.com/api"
 
 TICKET_BASE = f"{GATEWAY_BASE_URL}/open-apis/ticket"
 def _resolve_api_key() -> str:
@@ -33,6 +33,7 @@ def _resolve_api_key() -> str:
     raise RuntimeError("未找到 SOPH_API_KEY：请设置环境变量 SOPH_API_KEY ")
 
 API_KEY = _resolve_api_key()
+
 # 乘机人信息从环境变量读取（用户需提前设置）
 ENV_PASSENGER_NAME = "PASSENGER_NAME"
 ENV_PASSENGER_MOBILE = "PASSENGER_MOBILE"

package/skills/image-classify/skill.json

@@ -8,11 +8,11 @@
   "description": "通过人脸识别对照片进行分类、搜索和管理",
   "changelog": [
     {
+      "version": "1.0.3",
+      "date": "2026-04-15",
       "changes": [
-        "脚本内 pathlib 全部改为 os.path（递归列举图片、复制与打包等路径处理）；list_images_pathlib 重命名为 list_images_recursive"
-      ],
-      "date": "2026-04-10",
-      "version": "1.0.3"
+        "照片分类器添加对自动发送虾友的支持"
+      ]
     },
     {
       "changes": [
@@ -38,5 +38,5 @@
     }
   ],
   "createdAt": "2026-04-10",
-  "updatedAt": "2026-04-10"
+  "updatedAt": "2026-04-15"
 }

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

@@ -5,24 +5,25 @@ description: 照片分类器。通过人脸识别对照片进行分类、搜索
 
 # 📸 照片分类器
 
-基于人脸 embedding 相似度的照片分类系统。支持注册用户人脸、按用户搜索照片、一键全量分类、删除用户；搜索/分类结束后**先自动生成下载链接**，再**询问是否复制到指定文件夹**。
+基于人脸 embedding 相似度的照片分类系统。支持注册用户人脸、按用户搜索照片、一键全量分类、删除用户；搜索/分类结束后**生成下载链接**（`pack`）即完成结果导出。
 
 ## Processing Mode
 
 **STRICT SERIAL PROCESSING ONLY** — 单次顺序执行，不拆分子任务、不并行。
 
-**子会话（耗时任务）**：`search`、`quick-search`、`classify` 在**独立子会话**中执行。**子命令结束（成功或失败）后，须立即关闭并删除该子会话**，不得保留空壳会话。后续步骤——向用户展示结果表格、执行 `pack`、询问是否 `copy`——一律在**当前主会话**中完成。
+**子会话（耗时任务）**：`search`、`quick-search`、`classify` 在**独立子会话**中执行。**子命令结束（成功或失败）后，须立即关闭并删除该子会话**，不得保留空壳会话。后续步骤——向用户展示结果表格、执行 `pack`——一律在**当前主会话**中完成。
 
 ## Prerequisites
 
 - Python 3.10+、uv
 - 依赖：`requests`, `opencv-python`, `numpy`, `sophnet_tools`（项目内置）
 - 配置文件：`{baseDir}/references/config.json`
+- 若使用 **DM 自动推送**（注册时 `--friend-id`、一键 `classify` 后推送结果），需本机存在有效 JWT：`/home/node/.openclaw/jwt.json`（与 `send_dm_message.py` 一致）
 
 ## 核心概念
 
 - **`{baseDir}`**：本 skill 根目录，即 `skills/image-classify`，调用时替换为实际绝对路径。
-- **配置文件**：`{baseDir}/references/config.json`，存储所有注册用户的名称、照片路径及人脸 embedding 向量。
+- **配置文件**：`{baseDir}/references/config.json`，存储所有注册用户的名称、照片路径、人脸 embedding 向量，以及可选 **DM 绑定**：`friendId`（好友 userId）、`friendLabel`（可选展示名）。旧字段 `xia_you_hao` / `xia_you_label` 仍可被脚本读取。
 - **脚本入口**：`{baseDir}/scripts/face_search.py`，通过 `uv run` 以子命令方式调用。
 - **所有命令输出均为 JSON 格式**，方便解析结果。
 
@@ -39,7 +40,7 @@ uv run {baseDir}/scripts/face_search.py [-c CONFIG_PATH] <command> [args...]
 | 命令 | 用途 | 示例 |
 |------|------|------|
 | `check <name>` | 检查用户名是否已注册 | `check 张三` |
-| `add <name> <image>` | 注册新用户 | `add 张三 /path/photo.jpg` |
+| `add <name> <image> [--friend-id ID] [--friend-label 名]` | 注册新用户；可选 `friendId` 与 `friendLabel`（括号内提示用） | `add 张三 /path/photo.jpg --friend-label 小李 --friend-id 23725` |
 | `replace <name> <image>` | 替换用户照片（删除旧照片） | `replace 张三 /path/new.jpg` |
 | `append <name> <image>` | 为已有用户追加一张照片 | `append 张三 /path/extra.jpg` |
 | `rename <old> <new>` | 修改用户名 | `rename 张三 李三` |
@@ -47,7 +48,7 @@ uv run {baseDir}/scripts/face_search.py [-c CONFIG_PATH] <command> [args...]
 | `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 张三` |
+| `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` |
@@ -95,19 +96,23 @@ uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json list
 
 **流程**：
 
-1. 获取用户提供的**用户名**和**照片路径**
+1. 获取用户提供的**用户名**、**照片路径**，以及是否绑定 **DM 接收方**（均可选）。用户常以自然语言写出类似：**虾友：xxx，ID:23725**（虾友即 DM 对象；**23725** 即 `friendId`）。解析规则：**xxx** → `--friend-label`；**23725** → `--friend-id`（正整数，与 `send_dm_message.py` 的 `--user-id` / 接口 `userId` 一致）。可只填 `friendId`、不填展示名。
 2. 检查用户名是否已存在：
 ```bash
 uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json check "张三"
 ```
 输出：`{"exists": true/false, "name": "张三"}`
 
-3. **如果不存在** → 注册新用户：
+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)`
+若用户提供了 `friendId`，追加 `--friend-id <正整数>`；若有展示名，追加 `--friend-label "xxx"`（注意转义或引号，避免 shell 拆词）：
+```bash
+uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json add "张三" "/path/to/photo.jpg" --friend-label "小李" --friend-id 23725
+```
+输出：`{"success": true/false, "message": "...", "name": "张三", "image_url": "https://...", "friendId": 23725, "friendLabel": "小李"}`（`friendId` / `friendLabel` 仅在实际传入时出现）
+   - `success: true` → 提示：`🎉✨ **注册成功** · xxx`，并使用返回的 `image_url` 展示照片：`![image](image_url)`；若返回含 `friendId` / `friendLabel`，可顺带一句已绑定 DM（不必冗长）
    - `success: false` → 提示：`❌🙈 照片中未发现有效的人脸信息，注册失败！`
 
 4. **如果已存在** → 提示用户选择操作：
@@ -162,7 +167,7 @@ uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json sear
    | 🖼️ 照片路径 | 📊 相似度 |
    |:----:|:----:|
    | /path/to/photo.jpg | 0.85 |
-5. 展示结果后按「结果导出」流程处理：先 `pack` 生成下载链接，再询问是否复制到文件夹（见 §6）
+5. 展示结果后按「结果导出」执行 `pack` 生成下载链接（见 §6）；`pack` 返回后若含 `dm_lines`（向虾友推送**下载链接**的状态），须在链接展示之后**再**逐行展示（可与搜索结果本身区分开）。
 
 ### 3. 直接搜索（不注册）
 
@@ -189,7 +194,7 @@ uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json quic
    | 🖼️ 照片路径 | 📊 相似度 |
    |:----:|:----:|
    | /path/to/photo.jpg | 0.85 |
-4. 展示结果后按「结果导出」流程处理：先 `pack` 生成下载链接，再询问是否复制到文件夹（见 §6）
+4. 展示结果后按「结果导出」执行 `pack` 生成下载链接（见 §6）；`pack` 返回后若含 `dm_lines`，须在链接展示之后**再**逐行展示。
 
 ### 4. 一键分类
 
@@ -203,10 +208,20 @@ uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json quic
 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": 2,
+  "users": {"张三": {"count": 3, "results": [...]}, "李四": {"count": 1, "results": [...]}},
+  "dm": {"张三": {"success": true, "friendId": 23725, "friendLabel": "小李"}},
+  "dm_lines": ["✅ 💌 已向虾友「小李」发送成功", "📭 「李四」暂未绑定虾友，跳过私信"]
+}
 ```
+   - `dm`：仅当配置里**至少有一位用户**登记了 `friendId` 时出现；脚本在分类结束后**自动调用** `{baseDir}/scripts/send_dm_message.py`（`--user-id` = `friendId`），将**该用户本轮分类结果摘要**发出。失败时含 `"success": false` 与 `detail`。
+   - `dm_lines`：**只要本轮参与分类的用户数 ≥1 即出现**（与是否有人绑定 `friendId` 无关）。为**最终提示专用**短句数组，顺序与本轮 `users` 中用户顺序一致。句式固定：
+     - 已绑定且发送成功：`✅ 💌 已向虾友「xxx」发送成功` — **xxx** 优先为配置中的 `friendLabel`，否则为 `friendId` 数字字符串。
+     - 已绑定且发送失败：`❌ 💢 虾友「xxx」发送失败：<原因>`（原因取自 `dm` 中对应用户的 `detail`）。
+     - 未绑定 `friendId`：`📭 「<本地用户名>」暂未绑定虾友，跳过私信`。
    - `user_count: 0` → 提示：`❌👥 **暂无注册用户** · 请先注册人脸后再分类`
 3. 将结果通知到当前会话，对每个用户分别展示：
    ```
@@ -225,7 +240,14 @@ uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json clas
    ```
    👤💤 **王五** · 本轮暂无匹配
    ```
-4. 展示结果后按「结果导出」流程处理：先 `pack` 生成下载链接，再询问是否复制到文件夹（见 §6）
+4. **分类摘要 DM（必须在表格之后、`pack` 之前展示）**：若 `classify` 的 JSON 含 `dm_lines`（本轮**分类结果摘要**的私信状态），在分类表格**之后**单独加一块，**逐行原样**展示。示例：
+   ```
+   📬 **虾友发送状态（分类摘要）**
+   ✅ 💌 已向虾友「小李」发送成功
+   📭 「李四」暂未绑定虾友，跳过私信
+   ```
+   无 `dm_lines` 时（仅 `user_count: 0` 等异常）跳过本块。
+5. 展示结果后按「结果导出」执行 `pack` 生成下载链接（见 §6）。**`pack` 成功后还会自动向对应 `friendId` 私信「打包下载链接」**；若 `pack` 的 JSON 另含 `dm_lines`（**下载链接**的私信状态），须在下载链接展示之后**再**逐行展示，可与上一步标题区分，例如「下载链接私信状态」。
 
 ### 5. 删除用户
 
@@ -245,74 +267,48 @@ uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json clas
 
 ### 6. 结果导出（搜索/分类完成后）
 
-搜索或分类完成后，结果已保存在 `config.json` 中。展示匹配结果表格后，**不要先弹出菜单**，按下面顺序执行。
-
-#### 第一步：直接生成下载链接
+搜索或分类完成后，结果已保存在 `config.json` 中。展示匹配结果表格（分类场景下若已有「分类摘要」`dm_lines`，须先展示完毕）后，**不要先弹出与导出无关的菜单**，直接执行 **`pack`** 生成下载链接（压缩包可能较大，超时默认 120 秒）。
 
-立即执行 `pack`（压缩包可能较大，超时默认 120 秒），将返回的链接展示给用户：
+**`pack` 成功后，脚本会自动调用** `{baseDir}/scripts/send_dm_message.py`，向**已绑定 `friendId` 的注册用户**私信发送**对应用户的打包下载链接**；正文模板为：先提示「「用户名」的照片已为您送达」，再附 URL，并提醒 **24 小时内下载**、逾期链接可能失效。无 `friendId` 的用户条目会体现在返回的 `dm_lines` 里（`📭 「xxx」暂未绑定虾友，跳过私信`）。**仅 `quick-search` 结果、无注册用户名时**，无法绑定虾友，不会发链接私信。
 
 - **单用户 `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>`
+输出（节选）：`{"success": true, "url": "https://...", "zip_path": "/tmp/.../search_results.zip", "dm": {...}, "dm_lines": [...]}`（有 `friendId` 时含 `dm` / `dm_lines`）  
+成功提示：`📦🔗 **下载链接已就绪** ✨` → `<url>` → 若有 `dm_lines`，再展示「下载链接私信状态」块。
 
 - **`quick-search`（直接搜索）**：结果存于 `quick_search_result`，执行 **不带 `--name`** 的 `pack`（与仅含直接搜索结果时一致）：
 ```bash
 uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json pack --timeout 120
 ```
-成功提示：`📦🔗 **下载链接已就绪** ✨` → `<url>`
+成功提示：`📦🔗 **下载链接已就绪** ✨` → `<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}
+{
+  "success": true,
+  "user_urls": {"张三": "https://...", "李四": "https://..."},
+  "errors": null,
+  "dm": {"张三": {"success": true, "friendId": 23725, "friendLabel": "小李", "url": "https://..."}},
+  "dm_lines": ["✅ 💌 已向虾友「小李」发送成功", "📭 「李四」暂未绑定虾友，跳过私信"]
+}
 ```
-成功提示：逐用户展示链接，例如：
+成功提示：先逐用户展示链接，例如：
 ```
 📦✨ **各用户独立下载包**
 ───────────────────────
 👤 张三 📎 <url>
 👤 李四 📎 <url>
 ```
-部分失败：列出已成功链接，并对失败用户提示：`⚠️❌ **<用户名>** · 下载包生成失败：<原因>`。全部失败：`❌📦 下载链接全部失败`（仍进入第二步询问复制，便于用户落盘）。
+再展示 `dm_lines`（下载链接私信状态）。  
+部分失败：列出已成功链接，并对失败用户提示：`⚠️❌ **<用户名>** · 下载包生成失败：<原因>`；`dm_lines` 中亦会有对应失败说明。全部失败：`❌📦 下载链接全部失败`。
 
-#### 第二步：再询问是否复制到指定文件夹
-
-下载链接处理完毕后，询问用户：
-
-```
-💾📂 **要不要把匹配照片复制到本地？**
-  ✅ 需要 → 💬 请发目标文件夹路径
-  👋 不用了 → 到这里结束 ✨
-```
-
-用户选择**需要**时，再问 `📂✏️ 请输入目标文件夹路径：` 并执行：
-
-- **单用户 `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`。
+`pack` 完成后，**结果导出即结束**。若用户另行要求把文件复制到本地目录，可再使用命令表中的 `copy`（非本 skill 默认流程）。
 
 ### 7. 上传图片到待搜索目录
 
@@ -339,25 +335,21 @@ uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json uplo
 - 用户：「用照片分类器在 /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）
+  3. 展示结果表格 → `pack --name "张三" --timeout 120` 生成下载链接（见 §6）→ 若有 `dm_lines`，展示下载链接私信状态
 
 - 用户：「用这张照片在 /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`；失败 → 提示未检测到有效人脸
+  2. 成功 → 展示表格 → `pack --timeout 120`（不带 `--name`）；失败 → 提示未检测到有效人脸
 
 - 用户：「用照片分类器对 /home/album 进行分类」
   1. 子会话执行 `uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json classify "/home/album"`
-  2. 展示各用户结果 → **直接** `pack --timeout 120`（多用户各一链接）→ 再问是否 `copy`
+  2. 展示各用户结果（及分类摘要 `dm_lines` 若有）→ `pack --timeout 120`（多用户各一链接，见 §6）→ 展示链接及 **`pack` 返回的 `dm_lines`**（下载链接私信状态）
 
 - 用户：「删除照片分类器中李四的信息」
   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> ✨`
@@ -365,11 +357,12 @@ uv run {baseDir}/scripts/face_search.py -c {baseDir}/references/config.json uplo
 ## Notes
 
 - 建议始终通过 `-c` 传入 `{baseDir}/references/config.json` 的绝对路径，避免相对路径导致找不到配置文件。
-- `search`、`quick-search` 和 `classify` 可能耗时较长（取决于搜索目录中的图片数量），应在**子会话**中执行；**结束后立即关闭并删除该子会话**，再将结果与后续 `pack` / `copy` 交互放在**主会话**中完成。
+- `search`、`quick-search` 和 `classify` 可能耗时较长（取决于搜索目录中的图片数量），应在**子会话**中执行；**结束后立即关闭并删除该子会话**，再将结果展示与 `pack` 放在**主会话**中完成。
 - `images/` 目录用于存放待搜索图片；`upload-image` 内部会创建当天目录并串行逐张处理图片。
 - 搜索过程中会在图片所在目录下创建 `.embedding` 隐藏目录缓存 embedding 结果，后续搜索同一目录会自动跳过已处理的图片。
-- `copy` 和 `pack` 命令依赖 `config.json` 中保存的搜索结果（`search_result` 或 `quick_search_result` 字段），必须先执行 `search`、`classify` 或 `quick-search` 后才能使用。
-- 结果导出顺序：**先**执行 `pack` 生成下载链接，**再**询问用户是否需要 `copy`（见 §6）。
+- `pack` 与 `copy` 均依赖 `config.json` 中保存的搜索结果（`search_result` 或 `quick_search_result` 等），须先执行 `search`、`classify` 或 `quick-search`。默认流程只需 **`pack`**；`copy` 为可选，由用户另行提出时再执行。
+- **`classify`** 会向 `friendId` 发**分类结果摘要**；**`pack`** 会向 `friendId` 发**打包下载链接**（两次私信、用途不同）；若只需其一，可后续再改脚本或配置（当前实现为两者都发）。
 - `pack` 的压缩文件存放在系统临时目录中，上传完成后可忽略清理。上传超时默认 120 秒，文件特别大时可通过 `--timeout` 增大。
 - `config.json` 中的 `query_threshold`（默认 0.7）控制人脸检测置信度阈值，`search_similarity_threshold`（默认 0.3）控制搜索匹配的最低相似度。
 - `{baseDir}` 指本 skill 根目录（如 `skills/image-classify`），调用时替换为实际绝对路径。
+- `friendId`（虾友号）与可选 `friendLabel` 写在用户条目下；**注册时**通过 `add ... --friend-id` / `--friend-label` 写入。后续若需修改可编辑 `config.json`（本 skill 未单独提供改绑子命令）。旧键名仍兼容读取。