antenna-fyi 1.3.24 → 1.3.26

package/lib/cli.js

@@ -430,17 +430,17 @@ export async function handleConfig(f) {
 export async function handleLinkAccount(f) {
   const id = resolveId(f);
   const config = loadConfig();
-  const userId = f['user-id'] || f.userId || config.user_id;
-  if (!id) return console.error("Usage: antenna link-account --id <platform>:<user_id> --user-id <antenna.fyi UUID>\n       Or: antenna link-account (uses config device_id + user_id)");
-  if (!userId) return console.error("❌ No user_id. Run 'antenna config --key <your-key>' first, or pass --user-id <UUID>.");
+  const apiKey = f['api-key'] || f.apiKey || f.key || config.key;
+  if (!id) return console.error("Usage: antenna link-account --id <device_id> --api-key <ant_xxx>\n       Or: antenna link-account (uses config device_id + key)");
+  if (!apiKey) return console.error("❌ No API key. Run 'antenna config --key <your-key>' first, or pass --api-key <key>.");
   try {
-    const result = await linkAccount({ device_id: id, user_id: userId });
+    const result = await linkAccount({ device_id: id, api_key: apiKey });
     if (result.error) {
       console.error(`\n❌ ${result.message || result.error}`);
     } else {
       console.log(`\n✅ ${result.message || 'Account linked.'}`);
       console.log(`  Device ID: ${id}`);
-      console.log(`  User ID: ${userId}\n`);
+      console.log(`  API Key: ${apiKey.slice(0, 10)}...\n`);
     }
   } catch (e) {
     console.error(`\n❌ Failed: ${e.message}`);

package/lib/core.js

@@ -917,13 +917,13 @@ export async function verifyApiKey({ key, supabaseUrl, supabaseKey }) {
   return data;
 }
 
-// ─── linkAccount (bind user_id to device_id) ─────────────────────────
+// ─── linkAccount (bind device_id to website account via API key) ─────
 
-export async function linkAccount({ device_id, user_id, supabaseUrl, supabaseKey }) {
+export async function linkAccount({ device_id, api_key, supabaseUrl, supabaseKey }) {
   const sb = getClient(supabaseUrl, supabaseKey);
   const { data, error } = await sb.rpc("bind_user_id", {
     p_device_id: device_id,
-    p_user_id: user_id,
+    p_api_key: api_key,
   });
   if (error) throw new Error(error.message);
   if (data?.error) return data;

package/lib/hermes-plugin/schemas.py

@@ -397,9 +397,9 @@ LINK_ACCOUNT_SCHEMA = {
             "sender_id": {"type": "string", "description": "The sender's user ID"},
             "channel": {"type": "string", "description": "Platform name"},
             "chat_id": {"type": "string", "description": "REQUIRED. Pass the chat/channel ID from message context."},
-            "user_id": {"type": "string", "description": "The user's antenna.fyi account UUID, visible on their dashboard"},
+            "api_key": {"type": "string", "description": "The user's Antenna API key (ant_xxx) from antenna.fyi/me"},
         },
-        "required": ["sender_id", "channel", "chat_id", "user_id"],
+        "required": ["sender_id", "channel", "chat_id", "api_key"],
     },
 }
 

package/lib/hermes-plugin/tools.py

@@ -726,7 +726,7 @@ def handle_link_account(params: dict) -> str:
 
     resp = sb.rpc("bind_user_id", {
         "p_device_id": did,
-        "p_user_id": params["user_id"],
+        "p_api_key": params["api_key"],
     }).execute()
 
     if resp.data and resp.data.get("error"):

package/lib/mcp.js

@@ -540,15 +540,15 @@ export async function startMcpServer() {
 
   server.tool(
     "antenna_link_account",
-    "Link your Antenna agent profile to your antenna.fyi website account. The user needs to provide their user_id from the dashboard (antenna.fyi/me). After linking, the dashboard will show the same profile and match history.",
+    "Link your Antenna agent profile to your antenna.fyi website account. Pass the user's API key — the server verifies it and extracts the user_id. The agent never needs to know or pass user_id directly.",
     {
       sender_id: z.string().describe("The sender's user ID"),
       channel: z.string().describe("Channel name"),
-      user_id: z.string().describe("The user's antenna.fyi account UUID, visible on their dashboard"),
+      api_key: z.string().describe("The user's Antenna API key (ant_xxx) from antenna.fyi/me"),
     },
-    async ({ sender_id, channel, user_id }) => {
+    async ({ sender_id, channel, api_key }) => {
       try {
-        const result = await linkAccount({ device_id: deriveDeviceId(sender_id, channel), user_id });
+        const result = await linkAccount({ device_id: deriveDeviceId(sender_id, channel), api_key });
         return jsonResult(result);
       } catch (e) { return jsonResult({ error: e.message }); }
     }

package/package.json

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

package/skill/SKILL.md

@@ -24,50 +24,56 @@ Antenna 帮你的用户发现值得认识的人。不只是"附近的人"--profi
 - 如果没有,用 CLI:`antenna <command> [flags]`。
 - **所有 tool 必须传 `chat_id`**--Antenna 用它发通知。
 
-## Onboarding — 装上后主动引导
+## Onboarding - 装上后主动引导
 
-Plugin 安装后，agent **主动**开始引导，不要等用户问。
+Plugin 安装后,agent **主动**开始引导,不要等用户问。
 
-**前置条件：** 用户需要先在 antenna.fyi 注册账号，从 Dashboard 获取 API key。如果没注册，引导去 antenna.fyi。
+**前置条件:** 用户需要先在 antenna.fyi 注册账号,从 Dashboard 获取 API key。如果没注册,引导去 antenna.fyi。
 
 ### 流程
 
-**第一步：拿到 API key → 配置**
-> "嘿，你装了 Antenna——它能帮你发现有意思的人。先确认一下，你在 antenna.fyi 注册过了吗？拿到 API key 了吗？"
+**第一步:拿到 API key → 配置**
+> "嘿,你装了 Antenna--它能帮你发现有意思的人。先确认一下,你在 antenna.fyi 注册过了吗?拿到 API key 了吗?"
 
-用户给了 API key 后，调 `antenna config --key <key>` 验证。这会返回 `user_id` 和 `device_id`。
+用户给了 API key 后,调 `antenna config --key <key>` 验证。这会返回 `user_id` 和 `device_id`。
 
-**⚠️ 之后所有操作必须用 API key 验证返回的 device_id（格式 `user:xxx`）。不要自己拼 `channel:sender_id`。** 这样 agent 创建的 profile 才能在 dashboard 上显示。
+**⚠️ 之后所有操作必须用 API key 验证返回的 device_id(格式 `user:xxx`)。不要自己拼 `channel:sender_id`。** 这样 agent 创建的 profile 才能在 dashboard 上显示。
 
-**第二步：聊天收集 → 生成名片 → 确认**
+**第二步:聊天收集 → 生成名片 → 确认**
 
-跟用户聊几句，了解他们是谁、做什么、想认识什么人。然后 agent 自己生成：
-- more_information（~200 字，给 agent 匹配用的私密上下文，不展示给别人）
+跟用户聊几句,了解他们是谁、做什么、想认识什么人。然后 agent 自己生成:
+- more_information(~200 字,给 agent 匹配用的私密上下文,不展示给别人)
 - 从中提炼 line1/2/3 + display_name
 
-展示预览给用户确认：
-> 你的名片：
+展示预览给用户确认:
+> 你的名片:
 > Yi
-> · Product Designer，做 AI 搜索体验
+> · Product Designer,做 AI 搜索体验
 > · 对 AI agent、音乐、游泳感兴趣
 > · 想认识做 AI 产品和独立创作的人
 >
-> 这样可以吗？要改哪里告诉我。
+> 这样可以吗?要改哪里告诉我。
 
 确认后用 config 里的 device_id 调 `antenna_profile(action="set")` 保存。**不要跳过确认。**
 
-**⚠️ sender_id 用 config 里的 device_id，不要用 channel:sender_id。**
+**⚠️ sender_id 用 config 里的 device_id,不要用 channel:sender_id。**
 
 **第三步:立刻推荐 2-3 个人**
 
 名片存好后,**立刻**调 `antenna_initial_recommendations` 获取首次推荐:
 > "名片存好了!我先帮你看看有谁跟你特别像--"
 
-这是一次性的首次推荐(不消耗每日 discover 额度)。如果返回空,说明还没有足够的用户--跳过这步,继续 antenna_bind。
+这是一次性的首次推荐（不消耗每日 discover 额度）。如果返回空，说明还没有足够的用户——跳过这步。
 
-**第四步:调 antenna_bind 获取 GPS 链接**
+**第四步：发公开链接给用户**
 
-**强制。** 名片存好后**必须立刻**调用 `antenna_bind` 生成链接并发给用户:
+Profile 存好后，返回里会有 `public_url`（如 `antenna.fyi/p/yi`）。**必须发给用户：**
+> "这是你的公开名片链接：[public_url]
+> 你可以把它发给别人，对方的 agent 看到链接就能直接 accept 你。"
+
+**第五步：调 antenna_bind 获取 GPS 链接**
+
+**强制。** 名片存好后**必须立刻**调用 `antenna_bind` 生成链接并发给用户：
 > "点这个链接,在手机浏览器打开,允许定位就行:[链接]"
 
 GPS 不是 Antenna 的唯一入口,但它开启了附近发现的能力。
@@ -85,8 +91,8 @@ openclaw cron add --every 1h --message "Check antenna matches: call antenna_chec
 ### Linking to antenna.fyi account
 
 如果用户之前通过 agent 创建过 profile(没有网站账号),现在注册了 antenna.fyi:
-1. 让用户从 antenna.fyi/me 复制 user ID
-2. 调 `antenna_link_account(user_id = "xxx")`
+1. 让用户从 antenna.fyi/me 复制 API key
+2. 调 `antenna_link_account(api_key = "ant_xxx")`
 3. 确认:"关联成功!你现在可以在 dashboard 上看到完整的 profile 和匹配记录了。"
 
 这把 agent 创建的 profile(带全部历史)关联到网站账号。