QEdge 简介及脚本开发文档

简介

QEdge 是一个基于 Xposed 框架的 QQ 扩展模块，允许开发者通过编写脚本扩展 QQ 的功能。JS 脚本引擎基于 Rhino（纯 Java 实现，无原生依赖），支持 ES6 语法。

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

开发环境说明

脚本运行于 Rhino JS 引擎环境，支持 ES6 特性。编写时请遵循以下规范：

• 属性访问：直接用点号 . 访问对象属性（如 msgData.msg），无需调用 Getter 方法。

• 方法调用：所有 API 方法均为全局函数，直接裸调用，无需任何前缀（如 qe.）。

• 全局作用域：所有 API 方法在脚本任意位置均可直接调用。

• 日志输出：请使用 console.log(...) 输出日志（log 名称保留给用户变量使用）；console.error(...) 用于错误日志。

• 语法支持：支持 ES6 语法，包括箭头函数、模板字符串、let/const 等。

• 线程模型：事件回调默认在 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)

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

回调定义：

function 回调方法名(聊天类型, peerUin, 名称) {
    // 处理逻辑
}

消息菜单 (长按消息)

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

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

回调定义：

function 回调方法名(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处理

随机数

插件信息

示例脚本

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

// 使用 importClass + runOnUiThread 弹出 Android 原声对话框
importClass("android.app.AlertDialog");
runOnUiThread(function() {
    new AlertDialog.Builder(getNowActivity())
        .setTitle("标题")
        .setMessage("来自 JS 插件的弹窗")
        .setPositiveButton("确定", null)
        .show();
});

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

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

function onMsg(msgData) {
    var msg = msgData.msg;
    var peerUin = msgData.peerUin;
    var type = msgData.type;

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

    if (msg.indexOf("ping") >= 0) {
        sendMsg(peerUin, "pong", type);
    }
}

// loadJs 使用绝对路径加载其他脚本
// loadJs(pluginPath + "/lib/utils.js");

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