|
|
@@ -1,261 +1,260 @@
|
|
|
-TRANSLATED CONTENT:
|
|
|
-# Telegram 生态开发资源索引
|
|
|
+# Telegram Ecosystem Development Resource Index
|
|
|
|
|
|
-## 官方文档
|
|
|
+## Official Documentation
|
|
|
|
|
|
### Bot API
|
|
|
-**主文档:** https://core.telegram.org/bots/api
|
|
|
-**描述:** Telegram Bot API 完整参考文档
|
|
|
+**Main Documentation:** https://core.telegram.org/bots/api
|
|
|
+**Description:** Complete reference documentation for the Telegram Bot API
|
|
|
|
|
|
-**核心功能：**
|
|
|
-- 消息发送和接收
|
|
|
-- 媒体文件处理
|
|
|
-- 内联模式
|
|
|
-- 支付集成
|
|
|
-- Webhook 配置
|
|
|
-- 游戏和投票
|
|
|
+**Core Features:**
|
|
|
+- Sending and receiving messages
|
|
|
+- Handling media files
|
|
|
+- Inline mode
|
|
|
+- Payment integration
|
|
|
+- Webhook configuration
|
|
|
+- Games and polls
|
|
|
|
|
|
### Mini Apps (Web Apps)
|
|
|
-**主文档:** https://core.telegram.org/bots/webapps
|
|
|
-**完整平台:** https://docs.telegram-mini-apps.com
|
|
|
-**描述:** Telegram 小程序开发文档
|
|
|
+**Main Documentation:** https://core.telegram.org/bots/webapps
|
|
|
+**Full Platform:** https://docs.telegram-mini-apps.com
|
|
|
+**Description:** Development documentation for Telegram Mini Apps
|
|
|
|
|
|
-**核心功能：**
|
|
|
+**Core Features:**
|
|
|
- WebApp API
|
|
|
-- 主题和 UI 控件
|
|
|
-- 存储（Cloud/Device/Secure）
|
|
|
-- 生物识别认证
|
|
|
-- 位置和传感器
|
|
|
-- 支付集成
|
|
|
+- Themes and UI controls
|
|
|
+- Storage (Cloud/Device/Secure)
|
|
|
+- Biometric authentication
|
|
|
+- Location and sensors
|
|
|
+- Payment integration
|
|
|
|
|
|
### Telegram API & MTProto
|
|
|
-**主文档:** https://core.telegram.org
|
|
|
-**描述:** 完整的 Telegram 协议和客户端开发
|
|
|
-
|
|
|
-**核心功能：**
|
|
|
-- MTProto 协议
|
|
|
-- TDLib 客户端库
|
|
|
-- 认证和加密
|
|
|
-- 文件操作
|
|
|
+**Main Documentation:** https://core.telegram.org
|
|
|
+**Description:** Complete Telegram protocol and client development
|
|
|
+
|
|
|
+**Core Features:**
|
|
|
+- MTProto protocol
|
|
|
+- TDLib client library
|
|
|
+- Authentication and encryption
|
|
|
+- File operations
|
|
|
- Secret Chats
|
|
|
|
|
|
-## 官方 GitHub 仓库
|
|
|
-
|
|
|
-### Bot API 服务器
|
|
|
-**仓库:** https://github.com/tdlib/telegram-bot-api
|
|
|
-**描述:** Telegram Bot API 服务器实现
|
|
|
-**特点:**
|
|
|
-- 本地模式部署
|
|
|
-- 支持大文件（最高 2000 MB）
|
|
|
-- C++ 实现
|
|
|
-- TDLib 基础
|
|
|
-
|
|
|
-### Android 客户端
|
|
|
-**仓库:** https://github.com/DrKLO/Telegram
|
|
|
-**描述:** 官方 Android 客户端源代码
|
|
|
-**特点:**
|
|
|
-- 完整的 Android 实现
|
|
|
+## Official GitHub Repositories
|
|
|
+
|
|
|
+### Bot API Server
|
|
|
+**Repository:** https://github.com/tdlib/telegram-bot-api
|
|
|
+**Description:** Implementation of the Telegram Bot API server
|
|
|
+**Features:**
|
|
|
+- Local mode deployment
|
|
|
+- Support for large files (up to 2000 MB)
|
|
|
+- C++ implementation
|
|
|
+- Based on TDLib
|
|
|
+
|
|
|
+### Android Client
|
|
|
+**Repository:** https://github.com/DrKLO/Telegram
|
|
|
+**Description:** Source code for the official Android client
|
|
|
+**Features:**
|
|
|
+- Complete Android implementation
|
|
|
- Material Design
|
|
|
-- 可自定义编译
|
|
|
-
|
|
|
-### Desktop 客户端
|
|
|
-**仓库:** https://github.com/telegramdesktop/tdesktop
|
|
|
-**描述:** 官方桌面客户端 (Windows, macOS, Linux)
|
|
|
-**特点:**
|
|
|
-- Qt/C++ 实现
|
|
|
-- 跨平台支持
|
|
|
-- 完整功能
|
|
|
-
|
|
|
-### 官方组织
|
|
|
-**组织页面:** https://github.com/orgs/TelegramOfficial/repositories
|
|
|
-**包含:**
|
|
|
-- Beta 版本
|
|
|
-- 支持工具
|
|
|
-- 示例代码
|
|
|
-
|
|
|
-## API 方法分类
|
|
|
-
|
|
|
-### 更新管理
|
|
|
-- `getUpdates` - 长轮询
|
|
|
-- `setWebhook` - 设置 Webhook
|
|
|
-- `deleteWebhook` - 删除 Webhook
|
|
|
-- `getWebhookInfo` - Webhook 信息
|
|
|
-
|
|
|
-### 消息操作
|
|
|
-**发送消息：**
|
|
|
-- `sendMessage` - 文本消息
|
|
|
-- `sendPhoto` - 图片
|
|
|
-- `sendVideo` - 视频
|
|
|
-- `sendDocument` - 文档
|
|
|
-- `sendAudio` - 音频
|
|
|
-- `sendVoice` - 语音
|
|
|
-- `sendLocation` - 位置
|
|
|
-- `sendVenue` - 地点
|
|
|
-- `sendContact` - 联系人
|
|
|
-- `sendPoll` - 投票
|
|
|
-- `sendDice` - 骰子/飞镖
|
|
|
-
|
|
|
-**编辑消息：**
|
|
|
-- `editMessageText` - 编辑文本
|
|
|
-- `editMessageCaption` - 编辑标题
|
|
|
-- `editMessageMedia` - 编辑媒体
|
|
|
-- `editMessageReplyMarkup` - 编辑键盘
|
|
|
-- `deleteMessage` - 删除消息
|
|
|
-
|
|
|
-**其他操作：**
|
|
|
-- `forwardMessage` - 转发消息
|
|
|
-- `copyMessage` - 复制消息
|
|
|
-- `sendChatAction` - 发送动作（输入中...）
|
|
|
-
|
|
|
-### 文件操作
|
|
|
-- `getFile` - 获取文件信息
|
|
|
-- 文件下载 URL: `https://api.telegram.org/file/bot<token>/<file_path>`
|
|
|
-- 文件上传：支持 multipart/form-data
|
|
|
-- 最大文件：50 MB (标准), 2000 MB (本地 Bot API)
|
|
|
-
|
|
|
-### 内联模式
|
|
|
-- `answerInlineQuery` - 响应内联查询
|
|
|
-- 结果类型：article, photo, gif, video, audio, voice, document, location, venue, contact, game, sticker
|
|
|
-
|
|
|
-### 回调查询
|
|
|
-- `answerCallbackQuery` - 响应按钮点击
|
|
|
-- 可显示通知或警告
|
|
|
-
|
|
|
-### 支付
|
|
|
-- `sendInvoice` - 发送发票
|
|
|
-- `answerPreCheckoutQuery` - 预结账
|
|
|
-- `answerShippingQuery` - 配送查询
|
|
|
-- 支持提供商：Stripe, Yandex.Money, Telegram Stars
|
|
|
-
|
|
|
-### 游戏
|
|
|
-- `sendGame` - 发送游戏
|
|
|
-- `setGameScore` - 设置分数
|
|
|
-- `getGameHighScores` - 获取排行榜
|
|
|
-
|
|
|
-### 群组管理
|
|
|
-- `kickChatMember` / `unbanChatMember` - 封禁/解封
|
|
|
-- `restrictChatMember` - 限制权限
|
|
|
-- `promoteChatMember` - 提升管理员
|
|
|
-- `setChatTitle` / `setChatDescription` - 设置信息
|
|
|
-- `setChatPhoto` - 设置头像
|
|
|
-- `pinChatMessage` / `unpinChatMessage` - 置顶消息
|
|
|
-
|
|
|
-## Mini Apps API 详解
|
|
|
-
|
|
|
-### 初始化
|
|
|
+- Customizable compilation
|
|
|
+
|
|
|
+### Desktop Client
|
|
|
+**Repository:** https://github.com/telegramdesktop/tdesktop
|
|
|
+**Description:** Official desktop client (Windows, macOS, Linux)
|
|
|
+**Features:**
|
|
|
+- Qt/C++ implementation
|
|
|
+- Cross-platform support
|
|
|
+- Full functionality
|
|
|
+
|
|
|
+### Official Organization
|
|
|
+**Organization Page:** https://github.com/orgs/TelegramOfficial/repositories
|
|
|
+**Includes:**
|
|
|
+- Beta versions
|
|
|
+- Support tools
|
|
|
+- Example code
|
|
|
+
|
|
|
+## API Method Categories
|
|
|
+
|
|
|
+### Update Management
|
|
|
+- `getUpdates` - Long polling
|
|
|
+- `setWebhook` - Set a webhook
|
|
|
+- `deleteWebhook` - Delete a webhook
|
|
|
+- `getWebhookInfo` - Webhook information
|
|
|
+
|
|
|
+### Message Operations
|
|
|
+**Sending Messages:**
|
|
|
+- `sendMessage` - Text message
|
|
|
+- `sendPhoto` - Photo
|
|
|
+- `sendVideo` - Video
|
|
|
+- `sendDocument` - Document
|
|
|
+- `sendAudio` - Audio
|
|
|
+- `sendVoice` - Voice
|
|
|
+- `sendLocation` - Location
|
|
|
+- `sendVenue` - Venue
|
|
|
+- `sendContact` - Contact
|
|
|
+- `sendPoll` - Poll
|
|
|
+- `sendDice` - Dice/Darts
|
|
|
+
|
|
|
+**Editing Messages:**
|
|
|
+- `editMessageText` - Edit text
|
|
|
+- `editMessageCaption` - Edit caption
|
|
|
+- `editMessageMedia` - Edit media
|
|
|
+- `editMessageReplyMarkup` - Edit keyboard
|
|
|
+- `deleteMessage` - Delete a message
|
|
|
+
|
|
|
+**Other Operations:**
|
|
|
+- `forwardMessage` - Forward a message
|
|
|
+- `copyMessage` - Copy a message
|
|
|
+- `sendChatAction` - Send an action (typing...)
|
|
|
+
|
|
|
+### File Operations
|
|
|
+- `getFile` - Get file information
|
|
|
+- File download URL: `https://api.telegram.org/file/bot<token>/<file_path>`
|
|
|
+- File upload: Supports multipart/form-data
|
|
|
+- Max file size: 50 MB (standard), 2000 MB (local Bot API)
|
|
|
+
|
|
|
+### Inline Mode
|
|
|
+- `answerInlineQuery` - Respond to an inline query
|
|
|
+- Result types: article, photo, gif, video, audio, voice, document, location, venue, contact, game, sticker
|
|
|
+
|
|
|
+### Callback Queries
|
|
|
+- `answerCallbackQuery` - Respond to a button click
|
|
|
+- Can display a notification or an alert
|
|
|
+
|
|
|
+### Payments
|
|
|
+- `sendInvoice` - Send an invoice
|
|
|
+- `answerPreCheckoutQuery` - Pre-checkout
|
|
|
+- `answerShippingQuery` - Shipping query
|
|
|
+- Supported providers: Stripe, Yandex.Money, Telegram Stars
|
|
|
+
|
|
|
+### Games
|
|
|
+- `sendGame` - Send a game
|
|
|
+- `setGameScore` - Set a score
|
|
|
+- `getGameHighScores` - Get high scores
|
|
|
+
|
|
|
+### Group Management
|
|
|
+- `kickChatMember` / `unbanChatMember` - Ban/unban
|
|
|
+- `restrictChatMember` - Restrict permissions
|
|
|
+- `promoteChatMember` - Promote to admin
|
|
|
+- `setChatTitle` / `setChatDescription` - Set chat info
|
|
|
+- `setChatPhoto` - Set chat photo
|
|
|
+- `pinChatMessage` / `unpinChatMessage` - Pin/unpin a message
|
|
|
+
|
|
|
+## Mini Apps API Details
|
|
|
+
|
|
|
+### Initialization
|
|
|
```javascript
|
|
|
const tg = window.Telegram.WebApp;
|
|
|
tg.ready();
|
|
|
tg.expand();
|
|
|
```
|
|
|
|
|
|
-### 主要对象
|
|
|
-- **WebApp** - 主接口
|
|
|
-- **MainButton** - 主按钮
|
|
|
-- **SecondaryButton** - 次要按钮
|
|
|
-- **BackButton** - 返回按钮
|
|
|
-- **SettingsButton** - 设置按钮
|
|
|
-- **HapticFeedback** - 触觉反馈
|
|
|
-- **CloudStorage** - 云存储
|
|
|
-- **BiometricManager** - 生物识别
|
|
|
-- **LocationManager** - 位置服务
|
|
|
-- **Accelerometer** - 加速度计
|
|
|
-- **Gyroscope** - 陀螺仪
|
|
|
-- **DeviceOrientation** - 设备方向
|
|
|
-
|
|
|
-### 事件系统
|
|
|
-40+ 事件包括：
|
|
|
-- `themeChanged` - 主题改变
|
|
|
-- `viewportChanged` - 视口改变
|
|
|
-- `mainButtonClicked` - 主按钮点击
|
|
|
-- `backButtonClicked` - 返回按钮点击
|
|
|
-- `settingsButtonClicked` - 设置按钮点击
|
|
|
-- `invoiceClosed` - 支付完成
|
|
|
-- `popupClosed` - 弹窗关闭
|
|
|
-- `qrTextReceived` - 扫码结果
|
|
|
-- `clipboardTextReceived` - 剪贴板文本
|
|
|
-- `writeAccessRequested` - 写入权限请求
|
|
|
-- `contactRequested` - 联系人请求
|
|
|
-
|
|
|
-### 主题参数
|
|
|
+### Main Objects
|
|
|
+- **WebApp** - Main interface
|
|
|
+- **MainButton** - Main button
|
|
|
+- **SecondaryButton** - Secondary button
|
|
|
+- **BackButton** - Back button
|
|
|
+- **SettingsButton** - Settings button
|
|
|
+- **HapticFeedback** - Haptic feedback
|
|
|
+- **CloudStorage** - Cloud storage
|
|
|
+- **BiometricManager** - Biometrics
|
|
|
+- **LocationManager** - Location services
|
|
|
+- **Accelerometer** - Accelerometer
|
|
|
+- **Gyroscope** - Gyroscope
|
|
|
+- **DeviceOrientation** - Device orientation
|
|
|
+
|
|
|
+### Event System
|
|
|
+40+ events including:
|
|
|
+- `themeChanged` - Theme changed
|
|
|
+- `viewportChanged` - Viewport changed
|
|
|
+- `mainButtonClicked` - Main button clicked
|
|
|
+- `backButtonClicked` - Back button clicked
|
|
|
+- `settingsButtonClicked` - Settings button clicked
|
|
|
+- `invoiceClosed` - Payment completed
|
|
|
+- `popupClosed` - Popup closed
|
|
|
+- `qrTextReceived` - QR code scan result
|
|
|
+- `clipboardTextReceived` - Clipboard text
|
|
|
+- `writeAccessRequested` - Write access requested
|
|
|
+- `contactRequested` - Contact requested
|
|
|
+
|
|
|
+### Theme Parameters
|
|
|
```javascript
|
|
|
tg.themeParams = {
|
|
|
- bg_color, // 背景色
|
|
|
- text_color, // 文本色
|
|
|
- hint_color, // 提示色
|
|
|
- link_color, // 链接色
|
|
|
- button_color, // 按钮色
|
|
|
- button_text_color, // 按钮文本色
|
|
|
- secondary_bg_color, // 次要背景色
|
|
|
- header_bg_color, // 头部背景色
|
|
|
- accent_text_color, // 强调文本色
|
|
|
- section_bg_color, // 区块背景色
|
|
|
- section_header_text_color, // 区块头文本色
|
|
|
- subtitle_text_color, // 副标题色
|
|
|
- destructive_text_color // 危险操作色
|
|
|
+ bg_color, // Background color
|
|
|
+ text_color, // Text color
|
|
|
+ hint_color, // Hint color
|
|
|
+ link_color, // Link color
|
|
|
+ button_color, // Button color
|
|
|
+ button_text_color, // Button text color
|
|
|
+ secondary_bg_color, // Secondary background color
|
|
|
+ header_bg_color, // Header background color
|
|
|
+ accent_text_color, // Accent text color
|
|
|
+ section_bg_color, // Section background color
|
|
|
+ section_header_text_color, // Section header text color
|
|
|
+ subtitle_text_color, // Subtitle color
|
|
|
+ destructive_text_color // Destructive action color
|
|
|
}
|
|
|
```
|
|
|
|
|
|
-## 开发工具
|
|
|
+## Development Tools
|
|
|
|
|
|
-### @BotFather 命令
|
|
|
-创建和管理 Bot 的核心工具：
|
|
|
+### @BotFather Commands
|
|
|
+The core tool for creating and managing Bots:
|
|
|
|
|
|
-**Bot 管理：**
|
|
|
-- `/newbot` - 创建新 Bot
|
|
|
-- `/mybots` - 管理我的 Bots
|
|
|
-- `/deletebot` - 删除 Bot
|
|
|
-- `/token` - 重新生成 token
|
|
|
+**Bot Management:**
|
|
|
+- `/newbot` - Create a new Bot
|
|
|
+- `/mybots` - Manage my Bots
|
|
|
+- `/deletebot` - Delete a Bot
|
|
|
+- `/token` - Regenerate a token
|
|
|
|
|
|
-**设置命令：**
|
|
|
-- `/setname` - 设置名称
|
|
|
-- `/setdescription` - 设置描述
|
|
|
-- `/setabouttext` - 设置关于文本
|
|
|
-- `/setuserpic` - 设置头像
|
|
|
+**Settings Commands:**
|
|
|
+- `/setname` - Set name
|
|
|
+- `/setdescription` - Set description
|
|
|
+- `/setabouttext` - Set about text
|
|
|
+- `/setuserpic` - Set user picture
|
|
|
|
|
|
-**功能配置：**
|
|
|
-- `/setcommands` - 设置命令列表
|
|
|
-- `/setinline` - 启用内联模式
|
|
|
-- `/setinlinefeedback` - 内联反馈
|
|
|
-- `/setjoingroups` - 允许加入群组
|
|
|
-- `/setprivacy` - 隐私模式
|
|
|
+**Feature Configuration:**
|
|
|
+- `/setcommands` - Set command list
|
|
|
+- `/setinline` - Enable inline mode
|
|
|
+- `/setinlinefeedback` - Inline feedback
|
|
|
+- `/setjoingroups` - Allow joining groups
|
|
|
+- `/setprivacy` - Privacy mode
|
|
|
|
|
|
-**支付和游戏：**
|
|
|
-- `/setgamescores` - 游戏分数
|
|
|
-- `/setpayments` - 配置支付
|
|
|
+**Payments and Games:**
|
|
|
+- `/setgamescores` - Game scores
|
|
|
+- `/setpayments` - Configure payments
|
|
|
|
|
|
-**Mini Apps：**
|
|
|
-- `/newapp` - 创建 Mini App
|
|
|
-- `/myapps` - 管理 Mini Apps
|
|
|
-- `/setmenubutton` - 设置菜单按钮
|
|
|
+**Mini Apps:**
|
|
|
+- `/newapp` - Create a Mini App
|
|
|
+- `/myapps` - Manage Mini Apps
|
|
|
+- `/setmenubutton` - Set menu button
|
|
|
|
|
|
-### API ID 获取
|
|
|
-访问 https://my.telegram.org
|
|
|
-1. 登录账号
|
|
|
-2. 进入 API development tools
|
|
|
-3. 创建应用
|
|
|
-4. 获取 API ID 和 API Hash
|
|
|
+### Getting an API ID
|
|
|
+Visit https://my.telegram.org
|
|
|
+1. Log in to your account
|
|
|
+2. Go to API development tools
|
|
|
+3. Create an application
|
|
|
+4. Get your API ID and API Hash
|
|
|
|
|
|
-## 常用 Python 库
|
|
|
+## Common Python Libraries
|
|
|
|
|
|
### python-telegram-bot
|
|
|
```bash
|
|
|
pip install python-telegram-bot
|
|
|
```
|
|
|
|
|
|
-**特点：**
|
|
|
-- 完整的 Bot API 包装
|
|
|
-- 异步和同步支持
|
|
|
-- 丰富的扩展
|
|
|
-- 活跃维护
|
|
|
+**Features:**
|
|
|
+- Complete Bot API wrapper
|
|
|
+- Asynchronous and synchronous support
|
|
|
+- Rich extensions
|
|
|
+- Actively maintained
|
|
|
|
|
|
-**基础示例：**
|
|
|
+**Basic Example:**
|
|
|
```python
|
|
|
from telegram import Update
|
|
|
from telegram.ext import Application, CommandHandler, ContextTypes
|
|
|
|
|
|
async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
|
|
|
- await update.message.reply_text('你好！')
|
|
|
+ await update.message.reply_text('Hello!')
|
|
|
|
|
|
app = Application.builder().token("TOKEN").build()
|
|
|
app.add_handler(CommandHandler("start", start))
|
|
|
@@ -267,25 +266,25 @@ app.run_polling()
|
|
|
pip install aiogram
|
|
|
```
|
|
|
|
|
|
-**特点：**
|
|
|
-- 纯异步
|
|
|
-- 高性能
|
|
|
-- FSM 状态机
|
|
|
-- 中间件系统
|
|
|
+**Features:**
|
|
|
+- Purely asynchronous
|
|
|
+- High performance
|
|
|
+- FSM state machine
|
|
|
+- Middleware system
|
|
|
|
|
|
### Telethon / Pyrogram
|
|
|
-MTProto 客户端库：
|
|
|
+MTProto client libraries:
|
|
|
```bash
|
|
|
pip install telethon
|
|
|
pip install pyrogram
|
|
|
```
|
|
|
|
|
|
-**用途：**
|
|
|
-- 自定义客户端
|
|
|
-- 用户账号自动化
|
|
|
-- 完整 Telegram 功能
|
|
|
+**Uses:**
|
|
|
+- Custom clients
|
|
|
+- User account automation
|
|
|
+- Full Telegram functionality
|
|
|
|
|
|
-## 常用 Node.js 库
|
|
|
+## Common Node.js Libraries
|
|
|
|
|
|
### node-telegram-bot-api
|
|
|
```bash
|
|
|
@@ -297,25 +296,25 @@ npm install node-telegram-bot-api
|
|
|
npm install telegraf
|
|
|
```
|
|
|
|
|
|
-**特点：**
|
|
|
-- 现代化
|
|
|
-- 中间件架构
|
|
|
-- TypeScript 支持
|
|
|
+**Features:**
|
|
|
+- Modern
|
|
|
+- Middleware architecture
|
|
|
+- TypeScript support
|
|
|
|
|
|
### grammY
|
|
|
```bash
|
|
|
npm install grammy
|
|
|
```
|
|
|
|
|
|
-**特点：**
|
|
|
-- 轻量级
|
|
|
-- 类型安全
|
|
|
-- 插件生态
|
|
|
+**Features:**
|
|
|
+- Lightweight
|
|
|
+- Type-safe
|
|
|
+- Plugin ecosystem
|
|
|
|
|
|
-## 部署选项
|
|
|
+## Deployment Options
|
|
|
|
|
|
-### Webhook 托管
|
|
|
-**推荐平台：**
|
|
|
+### Webhook Hosting
|
|
|
+**Recommended Platforms:**
|
|
|
- Heroku
|
|
|
- AWS Lambda
|
|
|
- Google Cloud Functions
|
|
|
@@ -324,142 +323,142 @@ npm install grammy
|
|
|
- Railway
|
|
|
- Render
|
|
|
|
|
|
-**要求：**
|
|
|
-- HTTPS 支持
|
|
|
-- 公网可访问
|
|
|
-- 支持的端口：443, 80, 88, 8443
|
|
|
+**Requirements:**
|
|
|
+- HTTPS support
|
|
|
+- Publicly accessible
|
|
|
+- Supported ports: 443, 80, 88, 8443
|
|
|
|
|
|
-### 长轮询托管
|
|
|
-**推荐平台：**
|
|
|
+### Long Polling Hosting
|
|
|
+**Recommended Platforms:**
|
|
|
- VPS (Vultr, DigitalOcean, Linode)
|
|
|
- Raspberry Pi
|
|
|
-- 本地服务器
|
|
|
+- Local server
|
|
|
|
|
|
-**优点：**
|
|
|
-- 无需 HTTPS
|
|
|
-- 简单配置
|
|
|
-- 适合开发测试
|
|
|
+**Advantages:**
|
|
|
+- No HTTPS required
|
|
|
+- Simple configuration
|
|
|
+- Suitable for development and testing
|
|
|
|
|
|
-## 安全最佳实践
|
|
|
+## Security Best Practices
|
|
|
|
|
|
-1. **Token 安全**
|
|
|
- - 不要提交到 Git
|
|
|
- - 使用环境变量
|
|
|
- - 定期轮换
|
|
|
+1. **Token Security**
|
|
|
+ - Do not commit to Git
|
|
|
+ - Use environment variables
|
|
|
+ - Rotate tokens regularly
|
|
|
|
|
|
-2. **数据验证**
|
|
|
- - 验证 initData
|
|
|
- - 服务器端验证
|
|
|
- - 不信任客户端
|
|
|
+2. **Data Validation**
|
|
|
+ - Validate initData
|
|
|
+ - Server-side validation
|
|
|
+ - Do not trust the client
|
|
|
|
|
|
-3. **权限控制**
|
|
|
- - 检查用户权限
|
|
|
- - 管理员验证
|
|
|
- - 群组权限
|
|
|
+3. **Permission Control**
|
|
|
+ - Check user permissions
|
|
|
+ - Admin verification
|
|
|
+ - Group permissions
|
|
|
|
|
|
-4. **速率限制**
|
|
|
- - 实现请求限制
|
|
|
- - 防止滥用
|
|
|
- - 监控异常
|
|
|
+4. **Rate Limiting**
|
|
|
+ - Implement request limits
|
|
|
+ - Prevent abuse
|
|
|
+ - Monitor for anomalies
|
|
|
|
|
|
-## 调试技巧
|
|
|
+## Debugging Tips
|
|
|
|
|
|
-### Bot 调试
|
|
|
+### Bot Debugging
|
|
|
```python
|
|
|
import logging
|
|
|
logging.basicConfig(level=logging.DEBUG)
|
|
|
```
|
|
|
|
|
|
-### Mini App 调试
|
|
|
+### Mini App Debugging
|
|
|
```javascript
|
|
|
-// 开启调试模式
|
|
|
+// Enable debug mode
|
|
|
tg.showAlert(JSON.stringify(tg.initDataUnsafe, null, 2));
|
|
|
|
|
|
-// 控制台日志
|
|
|
+// Console logs
|
|
|
console.log('WebApp version:', tg.version);
|
|
|
console.log('Platform:', tg.platform);
|
|
|
console.log('Theme:', tg.colorScheme);
|
|
|
```
|
|
|
|
|
|
-### Webhook 测试
|
|
|
-使用 ngrok 本地测试：
|
|
|
+### Webhook Testing
|
|
|
+Use ngrok for local testing:
|
|
|
```bash
|
|
|
ngrok http 5000
|
|
|
-# 将生成的 https URL 设置为 webhook
|
|
|
+# Set the generated https URL as the webhook
|
|
|
```
|
|
|
|
|
|
-## 社区资源
|
|
|
+## Community Resources
|
|
|
|
|
|
-- **Telegram 开发者群组**: @BotDevelopers
|
|
|
-- **Telegram API 讨论**: @TelegramBots
|
|
|
-- **Mini Apps 讨论**: @WebAppChat
|
|
|
+- **Telegram Developer Group**: @BotDevelopers
|
|
|
+- **Telegram API Discussion**: @TelegramBots
|
|
|
+- **Mini Apps Discussion**: @WebAppChat
|
|
|
|
|
|
-## 更新日志
|
|
|
+## Changelog
|
|
|
|
|
|
-**最新功能：**
|
|
|
-- Paid Media (付费媒体)
|
|
|
-- Checklist Tasks (检查列表任务)
|
|
|
-- Gift Conversion (礼物转换)
|
|
|
-- Business Features (商业功能)
|
|
|
-- Poll 选项增加到 12 个
|
|
|
-- Story 发布和编辑
|
|
|
+**Latest Features:**
|
|
|
+- Paid Media
|
|
|
+- Checklist Tasks
|
|
|
+- Gift Conversion
|
|
|
+- Business Features
|
|
|
+- Poll options increased to 12
|
|
|
+- Story publishing and editing
|
|
|
|
|
|
---
|
|
|
|
|
|
-## 完整实现模板 (新增)
|
|
|
+## Complete Implementation Templates (New)
|
|
|
|
|
|
-### Telegram Bot 按钮和键盘实现指南
|
|
|
-**文件:** `Telegram_Bot_按钮和键盘实现模板.md`
|
|
|
-**行数:** 404 行
|
|
|
-**大小:** 12 KB
|
|
|
-**语言:** 中文
|
|
|
+### Telegram Bot Button and Keyboard Implementation Guide
|
|
|
+**File:** `Telegram_Bot_button_and_keyboard_implementation_template.md`
|
|
|
+**Lines:** 404
|
|
|
+**Size:** 12 KB
|
|
|
+**Language:** Chinese
|
|
|
|
|
|
-精简实用的 Telegram Bot 交互式功能实现指南：
|
|
|
+A concise and practical guide to implementing interactive features for Telegram Bots:
|
|
|
|
|
|
-**核心内容：**
|
|
|
-- 三种按钮类型详解（Inline/Reply/Command Menu）
|
|
|
-- python-telegram-bot 和 Telethon 双实现对比
|
|
|
-- 完整的代码示例（即拿即用）
|
|
|
-- 项目结构和模块化设计
|
|
|
-- Handler 优先级和事件处理
|
|
|
-- 生产环境部署方案
|
|
|
-- 安全和错误处理最佳实践
|
|
|
+**Core Content:**
|
|
|
+- Detailed explanation of three button types (Inline/Reply/Command Menu)
|
|
|
+- Comparison of implementations with python-telegram-bot and Telethon
|
|
|
+- Complete code examples (ready to use)
|
|
|
+- Project structure and modular design
|
|
|
+- Handler priority and event handling
|
|
|
+- Production deployment solutions
|
|
|
+- Security and error handling best practices
|
|
|
|
|
|
-**特色：**
|
|
|
-- 核心代码精简，去除冗余示例
|
|
|
-- 聚焦常用场景和实用技巧
|
|
|
-- 完整的快速参考表
|
|
|
+**Features:**
|
|
|
+- Concise core code, removing redundant examples
|
|
|
+- Focus on common scenarios and practical tips
|
|
|
+- A complete quick reference table
|
|
|
|
|
|
---
|
|
|
|
|
|
-### 动态视图对齐 - 数据展示指南
|
|
|
-**文件:** `动态视图对齐实现文档.md`
|
|
|
-**行数:** 407 行
|
|
|
-**大小:** 12 KB
|
|
|
-**语言:** 中文
|
|
|
-
|
|
|
-专业的等宽字体数据对齐和格式化方案：
|
|
|
-
|
|
|
-**核心功能：**
|
|
|
-- 智能动态视图对齐算法（三步法）
|
|
|
-- 自动计算列宽，无需硬编码
|
|
|
-- 智能对齐规则（文本左，数字右）
|
|
|
-- 完整的格式化系统：
|
|
|
- - 交易量智能缩写（B/M/K）
|
|
|
- - 价格智能精度（自适应小数位）
|
|
|
- - 涨跌幅格式化（+/- 符号）
|
|
|
- - 资金流向智能显示
|
|
|
-
|
|
|
-**应用场景：**
|
|
|
-- 排行榜、数据表格、实时行情
|
|
|
-- 任何需要专业数据展示的 Telegram Bot
|
|
|
-
|
|
|
-**技术特点：**
|
|
|
-- O(n×m) 线性复杂度，高效实用
|
|
|
-- 1000 行数据处理仅需 5-10ms
|
|
|
-- 支持中文字符宽度扩展
|
|
|
-
|
|
|
-**视觉效果示例：**
|
|
|
+### Dynamic View Alignment - Data Display Guide
|
|
|
+**File:** `dynamic-view-alignment-implementation-document.md`
|
|
|
+**Lines:** 407
|
|
|
+**Size:** 12 KB
|
|
|
+- **Language:** Chinese
|
|
|
+
|
|
|
+A professional solution for monospaced font data alignment and formatting:
|
|
|
+
|
|
|
+**Core Features:**
|
|
|
+- Intelligent dynamic view alignment algorithm (three-step method)
|
|
|
+- Automatic column width calculation, no hardcoding required
|
|
|
+- Smart alignment rules (text left, numbers right)
|
|
|
+- Complete formatting system:
|
|
|
+ - Smart abbreviation for trading volume (B/M/K)
|
|
|
+ - Smart precision for price (adaptive decimal places)
|
|
|
+ - Formatting for price change percentage (+/- signs)
|
|
|
+ - Smart display for fund flow
|
|
|
+
|
|
|
+**Use Cases:**
|
|
|
+- Leaderboards, data tables, real-time tickers
|
|
|
+- Any Telegram Bot that needs professional data display
|
|
|
+
|
|
|
+**Technical Features:**
|
|
|
+- O(n×m) linear complexity, highly efficient
|
|
|
+- Processes 1000 rows of data in just 5-10ms
|
|
|
+- Supports Chinese character width expansion
|
|
|
+
|
|
|
+**Visual Effect Example:**
|
|
|
```
|
|
|
1. BTC $1.23B $45,000 +5.23%
|
|
|
2. ETH $890.5M $2,500 +3.12%
|
|
|
@@ -468,4 +467,4 @@ ngrok http 5000
|
|
|
|
|
|
---
|
|
|
|
|
|
-**这些模板提供了从基础到生产级别的完整 Telegram Bot 开发解决方案！**
|
|
|
+**These templates provide a complete solution for Telegram Bot development, from basic to production level!**
|
tukuaiai