1
# 1. 核心功能模块
2
from nonebot import on_command, on_shell_command  # 命令注册
3
from nonebot.plugin import PluginMetadata, require  # 插件元数据和依赖
4
from nonebot.rule import ArgumentParser  # 命令参数解析
5
from nonebot.log import logger  # 日志记录
6

7
# 2. 适配器模块
8
from nonebot.adapters.onebot.v11 import (
9
    Bot,                # 机器人对象
10
    Event,             # 事件基类
11
    MessageEvent,      # 消息事件
12
    GroupMessageEvent, # 群消息事件
13
    PrivateMessageEvent,# 私聊消息事件
14
    Message,           # 消息类
15
    MessageSegment,    # 消息段
16
)
17

18
# 3. 权限控制模块
19
from nonebot.permission import (
20
    SUPERUSER,         # 超级用户
21
    GROUP_ADMIN,       # 群管理员
22
    GROUP_OWNER,       # 群主
23
)
24

25
# 组合权限
26
ADMIN = SUPERUSER | GROUP_ADMIN | GROUP_OWNER  # 超管或群管理或群主

1
# 1. 命令处理器(最常用)
2
cmd = on_command(
3
    "命令名",                # 命令名称
4
    aliases={"别名1", "别名2"},  # 命令别名
5
    priority=10,            # 优先级(数字越小优先级越高)
6
    block=True,             # 是否阻止事件传递
7
    permission=ADMIN        # 权限控制
8
)
9

10
# 2. shell命令处理器(适合复杂参数)
11
draw = on_shell_command(
12
    "draw",                # 命令名
13
    parser=draw_parser,    # 参数解析器
14
    priority=10
15
)
16

17
# 3. 关键词处理器
18
kw = on_keyword({"你好", "hello"})  # 触发关键词
19

20
# 4. 正则处理器
21
rex = on_regex(r"\d+")             # 匹配数字

1
from nonebot.rule import ArgumentParser
2

3
# 创建命令解析器
4
draw_parser = ArgumentParser(description="AI绘图命令")
5

6
# 1. 添加位置参数(必填)
7
draw_parser.add_argument(
8
    "prompt",           # 参数名
9
    nargs="*",         # 参数个数(*表示任意多个)
10
    help="绘图提示词",   # 参数说明
11
    type=str           # 参数类型
12
)
13

14
# 2. 添加可选参数
15
draw_parser.add_argument(
16
    "-n", "--negative",  # 参数别名
17
    nargs="*",          # 参数个数
18
    help="负面提示词",    # 参数说明
19
    type=str,           # 参数类型
20
    dest="negative"      # 存储变量名
21
)
22

23
# 3. 添加开关参数
24
draw_parser.add_argument(
25
    "--r18",           # 参数名
26
    action="store_true", # 存在即为True
27
    help="是否开启R18"   # 参数说明
28
)

1
@draw.handle()
2
async def handle_draw(bot: Bot, event: MessageEvent, args: Namespace):
3
    # 获取参数值
4
    prompt = " ".join(args.prompt) if args.prompt else ""  # 提示词
5
    negative = " ".join(args.negative) if args.negative else ""  # 负面词
6
    is_r18 = args.r18  # 是否R18
7

8
    await draw.send(
9
        f"收到绘图请求:\n"
10
        f"提示词: {prompt}\n"
11
        f"负面词: {negative}\n"
12
        f"R18: {'是' if is_r18 else '否'}"
13
    )

1
# 1. 基础消息发送
2
await cmd.send("普通文本")                     # 发送文本
3
await cmd.send("你好!", at_sender=True)       # @发送者
4
await cmd.finish("结束处理")                   # 发送并结束处理
5

6
# 2. 复杂消息发送
7
from nonebot.adapters.onebot.v11 import MessageSegment
8

9
# 发送图片
10
await cmd.send(MessageSegment.image("图片路径"))
11

12
# 发送表情
13
await cmd.send(MessageSegment.face(1))
14

15
# 发送@
16
await cmd.send(MessageSegment.at(user_id))
17

18
# 组合消息
19
msg = (
20
    MessageSegment.text("结果：\n") +
21
    MessageSegment.image("result.png") +
22
    MessageSegment.at(user_id)
23
)
24
await cmd.send(msg)
25

26
# 3. 合并转发消息(群聊)
27
msgs = []
28
for text in message_list:
29
    msgs.append({
30
        "type": "node",
31
        "data": {
32
            "name": "机器人",
33
            "uin": bot.self_id,
34
            "content": text
35
        }
36
    })
37
await bot.call_api(
38
    "send_group_forward_msg",
39
    group_id=event.group_id,
40
    messages=msgs
41
)

1
# 1. 基础权限
2
SUPERUSER         # 超级用户
3
GROUP_ADMIN       # 群管理员
4
GROUP_OWNER       # 群主
5

6
# 2. 组合权限
7
ADMIN = SUPERUSER | GROUP_ADMIN | GROUP_OWNER  # 超管或群管理
8

9
# 3. 使用权限
10
cmd = on_command("admin", permission=ADMIN)
11

12
# 4. 手动检查权限
13
if event.get_user_id() in bot.config.superusers:
14
    await cmd.finish("您是超级用户!")
15

16
if isinstance(event, GroupMessageEvent):
17
    if event.sender.role in ["admin", "owner"]:
18
        await cmd.finish("您是群管理!")

1
@cmd.handle()
2
async def handler(bot: Bot, event: MessageEvent):
3
    try:
4
        # 处理逻辑...
5
        result = await some_api()
6

7
    except NetworkError:
8
        # 网络错误
9
        logger.error("网络错误")
10
        await cmd.finish("网络错误,请稍后再试!")
11

12
    except ApiError as e:
13
        # API错误
14
        logger.error(f"API错误: {e}")
15
        await cmd.finish("处理失败,请检查参数!")
16

17
    except Exception as e:
18
        # 其他错误
19
        logger.exception(f"未知错误: {e}")
20
        await cmd.finish("发生未知错误!")

1
plugins/
2
└── nonebot_plugin_nai3/
3
    ├── __init__.py    # 主要逻辑
4
    ├── config.py      # 配置文件
5
    └── utils.py       # 工具函数

1
from pydantic import BaseModel
2
from nonebot import get_plugin_config
3

4
class Config(BaseModel):
5
    """插件配置类"""
6
    # API设置
7
    nai3_token: str = ""        # API密钥
8
    nai3_proxy: str = None      # 代理地址
9

10
    # 使用限制
11
    nai3_limit: int = 10        # 每人每天次数
12
    nai3_cd_group: int = 30     # 群冷却时间(秒)
13
    nai3_cd_user: int = 300     # 用户冷却时间(秒)
14

15
    # 其他设置
16
    nai3_r18: bool = False      # 是否允许R18
17
    nai3_save: bool = False     # 是否保存图片
18

19
# 获取配置
20
plugin_config = get_plugin_config(Config)

1
from nonebot import on_shell_command
2
from nonebot.rule import ArgumentParser
3
from nonebot.permission import SUPERUSER, GROUP_ADMIN, GROUP_OWNER
4

5
# 1. 创建命令解析器
6
parser = ArgumentParser(description='AI绘图')
7
parser.add_argument("prompt", help="提示词")     # 必填参数
8
parser.add_argument("-n", "--negative", help="负面词")  # 可选参数
9

10
# 2. 注册命令
11
draw = on_shell_command(
12
    "draw",              # 命令名
13
    parser=parser,       # 参数解析器
14
    priority=10          # 优先级
15
)
16

17
# 3. 注册管理命令
18
ADMIN = SUPERUSER | GROUP_ADMIN | GROUP_OWNER  # 组合权限

1
parser.add_argument("-n", default="bad quality")  # 不填时使用默认值

1
parser.add_argument("-s", type=float, choices=[1.0, 2.0, 3.0])  # 限制可选值

1
@draw.handle()
2
async def _(args: Namespace):
3
    if args.scale < 1.0 or args.scale > 10.0:
4
        await draw.finish("参数范围错误!")

1
plugins/
2
└── nonebot_plugin_nai3/
3
    ├── __init__.py    # 主要逻辑
4
    ├── config.py      # 配置文件
5
    └── utils.py       # 工具函数

1
class Config(BaseModel):
2
    api_key: str
3
    daily_limit: int = 10

1
draw = on_shell_command("draw", parser=parser)
2
admin = on_command("admin", permission=ADMIN)

1
@draw.handle()
2
async def handle_draw(event: MessageEvent):
3
    user_id = event.user_id
4
    message = event.get_message()

1
await bot.send(event, "文本消息")
2
await bot.send(event, MessageSegment.image(path))

1
ADMIN = SUPERUSER | GROUP_ADMIN | GROUP_OWNER

1
try:
2
    await process()
3
except NetworkError:
4
    await bot.send("网络错误")