feat: 更新readme与群组

.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

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. 权利人亦可向开发者提交包含身份证明、权属证明、具体规则信息及相关说明的有效通知。开发者将在合理技术能力范围内，对涉嫌违规规则采取必要处理措施。