ci(telegram): render release/issue notes as Telegram HTML (not raw markdown)

GitHub-Flavored Markdown ≠ Telegram MarkdownV2, so the old plain-text send
showed literal ## ** | etc. New .github/scripts/tg-notify.mjs converts GFM
→ Telegram-safe HTML (<b>/<i>/<code>/<pre>/<a>; headers→bold, tables→· rows,
lists→•, quotes→▎), escapes <>&, and falls back to plain text if Telegram
rejects the HTML. Adds workflow_dispatch to telegram-notify so you can send
the latest release rendered for testing without cutting a new release.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Gloridust
2026-06-13 00:41:54 +08:00
Unverified
parent 54ed841a68
commit 8ac0016398
2 changed files with 15 additions and 38 deletions
Binary file not shown.
+15 -38
View File
@@ -1,40 +1,39 @@
name: telegram-notify
# 通过 Telegram Bot(@WechatOnCloudBot)把「新版本发布 / 新 issue」推送到群组。
# 跑在 GitHub Actions 上,无需任何服务器。
# 新版本发布 / 新 issue 时,把内容(GitHub Markdown → Telegram HTML 渲染)推送到 Telegram 群组。
# 跑在 GitHub Actions 上,无需服务器;未配置 TELEGRAM_CHAT_ID 则自动跳过
#
# 一次性配置(未配置则自动跳过,不影响 fork):
# 1) 把 @WechatOnCloudBot 拉进目标群组(群里发言需要时设为管理员)。
# 2) 取群组 chat id:把 bot 拉进群后在群里随便发条消息,浏览器打开
# https://api.telegram.org/bot<BOT_TOKEN>/getUpdates ,找 result[].message.chat.id
# (群组通常是形如 -1001234567890 的负数)。
# 3) 仓库 Settings → Secrets and variables → Actions
# · Variables 选项卡 → 新建 TELEGRAM_CHAT_ID = 上面的 chat id
# · Secrets 选项卡 → 新建 TELEGRAM_BOT_TOKEN = @BotFather 给的 bot token
# chat id 放 Variable 是为了能在下面的 if 条件里判断是否已配置;token 必须放 Secret。)
# 一次性配置(仓库 Settings → Secrets and variables → Actions):
# · Variables → TELEGRAM_CHAT_ID = 群组 chat id(形如 -1001234567890;取法见 doc/发布到GHCR.md
# · Secrets → TELEGRAM_BOT_TOKEN = @BotFather 的 token
# 并把机器人拉进群组。
#
# 手动测试渲染效果:Actions → telegram-notify → Run workflow(会把「最新 release」渲染后发到群)。
on:
release:
types: [published]
issues:
types: [opened]
workflow_dispatch: {}
# 限制权限:只读元数据,足够本工作流所需。
permissions:
contents: read
jobs:
notify:
runs-on: ubuntu-latest
# 仅当配置了群组 chat id 时才运行(未配置的 fork 会安全跳过)
if: ${{ vars.TELEGRAM_CHAT_ID != '' }}
steps:
- name: Compose & send Telegram message
- uses: actions/checkout@v4
- name: Render & send to Telegram
env:
TG_TOKEN: ${{ secrets.TELEGRAM_BOT_TOKEN }}
TG_CHAT: ${{ vars.TELEGRAM_CHAT_ID }}
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
REPO: ${{ github.repository }}
EVENT: ${{ github.event_name }}
# 经 env 传任意文本,避免把 ${{ }} 直接拼进脚本造成命令注入
# 经 env 传任意文本,避免命令注入
R_TAG: ${{ github.event.release.tag_name }}
R_NAME: ${{ github.event.release.name }}
R_URL: ${{ github.event.release.html_url }}
@@ -44,26 +43,4 @@ jobs:
I_URL: ${{ github.event.issue.html_url }}
I_USER: ${{ github.event.issue.user.login }}
I_BODY: ${{ github.event.issue.body }}
run: |
set -uo pipefail
if [ -z "${TG_TOKEN:-}" ]; then
echo "::warning::TELEGRAM_BOT_TOKEN 未配置,跳过"
exit 0
fi
if [ "$EVENT" = "release" ]; then
title="🚀 云微 WechatOnCloud ${R_TAG} 已发布"
if [ -n "${R_NAME:-}" ] && [ "${R_NAME}" != "${R_TAG}" ]; then
title="${title} — ${R_NAME}"
fi
# 发布说明截断到 ~3000 字符(Telegram 单条上限 4096
body="$(printf '%s' "${R_BODY:-}" | head -c 3000)"
msg="$(printf '%s\n\n%s\n\n🔗 完整说明:%s\n⬆️ 升级: docker compose pull && docker compose up -d' "$title" "$body" "$R_URL")"
else
body="$(printf '%s' "${I_BODY:-}" | head -c 600)"
msg="$(printf '🐛 新反馈 Issue #%s%s\n👤 by %s\n\n%s\n\n🔗 %s' "$I_NUM" "$I_TITLE" "$I_USER" "$body" "$I_URL")"
fi
# --data-urlencode 负责转义,纯文本发送(不用 markdown parse_mode,避免特殊字符破坏解析)
curl -sS --fail-with-body -X POST \
"https://api.telegram.org/bot${TG_TOKEN}/sendMessage" \
--data-urlencode "chat_id=${TG_CHAT}" \
--data-urlencode "text=${msg}"
run: node .github/scripts/tg-notify.mjs