diff --git a/.github/workflows/auto-release.yml b/.github/workflows/auto-release.yml index 4b69c0367..ff190cf2b 100644 --- a/.github/workflows/auto-release.yml +++ b/.github/workflows/auto-release.yml @@ -354,3 +354,160 @@ jobs: artifacts/legado-${{ needs.prepare.outputs.versionL }}*.apk env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + + - name: 发布到 Telegram 群组 + env: + TG_BOT_TOKEN: ${{ secrets.TELEGRAM_BOT_TOKEN }} + TG_CHAT_ID: ${{ secrets.TELEGRAM_CHAT_ID }} + VERSION: ${{ needs.prepare.outputs.versionL }} + IS_RELEASE: ${{ needs.prepare.outputs.is_release }} + RELEASE_BODY: ${{ steps.get_commits.outputs.release_body }} + REPO_URL: ${{ github.server_url }}/${{ github.repository }} + run: | + python3 <<'PY' + import glob + import json + import os + import subprocess + import sys + + MAX_BOT_API_FILE_BYTES = 50 * 1024 * 1024 + MEDIA_GROUP_LIMIT = 10 + MESSAGE_LIMIT = 4096 + CAPTION_LIMIT = 1024 + + bot_token = os.environ.get("TG_BOT_TOKEN", "") + chat_id = os.environ.get("TG_CHAT_ID", "") + version = os.environ["VERSION"] + is_release = os.environ["IS_RELEASE"] == "true" + repo_url = os.environ["REPO_URL"] + release_body = os.environ.get("RELEASE_BODY", "").strip() + release_link = f"{repo_url}/releases/tag/{version}" + + missing = [name for name, value in { + "TELEGRAM_BOT_TOKEN": bot_token, + "TELEGRAM_CHAT_ID": chat_id, + }.items() if not value] + if missing: + print(f"缺少 Telegram Secret: {', '.join(missing)}") + sys.exit(1) + + def to_plain_text(text): + lines = [] + for line in text.splitlines(): + if line.startswith("### "): + line = line[4:] + lines.append(line.replace("**", "")) + return "\n".join(lines).strip() + + def limited_text(prefix, body, suffix, limit): + fixed_len = len(prefix) + len(suffix) + if fixed_len >= limit: + return (prefix + suffix)[:limit - 3] + "..." + budget = limit - fixed_len + if len(body) <= budget: + return f"{prefix}{body}{suffix}" + return f"{prefix}{body[:budget - 3]}...{suffix}" + + def tg_call(method, fields, files=None): + cmd = [ + "curl", "-sS", "--retry", "3", "--retry-delay", "2", + "--connect-timeout", "20", "--max-time", "600", + "-X", "POST", + f"https://api.telegram.org/bot{bot_token}/{method}", + ] + for key, value in fields.items(): + cmd.extend(["--form-string", f"{key}={value}"]) + for key, path in files or []: + cmd.extend(["-F", f"{key}=@{path}"]) + + result = subprocess.run(cmd, capture_output=True, text=True) + if result.stderr: + print(result.stderr, file=sys.stderr) + + try: + response = json.loads(result.stdout) + except json.JSONDecodeError: + print(f"Telegram {method} 返回非 JSON 响应:") + print(result.stdout) + sys.exit(1) + + if result.returncode != 0 or not response.get("ok"): + print(f"Telegram {method} 调用失败:") + print(json.dumps(response, ensure_ascii=False, indent=2)) + sys.exit(1) + + return response + + title = f"{'Release' if is_release else 'Pre-release'} {version}" + body = to_plain_text(release_body) + notes = limited_text( + f"{title}\n\n", + body, + f"\n\n完整更新日志: {release_link}", + MESSAGE_LIMIT, + ) + caption = limited_text( + "", + title, + f"\n完整更新日志: {release_link}", + CAPTION_LIMIT, + ) + + apk_files = sorted(glob.glob(f"artifacts/legado-{version}*.apk")) + if not apk_files: + print("未找到 APK 文件！") + sys.exit(1) + + too_large = [ + (apk, os.path.getsize(apk)) + for apk in apk_files + if os.path.getsize(apk) > MAX_BOT_API_FILE_BYTES + ] + if too_large: + print("Telegram Bot API 云端 sendDocument 限制单文件最大 50 MB，以下 APK 无法上传:") + for apk, size in too_large: + print(f" - {os.path.basename(apk)}: {size / 1024 / 1024:.2f} MB") + print(f"GitHub Release: {release_link}") + sys.exit(1) + + print(f"准备发送 Release Notes，并上传 {len(apk_files)} 个 APK:") + for apk in apk_files: + print(f" - {os.path.basename(apk)} ({os.path.getsize(apk) / 1024 / 1024:.2f} MB)") + + tg_call("sendMessage", { + "chat_id": chat_id, + "text": notes, + "disable_web_page_preview": "true", + }) + print("Release Notes 已发送。") + + caption_used = False + for start in range(0, len(apk_files), MEDIA_GROUP_LIMIT): + batch = apk_files[start:start + MEDIA_GROUP_LIMIT] + batch_caption = caption if not caption_used else "" + + if len(batch) == 1: + fields = {"chat_id": chat_id} + if batch_caption: + fields["caption"] = batch_caption + tg_call("sendDocument", fields, [("document", batch[0])]) + else: + media = [] + files = [] + for index, apk in enumerate(batch): + field_name = f"file{index}" + item = {"type": "document", "media": f"attach://{field_name}"} + if index == 0 and batch_caption: + item["caption"] = batch_caption + media.append(item) + files.append((field_name, apk)) + tg_call("sendMediaGroup", { + "chat_id": chat_id, + "media": json.dumps(media, ensure_ascii=False), + }, files) + + caption_used = True + + print("所有 APK 已发送到 Telegram。") + PY diff --git a/README.md b/README.md index 57ef54751..b810d8f35 100644 --- a/README.md +++ b/README.md @@ -46,6 +46,15 @@ Design 3 风格重构版本。 --- +## 💬 交流 + +* **Telegram 群组：** [Legado with MD3](https://t.me/materado) +* **版本发布：** + 最新版本会自动发布至群组，也可在 [GitHub Releases](https://github.com/HapeLee/legado-with-MD3/releases) + 下载。 + +--- + ## ❤️ 致谢 感谢以下优秀开源项目提供的灵感与技术支持： @@ -62,7 +71,43 @@ Design 3 风格重构版本。 优秀的拖动排序实现) * 以及更多开源项目... -## ⚠️ 免责声明 +## ⚠️ 用户协议与免责声明 -项目内容不代表原作者立场，与原项目作者不存在任何隶属或授权关系。 +> **【特别提示】** +> 在下载、安装或使用本软件前，请您务必仔细阅读并充分理解本协议及免责声明的全部内容。您一旦下载、安装或使用本软件，即视为已阅读、理解并同意接受本声明的全部内容。 + +### 一、软件性质说明 + +1. 本软件是一款用户可配置的本地化网页内容浏览工具，提供网页访问、内容解析、文本提取、阅读排版与数据管理等技术功能。 +2. 本软件默认状态下不预置、不内置、不提供任何第三方网站内容、数据资源或解析规则。 +3. 本软件开发者不提供任何内容运营、内容存储、内容发布或内容传播服务。 +4. 用户可基于自身需求，自行配置或导入第三方规则，以实现对公开网页内容的个性化浏览与处理。 + +### 二、用户行为与规则说明 + +1. 用户可自行创建、编辑、导入或使用第三方分享的解析规则（以下简称"规则"）。 +2. 相关规则仅用于定义网页内容的获取、提取与显示方式，其来源、合法性、准确性与适用性均由用户自行判断并承担责任。 +3. 用户使用规则访问第三方网站时，相关网络请求由用户设备直接向目标网站发起并接收数据。本软件仅提供本地解析与展示能力，不对第三方网站内容进行修改、编辑或再分发。 +4. 用户应遵守所在地法律法规、网络安全要求以及相关网站的服务协议与版权规范，不得利用本软件从事侵犯知识产权、非法传播、未授权数据获取、破坏网络服务或其他违法违规行为。 + +### 三、第三方内容与社区说明 + +1. 任何由第三方建立或维护的规则分享平台、论坛、交流群组、网站或其他社区，均属于独立运营的第三方平台，与本软件开发者无隶属关系。 +2. 开发者不参与第三方规则、内容或社区的制作、发布、运营、维护与传播行为，亦不对相关内容承担主动审查义务。 +3. 用户因使用第三方规则或访问第三方网站而产生的风险，包括但不限于版权纠纷、数据安全风险、网络访问风险或其他法律风险，应由相关行为主体依法承担相应责任。 + +### 四、隐私与数据说明 + +1. 本软件主要功能运行于用户本地设备，不设立用于提供网页内容服务的自有内容服务器。 +2. 本软件不会主动收集、上传或存储用户的阅读内容、规则列表、浏览记录或其他个人隐私数据。 +3. 为提升软件稳定性与兼容性，本软件可能集成第三方统计或崩溃分析服务（如 Firebase Crashlytics + 等），用于收集匿名化的崩溃日志、性能信息及基础设备信息。 +4. 部分网络、存储或同步权限，仅用于实现用户主动启用的本地备份、WebDAV 同步或跨设备数据同步等功能。 + +### 五、知识产权保护 + +1. 开发者尊重并保护知识产权权利人的合法权益，并反对任何侵犯著作权、商标权或其他合法权益的行为。 +2. 用户应确保其使用本软件获取、处理或访问相关内容的行为符合适用法律法规及权利要求。 +3. 若权利人认为某些第三方规则存在涉嫌侵权情形，可依法向相关内容实际托管方主张权利。 +4. 权利人亦可向开发者提交包含身份证明、权属证明、具体规则信息及相关说明的有效通知。开发者将在合理技术能力范围内，对涉嫌违规规则采取必要处理措施。