为 Action 添加 TaskLimit 注解限制 Action 同一时间重复运行方式

提供三种不同的级别规定 Action 的重复任务运行限制。

限制类型

sender: 发送者。
source: 发送源
all: 全局

当限制为发送者时，则在当前 Action 完成之前当前 QQ 下次发言无法触发本 Action。
当限制为发送源时，如果为私聊，则发送源为发送者，同发送者。
如果为群聊，则当前发送源为群，则在当前 Action 完成之前全群所有成员下次发言无法触发本 Action。
当限制为全局时，则在当前 Action 完成之前，所有人无法触发本 Action。

冷却时间

允许提供一个时间，来标明当前限制类型在执行本 Action 后的一段时间内仍无法触发本 Action。

例外权限

声明当拥有此权限的人，可以不受限制与冷却时间，重复使用本 Action。

ContextSession 提供 readNextMessage 方法，使得可以直接获取下一条消息，简化上下文开发流程。

权限验证 API 规范及功能需求收集

提供快速确定好友，临时会话目标，群成员的权限，同时允许更多精细化的操作方式。

对于受检查目标

目标具有的权限区分应该更加细腻。
应该按照不同场景，区分目标拥有不同的权限列表。
同一个 ID 下，一个人应在好友状态，群聊状态，临时会话状态拥有不同的权限。
同时不同群中同一个人拥有的权限也应该是不同的。

权限组

一个权限组为一组权限的集合。
同时权限组有具体的生效范围。
一个权限组可以仅在某个群生效，也可以在多个群生效，也可以在全部群同时生效。
同时也可以在好友私聊和临时会话中同时生效。
一个目标，允许有多个权限组。
但是同生效范围仅允许有一个权限组。
一个权限组可以继承自另外一个权限组，继承其权限和生效范围。

默认权限组

群

对于群内提供一些默认权限组。

群成员组

所有群成员都会被默认添加进本组。
也是理论上最基础的用户组。

管理员组

继承自群成员组。
所有管理员会被自动添加进本组。
当目标失去管理员身份时，会被自动移出本组，并移动至群成员组。
如果目标拥有其他权限组，如若权限组小于管理员组级别，则会自动移动至管理员组。

群主组

继承自管理员组
群主会被自动添加进本组。
当群主失去群主资格的时候会被自动移出本组。

私聊

临时会话组

TODO

好友组

继承自临时会话组

权限名

权限名不限制格式，但多级权限将使用 ”.“ 分割。
如授予用户上级权限，则代表用户可拥有其所有子权限。
举例：当用户拥有 moe.chat 权限时，可正常使用 moe.chat.sendMessage 权限的指令。

API

权限操作

对目标

应当为 Contact 提供
boolean hasPermission(String permissionName)
方法来确定目标用户是否有具体权限。

应当为 Contact 提供
boolean addPermission(String permissionName)
方法来为目标用户新增具体权限。

应当为 Contact 提供
boolean delPermission(String permissionName)
方法来为目标用户移除具体权限。

应当为 Contact 提供
boolean moveToPermissionGroup(String groupName)
方法来确定来将目标移动至某一权限组。

对权限组

TODO

Controller

应当为 Controller Action 提供 @PermissionCheck 注解用以提供权限检查。

如果有什么更好的想法与操作方式，或者优化设计思路，请回复。

获取群成员最后发言时间

yuq.getGroups().get(xxxx).get(xxxx)得到的member对象希望新增一个.getLastTime()方法，用以获得群成员的发言时间

对路由映射参数规则进行征集。

对路由分词进行改造，不再使用空格分词，允许使用更复杂的分词逻辑。
同时支持更复杂的内容映射到参数。
以致于提升 Controller 的易用性。

希望您能提供：

需要映射的内容
希望映射成的格式
简单举例一个样例
简单举例样例映射后的结果

如：
希望可以将 StringintStringint... 映射为 Map<String,Integer>
举例：
敏捷12力量3
映射为：

{
    "敏捷":12,
    "智慧":3
}

如果您有相应的需求，欢迎回复本 issue 来提供思路。

增加单独@bot事件

希望action返回值能支持ArrayList

希望能加一个MessageSendEvent来监听自己的消息发送

如题，现在的版本似乎不能全面的监听到自己消息的发出。希望能加一个event来监听自己的消息发出。

为 YuQVersion 添加参数 paltform 来支持应用获取正在运行的目标平台。

希望增强EhcacheHelp，使之能获取到所有的key，完成遍历操作

希望能为@Action添加重载功能

当前的Action不支持重载，在识别的时候不能按照参数类型启动合适的方法。但是很多的功能目前必须使用重载。

@Action(.rab {skill})

public void rab(String skill){}

@Action(.rab {time} {skill})

public void rab(int time,String skill){}

@Action(.rab {skill} {num})

public void rab(String skill,int num){}

@Action(.rab {time} {skill} {num})

public void rab(int time,String skill,int num){}

上述例子中当我输入：".rab 3 技能"的时候，不会启动第二个方法而是会启动第三个方法并且报错。
能否添加一个重载的功能来匹配合适的方法。

希望添加一个方法以直接比对消息体

希望能添加一个方法，判读2条信息的内容是否一致，做复读机

添加对于语音消息的支持。

包括接收，发送，转发。

将所有的联系人列表由 Map 切换到列表

将所有的联系人列表由 Map 切换到列表，并提供 get(id:Long) 与 get(platformId:String) 保证兼容性。

提供一个 Controller 工具类，以提升使用效率。

提供一个 yuq 对象。
提供一个 mf 对象。
提供一个 mif 对象。

提供一个 replay 方法，使得可以快速向当前消息源回复。

为所有可能涉及到的联系人，用户添加 platformId

在 platformId 为 Long（允许内）的平台的时候，id 则与 platformId 相等。
在 platformId 为其他类型的平台的时候，id 由框架按规则生成，并保证其可靠性。

获取群信息时获得更多信息

如群成员上线等信息，等同于原酷Q的.getGroup().getMax()方法

希望能在@Before里获得下游的@Action方法

希望能在@Before里添加一参数注入，用以获取下一步传入的@Action方法
同理，也希望@After能提供获取上游@Action的方法。

调用contact的sendMessage()方法后返回的MessageSource的id值为0

版本
yuqartqq-0.1.0.0-dev7
yuq-0.1.0.0-dev23
yucode-0.2.0.0-dev15

希望能添加语音消息的Rain码实现

现在还在是[ NoImpl ]

希望增加群公告接口

原有接口setGroupNotice(groupId,title,text);方法，希望支持类似方法，感谢

支持 Action 与 Path 使用 “ ”（空格）为路由区分

    @Action("{time}秒后说一句/{nr}")
    fun timeMessage(time: String, nr: String, message: Message): String {
        //TODO
    }

可同等替换为

    @Action("{time}秒后说一句 {nr}")
    fun timeMessage(time: String, nr: String, message: Message): String {
        //TODO
    }

以增强表达力

希望能为@QMsg添加一个属性，使得消息具有at并换行

希望能为@qmsg添加一个属性，使得消息具有at并换行

希望能添加一个在群中面向所有人的waitNextMessage

如题，目前暂时无法对一个群里的下一条消息接收，只能接收某个人而不是群中所有人。希望能够添加支持

当机器人受到空消息时，会抛出异常（不影响正常使用）

希望能添加转发消息的构建

QQ里面的消息转发

为 Java 用户提供 DSL 方式构建消息。

举例演示。

        buildMessage(() -> {
            textLine("%s，您好。", member.getNameCard());
            if (memberGirlsNow == 0){
                text("您当前还没有老婆！");
                return;
            }

            for (String girl : girls) {
                textLine("-------------");
                textLine("老婆：%s。",girl);
                imageByFile();
            }

            if (memberGirlsNow == memberGirlsMax){
                textLine("-------------");
                text("您的老婆已达上限！");
            }
        });

相比于 LineQ 方式，DSL 方式在承载业务上，要轻松的多。
LineQ 主要用于非承载业务的复杂消息构建。
DSL 主要用于承载业务的复杂消息构建。

    @Action("全员禁言/{flag}")
    fun test(flag: Boolean) {
        // TODO
    }

可自动将 flag 参数映射为 @PathVar(1, PathVar.Type.Switch)
等同于编写代码

    @Action("全员禁言")
    fun test(@PathVar(1, PathVar.Type.Switch) flag: Boolean) {
        // TODO
    }

@Action("rad{ex}")
fun rad(ex: String) = "rad!!"
@Action("radio{ex}")
fun radio(ex: String) = "radio!!"

当发送 radio111 给机器人时，预想的是机器人返回 radio!!，但实际情况是返回 rad!!。

希望冰淇淋大佬能为 @Action 注解添加优先级，或者提供其他解决方案。

当前可用的解决方案：

if(ex.startsWith("io")) return radio(ex.subString(2)) （~~十分不爽~~）
@Action("rad{ex:[^i][^o].*}")（~~十分不爽~~；强制要求长度至少为 2 的字符串，~~也可能是我太菜了不会写正则~~）

yuqworks / yuq Goto Github PK

yuq's People

Contributors

Stargazers

Watchers

Forkers

yuq's Issues