antenna-fyi 1.3.0 → 1.3.2

package/README.md

@@ -12,26 +12,26 @@ npm install -g antenna-fyi
 
 ```bash
 # Create your profile card
-antenna setup --id telegram:123
+antenna setup --id <platform>:<user_id>
 
 # Scan for nearby people
-antenna scan --lat 39.99 --lng 116.48 --radius 500 --id telegram:123
+antenna scan --lat 39.99 --lng 116.48 --radius 500 --id <platform>:<user_id>
 
 # Check in at a location
-antenna checkin --id telegram:123 --lat 39.99 --lng 116.48
+antenna checkin --id <platform>:<user_id> --lat 39.99 --lng 116.48
 
 # View/edit your profile
-antenna profile --id telegram:123
-antenna profile --id telegram:123 --name Yi --emoji 🦦 --line1 'Product Designer'
+antenna profile --id <platform>:<user_id>
+antenna profile --id <platform>:<user_id> --name Yi --emoji 🦦 --line1 'Product Designer'
 
 # Accept a match
-antenna accept --id telegram:123 --target telegram:789 --contact 'WeChat: yi'
+antenna accept --id <platform>:<user_id> --target <ref_or_id> --contact 'WeChat: yi'
 
 # Check match status
-antenna matches --id telegram:123
+antenna matches --id <platform>:<user_id>
 
 # Show status
-antenna status --id telegram:123
+antenna status --id <platform>:<user_id>
 ```
 
 ## MCP Server

package/lib/cli.js

@@ -31,7 +31,7 @@ export function parseFlags(args) {
 }
 
 export async function handleScan(f) {
-  if (!f.lat && !f.lng && !f.id) return console.error("Usage: antenna scan --lat 39.99 --lng 116.48 [--radius 500] (max 1000) [--id telegram:123]\n  Or just: antenna scan --id telegram:123 (uses saved location from GPS bind)");
+  if (!f.lat && !f.lng && !f.id) return console.error("Usage: antenna scan --lat 39.99 --lng 116.48 [--radius 500] (max 1000) [--id <platform>:<user_id>]\n  Or just: antenna scan --id <platform>:<user_id> (uses saved location from GPS bind)");
   const result = await scan({
     lat: f.lat ? +f.lat : undefined,
     lng: f.lng ? +f.lng : undefined,
@@ -64,7 +64,7 @@ export async function handleScan(f) {
 }
 
 export async function handleProfile(f) {
-  if (!f.id) return console.error("Usage: antenna profile --id telegram:123 [--name Yi --emoji 🦦 --line1 '...' --line2 '...' --line3 '...']");
+  if (!f.id) return console.error("Usage: antenna profile --id <platform>:<user_id> [--name Yi --emoji 🦦 --line1 '...' --line2 '...' --line3 '...']");
   if (f.name || f.line1 || f.line2 || f.line3 || f.visible !== undefined || f.hide !== undefined) {
     const visible = f.hide ? false : (f.visible !== undefined ? f.visible === 'true' || f.visible === true : undefined);
     const data = await setProfile({
@@ -89,7 +89,7 @@ export async function handleProfile(f) {
 }
 
 export async function handleAccept(f) {
-  if (!f.id || (!f.target && !f.ref)) return console.error("Usage: antenna accept --id telegram:123 --ref 1 [--contact 'WeChat: yi']\n       antenna accept --id telegram:123 --target telegram:789 [--contact 'WeChat: yi']");
+  if (!f.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: f.id,
     target_device_id: f.target || null,
@@ -101,7 +101,7 @@ export async function handleAccept(f) {
 }
 
 export async function handleCheckin(f) {
-  if (!f.id || !f.lat || !f.lng) return console.error("Usage: antenna checkin --id telegram:123 --lat 39.99 --lng 116.48 [--place '三里屯']");
+  if (!f.id || !f.lat || !f.lng) return console.error("Usage: antenna checkin --id <platform>:<user_id> --lat 39.99 --lng 116.48 [--place '三里屯']");
   const result = await checkin({
     lat: +f.lat,
     lng: +f.lng,
@@ -111,7 +111,7 @@ export async function handleCheckin(f) {
 }
 
 export async function handleMatches(f) {
-  if (!f.id) return console.error("Usage: antenna matches --id telegram:123");
+  if (!f.id) return console.error("Usage: antenna matches --id <platform>:<user_id>");
   const result = await checkMatches({ device_id: f.id });
   if (!result.mutual_matches.length && !result.incoming_accepts.length) {
     return console.log(result.message);
@@ -131,7 +131,7 @@ export async function handleMatches(f) {
 }
 
 export async function handleDiscover(f) {
-  if (!f.id) return console.error("Usage: antenna discover --id telegram:123");
+  if (!f.id) return console.error("Usage: antenna discover --id <platform>:<user_id>");
   const result = await discover({ device_id: f.id });
   if (result.count === 0) return console.log(result.message || "🌍 No global recommendation available right now.");
   console.log(`🌍 Global discover:\n`);
@@ -162,7 +162,7 @@ export async function handleEvent(f) {
   }
 
   if (f.end) {
-    if (!f.code || !f.id) return console.error("Usage: antenna event --end --code abc123 --id telegram:123");
+    if (!f.code || !f.id) return console.error("Usage: antenna event --end --code abc123 --id <platform>:<user_id>");
     const result = await endEvent({ code: f.code, device_id: f.id });
     if (result.ended) {
       console.log(`\n✅ Event ended.\n`);
@@ -173,15 +173,15 @@ export async function handleEvent(f) {
   }
 
   if (f.checkin) {
-    if (!f.code || !f.id) return console.error("Usage: antenna event --checkin --code abc123 --id telegram:123 [--lat 34.05 --lng -118.24]");
+    if (!f.code || !f.id) return console.error("Usage: antenna event --checkin --code abc123 --id <platform>:<user_id> [--lat 34.05 --lng -118.24]");
     const result = await eventCheckin({ code: f.code, device_id: f.id, lat: f.lat ? +f.lat : undefined, lng: f.lng ? +f.lng : undefined });
     console.log(`\n✅ Checked in to event.\n`);
     return;
   }
 
   if (f.create || (!f.join && !f.scan && !f.end && !f.update && !f.approve && !f.reject && !f['add-host'] && f.name)) {
-    if (!f.name) return console.error("Usage: antenna event --create --name 'AI Meetup' --id telegram:123 --starts-at '2026-04-19T14:00' --ends-at '2026-04-19T18:00' [--lat 34.05 --lng -118.25] [--desc 'description'] [--og-image 'url'] [--requires-approval] [--screening-questions 'Q1|Q2']");
-    if (!f.id) return console.error("❌ --id is required (e.g. --id telegram:123). Creator identity needed to manage the event.");
+    if (!f.name) return console.error("Usage: antenna event --create --name 'AI Meetup' --id <platform>:<user_id> --starts-at '2026-04-19T14:00' --ends-at '2026-04-19T18:00' [--lat 34.05 --lng -118.25] [--desc 'description'] [--og-image 'url'] [--requires-approval] [--screening-questions 'Q1|Q2']");
+    if (!f.id) return console.error("❌ --id is required (e.g. --id <platform>:<user_id>). Creator identity needed to manage the event.");
     if (!f['starts-at'] || !f['ends-at']) return console.error("❌ --starts-at and --ends-at are required. Example: --starts-at '2026-04-19T14:00' --ends-at '2026-04-19T18:00'");
     const result = await createEvent({ name: f.name, device_id: f.id, lat: f.lat ? +f.lat : undefined, lng: f.lng ? +f.lng : undefined, starts_at: f['starts-at'], ends_at: f['ends-at'], description: f.desc || undefined, og_image: f['og-image'] || undefined, requires_approval: f['requires-approval'] === true || f['requires-approval'] === 'true' || undefined, screening_questions: f['screening-questions'] ? f['screening-questions'].split('|') : undefined });
     console.log(`\n🎉 Event created!\n`);
@@ -193,7 +193,7 @@ export async function handleEvent(f) {
   }
 
   if (f.join) {
-    if (!f.code || !f.id) return console.error("Usage: antenna event --join --code abc123 --id telegram:123");
+    if (!f.code || !f.id) return console.error("Usage: antenna event --join --code abc123 --id <platform>:<user_id>");
     const result = await joinEvent({ code: f.code, device_id: f.id, lat: f.lat ? +f.lat : undefined, lng: f.lng ? +f.lng : undefined, application_context: f['application-context'] || undefined });
     if (result.joined) {
       if (result.status === 'pending') {
@@ -213,7 +213,7 @@ export async function handleEvent(f) {
   }
 
   if (f.scan) {
-    if (!f.code) return console.error("Usage: antenna event --scan --code abc123 [--id telegram:123]");
+    if (!f.code) return console.error("Usage: antenna event --scan --code abc123 [--id <platform>:<user_id>]");
     const result = await eventScan({ code: f.code, device_id: f.id || null });
     if (result.count === 0) return console.log("\n🏟️ No participants yet.\n");
     console.log(`\n🏟️ ${result.count} joined, ${result.checked_in_count || 0} checked in:\n`);
@@ -230,7 +230,7 @@ export async function handleEvent(f) {
   }
 
   if (f.approve) {
-    if (!f.code || !f.id || !f.ref) return console.error("Usage: antenna event --approve --code abc123 --id telegram:123 --ref 1");
+    if (!f.code || !f.id || !f.ref) return console.error("Usage: antenna event --approve --code abc123 --id <platform>:<user_id> --ref 1");
     const result = await approveParticipant({ code: f.code, device_id: f.id, ref: f.ref });
     if (result.approved) {
       console.log("\n✅ Participant approved\n");
@@ -241,7 +241,7 @@ export async function handleEvent(f) {
   }
 
   if (f.reject) {
-    if (!f.code || !f.id || !f.ref) return console.error("Usage: antenna event --reject --code abc123 --id telegram:123 --ref 1");
+    if (!f.code || !f.id || !f.ref) return console.error("Usage: antenna event --reject --code abc123 --id <platform>:<user_id> --ref 1");
     const result = await rejectParticipant({ code: f.code, device_id: f.id, ref: f.ref });
     if (result.rejected) {
       console.log("\n✅ Participant rejected\n");
@@ -252,7 +252,7 @@ export async function handleEvent(f) {
   }
 
   if (f.update) {
-    if (!f.code || !f.id) return console.error("Usage: antenna event --update --code abc123 --id telegram:123 [--name 'New Name'] [--desc 'New desc']");
+    if (!f.code || !f.id) return console.error("Usage: antenna event --update --code abc123 --id <platform>:<user_id> [--name 'New Name'] [--desc 'New desc']");
     const result = await updateEvent({ code: f.code, device_id: f.id, name: f.name, description: f.desc, og_image: f['og-image'], lat: f.lat ? +f.lat : undefined, lng: f.lng ? +f.lng : undefined, starts_at: f['starts-at'], ends_at: f['ends-at'] });
     if (result.updated) {
       console.log("\n✅ Event updated\n");
@@ -263,7 +263,7 @@ export async function handleEvent(f) {
   }
 
   if (f['add-host']) {
-    if (!f.code || !f.id || !f.ref) return console.error("Usage: antenna event --add-host --code abc123 --id telegram:123 --ref 1");
+    if (!f.code || !f.id || !f.ref) return console.error("Usage: antenna event --add-host --code abc123 --id <platform>:<user_id> --ref 1");
     const result = await addCohost({ code: f.code, device_id: f.id, ref: f.ref });
     if (result.added) {
       console.log("\n✅ Co-host added\n");
@@ -274,16 +274,16 @@ export async function handleEvent(f) {
   }
 
   console.log(`Usage:
-  antenna event --create --name 'AI Meetup' --starts-at '...' --ends-at '...' [--id telegram:123] [--lat 34.05 --lng -118.25] [--desc 'description'] [--og-image 'url'] [--requires-approval] [--screening-questions 'Q1|Q2']
-  antenna event --join --code abc123 --id telegram:123
-  antenna event --scan --code abc123 [--id telegram:123]
-  antenna event --checkin --code abc123 --id telegram:123 [--lat 34.05 --lng -118.24]
-  antenna event --end --code abc123 --id telegram:123
+  antenna event --create --name 'AI Meetup' --starts-at '...' --ends-at '...' [--id <platform>:<user_id>] [--lat 34.05 --lng -118.25] [--desc 'description'] [--og-image 'url'] [--requires-approval] [--screening-questions 'Q1|Q2']
+  antenna event --join --code abc123 --id <platform>:<user_id>
+  antenna event --scan --code abc123 [--id <platform>:<user_id>]
+  antenna event --checkin --code abc123 --id <platform>:<user_id> [--lat 34.05 --lng -118.24]
+  antenna event --end --code abc123 --id <platform>:<user_id>
   antenna event --upload-image --code abc123 --file /path/to/image.png`);
 }
 
 export async function handleBind(f) {
-  if (!f.id) return console.error("Usage: antenna bind --id telegram:123");
+  if (!f.id) return console.error("Usage: antenna bind --id <platform>:<user_id>");
   const result = await createBindToken({ device_id: f.id });
   console.log("\n🔗 GPS Binding Link:\n");
   console.log(`  ${result.url}\n`);
@@ -292,8 +292,8 @@ export async function handleBind(f) {
 }
 
 export async function handlePass(f) {
-  if (!f.id) return console.error("Usage: antenna pass --id telegram:123 --target telegram:789");
-  if (!f.target && !f.ref) return console.error("Usage: antenna pass --id telegram:123 --target telegram:789 (or --ref 1)");
+  if (!f.id) return console.error("Usage: antenna pass --id <platform>:<user_id> --target <ref_or_device_id>");
+  if (!f.target && !f.ref) return console.error("Usage: antenna pass --id <platform>:<user_id> --target <ref_or_device_id> (or --ref 1)");
   const result = await passUser({
     device_id: f.id,
     target_device_id: f.target,
@@ -308,7 +308,7 @@ export async function handleSetup(f) {
 
   console.log("\n📡 Antenna Setup — 创建你的名片\n");
 
-  const id = f.id || await ask("Your device ID (e.g. telegram:123): ");
+  const id = f.id || await ask("Your device ID (e.g. discord:12345, hermes:myname): ");
   if (!id) { rl.close(); return console.error("Device ID is required."); }
 
   const name = await ask("Display name: ");
@@ -499,7 +499,7 @@ export function handleInstallHermesPlugin() {
 export async function handleWatch(f) {
   const id = f.id;
   if (!id) {
-    console.error("❌ --id required (e.g. --id telegram:123)");
+    console.error("❌ --id required (e.g. --id <platform>:<user_id>)");
     process.exit(1);
   }
 
@@ -870,19 +870,19 @@ export function printHelp() {
   console.log(`📡 Antenna — nearby people discovery
 
 Usage:
-  antenna scan       --lat 39.99 --lng 116.48 [--radius 500] (max 1000) [--id telegram:123]
-  antenna checkin    --id telegram:123 --lat 39.99 --lng 116.48
-  antenna profile    --id telegram:123 [--name Yi --emoji 🦦 --line1 '...']
-  antenna accept     --id telegram:123 --target telegram:789 [--contact 'WeChat: yi']
-  antenna pass       --id telegram:123 --target telegram:789 (or --ref 1)
-  antenna matches    --id telegram:123
-  antenna discover   --id telegram:123
-  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 telegram:123 | --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 watch       --id telegram:123 [--push hermes|openclaw|terminal]  Watch for new matches in real-time (Ctrl+C to stop)
-  antenna bind       --id telegram:123
+  antenna scan       --lat 39.99 --lng 116.48 [--radius 500] (max 1000) [--id <platform>:<user_id>]
+  antenna checkin    --id <platform>:<user_id> --lat 39.99 --lng 116.48
+  antenna profile    --id <platform>:<user_id> [--name Yi --emoji 🦦 --line1 '...']
+  antenna accept     --id <platform>:<user_id> --target <ref_or_device_id> [--contact 'WeChat: yi']
+  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 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 watch       --id <platform>:<user_id> [--push hermes|openclaw|terminal]  Watch for new matches in real-time (Ctrl+C to stop)
+  antenna bind       --id <platform>:<user_id>
   antenna serve      Start MCP server (stdio transport)
-  antenna setup      Interactive profile setup [--id telegram:123]
-  antenna status     Show config & status [--id telegram:123]
+  antenna setup      Interactive profile setup [--id <platform>:<user_id>]
+  antenna status     Show config & status [--id <platform>:<user_id>]
   antenna install-skill    Install SKILL.md (detects OpenClaw + Hermes)
   antenna install-plugin   Copy OpenClaw plugin template to cwd
   antenna install-hermes   One-step Hermes setup (Plugin + Skill + deps)

package/lib/core.js

@@ -146,7 +146,7 @@ export async function scan({ lat, lng, radius_m = 500, device_id, supabaseUrl, s
       radius_m,
       profiles: [],
       _ref_map: {},
-      message: `附近暂时没人，今天的全球推荐已经用完了。明天再来！`,
+      message: `附近暂时没人，今天的全球推荐也用完了。明天再来！提示：Antenna 每天有 1 次全球推荐（antenna_discover），下次可以试试。`,
     };
   }
 

package/lib/hermes-plugin/__init__.py

@@ -197,7 +197,7 @@ def register(ctx):
                 if resp.data:
                     for evt in resp.data:
                         hints.append(
-                            f"[Antenna] 📡 用户 {evt['device_id']} 通过网页分享了位置 "
+                            f"[Antenna] 📡 有用户通过网页分享了位置 "
                             f"({evt['lat']}, {evt['lng']})。"
                             f"请使用 antenna_scan 查看附近有谁。"
                         )

package/lib/hermes-plugin/schemas.py

@@ -21,10 +21,14 @@ SCAN_SCHEMA = {
             },
             "channel": {
                 "type": "string",
-                "description": "Platform name (telegram, discord, etc.)",
+                "description": "Platform name (any platform: telegram, discord, webchat, signal, slack, etc.)",
+            },
+            "chat_id": {
+                "type": "string",
+                "description": "REQUIRED for notifications. Pass chat/channel ID from message context.",
             },
         },
-        "required": ["sender_id", "channel"],
+        "required": ["sender_id", "channel", "chat_id"],
     },
 }
 
@@ -51,8 +55,9 @@ PROFILE_SCHEMA = {
             "line2": {"type": "string", "description": "What you're into"},
             "line3": {"type": "string", "description": "What you're looking for"},
             "visible": {"type": "boolean", "description": "Visible to others"},
+            "matching_context": {"type": "string", "description": "Free-form context for AI matching (interests, goals, etc.)"},
         },
-        "required": ["action", "sender_id", "channel"],
+        "required": ["action", "sender_id", "channel", "chat_id"],
     },
 }
 
@@ -81,7 +86,7 @@ ACCEPT_SCHEMA = {
                 "description": "Contact info to share (e.g. 'WeChat: yi')",
             },
         },
-        "required": ["sender_id", "channel"],
+        "required": ["sender_id", "channel", "chat_id"],
     },
 }
 
@@ -103,7 +108,7 @@ CHECKIN_SCHEMA = {
                 "description": "Name of the place (optional)",
             },
         },
-        "required": ["lat", "lng", "sender_id", "channel"],
+        "required": ["lat", "lng", "sender_id", "channel", "chat_id"],
     },
 }
 
@@ -119,7 +124,7 @@ CHECK_MATCHES_SCHEMA = {
             "channel": {"type": "string"},
             "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
         },
-        "required": ["sender_id", "channel"],
+        "required": ["sender_id", "channel", "chat_id"],
     },
 }
 
@@ -137,7 +142,7 @@ BIND_SCHEMA = {
             "purpose": {"type": "string", "description": "'profile' (default) or 'event'"},
             "event_code": {"type": "string", "description": "Event code (when purpose=event)"},
         },
-        "required": ["sender_id", "channel"],
+        "required": ["sender_id", "channel", "chat_id"],
     },
 }
 
@@ -148,7 +153,8 @@ PASS_SCHEMA = {
         "type": "object",
         "properties": {
             "sender_id": {"type": "string", "description": "The sender's user ID"},
-            "channel": {"type": "string", "description": "Platform name"},
+            "channel": {"type": "string", "description": "Platform name (any platform works)"},
+            "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
             "ref": {
                 "type": "string",
                 "description": "Ref number from scan/discover results (e.g. '1')",
@@ -158,7 +164,7 @@ PASS_SCHEMA = {
                 "description": "Device ID (use ref instead when possible)",
             },
         },
-        "required": ["sender_id", "channel"],
+        "required": ["sender_id", "channel", "chat_id"],
     },
 }
 
@@ -172,9 +178,10 @@ DISCOVER_SCHEMA = {
         "type": "object",
         "properties": {
             "sender_id": {"type": "string", "description": "The sender's user ID"},
-            "channel": {"type": "string", "description": "Platform name"},
+            "channel": {"type": "string", "description": "Platform name (any platform works)"},
+            "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
         },
-        "required": ["sender_id", "channel"],
+        "required": ["sender_id", "channel", "chat_id"],
     },
 }
 
@@ -189,7 +196,7 @@ EVENT_CREATE_SCHEMA = {
         "properties": {
             "name": {"type": "string", "description": "Event name"},
             "sender_id": {"type": "string", "description": "The sender's user ID"},
-            "channel": {"type": "string", "description": "Platform name"},
+            "channel": {"type": "string", "description": "Platform name (any platform works)"},
             "lat": {"type": "number", "description": "Event latitude"},
             "lng": {"type": "number", "description": "Event longitude"},
             "starts_at": {"type": "string", "description": "Start time ISO (required)"},
@@ -198,8 +205,9 @@ EVENT_CREATE_SCHEMA = {
             "og_image": {"type": "string", "description": "OG image URL for social sharing"},
             "requires_approval": {"type": "boolean", "description": "Require host approval to join (default false)"},
             "screening_questions": {"type": "array", "items": {"type": "string"}, "description": "Screening questions for applicants"},
+            "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
         },
-        "required": ["name", "sender_id", "channel", "starts_at", "ends_at"],
+        "required": ["name", "sender_id", "channel", "starts_at", "ends_at", "chat_id"],
     },
 }
 
@@ -211,12 +219,13 @@ EVENT_JOIN_SCHEMA = {
         "properties": {
             "code": {"type": "string", "description": "Event code"},
             "sender_id": {"type": "string", "description": "The sender's user ID"},
-            "channel": {"type": "string", "description": "Platform name"},
+            "channel": {"type": "string", "description": "Platform name (any platform works)"},
             "lat": {"type": "number", "description": "Latitude (optional, for auto-checkin)"},
             "lng": {"type": "number", "description": "Longitude (optional, for auto-checkin)"},
             "application_context": {"type": "string", "description": "Application context from screening conversation"},
+            "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
         },
-        "required": ["code", "sender_id", "channel"],
+        "required": ["code", "sender_id", "channel", "chat_id"],
     },
 }
 
@@ -228,9 +237,10 @@ EVENT_SCAN_SCHEMA = {
         "properties": {
             "code": {"type": "string", "description": "Event code"},
             "sender_id": {"type": "string", "description": "The sender's user ID"},
-            "channel": {"type": "string", "description": "Platform name"},
+            "channel": {"type": "string", "description": "Platform name (any platform works)"},
+            "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
         },
-        "required": ["code", "sender_id", "channel"],
+        "required": ["code", "sender_id", "channel", "chat_id"],
     },
 }
 
@@ -242,9 +252,10 @@ EVENT_END_SCHEMA = {
         "properties": {
             "code": {"type": "string", "description": "Event code"},
             "sender_id": {"type": "string", "description": "The sender's user ID"},
-            "channel": {"type": "string", "description": "Platform name"},
+            "channel": {"type": "string", "description": "Platform name (any platform works)"},
+            "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
         },
-        "required": ["code", "sender_id", "channel"],
+        "required": ["code", "sender_id", "channel", "chat_id"],
     },
 }
 
@@ -270,11 +281,12 @@ EVENT_CHECKIN_SCHEMA = {
         "properties": {
             "code": {"type": "string", "description": "Event code"},
             "sender_id": {"type": "string", "description": "The sender's user ID"},
-            "channel": {"type": "string", "description": "Platform name"},
+            "channel": {"type": "string", "description": "Platform name (any platform works)"},
             "lat": {"type": "number", "description": "Latitude (optional)"},
             "lng": {"type": "number", "description": "Longitude (optional)"},
+            "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
         },
-        "required": ["code", "sender_id", "channel"],
+        "required": ["code", "sender_id", "channel", "chat_id"],
     },
 }
 
@@ -296,7 +308,7 @@ EVENT_UPDATE_SCHEMA = {
             "starts_at": {"type": "string"},
             "ends_at": {"type": "string"},
         },
-        "required": ["code", "sender_id", "channel"],
+        "required": ["code", "sender_id", "channel", "chat_id"],
     },
 }
 
@@ -312,7 +324,7 @@ EVENT_APPROVE_SCHEMA = {
             "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
             "ref": {"type": "string"},
         },
-        "required": ["code", "sender_id", "channel", "ref"],
+        "required": ["code", "sender_id", "channel", "ref", "chat_id"],
     },
 }
 
@@ -328,7 +340,7 @@ EVENT_REJECT_SCHEMA = {
             "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
             "ref": {"type": "string"},
         },
-        "required": ["code", "sender_id", "channel", "ref"],
+        "required": ["code", "sender_id", "channel", "ref", "chat_id"],
     },
 }
 
@@ -344,6 +356,6 @@ EVENT_ADD_HOST_SCHEMA = {
             "chat_id": {"type": "string", "description": "REQUIRED for notifications. Pass chat/channel ID from message context."},
             "ref": {"type": "string"},
         },
-        "required": ["code", "sender_id", "channel", "ref"],
+        "required": ["code", "sender_id", "channel", "ref", "chat_id"],
     },
 }

package/lib/hermes-plugin/tools.py

@@ -85,7 +85,7 @@ def handle_scan(params: dict) -> str:
     # Rate limit
     now = time.time()
     if did in _last_scan and now - _last_scan[did] < SCAN_DEBOUNCE_S:
-        return _ok({"nearby": [], "message": "刚刚才扫描过，稍等一会儿再试。", "rate_limited": True})
+        return _ok({"profiles": [], "message": "刚刚才扫描过，稍等一会儿再试。", "rate_limited": True})
     _last_scan[did] = now
 
     lat = params.get("lat")
@@ -99,7 +99,7 @@ def handle_scan(params: dict) -> str:
             lat = loc["lat"]
             lng = loc["lng"]
         else:
-            return _ok({"nearby": [], "message": "还没有位置信息。请先通过链接分享位置，或者发送位置消息。"})
+            return _ok({"profiles": [], "message": "还没有位置信息。请先通过链接分享位置，或者发送位置消息。"})
 
     flat, flng = _fuzzy(lat, lng)
 
@@ -111,7 +111,7 @@ def handle_scan(params: dict) -> str:
     others = [p for p in (resp.data or []) if p.get("device_id") != did]
 
     if not others:
-        return _ok({"nearby": [], "message": f"在 {radius}m 范围内没有发现其他人。"})
+        return _ok({"profiles": [], "message": f"在 {radius}m 范围内没有发现其他人。"})
 
     # Build ref mapping — never expose device_id to agent/user
     global _last_ref_map
@@ -131,8 +131,8 @@ def handle_scan(params: dict) -> str:
         })
 
     return _ok({
-        "nearby": profiles,
-        "total": len(others),
+        "profiles": profiles,
+        "count": len(others),
         "radius_m": radius,
         "instruction": "根据你对用户的了解，判断哪些人值得推荐，为每个推荐写一句个性化的匹配理由。使用 ref 编号（如 '1', '2')来引用人员，不要显示 device_id。",
     })
@@ -149,7 +149,7 @@ def handle_profile(params: dict) -> str:
         return _ok({"exists": True, "profile": resp.data})
 
     # set
-    resp = sb.rpc("upsert_profile", {
+    rpc_params = {
         "p_device_id": did,
         "p_display_name": params.get("display_name"),
         "p_emoji": params.get("emoji"),
@@ -157,7 +157,10 @@ def handle_profile(params: dict) -> str:
         "p_line2": params.get("line2"),
         "p_line3": params.get("line3"),
         "p_visible": params.get("visible", True),
-    }).execute()
+    }
+    if params.get("matching_context") is not None:
+        rpc_params["p_matching_context"] = params["matching_context"]
+    resp = sb.rpc("upsert_profile", rpc_params).execute()
 
     if resp.data:
         return _ok({"updated": True, "profile": resp.data, "next_step": "IMPORTANT: Now call antenna_bind to generate a GPS link for the user. Do not skip this."})
@@ -225,43 +228,37 @@ def handle_check_matches(params: dict) -> str:
     sb = _sb()
     did = _device_id(params["sender_id"], params["channel"], params.get("chat_id"))
 
-    resp = sb.rpc("get_my_matches", {"p_device_id": did}).execute()
-    all_matches = resp.data or []
+    resp = sb.rpc("get_my_matches_with_profiles", {"p_device_id": did}).execute()
+    data = resp.data or {}
 
-    if not all_matches:
-        return _ok({"mutual_matches": [], "incoming_accepts": [], "message": "目前没有进行中的匹配。"})
+    raw_mutual = data.get("mutual_matches") or []
+    raw_incoming = data.get("incoming_accepts") or []
 
-    my = [m for m in all_matches if m.get("device_id_a") == did]
-    incoming = [m for m in all_matches if m.get("device_id_b") == did]
+    if not raw_mutual and not raw_incoming:
+        return _ok({"mutual_matches": [], "incoming_accepts": [], "message": "目前没有进行中的匹配。"})
 
-    # Mutual
     mutual = []
-    for m in my:
-        rev = next((i for i in incoming if i.get("device_id_a") == m.get("device_id_b")), None)
-        if rev:
-            prof = sb.rpc("get_profile", {"p_device_id": m["device_id_b"]}).execute()
-            p = prof.data or {}
-            mutual.append({
-                "device_id": m["device_id_b"],
-                "name": p.get("display_name") or "匿名",
-                "emoji": p.get("emoji") or "👤",
-                "their_contact": rev.get("contact_info_a"),
-                "you_shared": m.get("contact_info_a"),
-            })
-
-    # Incoming only
+    for i, m in enumerate(raw_mutual):
+        mutual.append({
+            "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"),
+        })
+
     inc_only = []
-    for m in incoming:
-        already = next((x for x in my if x.get("device_id_b") == m.get("device_id_a")), None)
-        if not already:
-            prof = sb.rpc("get_profile", {"p_device_id": m["device_id_a"]}).execute()
-            p = prof.data or {}
-            inc_only.append({
-                "device_id": m["device_id_a"],
-                "name": p.get("display_name") or "匿名",
-                "emoji": p.get("emoji") or "👤",
-                "line1": p.get("line1"),
-            })
+    for i, m in enumerate(raw_incoming):
+        inc_only.append({
+            "ref": str(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"),
+        })
 
     msgs = []
     if mutual:
@@ -292,7 +289,7 @@ def handle_pass(params: dict) -> str:
     if not target and ref:
         # Try resolve via RPC
         try:
-            resp = sb.rpc("resolve_ref", {"p_device_id": did, "p_ref": ref}).execute()
+            resp = sb.rpc("resolve_ref", {"p_owner": did, "p_ref": ref}).execute()
             if resp.data:
                 target = resp.data.get("target_device_id")
         except Exception:
@@ -302,7 +299,7 @@ def handle_pass(params: dict) -> str:
 
     sb.rpc("pass_user", {
         "p_device_id": did,
-        "p_target_device_id": target,
+        "p_passed_device_id": target,
     }).execute()
 
     return _ok({"passed": True, "message": "已跳过，不会再推荐这个人了。"})
@@ -327,9 +324,11 @@ def handle_discover(params: dict) -> str:
     my_data = my_prof.data or {}
     my_lines = [my_data.get("line1", ""), my_data.get("line2", ""), my_data.get("line3", "")]
 
+    ref_map = {}
     for i, p in enumerate(results):
         ref = str(i + 1)
         _last_ref_map[ref] = p.get("device_id")
+        ref_map[ref] = p.get("device_id")
 
         their_lines = [p.get("line1", ""), p.get("line2", ""), p.get("line3", "")]
 
@@ -359,6 +358,17 @@ def handle_discover(params: dict) -> str:
             profile["match_reason"] = match_reason
         profiles.append(profile)
 
+    # Save refs and log recommendations
+    try:
+        sb.rpc("save_scan_refs", {"p_owner": did, "p_refs": ref_map}).execute()
+    except Exception:
+        pass
+    for p in results:
+        try:
+            sb.rpc("log_recommendation", {"p_device_id": did, "p_recommended_id": p["device_id"]}).execute()
+        except Exception:
+            pass
+
     return _ok({
         "count": len(profiles),
         "profiles": profiles,
@@ -499,7 +509,6 @@ def handle_event_scan(params: dict) -> str:
     if not others:
         return _ok({"count": 0, "profiles": [], "message": "活动里还没有其他人。"})
 
-    global _last_ref_map
     global _last_ref_map
     _last_ref_map = {}
     checked_in_count = 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antenna-fyi",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Antenna — nearby people discovery. CLI + MCP server + OpenClaw skill & plugin, all in one package.",
   "type": "module",
   "bin": {

package/skill/SKILL.md

@@ -10,7 +10,7 @@ You have access to Antenna for location-based social discovery.
 
 **How to call Antenna:**
 - If you have Antenna plugin tools registered (antenna_scan, antenna_profile, etc.) — use them directly.
-- If not, use CLI: `antenna <command> [flags]`. Example: `antenna scan --id telegram:123`. The CLI supports all the same features.
+- If not, use CLI: `antenna <command> [flags]`. Example: `antenna scan --id <platform>:<user_id>`. The CLI supports all the same features.
 - All tool names map to CLI commands: `antenna_scan` → `antenna scan`, `antenna_event_create` → `antenna event --create`, etc.
 - **Always pass `chat_id`** when calling any Antenna tool. This is the chat/channel ID from your message context (e.g. Discord channel ID, Telegram chat ID). Antenna uses it to send you notifications about matches and event approvals.
 
@@ -230,7 +230,7 @@ Source code is open: https://github.com/H1an1/Antenna
 > "最后——你想被叫什么？再选个 emoji 代表你自己。"
 
 **第六步：确认**
-把名片组装好，展示给用户确认：
+把名片组装好，**确认三行都有内容后**展示给用户确认：
 > 你的名片：
 >
 > 🎸 **小林**
@@ -240,7 +240,8 @@ Source code is open: https://github.com/H1an1/Antenna
 >
 > 看看有没有要改的？OK 的话我就存了。
 
-用户说 OK → `antenna_profile` action="set" 保存。
+用户说 OK → **检查 line1、line2、line3 都不为空后** 调 `antenna_profile` action="set" 保存。
+如果某一行为空，先问用户补完再保存。后端会拒绝没有 line1 的新 profile，并对缺失的 line2/line3 返回 warning。
 用户说要改 → 改完再确认。
 
 **关键原则：**
@@ -253,6 +254,10 @@ Source code is open: https://github.com/H1an1/Antenna
 
 ### Showing results — 你来判断，不是服务器
 
+**第一次 scan 的新用户：** 简短一句解释："这是附近的人。Antenna 基于 AI 匹配，看到感兴趣的人 accept，双向匹配后交换联系方式。"
+
+**Profile 不完整时：** 如果用户的 profile 只有 1 行，提示："你的名片只填了一行，补完后匹配质量会更好。要现在补吗？"
+
 `antenna_scan` 返回的是附近所有人的名片，**没有打分、没有预匹配**。你需要：
 
 **全球推荐 fallback：** 如果 scan 结果里有 `global: true`，说明附近没人，这些是全球推荐。告诉用户“附近暂时没人，但全球有这几个有意思的人”，然后正常推荐。用户仍然可以 accept。
@@ -261,7 +266,7 @@ Source code is open: https://github.com/H1an1/Antenna
 2. 结合你对用户的全部了解，判断谁值得推荐
 3. 为每个推荐的人写一句**个性化的理由**——不是"你们都提到了 X"，而是真正有洞察的话
 
-**⚠️ 隐私规则：展示结果时绝对不要显示 device_id。** `device_id`（如 `telegram:koji1986`）是内部标识符，包含用户的平台和 ID，属于隐私信息。只显示 emoji + 名字 + 三句话 + 你写的匹配理由。`device_id` 只在内部调 `antenna_accept` 时用，不要展示给用户。
+**⚠️ 隐私规则：展示结果时绝对不要显示 device_id。** `device_id`（如 `platform:user123`）是内部标识符，包含用户的平台和 ID，属于隐私信息。只显示 emoji + 名字 + 三句话 + 你写的匹配理由。`device_id` 只在内部调 `antenna_accept` 时用，不要展示给用户。
 
 比如你知道用户最近在学吉他，看到附近有人写"组乐队找吉他手"：
 > 🎸 **小林** — 在组后摇乐队，找吉他手
@@ -296,7 +301,7 @@ Use `antenna_check_matches` when:
 
 ### Privacy
 - Never reveal exact coordinates to other users
-- **Never show device_id to users** (e.g. `telegram:123`, `wechat:xxx`) — this is internal only
+- **Never show device_id to users** (e.g. `telegram:12345`, `discord:67890`) — this is internal only
 - Never share someone's platform or username with another user
 - Only show the profile info (name, emoji, three lines)
 - Contact info is only shared when the user explicitly agrees
@@ -376,7 +381,7 @@ Update event info. Only creator or co-host can update.
 - `code`: event code
 - `sender_id`, `channel`: from context
 - `chat_id`: REQUIRED for notifications
-- `name`, `description`, `og_image`, `lat`, `lng`, `starts_at`, `ends_at`: all optional, only provided fields are updated
+- `name`, `description`, `og_image`, `lat`, `lng`, `starts_at`, `ends_at`: all optional for update (only provided fields change, others stay as-is)
 
 ### `antenna_event_approve`
 Approve a pending participant. Only creator or co-host.

package/skill/EVENTS.md

@@ -1,112 +0,0 @@
----
-name: antenna-events
-description: "Antenna Event Mode — create events, manage participants, GPS check-in. Use when a user wants to create an event, join an event, check in, scan event participants, or manage event settings."
-tools:
-  - antenna_event_create
-  - antenna_event_join
-  - antenna_event_scan
-  - antenna_event_end
-  - antenna_event_checkin
-  - antenna_event_upload_image
-  - antenna_bind
----
-
-# Antenna Event Mode
-
-Create real-world events where everyone's AI agent handles the networking.
-
-## Quick Start
-
-1. **Create**: `antenna_event_create(name, description)` → get shareable link
-2. **Share**: Send `antenna.fyi/events/CODE` to attendees
-3. **Join**: Attendees' agents call `antenna_event_join(code)`
-4. **Check in**: At the venue, `antenna_event_checkin(code)` — GPS verified ≤1km
-5. **Discover**: `antenna_event_scan(code)` — no distance limit inside events
-
-## Tools
-
-### `antenna_event_create`
-Create an event. Returns a shareable link (antenna.fyi/events/CODE).
-- `name`: event name
-- `sender_id`, `channel`: from context
-- `lat`, `lng`: optional event location
-- `starts_at`, `ends_at`: optional time range (default: now to +12h)
-- `description`: optional event description
-- `og_image`: optional OG image URL for social sharing preview
-- `requires_approval`: boolean, default false. If true, participants must be approved by the organizer before they become visible.
-- `screening_questions`: string array. Questions to ask applicants. Agent should collect answers via conversation and submit as `application_context` when joining.
-
-**When the user says anything about "审批" / "approval" / "筛选" / "报名表"**, set `requires_approval: true` and ask what screening questions they want.
-
-**GPS flow for events:** If the user doesn't provide coordinates, generate a bind link (`antenna_bind` with `purpose="event"` and `event_code`) and ask them to open it at the event location. The GPS will update the event's coordinates, NOT the user's profile.
-
-### `antenna_event_join`
-Join an event by code. Auto-checks in if event already started and user GPS is within 1km.
-- `code`: from the event URL (antenna.fyi/events/CODE)
-- `sender_id`, `channel`: from context
-- **Requires profile** — user must have a profile before joining
-- If event has started + user has GPS + within 1km → auto check-in
-
-### `antenna_event_scan`
-Scan people in an event. No distance limit — returns all participants.
-- `code`: event code
-- `sender_id`, `channel`: from context
-- Returns profiles with `checked_in` status and `role` (creator/participant)
-- Header shows "X joined, Y checked in"
-
-### `antenna_event_end`
-End an event. Only the creator can end it.
-- `code`: event code
-- `sender_id`, `channel`: from context
-
-### `antenna_event_checkin`
-Check in at an event — marks you as present at the event location.
-- `code`: event code
-- `sender_id`, `channel`: from context
-- `lat`, `lng`: optional GPS (auto-reads profile location if not provided)
-- GPS verified: must be within 1km of event location
-- Event must have GPS set for check-in to work
-
-### `antenna_event_upload_image`
-Upload an image for an event OG preview. Returns a public URL.
-- `image_base64`: base64-encoded image data
-- `content_type`: MIME type (default image/png)
-- `event_code`: event code
-
-### `antenna_bind` (for events)
-Generate a GPS link for setting event location.
-- `purpose`: set to `"event"`
-- `event_code`: the event code
-- GPS from this link writes to the event, not the user's profile
-
-## Agent Behavior
-
-### When someone says "create an event"
-Collect the following info through conversation (ask one by one, don't dump all at once):
-1. **Event name** (required) — "活动叫什么名字？"
-2. **Description** — "简单描述一下这个活动？"
-3. **Time** — "什么时候开始？大概多长？" (convert to starts_at / ends_at ISO strings)
-4. **Location** — "活动在哪里？" If user gives an address, geocode it. If vague, generate a bind link after creation.
-5. **Approval** — "需要审批参与者吗？" If yes:
-6. **Screening questions** — "你想问报名者什么问题？" Collect as a list.
-
-Then call `antenna_event_create` with all collected info.
-If no GPS, call `antenna_bind(purpose="event", event_code=CODE)` and send the link.
-Share the event URL with the user.
-
-### When someone shares an event link
-1. Extract the code from `antenna.fyi/events/CODE`
-2. Call `antenna_event_join(code)` — this checks everything:
-   - If no profile → "Create a profile first"
-   - If event requires approval and no `application_context` provided → returns `needs_screening: true` + `screening_questions` array
-   - If screening questions returned: **ask the user each question**, collect answers, then call `antenna_event_join(code, application_context="collected answers")` again
-   - If join succeeds with `status: pending` → tell user "waiting for organizer approval"
-   - If join succeeds with `status: active` → user is in!
-3. Auto check-in happens automatically if event has started + GPS within 1km
-
-### When someone says "who's here" at an event
-1. Call `antenna_event_scan(code)`
-2. Analyze profiles against what you know about the user
-3. Recommend who they should meet and why
-4. Creator appears with organizer badge
-