QEdge 简介及脚本开发文档

简介

QEdge 是一个基于 Xposed 框架的 QQ 扩展模块，允许开发者通过编写脚本扩展 QQ 的功能。脚本引擎基于 Modern BeanShell（3.0.0 lambda 分支），支持 Lambda、var 类型推断等现代 Java 语法特性。

脚本目录位于 QQ 数据目录下的 QEdge/plugin 文件夹中。

开发环境说明

脚本运行于 Modern BeanShell 环境（3.0.0 lambda 分支），实现了 Java 8～10 的多数常用语法糖。它是脚本解释器而非完整的 Java 编译器，编写时请遵循以下规范：

• 属性访问：推荐使用成员符 . 直接访问对象属性（如 msgData.msg），无需调用 Getter 方法。
• 方法访问：无需强制类型转换即可自动调用对应签名的方法和字段。
• 全局作用域：所有 API 方法在脚本任意位置均可直接调用，无需传递。
• 语法支持：支持 Lambda 表达式、方法引用、var 类型推断、增强 for、自动装箱及流式 API 等现代语法；暂不支持 switch 表达式、record、模式匹配等 Java 10+ 之后的新特性。
• 线程模型：事件回调默认在 IO 线程执行。操作 UI 需切换至主线程。

脚本必须文件

info.prop 配置项

全局变量

核心数据结构

MsgData (消息对象)

用于 onMsg 回调中。

FriendInfo (好友信息)

GroupInfo (群信息)

MemberInfo (群成员信息)

ForbidInfo (禁言信息)

BlackUser (群黑名单信息)

JointGroup (共同群信息)

消息相关方法

sendMsg - 发送消息

void sendMsg(String peerUin, String msg, int chatType)

发送文本消息。

支持格式： 艾特：[atUin=QQ号]（QQ号为0时表示艾特全体） 图片：[pic=图片链接或绝对路径]

sendPic - 发送图片

void sendPic(String peerUin, String path, int chatType)

sendPtt - 发送语音

void sendPtt(String peerUin, String path, int chatType)

sendCard - 发送卡片

void sendCard(String peerUin, String data, int chatType)

sendFile - 发送文件

void sendFile(String peerUin, String path, int chatType)

sendVideo - 发送视频

void sendVideo(String peerUin, String path, int chatType)

sendBubbleVideo - 发送泡泡消息视频

void sendBubbleVideo(String peerUin, String path, int chatType)

sendPai - 拍一拍

void sendPai(String toUin, String peerUin, int chatType)
void sendPai(String toUin, String peerUin)

recallMsg - 撤回消息

void recallMsg(int chatType, String peerUin, long msgId)

sendMusic - 发送音乐卡片

void sendMusic(String platform, String peerUin, String title, String desc, String jumpUrl, String musicUrl, String imgUrl, int chatType)

快捷消息方法

平台音乐卡片

好友相关方法

getAllFriend - 获取好友列表

List<FriendInfo> getAllFriend()

getJointGroupList - 获取好友共同群列表

List<JointGroup> getJointGroupList()

isFriend - 判断好友

boolean isFriend(String uin)

sendZan - 点赞

void sendZan(String uin, int num)

getCurrentUin - 获取当前QQ号

String getCurrentUin()

getCurrentUid - 获取当前UID

String getCurrentUid()

getCurrentName - 获取当前昵称

String getCurrentName()

群管理方法

getGroupList - 获取群列表

List<GroupInfo> getGroupList()

getGroupInfo - 获取群信息

Object getGroupInfo(String group)

获取指定群的详细信息对象。

getGroupMemberList - 获取群成员列表

List<MemberInfo> getGroupMemberList(String group)

getForbidInfo - 获取禁言列表

List<ForbidInfo> getForbidInfo(String group)

getGroupBlackList - 获取群拉黑名单列表

List<BlackUser> getGroupBlackList(String group)

shutUp - 禁言成员

void shutUp(String group, String uin, long time)

传 0 为解禁。

shutUpAll - 全员禁言

void shutUpAll(String group, boolean enable)

setMemberTitle - 设置群头衔

void setMemberTitle(String group, String uin, String title)

kickGroup - 踢出群成员

void kickGroup(String group, String uin, boolean block)

setGroupAdmin - 设置管理员

void setGroupAdmin(String group, String uin, boolean enable)

clockIn - 群打卡

void clockIn(String group)

changeGroupName - 更换群名

void changeGroupName(String group, String name)

getAbnormalUserList - 获取群内异常用户列表

List<String> getAbnormalUserList(String group)

setGroupLocation - 设置群地点

void setGroupLocation(String group, String location)

setGroupShortcutBar - 设置群快捷栏

void setGroupShortcutBar(String group, String desc, String link, String name, String cover)

Cookie与Token

数据存储

数据保存在 plugin/脚本ID/config/ 下的 JSON 文件中。

写入数据

读取数据

其他操作

回调方法

在脚本中实现以下方法以接收事件。

onMsg - 接收消息

void onMsg(Object msgData)

接收消息时触发，参数为 MsgData 对象。

群变动事件

交互事件

生命周期

void unLoadPlugin()

脚本停止/卸载时触发。

菜单功能

脚本菜单 (悬浮窗)

void addItem(String name, String callback)

添加脚本菜单项目。入口在聊天页面(长按右上角三条杠或者右下角加号)

回调定义：

void 回调方法名(int 聊天类型, String PeerUin, String 名称) {
    // 处理逻辑
}

消息菜单 (长按消息)

void addMenuItem(String name, String callback, int[] msgTypes)

添加消息菜单项目。最后一个参数为空或不写则默认所有消息。

回调定义：

void 回调方法名(Object msgData) {
    // msgData为MsgData对象
}

网络请求

httpGet - GET请求

String httpGet(String url)
String httpGet(String url, int connectTimeout, int readTimeout)

httpPost - POST请求

String httpPost(String url, String body)
String httpPost(String url, String body, String contentType)

downloadFile - 下载文件

boolean downloadFile(String url, String savePath)

反射与Hook

反射方法

Hook方法

callback为Lambda表达式，参数为XC_MethodHook.MethodHookParam，可访问param.thisObject、param.args、param.getResult()等

UIN/UID转换

文件操作

编码解码

其他方法

日志与提示

动态加载

Activity操作

工具方法

自身操作

JSON处理

随机数

插件信息

示例脚本

log("脚本开始运行...");
qqToast(2, "Hello World!");

addItem("测试菜单", "onTestClick");

void onTestClick(int chatType, String peerUin, String peerName) {
    qqToast(2, "点击了菜单");
    sendMsg(peerUin, "你好!", chatType);
}

void onMsg(Object msgData) {
    String msg = msgData.msg;
    String peerUin = msgData.peerUin;
    int type = msgData.type;

    log("收到消息: " + msg);

    if (msg.contains("ping")) {
        sendMsg(peerUin, "pong", type);
    }
}

void unLoadPlugin() {
    qqToast(0, "脚本停止运行");
    log("脚本停止运行");
}