antenna-openclaw-plugin 1.3.28 → 1.3.30
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/index.ts +419 -263
- package/migrations/drift_bottles.sql +177 -0
- package/openclaw.plugin.json +2 -2
- package/package.json +1 -1
- package/skills/antenna/SKILL.md +271 -228
- package/tests/drift-bottle.test.ts +109 -0
- package/skills/antenna/EVENTS.md +0 -163
package/skills/antenna/SKILL.md
CHANGED
|
@@ -1,325 +1,368 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: antenna
|
|
3
|
-
description: "
|
|
3
|
+
description: "AI-native social discovery via Antenna. Use when a user wants to meet interesting people - through nearby scan, global recommendations, profile links, or events. Handles profile management, matching, and contact exchange."
|
|
4
4
|
metadata: { "openclaw": { "always": true } }
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
# Antenna -
|
|
7
|
+
# Antenna - AI-Native Social Discovery
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
Antenna 帮你的用户发现值得认识的人。不只是"附近的人"--profile link、全球推荐、活动,都是发现路径。
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
- If you have Antenna plugin tools registered (antenna_scan, antenna_profile, etc.) - use them directly.
|
|
13
|
-
- If not, use CLI: `antenna <command> [flags]`. Example: `antenna scan --id <platform>:<user_id>`. The CLI supports all the same features.
|
|
14
|
-
- All tool names map to CLI commands: `antenna_scan` → `antenna scan`, `antenna_event_create` → `antenna event --create`, etc.
|
|
15
|
-
- **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.
|
|
11
|
+
**核心流程:发现 → 判断 → accept → 交换联系方式。**
|
|
16
12
|
|
|
17
|
-
|
|
13
|
+
发现可以来自任何渠道:
|
|
14
|
+
- 📡 **附近扫描** - `antenna_scan`,基于 GPS 的周边发现
|
|
15
|
+
- 🌍 **全球推荐** - `antenna_discover`,每天 1 个最匹配的人
|
|
16
|
+
- 🔗 **Profile 链接** - 用户收到 `antenna.fyi/p/xxx` 链接,agent 读取后直接 accept
|
|
17
|
+
- 🎪 **活动** - `antenna_event_scan`,同一个活动里的人
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
**Accept 不需要先 scan。** 只要你知道对方的 `ref`、`profile_slug` 或 `device_id`,就可以直接 accept。
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
## How to call Antenna
|
|
22
|
+
|
|
23
|
+
- 如果有 Antenna plugin tools(antenna_scan, antenna_profile 等),直接用。
|
|
24
|
+
- 如果没有,用 CLI:`antenna <command> [flags]`。
|
|
25
|
+
- **所有 tool 必须传 `chat_id`**--Antenna 用它发通知。
|
|
26
|
+
|
|
27
|
+
## Onboarding - 装上后主动引导
|
|
28
|
+
|
|
29
|
+
Plugin 安装后,agent **主动**开始引导,不要等用户问。
|
|
30
|
+
|
|
31
|
+
**前置条件:** 用户需要先在 antenna.fyi 注册账号,从 Dashboard 获取 API key。如果没注册,引导去 antenna.fyi。
|
|
22
32
|
|
|
23
33
|
### 流程
|
|
24
34
|
|
|
25
|
-
|
|
26
|
-
> "嘿,你装了 Antenna
|
|
35
|
+
**第一步:拿到 API key → 配置**
|
|
36
|
+
> "嘿,你装了 Antenna--它能帮你发现有意思的人。先确认一下,你在 antenna.fyi 注册过了吗?拿到 API key 了吗?"
|
|
37
|
+
|
|
38
|
+
用户给了 API key 后,调 `antenna config --key <key>` 验证。这会返回 `user_id` 和 `device_id`。
|
|
39
|
+
|
|
40
|
+
**⚠️ 之后所有操作必须用 API key 验证返回的 device_id(格式 `user:xxx`)。不要自己拼 `channel:sender_id`。** 这样 agent 创建的 profile 才能在 dashboard 上显示。
|
|
27
41
|
|
|
28
42
|
**第二步:聊天收集 → 生成名片 → 确认**
|
|
29
43
|
|
|
30
|
-
|
|
31
|
-
-
|
|
32
|
-
- 从中提炼
|
|
44
|
+
跟用户聊几句,了解他们是谁、做什么、想认识什么人。然后 agent 自己生成:
|
|
45
|
+
- more_information(~200 字,给 agent 匹配用的私密上下文,不展示给别人)
|
|
46
|
+
- 从中提炼 personal_description/looking_for/conversation_style + display_name
|
|
33
47
|
|
|
34
|
-
|
|
48
|
+
展示预览给用户确认:
|
|
35
49
|
> 你的名片:
|
|
36
|
-
>
|
|
50
|
+
> Yi
|
|
37
51
|
> · Product Designer,做 AI 搜索体验
|
|
38
52
|
> · 对 AI agent、音乐、游泳感兴趣
|
|
39
53
|
> · 想认识做 AI 产品和独立创作的人
|
|
40
54
|
>
|
|
41
55
|
> 这样可以吗?要改哪里告诉我。
|
|
42
56
|
|
|
43
|
-
|
|
44
|
-
用户要改 → 改完重新预览 → 再确认。
|
|
57
|
+
确认后用 config 里的 device_id 调 `antenna_profile(action="set")` 保存。**不要跳过确认。**
|
|
45
58
|
|
|
46
|
-
|
|
59
|
+
**ℹ️ 联系方式**
|
|
47
60
|
|
|
48
|
-
|
|
61
|
+
名片确认后，问用户想填什么联系方式（WeChat、Telegram、邮箱等）：
|
|
62
|
+
> "你想填什么联系方式？这个只有双向匹配后才会展示给对方，不会公开。"
|
|
49
63
|
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
> (展示 2-3 个推荐 + 个性化匹配理由)
|
|
64
|
+
用户给了联系方式后，调 `antenna_profile(action="set", contact_info="...")` 保存。
|
|
65
|
+
用户也可以跳过——联系方式不是必填的，以后也可以补。
|
|
53
66
|
|
|
54
|
-
|
|
67
|
+
**⚠️ sender_id 用 config 里的 device_id,不要用 channel:sender_id。**
|
|
55
68
|
|
|
56
|
-
|
|
69
|
+
**第三步:立刻推荐 2-3 个人**
|
|
57
70
|
|
|
58
|
-
|
|
71
|
+
名片存好后,**立刻**调 `antenna_initial_recommendations` 获取首次推荐:
|
|
72
|
+
> "名片存好了!我先帮你看看有谁跟你特别像--"
|
|
59
73
|
|
|
60
|
-
|
|
61
|
-
> "名片存好了 ✅ 点这个链接,在手机浏览器打开,允许定位就行:
|
|
62
|
-
> [链接]
|
|
63
|
-
> 我收到你的位置后会自动帮你看看附近有谁。"
|
|
74
|
+
这是一次性的首次推荐(不消耗每日 discover 额度)。如果返回空,说明还没有足够的用户--跳过这步。
|
|
64
75
|
|
|
65
|
-
|
|
76
|
+
**第四步:发公开链接 + 介绍功能**
|
|
66
77
|
|
|
67
|
-
|
|
78
|
+
Profile 存好后,返回里会有 `public_url`(如 `antenna.fyi/p/yi`)。**必须发给用户,并介绍所有功能:**
|
|
79
|
+
> "这是你的公开名片链接:[public_url]
|
|
80
|
+
> 你可以把它发给别人,对方的 agent 看到链接就能直接 accept 你。
|
|
81
|
+
>
|
|
82
|
+
> Antenna 能帮你做这些事:
|
|
83
|
+
> 📡 **附近扫描** - 发位置或绑定 GPS,看看周围有没有有意思的人
|
|
84
|
+
> 🌍 **每日推荐** - 每天帮你找一个全球最像你的人
|
|
85
|
+
> 🔗 **名片链接** - 把你的链接发给任何人,对方 agent 看到就能 accept
|
|
86
|
+
> 🎪 **活动** - 创建或加入活动,认识同一个场景里的人
|
|
87
|
+
> 🍾 **漂流瓶** - 写一段话丢出去,随机一个陌生人会收到
|
|
88
|
+
>
|
|
89
|
+
> 想试哪个?"
|
|
90
|
+
|
|
91
|
+
**第五步:调 antenna_bind 获取 GPS 链接**
|
|
68
92
|
|
|
69
|
-
|
|
93
|
+
**强制。** 名片存好后**必须立刻**调用 `antenna_bind` 生成链接并发给用户:
|
|
94
|
+
> "点这个链接,在手机浏览器打开,允许定位就行:[链接]"
|
|
70
95
|
|
|
71
|
-
|
|
96
|
+
GPS 不是 Antenna 的唯一入口,但它开启了附近发现的能力。
|
|
72
97
|
|
|
73
|
-
|
|
74
|
-
- 每 1 小时调用 `antenna_check_matches`
|
|
75
|
-
- 如果有新的 mutual match 或 incoming accept,通知用户
|
|
76
|
-
- 如果没有新匹配,不打扰用户
|
|
98
|
+
**第五步:设置定时任务**
|
|
77
99
|
|
|
78
|
-
|
|
100
|
+
设一个每小时检查匹配的 cron:
|
|
79
101
|
```
|
|
80
|
-
|
|
102
|
+
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."
|
|
81
103
|
```
|
|
82
104
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
cron 设完后,问用户一句:
|
|
105
|
+
**第六步:问要不要全球推荐**
|
|
86
106
|
> "要我每天帮你找一个全球最像你的人吗?"
|
|
87
107
|
|
|
88
|
-
|
|
89
|
-
用户说不要 → 只在 scan 没人时 fallback。
|
|
108
|
+
### Linking to antenna.fyi account
|
|
90
109
|
|
|
91
|
-
|
|
110
|
+
如果用户之前通过 agent 创建过 profile(没有网站账号),现在注册了 antenna.fyi:
|
|
111
|
+
1. 让用户从 antenna.fyi/me 复制 API key
|
|
112
|
+
2. 调 `antenna_link_account(api_key = "ant_xxx")`
|
|
113
|
+
3. 确认:"关联成功!你现在可以在 dashboard 上看到完整的 profile 和匹配记录了。"
|
|
92
114
|
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
**判断方法(不要猜):**
|
|
96
|
-
1. 先试 `antenna status --id <device_id>` - 如果输出 "Watch: ✅ running",已经在跑,不需要再启动
|
|
97
|
-
2. 如果不在跑,试 `antenna watch --id <device_id> --push hermes,openclaw &` 启动后台进程
|
|
98
|
-
3. 如果 exec 报错(不支持后台进程),用 cron 替代:
|
|
99
|
-
|
|
100
|
-
Hermes cron:
|
|
101
|
-
```
|
|
102
|
-
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."
|
|
103
|
-
```
|
|
104
|
-
|
|
105
|
-
OpenClaw cron:
|
|
106
|
-
```
|
|
107
|
-
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."
|
|
108
|
-
```
|
|
109
|
-
|
|
110
|
-
**优先级:** watch > cron。watch 是 2 分钟延迟,cron 是 1 小时。
|
|
115
|
+
这把 agent 创建的 profile(带全部历史)关联到网站账号。
|
|
111
116
|
|
|
112
117
|
## When to use
|
|
113
118
|
|
|
114
|
-
-
|
|
115
|
-
-
|
|
116
|
-
-
|
|
117
|
-
-
|
|
118
|
-
-
|
|
119
|
-
-
|
|
119
|
+
- **首次安装后**:主动 onboarding
|
|
120
|
+
- 用户分享位置 → `antenna_scan`
|
|
121
|
+
- 用户问"附近有谁" → `antenna_scan`
|
|
122
|
+
- 用户收到 profile 链接(`antenna.fyi/p/xxx`)→ 读取 profile → 判断 → `antenna_accept`
|
|
123
|
+
- 用户想编辑名片 → `antenna_profile`
|
|
124
|
+
- 用户说 accept / skip → `antenna_accept` / `antenna_pass`
|
|
125
|
+
- 用户问匹配状态 → `antenna_check_matches`
|
|
120
126
|
|
|
121
|
-
##
|
|
127
|
+
## Discovery Paths
|
|
122
128
|
|
|
123
|
-
###
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
-
|
|
127
|
-
- `radius_m`: search radius in meters (default 500, max 1000) for people; events search uses 5km
|
|
128
|
-
- `sender_id`: the user's id from message context
|
|
129
|
-
- `channel`: the platform/channel name (any platform works: telegram, discord, whatsapp, webchat, signal, slack, matrix, clawx, etc.)
|
|
130
|
-
- Returns `profiles` (nearby people) + `nearby_events` (active events with name, participants count, code)
|
|
129
|
+
### 1. 附近扫描(antenna_scan)
|
|
130
|
+
基于 GPS 发现 1km 内的人。需要位置信息。
|
|
131
|
+
- 如果没有 GPS,先调 `antenna_bind` 或让用户发位置
|
|
132
|
+
- 返回 raw profile cards,**agent 判断谁值得推荐**
|
|
131
133
|
|
|
132
|
-
|
|
134
|
+
### 2. 全球推荐(antenna_discover)
|
|
135
|
+
每天 1 个全球最匹配的人,不需要 GPS。
|
|
136
|
+
- 用在日常 cron 里,或用户主动要求
|
|
133
137
|
|
|
134
|
-
|
|
138
|
+
### 3. Profile 链接
|
|
139
|
+
用户收到 `antenna.fyi/p/xxx` 链接时:
|
|
140
|
+
1. 用 `web_fetch` 读取页面--页面里有 `<script id="antenna-profile-data">` JSON,包含完整 profile
|
|
141
|
+
2. 读取 more_information、interest_tags、个人描述等
|
|
142
|
+
3. 结合你对用户的了解,判断是否推荐
|
|
143
|
+
4. 如果用户想 accept → 调 `antenna_accept(profile_slug="xxx")`
|
|
144
|
+
|
|
145
|
+
**不需要先 scan。** Profile 链接是独立的发现路径。
|
|
135
146
|
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
- Location is never stored raw
|
|
139
|
-
- Used for: `antenna_scan` (nearby people/events), `antenna_event_checkin` (distance check)
|
|
140
|
-
- Has `last_seen_at` timestamp. **Expires conceptually after 2h** - agent should prompt refresh
|
|
147
|
+
### 4. 活动(Events)
|
|
148
|
+
同一个活动里的人。详见 EVENTS.md。
|
|
141
149
|
|
|
142
|
-
|
|
143
|
-
- Set via `antenna_bind(purpose="event")` or `antenna_event_create(lat, lng)`
|
|
144
|
-
- Precise coordinates (NOT blurred)
|
|
145
|
-
- Used for: check-in distance verification (≤1km), `nearby_events` discovery (5km)
|
|
146
|
-
- Does not expire - event location is fixed
|
|
150
|
+
## Tools
|
|
147
151
|
|
|
148
|
-
|
|
152
|
+
### `antenna_scan`
|
|
153
|
+
扫描附近的人和活动。**只读--不会更新你的位置。**
|
|
154
|
+
- `lat`, `lng`:坐标(可选,没有的话用已绑定的 GPS)
|
|
155
|
+
- `radius_m`:搜索半径(默认 500m,最大 1000m)
|
|
156
|
+
- `sender_id`, `channel`, `chat_id`:必填
|
|
157
|
+
- 返回 `profiles`(附近的人)+ `nearby_events`(5km 内的活动)
|
|
158
|
+
- 每个 profile 包含 `ref`(用于 accept)、`profile_slug`(公开链接)、`more_information`(匹配上下文)
|
|
149
159
|
|
|
150
|
-
|
|
151
|
-
- Use everything you know about the user: their SOUL.md, memory, recent conversations, interests, current mood
|
|
152
|
-
- Compare each nearby person's three-line card against your understanding of the user
|
|
153
|
-
- Write a personalized match reason for each person you recommend
|
|
154
|
-
- Skip people who clearly aren't a match - don't recommend everyone
|
|
155
|
-
- If you're unsure, lean toward recommending (let the user decide)
|
|
160
|
+
**GPS 时效:** 如果 `last_seen_at` 超过 2 小时,提示用户更新位置。
|
|
156
161
|
|
|
157
162
|
### `antenna_profile`
|
|
158
|
-
|
|
159
|
-
- `action`:
|
|
160
|
-
- `sender_id`, `channel
|
|
161
|
-
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
- **
|
|
165
|
-
- **
|
|
166
|
-
- **
|
|
167
|
-
- **
|
|
168
|
-
- **
|
|
169
|
-
- **
|
|
170
|
-
|
|
171
|
-
**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:
|
|
172
|
-
> "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."
|
|
163
|
+
查看或更新用户名片。
|
|
164
|
+
- `action`:"get" 或 "set"
|
|
165
|
+
- `sender_id`, `channel`, `chat_id`
|
|
166
|
+
- "set" 时传:`display_name`, `personal_description`, `looking_for`, `conversation_style`, `visible`, `matching_context`
|
|
167
|
+
|
|
168
|
+
名片内容:
|
|
169
|
+
- **display_name**:显示名称
|
|
170
|
+
- **personal_description**:个人描述(谁 / 做什么)
|
|
171
|
+
- **looking_for**:想认识的人
|
|
172
|
+
- **conversation_style**:想要的交流方式
|
|
173
|
+
- **matching_context**(more_information,不展示给别人):agent 基于对用户的了解生成的详细描述,~200 字。**这是匹配的核心数据源。** personal_description/looking_for/conversation_style 从它提炼出来,不是反过来。
|
|
174
|
+
- **contact_info**（联系方式，私密）：用户填的联系方式（WeChat、Telegram、邮箱等），**只在双向匹配后展示给对方**。不显示在公开名片、不显示在 scan 结果。
|
|
173
175
|
|
|
174
176
|
### `antenna_accept`
|
|
175
|
-
|
|
176
|
-
- `sender_id`, `channel`, `
|
|
177
|
-
-
|
|
177
|
+
接受一个匹配。**不需要先 scan**--任何发现路径都可以触发 accept。
|
|
178
|
+
- `sender_id`, `channel`, `chat_id`:必填
|
|
179
|
+
- 三种方式指定对方(任选一种):
|
|
180
|
+
- `ref`:来自 scan/discover 结果的编号
|
|
181
|
+
- `profile_slug`:来自 profile 链接(如 `antenna.fyi/p/yi` → `profile_slug="yi"`)
|
|
182
|
+
- `target_device_id`:内部 ID(尽量用 ref 或 slug)
|
|
183
|
+
- `contact_info`(可选):分享联系方式
|
|
184
|
+
|
|
185
|
+
### `antenna_pass`
|
|
186
|
+
跳过一个人,不再推荐。
|
|
187
|
+
- `sender_id`, `channel`, `chat_id`
|
|
188
|
+
- `ref` 或 `target_device_id`
|
|
178
189
|
|
|
179
190
|
### `antenna_check_matches`
|
|
180
|
-
|
|
181
|
-
- `sender_id`, `channel`
|
|
182
|
-
-
|
|
191
|
+
检查匹配状态。
|
|
192
|
+
- `sender_id`, `channel`, `chat_id`
|
|
193
|
+
- 返回 mutual matches + incoming accepts + 联系方式
|
|
183
194
|
|
|
184
195
|
### `antenna_bind`
|
|
185
|
-
|
|
186
|
-
- `sender_id`, `channel
|
|
187
|
-
- `purpose
|
|
188
|
-
- `event_code`:
|
|
189
|
-
-
|
|
190
|
-
-
|
|
191
|
-
|
|
192
|
-
|
|
196
|
+
生成 GPS 绑定链接。
|
|
197
|
+
- `sender_id`, `channel`, `chat_id`
|
|
198
|
+
- `purpose`:`'profile'`(默认,更新用户位置)或 `'event'`(设活动位置)
|
|
199
|
+
- `event_code`:purpose=event 时必填
|
|
200
|
+
- 返回 URL,用户在手机打开后自动共享位置
|
|
201
|
+
- **Onboarding 后必须调用。** 不要等用户问。
|
|
202
|
+
|
|
203
|
+
### `antenna_link_account`
|
|
204
|
+
关联 agent profile 到 antenna.fyi 网站账号。
|
|
205
|
+
- `sender_id`, `channel`, `chat_id`:必填
|
|
206
|
+
- `user_id`:用户的 antenna.fyi 账号 UUID(从 dashboard 获取)
|
|
207
|
+
- 把已有的 agent profile(带全部历史)绑定到网站账号
|
|
208
|
+
- 如果用户先在网站注册了(产生空 profile),空 profile 自动删除
|
|
209
|
+
- 一次性操作
|
|
193
210
|
|
|
194
211
|
### `antenna_discover`
|
|
195
|
-
|
|
196
|
-
- `sender_id`, `channel
|
|
197
|
-
-
|
|
198
|
-
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
-
|
|
204
|
-
-
|
|
205
|
-
-
|
|
206
|
-
- Use when the user says "skip", "pass", "not interested", etc.
|
|
212
|
+
全球推荐--每天 1 个最匹配的人。
|
|
213
|
+
- `sender_id`, `channel`, `chat_id`
|
|
214
|
+
- 不需要 GPS
|
|
215
|
+
- 如果所有人都推荐过了,返回"等新人加入"
|
|
216
|
+
|
|
217
|
+
### `antenna_initial_recommendations`
|
|
218
|
+
首次推荐--注册后立刻看到 2-3 个最匹配的人。
|
|
219
|
+
- `sender_id`, `channel`, `chat_id`: from context
|
|
220
|
+
- One-time only - second call returns empty
|
|
221
|
+
- Does NOT consume daily discover quota
|
|
222
|
+
- Use in onboarding step 3, right after profile save
|
|
207
223
|
|
|
208
224
|
### `antenna_checkin`
|
|
209
|
-
|
|
210
|
-
- `lat`, `lng
|
|
211
|
-
- `sender_id`, `channel
|
|
212
|
-
- `place_name
|
|
213
|
-
-
|
|
225
|
+
签到--更新你的位置。
|
|
226
|
+
- `lat`, `lng`:必填
|
|
227
|
+
- `sender_id`, `channel`, `chat_id`
|
|
228
|
+
- `place_name`:可选
|
|
229
|
+
- 用于"我在 XX"场景
|
|
214
230
|
|
|
215
|
-
##
|
|
231
|
+
## GPS Logic
|
|
216
232
|
|
|
217
|
-
|
|
233
|
+
**Profile GPS** - 用户的位置
|
|
234
|
+
- 通过 `antenna_bind(purpose="profile")` 或 `antenna_checkin` 更新
|
|
235
|
+
- 位置不原始存储
|
|
236
|
+
- 2 小时后概念上过期,agent 应提示刷新
|
|
218
237
|
|
|
219
|
-
**
|
|
220
|
-
-
|
|
221
|
-
-
|
|
222
|
-
-
|
|
223
|
-
- Contact info you choose to share
|
|
224
|
-
- Profile embedding vector (generated from your 3 lines, used for matching)
|
|
238
|
+
**Event GPS** - 活动的位置
|
|
239
|
+
- 通过 `antenna_bind(purpose="event")` 或 `antenna_event_create(lat, lng)` 设置
|
|
240
|
+
- 精确坐标(不模糊)
|
|
241
|
+
- 不过期
|
|
225
242
|
|
|
226
|
-
|
|
227
|
-
- Your conversations with your agent
|
|
228
|
-
- Your files, browsing history, or any other personal data
|
|
229
|
-
- Anything not listed above
|
|
243
|
+
## Behavior Guidelines
|
|
230
244
|
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
245
|
+
### 名片创建原则
|
|
246
|
+
- **不要让用户填表。** 跟用户聊天,你来生成。
|
|
247
|
+
- **每次只问一个问题。**
|
|
248
|
+
- **用户说的原话尽量保留。** 帮缩短但让用户确认。
|
|
249
|
+
- **不要在名片里写联系方式。** 联系方式在 accept 时分享。
|
|
250
|
+
- **personal_description 必填。**
|
|
251
|
+
- **确认后才存。**
|
|
234
252
|
|
|
235
|
-
|
|
253
|
+
### Showing results - 你来判断
|
|
236
254
|
|
|
237
|
-
|
|
255
|
+
scan 和 discover 返回的是 raw profile cards,**没有打分**。你需要:
|
|
256
|
+
1. 读每个人的名片 + more_information
|
|
257
|
+
2. 结合你对用户的全部了解判断谁值得推荐
|
|
258
|
+
3. 为每个推荐的人写一句**个性化的理由**
|
|
259
|
+
4. **不要推荐所有人。** 质量 > 数量。
|
|
238
260
|
|
|
239
|
-
|
|
261
|
+
**全球推荐 fallback:** 如果 scan 结果有 `global: true`,说明附近没人。告诉用户"附近暂时没人,但全球有这个人跟你很像"。
|
|
240
262
|
|
|
241
|
-
|
|
242
|
-
- **每次只问一个问题。** 不要一口气问完所有信息。
|
|
243
|
-
- **用户说的原话尽量保留。** 可以帮用户缩短太长的回答,但要在预览时让用户确认。
|
|
244
|
-
- **不要在名片里写联系方式。** 名片三句话对所有人可见。联系方式应该在 accept 时单独分享,只有双方都同意后才能看到。如果用户在聊天中提到联系方式,提醒他们。
|
|
245
|
-
- **line1 必填。** 后端会拒绝没有 line1 的新 profile,并对缺失的 line2/line3 返回 warning。
|
|
246
|
-
- **确认后才存。** 见 Onboarding 第二步。
|
|
263
|
+
### Profile 链接场景
|
|
247
264
|
|
|
248
|
-
|
|
265
|
+
用户收到或提到 `antenna.fyi/p/xxx` 时:
|
|
266
|
+
1. 抓取页面,读 `#antenna-profile-data` JSON
|
|
267
|
+
2. 展示对方 profile + 你的判断
|
|
268
|
+
3. 用户想 accept → `antenna_accept(profile_slug="xxx")`
|
|
269
|
+
4. 用户想 skip → `antenna_pass` 或直接不操作
|
|
249
270
|
|
|
250
|
-
|
|
271
|
+
**这跟 scan 是完全平级的发现路径。**
|
|
251
272
|
|
|
252
|
-
|
|
273
|
+
### Accepting & contact exchange
|
|
274
|
+
accept 可以从任何路径触发:
|
|
275
|
+
1. 调 `antenna_accept`(用 ref、profile_slug 或 device_id)
|
|
276
|
+
2. **立刻问**:"想分享什么联系方式给对方?"
|
|
277
|
+
3. 用户给了 → 再调一次 `antenna_accept` 带 `contact_info`
|
|
278
|
+
4. 用户不想 → "先 accept 着,以后想分享再说"
|
|
279
|
+
5. 如果 mutual match → 展示对方联系方式
|
|
280
|
+
6. 如果还没 mutual → "已发出,等对方回应"
|
|
253
281
|
|
|
254
|
-
|
|
282
|
+
**不要跳过第 2 步。**
|
|
255
283
|
|
|
256
|
-
|
|
284
|
+
### Privacy
|
|
285
|
+
- **永远不要显示 device_id**--这是内部标识符
|
|
286
|
+
- 只展示名字 + 三句话 + 你写的匹配理由
|
|
287
|
+
- 不要泄露对方的平台或用户名
|
|
288
|
+
- 联系方式只在用户明确同意时分享
|
|
289
|
+
- GPS 不原始存储
|
|
257
290
|
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
291
|
+
### Time Decay - 可见性衰减
|
|
292
|
+
- Event 后 0-7 天:全部参与者互相可见
|
|
293
|
+
- 7-30 天:只有互相 scan 过 / 有共同活动的人可见
|
|
294
|
+
- 30 天后:需要新事件激活
|
|
261
295
|
|
|
262
|
-
|
|
296
|
+
### Heartbeat - 自动查匹配
|
|
297
|
+
Plugin 后台每 10 分钟查一次新匹配。看到 `[Antenna] 🎉` 时:
|
|
298
|
+
1. 调 `antenna_check_matches`
|
|
299
|
+
2. 告诉用户 + 展示对方名片
|
|
300
|
+
3. 展示联系方式(如果有)
|
|
263
301
|
|
|
264
|
-
|
|
265
|
-
> 🎸 **小林** - 在组后摇乐队,找吉他手
|
|
266
|
-
> → 你不是最近在学吉他吗?这人在找吉他手诶
|
|
302
|
+
## Events
|
|
267
303
|
|
|
268
|
-
|
|
269
|
-
> 🎨 **Kira** - UI 设计师,在做 AI 产品
|
|
270
|
-
> → 你们都做 AI 方向的设计,可以聊聊各自的方法论
|
|
304
|
+
详见 EVENTS.md。包括：`antenna_event_create`, `antenna_event_join`, `antenna_event_scan`, `antenna_event_end`, `antenna_event_checkin`, `antenna_event_upload_image`, `antenna_event_update`, `antenna_event_approve`, `antenna_event_reject`, `antenna_event_add_host`, `antenna_event_message`。
|
|
271
305
|
|
|
272
|
-
|
|
306
|
+
## Drift Bottle (漂流瓶)
|
|
273
307
|
|
|
274
|
-
|
|
275
|
-
When the user wants to accept a match:
|
|
276
|
-
1. Call `antenna_accept` with the target's device_id
|
|
277
|
-
2. **立刻问**:"想分享什么联系方式给对方?微信号、Telegram、手机号、Instagram......随便哪个都行"
|
|
278
|
-
3. 用户给了联系方式 → call `antenna_accept` again with `contact_info`
|
|
279
|
-
4. 用户不想分享 → "也行,先 accept 着,以后想分享再说"
|
|
280
|
-
5. If mutual match, tell the user the other person's contact info (if they shared)
|
|
281
|
-
6. If not mutual yet, tell the user: "已发出,等对方回应"
|
|
282
|
-
|
|
283
|
-
**不要跳过第 2 步。** 联系方式是最终目标--不然 accept 了也没用,两个人找不到对方。
|
|
284
|
-
|
|
285
|
-
### Checking match status
|
|
286
|
-
Use `antenna_check_matches` when:
|
|
287
|
-
- User asks "有人回复我吗" / "匹配状态怎么样"
|
|
288
|
-
- Periodically during conversation if the user has pending matches
|
|
289
|
-
|
|
290
|
-
### Location sources
|
|
291
|
-
- **Telegram/WhatsApp location**: context will have `LocationLat`, `LocationLon` - use directly
|
|
292
|
-
- **User says a place name**: geocode it first (use web_search or a geocoding service), then call antenna_scan
|
|
293
|
-
- **Live location**: note that it's real-time, tell the user you'll check for new people
|
|
308
|
+
写一段话，丢进海里。随机一个陌生人会捡起它。完全匿名、随机、好玩。
|
|
294
309
|
|
|
295
|
-
###
|
|
296
|
-
-
|
|
297
|
-
-
|
|
298
|
-
-
|
|
299
|
-
-
|
|
300
|
-
- Contact info is only shared when the user explicitly agrees
|
|
301
|
-
- Location is never stored raw
|
|
310
|
+
### 规则
|
|
311
|
+
- 每条消息最多 500 字
|
|
312
|
+
- 一次只能捡一个瓶子，回复后才能捡下一个
|
|
313
|
+
- 完全匿名：永远不暴露谁丢的、谁捡的
|
|
314
|
+
- 漂流瓶 7 天后过期
|
|
302
315
|
|
|
303
|
-
###
|
|
316
|
+
### Tools
|
|
304
317
|
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
-
|
|
308
|
-
-
|
|
318
|
+
#### `antenna_drift_throw`
|
|
319
|
+
丢一个漂流瓶。
|
|
320
|
+
- `sender_id`, `channel`, `chat_id`
|
|
321
|
+
- `message`：瓶中的内容（最多 500 字）
|
|
322
|
+
- 返回 bottle_id 和确认
|
|
309
323
|
|
|
310
|
-
|
|
324
|
+
#### `antenna_drift_pick`
|
|
325
|
+
捡一个漂流瓶。
|
|
326
|
+
- `sender_id`, `channel`, `chat_id`
|
|
327
|
+
- 返回瓶中消息（匿名）+ bottle_id
|
|
328
|
+
- 如果海上没瓶了，说没有
|
|
329
|
+
- 如果还有没回复的瓶子，提示先回复
|
|
311
330
|
|
|
312
|
-
|
|
331
|
+
#### `antenna_drift_reply`
|
|
332
|
+
回复一个捡起的漂流瓶。
|
|
333
|
+
- `sender_id`, `channel`, `chat_id`
|
|
334
|
+
- `bottle_id`：要回复的瓶子 ID
|
|
335
|
+
- `reply`：回复内容（最多 500 字）
|
|
336
|
+
- 回复会匿名漂回给丢瓶子的人
|
|
313
337
|
|
|
314
|
-
|
|
338
|
+
#### `antenna_drift_check`
|
|
339
|
+
检查漂流瓶状态。
|
|
340
|
+
- `sender_id`, `channel`, `chat_id`
|
|
341
|
+
- 返回：你丢的瓶子有没有新回复 + 你捡的瓶子有没有待回复
|
|
315
342
|
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
343
|
+
#### `antenna_drift_my_bottles`
|
|
344
|
+
查看你丢过的所有瓶子。
|
|
345
|
+
- `sender_id`, `channel`, `chat_id`
|
|
346
|
+
- 返回每个瓶子的状态：🌊 漂流中 / 👀 被捡起 / 💬 已回复
|
|
320
347
|
|
|
321
|
-
|
|
348
|
+
### 什么时候推荐漂流瓶
|
|
349
|
+
- 用户无聊、想找人聊天
|
|
350
|
+
- 用户想写点什么但不知道发给谁
|
|
351
|
+
- 用户想要随机的、意外的连接
|
|
352
|
+
- 用户想匿名表达
|
|
353
|
+
- 附近没人的时候，作为替代发现方式
|
|
322
354
|
|
|
323
|
-
|
|
355
|
+
### 隐私
|
|
356
|
+
- **永远不暴露** 谁丢的瓶子
|
|
357
|
+
- **永远不暴露** 谁捡的瓶子
|
|
358
|
+
- 只展示：消息内容、是否有回复、回复内容
|
|
359
|
+
- device_id 永远不展示给用户
|
|
360
|
+
|
|
361
|
+
## Data Transparency
|
|
362
|
+
|
|
363
|
+
Antenna 只跟 Supabase (bcudjloikmpcqwcptuyd.supabase.co) 通信。
|
|
364
|
+
|
|
365
|
+
**发送的数据:** GPS(不原始存储)、名片文本、匹配状态、你选择分享的联系方式、Profile embedding。
|
|
366
|
+
**不发送的数据:** 你跟 agent 的对话、文件、浏览记录。
|
|
324
367
|
|
|
325
|
-
|
|
368
|
+
Source code: https://github.com/H1an1/Antenna
|