关于 KOOK 适配器中 (rol)role_id(rol) 转换为 AstrBot At 组件的实现逻辑讨论

[shuiping233]

目前 #7626 已经实现了kook适配器对"角色(role)"id mention的处理和转换,就是处理了(rol)xxx(rol)这个格式的内容(xxx里边放的是角色id而不是角色名称),但是astrbot的消息组件设计中并不存在"角色"这一个概念, 在不对astrbot At消息组件进行改动或者添加新的消息组件的情况下,且还要实现astrbot对角色mention消息的正常响应, 只能在kook适配器侧对角色mention转换成At组件且At组件的qq字段的值设为机器人id

我能想到的方案有如下两种:

1. 直接将角色 mention 转换为At组件,qq字段填机器人id,name字段填角色名称

At(
    qq=bot_id,
    name=role_mention_name,
)

2. 保留角色mention且转换为At组件,qq和name字段分别填入角色id和角色名称,当成正常At其他用户的语义进行处理,然后再手动追加一个At机器人id的At组件

At(
    qq=role_id,
    name=role_mention_name,
)
At(
    qq=bot_id,
    name=bot_username,
)

为了尽可能减少原有消息的改动,目前是实现的方案1,我暂时没想到别的更好的方案了,角色mention处理这部分后续的改动和实现,我实在是没法做主,所以我才开启了这个讨论,希望大佬们能提供更好的方案)

相关文档:

• kook角色对象格式 , 描述了角色json的字段定义
• kmarkdown文档 , 描述了在消息事件中, 角色 mention 的固定格式 , 例如: (rol)xxx(rol)
• kook用户相关接口列表 , user/view接口可以通过服务器id(guild_id)查询当前机器人账户在特定的服务器的角色id
• kook角色的作用域是服务器(guild),机器人账号在某个服务器内拥有某个角色id,意味着机器人账号属于此角色

以下为 #7626 的角色mention部分的实现

KOOK_AT_SELECTOR_REGEX = re.compile(r"\((met|rol)\)([^()]+)\(\1\)")

for match in KOOK_AT_SELECTOR_REGEX.finditer(content):
    if match.start() > cursor:
        plain_text = content[cursor : match.start()].strip(" ")
        if plain_text:
            components.append(Plain(text=plain_text))

    tag_name = match.group(1)
    mention_target = match.group(2).strip()
    if tag_name == KookMentionTagName.MENTION and mention_target == "all":
        components.append(AtAll())
    elif tag_name == KookMentionTagName.ROLE:
        role_mention_counter += 1
        role_id = 0
        role_mention_name = mention_target
        if mention_role_part is not None:
            if len(mention_role_part) > role_mention_counter:
                role_mention_name = mention_role_part[role_mention_counter].name
                role_id = mention_role_part[role_mention_counter].role_id
                if (
                    bot_nickname == role_mention_name
                    or bot_username == role_mention_name
                ):
                    components.append(
                        At(
                            qq=bot_id,
                            name=role_mention_name,  # 保留角色名称
                        )
                    )
                    continue
        if not mention_target.isdigit() and role_id == 0:
            continue

        role_id = role_id or int(mention_target)
        if not guild_id:
            continue

        if not guild_id.isdigit():
            continue

        if not await self._roles_cache.has_role_in_channel(
            role_id, int(guild_id)
        ):
            continue

        components.append(
            At(
                qq=bot_id,
                name=role_mention_name,  # 保留角色名称
            )
        )

    elif mention_target:
        components.append(
            At(
                qq=mention_target,
                name=mention_name_map.get(mention_target, ""),
            )
        )
    cursor = match.end()