antenna-fyi 1.3.43 → 1.3.44

package/lib/cli.js

@@ -124,12 +124,14 @@ export async function handleProfile(f) {
 export async function handleAccept(f) {
   const id = resolveId(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 config = loadConfig();
   const result = await accept({
     device_id: id,
     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,
+    api_key: config.key || null,
   });
   console.log("✅ " + result.message);
   if (result.mutual && result.their_contact) console.log("📇 Their contact: " + result.their_contact);

package/lib/core.js

@@ -461,10 +461,18 @@ export async function accept({
   ref,
   profile_slug,
   contact_info,
+  api_key,
   supabaseUrl,
   supabaseKey,
 }) {
   const sb = getClient(supabaseUrl, supabaseKey);
+  if (api_key) {
+    const auth = await verifyApiKey({ key: api_key, supabaseUrl, supabaseKey });
+    if (!auth?.valid) {
+      throw new Error(auth?.error || "Invalid Antenna API key");
+    }
+    device_id = auth.device_id || (auth.user_id ? `user:${auth.user_id}` : device_id);
+  }
 
   // Resolve ref from DB if target_device_id not provided
   let targetId = target_device_id;
@@ -509,6 +517,7 @@ export async function accept({
   return {
     accepted: true,
     mutual,
+    dashboard_device_id: device_id,
     their_contact: mutual ? reverse?.contact_info_a || null : null,
     message: mutual
       ? "双向匹配成功！🎉"

package/lib/hermes-plugin/schemas.py

@@ -91,6 +91,10 @@ ACCEPT_SCHEMA = {
                 "type": "string",
                 "description": "Contact info to share (e.g. 'WeChat: yi')",
             },
+            "api_key": {
+                "type": "string",
+                "description": "User's Antenna API key from antenna.fyi/me. When provided, accept is written as the dashboard-linked profile, not a temporary sender/channel device.",
+            },
         },
         "required": ["sender_id", "channel", "chat_id"],
     },

package/lib/hermes-plugin/tools.py

@@ -50,7 +50,7 @@ def _dashboard_device_id(sb, api_key: str | None) -> tuple[str | None, str | Non
     data = resp.data or {}
     if not data.get("valid"):
         return None, data.get("error") or "Invalid Antenna API key"
-    device_id = f"user:{data.get('user_id')}" if data.get("user_id") else data.get("device_id")
+    device_id = data.get("device_id") or (f"user:{data.get('user_id')}" if data.get("user_id") else None)
     if not device_id:
         return None, "API key verified but did not return a dashboard device_id"
     return device_id, None
@@ -253,6 +253,11 @@ def handle_profile(params: dict) -> str:
 def handle_accept(params: dict) -> str:
     sb = _sb()
     did = _device_id(params["sender_id"], params["channel"], params.get("chat_id"))
+    if params.get("api_key"):
+        resolved_did, auth_error = _dashboard_device_id(sb, params.get("api_key"))
+        if auth_error:
+            return _ok({"error": auth_error})
+        did = resolved_did or did
 
     # Resolve ref to device_id
     ref = params.get("ref")
@@ -299,11 +304,12 @@ def handle_accept(params: dict) -> str:
     if reverse:
         contact = reverse.get("contact_info_a")
         msg = f"双方都接受了！对方分享的联系方式：{contact}" if contact else "双方都接受了！但对方还没有分享联系方式。"
-        return _ok({"accepted": True, "mutual": True, "their_contact": contact, "message": msg})
+        return _ok({"accepted": True, "mutual": True, "dashboard_device_id": did, "their_contact": contact, "message": msg})
 
     return _ok({
         "accepted": True,
         "mutual": False,
+        "dashboard_device_id": did,
         "message": "已接受。等对方也接受后，你们就可以交换联系方式了。",
     })
 

package/lib/mcp.js

@@ -160,12 +160,13 @@ export async function startMcpServer() {
       target_device_id: z.string().optional().describe("Device ID (use ref or profile_slug instead when possible)"),
       profile_slug: z.string().optional().describe("Profile slug from a public profile link (e.g. 'yi' from antenna.fyi/p/yi). Resolves to device_id automatically."),
       contact_info: z.string().optional().describe("Contact info to share"),
+      api_key: z.string().optional().describe("User's Antenna API key from antenna.fyi/me. When provided, accept is written as the dashboard-linked profile, not a temporary sender/channel device."),
     },
-    async ({ sender_id, channel, ref, target_device_id, profile_slug, contact_info }) => {
+    async ({ sender_id, channel, ref, target_device_id, profile_slug, contact_info, api_key }) => {
       try {
         const deviceId = deriveDeviceId(sender_id, channel);
-        const result = await accept({ device_id: deviceId, target_device_id, ref, profile_slug, contact_info });
-        return jsonResult(await withMatchNotifications(deviceId, result));
+        const result = await accept({ device_id: deviceId, target_device_id, ref, profile_slug, contact_info, api_key });
+        return jsonResult(await withMatchNotifications(result.dashboard_device_id || deviceId, result));
       } catch (e) {
         return jsonResult({ error: e.message });
       }

package/package.json

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

package/skill/SKILL.md

@@ -40,7 +40,7 @@ Plugin 安装后,agent **主动**开始引导,不要等用户问。
 
 用户给了 API key 后,调 `antenna config --key <key>` 验证。这会返回 `user_id` 和 dashboard 绑定的 `device_id`。
 
-**⚠️ Profile 写入必须通过用户的 Antenna API key。** 调 `antenna_profile(action="set")` 时传 `api_key`，tool 会验证 API key 并使用返回的 dashboard `device_id`(格式 `user:xxx`) 写入。不要自己拼 `channel:sender_id`，不要在用户拿到 API key 前凭空创建 profile。这样 agent 填的内容才会显示在 dashboard。
+**⚠️ Profile 写入和 accept 都必须尽量通过用户的 Antenna API key。** 调 `antenna_profile(action="set")` 时传 `api_key`，tool 会验证 API key 并使用返回的 dashboard-linked `device_id` 写入。调 `antenna_accept` 时如果用户已经有 API key，也传同一个 `api_key`，这样 match 会关联到用户的 dashboard profile，而不是临时 `sender_id/channel` profile。不要自己拼 `channel:sender_id`，不要在用户拿到 API key 前凭空创建 profile。这样 agent 填的内容和 match 才会显示在 dashboard。
 
 **第二步:聊天收集 → 生成名片 → 确认**
 
@@ -109,7 +109,7 @@ Legacy only: 如果用户之前通过旧版 agent 创建过 profile(没有网站
 - 用户分享位置 → `antenna_scan`
 - 用户问"附近有谁" → `antenna_scan`
 - 用户说"我想找一个 xxx 的人" → `antenna_find_people`
-- 用户收到 profile 链接(`antenna.fyi/p/xxx`)→ 读取 profile → 判断 → `antenna_accept`
+- 用户收到 profile 链接(`antenna.fyi/p/xxx`)→ 读取 profile → 判断 → `antenna_accept(profile_slug="xxx", api_key="ant_xxx")`
 - 用户想编辑名片 → `antenna_profile`
 - 用户说 accept / skip → `antenna_accept` / `antenna_pass`
 - 用户问匹配状态 → `antenna_check_matches`
@@ -140,7 +140,7 @@ Legacy only: 如果用户之前通过旧版 agent 创建过 profile(没有网站
 1. 用 `web_fetch` 读取页面--页面里有 `<script id="antenna-profile-data">` JSON,包含完整 profile
 2. 读取 more_information、interest_tags、个人描述等
 3. 结合你对用户的了解,判断是否推荐
-4. 如果用户想 accept → 调 `antenna_accept(profile_slug="xxx")`
+4. 如果用户想 accept → 调 `antenna_accept(profile_slug="xxx", api_key="ant_xxx")`
 
 **不需要先 scan。** Profile 链接是独立的发现路径。
 
@@ -183,6 +183,7 @@ Legacy only: 如果用户之前通过旧版 agent 创建过 profile(没有网站
   - `profile_slug`:来自 profile 链接(如 `antenna.fyi/p/yi` → `profile_slug="yi"`)
   - `target_device_id`:内部 ID(尽量用 ref 或 slug)
 - `contact_info`(可选):分享联系方式
+- `api_key`(强烈建议):用户从 dashboard 拿到的 Antenna API key。传了之后 accept 会写到 dashboard-linked profile；否则只能退回临时 `sender_id/channel` device，dashboard 关联可能不完整。
 
 ### `antenna_pass`
 跳过一个人,不再推荐。