访问控制

常用入口

打开功能菜单

插件帮助

/ac help

PicMenu 总帮助

帮助 /help

在机器人所在的 QQ 群中发送对应入口。发送“帮助”或“/help”可打开 PicMenu 总菜单；具体功能是否可用取决于机器人配置与权限。

插件信息

安装状态: 已安装
Bot 状态: 已同步
本地版本: 1.2.4
类型: 基础组件
上游资料: 作者项目与文档
名称: 访问控制
分类: 基础组件
来源: 第三方插件

使用方法

内容来源：PicMenu

📖 /ac 管理命令总览

触发方式

/ac help

查看当前插件提供的全部管理指令。

示例

/ac help
/ac service ls

ac 命令会解析权限、限流、服务层级及主体。仅超级用户可用；必须写成 ac <子命令>，单独发送 ac 没有子命令。

🔐 允许或拒绝服务访问

触发方式

/ac permission allow|deny --sbj <主体> --srv <服务>

为某个主体设置服务访问权限。

示例

/ac permission allow --sbj <主体> --srv <服务>
/ac permission deny --sbj <主体> --srv <服务>
/ac permission rm --sbj <主体> --srv <服务>
/ac permission ls

rm 删除一项显式权限，ls 列出已配置权限；ls 可选择添加 --sbj 和 --srv 过滤。服务名可为 nonebot、插件名或 <插件>.<子服务>。建议先通过 service ls 和 subject 查到准确名称。

⏱️ 调用次数限制

触发方式

/ac limit add|rm|ls|reset

按主体与服务设置调用限额。

示例

/ac limit add --sbj <主体> --srv <服务> --limit 5 --span 1h
/ac limit ls
/ac limit rm <规则ID>
/ac limit reset

新规则可带 --overwrite 覆盖冲突配置；ls 可用 --sbj 或 --srv 筛选。reset 会重置当前限流计数，请谨慎使用。

🧭 查询服务树与当前主体

触发方式

/ac service ls /ac subject

查找可管理的插件服务名称和消息发送者主体。

示例

/ac service ls
/ac service ls --srv nonebot_plugin_pixivbot
/ac subject

service ls 列出服务及子服务层级；subject 列出本次发送者的主体标识。将查询结果用于权限或限流规则的 --srv、--sbj 参数。

这是供其他插件调用的基础组件，不是直接发送 QQ 命令的功能。安装不代表它具有独立的聊天入口。

使用建议

不确定怎么用？

先发送上方的常用入口。如果机器人没有回复，请确认机器人在线，再发送“帮助”或“/help”查看 PicMenu 当前菜单。

查看完整使用说明 →

打开功能菜单

插件帮助

PicMenu 总帮助

使用方法

📖 /ac 管理命令总览

示例

🔐 允许或拒绝服务访问

示例

⏱️ 调用次数限制

示例

🧭 查询服务树与当前主体

示例

不确定怎么用？

你可能还会用到