功能说明

一键生成 Telegram、微信、抖音、Discord 等多平台 Bot，统一 API 接口，一次开发，多平台部署。支持消息处理、命令响应、媒体发送、用户管理等功能。

支持平台

快速开始

方式一：CLI 创建

# 创建新 Bot 项目
npx bot-builder create my-bot
# 选择平台
? Select platforms:
  ◉ Telegram
  ◉ Discord
  ◉ WeChat
  ◉ Douyin
# 生成项目结构
my-bot/
├── src/
│   ├── handlers/
│   │   ├── message.js
│   │   ├── command.js
│   │   └── event.js
│   ├── adapters/
│   │   ├── telegram.js
│   │   ├── discord.js
│   │   └── wechat.js
│   └── index.js
├── config/
│   └── platforms.json
├── .env
└── package.json

方式二：代码创建

const { BotBuilder } = require('@skylv/bot-builder');
const bot = new BotBuilder({
  name: 'my-assistant',
  platforms: ['telegram', 'discord', 'wechat']
});
// 添加消息处理器
bot.onMessage(async (ctx) => {
  await ctx.reply(收到：${ctx.message.text});
});
// 添加命令处理器
bot.onCommand('/start', async (ctx) => {
  await ctx.reply('欢迎使用！');
});
// 部署到多平台
await bot.deploy();

方式三：配置文件

# bot.yaml
name: my-assistant
version: 1.0.0
platforms:
  telegram:
    enabled: true
    token: ${TELEGRAM_BOT_TOKEN}
    webhook: https://your-domain.com/telegram/webhook
  
  discord:
    enabled: true
    token: ${DISCORD_BOT_TOKEN}
    intents:
      - GUILD_MESSAGES
      - DIRECT_MESSAGES
  
  wechat:
    enabled: true
    appId: ${WECHAT_APP_ID}
    appSecret: ${WECHAT_APP_SECRET}
    token: ${WECHAT_TOKEN}
handlers:
  - type: message
    pattern: "."
    handler: ./src/handlers/message.js
  
  - type: command
    commands: ["/start", "/help"]
    handler: ./src/handlers/command.js

统一 API

消息处理

// 统一消息上下文
{
  platform: 'telegram',
  userId: '123456',
  chatId: 'chat_789',
  message: {
    type: 'text',  // text|image|voice|video|document
    content: 'Hello',
    timestamp: 1234567890
  },
  user: {
    id: '123456',
    name: '张三',
    avatar: 'https://...'
  }
}
// 统一回复接口
ctx.reply('文本消息')
ctx.replyImage(imageUrl)
ctx.replyVoice(audioUrl)
ctx.replyVideo(videoUrl)
ctx.replyDocument(fileUrl)

命令处理

// 命令注册
bot.command('/start', async (ctx) => {
  await ctx.reply('欢迎！使用 /help 查看帮助');
});
bot.command('/help', async (ctx) => {
  const helpText = 
可用命令:
/start - 开始
/help - 帮助
/settings - 设置
;
  await ctx.reply(helpText);
});
// 命令参数解析
bot.command('/search ', async (ctx) => {
  const { query } = ctx.args;
  const results = await search(query);
  await ctx.reply(JSON.stringify(results));
});

事件处理

// 用户事件
bot.onEvent('user.joined', async (ctx) => {
  await ctx.reply(欢迎 ${ctx.user.name}！);
});
bot.onEvent('user.left', async (ctx) => {
  console.log(${ctx.user.name} 离开了);
});
// 消息事件
bot.onEvent('message.edited', async (ctx) => {
  console.log('消息被编辑了');
});
bot.onEvent('message.deleted', async (ctx) => {
  console.log('消息被删除了');
});

平台适配器

Telegram Adapter

const telegram = require('./adapters/telegram');
telegram.init({
  token: process.env.TELEGRAM_BOT_TOKEN,
  webhook: {
    url: 'https://your-domain.com/telegram/webhook',
    port: 8443
  }
});
// 特有功能
telegram.sendPoll({
  chatId,
  question: '你喜欢什么？',
  options: ['A', 'B', 'C'],
  multiple: false
});
telegram.sendLocation({
  chatId,
  latitude: 39.9,
  longitude: 116.4
});

Discord Adapter

const discord = require('./adapters/discord');
discord.init({
  token: process.env.DISCORD_BOT_TOKEN,
  intents: ['GUILD_MESSAGES', 'DIRECT_MESSAGES']
});
// 特有功能
discord.createEmbed({
  title: '标题',
  description: '描述',
  color: 0x00AE86,
  fields: [
    { name: '字段 1', value: '值 1' },
    { name: '字段 2', value: '值 2' }
  ]
});
discord.addReaction({
  messageId,
  emoji: '👍'
});

微信 Adapter

const wechat = require('./adapters/wechat');
wechat.init({
  appId: process.env.WECHAT_APP_ID,
  appSecret: process.env.WECHAT_APP_SECRET,
  token: process.env.WECHAT_TOKEN,
  encodingAESKey: process.env.WECHAT_AES_KEY
});
// 特有功能
wechat.sendTemplateMessage({
  toUser: userId,
  templateId: 'TEMPLATE_ID',
  data: {
    first: { value: '您好' },
    keyword1: { value: '订单完成' },
    remark: { value: '感谢使用' }
  }
});
wechat.createQRCode({
  sceneId: '123',
  expireSeconds: 2592000
});

部署方案

Docker 部署

FROM node:20-alpine
WORKDIR /app
COPY package.json ./
RUN npm ci --only=production
COPY . .
EXPOSE 8443
CMD ["node", "src/index.js"]

# 构建镜像
docker build -t my-bot .
# 运行容器
docker run -d \
  --name my-bot \
  -p 8443:8443 \
  -e TELEGRAM_BOT_TOKEN=xxx \
  -e DISCORD_BOT_TOKEN=xxx \
  my-bot

Serverless 部署

# vercel.json
{
  "version": 2,
  "builds": [
    { "src": "src/index.js", "use": "@vercel/node" }
  ],
  "routes": [
    { "src": "/telegram/webhook", "dest": "src/index.js" },
    { "src": "/discord/webhook", "dest": "src/index.js" },
    { "src": "/wechat/webhook", "dest": "src/index.js" }
  ]
}

# 部署到 Vercel
vercel deploy

工具函数

create_bot

def create_bot(name: str, platforms: list, config: dict) -> dict:
    """
    创建 Bot 项目
    
    Args:
        name: Bot 名称
        platforms: 平台列表
        config: 配置字典
    
    Returns:
        {
            "project_path": "/path/to/my-bot",
            "files_created": [...],
            "next_steps": ["配置 Token", "部署 webhook", "启动服务"]
        }
    """

deploy_to_platform

def deploy_to_platform(platform: str, bot_config: dict) -> dict:
    """
    部署到指定平台
    
    Args:
        platform: 平台名称
        bot_config: Bot 配置
    
    Returns:
        {
            "status": "success",
            "webhook_url": "https://...",
            "test_message": "发送测试消息"
        }
    """

analyze_bot_performance

def analyze_bot_performance(bot_id: str, time_range: str = "24h") -> dict:
    """
    分析 Bot 性能
    
    Args:
        bot_id: Bot ID
        time_range: 时间范围
    
    Returns:
        {
            "total_messages": 10000,
            "active_users": 500,
            "avg_response_time": 0.5,
            "error_rate": 0.01,
            "platform_breakdown": {...}
        }
    """

相关文件

• Telegram Bot API
• Discord Developer Portal
• 微信公众号开发
• 抖音开放平台

触发词

• 自动：检测 bot、telegram、wechat、discord、cross-platform 相关关键词
• 手动：/bot-builder, /create-bot, /multi-platform-bot
• 短语：创建 Bot、Telegram Bot、微信 Bot、跨平台 Bot