Times: 基于RSSHub 与 Friend-Circle-Lite 的学院通知聚合网站#

起因#

之前跟别人聊天的时候曾经开玩笑地说过

对我来说，信息就是生命

这样的话。所以我在生活中也挺留意学校和其他的一些通知。 早获得信息、早做打算、早想对策，于我而言大概算是一种习惯。

所以我闲着没事的时候就回去刷新一下学校的各个通知网站， 像是本科生院、学科竞赛、本科生跨国(境)、跨校交流网一类的。

于是就有一个显而易见的问题：通知太“散”了。 基本上为了查看有没有最新通知要去看好几个网站，就很麻烦。 但当时也没想到什么好的解决法子，就先凑合用着了。

契机#

之前有段时间了解过一点点 RSS ， 也听说过 RSSHub 这个为不提供 RSS 订阅的网站添加 RSS 解析的项目， 但当时也仅仅是作为一个订阅链接的“使用者”， 况且发现由于学校网站迁移，之前前辈写好的 RSSHub 路由不能用了， 也就没有深入了解下去。

上个月给这个博客网站添加了友链朋友圈功能后（见这篇博文）， 我突然发现“这玩意拿来抓学校通知刚刚好”。 本着有自用需求的想法，我忽悠 FrozenStarrrr 重启暑假搁置掉的 Minus 计划。 刚刚好那周我们专业要进行分流， 也带有一点点“做出来的话可以当面试资本”的私心在。

结构#

从这一小节开始正式进入具体介绍项目环节。

fuwari 怎么没有 mermaid 支持草

1
                                -----------------
2
---------------------  RSSHub   |     .xml      |
3
| School's websites |---------->|      on       |
4
---------------------           | RSSHub Server |
5
                                -----------------
6
                                        |
7
                        ----------------| Friend-Circle-Lite
8
                        |               |
9
                        v               v
10
                ---------------    ------------
11
                | Github Page |    | all.json |
12
                ---------------    ------------
13

14
// 手搓只能画成这样了凑合看吧

基本思路就是

1. 编写路由解析学校网站的通知公告页面
2. 部署 RSSHub 服务器（当然我们小作坊没钱高服务器只能找其他办法）
3. 利用友链朋友圈定时抓取上一步生成的 .xml 文件
4. 生成静态页面，部署到 Github Page 上

编写路由#

因为学校的本科生院网站完全就是把之前教务处网站换了个域名。 而 棒无 前辈之前曾写过教务处网站的路由， 这使得我们可以参考 抄 前辈留下来的 .ts 文件照葫芦画瓢， 先将 本科生院的路由 和 自家学院的路由 写好。

写完两个路由，也差不多有了点经验。 接下来的几周我们陆续又写完了其他 25 个学院的路由 （PR#20532, PR#20582）。 这也是目前路由的完成情况， 有关于更详细的路由支持计划， 您可以查看我们 Fork 仓库的 Issue#1。

由于作为一个仅有三人的小作坊， 我们属实没钱也没有什么网络安全经验去维护一台服务器， 所以我们只能依赖公共实例或是 Github Actions 。 无论哪种我们都需要将自己写的路由提 PR 给原 repo。 所以有一周基本上就是在 写路由 -> 提PR -> 查看CR评论 -> 改路由 的循环中度过的。

考虑到 RSSHub 的规模，我似乎可以不要脸的说自己也是给 stars 项目提过 pr 的人

部署友链朋友圈#

这一步基本照着文档来就行， 但考虑到抓取通知毕竟和项目原目的不一样， 还是需要做一些更改。

1
spider_settings:
2
  enable: true
3
  json_url: "https://raw.githubusercontent.com/ECNU-minus/Friend-Circle-Lite/main/sites.json"
4
  ...

1
# 特殊RSS地址指定，可以置空但是不要删除！
2
# 解释：用于指定特殊RSS地址，如B站专栏等不常见RSS地址后缀，可以添加多个
3
#   name:               友链名称
4
#   url:                指定的RSS地址
5
specific_RSS:
6
  - name: 学院名称
7
    url: RSS 订阅地址

1
<style>
2
  ...
3
  .container {
4
      background: rgba(255, 255, 255, 0.8);
5
      display: flex;
6
      text-align: center;
7
      align-items: center;
8
      height: 100vh;
9
      width: 100%;
10
      flex-direction: column;
11
      justify-content: center;
12
  }
13
  ...
14
</style>
15
...
16
<div class="container">
17
  <img src="./favicon.ico" alt="Avatar" class="avatar" />
18
  <p>Friend-Circle-Lite<br />服务已运行</p>
19
  <div class="button-container">
20
    <a
21
      href="https://blog.liushen.fun/posts/4dc716ec/"
22
      class="button"
23
      target="_blank"
24
      >查看文档</a
25
    >
26
    <a href="/all.json" class="button">测试接口</a>
27
  </div>
28
  <a href="#" class="scroll-down-icon" id="scroll-down-button"></a>
29
</div>

1
spider_settings:
2
  ...
3
  article_count: 8
4
  ...

1
def deal_with_large_data(result):
2
    """
3
    处理文章数据，保留前150篇及其作者在后续文章中的出现。
4

5
    参数：
6
    result (dict): 包含统计数据和文章数据的字典。
7

8
    返回：
9
    dict: 处理后的数据，只包含需要的文章。
10
    """
11
    result = sort_articles_by_time(result)
12
    article_data = result.get("article_data", [])
13

14
    # 检查文章数量是否大于 150
15
    max_articles = 256

1
timeout = (10, 15)

生成静态页面#

这部分主要是调 Actions ，感觉还算比较重要，故单拉出来一个二级标题。

• 域名

  原部署逻辑是在生成静态页面后初始化 git 仓库然后强制推送到 page 分支上， 这样做的好处是 page 分支始终仅有 1 个 commit ，较为简洁， 但是每次更新会清理掉 CNAME 文件，令自定义域名失效。 故对 actions 做如下修改

  1
  - name: Commit changes
  2
    run: |
  3
      mkdir pages
  4
      cp -r main ./static/index.html ./static/readme.md ./static/favicon.ico ./static/bg-light.webp ./temp/cache.json ./static/bg-dark.webp all.json errors.json pages/
  5
      cd pages
  6
      touch CNAME
  7
      echo "times.myecnu.org" >> CNAME
  8
      git init
  9
      git add .
  10
      git commit -m "⏱️ $(date +"%Y年%m月%d日-%H时%M分") GitHub Actions定时更新"
  11
      git push --force https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git HEAD:page
  

• 服务器

  一开始我们采用的是抓取远程公共实例的方式， 但是这样会比较依赖远端服务器的稳定性， 在问了伟大的ゲミニ様之后得知可以在 actions 里边通过拉取 docker 镜像提供服务。 于是作如下修改

  1
  friend-circle-lite:
  2
    runs-on: ubuntu-latest
  3
  
  4
    services:
  5
      rsshub:
  6
        image: diygod/rsshub:latest
  7
        ports:
  8
          - 1200:1200
  9
        options: >-
  10
          --health-cmd "curl -f http://localhost:1200/ || exit 1"
  11
          --health-interval 10s
  12
          --health-timeout 5s
  13
          --health-retries 5
  

  然后将所有抓取链接指向 localhost:1200 即可。

后续计划？#

当前虽然算是能用，但还是存在一些不足，后续可能会考虑对其进行进一步的修改。