initial commit

Author: Pigbibi

.github/workflows/main.yml

@@ -0,0 +1,57 @@
+name: Telegram Auto Sign
+
+on:
+  schedule:
+    - cron: '0 0 * * *'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  run-checkin:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: 检出代码
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: 配置 Python 环境
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+
+      - name: 安装依赖
+        run: |
+          python -m pip install --upgrade pip
+          pip install telethon
+
+      - name: 运行签到脚本
+        env:
+          API_ID: ${{ secrets.API_ID }}
+          API_HASH: ${{ secrets.API_HASH }}
+          SESSION_STRING: ${{ secrets.SESSION_STRING }}
+          BOT_USERNAME: ${{ secrets.BOT_USERNAME }}
+        run: python main.py
+
+      - name: 提交日志到 logs 分支
+        run: |
+          # 配置 Git 身份
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          
+          # 临时保存生成的日志文件内容
+          LOG_CONTENT=$(cat checkin.log)
+          
+          # 切换到 logs 分支
+          git checkout logs || git checkout -b logs
+          
+          # 将刚才运行生成的日志写回文件
+          echo "$LOG_CONTENT" > checkin.log
+          
+          # 提交并推送
+          git add checkin.log
+          git commit -m "Auto check-in log update: $(date +'%Y-%m-%d %H:%M:%S')" || echo "No changes to commit"
+          git push origin logs

README.md

@@ -0,0 +1,46 @@
+# 🤖 Telegram Auto Sign
+
+An automated daily sign-in script for Telegram bots, powered by GitHub Actions and Python (Telethon). It uses your personal account (Userbot) to send sign-in commands (like `/qd`) to specified Telegram bots daily, completely freeing your hands.
+
+## ✨ Core Features
+* **☁️ Zero-Cost Deployment**: Runs entirely on GitHub Actions. No need for a local server or VPS.
+* **👥 Multi-Bot Support**: Capable of sending sign-in commands to multiple bots sequentially.
+* **🎲 Smart Anti-Ban System**: Built-in 1~20 minutes randomized startup delay and random pauses between messages to prevent triggering Telegram's spam filters.
+* **📝 Auto-Log Keepalive**: Automatically writes sign-in results to `checkin.log` and pushes it to the repository after each run. This perfectly bypasses GitHub Actions' 60-day inactivity suspension rule.
+
+## 🚀 Deployment Guide
+
+### Step 1: Get API Credentials
+1. Log in to the [Telegram API Development Tools](https://my.telegram.org/).
+2. Create a new application.
+3. Note down your `App api_id` and `App api_hash`.
+
+### Step 2: Get Session String
+Install the dependency (`pip install telethon`) on your local machine and run a script to generate your session string. 
+> ⚠️ **WARNING**: Treat your Session String like a password. NEVER share it publicly!
+
+### Step 3: Configure GitHub Repository Secrets
+1. Create a **Private** repository (Highly recommended for security).
+2. Go to `Settings` -> `Secrets and variables` -> `Actions`, and add the following 4 **Repository secrets**:
+   * `API_ID`: Your API ID (Numbers only).
+   * `API_HASH`: Your API Hash string.
+   * `SESSION_STRING`: The extremely long session string generated in Step 2.
+   * `BOT_USERNAME`: The target bot usernames, separated by commas (e.g., `@bot1, @bot2`).
+
+### Step 4: Grant Action Permissions
+To allow the script to push the log file back to the repository:
+1. Go to `Settings` -> `Actions` -> `General`.
+2. Scroll down to **Workflow permissions**.
+3. Select **Read and write permissions** and click `Save`.
+
+### Step 5: First Run & Test
+Go to the **Actions** tab, select the `Telegram Auto Sign` workflow on the left, and click `Run workflow` to test it manually. If successful, your account will send the commands, and a log file will appear in your repository!
+
+---
+
+## ⏱️ Schedule Modification
+The default trigger time is **00:00 UTC daily**. 
+To modify this, edit the cron expression in the `.github/workflows/checkin.yml` file.
+
+## ⚠️ Disclaimer
+This script is for educational and automated testing purposes only. Do not use it for high-frequency spamming or violating Telegram's Terms of Service. The user bears all responsibility for any account restrictions or bans caused by API abuse.

main.py

@@ -0,0 +1,51 @@
+import os
+import asyncio
+import random
+from datetime import datetime, timezone, timedelta
+from telethon import TelegramClient
+from telethon.sessions import StringSession
+
+# 读取环境变量
+API_ID = int(os.environ['API_ID'])
+API_HASH = os.environ['API_HASH']
+SESSION_STRING = os.environ['SESSION_STRING']
+BOT_USERNAMES = os.environ['BOT_USERNAME']
+
+async def main():
+    delay_seconds = random.randint(10, 1200)
+    await asyncio.sleep(delay_seconds)
+
+    print("🔄 正在连接 Telegram 服务器...")
+    client = TelegramClient(StringSession(SESSION_STRING), API_ID, API_HASH)
+    await client.start()
+    print("✅ 登录成功！\n")
+    
+    bot_list = [bot.strip() for bot in BOT_USERNAMES.split(',')]
+    success_bots = []
+    
+    for bot in bot_list:
+        if bot:
+            print(f"👉 正在向 {bot} 发送签到指令 /qd ...")
+            await client.send_message(bot, '/qd')
+            success_bots.append(bot)
+            
+            sleep_time = random.randint(2, 5)
+            await asyncio.sleep(sleep_time) 
+            
+    print("\n🎉 所有签到指令发送完毕！")
+    await client.disconnect()
+
+    # 获取东八区时间 (北京时间)
+    tz = timezone(timedelta(hours=8))
+    current_time = datetime.now(tz).strftime('%Y-%m-%d %H:%M:%S')
+    
+    # 拼接日志内容
+    log_msg = f"[{current_time}] 成功向 {', '.join(success_bots)} 发送签到指令 (随机延迟了 {delay_seconds} 秒)。\n"
+    
+    # 追加写入到 checkin.log 文件中
+    with open('checkin.log', 'a', encoding='utf-8') as f:
+        f.write(log_msg)
+    print("📝 运行日志已成功写入 checkin.log")
+
+if __name__ == '__main__':
+    asyncio.run(main())