• 🤖 多客户端管理 - 支持管理多个 Telegram 客户端账号
• 📝 智能转发规则 - 基于关键词、来源聊天的灵活转发规则
• 🔄 消息替换 - 支持消息内容的查找替换
• 📊 实时监控 - 消息统计、日志查看、系统状态监控
• 🎨 现代化界面 - 响应式设计，支持深色/浅色主题切换

• ⚡ 高性能 - 异步处理，支持大量并发消息
• 🔐 安全可靠 - JWT 认证，完整的权限管理
• 📱 响应式设计 - 完美适配桌面端和移动端
• 🎯 类型安全 - 完整的 TypeScript 类型定义
• 🐳 容器化部署 - 一键启动，开箱即用

• Docker & Docker Compose
• Telegram API 凭证（从 https://my.telegram.org 获取）

1. 克隆项目

git clone <repository-url>
cd TMC

2. 配置环境变量（可选）

方式 A：通过网页端配置（推荐） ⭐

• 无需配置环境变量，直接启动服务
• 在网页端"客户端管理"页面添加客户端时提供 API_ID、API_HASH 等信息
• 适合多客户端场景，每个客户端可以使用不同的 API 凭证

方式 B：通过环境变量配置（全局配置）

# 编辑 docker-compose.yml 或创建 .env 文件
# 设置以下全局配置（作为 fallback）：
# - API_ID, API_HASH（可选）
# - BOT_TOKEN（可选）
# - PHONE_NUMBER（可选）
# - ADMIN_USER_IDS（可选）
# - JWT_SECRET（可选 - Web 管理界面登录密钥，不设置会自动生成）

3. 启动服务

docker compose up -d

4. 访问系统

• 打开浏览器访问: http://localhost:9393
• 默认账号: admin / admin123
• ⚠️ 首次登录后请立即修改密码！

在 客户端管理 页面：

1. 点击"添加客户端"
2. 选择客户端类型（用户客户端 / 机器人客户端）
3. 填写客户端配置：
   • 用户客户端：API ID、API Hash、手机号
   • 机器人客户端：Bot Token、管理员用户ID
4. 提交后进行登录验证（用户客户端需要验证码）
5. 启动客户端

在 转发规则 页面：

1. 点击"新建规则"
2. 选择源聊天和目标聊天
3. 设置过滤关键词（可选）
4. 配置替换规则（可选）
5. 启用规则

在 消息日志 页面：

• 查看所有转发的消息
• 按时间、来源、状态筛选
• 查看详细的转发信息

在 系统设置 页面：

• 配置系统参数
• 管理用户账号
• 查看容器日志
• 监控系统状态

TMC/
├── app/
│   ├── backend/          # Python FastAPI 后端
│   │   ├── api/          # API 路由
│   │   ├── models.py     # 数据模型
│   │   ├── database.py   # 数据库管理
│   │   └── main.py       # 应用入口
│   │
│   └── frontend/         # React 前端
│       ├── src/
│       │   ├── components/   # React 组件
│       │   ├── pages/        # 页面组件
│       │   ├── services/     # API 服务
│       │   └── theme/        # 主题系统
│       └── dist/         # 构建产物
│
├── data/                 # 数据库文件
├── logs/                 # 日志文件
├── sessions/             # Telegram 会话
└── docker-compose.yml    # Docker 编排

• Python 3.11
• FastAPI - 现代化的 Web 框架
• SQLAlchemy - 异步 ORM
• Telethon - Telegram 客户端库
• Alembic - 数据库迁移工具

• React 18 - UI 框架
• TypeScript - 类型安全
• Ant Design - UI 组件库
• Vite - 构建工具
• React Query - 数据管理

• Docker - 容器化
• SQLite - 数据库
• Nginx - 静态文件服务（内置）

# 后端开发
cd app/backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn main:app --reload

# 前端开发
cd app/frontend
npm install
npm run dev

# 后端测试（测试文件已归档）
cd app/backend
pytest

# 前端测试（测试文件已归档）
cd app/frontend
npm run test

docker compose -f docker-compose.yml up -d --build

Q: 登录后显示 401 未授权？
A: 清除浏览器缓存并硬刷新（Ctrl+Shift+R）

Q: 容器日志无法加载？
A: 重新登录获取新的认证 token

Q: 主题切换不生效？
A: 清除浏览器缓存，或使用隐私模式测试

Q: 客户端无法连接？
A: 检查网络连接，确认 Telegram API 凭证正确

更多问题请查看 PROJECT_STATUS.md 文档。

功能优化与用户体验提升

• ✨ 详情弹窗结构化展示（聊天详情、消息详情）
• 🔧 消息日志记录可靠性优化（重试机制+失败队列）
• 🧹 Web端日志过滤优化（移除系统噪音日志）
• 📚 文档清理与归档

查看完整更新日志

首个生产就绪版本发布！

• ✅ 完整的 Telegram 消息转发功能
• ✅ 完成主题系统重构，支持流畅的主题切换动画
• ✅ 修复所有认证相关问题（容器日志、系统状态）
• ✅ 解决数据库迁移冲突
• ✅ 优化项目结构，归档非生产文件
• ✅ 完善部署文档和故障排查指南
• ✅ GitHub Actions 自动构建
• ✅ Docker Hub 镜像发布

• 实现用户认证系统
• 添加头像上传功能
• 优化 API 接口

• 全面重构为前后端分离架构
• 引入 Docker 容器化部署
• 实现实时日志流

本项目采用 MIT 许可证。详见 LICENSE 文件。

欢迎提交 Issue 和 Pull Request！

1. Fork 本项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 提交 Pull Request

加入我们的 Telegram 交流群，获取帮助和交流使用经验：

• 📖 完整文档: 查看 PROJECT_STATUS.md
• 🐛 Bug 报告: 提交 GitHub Issue
• 💡 功能建议: 提交 Feature Request

如果 TMC 对你有帮助，欢迎通过以下方式支持项目：

给项目一个 Star 是对我们最大的鼓励！

扫码支持，感谢您的慷慨！

• 💬 加入 Telegram 交流群参与讨论
• 🐛 提交 Bug 报告和功能建议
• 🔧 贡献代码（Pull Request）
• 📝 帮助改进文档
• 📢 分享给更多需要的人
• ⭐ 给项目点 Star