核心功能
Discord OpenAPI Skill 是一套基于 UXC 框架的 Discord REST API 调用方案，通过标准化的 OpenAPI 规范实现 Discord 平台的程序化操作。该技能支持两种认证模式：Bot Token（推荐） 提供完整的 API 访问权限，包括读取频道消息、发送消息、管理服务器、执行管理操作等；OAuth2 用户认证 仅限读取用户档案信息，无法执行消息相关操作。
显著优点
1. 标准化接口：直接复用 Discord 官方 OpenAPI 规范，接口定义权威可靠
2. 双模式认证灵活适配：Bot Token 满足自动化运营需求，OAuth2 支持用户画像场景
3. 与 UXC 生态深度整合：复用 UXC 的统一执行、认证和错误处理机制
4. 细粒度权限控制：通过 OAuth Scope 精确限定访问范围，最小权限原则友好
5. Agent 友好的双阶段 OAuth 流程：支持非交互式环境下的授权完成
潜在局限
- OAuth2 用户认证存在严重功能限制：无法通过 HTTP API 读取频道消息、无法发送消息、无法管理服务器，仅适用于用户资料读取场景
- 需依赖 UXC 工具链，增加了一层抽象复杂度
- Bot Token 需妥善保管，泄露风险较高
- 部分高级功能（如消息读取）在 OAuth2 模式下仅能通过本地 RPC 实现，HTTP API 不可用
适合人群
- Discord 服务器管理员：需要自动化管理频道、角色、成员
- 开发者：构建 Discord 机器人、消息监控、自动化通知系统
- 数据分析场景：需要批量导出服务器结构、用户分布信息
- 用户画像集成：需要读取 Discord 用户资料作为身份验证或社交图谱
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| Token 泄露 | Bot Token 拥有较高权限，泄露可导致服务器被恶意控制 | 使用环境变量或密钥管理服务，定期轮换 |
| 误操作风险 | write 操作（发消息、删频道、踢成员）不可逆 | 技能内置 Guardrail：关键操作需显式确认 |
| Scope 过度授权 | OAuth2 申请过多 Scope 扩大攻击面 | 遵循最小权限，优先使用 "Minimal Read-Only Scopes" |
| API 限流 | Discord API 有严格速率限制 | 合理设计调用频率，实现退避重试机制 |
使用建议
绝大多数场景应首选 Bot Token，仅在明确需要"以用户身份读取自身资料"时才考虑 OAuth2。开发测试阶段建议先用 get:/gateway 和 get:/users/@me 验证连通性与认证配置，再逐步启用写操作。