Make Nonebot your puppet
Project description
Nonebot Plugin Puppet
基于 nonebot2 和 go-cqhttp 的会话转接插件
安装
从 PyPI 安装(推荐)
- 使用 nb-cli
nb plugin install nonebot_plugin_puppet
- 使用 poetry
poetry add nonebot_plugin_puppet
- 使用 pip
pip install nonebot_plugin_puppet
从 GitHub 安装(不推荐)
git clone https://github.com/Jigsaw111/nonebot_plugin_puppet.git
使用
仅限超级用户使用
不建议同时链接多个会话(尤其是大群),如被风控概不负责
puppet ln/link
链接会话-u user_id..., -ua user_id..., --user-a user_id...
可选参数,指定源会话的 QQ 号-g group_id..., -ga group_id..., --group-a group_id...
可选参数,指定源会话的群号 至少需要设置一个-ub user_id..., --user-b user_id...
可选参数,指定链接会话的 QQ 号-gb group_id..., --group-b group_id...
可选参数,指定链接会话的群号 不设置的话默认为当前会话的 QQ 号/群号-q, --quiet
可选参数,静默链接(不发送链接成功消息)-U, --unilateral
可选参数,单方面链接
puppet rm/unlink
删除会话链接-u user_id..., -ua user_id..., --user-a user_id...
可选参数,指定源会话的 QQ 号-g group_id..., -ga group_id..., --group-a group_id...
可选参数,指定源会话的群号 不设置的话,默认为当前会话链接的所有会话-ub user_id..., --user-b user_id...
可选参数,指定链接会话的 QQ 号-gb group_id..., --group-b group_id...
可选参数,指定链接会话的群号 不设置的话默认为当前会话的 QQ 号/群号-q, --quiet
可选参数,静默链接(不发送解除链接成功消息)-U, --unilateral
可选参数,单方面解除链接
puppet ls/list
查看链接到当前会话的会话列表-u user_id, --user user_id
互斥参数,指定会话的 QQ 号-g group_id, --group group_id
互斥参数,指定会话的群号 不设置的话默认为当前会话的 QQ 号/群号
puppet send message
向指定会话发送消息,支持 CQ 码message
需要发送的消息,支持 CQ 码,如含空格请用""
包裹-u user_id..., --user user_id...
可选参数,指定接收会话的 QQ 号-g group_id..., --group group_id...
可选参数,指定接收会话的群号 不设置的话默认为当前会话链接的所有会话--a, --all
可选参数,指定所有群聊
puppet aprv/approve
同意请求/邀请-f flag..., --flag flag...
可选参数,指定请求的 flag 不设置的话默认为链接到当前会话的所有请求--a, --all
可选参数,指定所有请求
puppet rej/reject
拒绝请求/邀请-f flag..., --flag flag...
可选参数,指定请求的 flag 不设置的话默认为链接到当前会话的所有请求--a, --all
可选参数,指定所有请求
Bug
- 不允许多个超级用户链接到同一会话
- 如果指定的会话不在会话列表里会产生错误
To Do
- 允许单向转接
- 转接请求事件
- 提供退群功能
- 提供默认设置
原理
graph LR
用户 & 群 ---> Puppet ---> 用户 & 群
Changelog
- 210525 0.2.0-alpha.5
- 实现转接请求事件
- 修复了 ln/rm 操作无效的 bug
- 修复了 list 重复展示的 bug
- 修复了 --undirect 参数无效的 bug
- 210429 0.2.0-alpha.4
- 新增部分命令的缩写
- list 命令能够显示单双向
- 支持 -h, --help 参数
- 发生错误时返回相关信息
- 分离 handle 与 parser
- 210429 0.2.0-alpha.3
- 修复未设置群名片时昵称为空的问题
- 实现单向的会话转接
- 210429 0.2.0-alpha.2
- 修复指定会话不在会话列表时会产生错误的问题
- 修复群发消息时由于风控/禁言而被打断的问题
- 210421 0.2.0-alpha.1
- 实现多对多的会话转接
- 重构数据结构以便下次更新
- 210416 0.1.0
- 实现单对单的会话转接
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for nonebot_plugin_puppet-0.2.0a6.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 454c9b8553635ce60074e5449d869d6e72c65ef876cc9dd79617f9849282a09f |
|
MD5 | 1f4c9293f6c2ce5e9288ac80e7c652a9 |
|
BLAKE2b-256 | 88c80150da8c59143f89067741ebde4972ea3172876d0af7f6b029bcc90ff729 |
Close
Hashes for nonebot_plugin_puppet-0.2.0a6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 468f0f6213f4c9bebbaabdb541be533501d6eb177de7b9f7c29f60ae7ff6a934 |
|
MD5 | afc9be0b57e53a4019d919c36d5e7df5 |
|
BLAKE2b-256 | 8b53bae51e1399f80c3fa6ca370ff4ceeb5c28ced513d92cd6841619788bd294 |