通过 Github Actions 推送 The Economist 到个人邮箱

感谢 awesome-english-ebooks 项目作者，感谢 Claude Code 老师。

获取邮箱密授权码

我用 QQ 邮箱，需要使用授权码代替邮箱密码。

登录 QQ 邮箱 → 设置 → 账号与安全
下滑找到 “POP3/IMAP/SMTP/Exchange/CardDAV 服务”，开启
按提示发短信验证，获得授权码，保存好

创建 Github 仓库并添加密钥

在 GitHub 新建一个仓库（随意命名，如 ebook-sync）
进入仓库 → Settings → Secrets and variables → Actions → New repository secret

添加两项：

QQ_EMAIL 你的 QQ 邮箱地址
QQ_AUTH_CODE 第一步获取的授权码

设置 Github Actions

在本地 git 初始化一个空文件夹，然后添加 .github/workflows/send-epub.yml 文件，内容如下。完成后推送到 ebook-sync 仓库。

1
name: Send New EPUBs to Email
2

3
on:
4
  schedule:
5
    - cron: '0 22 * * 5' # 每周六 06:00 北京时间
6
  workflow_dispatch:
7

8
permissions:
9
  contents: write
10

11
jobs:
12
  send-epub:
13
    runs-on: ubuntu-latest
14

15
    steps:
16
      - name: Checkout magz repo
17
        uses: actions/checkout@v4
18
        with:
19
          token: ${{ secrets.GITHUB_TOKEN }}
20

21
      - name: Find and download new epub files
22
        id: find_epubs
23
        run: |
24
          # 读取上次处理的 commit SHA
25
          LAST_SHA=""
26
          if [ -f .last_commit ]; then
27
            LAST_SHA=$(cat .last_commit)
28
          fi
29

30
          # 获取源仓库最新的 commit SHA
31
          LATEST_SHA=$(curl -s \
32
            "https://api.github.com/repos/hehonghui/awesome-english-ebooks/commits?per_page=1" \
33
            | jq -r '.[0].sha')
34

35
          # 没有新 commit，直接结束
36
          if [ "$LAST_SHA" = "$LATEST_SHA" ]; then
37
            echo "没有新的 commit，无需处理"
38
            echo "has_files=false" >> $GITHUB_OUTPUT
39
            exit 0
40
          fi
41

42
          # 获取新增的 commits
43
          if [ -z "$LAST_SHA" ]; then
44
            # 首次运行：取最近 7 天
45
            SINCE=$(date -u -d '7 days ago' +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || \
46
                    date -u -v-7d +%Y-%m-%dT%H:%M:%SZ)
47
            COMMITS=$(curl -s \
48
              "https://api.github.com/repos/hehonghui/awesome-english-ebooks/commits?since=${SINCE}&per_page=100" \
49
              | jq -r '.[].sha')
50
          else
51
            # 后续运行：取 LAST_SHA 之后的所有 commits
52
            COMMITS=$(curl -s \
53
              "https://api.github.com/repos/hehonghui/awesome-english-ebooks/compare/${LAST_SHA}...${LATEST_SHA}" \
54
              | jq -r '.commits[].sha')
55
          fi
56

57
          # 保存最新 SHA，供后续步骤提交
58
          echo "$LATEST_SHA" > .last_commit
59

60
          mkdir -p downloads
61
          HAS_ANY=false
62

63
          for SHA in $COMMITS; do
64
            FILES_JSON=$(curl -s \
65
              "https://api.github.com/repos/hehonghui/awesome-english-ebooks/commits/${SHA}" \
66
              | jq -r '.files[] | select(.status == "added") | select(.filename | ascii_downcase | endswith(".epub")) | [.filename, .raw_url] | @tsv')
67

68
            while IFS=$'\t' read -r FILENAME RAW_URL; do
69
              [ -z "$FILENAME" ] && continue
70
              DIR=$(echo "$FILENAME" | cut -d'/' -f1)
71
              BASENAME=$(basename "$FILENAME")
72
              SAVE_PATH="downloads/${DIR}___${BASENAME}"
73

74
              [ -f "$SAVE_PATH" ] && continue
75

76
              echo "下载: $BASENAME"
77
              curl -sL "$RAW_URL" -o "$SAVE_PATH"
78
              HAS_ANY=true
79
            done <<< "$FILES_JSON"
80
          done
81

82
          if [ "$HAS_ANY" = true ]; then
83
            echo "has_files=true" >> $GITHUB_OUTPUT
84
          else
85
            echo "has_files=false" >> $GITHUB_OUTPUT
86
          fi
87

88
      - name: Send one email per magazine
89
        if: steps.find_epubs.outputs.has_files == 'true'
90
        env:
91
          QQ_EMAIL: ${{ secrets.QQ_EMAIL }}
92
          QQ_AUTH_CODE: ${{ secrets.QQ_AUTH_CODE }}
93
        run: |
94
          python3 << 'EOF'
95
          import smtplib
96
          import os
97
          import glob
98
          import zipfile
99
          from email.mime.multipart import MIMEMultipart
100
          from email.mime.text import MIMEText
101
          from email.mime.base import MIMEBase
102
          from email import encoders
103
          from collections import defaultdict
104

105
          MAG_NAMES = {
106
              "01_economist": "The Economist",
107
              "02_new_yorker": "The New Yorker",
108
              "04_atlantic": "The Atlantic",
109
              "05_wired": "Wired",
110
          }
111

112
          SIZE_LIMIT = 50 * 1024 * 1024  # 50MB
113

114
          email = os.environ["QQ_EMAIL"]
115
          password = os.environ["QQ_AUTH_CODE"]
116

117
          magazines = defaultdict(list)
118
          for filepath in glob.glob("downloads/*___*.epub"):
119
              filename = os.path.basename(filepath)
120
              dir_key, basename = filename.split("___", 1)
121
              magazines[dir_key].append((basename, filepath))
122

123
          for dir_key, files in magazines.items():
124
              mag_name = MAG_NAMES.get(dir_key, dir_key)
125

126
              msg = MIMEMultipart()
127
              msg["Subject"] = f"本周新增 EPUB - {mag_name}"
128
              msg["From"] = email
129
              msg["To"] = email
130

131
              body_lines = [f"你好，\n\n本周《{mag_name}》新增了以下 EPUB 文件：\n"]
132
              oversized = []
133

134
              for basename, filepath in files:
135
                  size = os.path.getsize(filepath)
136
                  if size <= SIZE_LIMIT:
137
                      zip_name = basename.replace(".epub", ".zip")
138
                      zip_path = filepath.replace(".epub", ".zip")
139
                      with zipfile.ZipFile(zip_path, "w", zipfile.ZIP_DEFLATED) as zf:
140
                          zf.write(filepath, basename)
141
                      with open(zip_path, "rb") as f:
142
                          part = MIMEBase("application", "octet-stream")
143
                          part.set_payload(f.read())
144
                      encoders.encode_base64(part)
145
                      part.add_header(
146
                          "Content-Disposition",
147
                          f'attachment; filename="{zip_name}"'
148
                      )
149
                      msg.attach(part)
150
                      body_lines.append(f"- {basename}（附件，zip 格式，解压后即可阅读）")
151
                  else:
152
                      size_mb = size / 1024 / 1024
153
                      url = f"https://github.com/hehonghui/awesome-english-ebooks/raw/master/{dir_key}/{basename}"
154
                      oversized.append(f"- {basename}（{size_mb:.1f}MB，超过 50MB）\n  下载链接：{url}")
155

156
              if oversized:
157
                  body_lines.append("\n以下文件超过 50MB，以链接形式发送：\n")
158
                  body_lines.extend(oversized)
159

160
              body_lines.append("\n仓库地址：https://github.com/hehonghui/awesome-english-ebooks")
161
              msg.attach(MIMEText("\n".join(body_lines), "plain", "utf-8"))
162

163
              with smtplib.SMTP_SSL("smtp.qq.com", 465) as server:
164
                  server.login(email, password)
165
                  server.send_message(msg)
166
                  print(f"已发送：{mag_name}")
167
          EOF
168

169
      - name: Save last processed commit SHA
170
        run: |
171
          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
172
          git config user.name "github-actions[bot]"
173
          git add .last_commit
174
          git diff --staged --quiet || git commit -m "chore: update last commit SHA [skip ci]"
175
          git push
176

177
      - name: No new epub this week
178
        if: steps.find_epubs.outputs.has_files == 'false'
179
        run: echo "没有新增 epub 文件，无需发送邮件"

验证

在该仓库的 Actions 页的左侧点击 Send New EPUBs to Email，然后点击右侧的 Run workflow。

测试运行正常的话你会收到四封邮件，内容分别为原杂志仓库各杂志的最新一期提醒，杂志内容打包成 zip 文件¹以附件形式附在其中。

后续每周六早晨六点会自动检查新文件并发送。

QQ 邮箱会对附件内容做审查，发送 Epub 文件会被拦截，打包成 zip 文件可行。 ↩

通过 Github Actions 推送 The Economist 到个人邮箱

获取邮箱密授权码

创建 Github 仓库并添加密钥

设置 Github Actions

验证

脚注