Discord 社区中心(免费版)

概述

Discord 社区中心免费版是一款面向个人社区管理者的 Discord 社区基础管理工具。它通过集成网关连接 Discord 账号,提供当前用户资料查询、已加入服务器列表、服务器成员与角色信息、服务器小组件(widget)与邀请详情等只读查询能力,以及基础集成连接与工具发现功能。

免费版聚焦安全低风险的只读操作,适合个人 Discord 社区的日常信息查询和小型服务器的概览管理。所有写操作(如离开服务器、修改用户信息、编辑命令权限)在免费版中不可用,如需这些能力请升级至 Pro 版。

核心能力

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 按照skill规范执行核心功能执行操作,遵循单一意图原则。 输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 按照skill规范执行参数配置与调用操作,遵循单一意图原则。 输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输入: 用户提供结果处理与输出所需的指令和必要参数。 处理: 按照skill规范执行结果处理与输出操作,遵循单一意图原则。 输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：社区管理工具、支持用户信息、服务器列表与基础、集成查询、面向个人社区管理、社区基础管理工具、核心能力、查询当前用户资料、与已加入服务器列、获取服务器成员信、息与角色概况、查询服务器小组件、基础集成连接与工等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一:查询个人 Discord 账号概况

想快速了解自己 Discord 账号的基本信息和已加入的服务器。

// 1. 获取当前用户资料
const me = await integration.call_tool({
  tool: "discord_get_my_user",
  parameters: {}
});

// 2. 列出已加入的服务器
const guilds = await integration.call_tool({
  tool: "discord_list_my_guilds",
  parameters: {}
});

// 3. 获取自己在某服务器的成员信息
const member = await integration.call_tool({
  tool: "discord_get_my_guild_member",
  parameters: { guild_id: "123456789" }
});

返回结果包含用户名、ID、头像、已加入服务器列表及各服务器的成员角色、昵称、加入时间等。

场景二:服务器概览与邀请解析

新建社区后,想确认服务器组件状态并解析分享出去的邀请链接。

// 1. 获取服务器 widget(JSON 格式)
const widget = await integration.call_tool({
  tool: "discord_get_guild_widget",
  parameters: { guild_id: "123456789" }
});

// 2. 获取 widget 图片(PNG)
const widgetPng = await integration.call_tool({
  tool: "discord_get_guild_widget_png",
  parameters: { guild_id: "123456789" }
});

// 3. 解析邀请码详情
const invite = await integration.call_tool({
  tool: "discord_invite_resolve",
  parameters: { invite_code: "abc123xyz" }
});

场景三:集成工具发现

连接 Discord 后,想了解可用的工具集。

// 1. 确认 Discord 已连接
const integrations = await integration.list_integrations();

// 2. 列出 Discord 可用工具
const tools = await integration.list_tools({ integration: "discord" });

// 3. 搜索特定功能工具
const found = await integration.search_tools({
  query: "guild",
  integration: "discord"
});

不适用场景

以下场景Discord社区中心免费版不适合处理：

• 逆向工程闭源API
• API安全渗透测试
• 非标准协议集成

触发条件

需要API集成、接口对接、Webhook配置、系统连接时使用。不适用于非本工具能力范围的需求。

快速开始

依赖详情

在 Agent 平台安装集成网关插件:

platform plugins install integration-gateway

安装后开启新的对话会话以加载插件目录。

第二步:配对集成网关

// 1. 发起配对
const pairing = await integration.begin_pairing();

// 2. 在浏览器中打开返回的 URL
// 3. 登录集成网关并批准设备

第三步:连接 Discord 账号

在集成网关控制台中,打开 Discord 连接页面,完成 OAuth 授权流程,确认连接成功。

第四步:验证连接

// 验证 Discord 已连接
const connected = await integration.list_integrations();

// 列出可用工具
const tools = await integration.list_tools({ integration: "discord" });

示例

用户资料查询

// 获取当前用户完整资料
await integration.call_tool({
  tool: "discord_get_my_user",
  parameters: {}
});

// 获取 OAuth2 授权详情(含 scope 与过期时间)
await integration.call_tool({
  tool: "discord_get_my_oauth2_authorization",
  parameters: {}
});

// 获取 OIDC 用户信息(符合 OpenID Connect)
await integration.call_tool({
  tool: "discord_get_openid_connect_userinfo",
  parameters: {}
});

服务器信息查询

// 获取任意用户信息(传 '@me' 表示当前用户)
await integration.call_tool({
  tool: "discord_get_user",
  parameters: { user_id: "@me" }
});

// 列出已连接的第三方账号
await integration.call_tool({
  tool: "discord_list_my_connections",
  parameters: {}
});

// 获取服务器模板详情
await integration.call_tool({
  tool: "discord_get_guild_template",
  parameters: { template_code: "abc123" }
});

网关与工具

// 获取 WebSocket 网关 URL
await integration.call_tool({
  tool: "discord_get_gateway",
  parameters: {}
});

// 获取 OAuth2 公钥(用于外部 JWT 验证)
await integration.call_tool({
  tool: "discord_get_public_keys",
  parameters: {}
});

// 列出 Nitro 贴纸包
await integration.call_tool({
  tool: "discord_list_sticker_packs",
  parameters: {}
});

最佳实践

1. 优先只读操作: 免费版聚焦只读查询,安全无风险。在进行任何管理操作前,先用只读工具确认当前状态(如先查成员信息再考虑角色调整)。

2. Widget 需服务器开启: 获取服务器 widget 前需在服务器设置 → Widget 中开启「启用服务器组件」。未开启时调用会返回错误。

3. 邀请码及时解析: 分享邀请链接前用 discord_invite_resolve 解析确认有效期和目标服务器,避免邀请过期或指向错误服务器。

4. 集成工具检索技巧: 使用 search_tools 按功能关键词搜索(如 "guild"、"member"、"role"),快速定位所需工具,避免在长列表中手动翻找。

5. OAuth scope 确认: 连接 Discord 时注意授权范围(scope)。基础查询只需 identify + guilds;如需邮箱需 email scope。scope 不足会导致部分工具报错,可重新连接补全。

6. 凭证安全: 集成网关仅存储 OAuth 令牌,不存储原始机器人令牌。设备凭证保存在本地插件配置中。切勿在代码或配置中硬编码任何令牌。

7. 区分令牌类型: 机器人令牌(Bot Token)与 OAuth2 Bearer 令牌能力不同。部分工具(如编辑命令权限)需要 Bearer 令牌,使用机器人令牌会报错。按工具要求使用对应令牌类型。

常见问题

Q1: 安装插件后工具不显示怎么办?

安装集成网关插件后,需开启新的对话会话以重新加载插件目录。若仍不显示,调用 list_integrations 确认集成网关已配对成功,再调用 list_tools 检查 Discord 工具是否注册。

Q2: 获取 widget 报错「Guild widget disabled」?

服务器组件需在 Discord 服务器设置 → Widget 中手动开启「启用服务器组件」。未开启时调用 discord_get_guild_widget 会返回错误。请服务器管理员开启后重试。

Q3: 「401 Unauthorized」错误是什么原因?

通常是令牌类型不匹配。查询类操作使用 OAuth2 Bearer 令牌;若误用机器人令牌会返回 401。请确认集成网关使用的是 OAuth2 授权流程获取的 Bearer 令牌,并在连接时授予了足够 scope。

Q4: 免费版能修改用户名或头像吗?

不能。修改用户资料(discord_modify_current_user)属于写操作,免费版不提供。如需修改用户名(每小时限 2 次)或头像,请升级至 Pro 版。免费版仅支持只读查询。

Q5: 「Username change limit reached」是什么?

Discord 限制用户名每小时最多修改 2 次。频繁修改会触发此限制,需等待后再试。这是 Discord 平台限制,与工具版本无关。

Q6: 如何确认连接的 scope 是否足够?

调用 discord_get_my_oauth2_authorization 可查看当前授权的 scope 列表和令牌过期时间。若某工具报权限不足,对比工具要求的 scope 与当前已授权 scope,缺失的需重新连接 Discord 补全授权。

Q7: 集成网关存储哪些凭证?

集成网关仅存储 OAuth 令牌(用于访问 Discord API),不存储原始机器人令牌或密码。设备凭证保存在本地 Agent 插件配置中。discord_get_public_keys 用于验证外部 JWT,不用于存储密钥。

依赖说明

运行环境

• Agent 平台: 支持解析 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
• 操作系统: Windows / macOS / Linux
• 网络: 需可访问 Discord API 与集成网关
• 浏览器: OAuth 授权流程需在浏览器中完成

第三方依赖

API Key 配置

• OAuth2 应用: 在 Discord Developer Portal 注册 OAuth2 应用,获取 Client ID 和 Client Secret。
• 授权 scope: 基础查询需 identify + guilds scope;获取邮箱需 email scope;OIDC 需 openid scope。按需配置。
• 集成网关配对: 通过集成网关完成设备配对,凭证保存在本地插件配置中,无需手动管理令牌。
• 其他 API Key: 免费版不依赖额外 API Key。

可用性分类

• 分类: MD+EXEC(纯 Markdown 指令 + 部分功能需 exec 执行能力)
• 说明: 以自然语言指令驱动 Agent 通过集成网关调用 Discord 工具完成社区查询
• 适用规模: 个人/小团队,只读查询为主,无写操作风险
• 升级建议: 如需应用命令管理、权益管理、角色连接、用户修改等写操作,请升级至 discord-community-hub-pro

错误处理

已知限制

• 需LLM支持,无LLM环境不可用
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响