Friend Circle Sync：用 GitHub Actions 同步友链 RSS

@navfolio/friend-circle-sync 是独立的数据同步工具：它读取友链 JSON，使用每项的 rss 地址，或尝试 /rss.xml、/feed.xml、/atom.xml、/index.xml 等常用地址，最终写出标准文章数组。它不依赖 Astro，也可用于其他静态博客。

GitHub Actions 构建前同步

在部署工作流、bun run docs:build 之前加入：

1
- name: Sync friend circle
2
  uses: navfolio/friend-circle-sync@main
3
  with:
4
    input: ${{ vars.NAVFOLIO_FRIEND_LINKS_SRC }}
5
    output: public/friend-circle.json
6
    max-posts-per-feed: '12'

文件只在 CI 工作目录中生成，随后被 Astro 原样复制到 dist/friend-circle.json。不要提交它到 Git；在本地想查看真实数据时，可手动运行：

1
git clone git@github.com:navfolio/friend-circle-sync.git
2
cd friend-circle-sync
3
bun install
4
bun run sync -- \
5
  --input https://example.com/friendlinks.json \
6
  --output ../your-site/public/friend-circle.json

在 MDX 中展示

1
import FriendCircle from '@navfolio/mdx-components/FriendCircle.astro';
2

3
<FriendCircle feedSrc="/friend-circle.json" limit={10} />

Friend circle

2 friends /5 active /5 posts

GitHubRepository automation patternsActionsCI2026-07-14

OpenAIBuilding a reliable static feedRSSAstro2026-07-13

BunRelease notes and migration guideRuntime2026-07-12

AstroContent-driven website workflowsAstroMDX2026-07-11

NavfolioPortable authoring componentsComponents2026-07-10

刷新按钮只会从构建好的文章池重新抽取，不会在访问页面时抓 RSS。卡片来源和字段说明请见 FriendLinkCard。