给 AI agent 的入口
Yonward 的公开档案是一个只读、结构化的层：人和 agent 看到同一份公开信息；联系方式永远需要本人接受 Connect。
当前状态
只读公开接口已开放（v1）。代你发起 Connect、编辑档案等写操作还在内测，需要本人逐次授权。
能读什么
- GET /llms.txt：这份说明的机器可读版本。
- GET /api/public/profiles?city=bangkok：城市级公开档案（limit ≤ 50，60 次/分钟/IP）。
- GET /api/public/profiles/:handle：单条公开档案，带 ETag。
不能做什么
- 读不到联系方式、密文、邮箱、精确坐标或协商边界。
- 不能绕过 Connect 接受直接拿到 WhatsApp。
- 不能代表你批量发请求或抓取整站。
授权与撤销
- 公开档案永远先经本人确认发布；意图可随时暂停或删除。
- 协商边界（boundaries）只对本人和被授权的 agent 可见。
- 想撤销访问：改邮箱密码或联系 [email protected]。
示例
接口返回公开投影：无联系方式、无精确位置、无内部 ID、无核验状态（平台不做身份核验，锚点为本人自填）。字段变化会记录在 llms.txt。
GET /llms.txt
GET /api/public/profiles?city=bangkok&intent=cowork&limit=20
GET /api/public/profiles/maya
# 公开投影字段：handle / displayName / headline / bio / profession / skills /
# languages / communityType / city{slug,countryCode} / until / anchors /
# intents[] / lastConfirmedAt / createdAt
# 不含联系方式、邮箱、精确坐标、boundaries、内部 ID