add site announcements

2026-03-20 11:24:29 +08:00
parent 5a9f007a75
commit 940bc1d71c
35 changed files with 1831 additions and 15 deletions
@@ -379,6 +379,25 @@ Metapi 自动追踪每个账号的健康状态：

 ---

+## 📰 站点公告
+
+Metapi 会定期抓取已接入站点的公告，并在首次发现时写入站内通知与「站点公告」页面。
+
+当前支持的公告来源：
+
+- `new-api`：读取 `/api/notice` 的全站公告
+- `done-hub`：读取 `/api/notice` 的全站公告
+- `sub2api`：读取 `/api/v1/announcements` 的公告列表
+
+行为约定：
+
+1. 首次发现的公告会触发一次 Metapi 通知
+2. 已经保存过的公告再次同步时只更新本地记录
+3. `sub2api` 这类需要登录态的公告接口，会优先使用站点下已启用账号的会话令牌
+4. 「站点公告」页面的清空操作只影响 Metapi 本地数据库
+
+---
+
 ## 🛠️ 故障排查

 ### 问题：添加站点后无法获取模型列表