chore: initial commit

DEPLOY_TO_GITHUB.md

@@ -0,0 +1,78 @@
+# 上传到 GitHub 的步骤
+
+## 1. 创建 GitHub 仓库
+
+1. 登录 [GitHub](https://github.com)
+2. 点击右上角的 "+" → "New repository"
+3. 填写仓库信息：
+   - Repository name: `telegram-customer-bot`
+   - Description: `Telegram 客服机器人 - 自动转发客户消息给管理员`
+   - 选择 Public 或 Private
+   - 不要初始化 README（我们已经有了）
+
+## 2. 连接本地仓库到 GitHub
+
+```bash
+# 添加远程仓库（替换 YOUR_USERNAME）
+git remote add origin https://github.com/YOUR_USERNAME/telegram-customer-bot.git
+
+# 或使用 SSH（如果配置了 SSH key）
+git remote add origin git@github.com:YOUR_USERNAME/telegram-customer-bot.git
+
+# 推送代码
+git branch -M main
+git push -u origin main
+```
+
+## 3. 项目功能说明
+
+### 核心功能
+- ✅ **消息转发**：客户消息自动转发给管理员
+- ✅ **快速回复**：管理员直接输入文字即可回复最近客户
+- ✅ **会话管理**：追踪所有活跃会话
+- ✅ **数据持久化**：SQLite 数据库存储历史记录
+- ✅ **模块化架构**：清晰的代码结构，易于维护
+
+### 技术特点
+- 🔧 生产级代码质量
+- 📝 完整的错误处理
+- 🎯 装饰器模式应用
+- 🗂️ 分层架构设计
+- ⚙️ 环境变量配置
+
+### 目录结构
+```
+src/
+├── core/           # 核心业务逻辑
+│   ├── bot.py      # 主机器人类
+│   ├── router.py   # 消息路由
+│   └── handlers.py # 处理器基类
+├── config/         # 配置管理
+├── utils/          # 工具函数
+└── modules/        # 扩展模块
+    └── storage/    # 数据存储
+```
+
+## 4. 部署说明
+
+1. 克隆仓库
+2. 复制 `.env.example` 为 `.env`
+3. 填写你的 Bot Token 和管理员 ID
+4. 安装依赖：`pip install -r requirements.txt`
+5. 运行：`python main.py`
+
+## 5. 重要文件说明
+
+- `.env.example` - 配置模板（不包含敏感信息）
+- `.gitignore` - 忽略敏感文件（.env、数据库、日志）
+- `requirements.txt` - Python 依赖
+- `LICENSE` - MIT 开源协议
+
+## 注意事项
+
+⚠️ **安全提醒**：
+- 永远不要提交 `.env` 文件
+- Bot Token 必须保密
+- 定期备份数据库文件
+
+🎉 项目已准备就绪，可以上传到 GitHub！