Discord 接入

1. 在 Discord 开发者门户 创建应用 → Bot → 复制 Token。
2. 启用 Message Content Intent（推荐同时启用 Server Members Intent）。
3. 生成 OAuth2 邀请链接，将机器人添加到服务器。
4. 配置 Token 并启动 Gateway。

# 环境变量
export DISCORD_BOT_TOKEN="your-token"

# 或配置文件
{
  channels: {
    discord: {
      enabled: true,
      token: "your-token"
    }
  }
}

1. Discord 开发者门户 → Applications → New Application
2. Bot → Add Bot → 复制 Token
3. 启用特权网关意图：
   • Message Content Intent（必需）
   • Server Members Intent（推荐，用于成员查找和允许列表匹配）
4. OAuth2 → URL Generator，选择 Scopes：bot + applications.commands
5. 设置 Bot Permissions：View Channels、Send Messages、Read Message History、Embed Links、Attach Files、Add Reactions

通过 channels.discord.dm 控制私信行为：

{
  channels: {
    discord: {
      dm: {
        enabled: true,
        policy: "pairing",      // pairing | allowlist | open | disabled
        allowFrom: ["123456789"],
        groupEnabled: false,     // 群组私信
        groupChannels: []        // 群组私信频道白名单
      }
    }
  }
}

私信默认合并到主会话（agent:main:main）；原生斜杠命令使用隔离的会话键。

通过 guilds 按服务器 ID（推荐）或 slug 配置规则。每个服务器可独立设置允许列表、提及要求和频道过滤。

{
  channels: {
    discord: {
      groupPolicy: "allowlist",
      guilds: {
        "123456789012345678": {
          requireMention: true,
          users: ["987654321"],
          channels: {
            general: { allow: true },
            help: {
              allow: true,
              requireMention: true,
              users: ["987654321"],
              skills: ["search", "docs"],
              systemPrompt: "回复简洁。"
            }
          }
        },
        "*": { requireMention: true }
      }
    }
  }
}

• 配置了 channels 时，未列出的频道默认被拒绝
• 用 "*" 频道条目设置所有频道的默认值
• 话题继承父频道配置，也可单独覆盖
• 频道会话键格式：agent:<id>:discord:channel:<channelId>

Discord 渠道提供丰富的工具操作，每个都可通过 actions 单独开关：

Discord 支持在私信中通过按钮 UI 审批工具执行请求：

{
  channels: {
    discord: {
      execApprovals: {
        enabled: true,
        approvers: ["YOUR_USER_ID"]
      }
    }
  }
}

审批者会在私信中收到按钮提示：Allow once / Always allow / Deny。

1. Discord 桌面/网页 → 用户设置 → 高级 → 启用开发者模式
2. 右键点击服务器名称 → 复制服务器 ID
3. 右键点击频道 → 复制频道 ID
4. 右键点击用户 → 复制用户 ID