TeleSubmit v2

功能强大的 Telegram 频道投稿机器人，支持媒体上传、全文搜索、热度统计

TeleSubmit v2 是一个开源的 Telegram 频道内容管理系统，专为频道管理员和内容创作者设计。支持用户投稿、自动审核、全文搜索、热度统计等功能，帮助您高效管理 Telegram 频道内容。

核心功能

投稿管理 - 支持图片、视频、文档批量上传，支持多种媒体格式
频道监听 - 自动监听频道消息，智能提取标签和内容，自动同步到数据库和搜索索引
全文搜索 - 基于 Whoosh 搜索引擎，中文分词优化（jieba/simple），支持标题/标签/文件名多字段搜索
热度统计 - 智能热度算法，自动生成排行榜，支持按时间范围筛选
标签系统 - 标签云可视化，快速分类内容，支持标签搜索和统计
权限管理 - 黑名单系统，灵活控制用户权限，支持管理员命令
双模式运行 - 支持 Polling 和 Webhook 两种运行模式，适应不同部署场景
容器化部署 - 提供 Docker 和 Docker Compose 支持，一键部署
数据持久化 - 基于 SQLite 数据库，支持数据备份和恢复
内存优化 - 支持多种内存模式，最低仅需 80-120 MB 内存

快速开始

一键部署（推荐新手）

git clone https://github.com/zoidberg-xgd/TeleSubmit-v2.git
cd TeleSubmit-v2
./quickstart.sh  # 智能检测环境，自动引导部署

其他部署方式

完整安装向导

```bash
cp config.ini.example config.ini
nano config.ini  # 编辑配置
./deploy.sh

手动部署

pip3 install -r requirements.txt
cp config.ini.example config.ini
nano config.ini
./start.sh

基本配置

编辑 config.ini，填入以下必填项：

[BOT]
TOKEN = your_bot_token_here        # 从 @BotFather 获取
CHANNEL_ID = @your_channel         # 频道用户名或 ID
OWNER_ID = 123456789               # 管理员 User ID

如何获取配置信息？

Bot Token: 向 @BotFather 发送 /newbot 创建机器人
Channel ID: 频道用户名（如 @mychannel）或数字 ID
Owner ID: 向 @userinfobot 发送消息获取

运行模式选择

模式	适用场景	优点	缺点
Polling（默认）	本地开发、测试	配置简单	延迟 1-3 秒
Webhook	生产环境、云服务器	响应快（<1秒）	需 HTTPS 域名

Webhook 模式配置

[BOT]
RUN_MODE = WEBHOOK

[WEBHOOK]
URL = https://your-domain.com
PORT = 8080
PATH = /webhook

详见 Webhook 模式完整指南

常用命令

管理脚本

命令	说明	使用场景
`./start.sh`	启动机器人	首次启动
`./restart.sh`	重启机器人	修改配置后
`./update.sh`	更新代码	定期维护
`./deploy.sh`	Docker 部署	生产环境

更多脚本请查看脚本使用指南

用户命令

命令	说明
`/submit`	开始新投稿
`/search <关键词>`	搜索内容
`/hot [时间]`	查看热门排行
`/mystats`	我的统计
`/help`	查看帮助

管理员命令

命令	说明
`/debug`	系统状态
`/blacklist_add <ID>`	添加黑名单
`/blacklist_list`	查看黑名单
`/searchuser <ID>`	查询用户投稿

投稿流程

1. 发送 /submit
   ↓
2. 选择类型（媒体/文档/混合）
   ↓
3. 上传文件
   ↓
4. 发送 /done_media 或 /done_doc
   ↓
5. 输入标签（必填）
   ↓
6. 输入可选信息（链接、标题、说明）
   ↓
7. 预览并确认
   ↓
8. 发布到频道

搜索功能

基础搜索

/search Python          # 搜索关键词
/search #编程           # 搜索标签
/search 文件.txt        # 搜索文件名

高级搜索

/search Python -t week      # 限定时间（day/week/month/all）
/search 教程 -n 20          # 限定结果数量
/search #Python -t month -n 15  # 组合使用

搜索特性:

中文分词优化（jieba/simple 可选）
中文部分匹配支持（搜索"卫宫"可匹配"卫宫士郎"）
多字段匹配（标题/描述/标签/文件名）
按相关度和热度排序
自动索引管理和同步

系统要求

最低配置

操作系统: Linux / macOS / Windows (WSL2)
Python: 3.9+（推荐 3.11）
内存: 256 MB（优化后可低至 80-120 MB）
磁盘: 100 MB 以上

Docker 部署

Docker: >= 20.10
Docker Compose: >= 2.0
内存: 512 MB（容器限制）

内存优化

查看内存优化方案

智能分词器切换（v2.1+）

修改配置后自动适配，无需手动操作。详见内存优化指南。

# config.ini
[SEARCH]
ANALYZER = simple  # 轻量级，节省 ~140MB 内存
# ANALYZER = jieba # 高质量中文分词

重启后自动完成索引重建！

模式切换脚本

./switch_mode.sh minimal      # 极致省内存 (~80-120 MB)
./switch_mode.sh balanced     # 均衡模式 (~150-200 MB)
./switch_mode.sh performance  # 性能优先 (~200-350 MB)

详见内存优化指南

文档导航

文档	说明
脚本指南	所有管理脚本详细说明
部署指南	详细部署步骤、故障排查
Webhook 模式	Webhook 完整配置指南
管理员指南	管理功能、系统维护
内存优化	内存使用分析与优化
测试指南	测试框架、编写和运行测试
更新日志	版本历史、功能更新

测试

项目包含完整的测试套件，覆盖核心功能模块。

快速测试

# 运行所有测试
pytest

# 生成覆盖率报告
pytest --cov=. --cov-report=html
open htmlcov/index.html

# 使用 Makefile
make test-cov

测试覆盖

热度计算器: 86% 覆盖率，9个测试用例
UI消息格式化: 90% 覆盖率，30个测试用例
文件验证器: 100% 覆盖率，15个测试用例
工具函数: 98% 覆盖率，10+个测试用例

详见完整测试指南和测试套件说明

故障排查

机器人无法启动？

请查看部署指南 - 故障排查章节。

搜索功能异常？

请查看索引管理器文档。

# 重建搜索索引
python3 utils/index_manager.py rebuild

热度数据不更新？

热度每小时自动更新一次
手动触发：./restart.sh

更多问题请查看部署指南的故障排查章节。

项目结构

查看项目结构

TeleSubmit-v2/
├── config/              # 配置管理
├── handlers/            # 消息处理器
│   ├── command_handlers.py
│   ├── submit_handlers.py
│   ├── search_handlers.py
│   └── ...
├── utils/               # 工具模块
│   ├── database.py
│   ├── search_engine.py
│   └── ...
├── ui/                  # 用户界面
├── data/                # 数据目录
├── logs/                # 日志目录
├── main.py              # 主程序入口
└── *.sh                 # 管理脚本

技术栈

语言: Python 3.9+
框架: python-telegram-bot 21.10+
搜索引擎: Whoosh 2.7.4+
中文分词: jieba 0.42.1+ (可选)
数据库: SQLite (通过 aiosqlite)
容器化: Docker & Docker Compose
Web 框架: aiohttp (Webhook 模式)

许可证

本项目采用 MIT 许可证。

适用场景

内容社区管理: 管理用户投稿，审核内容质量
资源分享频道: 组织和管理分享的资源，支持搜索和分类
新闻资讯频道: 收集和整理新闻资讯，支持标签分类
学习资料频道: 管理学习资料，支持全文搜索和热度排序
技术分享频道: 技术文章和代码分享，支持标签和搜索

帮助与支持

问题反馈: GitHub Issues
功能建议: GitHub Discussions
开发者: @zoidberg-xgd

⭐ 如果觉得有用，请给个 Star！

Made by zoidberg-xgd

Name		Name	Last commit message	Last commit date
Latest commit History 90 Commits
.github		.github
config		config
database		database
docs		docs
handlers		handlers
models		models
tests		tests
ui		ui
utils		utils
.coveragerc		.coveragerc
.dockerignore		.dockerignore
.gitattributes		.gitattributes
.gitignore		.gitignore
ADMIN_GUIDE.md		ADMIN_GUIDE.md
CHANGELOG.md		CHANGELOG.md
DELETE_POST_GUIDE.md		DELETE_POST_GUIDE.md
DEPLOYMENT.md		DEPLOYMENT.md
Dockerfile		Dockerfile
INDEX_MANAGER_README.md		INDEX_MANAGER_README.md
LICENSE		LICENSE
MEMORY_USAGE.md		MEMORY_USAGE.md
Makefile		Makefile
Makefile.tests		Makefile.tests
README.md		README.md
SCRIPTS_GUIDE.md		SCRIPTS_GUIDE.md
STATS_FAQ.md		STATS_FAQ.md
TESTING.md		TESTING.md
check_config.py		check_config.py
cleanup_duplicates.py		cleanup_duplicates.py
config.ini.example		config.ini.example
deploy.sh		deploy.sh
deploy_flyio.sh		deploy_flyio.sh
diagnose_stats.py		diagnose_stats.py
docker-compose.yml		docker-compose.yml
fly.toml		fly.toml
install.sh		install.sh
main.py		main.py
migrate_add_filename.py		migrate_add_filename.py
migrate_extract_filenames.py		migrate_extract_filenames.py
migrate_to_search.py		migrate_to_search.py
optimize_database.py		optimize_database.py
optimize_memory.sh		optimize_memory.sh
pytest.ini		pytest.ini
pythonanywhere_wsgi.py		pythonanywhere_wsgi.py
quickstart.sh		quickstart.sh
requirements.txt		requirements.txt
restart.sh		restart.sh
run_all_tests.sh		run_all_tests.sh
run_tests.py		run_tests.py
setup_wizard.py		setup_wizard.py
start.sh		start.sh
switch_mode.sh		switch_mode.sh
uninstall.sh		uninstall.sh
update.sh		update.sh
upgrade.sh		upgrade.sh

Folders and files

Latest commit

History

Repository files navigation

TeleSubmit v2

核心功能

快速开始

一键部署（推荐新手）

其他部署方式

基本配置

运行模式选择

常用命令

管理脚本

用户命令

投稿流程

搜索功能

基础搜索

高级搜索

系统要求

最低配置

推荐配置

Docker 部署

内存优化

智能分词器切换（v2.1+）

模式切换脚本

文档导航

推荐阅读顺序

测试

快速测试

测试覆盖

故障排查

项目结构

技术栈

许可证

适用场景

帮助与支持

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages