@openilink/app-discord

docker compose up -d

或手动运行：

docker build -t openilink-app-discord .
docker run -d \
  -p 8083:8083 \
  -e HUB_URL="https://your-hub.example.com" \
  -e BASE_URL="https://your-app.example.com" \
  -e DISCORD_BOT_TOKEN="your-bot-token" \
  -e DISCORD_CHANNEL_ID="your-channel-id" \
  -v app-data:/data \
  openilink-app-discord

git clone https://github.com/openilink/openilink-app-discord.git && cd openilink-app-discord
npm install
cp .env.example .env
# 编辑 .env 填入你的配置

# 开发模式（热重载）
npm run dev

# 生产模式
npm run build
npm start

1. 创建应用

1. 登录 Discord Developer Portal
2. 点击右上角 New Application
3. 输入应用名称（如 "OpeniLink Bridge"），点击 Create

2. 获取 Bot Token

1. 左侧菜单选择 Bot
2. 点击 Reset Token，复制并保存 Token
3. 注意：Token 只会显示一次，请妥善保存

3. 配置 Intents

1. 在 Bot 页面下方找到 Privileged Gateway Intents
2. 开启 SERVER MEMBERS INTENT
3. 开启 MESSAGE CONTENT INTENT
4. 点击 Save Changes

4. 生成邀请链接

1. 左侧菜单选择 OAuth2 > URL Generator
2. Scopes 勾选: bot
3. Bot Permissions 勾选:
   • Send Messages
   • Read Message History
   • Manage Messages
   • Embed Links
   • Attach Files
   • Add Reactions
   • Manage Channels
   • Kick Members
   • Ban Members
4. 复制底部生成的 URL

5. 邀请到服务器

1. 在浏览器中打开复制的 URL
2. 选择目标服务器，确认授权

6. 获取频道 ID

1. 在 Discord 客户端中开启开发者模式（设置 > 高级 > 开发者模式）
2. 右键点击目标频道，选择「复制频道 ID」

架构图

graph LR
    WX[微信用户] -->|消息| HUB[OpeniLink Hub]
    HUB -->|Webhook POST| APP[Discord Bridge App]
    APP -->|Gateway WebSocket| DC[Discord]
    DC -->|消息事件| APP
    APP -->|Hub API| HUB
    HUB -->|消息| WX

    subgraph Discord Bridge App
        direction TB
        WEB[HTTP Server]
        WTD[WxToDiscord Bridge]
        DTW[DiscordToWx Bridge]
        RT[Router]
        TL[19 AI Tools]
        ST[(SQLite)]
    end

消息流转

1. 自动桥接（微信 -> Discord）：Hub Webhook -> handleWebhook -> WxToDiscord -> Discord Embed
2. 自动桥接（Discord -> 微信）：Discord Gateway -> registerMessageHandler -> DiscordToWx -> Hub API -> 微信
3. 自然语言命令：Hub Webhook (command) -> Router -> Tool Handler -> Discord API -> 结果回复到微信
4. AI 工具调用：Hub 将 AI 选择的工具通过 command 事件发送，Router 分发到对应 handler 执行

常用命令

# 安装依赖
npm install

# 开发模式
npm run dev

# 编译
npm run build

# 生产运行
npm start

# 运行测试
npm test

# 监视模式
npm run test:watch

项目结构

src/
  index.ts              # 主入口
  config.ts             # 环境变量配置
  store.ts              # SQLite 存储层
  router.ts             # 命令路由器
  hub/
    types.ts            # Hub 协议类型定义
    oauth.ts            # OAuth2 + PKCE 安装流程
    webhook.ts          # Webhook 签名验证与事件分发
    client.ts           # Hub Bot API 客户端
    manifest.ts         # App Manifest 声明
  discord/
    client.ts           # Discord SDK 封装
    event.ts            # Discord 消息事件监听
  bridge/
    wx-to-discord.ts    # 微信 -> Discord 消息转发
    discord-to-wx.ts    # Discord -> 微信消息转发
  tools/
    index.ts            # 工具聚合注册
    messaging.ts        # 消息操作工具（6 个）
    channels.ts         # 频道操作工具（5 个）
    members.ts          # 成员操作工具（4 个）
    embed.ts            # Embed 富文本工具（1 个）
    files.ts            # 文件上传工具（1 个）
    moderation.ts       # 管理操作工具（2 个）
  utils/
    crypto.ts           # 签名验证与 PKCE