antenna-openclaw-plugin 1.3.1 → 1.3.3

package/index.ts

@@ -268,7 +268,7 @@ export default function register(api: any) {
         channel: { type: "string", description: "The channel name" },
         chat_id: { type: "string", description: "REQUIRED for notifications. Pass the chat/channel ID from your message context so Antenna can send you match and event notifications." },
       },
-      required: ["sender_id", "channel"],
+      required: ["sender_id", "channel", "chat_id"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
@@ -277,7 +277,7 @@ export default function register(api: any) {
       const radius = params.radius_m ?? cfg.defaultRadiusM ?? 500;
 
       if (isRateLimited(deviceId)) {
-        return ok({ nearby: [], message: "刚刚才扫描过，稍等一会儿再试。", rate_limited: true });
+        return ok({ profiles: [], message: "刚刚才扫描过，稍等一会儿再试。", rate_limited: true });
       }
 
       let lat = params.lat;
@@ -290,7 +290,7 @@ export default function register(api: any) {
           lat = loc.lat;
           lng = loc.lng;
         } else {
-          return ok({ nearby: [], message: "还没有位置信息。请先通过链接分享位置，或者发送位置消息。" });
+          return ok({ profiles: [], message: "还没有位置信息。请先通过链接分享位置，或者发送位置消息。" });
         }
       }
 
@@ -323,11 +323,11 @@ export default function register(api: any) {
             try { await supabase.rpc("log_recommendation", { p_device_id: deviceId, p_recommended_id: p.device_id }); } catch {}
           }
           return ok({
-            nearby: gProfiles, total: gProfiles.length, radius_m: radius, global: true,
+            profiles: gProfiles, count: gProfiles.length, radius_m: radius, global: true,
             message: `附近 ${radius}m 暂时没人。今天的全球推荐——这个人跟你可能聊得来。（每天 1 次）`,
           });
         }
-        return ok({ nearby: [], message: `附近暂时没人，今天的全球推荐已经用完了。明天再来！` });
+        return ok({ profiles: [], message: `附近暂时没人，今天的全球推荐已经用完了。明天再来！` });
       }
 
       // Build ref mapping — never expose device_id
@@ -353,8 +353,8 @@ export default function register(api: any) {
       } catch { /* best effort */ }
 
       return ok({
-        nearby: profiles,
-        total: others.length,
+        profiles: profiles,
+        count: others.length,
         radius_m: radius,
         instruction: "根据你对用户的了解，判断哪些人值得推荐，用 ref 编号引用。不要显示 device_id。",
       });
@@ -381,8 +381,9 @@ export default function register(api: any) {
         line2: { type: "string", description: "Second line (what you're into)" },
         line3: { type: "string", description: "Third line (what you're looking for)" },
         visible: { type: "boolean", description: "Whether to be 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"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
@@ -406,6 +407,7 @@ export default function register(api: any) {
         p_display_name: params.display_name ?? null, p_emoji: params.emoji ?? null,
         p_line1: params.line1 ?? null, p_line2: params.line2 ?? null,
         p_line3: params.line3 ?? null, p_visible: params.visible ?? true,
+        ...(params.matching_context != null ? { p_matching_context: params.matching_context } : {}),
       });
 
       if (error) return ok({ error: error.message });
@@ -436,7 +438,7 @@ export default function register(api: any) {
         chat_id: { type: "string", description: "REQUIRED for notifications. Pass the chat/channel ID from your message context so Antenna can send you match and event notifications." },
         place_name: { type: "string", description: "Optional: name of the place (for confirmation message)" },
       },
-      required: ["lat", "lng", "sender_id", "channel"],
+      required: ["lat", "lng", "sender_id", "channel", "chat_id"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
@@ -484,7 +486,7 @@ export default function register(api: any) {
         target_device_id: { type: "string", description: "Device ID (use ref instead when possible)" },
         contact_info: { type: "string", description: "Optional contact info to share" },
       },
-      required: ["sender_id", "channel"],
+      required: ["sender_id", "channel", "chat_id"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
@@ -560,7 +562,7 @@ export default function register(api: any) {
         purpose: { type: "string", description: "'profile' (default) or 'event'" },
         event_code: { type: "string", description: "Event code (required when purpose=event)" },
       },
-      required: ["sender_id", "channel"],
+      required: ["sender_id", "channel", "chat_id"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
@@ -601,7 +603,7 @@ export default function register(api: any) {
         channel: { type: "string", description: "The channel name" },
         chat_id: { type: "string", description: "REQUIRED for notifications. Pass the chat/channel ID from your message context so Antenna can send you match and event notifications." },
       },
-      required: ["sender_id", "channel"],
+      required: ["sender_id", "channel", "chat_id"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
@@ -690,7 +692,7 @@ export default function register(api: any) {
         requires_approval: { type: "boolean", description: "Require host approval to join (default false)" },
         screening_questions: { type: "array", items: { type: "string" }, description: "Screening questions for applicants" },
       },
-      required: ["name", "sender_id", "channel", "starts_at", "ends_at"],
+      required: ["name", "sender_id", "channel", "starts_at", "ends_at", "chat_id"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
@@ -698,8 +700,8 @@ export default function register(api: any) {
       const deviceId = deriveDeviceId(params.sender_id, params.channel, params.chat_id);
       const { data, error } = await supabase.rpc("create_event", {
         p_name: params.name,
-        p_lat: params.lat || null,
-        p_lng: params.lng || null,
+        p_lat: params.lat ?? null,
+        p_lng: params.lng ?? null,
         p_created_by: deviceId,
         p_starts_at: params.starts_at || null,
         p_ends_at: params.ends_at || null,
@@ -727,7 +729,7 @@ export default function register(api: any) {
         channel: { type: "string" },
         chat_id: { type: "string", description: "REQUIRED for notifications. Pass the chat/channel ID from your message context so Antenna can send you match and event notifications." },
       },
-      required: ["code", "sender_id", "channel"],
+      required: ["code", "sender_id", "channel", "chat_id"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
@@ -759,7 +761,7 @@ export default function register(api: any) {
         lng: { type: "number", description: "Longitude (optional, for auto-checkin)" },
         application_context: { type: "string", description: "Application context from screening conversation" },
       },
-      required: ["code", "sender_id", "channel"],
+      required: ["code", "sender_id", "channel", "chat_id"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
@@ -783,7 +785,7 @@ export default function register(api: any) {
         } catch {}
       }
 
-      const { data, error } = await supabase.rpc("join_event", { p_code: params.code, p_device_id: deviceId, p_application_context: params.application_context || null });
+      const { data, error } = await supabase.rpc("join_event", { p_code: params.code, p_device_id: deviceId, p_lat: lat ?? null, p_lng: lng ?? null, p_application_context: params.application_context || null });
       if (error) return ok({ error: error.message });
       if (!data?.joined) return ok(data);
 
@@ -841,7 +843,7 @@ export default function register(api: any) {
         channel: { type: "string" },
         chat_id: { type: "string", description: "REQUIRED for notifications. Pass the chat/channel ID from your message context so Antenna can send you match and event notifications." },
       },
-      required: ["code", "sender_id", "channel"],
+      required: ["code", "sender_id", "channel", "chat_id"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
@@ -881,7 +883,7 @@ export default function register(api: any) {
         ref: { type: "string", description: "Ref number from scan/discover results" },
         target_device_id: { type: "string", description: "Device ID (use ref instead when possible)" },
       },
-      required: ["sender_id", "channel"],
+      required: ["sender_id", "channel", "chat_id"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
@@ -918,7 +920,7 @@ export default function register(api: any) {
         lat: { type: "number", description: "Latitude (optional)" },
         lng: { type: "number", description: "Longitude (optional)" },
       },
-      required: ["code", "sender_id", "channel"],
+      required: ["code", "sender_id", "channel", "chat_id"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
@@ -977,60 +979,44 @@ export default function register(api: any) {
         channel: { type: "string" },
         chat_id: { type: "string", description: "REQUIRED for notifications. Pass the chat/channel ID from your message context so Antenna can send you match and event notifications." },
       },
-      required: ["sender_id", "channel"],
+      required: ["sender_id", "channel", "chat_id"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
       const supabase = getSupabase(cfg);
       const deviceId = deriveDeviceId(params.sender_id, params.channel, params.chat_id);
 
-      const { data: allMatches } = await supabase.rpc("get_my_matches", { p_device_id: deviceId });
+      const { data: result } = await supabase.rpc("get_my_matches_with_profiles", { p_device_id: deviceId });
 
-      if (!allMatches?.length) {
-        return ok({ mutual_matches: [], incoming_accepts: [], message: "目前没有进行中的匹配。" });
-      }
+      const rawMutual = result?.mutual_matches || [];
+      const rawIncoming = result?.incoming_accepts || [];
 
-      // Matches I initiated
-      const myMatches = allMatches.filter((m: any) => m.device_id_a === deviceId);
-      // Matches where someone else accepted me
-      const incomingMatches = allMatches.filter((m: any) => m.device_id_b === deviceId);
-
-      // --- Mutual matches (both sides accepted) ---
-      const mutualMatches = [];
-      for (const match of myMatches) {
-        const reverse = incomingMatches.find(
-          (m: any) => m.device_id_a === match.device_id_b
-        );
-        if (reverse) {
-          // Clean up follow-up crons for this mutual pair
-          stopFollowUpCron(deviceId, match.device_id_b, logger);
-          stopFollowUpCron(match.device_id_b, deviceId, logger);
-
-          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 || "👤",
-            line1: profile?.line1, line2: profile?.line2, line3: profile?.line3,
-            their_contact: reverse.contact_info_a || null, you_shared: match.contact_info_a || null,
-          });
-        }
+      if (!rawMutual.length && !rawIncoming.length) {
+        return ok({ mutual_matches: [], incoming_accepts: [], message: "目前没有进行中的匹配。" });
       }
 
-      // --- Incoming accepts (someone accepted me but I haven't accepted them yet) ---
-      const incomingAccepts = [];
-      for (const match of incomingMatches) {
-        const iAccepted = myMatches.find(
-          (m: any) => m.device_id_b === match.device_id_a
-        );
-        if (!iAccepted) {
-          // They accepted me but I haven't responded
-          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 || "👤",
-            line1: profile?.line1, line2: profile?.line2, line3: profile?.line3,
-          });
-        }
+      const mutualMatches = rawMutual.map((m: any, i: number) => ({
+        ref: String(i + 1),
+        _device_id: m.target_id,
+        name: m.name || "匿名",
+        emoji: m.emoji || "👤",
+        line1: m.line1, line2: m.line2, line3: m.line3,
+        their_contact: m.their_contact || null,
+        you_shared: m.you_shared || null,
+      }));
+
+      const incomingAccepts = rawIncoming.map((m: any, i: number) => ({
+        ref: String(i + 1),
+        _device_id: m.target_id,
+        name: m.name || "匿名",
+        emoji: m.emoji || "👤",
+        line1: m.line1, line2: m.line2, line3: m.line3,
+      }));
+
+      // Clean up follow-up crons for mutual matches
+      for (const m of mutualMatches) {
+        stopFollowUpCron(deviceId, m._device_id, logger);
+        stopFollowUpCron(m._device_id, deviceId, logger);
       }
 
       const messages = [];
@@ -1067,7 +1053,7 @@ export default function register(api: any) {
         starts_at: { type: "string", description: "New start time ISO" },
         ends_at: { type: "string", description: "New end time ISO" },
       },
-      required: ["code", "sender_id", "channel"],
+      required: ["code", "sender_id", "channel", "chat_id"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
@@ -1076,7 +1062,7 @@ export default function register(api: any) {
       const { data, error } = await supabase.rpc("update_event", {
         p_code: params.code, p_device_id: deviceId,
         p_name: params.name || null, p_description: params.description || null,
-        p_og_image: params.og_image || null, p_lat: params.lat || null, p_lng: params.lng || null,
+        p_og_image: params.og_image || null, p_lat: params.lat ?? null, p_lng: params.lng ?? null,
         p_starts_at: params.starts_at || null, p_ends_at: params.ends_at || null,
       });
       if (error) return ok({ error: error.message });
@@ -1099,7 +1085,7 @@ export default function register(api: any) {
         chat_id: { type: "string", description: "REQUIRED for notifications. Pass the chat/channel ID from your message context so Antenna can send you match and event notifications." },
         ref: { type: "string", description: "Ref number of the participant to approve" },
       },
-      required: ["code", "sender_id", "channel", "ref"],
+      required: ["code", "sender_id", "channel", "ref", "chat_id"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
@@ -1128,7 +1114,7 @@ export default function register(api: any) {
         chat_id: { type: "string", description: "REQUIRED for notifications. Pass the chat/channel ID from your message context so Antenna can send you match and event notifications." },
         ref: { type: "string", description: "Ref number of the participant to reject" },
       },
-      required: ["code", "sender_id", "channel", "ref"],
+      required: ["code", "sender_id", "channel", "ref", "chat_id"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
@@ -1157,7 +1143,7 @@ export default function register(api: any) {
         chat_id: { type: "string", description: "REQUIRED for notifications. Pass the chat/channel ID from your message context so Antenna can send you match and event notifications." },
         ref: { type: "string", description: "Ref number of the participant to make co-host" },
       },
-      required: ["code", "sender_id", "channel", "ref"],
+      required: ["code", "sender_id", "channel", "ref", "chat_id"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antenna-openclaw-plugin",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "Antenna — agent-mediated nearby people discovery for OpenClaw",
   "openclaw": {
     "extensions": ["./index.ts"]

package/skills/antenna/SKILL.md

@@ -4,70 +4,88 @@ description: "Nearby people discovery via Antenna. Use when a user shares locati
 metadata: { "openclaw": { "always": true } }
 ---
 
-# Antenna — Nearby People Discovery
+# Antenna - Nearby People Discovery
 
 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 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 <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.
 
-## Onboarding — 装上之后主动引导
+## Onboarding - 装上之后主动引导
 
-Plugin 安装后，agent 应该**主动**开始引导，不要等用户问"怎么用"。
+Plugin 安装后,agent 应该**主动**开始引导,不要等用户问"怎么用"。
 
 ### 流程
 
-**第一步：打招呼 + 解释**
-> "嘿，你装了 Antenna——它能帮你发现附近有意思的人。我先帮你做张名片，然后你发个位置给我，我看看附近有谁。"
+**第一步:打招呼 + 解释**
+> "嘿,你装了 Antenna--它能帮你发现附近有意思的人。我先帮你做张名片,然后你发个位置给我,我看看附近有谁。"
 
-**第二步：聊天式填名片**（见下方详细流程）
+**第二步:聊天收集 → 生成名片 → 确认**
 
-**第三步：名片存好后，立刻调 antenna_bind**
+Agent 跟用户聊几句,了解他们是谁、做什么、对什么感兴趣、想认识什么人。然后 agent 自己完成以下工作(不需要用户参与):
+- 生成 matching_context(~200 字,用于 embedding 匹配,不展示给别人)
+- 从中提炼 line1/2/3 + 选一个 emoji + display_name
 
-**这一步是强制的。** 名片保存成功后，你**必须立刻**调用 `antenna_bind` 生成链接并发给用户。不要问用户要不要，不要等用户说什么，直接调。
+然后展示名片预览给用户确认:
+> 你的名片:
+> 🦦 Yi
+> · Product Designer,做 AI 搜索体验
+> · 对 AI agent、音乐、游泳感兴趣
+> · 想认识做 AI 产品和独立创作的人
+>
+> 这样可以吗?要改哪里告诉我。
+
+用户确认后才调 `antenna_profile(action="set")` 保存(matching_context + line1/2/3 + emoji + name 一起存)。
+用户要改 → 改完重新预览 → 再确认。
+
+**不要跳过确认。名片是展示给别人看的,必须让用户看过才存。**
+
+**第三步:名片存好后,立刻调 antenna_bind**
 
-调用 `antenna_bind` 生成链接，发给用户：
-> "名片存好了 ✅ 点这个链接，在手机浏览器打开，允许定位就行：
+**这一步是强制的。** 名片保存成功后,你**必须立刻**调用 `antenna_bind` 生成链接并发给用户。不要问用户要不要,不要等用户说什么,直接调。
+
+调用 `antenna_bind` 生成链接,发给用户:
+> "名片存好了 ✅ 点这个链接,在手机浏览器打开,允许定位就行:
 > [链接]
 > 我收到你的位置后会自动帮你看看附近有谁。"
 
-备选：如果用户在 Telegram/WhatsApp 里，也可以直接发位置消息。但优先用链接。
+备选:如果用户在 Telegram/WhatsApp 里,也可以直接发位置消息。但优先用链接。
 
-**⚠️ 如果你保存了名片但没有调 antenna_bind，你就没有完成 onboarding。**
+**⚠️ 如果你保存了名片但没有调 antenna_bind,你就没有完成 onboarding。**
 
-**第四步：设置匹配检查定时任务**
+**第四步:设置匹配检查定时任务**
 
-onboarding 完成后，帮用户设置一个每小时自动检查匹配的 cron 任务，这样有人 accept 用户时能及时通知。
+onboarding 完成后,帮用户设置一个每小时自动检查匹配的 cron 任务,这样有人 accept 用户时能及时通知。
 
-如果你有 cron 能力（Hermes: `hermes cron`，OpenClaw: `openclaw cron`），创建一个定时任务：
+如果你有 cron 能力(Hermes: `hermes cron`,OpenClaw: `openclaw cron`),创建一个定时任务:
 - 每 1 小时调用 `antenna_check_matches`
-- 如果有新的 mutual match 或 incoming accept，通知用户
-- 如果没有新匹配，不打扰用户
+- 如果有新的 mutual match 或 incoming accept,通知用户
+- 如果没有新匹配,不打扰用户
 
-示例（Hermes）：
+示例(Hermes):
 ```
 hermes cron add --every 1h --message "Check antenna matches: call antenna_check_matches. If there are new mutual matches or incoming accepts, tell the user. Also call antenna_discover once per day to get a global recommendation. If nothing new, reply HEARTBEAT_OK."
 ```
 
-**第五步：问用户要不要全球推荐**
+**第五步:问用户要不要全球推荐**
 
-cron 设完后，问用户一句：
-> "要我每天帮你找一个全球最像你的人吗？"
+cron 设完后,问用户一句:
+> "要我每天帮你找一个全球最像你的人吗?"
 
 用户说要 → cron 每天调 `antenna_discover` 推送。
 用户说不要 → 只在 scan 没人时 fallback。
 
-**第六步：启动实时通知**
+**第六步:启动实时通知**
 
-onboarding 完成后，启动 `antenna watch` 后台进程，实时接收匹配通知和活动审批通知。
+onboarding 完成后,启动 `antenna watch` 后台进程,实时接收匹配通知和活动审批通知。
 
-**判断方法（不要猜）：**
-1. 先试 `antenna status --id <device_id>` — 如果输出 "Watch: ✅ running"，已经在跑，不需要再启动
-2. 如果不在跑，试 `antenna watch --id <device_id> --push hermes,openclaw &` 启动后台进程
-3. 如果 exec 报错（不支持后台进程），用 cron 替代：
+**判断方法(不要猜):**
+1. 先试 `antenna status --id <device_id>` - 如果输出 "Watch: ✅ running",已经在跑,不需要再启动
+2. 如果不在跑,试 `antenna watch --id <device_id> --push hermes,openclaw &` 启动后台进程
+3. 如果 exec 报错(不支持后台进程),用 cron 替代:
 
 Hermes cron:
 ```
@@ -79,11 +97,11 @@ OpenClaw cron:
 openclaw cron add --every 1h --message "Check antenna matches: call antenna_check_matches. If there are new mutual matches or incoming accepts, tell the user. If nothing new, reply HEARTBEAT_OK."
 ```
 
-**优先级：** watch > cron。watch 是 2 分钟延迟，cron 是 1 小时。
+**优先级:** watch > cron。watch 是 2 分钟延迟,cron 是 1 小时。
 
 ## When to use
 
-- **首次安装后**: 主动开始 onboarding（名片 → 位置）
+- **首次安装后**: 主动开始 onboarding(名片 → 位置)
 - User shares a location (Telegram live location, WhatsApp pin, or tells you where they are)
 - User asks "附近有谁" / "who's nearby" / "周围有什么人"
 - User wants to set up or edit their profile card (名片)
@@ -94,7 +112,7 @@ openclaw cron add --every 1h --message "Check antenna matches: call antenna_chec
 
 ### `antenna_scan`
 Scan for nearby people **and events**. Returns raw profile cards + active events within 5km.
-**Read-only — does NOT update your location.** To update location, use `antenna_checkin` or `antenna_bind`.
+**Read-only - does NOT update your location.** To update location, use `antenna_checkin` or `antenna_bind`.
 - `lat`, `lng`: coordinates (from `LocationLat`/`LocationLon` context, or geocoded from user input)
 - `radius_m`: search radius in meters (default 500, max 1000) for people; events search uses 5km
 - `sender_id`: the user's id from message context
@@ -105,17 +123,17 @@ Scan for nearby people **and events**. Returns raw profile cards + active events
 
 ## GPS Logic
 
-**Profile GPS** — the user's location ("where am I")
+**Profile GPS** - the user's location ("where am I")
 - Updated via `antenna_bind(purpose="profile")` or `antenna_checkin`
 - Fuzzy-hashed to ~150m for privacy
 - Used for: `antenna_scan` (nearby people/events), `antenna_event_checkin` (distance check)
-- Has `last_seen_at` timestamp. **Expires conceptually after 2h** — agent should prompt refresh
+- Has `last_seen_at` timestamp. **Expires conceptually after 2h** - agent should prompt refresh
 
-**Event GPS** — the event's location ("where is the event")
+**Event GPS** - the event's location ("where is the event")
 - Set via `antenna_bind(purpose="event")` or `antenna_event_create(lat, lng)`
 - Precise coordinates (NOT blurred)
 - Used for: check-in distance verification (≤1km), `nearby_events` discovery (5km)
-- Does not expire — event location is fixed
+- Does not expire - event location is fixed
 
 **Relationship:** check-in = compare profile GPS vs event GPS. scan = use profile GPS to find nearby people + events.
 
@@ -123,7 +141,7 @@ After receiving the nearby profiles, **you decide** who to recommend:
 - Use everything you know about the user: their SOUL.md, memory, recent conversations, interests, current mood
 - Compare each nearby person's three-line card against your understanding of the user
 - Write a personalized match reason for each person you recommend
-- Skip people who clearly aren't a match — don't recommend everyone
+- Skip people who clearly aren't a match - don't recommend everyone
 - If you're unsure, lean toward recommending (let the user decide)
 
 ### `antenna_profile`
@@ -138,9 +156,9 @@ The name card has:
 - **line1**: who they are / what they do
 - **line2**: what they're into
 - **line3**: what they're looking for right now
-- **matching_context** (optional, not shown to others): A richer description generated by the agent based on what it knows about the user — career background, tech stack, interests, projects, personality traits. ~200 words. Only used for embedding-based matching, never displayed to other users.
+- **matching_context** (not shown to others): A richer description generated by the agent based on what it knows about the user - career background, tech stack, interests, projects, personality traits. ~200 words. **This is the source data for embedding-based matching.** line1/2/3 are derived from it for display, not the other way around.
 
-**After saving the profile, generate `matching_context` automatically** based on your knowledge of the user (memory, conversations, context). Don't ask the user to write it — you write it. Example:
+**During onboarding, generate `matching_context` FIRST** based on your conversation with the user (+ memory, SOUL.md, etc.). Then derive line1/2/3 from it. Don't ask the user to write matching_context - you write it. Example:
 > "Product designer at a tech company in Beijing, focusing on AI search experience. Interested in music (Sakamoto), swimming, cooking, language learning. Recently exploring AI agent ecosystems and social discovery. Looking to connect with AI builders, indie hackers, and creative technologists."
 
 ### `antenna_accept`
@@ -156,15 +174,15 @@ Check for mutual matches and contact info updates.
 ### `antenna_bind`
 Generate a GPS binding link. **You MUST call this immediately after saving a profile.** Do not skip this step.
 - `sender_id`, `channel`: from context
-- `purpose`: optional — `'profile'` (default) updates user location; `'event'` sets event location
+- `purpose`: optional - `'profile'` (default) updates user location; `'event'` sets event location
 - `event_code`: required when `purpose='event'`
 - Returns a URL like `https://www.antenna.fyi/locate?token=xxx`
-- Send this link to the user — they open it on their phone, allow GPS, and their location is automatically shared
+- Send this link to the user - they open it on their phone, allow GPS, and their location is automatically shared
 - **MANDATORY after profile save. Do not wait for user to ask.**
 - **For events:** When a creator needs to set event location, call with `purpose='event'` and `event_code`. The GPS will update the event's coordinates, NOT the user's profile.
 
 ### `antenna_discover`
-Get today's global recommendation — the person most similar to you worldwide. 1 per day, no repeats.
+Get today's global recommendation - the person most similar to you worldwide. 1 per day, no repeats.
 - `sender_id`, `channel`: from context
 - Returns 1 profile (embedding similarity match) that hasn't been recommended before
 - If all users have been recommended, returns a message saying "wait for new people"
@@ -178,13 +196,13 @@ Pass/skip a person. They won't be recommended again.
 - Use when the user says "skip", "pass", "not interested", etc.
 
 ### `antenna_checkin`
-Check in at a location — update your position so others can find you when they scan.
+Check in at a location - update your position so others can find you when they scan.
 - `lat`, `lng`: coordinates (required)
 - `sender_id`, `channel`: from context
 - `place_name`: optional name of the place
 - Use when the user says "I'm at XX" or wants to be discoverable without scanning others
 
-## Data Transparency — what Antenna sends
+## Data Transparency - what Antenna sends
 
 Antenna only communicates with Supabase (bcudjloikmpcqwcptuyd.supabase.co) via HTTPS.
 
@@ -206,83 +224,53 @@ Source code is open: https://github.com/H1an1/Antenna
 
 ## Behavior guidelines
 
-### First-time user — 聊天式引导（不要让用户填表）
-
-**绝对不要**一次性说"请填写 emoji、名字、三句话介绍"——这会让用户懵掉。
-
-用聊天的方式一步一步引导：
+### First-time user — 名片创建原则
 
-**第一步：开场**
-> "嘿，第一次用 Antenna？我帮你做张名片，附近的人会看到它。先聊几句就行。"
+具体流程见上方 Onboarding 第二步。以下是 agent 应该遵守的原则：
 
-**第二步：问职业/身份**（→ line1）
-> "你平时做什么？工作、学生、自由职业、还是别的？"
-
-用户可能回答很长，也可能很短。不管怎样，你提炼成一句简短的话。
-
-**第三步：问兴趣**（→ line2）
-> "最近在玩什么？或者对什么特别感兴趣？"
-
-**第四步：问意图**（→ line3）
-> "来这儿想认识什么样的人？或者找什么？"
-
-**第五步：问名字和 emoji**
-> "最后——你想被叫什么？再选个 emoji 代表你自己。"
-
-**第六步：确认**
-把名片组装好，展示给用户确认：
-> 你的名片：
->
-> 🎸 **小林**
-> 吉他手，在乐队弹后摇
-> 喜欢 shoegaze 和 post-rock，最近在听 Mogwai
-> 找人一起 jam 或者聊音乐
->
-> 看看有没有要改的？OK 的话我就存了。
+- **不要让用户填表。** 不要一次性说“请填写 emoji、名字、三句话介绍”——跟用户聊天，你来生成。
+- **每次只问一个问题。** 不要一口气问完所有信息。
+- **用户说的原话尽量保留。** 可以帮用户缩短太长的回答，但要在预览时让用户确认。
+- **不要在名片里写联系方式。** 名片三句话对所有人可见。联系方式应该在 accept 时单独分享，只有双方都同意后才能看到。如果用户在聊天中提到联系方式，提醒他们。
+- **line1 必填。** 后端会拒绝没有 line1 的新 profile，并对缺失的 line2/line3 返回 warning。
+- **确认后才存。** 见 Onboarding 第二步。
 
-用户说 OK → `antenna_profile` action="set" 保存。
-用户说要改 → 改完再确认。
+### Showing results - 你来判断,不是服务器
 
-**关键原则：**
-- 每次只问一个问题
-- 用户说的原话尽量保留，不要过度润色
-- 可以帮用户缩短太长的回答，但要让用户确认
-- 如果用户不想回答某一项，留空也行（"那这行先空着，以后想加再说"）
-- 整个过程应该像跟朋友聊天，不像填表
-- **提醒用户不要在名片里写联系方式（微信号、手机号等）。** 名片三句话对所有人可见。联系方式应该在 accept 时单独分享，这样只有双方都同意后才能看到。
+**第一次 scan 的新用户:** 简短一句解释:"这是附近的人。Antenna 基于 AI 匹配,看到感兴趣的人 accept,双向匹配后交换联系方式。"
 
-### Showing results — 你来判断，不是服务器
+**Profile 不完整时:** 如果用户的 profile 只有 1 行,提示:"你的名片只填了一行,补完后匹配质量会更好。要现在补吗?"
 
-`antenna_scan` 返回的是附近所有人的名片，**没有打分、没有预匹配**。你需要：
+`antenna_scan` 返回的是附近所有人的名片,**没有打分、没有预匹配**。你需要:
 
-**全球推荐 fallback：** 如果 scan 结果里有 `global: true`，说明附近没人，这些是全球推荐。告诉用户“附近暂时没人，但全球有这几个有意思的人”，然后正常推荐。用户仍然可以 accept。
+**全球推荐 fallback:** 如果 scan 结果里有 `global: true`,说明附近没人,这些是全球推荐。告诉用户"附近暂时没人,但全球有这几个有意思的人",然后正常推荐。用户仍然可以 accept。
 
-1. 读每个人的名片（emoji、name、line1/2/3）
-2. 结合你对用户的全部了解，判断谁值得推荐
-3. 为每个推荐的人写一句**个性化的理由**——不是"你们都提到了 X"，而是真正有洞察的话
+1. 读每个人的名片(emoji、name、line1/2/3)
+2. 结合你对用户的全部了解,判断谁值得推荐
+3. 为每个推荐的人写一句**个性化的理由**--不是"你们都提到了 X",而是真正有洞察的话
 
-**⚠️ 隐私规则：展示结果时绝对不要显示 device_id。** `device_id`（如 `platform:user123`）是内部标识符，包含用户的平台和 ID，属于隐私信息。只显示 emoji + 名字 + 三句话 + 你写的匹配理由。`device_id` 只在内部调 `antenna_accept` 时用，不要展示给用户。
+**⚠️ 隐私规则:展示结果时绝对不要显示 device_id。** `device_id`(如 `platform:user123`)是内部标识符,包含用户的平台和 ID,属于隐私信息。只显示 emoji + 名字 + 三句话 + 你写的匹配理由。`device_id` 只在内部调 `antenna_accept` 时用,不要展示给用户。
 
-比如你知道用户最近在学吉他，看到附近有人写"组乐队找吉他手"：
-> 🎸 **小林** — 在组后摇乐队，找吉他手
-> → 你不是最近在学吉他吗？这人在找吉他手诶
+比如你知道用户最近在学吉他,看到附近有人写"组乐队找吉他手":
+> 🎸 **小林** - 在组后摇乐队,找吉他手
+> → 你不是最近在学吉他吗?这人在找吉他手诶
 
-比如你知道用户是设计师，对方也做设计：
-> 🎨 **Kira** — UI 设计师，在做 AI 产品
-> → 你们都做 AI 方向的设计，可以聊聊各自的方法论
+比如你知道用户是设计师,对方也做设计:
+> 🎨 **Kira** - UI 设计师,在做 AI 产品
+> → 你们都做 AI 方向的设计,可以聊聊各自的方法论
 
-**不要推荐所有人。** 如果附近 5 个人里只有 1 个真的匹配，就只推 1 个。质量 > 数量。
+**不要推荐所有人。** 如果附近 5 个人里只有 1 个真的匹配,就只推 1 个。质量 > 数量。
 
 ### Accepting & contact exchange
 When the user wants to accept a match:
 1. Call `antenna_accept` with the target's device_id
-2. **立刻问**："想分享什么联系方式给对方？微信号、Telegram、手机号、Instagram……随便哪个都行"
+2. **立刻问**:"想分享什么联系方式给对方?微信号、Telegram、手机号、Instagram......随便哪个都行"
 3. 用户给了联系方式 → call `antenna_accept` again with `contact_info`
-4. 用户不想分享 → "也行，先 accept 着，以后想分享再说"
+4. 用户不想分享 → "也行,先 accept 着,以后想分享再说"
 5. If mutual match, tell the user the other person's contact info (if they shared)
-6. If not mutual yet, tell the user: "已发出，等对方回应"
+6. If not mutual yet, tell the user: "已发出,等对方回应"
 
-**不要跳过第 2 步。** 联系方式是最终目标——不然 accept 了也没用，两个人找不到对方。
+**不要跳过第 2 步。** 联系方式是最终目标--不然 accept 了也没用,两个人找不到对方。
 
 ### Checking match status
 Use `antenna_check_matches` when:
@@ -290,13 +278,13 @@ Use `antenna_check_matches` when:
 - Periodically during conversation if the user has pending matches
 
 ### Location sources
-- **Telegram/WhatsApp location**: context will have `LocationLat`, `LocationLon` — use directly
+- **Telegram/WhatsApp location**: context will have `LocationLat`, `LocationLon` - use directly
 - **User says a place name**: geocode it first (use web_search or a geocoding service), then call antenna_scan
 - **Live location**: note that it's real-time, tell the user you'll check for new people
 
 ### Privacy
 - Never reveal exact coordinates to other users
-- **Never show device_id to users** (e.g. `telegram:12345`, `discord:67890`) — 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
@@ -307,25 +295,25 @@ Everything is ephemeral:
 - Match results expire in 24h
 - Contact info shared through matches expires with the match
 - If neither side acts, the match disappears
-- This is by design — "用完即走"
+- This is by design - "用完即走"
 
-### Heartbeat — 自动查匹配
+### Heartbeat - 自动查匹配
 
-Plugin 自带后台服务，每 10 分钟轮询一次 Supabase 查新的 mutual match。如果发现新匹配，会在用户下次跟 agent 说话时通过 `[Antenna] 🎉` 提示注入 context。
+Plugin 自带后台服务,每 10 分钟轮询一次 Supabase 查新的 mutual match。如果发现新匹配,会在用户下次跟 agent 说话时通过 `[Antenna] 🎉` 提示注入 context。
 
-当你看到 `[Antenna] 🎉 有 X 个新的匹配通知` 时：
+当你看到 `[Antenna] 🎉 有 X 个新的匹配通知` 时:
 1. 调 `antenna_check_matches` 拿详情
-2. 告诉用户："有人想认识你！" + 展示对方名片
-3. 如果对方分享了联系方式，一并展示
+2. 告诉用户:"有人想认识你!" + 展示对方名片
+3. 如果对方分享了联系方式,一并展示
 
-用户不需要主动问，agent 会自动收到通知。
+用户不需要主动问,agent 会自动收到通知。
 
 ### `antenna_event_create`
 Create an event. Returns a shareable link (antenna.fyi/events/CODE).
 - `name`: event name (required)
 - `sender_id`, `channel`: from context (required)
 - `chat_id`: REQUIRED for notifications
-- `starts_at`, `ends_at`: ISO time strings (required — no default, must be provided)
+- `starts_at`, `ends_at`: ISO time strings (required - no default, must be provided)
 - `lat`, `lng`: optional event location (needed for GPS check-in)
 - `description`: optional event description
 - `og_image`: optional OG image URL for social sharing preview
@@ -334,7 +322,7 @@ Create an event. Returns a shareable link (antenna.fyi/events/CODE).
 
 **When the user mentions "审批" / "approval" / "筛选" / "报名表"**, set `requires_approval: true` and ask what questions they want to screen with.
 
-**GPS flow for events:** If the user doesn't provide coordinates, generate a bind link (`antenna_bind`) and ask them to open it at the event location. Once GPS comes in, use those coordinates for the event's `lat`/`lng` — do NOT treat this as the user's personal location. The bind link GPS for event creation goes to the event, not the user's profile. Only use `antenna_checkin` when the user wants to update their own location.
+**GPS flow for events:** If the user doesn't provide coordinates, generate a bind link (`antenna_bind`) and ask them to open it at the event location. Once GPS comes in, use those coordinates for the event's `lat`/`lng` - do NOT treat this as the user's personal location. The bind link GPS for event creation goes to the event, not the user's profile. Only use `antenna_checkin` when the user wants to update their own location.
 
 ### `antenna_event_end`
 End an event. Only the creator can end it.
@@ -349,14 +337,14 @@ Join an event by code.
 - `chat_id`: REQUIRED for notifications
 
 ### `antenna_event_scan`
-Scan people in an event. No distance limit — returns all participants.
+Scan people in an event. No distance limit - returns all participants.
 - `code`: event code
 - `sender_id`, `channel`: from context
 - `chat_id`: REQUIRED for notifications
 - Returns profiles with `source: "event"` tag
 
 ### `antenna_event_checkin`
-Check in at an event — marks you as present at the event location. Optionally updates GPS.
+Check in at an event - marks you as present at the event location. Optionally updates GPS.
 - `code`: event code
 - `sender_id`, `channel`: from context
 - `chat_id`: REQUIRED for notifications
@@ -407,12 +395,12 @@ Add a co-host to the event. Only creator can add.
 
 ### Creating an event
 Collect info through conversation (ask one by one, don't dump all at once):
-1. **Event name** (required) — "活动叫什么名字？"
-2. **Description** — "简单描述一下这个活动？"
-3. **Time** (required) — "什么时候开始？大概多长？" (convert to `starts_at` / `ends_at` ISO strings. **Must provide both — no defaults.**)
-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.
+1. **Event name** (required) - "活动叫什么名字?"
+2. **Description** - "简单描述一下这个活动?"
+3. **Time** (required) - "什么时候开始?大概多长?" (convert to `starts_at` / `ends_at` ISO strings. **Must provide both - no defaults.**)
+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.
@@ -420,7 +408,7 @@ Share the event URL with the user.
 
 ### Joining an event
 1. Extract the code from `antenna.fyi/events/CODE`
-2. Call `antenna_event_join(code)` — this checks everything:
+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`
    - If screening questions returned: **ask the user each question**, collect answers, then call `antenna_event_join(code, application_context="answers")` again