悠悠

Appearance

常见问题 ​

价格 ​

每月 50 元, 购买一年 送一年云服务器 或 立减一百元

最少购买 3 个月起, 首次购买送 1 个月

使用机器人需要准备什么? ​

一台能跑程序能联网的计算机, 需要一直运行机器人程序

硬件要求 至少 500M 内存空间 至少 1GB 磁盘空间

系统要求 windows7 或 windows service 2012 及以上

一个 QQ 小号, 最好有等级 用自己的 QQ 小号, 安全又稳定, 不存在多人共用

机器人怎么用? ​

这个不用担心, 可以远程帮部署好, 最好语音教你怎么使用, 部署 10 分钟, 教学 15 分钟, 轻松拿下

功能都是按需使用, 用不到的功能可以关闭

如何启动? ​

机器人完整运行需要两个独立程序, 无先后启动顺序

  • 机器人本体 / 悠悠 / mxdbot (提供业务处理能力)

  • 协议端 (提供与 QQ 消息收发等接口调用)

启动机器人 ​

直接双击 start.bat 就可以启动

没有 start.bat 或 启动了旧版本

点击 启动器(starter) 的 生成并启动 会自动生成并保存一份 start.bat

协议端 ​

这个没有固定方式, 以部署时为准

更多请参考左侧 协议端常见问题

如何更新? (不建议自行更新) ​

先打开 启动器(starter) 再点击 更新

下载更新完成后, 点击 生成并启动 即可 (重新生成启动脚本)

提示

有些版本更新较大, 导致可能更新后无法正常工作, 更新前 问问客服 或 协助更新

如何查看或修改网页管理端密码? ​

打开 /config/application.yml, 修改 password 的值

提示

重启程序生效

切换主副群 ​

切到哪个群, 哪个群才会生效

目录结构 ​

config
.
├─ adapter              适配器
│  └─ ...
├─ config
│  ├─ application.yml   配置文件    
│  └─ data.db           数据库文件    
├─ files                文件 (通常来自上传的图片)
│  └─ ...               
├─ modules              模块
│  ├─ ocr               光学字符识别
│  ├─ chrome            Chrome      
│  └─ ...               
├─ objects              对象 (通常是 json)
│  └─ ...               
├─ plugins              插件的配置和数据
│  └─ ...                  
├─ mxdbot-*.*.*.jar     主程序
├─ starter.exe          启动器
└─ start.bat            启动脚本

配置文件 ​

文件位置 /config/application.yml

yml
adapter: NapCat                   # 适配器名称  
password: 886521uu                # 后台登录密码, 强烈建议修改 
open-api:                  
  whitelist:                      # openapi 允许调用地址  
    - 127.0.0.1
    - 0:0:0:0:0:0:0:1
  charset: UTF-8                  # 编码  
server:
  port: 9600                      # 端口, 默认9600

提示

不同层级一定用空格对齐, 而不是 tab, 冒号后面一定要有一个空格

不正确的配置格式会导致程序无法启动

端口占用 ​

程序会默认占用 9600 端口

网页管理端的网址是什么? ​

本地访问 http://127.0.0.1:9600

外网访问 http://{外网ip}:9600

假如你的服务器 ip 是 8.16.7.22 就访问 http://8.16.7.22:9600

提示

https 协议是访问不了的, 有时候浏览器会隐藏协议

接收消息推送的地址是什么? ​

http://127.0.0.1:9600/bot/event

JavaScript ES ​

只支持部分 ES6

配置文件内置 key 解释 ​

master 机器人的管理者 QQ, 不是机器人 QQ, 部分插件需要权限

group.main 主群号

group.test 测试群号, 建议人数少于 5 人

group.log 通知群号, 用来接收通知的, 异常信息的, 敏感信息的, 人数强烈建议少于等于 3 人

group.current 当前启用群号, 在 工具 面板可手动快速切换, 无需配置

提示

没有群就新建一个

log 和 test 的群号可以一样

消息中的 普通模式 脚本模式 ​

普通模式下机器人会直接发送内容的文本

脚本模式下不会直接发送内容, 而是会执行内容中的脚本

可以利用 bot 对象发送消息, 撤回等操作

利用脚本模式撤回消息

js
function action(event) {
    bot.recall(event.id)
}

脚本模式返回值的说明

采用 责任链 模式, 每个脚本依次按顺序执行, 当脚本返回 false 时, 结束整个 责任链

返回 true 则继续交给下一个脚本 / 回复

默认返回 false

如何发送本地图片? 为什么要发送本地图片? ​

发送本地图片, 可以保持图片的可靠性, 超链接容易失效

直接发送图片码就行 <image file="file:///图片路径">

路径中可以用 @ 代替工作目录

如 <image file="file:///@/files/download.png">

提示

  • file 本地路径需要加协议前缀, 也就是 file:///
  • 可以在工具组件中快速上传图片

消息中特殊字符转义 < > & 等 ​

被 < 和 > 所包裹的内容, 将被系统转换成有意义的内容

想输出真正的 < 和 >, 需要对其转义, & 也需要转义

  • &lt; 或 &#60; 转换为 <
  • &gt; 或 &#62; 转换为 >
  • &amp; 或 &#38; 转换为 &
  • &lsb; 或 &#91; 转换为 [
  • &rsb; 或 &#93; 转换为 ]
  • &lcub; 或 &#123; 转换为 {
  • &rcub; 或 &#125; 转换为 }

mysql 新建指定 ip 的用户 ​

sql
-- 创建用户 ip 地址必填 
CREATE USER 'bot'@'{{ip地址}}' IDENTIFIED BY '密码';
-- 赋予查询, 新增, 删除, 修改权限
GRANT SELECT, INSERT, DELETE, UPDATE ON *.* TO 'bot'@'{{ip地址}}'
-- 刷新
FLUSH PRIVILEGES;

-- 只赋予查询权限
GRANT SELECT ON *.* TO 'bot'@'{{ip地址}}'
-- 赋予所有权限
GRANT ALL PRIVILEGES ON *.* TO 'bot'@'ip地址'

怎么发送 QQ 表情? ​

在群里发一个表情, 看看消息面板, 怎么收到的就怎么发, 嘿嘿😝