# tgtimed

**Repository Path**: initchu/tgtimed

## Basic Information

- **Project Name**: tgtimed
- **Description**: TG定时任务管理
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-28
- **Last Updated**: 2026-01-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Telegram定时任务管理

轻量级容器化Telegram定时任务管理系统，支持多任务管理、定时执行、Web界面管理。

## 功能特性

- 🤖 支持Telegram Bot API交互
- ⏰ 灵活的定时任务配置（CRON表达式、简单周期）
- 📊 Web界面管理任务和查看日志
- 🐳 Docker容器化部署
- 💾 SQLite数据持久化
- 📝 完整的执行日志记录

## 快速开始

### 1. 准备Telegram Bot Token

1. 在Telegram中找到 @BotFather
2. 发送 `/newbot` 创建新机器人
3. 获取Bot Token（格式：`123456789:ABCdefGHIjklMNOpqrsTUVwxyz`）

### 2. 部署应用

#### 一键部署（推荐）

**Linux/macOS:**
```bash
# 克隆项目
git clone <repository-url>
cd telegram-scheduler

# 运行一键部署脚本
chmod +x quick-start.sh
./quick-start.sh
```

**Windows:**
```cmd
# 克隆项目
git clone <repository-url>
cd telegram-scheduler

# 运行一键部署脚本
quick-start.bat
```

#### 手动部署

```bash
# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，填入您的Telegram Bot Token

# 启动服务
docker-compose up -d
```

### 3. 访问Web界面

打开浏览器访问：http://localhost:8080

## 使用说明

### 创建签到任务示例

1. 访问Web界面
2. 点击"添加任务"
3. 填写配置：
   - 任务名称：每日签到
   - 目标ID：@LSMCDLXBOT 的用户名或ID
   - 发送内容：/sign
   - 定时策略：0 9 * * *（每天9点执行）
4. 保存任务

### 查看执行日志

在Web界面的"执行日志"页面可以查看：
- 任务执行时间
- 执行状态（成功/失败）
- Telegram机器人的回复内容
- 错误信息（如有）

## 配置说明

### 环境变量

- `TELEGRAM_BOT_TOKEN`: Telegram Bot Token（必需）
- `DATABASE_URL`: 数据库连接URL（默认：sqlite:///./tasks.db）
- `WEB_PASSWORD`: Web界面访问密码（可选，为空则无需密码）

### 定时策略格式

- CRON表达式：`0 9 * * *`（每天9点）
- 简单描述：支持"每天X点"、"每周X X点"等格式