@onebots/adapter-discord 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 凉菜
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,202 @@
+# @onebots/adapter-discord
+
+onebots Discord 适配器 - 轻量版实现，直接封装 Discord API，无外部依赖。
+
+## 特性
+
+- ✅ **轻量级**：不依赖 discord.js，包体积小
+- ✅ **多运行时**：支持 Node.js、Cloudflare Workers、Vercel Edge
+- ✅ **原生 fetch**：使用原生 API，兼容性好
+- ✅ **代理支持**：使用 https-proxy-agent（可选）
+
+## 安装
+
+```bash
+npm install @onebots/adapter-discord
+
+# Node.js Gateway 模式需要 ws
+npm install ws
+
+# 需要代理时
+npm install https-proxy-agent
+```
+
+## 配置
+
+在 onebots 配置文件中添加 Discord 账号配置：
+
+```yaml
+discord.your_bot_id:
+  token: 'your_discord_bot_token'  # Discord Bot Token，必填
+  
+  # 代理配置（可选）
+  proxy:
+    url: "http://127.0.0.1:7890"
+    # username: "user"  # 可选
+    # password: "pass"  # 可选
+  
+  intents:  # 可选，Gateway Intents
+    - Guilds
+    - GuildMessages
+    - GuildMembers
+    - GuildMessageReactions
+    - DirectMessages
+    - DirectMessageReactions
+    - MessageContent
+  presence:  # 可选，机器人状态
+    status: online  # online, idle, dnd, invisible
+    activities:
+      - name: '正在运行 onebots'
+        type: 0  # 0: Playing, 1: Streaming, 2: Listening, 3: Watching, 5: Competing
+```
+
+## 独立使用（不依赖 onebots）
+
+### Node.js Gateway 模式
+
+```typescript
+import { DiscordLite, GatewayIntents } from '@onebots/adapter-discord/lite';
+
+const client = new DiscordLite({
+    token: process.env.DISCORD_TOKEN,
+    intents: GatewayIntents.Guilds | GatewayIntents.GuildMessages | GatewayIntents.MessageContent,
+    mode: 'gateway',
+    proxy: { url: 'http://127.0.0.1:7890' },  // 可选
+});
+
+client.on('ready', (user) => {
+    console.log(`已登录为 ${user.username}`);
+});
+
+client.on('messageCreate', async (message) => {
+    if (message.content === '!ping') {
+        await client.sendMessage(message.channel_id, 'Pong!');
+    }
+});
+
+await client.start();
+```
+
+### Cloudflare Workers 模式
+
+```typescript
+import { InteractionsHandler } from '@onebots/adapter-discord/lite';
+
+export default {
+    async fetch(request: Request, env: Env): Promise<Response> {
+        const handler = new InteractionsHandler({
+            publicKey: env.DISCORD_PUBLIC_KEY,
+            token: env.DISCORD_TOKEN,
+            applicationId: env.DISCORD_APP_ID,
+        });
+
+        handler.onCommand('ping', async () => {
+            return InteractionsHandler.messageResponse('🏓 Pong!');
+        });
+
+        return handler.handleRequest(request);
+    },
+};
+```
+
+### 直接使用 REST API
+
+```typescript
+import { DiscordREST } from '@onebots/adapter-discord/lite';
+
+const rest = new DiscordREST({ token: process.env.DISCORD_TOKEN });
+
+// 发送消息
+await rest.createMessage('channel_id', 'Hello!');
+
+// 获取用户
+const user = await rest.getUser('user_id');
+```
+
+## 获取 Discord Bot Token
+
+1. 前往 [Discord Developer Portal](https://discord.com/developers/applications)
+2. 点击 "New Application" 创建新应用
+3. 进入应用后，点击左侧 "Bot" 菜单
+4. 点击 "Reset Token" 获取 Bot Token
+5. 在 "Privileged Gateway Intents" 中启用需要的 Intents
+
+## 支持的 API
+
+### 消息相关
+- ✅ sendMessage - 发送消息
+- ✅ deleteMessage - 删除消息
+- ✅ getMessage - 获取消息
+- ✅ getMessageHistory - 获取历史消息
+
+### 用户相关
+- ✅ getLoginInfo - 获取机器人信息
+- ✅ getUserInfo - 获取用户信息
+
+### 群组（服务器）相关
+- ✅ getGroupList - 获取服务器列表
+- ✅ getGroupInfo - 获取服务器信息
+- ✅ leaveGroup - 退出服务器
+- ✅ getGroupMemberList - 获取成员列表
+- ✅ getGroupMemberInfo - 获取成员信息
+- ✅ kickGroupMember - 踢出成员
+- ✅ muteGroupMember - 禁言成员
+- ✅ setGroupCard - 设置昵称
+
+### 频道相关
+- ✅ getChannelInfo - 获取频道信息
+- ✅ getChannelList - 获取频道列表
+- ✅ createChannel - 创建频道
+- ✅ deleteChannel - 删除频道
+- ✅ updateChannel - 更新频道
+
+## 依赖说明
+
+本适配器采用轻量级设计，核心功能无需外部依赖。以下为可选依赖：
+
+| 依赖 | 何时需要 | 安装命令 |
+|------|----------|----------|
+| `ws` | Node.js Gateway 模式 | `npm install ws` |
+| `https-proxy-agent` | 使用 HTTP/HTTPS 代理（REST API） | `npm install https-proxy-agent` |
+| `socks-proxy-agent` | 使用 SOCKS5 代理（WebSocket 推荐） | `npm install socks-proxy-agent` |
+
+### 常见问题
+
+#### 1. 连接超时 / ECONNRESET
+
+如果你在中国大陆等需要代理的地区，请配置代理：
+
+```yaml
+discord.your_bot:
+  token: 'xxx'
+  proxy:
+    url: "http://127.0.0.1:7890"  # 你的代理地址
+```
+
+并安装代理依赖：
+
+```bash
+# 推荐同时安装（WebSocket 使用 SOCKS5 更稳定）
+npm install https-proxy-agent socks-proxy-agent
+```
+
+#### 2. 缺少 ws 模块
+
+如果看到 `Cannot find module 'ws'` 错误：
+
+```bash
+npm install ws
+```
+
+> **注意**：Cloudflare Workers 模式（Interactions）不需要 `ws`
+
+#### 3. WebSocket 连接失败但 REST API 正常
+
+某些代理软件（如 Clash）的 HTTP 代理模式对 WebSocket 支持不佳。适配器会自动将 HTTP 代理转换为 SOCKS5，但需要：
+
+1. 确保代理软件开启了混合端口（同时支持 HTTP 和 SOCKS5）
+2. 安装 `socks-proxy-agent`：`npm install socks-proxy-agent`
+
+## 许可证
+
+MIT

package/lib/adapter.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Discord 适配器
+ * 轻量版实现，直接封装 Discord API
+ */
+import { Account } from "onebots";
+import { Adapter } from "onebots";
+import { BaseApp } from "onebots";
+import { DiscordBot } from "./bot.js";
+import type { DiscordConfig } from "./types.js";
+export declare class DiscordAdapter extends Adapter<DiscordBot, "discord"> {
+    constructor(app: BaseApp);
+    /**
+     * 发送消息
+     * 支持私聊(DM)、群组(Guild)和频道(Channel)消息
+     */
+    sendMessage(uin: string, params: Adapter.SendMessageParams): Promise<Adapter.SendMessageResult>;
+    /**
+     * 删除/撤回消息
+     */
+    deleteMessage(uin: string, params: Adapter.DeleteMessageParams): Promise<void>;
+    /**
+     * 获取消息
+     */
+    getMessage(uin: string, params: Adapter.GetMessageParams): Promise<Adapter.MessageInfo>;
+    /**
+     * 获取历史消息
+     */
+    getMessageHistory(uin: string, params: Adapter.GetMessageHistoryParams): Promise<Adapter.MessageInfo[]>;
+    /**
+     * 获取机器人信息
+     */
+    getLoginInfo(uin: string): Promise<Adapter.UserInfo>;
+    /**
+     * 获取用户信息
+     */
+    getUserInfo(uin: string, params: Adapter.GetUserInfoParams): Promise<Adapter.UserInfo>;
+    /**
+     * 获取好友列表
+     * Discord 没有传统好友系统，返回空列表
+     */
+    getFriendList(uin: string, params?: Adapter.GetFriendListParams): Promise<Adapter.FriendInfo[]>;
+    /**
+     * 获取好友信息
+     * Discord 没有传统好友系统，返回用户信息
+     */
+    getFriendInfo(uin: string, params: Adapter.GetFriendInfoParams): Promise<Adapter.FriendInfo>;
+    /**
+     * 获取群列表（服务器列表）
+     */
+    getGroupList(uin: string, params?: Adapter.GetGroupListParams): Promise<Adapter.GroupInfo[]>;
+    /**
+     * 获取群信息（服务器信息）
+     */
+    getGroupInfo(uin: string, params: Adapter.GetGroupInfoParams): Promise<Adapter.GroupInfo>;
+    /**
+     * 退出群组（服务器）
+     */
+    leaveGroup(uin: string, params: Adapter.LeaveGroupParams): Promise<void>;
+    /**
+     * 获取群成员列表
+     */
+    getGroupMemberList(uin: string, params: Adapter.GetGroupMemberListParams): Promise<Adapter.GroupMemberInfo[]>;
+    /**
+     * 获取群成员信息
+     */
+    getGroupMemberInfo(uin: string, params: Adapter.GetGroupMemberInfoParams): Promise<Adapter.GroupMemberInfo>;
+    /**
+     * 踢出群成员
+     */
+    kickGroupMember(uin: string, params: Adapter.KickGroupMemberParams): Promise<void>;
+    /**
+     * 群成员禁言（超时）
+     */
+    muteGroupMember(uin: string, params: Adapter.MuteGroupMemberParams): Promise<void>;
+    /**
+     * 设置群名片（昵称）
+     */
+    setGroupCard(uin: string, params: Adapter.SetGroupCardParams): Promise<void>;
+    /**
+     * 发送群消息表情回应
+     */
+    sendGroupMessageReaction(uin: string, params: Adapter.SendGroupMessageReactionParams): Promise<void>;
+    /**
+     * 获取频道服务器信息
+     */
+    getGuildInfo(uin: string, params: Adapter.GetGuildInfoParams): Promise<Adapter.GuildInfo>;
+    /**
+     * 获取频道服务器列表
+     */
+    getGuildList(uin: string): Promise<Adapter.GuildInfo[]>;
+    /**
+     * 获取频道成员信息
+     */
+    getGuildMemberInfo(uin: string, params: Adapter.GetGuildMemberInfoParams): Promise<Adapter.GuildMemberInfo>;
+    /**
+     * 获取频道信息
+     */
+    getChannelInfo(uin: string, params: Adapter.GetChannelInfoParams): Promise<Adapter.ChannelInfo>;
+    /**
+     * 获取频道列表
+     */
+    getChannelList(uin: string, params?: Adapter.GetChannelListParams): Promise<Adapter.ChannelInfo[]>;
+    /**
+     * 创建频道
+     */
+    createChannel(uin: string, params: Adapter.CreateChannelParams): Promise<Adapter.ChannelInfo>;
+    /**
+     * 删除频道
+     */
+    deleteChannel(uin: string, params: Adapter.DeleteChannelParams): Promise<void>;
+    /**
+     * 更新频道
+     */
+    updateChannel(uin: string, params: Adapter.UpdateChannelParams): Promise<void>;
+    /**
+     * 获取频道成员信息
+     */
+    getChannelMemberInfo(uin: string, params: Adapter.GetChannelMemberInfoParams): Promise<Adapter.ChannelMemberInfo>;
+    /**
+     * 获取频道成员列表
+     */
+    getChannelMemberList(uin: string, params: Adapter.GetChannelMemberListParams): Promise<Adapter.ChannelMemberInfo[]>;
+    /**
+     * 踢出频道成员
+     */
+    kickChannelMember(uin: string, params: Adapter.KickChannelMemberParams): Promise<void>;
+    /**
+     * 设置频道成员禁言
+     */
+    setChannelMemberMute(uin: string, params: Adapter.SetChannelMemberMuteParams): Promise<void>;
+    /**
+     * 检查是否可以发送图片
+     */
+    canSendImage(uin: string): Promise<boolean>;
+    /**
+     * 检查是否可以发送语音
+     */
+    canSendRecord(uin: string): Promise<boolean>;
+    /**
+     * 获取版本信息
+     */
+    getVersion(uin: string): Promise<Adapter.VersionInfo>;
+    /**
+     * 获取运行状态
+     */
+    getStatus(uin: string): Promise<Adapter.StatusInfo>;
+    createAccount(config: Account.Config<'discord'>): Account<'discord', DiscordBot>;
+    /**
+     * 构建 Discord 消息内容
+     */
+    private buildDiscordMessage;
+    /**
+     * 转换消息为 MessageInfo
+     */
+    private convertMessageToInfo;
+    /**
+     * 获取成员角色
+     */
+    private getMemberRole;
+}
+declare module "onebots" {
+    namespace Adapter {
+        interface Configs {
+            discord: DiscordConfig;
+        }
+    }
+}
+declare module './adapter.js' {
+    namespace Adapter {
+        interface Configs {
+            discord: DiscordConfig;
+        }
+    }
+}
+//# sourceMappingURL=adapter.d.ts.map