<!-- markdownlint-disable MD033 MD036 MD041 -->
<p align="center">
<a href="https://v2.nonebot.dev/"><img src="https://v2.nonebot.dev/logo.png" width="200" height="200" alt="nonebot"></a>
</p>
<div align="center">
nonebot-plugin-access-control
============
_✨ Nonebot 权限控制插件 ✨_
</div>
<p align="center">
<a href="https://raw.githubusercontent.com/ssttkkl/nonebot-plugin-access-control/master/LICENSE">
<img src="https://img.shields.io/github/license/ssttkkl/nonebot-plugin-access-control.svg" alt="license">
</a>
<a href="https://pypi.python.org/pypi/nonebot-plugin-access-control">
<img src="https://img.shields.io/pypi/v/nonebot-plugin-access-control.svg" alt="pypi">
</a>
<img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="python">
</p>
## 特点
- 功能
- [x] 支持针对用户/群组的权限开关
- [x] 支持限制同一用户在一定时间内的指令调用次数
- [x] 对未适配插件提供**插件级别**的控制支持
- 插件适配
- [x] 支持**功能级别**的细粒度控制
- [x] 支持对权限开关等事件进行订阅
- 拓展
- [x] 支持开发者拓展定义新的主体
- CLI插件
- [x] 支持通过控制台中执行`nb accctrl`进入权限控制台
## 使用
### 主体
#### 概念
当我们对用户进行权限控制时，我们想要的是针对拥有某种同样身份的所有用户进行配置，而不是对每一个具体用户分别配置。因此，我们引入主体的概念。
**主体（Subject）代表了拥有某种同样身份的用户的集合，也是设置权限的基本单位。**
当我们说用户具有某个主体，也就是说用户在该主体所代表的集合内。换句话说，主体就是一个用户所具有的身份。
一个用户通常拥有多个主体。举个例子：QQ上群组G的用户U发送了一条消息，该用户同时具有“用户U”、“群组G成员”、“QQ用户”、“Bot用户”这几个主体。同时QQ上群组G的用户V也发送了一条消息，该用户该用户同时具有“用户V”、“群组G成员”、“QQ用户”、“Bot用户”这几个主体。
当设置权限时，我们直接针对一个主体进行设置。当鉴权时，我们对用户的所有主体**按优先级从高到低的顺序**
，逐一检查是否设置了权限。一旦检查到某个主体设置了权限，就以该主体设置的权限作为该用户的权限。
回到上面的例子，假设我们对主体”群组G“禁用服务，但是对主体”用户V“启用服务。则用户U在群组G内将无法使用服务，但是用户V在群组G内可以使用。
在插件使用中，我们用一个字符串表示主体，例如`qq:12345678`表示QQ用户12345678、`qq:g87654321`表示QQ群组87654321。
我们约定：`all`表示所有用户、`superuser`表示超级用户、`<平台名>`表示所有此平台的用户、`<协议名>`
表示所有此协议的用户、所有与平台相关的主体均以`<平台名>:`开头、所有与协议相关的主体均以`<协议名>:`开头。
插件依赖[nonebot-plugin-session](https://github.com/noneplugin/nonebot-plugin-session)提取事件的主体，各适配器的主体定义如下：
- [OneBot V11](docs/onebot_v11.md)
- [OneBot V12](docs/onebot_v12.md)
- [Kaiheila](docs/kaiheila.md)
- [QQ Guild](docs/qqguild.md)
- Telegram：未测试，参考OneBot V12的定义
### 服务
**服务（Service）为一组能够进行权限控制的功能的集合。** 服务可以拥有子服务，通过树形结构组织服务，统一管理权限。
整个NoneBot是一个名为nonebot的服务，为树形结构的根节点，其直接子节点为所有插件。
一个插件是一个服务（PluginService），其父节点为nonebot。当插件未进行适配时，该插件只具有这一个PluginService。对插件进行适配，则需要从插件的PluginService创建SubService，为插件的Matcher等功能入口应用SubService。（参考下文插件适配章节）
（为防止意外发生，nonebot_plugin_access_control本身不可以进行权限开关）
当某主体需要检查某服务是否可用时，将从该服务开始检查是否为该主体配置了权限，若未配置则检查其父服务，以此类推直到检查到根节点nonebot。
换句话说，当鉴权时，我们逐一对用户的所有主体**按优先级从高到低的顺序**，**按服务的节点深度从深到浅的顺序**
检查该服务及其所有祖先节点配置的权限。因此，在节点深度较浅的服务配置的高优先级的主体配置，也会覆盖在节点深度较深的服务配置的低优先级的主体配置。
通过指令可查看所有服务及子服务层级：
- `/ac service ls`：列出所有服务与子服务层级
- `/ac service ls --srv <服务>`：列出服务的子服务层级
其中`<服务>`的格式如下：
- `nonebot`：对整个NoneBot进行开关
- `<插件名>`：对整个插件进行开关
- `<插件名>.<子服务名>.<子服务名>.....<子服务名>`：对插件内的某个子服务进行开关（需参照下文对插件进行配置）
### 鉴权
通过指令可实现权限开关：
- `/ac permission allow --sbj <主体> --srv <服务>`：为主体启用服务
- `/ac permission deny --sbj <主体> --srv <服务>`：为主体禁用服务
- `/ac permission rm --sbj <主体> --srv <服务>`：为主体删除服务权限配置
- `/ac permission ls`：列出所有已配置的权限
- `/ac permission ls --sbj <主体>`：列出主体已配置的服务权限
- `/ac permission ls --srv <服务>`：列出服务已配置的主体权限
- `/ac permission ls --sbj <主体> --srv <服务>`：列出主体与服务已配置的权限
其中`<服务>`的格式同上
### 限流
插件还提供了限流的功能（限制同一用户在一定时间内的指令调用次数）。
限流规则同样是针对服务及主体的。与鉴权不同的是，限流规则是串联的。应用在一个用户拥有的所有主体的限流规则，与应用在一个服务及其所有祖先服务的限流规则，会同时对用户产生限制。
举个例子，如果我们设置了”主体`all`每天最多调用100次`nonebot`服务“，”主体`qq:g87654321`
每分钟最多调用5次`nonebot_plugin_pixivbot`服务“。一位拥有`qq:12345678`、`qq:g87654321`、`qq`、`all`
这四个主体的用户尝试调用`nonebot_plugin_pixivbot.xxx`服务时，将同时受到以上两条规则的限制。
如果我不希望这样的串联，该怎么办？通过为规则设置”覆写“属性，可以覆盖掉所有优先级低于该规则的规则。规则的优先级比较规则如下：
- 若主体优先级不一致，按照主体优先级
- 否则，按照服务的父子关系，父服务优先级低于子服务
通过指令可对限流规则进行操作：
- `/ac limit add --sbj <主体> --srv <服务> --limit <次数> --span <时间间隔> [--overwrite]`
：为主体与服务添加限流规则（`--overwrite`：为规则设置”覆写“属性）
- `/ac limit rm <规则ID>`：删除限流规则
- `/ac limit ls`：列出所有已配置的限流规则
- `/ac limit ls --sbj <主体>`：列出主体已配置的限流规则
- `/ac limit ls --srv <服务>`：列出服务已配置的限流规则
- `/ac limit ls --sbj <主体> --srv <服务>`：列出主体与服务已配置的限流规则
- `/ac limit reset`：重置限流计数
其中`<服务>`的格式同上
### 指令一览
进行控制的指令为`/ac`，仅超级用户可用。（通过在配置文件中设置`SUPERUSERS`变量可设置超级用户）
（注意：0.3.0版本对指令进行了一次大的更改）
- 帮助
- `/ac help`：显示此帮助
- 权限控制
- `/ac permission allow --sbj <主体> --srv <服务>`：为主体启用服务
- `/ac permission deny --sbj <主体> --srv <服务>`：为主体禁用服务
- `/ac permission rm --sbj <主体> --srv <服务>`：为主体删除服务权限配置
- `/ac permission ls`：列出所有已配置的权限
- `/ac permission ls --sbj <主体>`：列出主体已配置的服务权限
- `/ac permission ls --srv <服务>`：列出服务已配置的主体权限
- `/ac permission ls --sbj <主体> --srv <服务>`：列出主体与服务已配置的权限
- 流量限制
- `/ac limit add --sbj <主体> --srv <服务> --limit <次数> --span <时间间隔> [--overwrite]`：为主体与服务添加限流规则
- `/ac limit rm <规则ID>`：删除限流规则
- `/ac limit ls`：列出所有已配置的限流规则
- `/ac limit ls --sbj <主体>`：列出主体已配置的限流规则
- `/ac limit ls --srv <服务>`：列出服务已配置的限流规则
- `/ac limit ls --sbj <主体> --srv <服务>`：列出主体与服务已配置的限流规则
- `/ac limit reset`：重置限流计数
- 服务查看
- `/ac service ls`：列出所有服务与子服务层级
- `/ac service ls --srv <服务>`：列出服务的子服务层级
- 主体测试
- `/ac subject`：列出消息发送者的所有主体
其中`<服务>`的格式如下：
- `nonebot`：对整个NoneBot进行开关
- `<插件名>`：对整个插件进行开关
- `<插件名>.<子服务名>.<子服务名>.....<子服务名>`：对插件内的某个子服务进行开关（需参照下文对插件进行配置）
### 示例
首先编辑配置文件，打开对未适配插件的支持：
```
ACCESS_CONTROL_AUTO_PATCH_ENABLED=true
```
假设bot加载了内置插件echo
```python
nonebot.load_builtin_plugins("echo")
```
#### 鉴权
执行下面的指令后，QQ用户12345678将无法调用指令`/echo`
```
/ac permission deny --sbj qq:12345678 --srv echo
```
执行下面的指令后，QQ用户12345678将无法调用所有指令
```
/ac permission deny --sbj all --srv nonebot
```
执行下面的指令后，QQ群组87654321的所有用户（QQ用户12345678除外）将无法调用指令`/echo`
```
/ac permission allow --sbj qq:12345678 --srv echo
/ac permission deny --sbj qq:g87654321 --srv echo
```
执行下面的指令后，所有用户将无法调用指令`/echo`
```
/ac permission deny --sbj all --srv echo
```
#### 限流
执行下面的指令后，所有用户每天只能调用100次任意指令，且每分钟只能调用三次指令`/echo`
```
/ac limit add --sbj all --srv nonebot --span 1d --limit 100
/ac limit add --sbj all --srv echo --span 1m --limit 3
```
执行下面的指令后，QQ群组87654321的所有用户（QQ用户12345678除外）每分钟只能调用三次指令`/echo`
（QQ用户12345678每分钟能够调用114514次指令`/echo`）
```
/ac limit add --sbj qq:g87654321 --srv echo --span 1m --limit 3
/ac limit add --sbj qq:12345678 --srv echo --span 1m --limit 114514 --overwrite
```
## 插件适配
参考 [https://github.com/ssttkkl/nonebot-plugin-access-control-api/blob/v1.1.0/README.MD]
## CLI支持
可以通过控制台中执行`nb accctrl`进入权限控制台，使用方式与`/ac`指令类似。
## 配置项
### 数据库配置
参考 https://github.com/nonebot/plugin-orm#%E9%85%8D%E7%BD%AE%E9%A1%B9
### access_control_default_permission
未设置权限时的默认行为
可选值：`allow`, `deny`
默认值：`allow`
### access_control_auto_patch_enabled
是否启用对未适配插件的权限控制
类型：`bool`
默认值：`False`
### access_control_auto_patch_ignore
对指定的未适配插件将不启用权限控制
类型：`List[str]`
默认值：`[]`
### access_control_reply_on_permission_denied_enabled
因无权限而拒绝执行时，是否向用户回复消息
类型：`bool`
默认值：`False`
### access_control_reply_on_permission_denied
因无权限而拒绝执行时向用户回复的消息
类型：`str`
默认值：`"你没有权限执行该指令"`
### access_control_reply_on_rate_limited_enabled
因到达最大次数而拒绝执行时，是否向用户回复消息
类型：`bool`
默认值：`False`
### access_control_reply_on_rate_limited
因到达最大次数而拒绝执行时向用户回复的消息
类型：`str`
### access_control_rate_limit_token_storage
限流计数使用的存储方式，支持内存存储（inmemory）与数据库存储（datastore）。
内存存储会在重启后重置限流计数，数据库存储则不会。同时数据库存储还能够实现多个NoneBot实例共享限流计数，适用于分布式Bot应用。
在性能上，内存存储优于数据库存储。默认使用的是内存存储。
可选值：`inmemory`, `datastore`
默认值：`inmemory`
## Q&A
### **本插件与[nonebot_plugin_rauthman](https://github.com/Lancercmd/nonebot_plugin_rauthman)
和[nonebot-plugin-manager](https://github.com/nonepkg/nonebot-plugin-manager)等其他权限管理插件有什么差别？**
[nonebot_plugin_rauthman](https://github.com/Lancercmd/nonebot_plugin_rauthman)
支持功能级别的细粒度权限控制，但是需要插件进行适配，对于未适配插件不起作用。[nonebot-plugin-manager](https://github.com/nonepkg/nonebot-plugin-manager)
则实现了非侵入式的权限控制。
本插件主要受这两个插件的启发，结合了这两个插件的优点。既支持非侵入式应用到原有插件，也支持对插件进行适配以获得更多feature。同时提供事件订阅机制，以便插件开发者更灵活处理权限。
同时，上述两款插件均只支持OneBot V11协议，而本插件设计之初就考虑到了除OneBot V11以外的协议，具有更强的可扩展性。
## 在线乞讨
<details><summary>点击请我打两把maimai</summary>
</details>
## LICENSE
> MIT License
>
> Copyright (c) 2022 ssttkkl
>
> Permission is hereby granted, free of charge, to any person obtaining a copy
> of this software and associated documentation files (the "Software"), to deal
> in the Software without restriction, including without limitation the rights
> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
> copies of the Software, and to permit persons to whom the Software is
> furnished to do so, subject to the following conditions:
>
> The above copyright notice and this permission notice shall be included in all
> copies or substantial portions of the Software.
>
> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
> SOFTWARE.
>
Raw data
{
"_id": null,
"home_page": "https://github.com/bot-ssttkkl/nonebot-plugin-access-control",
"name": "nonebot-plugin-access-control",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": null,
"author": "ssttkkl",
"author_email": "huang.wen.long@hotmail.com",
"download_url": "https://files.pythonhosted.org/packages/2e/88/fc5e66f514f9657b7017d5c559c925cb81a5784f55b9f0e31c0c0cf8478d/nonebot_plugin_access_control-1.2.0.tar.gz",
"platform": null,
"description": "<!-- markdownlint-disable MD033 MD036 MD041 -->\n\n<p align=\"center\">\n <a href=\"https://v2.nonebot.dev/\"><img src=\"https://v2.nonebot.dev/logo.png\" width=\"200\" height=\"200\" alt=\"nonebot\"></a>\n</p>\n\n<div align=\"center\">\n\nnonebot-plugin-access-control\n============\n\n_\u2728 Nonebot \u6743\u9650\u63a7\u5236\u63d2\u4ef6 \u2728_\n\n</div>\n\n\n<p align=\"center\">\n <a href=\"https://raw.githubusercontent.com/ssttkkl/nonebot-plugin-access-control/master/LICENSE\">\n <img src=\"https://img.shields.io/github/license/ssttkkl/nonebot-plugin-access-control.svg\" alt=\"license\">\n </a>\n <a href=\"https://pypi.python.org/pypi/nonebot-plugin-access-control\">\n <img src=\"https://img.shields.io/pypi/v/nonebot-plugin-access-control.svg\" alt=\"pypi\">\n </a>\n <img src=\"https://img.shields.io/badge/python-3.9+-blue.svg\" alt=\"python\">\n</p>\n\n## \u7279\u70b9\n\n- \u529f\u80fd\n - [x] \u652f\u6301\u9488\u5bf9\u7528\u6237/\u7fa4\u7ec4\u7684\u6743\u9650\u5f00\u5173\n - [x] \u652f\u6301\u9650\u5236\u540c\u4e00\u7528\u6237\u5728\u4e00\u5b9a\u65f6\u95f4\u5185\u7684\u6307\u4ee4\u8c03\u7528\u6b21\u6570\n - [x] \u5bf9\u672a\u9002\u914d\u63d2\u4ef6\u63d0\u4f9b**\u63d2\u4ef6\u7ea7\u522b**\u7684\u63a7\u5236\u652f\u6301\n- \u63d2\u4ef6\u9002\u914d\n - [x] \u652f\u6301**\u529f\u80fd\u7ea7\u522b**\u7684\u7ec6\u7c92\u5ea6\u63a7\u5236\n - [x] \u652f\u6301\u5bf9\u6743\u9650\u5f00\u5173\u7b49\u4e8b\u4ef6\u8fdb\u884c\u8ba2\u9605\n- \u62d3\u5c55\n - [x] \u652f\u6301\u5f00\u53d1\u8005\u62d3\u5c55\u5b9a\u4e49\u65b0\u7684\u4e3b\u4f53\n- CLI\u63d2\u4ef6\n - [x] \u652f\u6301\u901a\u8fc7\u63a7\u5236\u53f0\u4e2d\u6267\u884c`nb accctrl`\u8fdb\u5165\u6743\u9650\u63a7\u5236\u53f0\n\n## \u4f7f\u7528\n\n### \u4e3b\u4f53\n\n#### \u6982\u5ff5\n\n\u5f53\u6211\u4eec\u5bf9\u7528\u6237\u8fdb\u884c\u6743\u9650\u63a7\u5236\u65f6\uff0c\u6211\u4eec\u60f3\u8981\u7684\u662f\u9488\u5bf9\u62e5\u6709\u67d0\u79cd\u540c\u6837\u8eab\u4efd\u7684\u6240\u6709\u7528\u6237\u8fdb\u884c\u914d\u7f6e\uff0c\u800c\u4e0d\u662f\u5bf9\u6bcf\u4e00\u4e2a\u5177\u4f53\u7528\u6237\u5206\u522b\u914d\u7f6e\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5f15\u5165\u4e3b\u4f53\u7684\u6982\u5ff5\u3002\n**\u4e3b\u4f53\uff08Subject\uff09\u4ee3\u8868\u4e86\u62e5\u6709\u67d0\u79cd\u540c\u6837\u8eab\u4efd\u7684\u7528\u6237\u7684\u96c6\u5408\uff0c\u4e5f\u662f\u8bbe\u7f6e\u6743\u9650\u7684\u57fa\u672c\u5355\u4f4d\u3002**\n\u5f53\u6211\u4eec\u8bf4\u7528\u6237\u5177\u6709\u67d0\u4e2a\u4e3b\u4f53\uff0c\u4e5f\u5c31\u662f\u8bf4\u7528\u6237\u5728\u8be5\u4e3b\u4f53\u6240\u4ee3\u8868\u7684\u96c6\u5408\u5185\u3002\u6362\u53e5\u8bdd\u8bf4\uff0c\u4e3b\u4f53\u5c31\u662f\u4e00\u4e2a\u7528\u6237\u6240\u5177\u6709\u7684\u8eab\u4efd\u3002\n\n\u4e00\u4e2a\u7528\u6237\u901a\u5e38\u62e5\u6709\u591a\u4e2a\u4e3b\u4f53\u3002\u4e3e\u4e2a\u4f8b\u5b50\uff1aQQ\u4e0a\u7fa4\u7ec4G\u7684\u7528\u6237U\u53d1\u9001\u4e86\u4e00\u6761\u6d88\u606f\uff0c\u8be5\u7528\u6237\u540c\u65f6\u5177\u6709\u201c\u7528\u6237U\u201d\u3001\u201c\u7fa4\u7ec4G\u6210\u5458\u201d\u3001\u201cQQ\u7528\u6237\u201d\u3001\u201cBot\u7528\u6237\u201d\u8fd9\u51e0\u4e2a\u4e3b\u4f53\u3002\u540c\u65f6QQ\u4e0a\u7fa4\u7ec4G\u7684\u7528\u6237V\u4e5f\u53d1\u9001\u4e86\u4e00\u6761\u6d88\u606f\uff0c\u8be5\u7528\u6237\u8be5\u7528\u6237\u540c\u65f6\u5177\u6709\u201c\u7528\u6237V\u201d\u3001\u201c\u7fa4\u7ec4G\u6210\u5458\u201d\u3001\u201cQQ\u7528\u6237\u201d\u3001\u201cBot\u7528\u6237\u201d\u8fd9\u51e0\u4e2a\u4e3b\u4f53\u3002\n\n\u5f53\u8bbe\u7f6e\u6743\u9650\u65f6\uff0c\u6211\u4eec\u76f4\u63a5\u9488\u5bf9\u4e00\u4e2a\u4e3b\u4f53\u8fdb\u884c\u8bbe\u7f6e\u3002\u5f53\u9274\u6743\u65f6\uff0c\u6211\u4eec\u5bf9\u7528\u6237\u7684\u6240\u6709\u4e3b\u4f53**\u6309\u4f18\u5148\u7ea7\u4ece\u9ad8\u5230\u4f4e\u7684\u987a\u5e8f**\n\uff0c\u9010\u4e00\u68c0\u67e5\u662f\u5426\u8bbe\u7f6e\u4e86\u6743\u9650\u3002\u4e00\u65e6\u68c0\u67e5\u5230\u67d0\u4e2a\u4e3b\u4f53\u8bbe\u7f6e\u4e86\u6743\u9650\uff0c\u5c31\u4ee5\u8be5\u4e3b\u4f53\u8bbe\u7f6e\u7684\u6743\u9650\u4f5c\u4e3a\u8be5\u7528\u6237\u7684\u6743\u9650\u3002\n\n\u56de\u5230\u4e0a\u9762\u7684\u4f8b\u5b50\uff0c\u5047\u8bbe\u6211\u4eec\u5bf9\u4e3b\u4f53\u201d\u7fa4\u7ec4G\u201c\u7981\u7528\u670d\u52a1\uff0c\u4f46\u662f\u5bf9\u4e3b\u4f53\u201d\u7528\u6237V\u201c\u542f\u7528\u670d\u52a1\u3002\u5219\u7528\u6237U\u5728\u7fa4\u7ec4G\u5185\u5c06\u65e0\u6cd5\u4f7f\u7528\u670d\u52a1\uff0c\u4f46\u662f\u7528\u6237V\u5728\u7fa4\u7ec4G\u5185\u53ef\u4ee5\u4f7f\u7528\u3002\n\n\u5728\u63d2\u4ef6\u4f7f\u7528\u4e2d\uff0c\u6211\u4eec\u7528\u4e00\u4e2a\u5b57\u7b26\u4e32\u8868\u793a\u4e3b\u4f53\uff0c\u4f8b\u5982`qq:12345678`\u8868\u793aQQ\u7528\u623712345678\u3001`qq:g87654321`\u8868\u793aQQ\u7fa4\u7ec487654321\u3002\n\n\u6211\u4eec\u7ea6\u5b9a\uff1a`all`\u8868\u793a\u6240\u6709\u7528\u6237\u3001`superuser`\u8868\u793a\u8d85\u7ea7\u7528\u6237\u3001`<\u5e73\u53f0\u540d>`\u8868\u793a\u6240\u6709\u6b64\u5e73\u53f0\u7684\u7528\u6237\u3001`<\u534f\u8bae\u540d>`\n\u8868\u793a\u6240\u6709\u6b64\u534f\u8bae\u7684\u7528\u6237\u3001\u6240\u6709\u4e0e\u5e73\u53f0\u76f8\u5173\u7684\u4e3b\u4f53\u5747\u4ee5`<\u5e73\u53f0\u540d>:`\u5f00\u5934\u3001\u6240\u6709\u4e0e\u534f\u8bae\u76f8\u5173\u7684\u4e3b\u4f53\u5747\u4ee5`<\u534f\u8bae\u540d>:`\u5f00\u5934\u3002\n\n\u63d2\u4ef6\u4f9d\u8d56[nonebot-plugin-session](https://github.com/noneplugin/nonebot-plugin-session)\u63d0\u53d6\u4e8b\u4ef6\u7684\u4e3b\u4f53\uff0c\u5404\u9002\u914d\u5668\u7684\u4e3b\u4f53\u5b9a\u4e49\u5982\u4e0b\uff1a\n\n- [OneBot V11](docs/onebot_v11.md)\n- [OneBot V12](docs/onebot_v12.md)\n- [Kaiheila](docs/kaiheila.md)\n- [QQ Guild](docs/qqguild.md)\n- Telegram\uff1a\u672a\u6d4b\u8bd5\uff0c\u53c2\u8003OneBot V12\u7684\u5b9a\u4e49\n\n### \u670d\u52a1\n\n**\u670d\u52a1\uff08Service\uff09\u4e3a\u4e00\u7ec4\u80fd\u591f\u8fdb\u884c\u6743\u9650\u63a7\u5236\u7684\u529f\u80fd\u7684\u96c6\u5408\u3002** \u670d\u52a1\u53ef\u4ee5\u62e5\u6709\u5b50\u670d\u52a1\uff0c\u901a\u8fc7\u6811\u5f62\u7ed3\u6784\u7ec4\u7ec7\u670d\u52a1\uff0c\u7edf\u4e00\u7ba1\u7406\u6743\u9650\u3002\n\n\u6574\u4e2aNoneBot\u662f\u4e00\u4e2a\u540d\u4e3anonebot\u7684\u670d\u52a1\uff0c\u4e3a\u6811\u5f62\u7ed3\u6784\u7684\u6839\u8282\u70b9\uff0c\u5176\u76f4\u63a5\u5b50\u8282\u70b9\u4e3a\u6240\u6709\u63d2\u4ef6\u3002\n\n\u4e00\u4e2a\u63d2\u4ef6\u662f\u4e00\u4e2a\u670d\u52a1\uff08PluginService\uff09\uff0c\u5176\u7236\u8282\u70b9\u4e3anonebot\u3002\u5f53\u63d2\u4ef6\u672a\u8fdb\u884c\u9002\u914d\u65f6\uff0c\u8be5\u63d2\u4ef6\u53ea\u5177\u6709\u8fd9\u4e00\u4e2aPluginService\u3002\u5bf9\u63d2\u4ef6\u8fdb\u884c\u9002\u914d\uff0c\u5219\u9700\u8981\u4ece\u63d2\u4ef6\u7684PluginService\u521b\u5efaSubService\uff0c\u4e3a\u63d2\u4ef6\u7684Matcher\u7b49\u529f\u80fd\u5165\u53e3\u5e94\u7528SubService\u3002\uff08\u53c2\u8003\u4e0b\u6587\u63d2\u4ef6\u9002\u914d\u7ae0\u8282\uff09\n\n\uff08\u4e3a\u9632\u6b62\u610f\u5916\u53d1\u751f\uff0cnonebot_plugin_access_control\u672c\u8eab\u4e0d\u53ef\u4ee5\u8fdb\u884c\u6743\u9650\u5f00\u5173\uff09\n\n\u5f53\u67d0\u4e3b\u4f53\u9700\u8981\u68c0\u67e5\u67d0\u670d\u52a1\u662f\u5426\u53ef\u7528\u65f6\uff0c\u5c06\u4ece\u8be5\u670d\u52a1\u5f00\u59cb\u68c0\u67e5\u662f\u5426\u4e3a\u8be5\u4e3b\u4f53\u914d\u7f6e\u4e86\u6743\u9650\uff0c\u82e5\u672a\u914d\u7f6e\u5219\u68c0\u67e5\u5176\u7236\u670d\u52a1\uff0c\u4ee5\u6b64\u7c7b\u63a8\u76f4\u5230\u68c0\u67e5\u5230\u6839\u8282\u70b9nonebot\u3002\n\n\u6362\u53e5\u8bdd\u8bf4\uff0c\u5f53\u9274\u6743\u65f6\uff0c\u6211\u4eec\u9010\u4e00\u5bf9\u7528\u6237\u7684\u6240\u6709\u4e3b\u4f53**\u6309\u4f18\u5148\u7ea7\u4ece\u9ad8\u5230\u4f4e\u7684\u987a\u5e8f**\uff0c**\u6309\u670d\u52a1\u7684\u8282\u70b9\u6df1\u5ea6\u4ece\u6df1\u5230\u6d45\u7684\u987a\u5e8f**\n\u68c0\u67e5\u8be5\u670d\u52a1\u53ca\u5176\u6240\u6709\u7956\u5148\u8282\u70b9\u914d\u7f6e\u7684\u6743\u9650\u3002\u56e0\u6b64\uff0c\u5728\u8282\u70b9\u6df1\u5ea6\u8f83\u6d45\u7684\u670d\u52a1\u914d\u7f6e\u7684\u9ad8\u4f18\u5148\u7ea7\u7684\u4e3b\u4f53\u914d\u7f6e\uff0c\u4e5f\u4f1a\u8986\u76d6\u5728\u8282\u70b9\u6df1\u5ea6\u8f83\u6df1\u7684\u670d\u52a1\u914d\u7f6e\u7684\u4f4e\u4f18\u5148\u7ea7\u7684\u4e3b\u4f53\u914d\u7f6e\u3002\n\n\u901a\u8fc7\u6307\u4ee4\u53ef\u67e5\u770b\u6240\u6709\u670d\u52a1\u53ca\u5b50\u670d\u52a1\u5c42\u7ea7\uff1a\n\n- `/ac service ls`\uff1a\u5217\u51fa\u6240\u6709\u670d\u52a1\u4e0e\u5b50\u670d\u52a1\u5c42\u7ea7\n- `/ac service ls --srv <\u670d\u52a1>`\uff1a\u5217\u51fa\u670d\u52a1\u7684\u5b50\u670d\u52a1\u5c42\u7ea7\n\n\u5176\u4e2d`<\u670d\u52a1>`\u7684\u683c\u5f0f\u5982\u4e0b\uff1a\n\n- `nonebot`\uff1a\u5bf9\u6574\u4e2aNoneBot\u8fdb\u884c\u5f00\u5173\n- `<\u63d2\u4ef6\u540d>`\uff1a\u5bf9\u6574\u4e2a\u63d2\u4ef6\u8fdb\u884c\u5f00\u5173\n- `<\u63d2\u4ef6\u540d>.<\u5b50\u670d\u52a1\u540d>.<\u5b50\u670d\u52a1\u540d>.....<\u5b50\u670d\u52a1\u540d>`\uff1a\u5bf9\u63d2\u4ef6\u5185\u7684\u67d0\u4e2a\u5b50\u670d\u52a1\u8fdb\u884c\u5f00\u5173\uff08\u9700\u53c2\u7167\u4e0b\u6587\u5bf9\u63d2\u4ef6\u8fdb\u884c\u914d\u7f6e\uff09\n\n### \u9274\u6743\n\n\u901a\u8fc7\u6307\u4ee4\u53ef\u5b9e\u73b0\u6743\u9650\u5f00\u5173\uff1a\n\n- `/ac permission allow --sbj <\u4e3b\u4f53> --srv <\u670d\u52a1>`\uff1a\u4e3a\u4e3b\u4f53\u542f\u7528\u670d\u52a1\n- `/ac permission deny --sbj <\u4e3b\u4f53> --srv <\u670d\u52a1>`\uff1a\u4e3a\u4e3b\u4f53\u7981\u7528\u670d\u52a1\n- `/ac permission rm --sbj <\u4e3b\u4f53> --srv <\u670d\u52a1>`\uff1a\u4e3a\u4e3b\u4f53\u5220\u9664\u670d\u52a1\u6743\u9650\u914d\u7f6e\n- `/ac permission ls`\uff1a\u5217\u51fa\u6240\u6709\u5df2\u914d\u7f6e\u7684\u6743\u9650\n- `/ac permission ls --sbj <\u4e3b\u4f53>`\uff1a\u5217\u51fa\u4e3b\u4f53\u5df2\u914d\u7f6e\u7684\u670d\u52a1\u6743\u9650\n- `/ac permission ls --srv <\u670d\u52a1>`\uff1a\u5217\u51fa\u670d\u52a1\u5df2\u914d\u7f6e\u7684\u4e3b\u4f53\u6743\u9650\n- `/ac permission ls --sbj <\u4e3b\u4f53> --srv <\u670d\u52a1>`\uff1a\u5217\u51fa\u4e3b\u4f53\u4e0e\u670d\u52a1\u5df2\u914d\u7f6e\u7684\u6743\u9650\n\n\u5176\u4e2d`<\u670d\u52a1>`\u7684\u683c\u5f0f\u540c\u4e0a\n\n### \u9650\u6d41\n\n\u63d2\u4ef6\u8fd8\u63d0\u4f9b\u4e86\u9650\u6d41\u7684\u529f\u80fd\uff08\u9650\u5236\u540c\u4e00\u7528\u6237\u5728\u4e00\u5b9a\u65f6\u95f4\u5185\u7684\u6307\u4ee4\u8c03\u7528\u6b21\u6570\uff09\u3002\n\n\u9650\u6d41\u89c4\u5219\u540c\u6837\u662f\u9488\u5bf9\u670d\u52a1\u53ca\u4e3b\u4f53\u7684\u3002\u4e0e\u9274\u6743\u4e0d\u540c\u7684\u662f\uff0c\u9650\u6d41\u89c4\u5219\u662f\u4e32\u8054\u7684\u3002\u5e94\u7528\u5728\u4e00\u4e2a\u7528\u6237\u62e5\u6709\u7684\u6240\u6709\u4e3b\u4f53\u7684\u9650\u6d41\u89c4\u5219\uff0c\u4e0e\u5e94\u7528\u5728\u4e00\u4e2a\u670d\u52a1\u53ca\u5176\u6240\u6709\u7956\u5148\u670d\u52a1\u7684\u9650\u6d41\u89c4\u5219\uff0c\u4f1a\u540c\u65f6\u5bf9\u7528\u6237\u4ea7\u751f\u9650\u5236\u3002\n\n\u4e3e\u4e2a\u4f8b\u5b50\uff0c\u5982\u679c\u6211\u4eec\u8bbe\u7f6e\u4e86\u201d\u4e3b\u4f53`all`\u6bcf\u5929\u6700\u591a\u8c03\u7528100\u6b21`nonebot`\u670d\u52a1\u201c\uff0c\u201d\u4e3b\u4f53`qq:g87654321`\n\u6bcf\u5206\u949f\u6700\u591a\u8c03\u75285\u6b21`nonebot_plugin_pixivbot`\u670d\u52a1\u201c\u3002\u4e00\u4f4d\u62e5\u6709`qq:12345678`\u3001`qq:g87654321`\u3001`qq`\u3001`all`\n\u8fd9\u56db\u4e2a\u4e3b\u4f53\u7684\u7528\u6237\u5c1d\u8bd5\u8c03\u7528`nonebot_plugin_pixivbot.xxx`\u670d\u52a1\u65f6\uff0c\u5c06\u540c\u65f6\u53d7\u5230\u4ee5\u4e0a\u4e24\u6761\u89c4\u5219\u7684\u9650\u5236\u3002\n\n\u5982\u679c\u6211\u4e0d\u5e0c\u671b\u8fd9\u6837\u7684\u4e32\u8054\uff0c\u8be5\u600e\u4e48\u529e\uff1f\u901a\u8fc7\u4e3a\u89c4\u5219\u8bbe\u7f6e\u201d\u8986\u5199\u201c\u5c5e\u6027\uff0c\u53ef\u4ee5\u8986\u76d6\u6389\u6240\u6709\u4f18\u5148\u7ea7\u4f4e\u4e8e\u8be5\u89c4\u5219\u7684\u89c4\u5219\u3002\u89c4\u5219\u7684\u4f18\u5148\u7ea7\u6bd4\u8f83\u89c4\u5219\u5982\u4e0b\uff1a\n\n- \u82e5\u4e3b\u4f53\u4f18\u5148\u7ea7\u4e0d\u4e00\u81f4\uff0c\u6309\u7167\u4e3b\u4f53\u4f18\u5148\u7ea7\n- \u5426\u5219\uff0c\u6309\u7167\u670d\u52a1\u7684\u7236\u5b50\u5173\u7cfb\uff0c\u7236\u670d\u52a1\u4f18\u5148\u7ea7\u4f4e\u4e8e\u5b50\u670d\u52a1\n\n\u901a\u8fc7\u6307\u4ee4\u53ef\u5bf9\u9650\u6d41\u89c4\u5219\u8fdb\u884c\u64cd\u4f5c\uff1a\n\n- `/ac limit add --sbj <\u4e3b\u4f53> --srv <\u670d\u52a1> --limit <\u6b21\u6570> --span <\u65f6\u95f4\u95f4\u9694> [--overwrite]`\n \uff1a\u4e3a\u4e3b\u4f53\u4e0e\u670d\u52a1\u6dfb\u52a0\u9650\u6d41\u89c4\u5219\uff08`--overwrite`\uff1a\u4e3a\u89c4\u5219\u8bbe\u7f6e\u201d\u8986\u5199\u201c\u5c5e\u6027\uff09\n- `/ac limit rm <\u89c4\u5219ID>`\uff1a\u5220\u9664\u9650\u6d41\u89c4\u5219\n- `/ac limit ls`\uff1a\u5217\u51fa\u6240\u6709\u5df2\u914d\u7f6e\u7684\u9650\u6d41\u89c4\u5219\n- `/ac limit ls --sbj <\u4e3b\u4f53>`\uff1a\u5217\u51fa\u4e3b\u4f53\u5df2\u914d\u7f6e\u7684\u9650\u6d41\u89c4\u5219\n- `/ac limit ls --srv <\u670d\u52a1>`\uff1a\u5217\u51fa\u670d\u52a1\u5df2\u914d\u7f6e\u7684\u9650\u6d41\u89c4\u5219\n- `/ac limit ls --sbj <\u4e3b\u4f53> --srv <\u670d\u52a1>`\uff1a\u5217\u51fa\u4e3b\u4f53\u4e0e\u670d\u52a1\u5df2\u914d\u7f6e\u7684\u9650\u6d41\u89c4\u5219\n- `/ac limit reset`\uff1a\u91cd\u7f6e\u9650\u6d41\u8ba1\u6570\n\n\u5176\u4e2d`<\u670d\u52a1>`\u7684\u683c\u5f0f\u540c\u4e0a\n\n### \u6307\u4ee4\u4e00\u89c8\n\n\u8fdb\u884c\u63a7\u5236\u7684\u6307\u4ee4\u4e3a`/ac`\uff0c\u4ec5\u8d85\u7ea7\u7528\u6237\u53ef\u7528\u3002\uff08\u901a\u8fc7\u5728\u914d\u7f6e\u6587\u4ef6\u4e2d\u8bbe\u7f6e`SUPERUSERS`\u53d8\u91cf\u53ef\u8bbe\u7f6e\u8d85\u7ea7\u7528\u6237\uff09\n\n\uff08\u6ce8\u610f\uff1a0.3.0\u7248\u672c\u5bf9\u6307\u4ee4\u8fdb\u884c\u4e86\u4e00\u6b21\u5927\u7684\u66f4\u6539\uff09\n\n- \u5e2e\u52a9\n - `/ac help`\uff1a\u663e\u793a\u6b64\u5e2e\u52a9\n- \u6743\u9650\u63a7\u5236\n - `/ac permission allow --sbj <\u4e3b\u4f53> --srv <\u670d\u52a1>`\uff1a\u4e3a\u4e3b\u4f53\u542f\u7528\u670d\u52a1\n - `/ac permission deny --sbj <\u4e3b\u4f53> --srv <\u670d\u52a1>`\uff1a\u4e3a\u4e3b\u4f53\u7981\u7528\u670d\u52a1\n - `/ac permission rm --sbj <\u4e3b\u4f53> --srv <\u670d\u52a1>`\uff1a\u4e3a\u4e3b\u4f53\u5220\u9664\u670d\u52a1\u6743\u9650\u914d\u7f6e\n - `/ac permission ls`\uff1a\u5217\u51fa\u6240\u6709\u5df2\u914d\u7f6e\u7684\u6743\u9650\n - `/ac permission ls --sbj <\u4e3b\u4f53>`\uff1a\u5217\u51fa\u4e3b\u4f53\u5df2\u914d\u7f6e\u7684\u670d\u52a1\u6743\u9650\n - `/ac permission ls --srv <\u670d\u52a1>`\uff1a\u5217\u51fa\u670d\u52a1\u5df2\u914d\u7f6e\u7684\u4e3b\u4f53\u6743\u9650\n - `/ac permission ls --sbj <\u4e3b\u4f53> --srv <\u670d\u52a1>`\uff1a\u5217\u51fa\u4e3b\u4f53\u4e0e\u670d\u52a1\u5df2\u914d\u7f6e\u7684\u6743\u9650\n- \u6d41\u91cf\u9650\u5236\n - `/ac limit add --sbj <\u4e3b\u4f53> --srv <\u670d\u52a1> --limit <\u6b21\u6570> --span <\u65f6\u95f4\u95f4\u9694> [--overwrite]`\uff1a\u4e3a\u4e3b\u4f53\u4e0e\u670d\u52a1\u6dfb\u52a0\u9650\u6d41\u89c4\u5219\n - `/ac limit rm <\u89c4\u5219ID>`\uff1a\u5220\u9664\u9650\u6d41\u89c4\u5219\n - `/ac limit ls`\uff1a\u5217\u51fa\u6240\u6709\u5df2\u914d\u7f6e\u7684\u9650\u6d41\u89c4\u5219\n - `/ac limit ls --sbj <\u4e3b\u4f53>`\uff1a\u5217\u51fa\u4e3b\u4f53\u5df2\u914d\u7f6e\u7684\u9650\u6d41\u89c4\u5219\n - `/ac limit ls --srv <\u670d\u52a1>`\uff1a\u5217\u51fa\u670d\u52a1\u5df2\u914d\u7f6e\u7684\u9650\u6d41\u89c4\u5219\n - `/ac limit ls --sbj <\u4e3b\u4f53> --srv <\u670d\u52a1>`\uff1a\u5217\u51fa\u4e3b\u4f53\u4e0e\u670d\u52a1\u5df2\u914d\u7f6e\u7684\u9650\u6d41\u89c4\u5219\n - `/ac limit reset`\uff1a\u91cd\u7f6e\u9650\u6d41\u8ba1\u6570\n- \u670d\u52a1\u67e5\u770b\n - `/ac service ls`\uff1a\u5217\u51fa\u6240\u6709\u670d\u52a1\u4e0e\u5b50\u670d\u52a1\u5c42\u7ea7\n - `/ac service ls --srv <\u670d\u52a1>`\uff1a\u5217\u51fa\u670d\u52a1\u7684\u5b50\u670d\u52a1\u5c42\u7ea7\n- \u4e3b\u4f53\u6d4b\u8bd5\n - `/ac subject`\uff1a\u5217\u51fa\u6d88\u606f\u53d1\u9001\u8005\u7684\u6240\u6709\u4e3b\u4f53\n\n\u5176\u4e2d`<\u670d\u52a1>`\u7684\u683c\u5f0f\u5982\u4e0b\uff1a\n\n- `nonebot`\uff1a\u5bf9\u6574\u4e2aNoneBot\u8fdb\u884c\u5f00\u5173\n- `<\u63d2\u4ef6\u540d>`\uff1a\u5bf9\u6574\u4e2a\u63d2\u4ef6\u8fdb\u884c\u5f00\u5173\n- `<\u63d2\u4ef6\u540d>.<\u5b50\u670d\u52a1\u540d>.<\u5b50\u670d\u52a1\u540d>.....<\u5b50\u670d\u52a1\u540d>`\uff1a\u5bf9\u63d2\u4ef6\u5185\u7684\u67d0\u4e2a\u5b50\u670d\u52a1\u8fdb\u884c\u5f00\u5173\uff08\u9700\u53c2\u7167\u4e0b\u6587\u5bf9\u63d2\u4ef6\u8fdb\u884c\u914d\u7f6e\uff09\n\n### \u793a\u4f8b\n\n\u9996\u5148\u7f16\u8f91\u914d\u7f6e\u6587\u4ef6\uff0c\u6253\u5f00\u5bf9\u672a\u9002\u914d\u63d2\u4ef6\u7684\u652f\u6301\uff1a\n\n```\nACCESS_CONTROL_AUTO_PATCH_ENABLED=true\n```\n\n\u5047\u8bbebot\u52a0\u8f7d\u4e86\u5185\u7f6e\u63d2\u4ef6echo\n\n```python\nnonebot.load_builtin_plugins(\"echo\")\n```\n\n#### \u9274\u6743\n\n\u6267\u884c\u4e0b\u9762\u7684\u6307\u4ee4\u540e\uff0cQQ\u7528\u623712345678\u5c06\u65e0\u6cd5\u8c03\u7528\u6307\u4ee4`/echo`\n\n```\n/ac permission deny --sbj qq:12345678 --srv echo\n```\n\n\u6267\u884c\u4e0b\u9762\u7684\u6307\u4ee4\u540e\uff0cQQ\u7528\u623712345678\u5c06\u65e0\u6cd5\u8c03\u7528\u6240\u6709\u6307\u4ee4\n\n```\n/ac permission deny --sbj all --srv nonebot\n```\n\n\u6267\u884c\u4e0b\u9762\u7684\u6307\u4ee4\u540e\uff0cQQ\u7fa4\u7ec487654321\u7684\u6240\u6709\u7528\u6237\uff08QQ\u7528\u623712345678\u9664\u5916\uff09\u5c06\u65e0\u6cd5\u8c03\u7528\u6307\u4ee4`/echo`\n\n```\n/ac permission allow --sbj qq:12345678 --srv echo\n/ac permission deny --sbj qq:g87654321 --srv echo\n```\n\n\u6267\u884c\u4e0b\u9762\u7684\u6307\u4ee4\u540e\uff0c\u6240\u6709\u7528\u6237\u5c06\u65e0\u6cd5\u8c03\u7528\u6307\u4ee4`/echo`\n\n```\n/ac permission deny --sbj all --srv echo\n```\n\n#### \u9650\u6d41\n\n\u6267\u884c\u4e0b\u9762\u7684\u6307\u4ee4\u540e\uff0c\u6240\u6709\u7528\u6237\u6bcf\u5929\u53ea\u80fd\u8c03\u7528100\u6b21\u4efb\u610f\u6307\u4ee4\uff0c\u4e14\u6bcf\u5206\u949f\u53ea\u80fd\u8c03\u7528\u4e09\u6b21\u6307\u4ee4`/echo`\n\n```\n/ac limit add --sbj all --srv nonebot --span 1d --limit 100\n/ac limit add --sbj all --srv echo --span 1m --limit 3\n```\n\n\u6267\u884c\u4e0b\u9762\u7684\u6307\u4ee4\u540e\uff0cQQ\u7fa4\u7ec487654321\u7684\u6240\u6709\u7528\u6237\uff08QQ\u7528\u623712345678\u9664\u5916\uff09\u6bcf\u5206\u949f\u53ea\u80fd\u8c03\u7528\u4e09\u6b21\u6307\u4ee4`/echo`\n\n\uff08QQ\u7528\u623712345678\u6bcf\u5206\u949f\u80fd\u591f\u8c03\u7528114514\u6b21\u6307\u4ee4`/echo`\uff09\n\n```\n/ac limit add --sbj qq:g87654321 --srv echo --span 1m --limit 3\n/ac limit add --sbj qq:12345678 --srv echo --span 1m --limit 114514 --overwrite\n```\n\n## \u63d2\u4ef6\u9002\u914d\n\n\u53c2\u8003 [https://github.com/ssttkkl/nonebot-plugin-access-control-api/blob/v1.1.0/README.MD]\n\n## CLI\u652f\u6301\n\n\u53ef\u4ee5\u901a\u8fc7\u63a7\u5236\u53f0\u4e2d\u6267\u884c`nb accctrl`\u8fdb\u5165\u6743\u9650\u63a7\u5236\u53f0\uff0c\u4f7f\u7528\u65b9\u5f0f\u4e0e`/ac`\u6307\u4ee4\u7c7b\u4f3c\u3002\n\n## \u914d\u7f6e\u9879\n\n### \u6570\u636e\u5e93\u914d\u7f6e\n\n\u53c2\u8003 https://github.com/nonebot/plugin-orm#%E9%85%8D%E7%BD%AE%E9%A1%B9\n\n### access_control_default_permission\n\n\u672a\u8bbe\u7f6e\u6743\u9650\u65f6\u7684\u9ed8\u8ba4\u884c\u4e3a\n\n\u53ef\u9009\u503c\uff1a`allow`, `deny`\n\n\u9ed8\u8ba4\u503c\uff1a`allow`\n\n### access_control_auto_patch_enabled\n\n\u662f\u5426\u542f\u7528\u5bf9\u672a\u9002\u914d\u63d2\u4ef6\u7684\u6743\u9650\u63a7\u5236\n\n\u7c7b\u578b\uff1a`bool`\n\n\u9ed8\u8ba4\u503c\uff1a`False`\n\n### access_control_auto_patch_ignore\n\n\u5bf9\u6307\u5b9a\u7684\u672a\u9002\u914d\u63d2\u4ef6\u5c06\u4e0d\u542f\u7528\u6743\u9650\u63a7\u5236\n\n\u7c7b\u578b\uff1a`List[str]`\n\n\u9ed8\u8ba4\u503c\uff1a`[]`\n\n### access_control_reply_on_permission_denied_enabled\n\n\u56e0\u65e0\u6743\u9650\u800c\u62d2\u7edd\u6267\u884c\u65f6\uff0c\u662f\u5426\u5411\u7528\u6237\u56de\u590d\u6d88\u606f\n\n\u7c7b\u578b\uff1a`bool`\n\n\u9ed8\u8ba4\u503c\uff1a`False`\n\n### access_control_reply_on_permission_denied\n\n\u56e0\u65e0\u6743\u9650\u800c\u62d2\u7edd\u6267\u884c\u65f6\u5411\u7528\u6237\u56de\u590d\u7684\u6d88\u606f\n\n\u7c7b\u578b\uff1a`str`\n\n\u9ed8\u8ba4\u503c\uff1a`\"\u4f60\u6ca1\u6709\u6743\u9650\u6267\u884c\u8be5\u6307\u4ee4\"`\n\n### access_control_reply_on_rate_limited_enabled\n\n\u56e0\u5230\u8fbe\u6700\u5927\u6b21\u6570\u800c\u62d2\u7edd\u6267\u884c\u65f6\uff0c\u662f\u5426\u5411\u7528\u6237\u56de\u590d\u6d88\u606f\n\n\u7c7b\u578b\uff1a`bool`\n\n\u9ed8\u8ba4\u503c\uff1a`False`\n\n### access_control_reply_on_rate_limited\n\n\u56e0\u5230\u8fbe\u6700\u5927\u6b21\u6570\u800c\u62d2\u7edd\u6267\u884c\u65f6\u5411\u7528\u6237\u56de\u590d\u7684\u6d88\u606f\n\n\u7c7b\u578b\uff1a`str`\n\n### access_control_rate_limit_token_storage\n\n\u9650\u6d41\u8ba1\u6570\u4f7f\u7528\u7684\u5b58\u50a8\u65b9\u5f0f\uff0c\u652f\u6301\u5185\u5b58\u5b58\u50a8\uff08inmemory\uff09\u4e0e\u6570\u636e\u5e93\u5b58\u50a8\uff08datastore\uff09\u3002\n\n\u5185\u5b58\u5b58\u50a8\u4f1a\u5728\u91cd\u542f\u540e\u91cd\u7f6e\u9650\u6d41\u8ba1\u6570\uff0c\u6570\u636e\u5e93\u5b58\u50a8\u5219\u4e0d\u4f1a\u3002\u540c\u65f6\u6570\u636e\u5e93\u5b58\u50a8\u8fd8\u80fd\u591f\u5b9e\u73b0\u591a\u4e2aNoneBot\u5b9e\u4f8b\u5171\u4eab\u9650\u6d41\u8ba1\u6570\uff0c\u9002\u7528\u4e8e\u5206\u5e03\u5f0fBot\u5e94\u7528\u3002\n\n\u5728\u6027\u80fd\u4e0a\uff0c\u5185\u5b58\u5b58\u50a8\u4f18\u4e8e\u6570\u636e\u5e93\u5b58\u50a8\u3002\u9ed8\u8ba4\u4f7f\u7528\u7684\u662f\u5185\u5b58\u5b58\u50a8\u3002\n\n\u53ef\u9009\u503c\uff1a`inmemory`, `datastore`\n\n\u9ed8\u8ba4\u503c\uff1a`inmemory`\n\n## Q&A\n\n### **\u672c\u63d2\u4ef6\u4e0e[nonebot_plugin_rauthman](https://github.com/Lancercmd/nonebot_plugin_rauthman)\n\n\u548c[nonebot-plugin-manager](https://github.com/nonepkg/nonebot-plugin-manager)\u7b49\u5176\u4ed6\u6743\u9650\u7ba1\u7406\u63d2\u4ef6\u6709\u4ec0\u4e48\u5dee\u522b\uff1f**\n\n[nonebot_plugin_rauthman](https://github.com/Lancercmd/nonebot_plugin_rauthman)\n\u652f\u6301\u529f\u80fd\u7ea7\u522b\u7684\u7ec6\u7c92\u5ea6\u6743\u9650\u63a7\u5236\uff0c\u4f46\u662f\u9700\u8981\u63d2\u4ef6\u8fdb\u884c\u9002\u914d\uff0c\u5bf9\u4e8e\u672a\u9002\u914d\u63d2\u4ef6\u4e0d\u8d77\u4f5c\u7528\u3002[nonebot-plugin-manager](https://github.com/nonepkg/nonebot-plugin-manager)\n\u5219\u5b9e\u73b0\u4e86\u975e\u4fb5\u5165\u5f0f\u7684\u6743\u9650\u63a7\u5236\u3002\n\n\u672c\u63d2\u4ef6\u4e3b\u8981\u53d7\u8fd9\u4e24\u4e2a\u63d2\u4ef6\u7684\u542f\u53d1\uff0c\u7ed3\u5408\u4e86\u8fd9\u4e24\u4e2a\u63d2\u4ef6\u7684\u4f18\u70b9\u3002\u65e2\u652f\u6301\u975e\u4fb5\u5165\u5f0f\u5e94\u7528\u5230\u539f\u6709\u63d2\u4ef6\uff0c\u4e5f\u652f\u6301\u5bf9\u63d2\u4ef6\u8fdb\u884c\u9002\u914d\u4ee5\u83b7\u5f97\u66f4\u591afeature\u3002\u540c\u65f6\u63d0\u4f9b\u4e8b\u4ef6\u8ba2\u9605\u673a\u5236\uff0c\u4ee5\u4fbf\u63d2\u4ef6\u5f00\u53d1\u8005\u66f4\u7075\u6d3b\u5904\u7406\u6743\u9650\u3002\n\n\u540c\u65f6\uff0c\u4e0a\u8ff0\u4e24\u6b3e\u63d2\u4ef6\u5747\u53ea\u652f\u6301OneBot V11\u534f\u8bae\uff0c\u800c\u672c\u63d2\u4ef6\u8bbe\u8ba1\u4e4b\u521d\u5c31\u8003\u8651\u5230\u4e86\u9664OneBot V11\u4ee5\u5916\u7684\u534f\u8bae\uff0c\u5177\u6709\u66f4\u5f3a\u7684\u53ef\u6269\u5c55\u6027\u3002\n\n## \u5728\u7ebf\u4e5e\u8ba8\n\n<details><summary>\u70b9\u51fb\u8bf7\u6211\u6253\u4e24\u628amaimai</summary>\n\n\n\n</details>\n\n## LICENSE\n\n> MIT License\n>\n> Copyright (c) 2022 ssttkkl\n>\n> Permission is hereby granted, free of charge, to any person obtaining a copy\n> of this software and associated documentation files (the \"Software\"), to deal\n> in the Software without restriction, including without limitation the rights\n> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n> copies of the Software, and to permit persons to whom the Software is\n> furnished to do so, subject to the following conditions:\n>\n> The above copyright notice and this permission notice shall be included in all\n> copies or substantial portions of the Software.\n>\n> THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n> SOFTWARE.\n> \n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": null,
"version": "1.2.0",
"project_urls": {
"Homepage": "https://github.com/bot-ssttkkl/nonebot-plugin-access-control",
"Repository": "https://github.com/bot-ssttkkl/nonebot-plugin-access-control"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a8d914cab5548cac182b00c6368829010a0afa0785dc154b8be9c951810d17fc",
"md5": "eb271bfa2a00ca73c276c0f18f0ec729",
"sha256": "97a12c4168c3b38ef227d796ebb0f2f3ac756abc20ac50b8d39c0bcd53349534"
},
"downloads": -1,
"filename": "nonebot_plugin_access_control-1.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "eb271bfa2a00ca73c276c0f18f0ec729",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 45734,
"upload_time": "2024-05-04T09:01:08",
"upload_time_iso_8601": "2024-05-04T09:01:08.743103Z",
"url": "https://files.pythonhosted.org/packages/a8/d9/14cab5548cac182b00c6368829010a0afa0785dc154b8be9c951810d17fc/nonebot_plugin_access_control-1.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2e88fc5e66f514f9657b7017d5c559c925cb81a5784f55b9f0e31c0c0cf8478d",
"md5": "d7ab2fb15156e3bde1667ae9bbbdadf6",
"sha256": "32f85ae7a3ca5fa708819ee7db4295416fe01bf3e1146ab9c80efd81bcb9a806"
},
"downloads": -1,
"filename": "nonebot_plugin_access_control-1.2.0.tar.gz",
"has_sig": false,
"md5_digest": "d7ab2fb15156e3bde1667ae9bbbdadf6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 31434,
"upload_time": "2024-05-04T09:01:10",
"upload_time_iso_8601": "2024-05-04T09:01:10.412911Z",
"url": "https://files.pythonhosted.org/packages/2e/88/fc5e66f514f9657b7017d5c559c925cb81a5784f55b9f0e31c0c0cf8478d/nonebot_plugin_access_control-1.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-04 09:01:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "bot-ssttkkl",
"github_project": "nonebot-plugin-access-control",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "nonebot-plugin-access-control"
}
JSON
