antenna-openclaw-plugin 0.8.1 → 0.10.0

package/index.ts

@@ -278,19 +278,29 @@ export default function register(api: any) {
         return ok({ nearby: [], message: `在 ${radius}m 范围内没有发现其他人。试试扩大范围？` });
       }
 
-      // Return raw profile cards — the agent decides who to recommend
-      return ok({
-        nearby: others.map((p: Profile) => ({
-          device_id: p.device_id,
+      // Build ref mapping — never expose device_id
+      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,
           emoji: p.emoji || "👤",
           name: p.display_name || "匿名",
           line1: p.line1,
           line2: p.line2,
           line3: p.line3,
-        })),
+        };
+      });
+
+      // Store ref map for accept
+      (api as any)._antennaRefMap = _refMap;
+
+      return ok({
+        nearby: profiles,
         total: others.length,
         radius_m: radius,
-        instruction: "根据你对用户的了解（记忆、偏好、最近的状态），判断哪些人值得推荐，为每个推荐写一句个性化的匹配理由。",
+        instruction: "根据你对用户的了解，判断哪些人值得推荐，用 ref 编号引用。不要显示 device_id。",
       });
     },
   });
@@ -405,24 +415,34 @@ export default function register(api: any) {
   api.registerTool({
     name: "antenna_accept",
     description:
-      "Accept a match. Optionally share contact info (WeChat, Telegram, phone, etc). If both sides accept, they can exchange contact info through their agents.",
+      "Accept a match. Use 'ref' from scan results (e.g. '1', '2') or target_device_id. Optionally share contact info.",
     parameters: {
       type: "object",
       properties: {
         sender_id: { type: "string" },
         channel: { type: "string" },
-        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')" },
+        ref: { type: "string", description: "Ref number from scan results (e.g. '1')" },
+        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", "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);
 
+      // Resolve ref to device_id
+      let targetId = params.target_device_id;
+      if (params.ref && (api as any)._antennaRefMap?.[params.ref]) {
+        targetId = (api as any)._antennaRefMap[params.ref];
+      }
+      if (!targetId) {
+        return ok({ error: "No target. Use 'ref' from scan results 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,
       });
 
@@ -430,13 +450,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,
@@ -448,11 +468,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,
       );
 

package/package.json

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

package/skills/antenna/SKILL.md

@@ -43,9 +43,17 @@ onboarding 完成后，帮用户设置一个每小时自动检查匹配的 cron
 
 示例（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. If nothing new, reply HEARTBEAT_OK."
+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 每天调 `antenna_discover` 推送。
+用户说不要 → 只在 scan 没人时 fallback。
+
 ## When to use
 
 - **首次安装后**: 主动开始 onboarding（名片 → 位置）
@@ -101,6 +109,13 @@ Generate a GPS binding link. **You MUST call this immediately after saving a pro
 - 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.**
 
+### `antenna_discover`
+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"
+- Use this in the daily cron job, or when user asks "find someone interesting globally"
+
 ## Behavior guidelines
 
 ### First-time user — 聊天式引导（不要让用户填表）