overview · 总览
生态接入协议 v1 · 给独立博客生态的开发者参考
欢迎来到 AstraHub 开发者接入指南。
我们诚挚邀请来自各个独立博客生态的开发者一起共建这张星链：
WordPress / WooCommerce 插件作者
Halo 插件 / 主题作者
Hugo Hexo Jekyll / Astro 等静态站点的构建钩子作者
Typecho Z-BlogPHP EMLOG 等老牌 PHP 博客系统的扩展作者
Ghost Mastodon 自建 CMS 的运营者
用 Go Rust Node.js Python PHP / Java 等任何语言写自定义脚本的开发者
只要你的平台后端能发出 HTTPS 请求并计算 HMAC-SHA256，就能接入 AstraHub。本文档描述的是 Hub 服务端 API，不要求使用 Halo 插件，也不要求把密钥暴露给浏览器。
——
AstraHub 是一个面向独立博客生态的星链协作系统。它不是单纯的友链展示页，而是把博客之间原本分散、孤立的友链关系、节点身份和公开动态组织成一个可联动、可检索、可探索的博客关系网络。
接入价值
连接：把原本分散的独立博客连接起来，形成真实可见的博客关系网络。每一条友链都成为图谱中的一条边，被全网共同读取、共同放大。
发现：沿着"朋友的朋友"快速触达更多与你气质相近的博主与圈层。从图谱、标签和节点关系中发现你想要的博客与创作者，不再一个个手动翻友链页。
曝光：加入生态的人越多，每个博客都会获得更高的可见度——出现在更多关系链、动态流和检索结果中。
圈层归属：系统会根据站点信息、内容主题与标签，把博客自动归入对应星团（圈层）。同圈层的博主彼此可见、相互发现。
关系图谱：交互式星链图谱把站点之间的友链与圈层关系可视化展现。一眼看清谁在你的圈层里、谁处在网络枢纽位置、哪些节点之间存在高频连接。
友链交换新范式：在 AstraHub 看到心仪的博客，直接发起友链申请，对方在自己后台一键审核通过，双向友链同步生效，整个换链过程不超过 1 分钟。
跨站协作：基于 friend-invitations 协议（v1）跨站发起友链邀请、批量解析关系，配合 WebSocket 实时事件做即时通知。
全网检索：聚合后的全网友链信号流（/v1/planet/feed）、友链星球（/v1/planet/links）、节点聚类（/v1/planet/clusters）、RSS 深空（/v1/planet/rss-deep-space/*）等查询能力，可接入自身后台、主题或客户端。
迁移无忧：换服务器、换域名后，通过 boarding-restore 邮箱验证码恢复站点身份，原有的友链关系与圈层归属全部保留。
接入参考
入门思考与生态背景：
https://www.aobp.cn/archives/AstraHub
《AstraHub 星链插件 · 一篇写给独立博客生态的使用与思考》
接入流程
注册：用一次性邀请码（X-BP-Invitation-Code）换取永久 siteId + apiKey
上报：由你的服务端采集本地友链、RSS、文章/页面数据，再主动调用 /v1/site-link-edges/push 与 /v1/graph/push 推送给 Hub
查询：由你的服务端用签名请求查询聚合后的星系数据，再回传给自己的后台、主题或客户端。友链星球、星链资讯和关系图都走签名 GET
协作：通过 friend-invitations 跨站发起友链邀请、relations/sites/batch 批量解析关系
实时：用 WebSocket 订阅 friend_invitation_* site_link_edges_pushed graph_pushed 等事件做即时通知
数据格式协议版本：bp.site-links.v1、bp.graph.v1、friend-invitations v1。
本文档展示的请求 / 响应为协议示例；实际接入请使用自己注册后得到的真实 siteId + apiKey，在接入方服务端生成签名并调用 Hub。