antenna-fyi 1.3.37 → 1.3.39

package/bin/antenna.js

@@ -8,6 +8,7 @@ import {
   handleCheckin,
   handleMatches,
   handleDiscover,
+  handleFindPeople,
   handleEvent,
   handleBind,
   handlePass,
@@ -40,6 +41,9 @@ async function main() {
       return handleMatches(f);
     case "discover":
       return handleDiscover(f);
+    case "find":
+    case "find-people":
+      return handleFindPeople(f);
     case "event":
       return handleEvent(f);
     case "drift":

package/lib/cli.js

@@ -1,6 +1,6 @@
 // antenna CLI command handlers
 
-import { scan, getProfile, setProfile, accept, checkMatches, checkin, createBindToken, discover, createEvent, endEvent, eventCheckin, joinEvent, eventScan, pass as passUser, uploadEventImage, updateEvent, approveParticipant, rejectParticipant, addCohost, sendEventMessage, getMyEventMessages, getClient, verifyApiKey, linkAccount, initialRecommendations, throwDriftBottle, pickDriftBottle, replyDriftBottle, checkDriftBottles, getMyBottles } from "./core.js";
+import { scan, getProfile, setProfile, accept, checkMatches, checkin, createBindToken, discover, findPeople, createEvent, endEvent, eventCheckin, joinEvent, eventScan, pass as passUser, uploadEventImage, updateEvent, approveParticipant, rejectParticipant, addCohost, sendEventMessage, getMyEventMessages, getClient, verifyApiKey, linkAccount, initialRecommendations, throwDriftBottle, pickDriftBottle, replyDriftBottle, checkDriftBottles, getMyBottles } from "./core.js";
 import { createInterface } from "readline";
 import { existsSync, mkdirSync, copyFileSync, readFileSync, writeFileSync, unlinkSync, renameSync } from "fs";
 import path from "path";
@@ -14,7 +14,7 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
 export function parseFlags(args) {
-  const flags = {};
+  const flags = { _: [] };
   for (let i = 0; i < args.length; i++) {
     if (args[i].startsWith("--")) {
       const key = args[i].slice(2);
@@ -25,6 +25,8 @@ export function parseFlags(args) {
       } else {
         flags[key] = true;
       }
+    } else {
+      flags._.push(args[i]);
     }
   }
   return flags;
@@ -122,7 +124,8 @@ export async function handleAccept(f) {
   if (!id || (!f.target && !f.ref)) return console.error("Usage: antenna accept --id <platform>:<user_id> --ref 1 [--contact 'WeChat: yi']\n       antenna accept --id <platform>:<user_id> --target <ref_or_device_id> [--contact 'WeChat: yi']");
   const result = await accept({
     device_id: id,
-    target_device_id: f.target || null,
+    target_device_id: f.target && f.target.includes(':') ? f.target : null,
+    profile_slug: f.target && !f.target.includes(':') ? f.target : null,
     ref: f.ref || null,
     contact_info: f.contact,
   });
@@ -178,6 +181,25 @@ export async function handleDiscover(f) {
   });
 }
 
+export async function handleFindPeople(f) {
+  const id = resolveId(f);
+  const query = f.query || f.q || f._?.join(" ");
+  if (!id || !query) return console.error("Usage: antenna find --id <platform>:<user_id> --query '想找一个懂 consumer social 增长的人' [--limit 3]");
+  const result = await findPeople({ device_id: id, query, limit: +(f.limit || 3) });
+  if (result.count === 0) return console.log(result.message || "No relevant profiles found.");
+  console.log(`🔎 Intent search: ${result.query}\n`);
+  result.profiles.forEach((p) => {
+    console.log(`  ${p.display_name}`);
+    if (p.personal_description) console.log(`    ${p.personal_description}`);
+    if (p.looking_for) console.log(`    Looking for: ${p.looking_for}`);
+    if (p.conversation_style) console.log(`    Conversation: ${p.conversation_style}`);
+    if (p.interest_tags?.length) console.log(`    Tags: ${p.interest_tags.join(", ")}`);
+    if (p.city) console.log(`    ${p.city}`);
+    if (p.recommendation_reason) console.log(`    → ${p.recommendation_reason}`);
+    console.log(`    ref: ${p.ref}\n`);
+  });
+}
+
 export async function handleEvent(f) {
   f.id = f.id || resolveId(f);
   const sub = f._?.[0] || Object.keys(f).find(k => ["create", "join", "scan", "end", "checkin", "upload-image"].includes(k));
@@ -1084,6 +1106,7 @@ Usage:
   antenna pass       --id <platform>:<user_id> --target <ref_or_device_id> (or --ref 1)
   antenna matches    --id <platform>:<user_id>
   antenna discover   --id <platform>:<user_id>
+  antenna find       --id <platform>:<user_id> --query '想找一个懂 consumer social 增长的人' [--limit 3]
   antenna event      --create --name 'AI Meetup' --starts-at '...' --ends-at '...' [--lat 34.05 --lng -118.25] [--desc '...'] [--og-image 'url'] [--requires-approval] [--screening-questions 'Q1|Q2'] | --join --code abc123 | --scan --code abc123 | --end --code abc123 --id <platform>:<user_id> | --upload-image --code abc123 --file /path/to/image.png | --update --code abc123 --name 'New Name' | --approve --code abc123 --ref 1 | --reject --code abc123 --ref 1 | --add-host --code abc123 --ref 1
   antenna drift      --throw --message 'hello' | --pick | --reply --bottle-id <uuid> --message 'reply' | --check | --my-bottles  --id <platform>:<user_id>
   antenna watch       --id <platform>:<user_id> [--push hermes|openclaw|terminal]  Watch for new matches in real-time (Ctrl+C to stop)

package/lib/core.js

@@ -12,14 +12,15 @@ let _url = null;
 
 // ─── Embedding & Match Reason (via Supabase Edge Functions) ───────
 
-async function generateEmbedding(text) {
+async function generateEmbedding(text, supabaseUrl, supabaseKey) {
   try {
-    const sb = getClient();
+    getClient(supabaseUrl, supabaseKey);
+    const key = supabaseKey || process.env.ANTENNA_SUPABASE_KEY || process.env.ANTENNA_KEY || DEFAULT_KEY;
     const res = await fetch(`${_url || DEFAULT_URL}/functions/v1/generate-embedding`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
-        "Authorization": `Bearer ${process.env.ANTENNA_SUPABASE_KEY || process.env.ANTENNA_KEY || DEFAULT_KEY}`,
+        "Authorization": `Bearer ${key}`,
       },
       body: JSON.stringify({ text }),
     });
@@ -29,6 +30,31 @@ async function generateEmbedding(text) {
   } catch { return null; }
 }
 
+function profileSearchReason(query, profile) {
+  if (profile.recommendation_reason) return profile.recommendation_reason;
+  const tags = Array.isArray(profile.interest_tags) && profile.interest_tags.length
+    ? ` Tags: ${profile.interest_tags.slice(0, 3).join(", ")}.`
+    : "";
+  const score = typeof profile.match_score === "number" ? ` Score: ${profile.match_score.toFixed(2)}.` : "";
+  return `Matches the intent "${query}".${tags}${score}`.trim();
+}
+
+function mapSearchProfile(p, ref, query) {
+  return {
+    ref: ref,
+    display_name: p.display_name || "匿名",
+    profile_slug: p.profile_slug || null,
+    personal_description: p.personal_description ?? p.line1 ?? null,
+    looking_for: p.looking_for ?? p.line2 ?? null,
+    conversation_style: p.conversation_style ?? p.line3 ?? null,
+    more_information: p.more_information ?? p.matching_context ?? null,
+    interest_tags: p.interest_tags || [],
+    city: p.city || null,
+    match_score: typeof p.match_score === "number" ? Math.round(p.match_score * 1000) / 1000 : null,
+    recommendation_reason: profileSearchReason(query, p),
+  };
+}
+
 async function generateMatchReason(myLines, theirLines) {
   try {
     const res = await fetch(`${_url || DEFAULT_URL}/functions/v1/generate-match-reason`, {
@@ -119,7 +145,7 @@ export async function scan({ lat, lng, radius_m = 500, device_id, supabaseUrl, s
     const ref = String(i + 1);
     _refMap[ref] = p.device_id;
     return {
-      ref,
+      ref: ref,
       name: p.display_name || "匿名",
       personal_description: p.line1,
       looking_for: p.line2,
@@ -206,7 +232,7 @@ export const PROFILE_FIELDS = {
   looking_for: { label: "想认识的人", description: "The kind of people you want to meet", maxLength: 140 },
   conversation_style: { label: "想要的交流方式", description: "The type of conversations you want", maxLength: 160 },
   more_information: { label: "更多信息", description: "Agent-generated rich context for better matching (not shown to others)", maxLength: 1000 },
-  interest_tags: { label: "兴趣标签", description: "Interest/topic tags shown on the card (up to 8)", maxItems: 8 },
+  interest_tags: { label: "兴趣标签", description: "Interest/topic tags shown on the card (up to 5)", maxItems: 5 },
   city: { label: "国家/地区", description: "Country or region" },
   links: { label: "社交链接", description: "Social links shown on the card footer (up to 3)", maxItems: 3 },
   is_active: { label: "状态", description: "Whether the profile is active or quiet" },
@@ -290,7 +316,7 @@ export async function setProfile({
     if (!matching_context && !existing.context && (line1 || line2 || line3)) {
       existing.context = [line1, line2, line3].filter(Boolean).join(". ");
     }
-    if (interest_tags) existing.interestTags = interest_tags;
+    if (interest_tags) existing.interestTags = interest_tags.slice(0, 5);
     if (city) existing.city = city;
     if (links) existing.links = links;
     if (is_active !== undefined) existing.isActive = is_active;
@@ -318,7 +344,7 @@ export async function setProfile({
     const textParts = [line1, line2, line3, matching_context].filter(Boolean);
     const text = textParts.join(". ");
     if (text) {
-      const embedding = await generateEmbedding(text);
+      const embedding = await generateEmbedding(text, supabaseUrl, supabaseKey);
       if (embedding) {
         await sb.rpc("update_profile_embedding", {
           p_device_id: device_id,
@@ -350,45 +376,32 @@ export async function setProfile({
     }
   } catch {}
 
-  // Generate personalized archetype description via LLM
+  // Generate personalized archetype via LLM (no keyword matching)
   try {
     const profileText = [line1, line2, line3, matching_context].filter(Boolean).join(". ");
     if (profileText) {
-      // Simple keyword-based archetype detection (same logic as frontend)
-      const corpus = profileText.toLowerCase();
-      const archetypeKeywords = {
-        Prometheus: ["ai", "agent", "llm", "founder", "startup", "build", "developer", "hacker", "tools", "\u667a\u80fd\u4f53", "\u521b\u4e1a", "\u5f00\u53d1"],
-        Athena: ["product", "strategy", "research", "design", "craft", "pm", "ux", "\u4ea7\u54c1", "\u8bbe\u8ba1", "\u7814\u7a76"],
-        Hermes: ["network", "connect", "community", "social", "bridge", "\u793e\u4ea4", "\u8fde\u63a5", "\u793e\u533a"],
-        Apollo: ["music", "media", "content", "creator", "writing", "taste", "\u97f3\u4e50", "\u5185\u5bb9", "\u521b\u4f5c"],
-        Artemis: ["independent", "explore", "freelance", "health", "outdoor", "\u72ec\u7acb", "\u63a2\u7d22"],
-        Aphrodite: ["beauty", "brand", "fashion", "relationship", "\u7f8e", "\u54c1\u724c", "\u65f6\u5c1a"],
-        Dionysus: ["event", "culture", "party", "art", "festival", "\u6d3b\u52a8", "\u6587\u5316", "\u827a\u672f"],
-        Hades: ["finance", "invest", "infrastructure", "backend", "security", "\u6295\u8d44", "\u91d1\u878d", "\u67b6\u6784"],
-        Persephone: ["transform", "cross", "research", "academic", "bridge", "\u8de8\u754c", "\u7814\u7a76", "\u5b66\u672f"],
-        Odysseus: ["founder", "journey", "resilience", "travel", "startup", "\u521b\u4e1a", "\u65c5\u884c"],
-      };
-      let bestArchetype = "Prometheus";
-      let bestScore = 0;
-      for (const [role, keywords] of Object.entries(archetypeKeywords)) {
-        const score = keywords.reduce((s, kw) => s + (corpus.includes(kw) ? 1 : 0), 0);
-        if (score > bestScore) { bestScore = score; bestArchetype = role; }
-      }
-      archetypeResult = await generateArchetypeReason(bestArchetype, profileText);
-      if (archetypeResult?.reason) {
-        archetypeResult.archetype = bestArchetype;
-        // Write archetype back to matching_context so dashboard can display it
-        try {
-          const profile = await getProfile({ device_id, supabaseUrl, supabaseKey });
-          let ctx = {};
-          try { ctx = JSON.parse(profile?.matching_context || "{}"); } catch {}
-          ctx.archetypeOverride = { name: bestArchetype, reason: archetypeResult.reason, reasonZh: archetypeResult.reasonZh };
-          await sb.rpc("upsert_profile", {
-            p_device_id: device_id,
-            p_matching_context: JSON.stringify(ctx),
-            p_visible: profile?.visible ?? true,
-          });
-        } catch {}
+      const archRes = await fetch(`${_url || DEFAULT_URL}/functions/v1/generate-archetype`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", "Authorization": `Bearer ${process.env.ANTENNA_SUPABASE_KEY || process.env.ANTENNA_KEY || DEFAULT_KEY}` },
+        body: JSON.stringify({ profile_text: profileText }),
+      });
+      if (archRes.ok) {
+        const archData = await archRes.json();
+        if (archData?.archetype && archData?.reason) {
+          archetypeResult = { archetype: archData.archetype, reason: archData.reason, reasonZh: archData.reasonZh };
+          // Write archetype back to matching_context
+          try {
+            const profile = await getProfile({ device_id, supabaseUrl, supabaseKey });
+            let ctx = {};
+            try { ctx = JSON.parse(profile?.matching_context || "{}"); } catch {}
+            ctx.archetypeOverride = { name: archData.archetype, reason: archData.reason, reasonZh: archData.reasonZh };
+            await sb.rpc("upsert_profile", {
+              p_device_id: device_id,
+              p_matching_context: JSON.stringify(ctx),
+              p_visible: profile?.visible ?? true,
+            });
+          } catch {}
+        }
       }
     }
   } catch (e) {
@@ -599,7 +612,7 @@ export async function discover({ device_id, supabaseUrl, supabaseKey }) {
     }
 
     profiles.push({
-      ref,
+      ref: ref,
       name: p.display_name || "匿名",
       personal_description: p.line1,
       looking_for: p.line2,
@@ -708,6 +721,50 @@ export async function initialRecommendations({ device_id, supabaseUrl, supabaseK
   };
 }
 
+// ─── findPeople (intent-based search) ───────────────────────────────
+
+export async function findPeople({ query, device_id, limit = 3, supabaseUrl, supabaseKey }) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+  const cleanQuery = String(query || "").trim();
+  const cappedLimit = Math.min(Math.max(Number(limit) || 3, 1), 3);
+
+  if (cleanQuery.length < 2) {
+    return { count: 0, profiles: [], message: "Tell me what kind of person you want to find." };
+  }
+
+  const embedding = await generateEmbedding(cleanQuery, supabaseUrl, supabaseKey);
+  const { data, error } = await sb.rpc("antenna_intent_search_people", {
+    p_device_id: device_id,
+    p_query: cleanQuery,
+    p_query_embedding: embedding ? `[${embedding.join(",")}]` : null,
+    p_limit: cappedLimit,
+  });
+
+  if (error) throw new Error(error.message);
+
+  const results = data || [];
+  const _refMap = {};
+  const profiles = results.map((p, i) => {
+    const ref = String(i + 1);
+    _refMap[ref] = p.device_id;
+    return mapSearchProfile(p, ref, cleanQuery);
+  });
+
+  if (device_id && Object.keys(_refMap).length > 0) {
+    try { await sb.rpc("save_scan_refs", { p_owner: device_id, p_refs: _refMap }); } catch {}
+  }
+
+  return {
+    count: profiles.length,
+    profiles,
+    _ref_map: _refMap,
+    query: cleanQuery,
+    message: profiles.length
+      ? "Intent search results. Recommend only the best fit(s), then use ref with antenna_accept if the user wants an intro."
+      : "No relevant active profiles found for that intent right now.",
+  };
+}
+
 // ─── pass ───────────────────────────────────────────────────────────
 
 export async function pass({ device_id, target_device_id, ref, supabaseUrl, supabaseKey }) {
@@ -865,7 +922,7 @@ export async function eventScan({ code, device_id, supabaseUrl, supabaseKey }) {
     _refMap[ref] = p.device_id;
     if (p.checked_in) checkedInCount++;
     return {
-      ref,
+      ref: ref,
       name: p.display_name || "匿名",
       personal_description: p.line1,
       looking_for: p.line2,

package/lib/hermes-plugin/__init__.py

@@ -22,6 +22,7 @@ from .tools import (
     handle_bind,
     handle_pass,
     handle_discover,
+    handle_find_people,
     handle_event_create,
     handle_event_join,
     handle_event_scan,
@@ -47,6 +48,7 @@ from .schemas import (
     BIND_SCHEMA,
     PASS_SCHEMA,
     DISCOVER_SCHEMA,
+    FIND_PEOPLE_SCHEMA,
     EVENT_CREATE_SCHEMA,
     EVENT_JOIN_SCHEMA,
     EVENT_SCAN_SCHEMA,
@@ -83,6 +85,7 @@ def register(ctx):
     ctx.register_tool("antenna_bind", BIND_SCHEMA, handle_bind)
     ctx.register_tool("antenna_pass", PASS_SCHEMA, handle_pass)
     ctx.register_tool("antenna_discover", DISCOVER_SCHEMA, handle_discover)
+    ctx.register_tool("antenna_find_people", FIND_PEOPLE_SCHEMA, handle_find_people)
     ctx.register_tool("antenna_event_create", EVENT_CREATE_SCHEMA, handle_event_create)
     ctx.register_tool("antenna_event_join", EVENT_JOIN_SCHEMA, handle_event_join)
     ctx.register_tool("antenna_event_scan", EVENT_SCAN_SCHEMA, handle_event_scan)

package/lib/hermes-plugin/plugin.yaml

@@ -3,5 +3,5 @@ version: "1.3.8"
 description: |
   Nearby people discovery + events — scan for people, set up your profile card,
   accept matches, create/join events, and get real-time notifications.
-  18 tools. Uses Supabase as shared backend.
+  19 tools. Uses Supabase as shared backend.
 requires_env: []

package/lib/hermes-plugin/schemas.py

@@ -420,3 +420,23 @@ INITIAL_RECOMMENDATIONS_SCHEMA = {
         "required": ["sender_id", "channel", "chat_id"],
     },
 }
+
+FIND_PEOPLE_SCHEMA = {
+    "name": "antenna_find_people",
+    "description": (
+        "Find 1-3 people by a free-form intent, e.g. "
+        "'想找一个懂 consumer social 增长的人'. Returns privacy-safe refs; "
+        "use ref with antenna_accept if the user wants an intro."
+    ),
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "query": {"type": "string", "description": "Free-form user intent describing the kind of person to find"},
+            "sender_id": {"type": "string", "description": "The sender's user ID"},
+            "channel": {"type": "string", "description": "Platform name (any platform works)"},
+            "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
+            "limit": {"type": "number", "description": "Maximum profiles to return, 1-3"},
+        },
+        "required": ["query", "sender_id", "channel", "chat_id"],
+    },
+}

package/lib/hermes-plugin/tools.py

@@ -75,6 +75,30 @@ def _ok(data) -> str:
     return json.dumps(data, ensure_ascii=False)
 
 
+def _generate_embedding(text: str):
+    try:
+        req = urllib.request.Request(
+            f"{_get_url()}/functions/v1/generate-embedding",
+            data=json.dumps({"text": text}).encode(),
+            headers={"Content-Type": "application/json", "Authorization": f"Bearer {_get_key()}"},
+        )
+        res = urllib.request.urlopen(req, timeout=15)
+        body = json.loads(res.read().decode())
+        return body.get("embedding")
+    except Exception:
+        return None
+
+
+def _search_reason(query: str, profile: dict) -> str:
+    if profile.get("recommendation_reason"):
+        return profile["recommendation_reason"]
+    tags = profile.get("interest_tags") or []
+    tag_text = f" Tags: {', '.join(tags[:3])}." if tags else ""
+    score = profile.get("match_score")
+    score_text = f" Score: {score:.2f}." if isinstance(score, (int, float)) else ""
+    return f'Matches the intent "{query}".{tag_text}{score_text}'.strip()
+
+
 # ─── Handlers ─────────────────────────────────────────────────────────
 
 def handle_scan(params: dict) -> str:
@@ -122,11 +146,10 @@ def handle_scan(params: dict) -> str:
         _last_ref_map[ref] = p.get("device_id")
         profiles.append({
             "ref": ref,
-            "emoji": p.get("emoji") or "👤",
             "name": p.get("display_name") or "匿名",
-            "line1": p.get("line1"),
-            "line2": p.get("line2"),
-            "line3": p.get("line3"),
+            "personal_description": p.get("line1"),
+            "looking_for": p.get("line2"),
+            "conversation_style": p.get("line3"),
             "more_information": p.get("matching_context") or None,
             "profile_slug": p.get("profile_slug") or None,
             "distance_m": p.get("distance_m") or p.get("dist_meters"),
@@ -154,14 +177,14 @@ def handle_profile(params: dict) -> str:
     if params["action"] == "get":
         resp = sb.rpc("get_profile", {"p_device_id": did}).execute()
         if not resp.data:
-            return _ok({"exists": False, "message": "你还没有名片。告诉我你的名字、emoji、三句话，我帮你创建。"})
+            return _ok({"exists": False, "message": "你还没有名片。告诉我你是谁、做什么、想认识什么人，我帮你创建。"})
         return _ok({"exists": True, "profile": resp.data})
 
     # set
     rpc_params = {
         "p_device_id": did,
         "p_display_name": params.get("display_name"),
-        "p_emoji": params.get("emoji"),
+        "p_emoji": None,
         "p_line1": params.get("line1"),
         "p_line2": params.get("line2"),
         "p_line3": params.get("line3"),
@@ -271,7 +294,6 @@ def handle_check_matches(params: dict) -> str:
             "ref": str(i + 1),
             "_device_id": m.get("target_id"),
             "name": m.get("name") or "匿名",
-            "emoji": m.get("emoji") or "👤",
             "their_contact": m.get("their_contact"),
             "you_shared": m.get("you_shared"),
         })
@@ -282,7 +304,6 @@ def handle_check_matches(params: dict) -> str:
             "ref": str(len(mutual) + i + 1),
             "_device_id": m.get("target_id"),
             "name": m.get("name") or "匿名",
-            "emoji": m.get("emoji") or "👤",
             "line1": m.get("line1"),
             "line2": m.get("line2"),
             "line3": m.get("line3"),
@@ -389,16 +410,14 @@ def handle_discover(params: dict) -> str:
 
         profile = {
             "ref": ref,
-            "emoji": p.get("emoji") or "\ud83d\udc64",
             "name": p.get("display_name") or "匿名",
-            "line1": p.get("line1"),
-            "line2": p.get("line2"),
-            "line3": p.get("line3"),
+            "personal_description": p.get("line1"),
+            "looking_for": p.get("line2"),
+            "conversation_style": p.get("line3"),
             "more_information": p.get("matching_context") or None,
             "profile_slug": p.get("profile_slug") or None,
+            "match_reason": match_reason,
         }
-        if match_reason:
-            profile["match_reason"] = match_reason
         profiles.append(profile)
 
     # Save refs and log recommendations
@@ -419,6 +438,63 @@ def handle_discover(params: dict) -> str:
     })
 
 
+def handle_find_people(params: dict) -> str:
+    sb = _sb()
+    did = _device_id(params["sender_id"], params["channel"], params.get("chat_id"))
+    query = (params.get("query") or "").strip()
+    limit = max(1, min(int(params.get("limit") or 3), 3))
+
+    if len(query) < 2:
+        return _ok({"count": 0, "profiles": [], "message": "Tell me what kind of person you want to find."})
+
+    embedding = _generate_embedding(query)
+    emb_text = f"[{','.join(str(x) for x in embedding)}]" if embedding else None
+    resp = sb.rpc("antenna_intent_search_people", {
+        "p_device_id": did,
+        "p_query": query,
+        "p_query_embedding": emb_text,
+        "p_limit": limit,
+    }).execute()
+    results = resp.data or []
+
+    global _last_ref_map
+    _last_ref_map = {}
+    profiles = []
+    for i, p in enumerate(results):
+        ref = str(i + 1)
+        _last_ref_map[ref] = p.get("device_id")
+        profiles.append({
+            "ref": ref,
+            "display_name": p.get("display_name") or "匿名",
+            "profile_slug": p.get("profile_slug"),
+            "personal_description": p.get("personal_description"),
+            "looking_for": p.get("looking_for"),
+            "conversation_style": p.get("conversation_style"),
+            "more_information": p.get("more_information"),
+            "interest_tags": p.get("interest_tags") or [],
+            "city": p.get("city"),
+            "match_score": p.get("match_score"),
+            "recommendation_reason": _search_reason(query, p),
+        })
+
+    if did and _last_ref_map:
+        try:
+            sb.rpc("save_scan_refs", {"p_owner": did, "p_refs": _last_ref_map}).execute()
+        except Exception:
+            pass
+
+    return _ok({
+        "count": len(profiles),
+        "profiles": profiles,
+        "query": query,
+        "message": (
+            "Intent search results. Recommend only the best fit(s), then use ref with antenna_accept if the user wants an intro."
+            if profiles else
+            "No relevant active profiles found for that intent right now."
+        ),
+    })
+
+
 def handle_event_create(params: dict) -> str:
     sb = _sb()
     did = _device_id(params["sender_id"], params["channel"], params.get("chat_id"))
@@ -563,11 +639,10 @@ def handle_event_scan(params: dict) -> str:
             checked_in_count += 1
         profiles.append({
             "ref": ref,
-            "emoji": p.get("emoji") or "👤",
             "name": p.get("display_name") or "匿名",
-            "line1": p.get("line1"),
-            "line2": p.get("line2"),
-            "line3": p.get("line3"),
+            "personal_description": p.get("line1"),
+            "looking_for": p.get("line2"),
+            "conversation_style": p.get("line3"),
             "more_information": p.get("matching_context") or None,
             "profile_slug": p.get("profile_slug") or None,
             "checked_in": bool(p.get("checked_in")),
@@ -784,7 +859,6 @@ def handle_initial_recommendations(params: dict) -> str:
 
         profile = {
             "ref": ref,
-            "emoji": p.get("emoji") or "\ud83d\udc64",
             "name": p.get("display_name") or "匿名",
             "personal_description": p.get("line1"),
             "looking_for": p.get("line2"),

package/lib/mcp.js

@@ -14,6 +14,7 @@ import {
   createBindToken,
   discover,
   initialRecommendations,
+  findPeople,
   createEvent,
   endEvent,
   eventCheckin,
@@ -122,7 +123,7 @@ export async function startMcpServer() {
       looking_for: z.string().optional().describe("Looking for — the kind of people you want to meet (max 140 chars)"),
       conversation_style: z.string().optional().describe("Conversation style — the type of conversations you want (max 160 chars)"),
       more_information: z.string().optional().describe("More information — agent-generated rich context for better matching (not shown to others, max 1000 chars). Generate this FIRST, then derive personal_description, looking_for, and conversation_style from it."),
-      interest_tags: z.array(z.string()).optional().describe("Interest/topic tags shown on the card (up to 8)"),
+      interest_tags: z.array(z.string()).max(5).optional().describe("Interest/topic tags shown on the card (up to 5)"),
       city: z.string().optional().describe("Country or region (e.g. 'United States', 'Beijing')"),
       links: z.array(z.string()).optional().describe("Social links shown on the card footer (up to 3)"),
       is_active: z.boolean().optional().describe("Whether the profile is active or quiet"),
@@ -289,6 +290,33 @@ export async function startMcpServer() {
     }
   );
 
+  // ─── antenna_find_people ─────────────────────────────────────
+
+  server.tool(
+    "antenna_find_people",
+    "Find 1-3 people by a free-form intent, e.g. '找一个懂 consumer social 增长的人'. Returns privacy-safe profile refs; use ref with antenna_accept if the user wants an intro.",
+    {
+      query: z.string().describe("Free-form user intent describing the kind of person to find"),
+      sender_id: z.string().describe("The sender's user ID"),
+      channel: z.string().describe("Channel name"),
+      limit: z.number().optional().default(3).describe("Maximum profiles to return, 1-3"),
+    },
+    async ({ query, sender_id, channel, limit }) => {
+      try {
+        const deviceId = deriveDeviceId(sender_id, channel);
+        const result = await findPeople({ query, device_id: deviceId, limit });
+        if (result._ref_map) {
+          _lastRefMap = { ..._lastRefMap, ...result._ref_map };
+          const { _ref_map, ...clean } = result;
+          return jsonResult(await withMatchNotifications(deviceId, clean));
+        }
+        return jsonResult(await withMatchNotifications(deviceId, result));
+      } catch (e) {
+        return jsonResult({ error: e.message });
+      }
+    }
+  );
+
   // ─── antenna_pass ────────────────────────────────────────────
 
   server.tool(

package/lib/plugin-template/index.ts

@@ -25,7 +25,6 @@ interface Profile {
   line1: string | null;
   line2: string | null;
   line3: string | null;
-  emoji: string | null;
   visible: boolean;
   last_seen_at?: string;
 }
@@ -33,7 +32,6 @@ interface Profile {
 interface MatchResult {
   device_id: string;
   display_name: string | null;
-  emoji: string | null;
   line1: string | null;
   line2: string | null;
   line3: string | null;
@@ -107,6 +105,30 @@ function ok(data: any) {
   return { content: [{ type: "text", text: JSON.stringify(data) }] };
 }
 
+async function generateEmbeddingForQuery(cfg: AntennaConfig, text: string): Promise<number[] | null> {
+  try {
+    const res = await fetch(`${cfg.supabaseUrl}/functions/v1/generate-embedding`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "Authorization": `Bearer ${cfg.supabaseKey}` },
+      body: JSON.stringify({ text }),
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data?.embedding || null;
+  } catch {
+    return null;
+  }
+}
+
+function intentSearchReason(query: string, profile: any): string {
+  if (profile.recommendation_reason) return profile.recommendation_reason;
+  const tags = Array.isArray(profile.interest_tags) && profile.interest_tags.length
+    ? ` Tags: ${profile.interest_tags.slice(0, 3).join(", ")}.`
+    : "";
+  const score = typeof profile.match_score === "number" ? ` Score: ${profile.match_score.toFixed(2)}.` : "";
+  return `Matches the intent "${query}".${tags}${score}`.trim();
+}
+
 // ─── Cron helpers ────────────────────────────────────────────────────
 
 const FOLLOW_UP_INTERVAL_MS = 15 * 60 * 1000; // 15 minutes
@@ -265,15 +287,26 @@ export default function register(api: any) {
       }
 
       // Return raw profile cards — the agent decides who to recommend
-      return ok({
-        nearby: others.map((p: Profile) => ({
-          device_id: p.device_id,
-          emoji: p.emoji || "👤",
+      const _refMap: Record<string, string> = {};
+      const profiles = others.map((p: Profile, i: number) => {
+        const ref = String(i + 1);
+        _refMap[ref] = p.device_id;
+        return {
+          ref: ref,
           name: p.display_name || "匿名",
-          line1: p.line1,
-          line2: p.line2,
-          line3: p.line3,
-        })),
+          personal_description: p.line1,
+          looking_for: p.line2,
+          conversation_style: p.line3,
+          more_information: null,
+          profile_slug: null,
+          distance_m: p.distance_m ?? p.dist_meters ?? null,
+        };
+      });
+      (api as any)._antennaRefMap = _refMap;
+      try { await supabase.rpc("save_scan_refs", { p_owner: deviceId, p_refs: _refMap }); } catch {}
+
+      return ok({
+        profiles: profiles,
         total: others.length,
         radius_m: radius,
         instruction: "根据你对用户的了解（记忆、偏好、最近的状态），判断哪些人值得推荐，为每个推荐写一句个性化的匹配理由。",
@@ -281,13 +314,81 @@ export default function register(api: any) {
     },
   });
 
+  // ═══════════════════════════════════════════════════════════════════
+  // Tool: antenna_find_people
+  // ═══════════════════════════════════════════════════════════════════
+  api.registerTool({
+    name: "antenna_find_people",
+    description:
+      "Find 1-3 people by a free-form intent. Returns privacy-safe refs; use ref with antenna_accept if the user wants an intro.",
+    parameters: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "Free-form user intent describing the kind of person to find" },
+        sender_id: { type: "string", description: "The sender's user ID" },
+        channel: { type: "string", description: "The channel name" },
+        limit: { type: "number", description: "Maximum profiles to return, 1-3" },
+      },
+      required: ["query", "sender_id", "channel"],
+    },
+    async execute(_id: string, params: any) {
+      const cfg = getConfig(api);
+      const supabase = getSupabase(cfg);
+      const deviceId = deriveDeviceId(params.sender_id, params.channel);
+      const query = String(params.query || "").trim();
+      const limit = Math.min(Math.max(Number(params.limit) || 3, 1), 3);
+      if (query.length < 2) return ok({ count: 0, profiles: [], message: "Tell me what kind of person you want to find." });
+
+      const embedding = await generateEmbeddingForQuery(cfg, query);
+      const { data, error } = await supabase.rpc("antenna_intent_search_people", {
+        p_device_id: deviceId,
+        p_query: query,
+        p_query_embedding: embedding ? `[${embedding.join(",")}]` : null,
+        p_limit: limit,
+      });
+      if (error) return ok({ error: error.message });
+
+      const _refMap: Record<string, string> = {};
+      const profiles = (data || []).map((p: any, i: number) => {
+        const ref = String(i + 1);
+        _refMap[ref] = p.device_id;
+        return {
+          ref: ref,
+          display_name: p.display_name || "匿名",
+          profile_slug: p.profile_slug || null,
+          personal_description: p.personal_description || null,
+          looking_for: p.looking_for || null,
+          conversation_style: p.conversation_style || null,
+          more_information: p.more_information || null,
+          interest_tags: p.interest_tags || [],
+          city: p.city || null,
+          match_score: typeof p.match_score === "number" ? Math.round(p.match_score * 1000) / 1000 : null,
+          recommendation_reason: intentSearchReason(query, p),
+        };
+      });
+      (api as any)._antennaRefMap = { ...(api as any)._antennaRefMap, ..._refMap };
+      if (Object.keys(_refMap).length > 0) {
+        try { await supabase.rpc("save_scan_refs", { p_owner: deviceId, p_refs: _refMap }); } catch {}
+      }
+
+      return ok({
+        count: profiles.length,
+        profiles,
+        query,
+        message: profiles.length
+          ? "Intent search results. Recommend only the best fit(s), then use ref with antenna_accept if the user wants an intro."
+          : "No relevant active profiles found for that intent right now.",
+      });
+    },
+  });
+
   // ═══════════════════════════════════════════════════════════════════
   // Tool: antenna_profile
   // ═══════════════════════════════════════════════════════════════════
   api.registerTool({
     name: "antenna_profile",
     description:
-      "View or update the user's Antenna profile (name card). The profile has a display name, emoji, and three lines describing who they are.",
+      "View or update the user's Antenna profile (name card). The profile has a display name and three lines describing who they are.",
     parameters: {
       type: "object",
       properties: {
@@ -295,7 +396,6 @@ export default function register(api: any) {
         sender_id: { type: "string", description: "The sender's user ID" },
         channel: { type: "string", description: "The channel name" },
         display_name: { type: "string", description: "Display name" },
-        emoji: { type: "string", description: "Profile emoji" },
         line1: { type: "string", description: "First line (who you are / what you do)" },
         line2: { type: "string", description: "Second line (what you're into)" },
         line3: { type: "string", description: "Third line (what you're looking for)" },
@@ -311,18 +411,18 @@ export default function register(api: any) {
       if (params.action === "get") {
         const { data, error } = await supabase.rpc("get_profile", { p_device_id: deviceId });
         if (error || !data) {
-          return ok({ exists: false, message: "你还没有名片。告诉我你的名字、一个 emoji、和三句话介绍自己，我帮你创建。" });
+          return ok({ exists: false, message: "你还没有名片。告诉我你是谁、做什么、想认识什么人，我帮你创建。" });
         }
         return ok({
           exists: true,
-          profile: { display_name: data.display_name, emoji: data.emoji,
+          profile: { display_name: data.display_name,
             line1: data.line1, line2: data.line2, line3: data.line3, visible: data.visible },
         });
       }
 
       const { data, error } = await supabase.rpc("upsert_profile", {
         p_device_id: deviceId,
-        p_display_name: params.display_name ?? null, p_emoji: params.emoji ?? null,
+        p_display_name: params.display_name ?? null, p_emoji: null,
         p_line1: params.line1 ?? null, p_line2: params.line2 ?? null,
         p_line3: params.line3 ?? null, p_visible: params.visible ?? true,
       });
@@ -331,7 +431,7 @@ export default function register(api: any) {
 
       return ok({
         updated: true,
-        profile: { display_name: data.display_name, emoji: data.emoji,
+        profile: { display_name: data.display_name,
           line1: data.line1, line2: data.line2, line3: data.line3, visible: data.visible },
       });
     },
@@ -366,7 +466,7 @@ export default function register(api: any) {
       if (!profile) {
         return ok({
           checked_in: false,
-          message: "你还没有名片，别人看到你也不知道你是谁。先创建一个名片吧（告诉我你的名字、emoji、三句话介绍自己）。",
+          message: "你还没有名片，别人看到你也不知道你是谁。先创建一个名片吧（告诉我你是谁、做什么、想认识什么人）。",
         });
       }
 
@@ -396,18 +496,28 @@ export default function register(api: any) {
       properties: {
         sender_id: { type: "string" },
         channel: { type: "string" },
+        ref: { type: "string", description: "Ref number from scan/find results" },
         target_device_id: { type: "string", description: "The device_id of the person to accept" },
         contact_info: { type: "string", description: "Optional contact info to share (e.g. 'WeChat: yi_xxx')" },
       },
-      required: ["sender_id", "channel", "target_device_id"],
+      required: ["sender_id", "channel"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
       const supabase = getSupabase(cfg);
       const deviceId = deriveDeviceId(params.sender_id, params.channel);
+      let targetId = params.target_device_id;
+      if (!targetId && params.ref) {
+        targetId = (api as any)._antennaRefMap?.[params.ref];
+        if (!targetId) {
+          const { data } = await supabase.rpc("resolve_ref", { p_owner: deviceId, p_ref: params.ref });
+          targetId = data;
+        }
+      }
+      if (!targetId) return ok({ accepted: false, error: "No target. Provide ref or target_device_id." });
 
       const { error } = await supabase.rpc("upsert_match", {
-        p_device_id_a: deviceId, p_device_id_b: params.target_device_id,
+        p_device_id_a: deviceId, p_device_id_b: targetId,
         p_status: "accepted", p_contact_info: params.contact_info ?? null,
       });
 
@@ -415,13 +525,13 @@ export default function register(api: any) {
 
       const { data: myMatches } = await supabase.rpc("get_my_matches", { p_device_id: deviceId });
       const reverse = (myMatches || []).find(
-        (m: any) => m.device_id_a === params.target_device_id && m.device_id_b === deviceId
+        (m: any) => m.device_id_a === targetId && m.device_id_b === deviceId
       );
 
       if (reverse) {
         // Mutual match! Stop any follow-up cron for this pair
-        stopFollowUpCron(deviceId, params.target_device_id, logger);
-        stopFollowUpCron(params.target_device_id, deviceId, logger);
+        stopFollowUpCron(deviceId, targetId, logger);
+        stopFollowUpCron(targetId, deviceId, logger);
 
         return ok({
           accepted: true, mutual: true,
@@ -433,11 +543,11 @@ export default function register(api: any) {
       }
 
       // Not mutual yet — start a follow-up cron (check every 15min for 2h)
-      const { data: targetProfile } = await supabase.rpc("get_profile", { p_device_id: params.target_device_id });
+      const { data: targetProfile } = await supabase.rpc("get_profile", { p_device_id: targetId });
       const targetName = targetProfile?.display_name || "对方";
 
       startFollowUpCron(
-        deviceId, params.target_device_id,
+        deviceId, targetId,
         params.channel, params.sender_id, targetName, logger,
       );
 
@@ -493,7 +603,7 @@ export default function register(api: any) {
           const { data: profile } = await supabase.rpc("get_profile", { p_device_id: match.device_id_b });
           mutualMatches.push({
             device_id: match.device_id_b,
-            name: profile?.display_name || "匿名", emoji: profile?.emoji || "👤",
+            name: profile?.display_name || "匿名",
             line1: profile?.line1, line2: profile?.line2, line3: profile?.line3,
             their_contact: reverse.contact_info_a || null, you_shared: match.contact_info_a || null,
           });
@@ -511,7 +621,7 @@ export default function register(api: any) {
           const { data: profile } = await supabase.rpc("get_profile", { p_device_id: match.device_id_a });
           incomingAccepts.push({
             device_id: match.device_id_a,
-            name: profile?.display_name || "匿名", emoji: profile?.emoji || "👤",
+            name: profile?.display_name || "匿名",
             line1: profile?.line1, line2: profile?.line2, line3: profile?.line3,
           });
         }
@@ -587,11 +697,10 @@ export default function register(api: any) {
                 if (reverse) {
                   const { data: theirProfile } = await supabase.rpc("get_profile", { p_device_id: match.device_id_b });
                   const name = theirProfile?.display_name || "对方";
-                  const emoji = theirProfile?.emoji || "👤";
                   const contact = reverse.contact_info_a ? `\n对方的联系方式：${reverse.contact_info_a}` : "";
                   notifyUser(
                     channel, userId,
-                    `[Antenna] 🎉 双向匹配成功！${emoji} ${name} 也接受了你！${contact}\n\n用 antenna_check_matches 查看详情。`,
+                    `[Antenna] 🎉 双向匹配成功！${name} 也接受了你！${contact}\n\n用 antenna_check_matches 查看详情。`,
                     logger,
                   );
                   // Clean up follow-up crons
@@ -601,14 +710,13 @@ export default function register(api: any) {
                 // Someone new accepted me
                 const { data: theirProfile } = await supabase.rpc("get_profile", { p_device_id: match.device_id_a });
                 const name = theirProfile?.display_name || "有人";
-                const emoji = theirProfile?.emoji || "👤";
                 const iAccepted = myMatches.find((m: any) => m.device_id_b === match.device_id_a);
                 if (iAccepted) {
                   // I already accepted them → mutual!
                   const contact = match.contact_info_a ? `\n对方的联系方式：${match.contact_info_a}` : "";
                   notifyUser(
                     channel, userId,
-                    `[Antenna] 🎉 双向匹配成功！${emoji} ${name} 也接受了你！${contact}\n\n用 antenna_check_matches 查看详情。`,
+                    `[Antenna] 🎉 双向匹配成功！${name} 也接受了你！${contact}\n\n用 antenna_check_matches 查看详情。`,
                     logger,
                   );
                   stopFollowUpCron(deviceId, match.device_id_a, logger);
@@ -616,7 +724,7 @@ export default function register(api: any) {
                   // They accepted me but I haven't responded
                   notifyUser(
                     channel, userId,
-                    `[Antenna] 📩 ${emoji} ${name} 想认识你！看看 TA 的名片，决定要不要接受？\n\n用 antenna_check_matches 查看详情。`,
+                    `[Antenna] 📩 ${name} 想认识你！看看 TA 的名片，决定要不要接受？\n\n用 antenna_check_matches 查看详情。`,
                     logger,
                   );
                 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "antenna-fyi",
-  "version": "1.3.37",
-  "description": "Antenna \u2014 nearby people discovery. CLI + MCP server + OpenClaw skill & plugin, all in one package.",
+  "version": "1.3.39",
+  "description": "Antenna — nearby people discovery. CLI + MCP server + OpenClaw skill & plugin, all in one package.",
   "type": "module",
   "bin": {
     "antenna-fyi": "bin/antenna.js",
@@ -26,4 +26,4 @@
     "@modelcontextprotocol/sdk": "^1.12.1",
     "zod": "^3.24.4"
   }
-}
+}

package/skill/SKILL.md

@@ -13,6 +13,7 @@ Antenna 帮你的用户发现值得认识的人。不只是"附近的人"--profi
 发现可以来自任何渠道:
 - 📡 **附近扫描** - `antenna_scan`,基于 GPS 的周边发现
 - 🌍 **全球推荐** - `antenna_discover`,每天 1 个最匹配的人
+- 🔎 **意图找人** - `antenna_find_people`,用户直接说"我想找一个 xxx 的人"
 - 🔗 **Profile 链接** - 用户收到 `antenna.fyi/p/xxx` 链接,agent 读取后直接 accept
 - 🎪 **活动** - `antenna_event_scan`,同一个活动里的人
 
@@ -44,7 +45,7 @@ Plugin 安装后,agent **主动**开始引导,不要等用户问。
 跟用户聊几句,了解他们是谁、做什么、想认识什么人。然后 agent 自己生成:
 - more_information(~200 字,给 agent 匹配用的私密上下文,不展示给别人)
 - 从中提炼 personal_description/looking_for/conversation_style + display_name
-- 提取 interest_tags（最多 8 个，如 "AI agents", "music", "design"）
+- 提取 interest_tags（最多 5 个，如 "AI agents", "music", "design"）
 
 展示预览给用户确认:
 > 你的名片:
@@ -103,6 +104,7 @@ openclaw cron add --every 1h --message "Check antenna matches: call antenna_chec
 - **首次安装后**:主动 onboarding
 - 用户分享位置 → `antenna_scan`
 - 用户问"附近有谁" → `antenna_scan`
+- 用户说"我想找一个 xxx 的人" → `antenna_find_people`
 - 用户收到 profile 链接(`antenna.fyi/p/xxx`)→ 读取 profile → 判断 → `antenna_accept`
 - 用户想编辑名片 → `antenna_profile`
 - 用户说 accept / skip → `antenna_accept` / `antenna_pass`
@@ -119,7 +121,15 @@ openclaw cron add --every 1h --message "Check antenna matches: call antenna_chec
 每天 1 个全球最匹配的人,不需要 GPS。
 - 用在日常 cron 里,或用户主动要求
 
-### 3. Profile 链接
+### 3. 意图找人(antenna_find_people)
+用户直接提出想认识的人,例如"想找一个懂 consumer social 增长的人"、"找一个做 AI hardware 的人"。
+- 输入用户原话作为 `query`
+- 返回 1-3 个候选 profile,包含 `ref`、`profile_slug`、三段名片、`more_information`、`interest_tags`、city 和推荐理由
+- 不返回联系方式或 raw `device_id`
+- 你仍然要结合上下文判断是否推荐,不要机械展示所有结果
+- 用户想认识某人时,用 `ref` 调 `antenna_accept`
+
+### 4. Profile 链接
 用户收到 `antenna.fyi/p/xxx` 链接时:
 1. 用 `web_fetch` 读取页面--页面里有 `<script id="antenna-profile-data">` JSON,包含完整 profile
 2. 读取 more_information、interest_tags、个人描述等
@@ -128,7 +138,7 @@ openclaw cron add --every 1h --message "Check antenna matches: call antenna_chec
 
 **不需要先 scan。** Profile 链接是独立的发现路径。
 
-### 4. 活动(Events)
+### 5. 活动(Events)
 同一个活动里的人。详见 EVENTS.md。
 
 ## Tools
@@ -197,6 +207,14 @@ openclaw cron add --every 1h --message "Check antenna matches: call antenna_chec
 - 不需要 GPS
 - 如果所有人都推荐过了,返回"等新人加入"
 
+### `antenna_find_people`
+意图找人--根据用户自然语言需求搜索 1-3 个相关的人。
+- `query`:用户原话,如"想找一个懂 consumer social 增长的人"
+- `sender_id`, `channel`, `chat_id`
+- `limit`:1-3,默认 3
+- 返回 `profiles`,每个 profile 有 `ref`, `display_name`, `profile_slug`, `personal_description`, `looking_for`, `conversation_style`, `more_information`, `interest_tags`, `city`, `recommendation_reason`
+- 不会返回联系方式或 raw `device_id`
+
 ### `antenna_initial_recommendations`
 首次推荐--注册后立刻看到 2-3 个最匹配的人。
 - `sender_id`, `channel`, `chat_id`: from context