Weibo Helper

基于 Mirai Console 的 微博 转发插件

使用前应该查阅的相关文档或项目

• User Manual
• Permission Command
• Chat Command

插件基于PC网页版微博API，使用插件需要登录一个微博账号
插件初始化时，如果恢复登录状态失败，则会尝试模拟游客

指令

注意: 使用前请确保可以 在聊天环境执行指令
带括号的/前缀是可选的
<...>中的是指令名，由空格隔开表示或，选择其中任一名称都可执行例如/微博用户 订阅
[...]表示参数，当[...]后面带?时表示参数可选
{...}表示连续的多个参数

本插件指令权限ID 格式为 xyz.cssxsh.mirai.plugin.weibo-helper:command.*, * 是指令的第一指令名
例如 /微博用户 订阅 的权限ID为 xyz.cssxsh.mirai.plugin.weibo-helper:command.wuser

[subject]?订阅的接收对象，可选参数, 默认填充当前聊天环境

登录指令

使用指令后，机器人会发送网页登录的二维码
使用手机微博APP扫描确认登录后
如果成功登录，则会回复 @用户名#ID 登陆成功的消息

用户订阅指令

uid是用户的ID，可以在用户的主页获得，
例如 https://www.weibo.com/u/1111681197 的1111681197
使用订阅指令后，如果成功找到指定用户，则会回复
对@用户名#ID 的监听任务, 添加完成

分组订阅指令

id是分组的GID或者TITLE，GID可以在分组的页面获得，
例如 https://www.weibo.com/mygroups?gid=3893924734832698 的3893924734832698
也可以通过列表指令获得，使用列表指令之后会按行回复title -> gid
使用订阅指令后，如果成功找到指定分组，则会回复
对分组标题#ID的监听任务, 添加完成

分组订阅指令

博文查看指令

关注指令

解析微博链接

机器人会将群里中的微博链接捕获，并将微博内容回复给发送微博链接的人
这个功能默认开启，通过权限 xyz.cssxsh.mirai.plugin.weibo-helper:quiet.group 设置不开启的群聊

配置

位于Mirai-Console运行目录下的config/weibo-helper文件夹下的WeiboHelperSettings文件

• cache 图片缓存位置
• expire 图片缓存过期时间，单位小时，默认3天，为0时不会过期
• following 是否清理收藏的用户的缓存，默认 true
• fast 快速轮询间隔，单位分钟
• slow 慢速轮询间隔，单位分钟
• contact 登录状态失效联系人，当微博的登录状态失效时会向这个QQ号发送消息
• repost 微博订阅器，最少转发数过滤器，只对列表订阅生效，默认16
• users 微博订阅器，屏蔽用户
• regexes 微博订阅器，屏蔽的关键词正则表达式
• urls 微博订阅器，屏蔽的URL类型, 屏蔽视频可以尝试填入39
• video 发送微博视频文件
• emoticon 处理微博表情
• picture 图片设置
• cover 封面设置
• history 历史记录保留时间，单位天，默认 7d
• timeout Http 超时时间，单位毫秒，默认 60_000 ms
• forward 以转发消息的方式发送订阅微博
• show_url 是否显示url

图片设置

有四种设置方案

• { type: none, value: {} } 一张也不显示
• { type: all, value: {} } 全部显示
• { type: limit, value: { total: 3 } } 最多显示total张
• { type: top, value: { total: 3 } } 超过total张一张也不显示

quiet.group

安静群聊, 不解析URL链接, 通过权限系统配置
/perm add g12345 xyz.cssxsh.mirai.plugin.weibo-helper:quiet.group

安装

MCL 指令安装

./mcl --update-package xyz.cssxsh:weibo-helper --channel stable --type plugin

手动安装

• 运行 Mirai Console 生成plugins文件夹
• 从 Releases 下载jar并将其放入plugins文件夹中