QQBot
U
词库
👥
机器人数量
-
额度 -
📦
已启用插件
-
账号状态
正常
▣ 注册于 -

快速开始

词库编辑器在线编写机器人词库文件

我的机器人

机器人插件配置

配置区这里管理“机器人 ↔ 已安装插件”的启用关系;插件发现和安装在插件市场。

插件市场

发现、筛选并快速启用 QQBot Cloud 官方与精选插件。

0Plugins
插件市场用于发现、安装、购买插件;不负责给某个机器人开关插件。

开发者中心

Developer Console

写插件,上架市场

未申请

使用 3.6 风格脚本式 DSL 在线编写插件。无需 class/interface,保存草稿后提交审核,发布后进入插件市场。

0全部提交
0审核中
0已发布

插件开发文档

1. 插件写法

新平台插件采用 3.6 风格脚本式写法,不需要写 class,不需要继承接口。插件代码就是普通 PHP 脚本。

<?php

if (消息 == "测试文字") {
    文字("这是一条来自测试插件的文字回复。");
    return;
}
2. 常用变量
  • 消息:用户发送的文本,已去掉首尾 / 和空格。
  • 消息来源:当前来源,常见为 群聊私聊
  • 来源:群 openid 或用户 openid。
  • 用户:触发用户 openid。
  • 消息ID:当前消息 ID。
  • 事件ID:当前事件 ID。
3. 命令判断
<?php

// 精准匹配
if (消息 == "菜单") {
    文字("这里是菜单");
    return;
}

// 前缀匹配
if (前缀(消息, "echo ")) {
    $text = 前缀后(消息, "echo ");
    文字($text);
    return;
}
4. 发送文字
文字("你好,这是一条文字回复");
5. 发送图片
图片("https://example.com/a.jpg");
图片("https://example.com/a.jpg", "图片说明");
6. 原生 Markdown
原生MD("# 标题\n这是一条 Markdown 消息");

// 如果你有官方 keyboard id
原生MD("# 菜单", "keyboard_id_xxx");
7. 原生按钮
$md = "# 点击按钮";

$rows = [
    [
        "buttons" => [
            [
                "id" => "btn_1",
                "render_data" => [
                    "label" => "点我",
                    "visited_label" => "已点击",
                    "style" => 1
                ],
                "action" => [
                    "type" => 1,
                    "permission" => ["type" => 2],
                    "data" => "demo:click",
                    "unsupport_tips" => "当前客户端不支持"
                ]
            ]
        ]
    ]
];

原生按钮($md, $rows);
8. 场景限制
if (消息来源 != "群聊") {
    return;
}

if (!in_array(消息来源, ["群聊", "私聊"])) {
    return;
}
9. 提交与发布流程
  • 开发者在线编写或导入代码。
  • 可以先保存草稿。
  • 提交代码审核后,后台管理员审核。
  • 后台点击发布后,代码进入插件目录并上架市场。
  • 用户在插件市场安装后,才会出现在机器人插件配置里。

10. 注意事项

  • 插件处理完命令后建议写 return;,避免继续执行后续逻辑。
  • 不要使用 echo / print 回复消息,请使用 文字()图片()原生MD()原生按钮()
  • 不要写危险函数,如 evalexecsystemshell_exec
  • 插件代码最大建议 512KB 以内。
加载中...

我的提交

暂无提交

卡密兑换

输入卡密兑换额度

获得额外的机器人创建额度

账号设置

基本信息

修改密码