AstraHub 3.0.3

本次更新重点优化了插件后台的数据加载机制，减少重复请求、服务器流量和数据库压力，并提升页面切换速度。

主要更新

• 优化插件内部页面切换机制。
• 各页面改为首次访问时加载数据。
• 已访问页面的数据会保留在当前插件会话中。
• 再次切换回来时直接展示已有数据，不再重复请求服务端。
• 保留列表分页、滚动位置、聊天记录和页面操作状态。

实时同步优化

• 世界频道继续通过 WebSocket实时接收新消息和消息变化。
• 友链邀请、审核结果和友链关系变化继续实时同步。
• 补齐 site_profile_updated 事件处理。
• 站点名称、头像和资料发生变化时可及时更新。
• 仅在实时事件信息不足时刷新对应数据，不再因普通切页重新加载。

关系图优化

• 保留“点击开始渲染后才加载”的机制。
• 未点击渲染时不会请求关系图数据。
• 已加载的关系图在插件内部切页后继续保留。
• 离开关系图期间收到关系变化时暂缓刷新，返回后再进行更新。
• 避免隐藏状态下重复执行高开销的图谱请求。

涉及页面

• 友链星球
• 友链审核管理
• 资讯中心
• 星际通讯
• 关系图
• 接入配置

仍会正常请求的操作

以下操作属于主动查询或必要的数据同步，仍会正常访问服务端：

• 首次打开页面
• 搜索内容
• 切换筛选条件或审核分类
• 加载更多数据
• 手动刷新
• 切换 AstraHub 节点
• WebSocket断线后的必要状态校准

更新效果

• 插件内部重复切页基本不再产生业务数据请求。
• 页面切换响应速度更快。
• 减少服务端带宽消耗。
• 降低数据库重复查询压力。
• 改善世界频道、资讯和大型列表页面的使用体验。
• 实时数据仍由 WebSocket持续同步。

查看版本详情

AstraHub v3.0.2 更新日志

AstraHub 3.0 是从单节点接入迈向多节点协同的一次重大跨越。

这一版本不只是界面和版本号的更新，而是对节点架构、图谱同步、实时通信、故障切换、运行状态存储以及插件交互体验的一次整体升级。

Astra 节点团队

Astra 节点能力由以下成员共同提供强力驱动：

感谢每一位伙伴为 AstraHub 的贡献。

重大更新：正式进入多节点时代

插件启动后会自动检测各节点状态和连接延迟，并根据实际可用情况选择服务节点。

主要能力包括：

• 自动并行检测全部节点；
• 展示各节点当前状态和检测延迟；
• 根据最新检测结果选择低延迟节点；
• 支持用户手动切换服务节点；
• 保持已选节点，减少频繁跳转造成的连接抖动；
• 节点业务请求失败后自动切换；
• 故障节点进入短暂冷却，避免持续请求异常节点；
• 节点恢复后自动重新加入候选列表；
• 所有正式节点共享 AstraHub 数据与实时能力。

Bug修复

• 其他一些你或许并不在意的细节

查看版本详情

AstraHub 插件 2.7.16 紧急更新公告

[!CAUTION]
本次更新为强制更新，请所有已接入 AstraHub 的站点管理员尽快完成升级。

由于 AstraHub 服务端迁移及数据恢复需要，旧版本插件可能出现站点识别失败、自动上报失败、星链信息推送失败或显示“站点未注册”等问题。

必须更新的原因

本次更新加入了临时站点身份恢复能力。插件升级后，会使用站点本地保留的接入配置，与新的 AstraHub 服务端重新确认并恢复原有站点身份。

恢复内容包括：

• 原站点 ID
• 原站点接入凭据
• 绑定邮箱
• 站点地址
• 站点名称、节点名称、头像及 RSS 地址
• 星链和友链关系数据

由于恢复过程依赖限时开放的服务端恢复窗口，未及时升级的站点可能无法自动恢复原有接入状态。

查看版本详情

首页滚动稳定性

• 修正首页 Hero 区域与虚拟列表之间的可视范围计算。
• 修复友链星球加载多页数据后，收到邀请、关系变化等实时事件时重新退回第一页的问题。

分页请求竞态修复

• 为首页分页请求增加请求代次保护，较慢的旧请求不再覆盖较新的列表状态。

星际通讯首屏加载优化

• 世界频道消息数据完成写入后即可进入界面，不再等待已读回执完成。

查看版本详情

资料更新

• 友链星球开始消费完整站点资料更新事件，命中对应 siteId 或历史 URL 后立即更新卡片，并在后台重新读取 Hub 权威快照。

UI优化

• 将“启用主星实时播报”开关移入“前台显示”卡片，排列在“显示前台挂件”下方。
• 两个开关继续使用各自独立的配置字段和保存逻辑，仅收敛界面层级，不改变既有功能行为。

Bug修复

• 修复本地残留的链接创建接口。

数据搬家（旧Bug）

• 修复“友链搬家”入口，以 AstraHub 服务端快照为唯一权威数据源，完整重建当前站点的 Halo Link 与 LinkGroup。站点搬迁/数据丢失可一键重载，找回互联站点。

资料同步（旧Bug）

• 站点名称、站点 URL、星链节点名、站点简介、头像和 RSS 地址现已纳入同一份完整资料更新事件。

查看版本详情

友链邀请与本地建链

• 邀请列表改为直接读取权威聚合接口，统一收件箱、发件箱和状态筛选，避免本地缓存状态不一致。
• 对方同意邀请后，WebSocket 事件会通知邀请方，插件自动创建或复用本地 Halo Link，并完成回执。
• 邀请事件统一携带方向、双方站点资料和处理状态，前端红点、列表卡片与实时事件使用同一份数据。

星图库实时更新

• 扩充星图库 WebSocket 事件解析，统一识别事件中的来源站点、目标站点及受影响站点集合。

星链资讯

• 优化资讯来源的增量加载状态，组件卸载后不再继续写入过期响应。

查看版本详情

• 优化友链管理与星链资讯接口，提高数据加载速度。
• 优化星图库接口，提高数据加载速度。

查看版本详情

新增与优化，建议升级

• 新增世界频道首屏聚合，减少首屏多接口并发请求。
• 友链管理页改用聚合接口加载核心数据，移除分散请求链路，提高加载速度。
• 星链资讯页面优化数据加载链路，减少重复请求，修复部分 RSS 来源列表重复展示和加载不稳定问题。
• 世界频道新增历史阅读位置提示，可快速回到上次阅读位置；同时优化未读提示、@ 提醒、自定义表情包、成员列表、右键 @TA、引用消息等交互。

查看版本详情

• 修复世界频道未读信息统计问题
• 其他一些你或许并不在意的优化…

查看版本详情

• 紧急修复 Halo 2.25.5 下插件页面切换失败的问题。

查看版本详情

• 适配 Halo 2.25.3 控制台前端依赖，修复新版 Halo 下可能出现的控制台加载异常。
• 增强实时通知链路：支持 WebSocket、SSE 与事件补偿拉取自动切换。
• 修复世界频道消息气泡中星系名称显示不准确的问题。

查看版本详情

新增

• 新增世界频道。
• 支持已接入星系在同一世界频道内实时交流。
• 支持消息发送、撤回、举报、禁言提示、自定义表情包、成员列表、成员详情、最近文章展示等能力。
• 支持世界频道首次使用协议确认，由服务端下发协议内容。
• 支持世界频道错误提示优化，违规内容、禁言、频率限制、表情包上传失败、撤回超时等场景会显示明确提示。

修复

• 修复关系图首次渲染后球体不在视图中心的问题。
• 修复关系图需要手动点击「重置」后才能看到完整球体的问题。
• 修复关系图未点击渲染前仍可能看到图谱残影的问题。
• 修复关系图节点提示展示“已接入 / 未接入”状态造成干扰的问题。

优化

• 关系图改为手动点击「开始渲染」后再加载，避免进入页面后自动渲染造成性能消耗。
• 关系图节点渲染上限提升至 5000。
• 简化关系图「开始渲染」按钮样式。

查看版本详情

新增与增强

1. 支持WebSocket 实时刷新

• 新增 ** WebSocket 事件监听**，当星系联盟、星系关系、星系资料、星际资讯等数据发生变化后，插件会自动刷新本地星图库快照并推送给主题页面。
• 更新 不再依赖后台手动点击“重新同步”，主题侧可以直接接收新的本地快照结果。
• 对连续到达的实时事件增加 合并与节流处理，避免短时间内重复触发刷新，提升页面数据更新的及时性与稳定性。

2. 星图库主题侧数据推送链路补强

• 新增星图库专用路由、服务与 WebSocket 处理链路，统一承接实时事件、快照重建与前台推送。
• 优化本地星图库快照的刷新时机，保证主题页面获取到的是最新一轮聚合后的数据结果。

问题修复

修复Bug：收紧前端删除入口判定，只有 目标站点已接入插件 且关系状态为 following / mutual 时，才允许显示“删除友链 / 解除关系”按钮。

查看版本详情

Bug修复

星球删除逻辑改为按关系状态分流：单向关注仅删除本站到对方的关注关系，互相关注才执行解除关系。

查看版本详情

AstraHub 插件 2.6.0 更新说明

主题接入方式

AstraHub 星图库采用 REST API + WebSocket 的方式对外提供数据。

插件状态探测

主题页面建议先请求状态接口，用于判断 AstraHub 插件是否已启用、星图库数据是否可用。

const statusRes = await fetch('/apis/anonymous.astrahub.halo.run/v1alpha1/star-gallery/-/status', {
  method: 'GET',
  credentials: 'same-origin',
  headers: {
    Accept: 'application/json',
  },
});

if (!statusRes.ok) {
  // 插件未安装、未启用，或接口不可用
}

const status = await statusRes.json();

if (!status.available) {
  // 插件已启用，但星图库数据尚不可用
}

返回示例：

{
  "available": true,
  "generatedAt": "2026-06-28T00:00:00Z",
  "relationCount": 64
}

获取星图库快照

状态可用后，请求完整快照接口。

const snapshotRes = await fetch('/apis/anonymous.astrahub.halo.run/v1alpha1/star-gallery/-/snapshot', {
  method: 'GET',
  credentials: 'same-origin',
  headers: {
    Accept: 'application/json',
  },
});

const snapshot = await snapshotRes.json();

快照主要字段：

• snapshot.profile // 本站 / 本星系信息
• snapshot.sectors // 星系联盟卡片
• snapshot.posts // 星际资讯

星系成员分页

每个星系卡片会提供 planetsUrl，主题可以直接请求该地址获取星系成员。

const planetsRes = await fetch(`${sector.planetsUrl}?page=1&pageSize=24`, {
  method: 'GET',
  credentials: 'same-origin',
  headers: {
    Accept: 'application/json',
  },
});

const planets = await planetsRes.json();

返回示例：

{
  "items": [],
  "page": 1,
  "pageSize": 24,
  "total": 98,
  "hasMore": true
}

实时更新

主题可选接入 WebSocket。当 AstraHub 同步到新数据时，前台可以自动刷新星图库。

const protocol = location.protocol === 'https:' ? 'wss:' : 'ws:';

const ws = new WebSocket(
  `${protocol}//${location.host}/apis/anonymous.astrahub.halo.run/v1alpha1/astrahub/ws/star-gallery`
);

ws.addEventListener('message', (event) => {
  const snapshot = JSON.parse(event.data);
  // 使用新的 snapshot 重新渲染页面
});

星际资讯按钮建议

posts 中推荐按以下字段处理：

• post.url // 文章类资讯的原文地址
• post.siteUrl // 星球 / 站点地址
• post.type // 资讯类型

推荐逻辑：

const isArticle = ['rss', 'article', 'post'].includes(
  String(post.type || '').toLowerCase()
);

if (isArticle && post.url) {
  // 显示：打开原文
  // 跳转：post.url
}

if (!isArticle && post.siteUrl) {
  // 显示：定位星球
  // 跳转：post.siteUrl
}

插件未启用提示

如果状态接口请求失败，主题可提示：

需要安装或启动 AstraHub 星链插件
请在 Halo 后台启用 AstraHub 星链插件，并同步星图库数据。

查看版本详情

优化

• 优化友链管理页面中审核时间的展示方式，修复时间文本过长时不换行导致布局异常的问题。

修复

• 修复插件无关日志被错误输入或记录的问题，避免非插件功能日志干扰 AstraHub 插件日志内容。

查看版本详情

新特性

• 卡片排序按照热门友链排序。

友链星球

• 友链星球卡片改为热门推荐排序展示。
• 新增星系排行皇冠标志，并支持鼠标悬浮查看排行计算方法。
• 卡片新增星系名称展示，名称超过 10 个字自动省略。
• 卡片新增“星系N”展示，用于显示关联星系数量。
• 卡片 URL 支持点击跳转。
• 卡片描述默认展示 15 个字，超出自动省略。
• 移除卡片上的标签展示。
• 移除卡片上的归属站点展示。
• 操作按钮简化，同一张卡片只展示一个主要操作按钮。
• 本站卡片合并进普通列表样式，不再使用独立特殊卡片。

友链邀请管理

• 收紧友链管理列表各字段之间的间距，RSS 链接和邀请状态不再距离过远。
• 原“已送达/投递状态”标志改为审核结果标志。
• 已通过显示绿色打勾。
• 已拒绝显示红色打叉。

稳定性与兼容

• 修复友链星球虚拟滚动加载后闪现/消失的问题。
• 修复收藏配置为空时可能导致页面异常的问题。

清理

• 移除旧本站特殊卡片样式残留。
• 移除旧投递状态展示函数和样式残留。
• 移除未使用的友链星球普通背景样式残留。
• 清理文件头异常 BOM。
• 已通过前端构建和完整插件构建验证。

查看版本详情

本次更新聚焦友链相关页面的响应速度与交互流畅度。

性能与体验优化

1. 友链星球卡片虚拟滚动改固定行高（解决数据加载卡顿问题）。

2. 审核「通过」改为局部即时响应，不再刷新整页。

3. 友链星球页面筛选和搜索采用数据库索引检索，不在基于本地加载的数据。

4. 插件端数据响应问题，优化服务端数据响应结构，数据响应极大提升，受益页面包括友链星球、友链管理（审核、拒绝、撤回）。

问题修复

1. 修复邀请未选择分组或同意未选择分组，导致主题links页面友链卡片不显示问题。

2. 修复插件/服务端RSS 来筛选列表数据展示问题，现在可展示所有文章来源站点。

查看版本详情

AstraHub 友链插件 v2.4.0 更新日志

本次为「站点身份统一」版本，核心目标是让整个友链网络的信息全局自动同步、保持统一。建议所有站点更新。

新增功能

1. 信息全局自动同步，全网统一

当任意站点更新自己的资料（域名、站名、头像、简介等）后，所有把该站作为友链的其他站点会自动同步到最新信息，无需任何一方手动改链接、重新提交。

• 示例：A 站把域名从 a.top 换成 a.com，所有友链过 A 的站点，其友链卡片会自动更新为 a.com，全网呈现统一的最新信息。
• 整个友链生态以「同一份权威身份」为准，彻底告别「各站信息各不相同、需逐个手动维护」的局面。

2. 友链关系改用「站点编号」锚定，更换域名不再断链

推送友链数据时携带对方站点的唯一编号（site_id）作为关系锚点，关系归属判定从「域名匹配」改为「站点编号匹配」。

• 效果：友链对方更换域名后，您与对方的友链、互相关注关系自动保持，不再因域名变化而失联或错位。
• 生效条件：关系双方均需更新至本版本，编号锚点方可完全生效。

3. 更换自身域名后，本地展示自动同步

在后台修改本站域名后，星球探索页的卡片域名、「本站」置顶标识、互相关注状态等将正确刷新，不再停留在旧域名。

4. 友链和文章合规性检测

新增友链和文章合规性自动检测功能，一经核实自动发送邮件通知对应星系/站长自己友链和友链文章合规性。

问题修复

5. 修复：更换域名后探索页卡片域名不更新

修复因友链物化数据重建时触发唯一约束冲突、导致整批更新事务回滚、数据永久停留在旧快照的问题。更换域名后卡片域名现可正常更新。

6. 修复：更换域名后被误判为「尚未注册 / 暂未接入」

与第 4 项同源问题导致的连锁误判，一并修复。

7. 修复：更换域名后互相关注被降级为「我已关注」

互相关注关系现锚定站点编号，更换域名不再触发关系降级。

注：需关系双方均更新至本版本，锚点方可生效。

8. 修复：友链卡片按钮误显示「凭据缺失」

针对「已关注但对方尚未接入插件」的友链占位站点，按钮文案此前被误判为「凭据缺失」。现已修正为语义准确的「尚未注册」，且不影响对方后续正常注册接入。

升级说明

• 本版本为全员建议更新版本。关系双方均完成更新后，「信息全局同步」「更换域名不断链」「互相关注不降级」方可完全生效。
• 仍使用旧版本插件的站点不受影响；其在更换域名时可能出现短暂的展示错位，更新后即可自愈。

查看版本详情

v2.3.0

✨ 新增

• 友链双向解除：本地与服务端、对端 Halo Link 同步删除
• 审核卡片支持点击跳转对方站点，站点 URL / RSS 显示为可点击外链（by @liuyiwuqing）
• 星链资讯新增「我的星系」筛选：仅展示当前站点友链对端（星系下的星球）的 RSS 资讯
• 关系图孤立星系区分展示：与其他星系无关联的星系环绕在球体外壳，有关联的收束在球体内部

🚀 优化

• 即时响应：邀请、审核、解除友链即时同步
• 归属站点/标签：限制 20 项，超出 +N 折叠
• 页面审核： 待审核/通过/拒绝通知（by @liuyiwuqing），在此基础上使用WS + Set即时响应，且审核 emit 行为立即 pending-inbox-remove
• 插件日志：头像加载失败日志降级为 debug
• 友链邀请：管理列表改为可循环单流，加载与翻页更顺滑

🐛 修复

• 「全部」筛选下未审核卡片操作按钮误显示为删除
• 邀请通过未选分组导致主题友链不显示（groupName 空字符串改为 null）
• 操作按钮 hover 抖动；「已发邀请」缩短为「已邀」
• 关系图星球冷却后漂出球体：边界力补充无视 alpha 的硬钳制

🔧 其他

• 移除未使用的 VLoading 导入（by @liuyiwuqing）

查看版本详情