Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/canxin121/nonebot_plugin_bind
nonebot2的通用多平台身份绑定插件
https://github.com/canxin121/nonebot_plugin_bind
Last synced: about 2 months ago
JSON representation
nonebot2的通用多平台身份绑定插件
- Host: GitHub
- URL: https://github.com/canxin121/nonebot_plugin_bind
- Owner: canxin121
- Created: 2023-08-01T03:27:23.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2023-10-12T14:26:37.000Z (about 1 year ago)
- Last Synced: 2024-11-07T19:54:57.725Z (about 2 months ago)
- Language: Python
- Size: 1.08 MB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
nonebot_plugin_bind
# 适配支持
- onebotv11
- telegram
- discord
- kook(开黑啦)
- villa(大别野)
- 飞书
# 使用说明
## 用户使用说明
| 命令 | 限制 | 含义 |
|-------------------|-------|-----------------------------|
| 'bind' | 群聊或私聊 | 将其他通用账户绑定至当前通用账户 |
| 'bindinfo' | 仅私聊 | 查看当前通用账户的平台账户绑定信息 |
| 'rebind' | 仅私聊 | 取消本平台账户和通用账户的绑定,并形成一个新的通用账户 |
| 'bind -group' | 群聊或私聊 | 将其他通用群组绑定至当前通用群组 |
| 'bindinfo -group' | 仅私聊 | 查看当前通用群组的平台群组绑定信息 |
| 'rebind -group' | 仅私聊 | 取消本平台群组和通用尊祖的绑定,并形成一个新的通用群组 |
## 配置项
请使用[Webui](https://github.com/canxin121/nonebot_plugin_web_config)
进行配置,默认端口为8666,ip为主机对应ip,默认本地地址为http:
//127.0.0.1:8666
| 配置名 | 默认 | 含义 |
|------------------|-------|------------------------------------------------------------------|
| bind_superuser | [] | bind的superuser,用以管理群组绑定,注意填写的值应该是通过bindinfo查询出的id,而不是你的某个社交平台的账户 |
| bind_group_admin | False | 是否允许某社交平台的群组的管理员直接管理其群组绑定,不管他是否是bind_superuser |
具体使用请看下图流程示例(群聊绑定同理)
(如果是在群聊中发起的绑定,不会显示下面的绑定信息,只会显示其他内容)
## 开发者说明
主要提供两个依赖注入
1. GetUser:返回一个User实例,其属性id为一个通用账户的唯一标识,其属性platform_users中包含绑定的所有平台账户的信息
2. GetGroup:返回一个Group实例,其属性id为一个通用群组的唯一标识,其属性platform_groups中包含所有绑定的平台群组的信息(
其中groupid是对应平台群组的id)(如果不想在匹配非群组消息时跳过matcher,请使用Optional类型注释)
示例代码如下
```python
from typing import Annotated
from nonebot import require
require('nonebot_plugin_bind')
from nonebot_plugin_bind import GetUser, GetGroup, GetGroupId, User, Group
# 此处省略了部分import
bind_info = on_alconna(Alconna(Command_Start, "bindinfo", Option("-group")))
@bind_info.assign("$main")
async def bind_info_(
event: Event, bot: Bot, matcher: Matcher, user: Annotated[User, GetUser()]
):
user_str = "\n".join(
pg + " √" if event.get_user_id() in pg else pg for pg in str(user).split("\n")
)
if _is_private_(event, bot):
await matcher.finish(f"当前通用账户的绑定的平台账户如下:\n{str(user_str)}")
else:
await matcher.finish("账户绑定信息只能在私聊中查看")
@bind_info.assign("group")
async def bind_info_group(
matcher: Matcher,
group: Optional[Group] = GetGroup(),
groupid: Optional[str] = GetGroupId(),
):
# 如果在私聊中发送此命令,得到的group会是None,groupid也是如此
if group is None:
await matcher.finish("本命令只能在各平台的群聊中使用,私聊中无法使用")
group_str = "\n".join(
pg + " √" if groupid in pg else pg for pg in str(group).split("\n")
)
await matcher.send(f"当前通用群组的绑定的平台群组如下:\n{group_str}")
_bind_ = on_alconna(
Alconna(Command_Start, "bind", Option("token", Args["token_value", str]))
)
```
