用户文档¶
命令说明¶
调用命令实现功能需要以
<命令标识符><命令> <参数表>的形式调用,具体格式已在各命令中说明。默认标识符为
!或!,故在调用时请添加命令标识符,例如使用帮助命令时,请在聊天室(群/私聊)中键入:而非仅发送
about。关于权限,部分命令由于涉及重要推送设置或推送大量信息。为了保护BOT正常运行以及群内使用体验,故操作需要管理权限(超级管理员/群主/管理员)进行操作才会进行响应。
在权限中有
@bot字段的,群聊消息需要在添加标识符的同时@所使用的的BOT账号,如:
命令和参数表,以及参数表各参数之间需要以一个半角空格作为空格,空参数亦不能省略空格。
- 同义格式可以替换
<命令>使用,功能完全相同(通常提供中文支持或缩写)
- 同义格式可以替换
参数注释
- 推文推送命令列表中提到的
<推特用户ID>是指由英文数字组成的用户名(即在@时会显示的文本)。 - 烤推命令列表中提到的
<推文ID>为推文status字段后19位(或以上)10进制数码,<压缩推文ID>为推文推送时附带的字符串,可使用相关命令互相转换。
- 推文推送命令列表中提到的
!注意!:如果监听列表里没有监听对象则全局设置会被重置。
命令说明¶
沟通反馈¶
帮助 about¶
- 命令格式:
about - 同义格式:
帮助、关于、help - 所需权限:无限制
- 功能说明:返回转推bot的关于消息
信息反馈 feedback¶
- 命令格式:
feedback <信息> - 同义格式:
Feedback、反馈 - 所需权限:超级管理员/群管理/群主,@bot
- 功能说明:所发送的信息将会反馈到后台日志供开发者查看 并可由开发者查看后处理回复反馈
处理反馈 dealfeedback¶
- 命令格式:
feedback <编号> <反馈内容> - 同义格式:
处理反馈、反馈处理、dealFeedback - 所需权限:仅开发者
- 功能说明:开发者用于回复信息反馈内容的命令
反馈完成¶
- 命令格式:
反馈完成 <反馈ID> - 同义格式:
反馈处理完成 - 所需权限:仅开发者
- 功能说明:开发者用于回复信息反馈内容的命令
反馈列表 feedbacklist¶
- 命令格式:
feedbacklist [<页码>] - 同义格式:
反馈列表 - 所需权限:仅开发者
- 功能说明:开发者用于回复信息反馈内容的命令
插件例程¶
示例/测试用插件,用于简单娱乐和检查BOT连通性。
回复233 233¶
- 命令格式:
233 - 所需权限:组
say233 - 功能说明:权限组测试,BOT回复
233
固定回复 爬¶
- 命令格式:
233 - 同义格式:
say233 - 所需权限:无限制
- 功能说明:BOT回复
233
随机回复 爪巴¶
- 命令格式:
爪巴 - 所需权限:无限制
- 功能说明:BOT随机回复
复读 233¶
- 命令格式:
233 - 同义格式:
say233 - 所需权限:无限制
- 功能说明:BOT回复
233
报错测试绝活¶
- 命令格式:
绝活 - 同义格式:
异常、无内鬼报个错 - 所需权限:无限制
- 功能说明:管理/开发使用,测试后台报错。
权限管理¶
获取合法权限组列表 legalGroupList¶
- 命令格式:
legalGroupList - 同义格式:
合法组权限列表 - 所需权限:超级管理员/开发者
- 功能说明:获取合法可授权模块(合法权限组列表)
获取合法权限列表 legalPermList¶
- 命令格式:
legalPermList <合法权限组名> - 同义格式:
合法权限列表 - 所需权限:超级管理员/开发者
- 功能说明:获取某合法权限组内具体可用命令(具体合法权限)
查看授权¶
权限组列表 permGroupList¶
- 命令格式:
permGroupList <类型> <ID> - 同义格式:
权限组列表 - 所需权限:超级管理员/开发者
- 功能说明:获取某群聊/聊天所有权限组列表
远程授权¶
远程取消授权¶
远程授权禁用¶
查询授权¶
添加权限 permAdd¶
- 命令格式:
permAdd <群号> <权限组名> - 同义格式:
添加权限 - 所需权限:超级管理员/开发者
- 功能说明:添加某群组/聊天权限
移除权限 permDel¶
- 命令格式:
permDel <群号> <权限组名> - 同义格式:
移除权限 - 所需权限:超级管理员/开发者
- 功能说明:移除某群组/聊天权限
RSS推送¶
推送插件¶
订阅、监听、推送的功能插件。
启动监听 runTweetListener¶
- 命令格式:
runTweetListener - 同义格式:
启动监听 - 所需权限:超级管理员, @bot
- 功能说明:用于推特流断连后尝试重启监听 如已启动则会警告
移除全部监听 delall¶
- 命令格式:
delall - 同义格式:
这里单推bot - 所需权限:超级管理员/群主, @bot
- 功能:移除当前私聊/群的所有监听
查看监听列表 getpushlist¶
- 命令格式:
getpushlist <页码-可选> - 同义格式:
DD列表 - 所需权限:超级管理员/群管理/群主/好友私聊
- 功能:获取当前私聊/群的监听列表,页数默认为1。
获取用户信息 getuserinfo¶
- 命令格式:
getuserinfo <推特用户ID> - 同义格式:
查询推特用户 <推特用户ID> - 所需权限:超级管理员/好友私聊/群管理/群主, @bot
- 功能:获取当前私聊/群的监听列表
例:getuserinfo shiranuiflare
添加监听对象 addone¶
命令格式:
addone <推特用户ID> <称呼> <描述>同义格式:
给俺D一个 <推特用户ID> <称呼> <描述>所需权限:超级管理员/好友私聊/群管理/群主, @bot
功能说明:添加一个用户到本群监听
使用例:
给俺D一个 shirakamifubuki 吹雪 我永远喜欢小狐狸(不设置昵称)使用例:
给俺D一个 shirakamifubuki 我永远喜欢小狐狸(完全无参数)使用例:
给俺D一个 shirakamifubuki※ 跨参数设置同样需要空格分割,完全不设置参数时可以不添加空格
删除监听对象 delone¶
- 命令格式:
delone <推特用户ID> - 同义格式:
我不想D了 - 所需权限:超级管理员/群管理/群主/好友私聊, @bot
- 功能说明:移除一个本群监听的用户
显示BOT推送设置 getGroupSetting¶
- 命令格式:
getGroupSetting - 同义格式:
全局设置列表 - 所需权限:超级管理员/群管理/群主/好友私聊, @bot
- 功能说明:显示当前私聊/群的全局推送设置
显示推送设置 getSetting¶
- 命令格式:
getSetting <推特用户ID> - 同义格式:
对象设置列表 - 所需权限:超级管理员/群管理/群主/好友私聊, @bot
- 功能说明:显示当前私聊/群的某个监听对象的推送设置
设置推送属性 setGroupAttr¶
- 命令格式:
setGroupAttr <属性> <值> - 同义格式:
全局设置 - 所需权限:超级管理员/群管理/群主/好友私聊, @bot
- 功能说明:移除一个本群监听的用户
例:setGroupAttr 转推 关
消息模版(参数为模版字符串)¶
retweet_template,转推模版
quoted_template,转推并评论模版
reply_to_status_template,回复模版
reply_to_user_template,被提及模版
none_template,发推模版
推特转发各类型开关¶
- 属性
retweet,转推
quoted,转推并评论
reply_to_status,回复
reply_to_user,被提及
none,发推
- 值
true,开,打开,开启,1
false,关,关闭,0
模版字符串说明¶
默认模版¶
发推¶
转推¶
转发并评论¶
回复与被提及¶
模版支持的变量¶
注:使用\n替代换行符,理论上直接换行也可以但是十分不推荐
$tweet_id 推特ID
$tweet_id_min 压缩推特id
$tweet_nick 操作人昵称
$tweet_user_id 操作人ID
$tweet_text 发送推特的完整内容
$related_user_id 关联用户ID
$related_user_name 关联用户昵称-昵称-昵称查询不到时为ID(被评论/被转发/被提及)
$related_tweet_id 关联推特ID(被评论/被转发)
$related_tweet_id_min 关联推特ID的压缩(被评论/被转发)
$related_tweet_text 关联推特内容(被转发或被转发并评论时存在)
$media_img 推特携带的图片
更改监听对象属性 setAttr¶
- 命令格式:
setAttr <监听用户UID> <属性> <值> - 同义格式:
对象设置 - 所需权限:超级管理员/群管理/群主/好友私聊, @bot
- 功能说明:设置指定监听对象的属性
例:setGroupAttr 997786053124616192 转推 关
setGroupAttr 997786053124616192 昵称
setGroupAttr 997786053124616192 昵称 FBKwaring
※ UID可以通过命令getpushlist查看,大部分属性与setGroupAttr命令相同
删除推送对象 globalRemove¶
- 命令格式:
globalRemove 消息类型 Q号/群号 - 同义格式:
全局移除 - 所需权限:超级管理员/好友私聊, @bot
- 功能说明:移除某个人或某个群的所有监听,用于修复配置错误(退出群/删除好友时不在线)
查询推特用户信息 getuserinfo¶
- 命令格式:
getuserinfo <用户UID/用户ID> - 同义格式:
查询推特用户 - 所需权限:超级管理员/好友私聊, @bot
- 功能说明:查询某个用户的信息,显示的头像将会更新(新增与减少监听不会重新下载头像)
全局移除 globalRemove¶
- 命令格式:
globalRemove <private/私聊/group/群聊> <QQ号/群号> - 同义格式:
全局移除 - 所需权限:超级管理员, @bot
- 功能说明:移除某个人或某个群的所有监测,用于修复配置错误(退出群/删除好友时不在线)
压缩推特ID entweetid¶
- 命令格式:
entweetid <推文ID> - 同义格式:
推特ID压缩、压缩ID - 所需权限:无限制
- 功能说明:将推文ID压缩为缩写推文ID
解压推特ID detweetid¶
- 命令格式:
detweetid <缩写推文ID> - 同义格式:
推特ID解压、解压ID - 所需权限:无限制
- 功能说明:将缩写推文ID解压为推文ID
烤推插件¶
烤推授权 transswitch¶
- 命令格式:
globalRemove <private/私聊/group/群聊> <QQ号/群号> - 同义格式:
ts、烤推授权 - 所需权限:群聊, 群主/超级管理员, @bot
- 功能说明:为群聊添加/移除烤推授权(开关功能)
翻译推特 trans¶
- 命令格式:
trans <推文ID/缩写推文ID> <翻译文本> - 同义格式:
t、烤推 - 所需权限:无限制
- 功能说明:为某条推文添加翻译,由BOT完成嵌字并返回。翻译文本支持多行,不支持转义字符(TODO: 对emoji的支持尚需完善)
获取推特翻译列表 translist¶
- 命令格式:
translist <页数>或translist(translist默认值为1) - 同义格式:
tl、烤推列表 - 所需权限:无限制
- 功能说明:获取已翻译推特列表
获取翻译文本 gettrans¶
- 命令格式:
gettrans <推文ID/缩写推文ID> - 同义格式:
gt、获取翻译 - 所需权限:无限制
- 功能说明:获取某条推文的翻译文本
获取烤推帮助 transabout¶
- 命令格式:
transabout - 同义格式:
ta、烤推帮助 - 所需权限:无限制
- 功能说明:获取烤推流程相关命令帮助说明
按类型获取推文翻译 typeGettrans¶
- 命令格式:
typeGettrans <推文翻译类型> - 同义格式:
tgt - 所需权限:超级管理员/开发者
- 功能说明:仅供开发者使用的推文翻译获取方法