---
slug: "discord-community-hub"
name: "discord-community-hub"
version: 1.0.1
displayName: "Discord社区中心专业版"
summary: "企业级 Discord 社区管理,支持应用命令、权益管理、角色连接与用户资料修改。。面向企业运营与社区管理团队的 Discord 社区全功能管理工具。核心能力: - 应用命令权限管理与批量权"
summary_zh: "企业级 Discord 社区管理,支持应用命令、权益管理、角色连接与用户资料修改。。面向企业运营与社区管理团队的 Discord 社区全功能管理工具。核心能力: - 应用命令权限管理与批量权"
license: "MIT"
edition: "pro"
description: |-
  面向企业运营与社区管理团队的 Discord 社区全功能管理工具。核心能力:
  - 应用命令权限管理与批量权限配置
  - 权益(Entitlement)与订阅管理
  - 角色连接元数据读写与外部系统对接
  - 用户资料修改、服务器离开与高级身份管理
  - 多服务器批量运营与审计日志

  适用场景:
  - 企业 Discord 社区的应用命令权限治理
  - 付费订阅与权益发放管理
  - 外部系统(游戏/论坛)与 Discord 角色对接

  差异化: Pro 版在免费版只读基础上解锁应用命令、权益、角色连接与用户修改等写操作;与免...
tags:
  - Discord
  - 企业管理
  - Communication
  - 应用命令
  - 权益管理
  - 社交
  - 通信
  - await
  - integration
  - call_tool
  - parameters
tools:
  - read
  - exec
  - write
homepage: ""
category: "Communication"
---
# Discord社区中心专业版

## 付费版专享能力

| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| Discord社区中心专业版社区管理 | 不支持 | 支持 |
| Discord社区中心专业版权益管理 | 不支持 | 支持 |
| 多渠道消息批量发送 | 不支持 | 支持 |
| 消息模板与变量注入 | 不支持 | 支持 |
| 送达状态实时回调 | 不支持 | 支持 |

## 核心能力

| 能力模块 | 说明 | 免费版 | Pro 版 |
|:-----|:-----|:-----|:-----|
| 用户/身份 | 资料查询 | 只读 | 只读+修改 |
| 服务器/组件 | 服务器与 widget | 只读 | 只读+离开 |
| 应用命令 | 权限管理 | 不支持 | 支持(单条+批量) |
| 权益/订阅 | Entitlement 管理 | 不支持 | 支持 |
| 角色连接 | 元数据读写 | 不支持 | 支持 |
| 网关/工具 | 网关与工具 | 支持 | 支持 |
| 用户修改 | 用户名/头像 | 不支持 | 支持 |
| 多服务器运营 | 批量管理 | 不支持 | 支持 |
| 审计日志 | 操作记录 | 不支持 | 支持 |
### 能力模块

针对能力模块,自动解析输入参数、调度任务队列、格式化输出,返回结构化响应.
**输入**: 用户提供能力模块相关的配置参数、输入数据和处理选项.
**输出**: 返回能力模块的处理结果。- 验证返回数据的完整性和格式正确性
- 参考`能力模块`的配置文档进行参数调优
### 用户/身份

针对用户/身份,自动解析输入参数、调度任务队列、格式化输出,返回结构化响应.
**输入**: 用户提供用户/身份相关的配置参数、输入数据和处理选项.
**输出**: 返回用户/身份的处理结果。- 验证返回数据的完整性和格式正确性
- 参考`用户/身份`的配置文档进行参数调优
### 服务器/组件

针对服务器/组件,自动解析输入参数、调度任务队列、格式化输出,返回结构化响应.
**输入**: 用户提供服务器/组件相关的配置参数、输入数据和处理选项.
**输出**: 返回服务器/组件的处理结果。- 验证返回数据的完整性和格式正确性
- 参考`服务器/组件`的配置文档进行参数调优
#
## 快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。

## 适用场景

### 场景一:应用命令权限治理

企业社区注册了多个斜杠命令(slash command),需要按服务器维度批量配置各命令的可用角色范围.
```javascript
// 1. 获取某命令在服务器的当前权限
const perm = await integration.call_tool({
  tool: "discord_get_application_command_permissions",
  parameters: {
    application_id: "987654321",
    guild_id: "123456789",
    command_id: "111111"
  }
});
// ...
// 2. 批量获取所有命令的权限
const allPerms = await integration.call_tool({
  tool: "discord_get_batch_application_command_permissions",
  parameters: {
    application_id: "987654321",
    guild_id: "123456789"
  }
});
// ...
// 3. 编辑某命令的权限(需 MANAGE_GUILD)
await integration.call_tool({
  tool: "discord_edit_application_command_permissions",
  parameters: {
    application_id: "987654321",
    guild_id: "123456789",
    command_id: "111111",
    permissions: [
      { id: "222", type: 1, permission: true }  // 角色可使用
    ]
  }
});
```

### 场景二:付费订阅与权益发放

付费应用需要查询用户权益、列出订阅记录并消费消耗型权益.
```javascript
// 1. 查询用户在某应用下的权益
const entitlements = await integration.call_tool({
  tool: "discord_get_current_user_application_entitlements",
  parameters: { application_id: "987654321" }
});
// ...
// 2. 列出某 SKU 的所有订阅
const subs = await integration.call_tool({
  tool: "discord_list_sku_subscriptions",
  parameters: { sku_id: "123456789" }
});
// ...
// 3. 获取特定订阅详情
const sub = await integration.call_tool({
  tool: "discord_get_sku_subscription",
  parameters: {
    sku_id: "123456789",
    subscription_id: "sub_abc123"
  }
});
// ...
// 4. 消费消耗型权益(用户已使用该权益)
await integration.call_tool({
  tool: "discord_consume_entitlement",
  parameters: { entitlement_id: "ent_xyz" }
});
// ...
// 5. 清理测试权益
await integration.call_tool({
  tool: "discord_delete_test_entitlement",
  parameters: { entitlement_id: "ent_test_001" }
});
```

### 场景三:外部系统与 Discord 角色对接

游戏平台或论坛需将用户的外部身份(如游戏 ID)同步到 Discord 角色连接元数据.
```javascript
// 1. 获取用户当前角色连接
const roleConn = await integration.call_tool({
  tool: "discord_get_user_application_role_connection",
  parameters: { application_id: "987654321" }
});
// ...
// 2. 更新角色连接(写入游戏标签等元数据)
await integration.call_tool({
  tool: "discord_update_user_application_role_connection",
  parameters: {
    application_id: "987654321",
    metadata: {
      platform_name: "Xbox",
      platform_username: "PlayerOne",
      custom_fields: [
        { name: "等级", value: "42" },
        { name: "段位", value: "钻石" }
      ]
    }
  }
});
// ...
// 3. 清除角色连接(用户解绑)
await integration.call_tool({
  tool: "discord_delete_user_application_role_connection",
  parameters: { application_id: "987654321" }
});
```

## 使用流程

### 优秀步:升级授权 scope

Pro 版写操作需更完整的 OAuth2 scope。重新连接 Discord 时确保授予:

- `identify` `guilds` `email`(基础)
- `applications.commands`(命令权限)
- `role_connections.write`(角色连接写入)
- `applications.entitlements`(权益查询)

### 第二步:验证权限

```javascript
// 确认当前授权
const auth = await integration.call_tool({
  tool: "discord_get_my_oauth2_authorization",
  parameters: {}
});
// ...
// 确认目标服务器管理权限
const member = await integration.call_tool({
  tool: "discord_get_my_guild_member",
  parameters: { guild_id: "123456789" }
});
```

编辑命令权限需用户在目标服务器具备 `MANAGE_GUILD` 和 `MANAGE_ROLES` 权限.
### 第三步:执行写操作

```javascript
// 修改当前用户名(每小时限 2 次)
await integration.call_tool({
  tool: "discord_modify_current_user",
  parameters: {
    username: "new_display_name",
    avatar: "data:image/png;base64,..."
  }
});
```

**结果验证**: 任务完成后,查看输出确认状态。成功时返回摘要和数据;失败时根据错误信息排查,参考恢复章节获取修复步骤.
## 输入格式

| 参数名 | 类型 | 必填 | 说明 |
|---:|---:|---:|---:|
| content | string | 否 | discord-community-hub处理的内容输入 |, 默认: 全部维度 |
| strict_level | string | 否 | 审查严格度, 可选: strict/normal/loose, 默认: normal |

## 输出格式

```json
{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}
```

## 异常处理

| 错误场景 | 原因 | 处理方式 |
|:---:|:---:|:---:|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 

## 依赖说明

### 运行环境

- **Agent 平台**: 支持解析 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
- **操作系统**: Windows / macOS / Linux(推荐 Linux 用于生产环境)
- **网络**: 需稳定访问 Discord API 与集成网关
- **浏览器**: OAuth 授权流程需在浏览器中完成

### 依赖说明(补充)

| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:------|------:|:------|:------|
| LLM 能力 | API | 必需 | 由 Agent 内置大模型提供 |
| 集成网关插件 | 插件 | 必需 | Agent 平台插件市场安装 |
| Discord OAuth2 | 授权 | 必需 | Discord Developer Portal 注册应用 |
| Discord API | 服务 | 必需 | Discord 平台提供 |
| 浏览器 | 运行时 | 必需 | 用于 OAuth 授权流程 |
| 外部系统 | 集成 | 可选 | 游戏平台/论坛等角色对接源 |

### API Key 配置

- **OAuth2 应用**: 在 Discord Developer Portal 注册 OAuth2 应用,获取 Client ID 和 Client Secret.
- **完整授权 scope**: Pro 版需更完整的 scope:`identify` `guilds` `email` `applications.commands` `role_connections.write` `applications.entitlements`。重新连接时务必补全.
- **Bearer 令牌**: 写操作(命令权限、权益、角色连接)必须使用 OAuth2 Bearer 令牌,非机器人令牌。集成网关自动管理令牌刷新.
- **审计存储**: 审计日志建议配置独立存储路径,加密存储,设置保留策略(建议 90 天以上).
### 可用性分类

- **分类**: MD+EXEC(纯 Markdown 指令 + 部分功能需 `exec` 执行能力)
- **说明**: 以自然语言指令驱动 Agent 通过集成网关调用 Discord 工具完成社区管理与写操作
- **适用规模**: 企业级,多服务器批量运营,支持应用生态与付费体系管理
- **兼容性**: 与 `discord-community-hub-free` 工具格式完全兼容,可平滑升级
- **支持级别**: 优先支持(Pro 版享有问题优先响应与功能迭代建议通道)

**API Key配置方式**:
```bash
export API_KEY="your_api_key_here"
```
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
## 案例展示

### 应用命令权限完整配置

```javascript
// 批量配置多个命令的权限
const commands = ["cmd_001", "cmd_002", "cmd_003"];
// ...
for (const cmdId of commands) {
  await integration.call_tool({
    tool: "discord_edit_application_command_permissions",
    parameters: {
      application_id: "987654321",
      guild_id: "123456789",
      command_id: cmdId,
      permissions: [
        { id: "role_admin", type: 1, permission: true },
        { id: "role_member", type: 1, permission: false }
      ]
    }
  });
}
```

### 权益管理流程

```javascript
// 完整的权益发放与消费流程
// ...
// 1. 查询用户是否有有效订阅
const entitlements = await integration.call_tool({
  tool: "discord_get_current_user_application_entitlements",
  parameters: { application_id: "987654321" }
});
// ...
const activeEnt = entitlements.find(e =>
  e.type === "subscription" && !e.consumed
);
// ...
// 2. 用户使用后消费权益
if (activeEnt) {
  await integration.call_tool({
    tool: "discord_consume_entitlement",
    parameters: { entitlement_id: activeEnt.id }
  });
}
```

### 角色连接批量同步

```javascript
// 从外部系统批量同步用户角色连接
const externalUsers = [
  { discord_id: "111", gamer_tag: "Alpha", level: 50 },
  { discord_id: "222", gamer_tag: "Beta", level: 30 }
];
// ...
for (const u of externalUsers) {
  await integration.call_tool({
    tool: "discord_update_user_application_role_connection",
    parameters: {
      application_id: "987654321",
      metadata: {
        platform_name: "Xbox",
        platform_username: u.gamer_tag,
        custom_fields: [
          { name: "等级", value: String(u.level) }
        ]
      }
    }
  });
}
```

### 服务器离开管理

```javascript
// 离开指定服务器(高影响操作)
await integration.call_tool({
  tool: "discord_leave_guild",
  parameters: { guild_id: "123456789" }
});
```

## 常见问题

### Q1: 编辑命令权限报「Missing MANAGE_GUILD permission」?

编辑应用命令权限需要当前用户在目标服务器具备 `MANAGE_GUILD` 和 `MANAGE_ROLES` 权限,且使用 OAuth2 Bearer 令牌(机器人令牌会报错)。请确认:用户是服务器管理员或有管理权限的角色;集成网关使用 Bearer 令牌;OAuth2 授权包含 `applications.commands` scope.
### Q2: 「Role connection write scope missing」是什么原因?

角色连接写入需要 OAuth2 授权包含 `role_connections.write` scope。若当前授权缺失,需重新连接 Discord 并补全该 scope。重新授权后即可正常调用 `discord_update_user_application_role_connection`.
### Q3: 权益查询返回为空?

确认:查询的 `application_id` 正确;用户确实有该应用的付费订阅;OAuth2 授权包含 `applications.entitlements` scope。测试权益需通过 `discord_delete_test_entitlement` 单独管理,不在正式权益列表中返回.
### 错误恢复步骤
| 错误场景(续)| 原因 | 处理方式 |
|----:|:----|----:|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | ，请求；确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |

## 已知限制

`custom_fields` 是应用在 Discord Developer Portal 中预先定义的元数据字段。字段 `name` 必须与预定义一致,`value` 为字符串。未预定义的字段会被忽略。最多支持 8 个自定义字段.
### Q5: `discord_delete_test_entitlement` 和 `discord_consume_entitlement` 有什么区别?

`consume_entitlement` 用于标记消耗型权益(如一次性道具)为已使用,正式权益不会被删除,只是状态变更;`delete_test_entitlement` 用于删除测试环境产生的测试权益,是物理删除,仅对测试权益有效,不影响正式权益.
### Q6: 多服务器批量运营如何管理?

Pro 版支持遍历服务器列表批量执行操作。建议:按操作类型分组批量执行;配置频率限制避免触发 API 限流;记录每个服务器的执行结果汇总;失败项单独重试。大规模批量操作建议在低峰时段执行.
### Q7: 审计日志记录哪些内容?

审计日志记录:操作时间、操作人、工具名称、目标(application_id/guild_id/user_id)、参数摘要、结果(成功/失败)、错误信息。高影响操作(leave_guild、delete_test_entitlement、delete_role_connection)额外记录操作前状态快照。日志建议加密存储,保留 90 天以上.
### Q8: Pro 版能管理机器人的应用命令吗?

可以。通过 `application_id`(机器人的应用 ID)管理其在各服务器的命令权限。但需注意:编辑命令权限使用的是用户的 OAuth2 Bearer 令牌(需用户有管理权限),而非机器人令牌。这是设计上的权限分离.
## 错误处理

| 错误场景(续)(续)| 原因 | 处理方式 |
|:------------:|--------------|:-------------|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | 检查网络连接，重试请求；确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |

## 补充限制说明

- 需要LLM支持
- 消息发送依赖第三方平台的API可用性
- 免费版有消息发送频率限制