我的机器人
还没有创建机器人
机器人插件配置
配置区这里管理“机器人 ↔ 已安装插件”的启用关系;插件发现和安装在插件市场。
插件市场
发现、筛选并快速启用 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()、原生按钮()。 - 不要写危险函数,如
eval、exec、system、shell_exec。 - 插件代码最大建议 512KB 以内。
加载中...
创建插件项目
在线编辑插件
先在概览里创建插件项目,再选择项目编辑代码。
在线代码只保存到隔离草稿/审核区,发布后按 3.6 脚本式底层执行。
我的提交
暂无提交
卡密兑换
输入卡密兑换额度
获得额外的机器人创建额度