antenna-fyi 0.12.2 → 0.13.0

package/lib/core.js

@@ -337,6 +337,58 @@ export async function checkMatches({ device_id, supabaseUrl, supabaseKey }) {
 
 // ─── createBindToken ─────────────────────────────────────────────
 
+// ─── discover (global recommendation) ─────────────────────────────
+
+export async function discover({ device_id, supabaseUrl, supabaseKey }) {
+  const sb = getClient(supabaseUrl, supabaseKey);
+
+  const { data: globalData } = await sb.rpc("global_discover", {
+    p_device_id: device_id,
+    p_limit: 1,
+  });
+
+  const results = globalData || [];
+  if (results.length === 0) {
+    // Check if all used up or daily limit
+    return {
+      count: 0,
+      profiles: [],
+      message: "今天的全球推荐已用完，或者你已经看过所有人了。等新人加入！",
+    };
+  }
+
+  // Build ref map
+  const _refMap = {};
+  const profiles = results.map((p, i) => {
+    const ref = String(i + 1);
+    _refMap[ref] = p.device_id;
+    return {
+      ref,
+      name: p.display_name || "匿名",
+      emoji: p.emoji || "👤",
+      line1: p.line1,
+      line2: p.line2,
+      line3: p.line3,
+    };
+  });
+
+  // Log who was recommended (for dedup)
+  for (const p of results) {
+    await sb.rpc("log_recommendation", {
+      p_device_id: device_id,
+      p_recommended_id: p.device_id,
+    });
+  }
+
+  return {
+    count: profiles.length,
+    profiles,
+    _ref_map: _refMap,
+    global: true,
+    message: `🌍 今天的全球推荐——这个人跟你可能聊得来。`,
+  };
+}
+
 export async function createBindToken({ device_id, supabaseUrl, supabaseKey }) {
   const sb = getClient(supabaseUrl, supabaseKey);
   const { data, error } = await sb.rpc("create_bind_token", { p_device_id: device_id });

package/lib/mcp.js

@@ -11,6 +11,7 @@ import {
   checkMatches,
   checkin,
   createBindToken,
+  discover,
   deriveDeviceId,
 } from "./core.js";
 
@@ -176,6 +177,30 @@ export async function startMcpServer() {
     }
   );
 
+  // ─── antenna_discover ────────────────────────────────────────
+
+  server.tool(
+    "antenna_discover",
+    "Get today's global recommendation — the person most similar to you worldwide. 1 per day, no repeats.",
+    {
+      sender_id: z.string().describe("The sender's user ID"),
+      channel: z.string().describe("Channel name"),
+    },
+    async ({ sender_id, channel }) => {
+      try {
+        const result = await discover({ device_id: deriveDeviceId(sender_id, channel) });
+        if (result._ref_map) {
+          _lastRefMap = result._ref_map;
+          const { _ref_map, ...clean } = result;
+          return jsonResult(clean);
+        }
+        return jsonResult(result);
+      } catch (e) {
+        return jsonResult({ error: e.message });
+      }
+    }
+  );
+
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }

package/package.json

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

package/skill/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 — 聊天式引导（不要让用户填表）