移除商店中的过期插件

不知不觉 NoneBot2 已经进入 beta 一个多月，值此 beta2 版本发布之际，我们计划将插件商店中仍未适配 beta 更新的插件移除，在此处列出名单以告知作者，如有错误请回复。

列表

Git 已适配但未在 PyPI 发版（Warning）

nonebot-plugin-setu @ayanamiblhx nonebot-plugin-filehost @mnixry nonebot-plugin-leetcode @zxz0415 nonebot-plugin-picsbank @Diaosi1111

未适配

依赖问题

• [ ] nonebot-plugin-wordbank @Joenothing-lst GitHub 仓库里没有 setup.py 或 pyproject.toml
• [ ] nonebot-plugin-fr24 @IronWolf-K
• [x] nonebot-plugin-imgsearch @bakashigure
• [x] nonebot-plugin-itnew @yzyyz1387
• [x] lolHeroes @cjladmin
• [x] nonebot-plugin-random-cat @alphaAE
• [ ] random_cat_gif @applenana GitHub 仓库里没有 setup.py 或 pyproject.toml
• [x] ServantReasoning @suhexia
• [ ] nonebot-plugin-anime-news @5656565566 仓库里没有 setup.py 或 pyproject.toml
• [x] nonebot-pulgin-autoagree @ZakiuC
• [x] nonebot-plugin-fg @mgsky1
• [ ] nonebot-mockingbird-plugin @Diaosi1111

beta2 Config 问题

nonebot-plugin-pixivrank-search @HibiKier nonebot-plugin-heisi @yzyyz1387 nonebot-plugin-admin @yzyyz1387

其他

nonebot-plugin-vf @snowyfirefly 代码未托管在 GitHub，懒得管

待删除

nonebot-plugin-test @yanyongyu nonebot-plugin-web @abrahum nonebot-plugin-ipypreter @iyume nonebot-plugin-arcaea @iyume nonebot-plugin-statistical @HibiKier nonebot-plugin-workscore @yzyyz1387 nonebot-plugin-nokia @kexue-z nonebot-plugin-pctrl @CherryGS

已删除

nonebot-plugin-hanayori @kanomahoro nonebot-plugin-simplemusic @kanomahoro nonebot-plugin-twitter @kanomahoro

数据来源

Lancercmd/nonebot2-store-test

现状

目前插件若通过 nonebot.load_plugin 与 nonebot.load_plugins 加载，可能会导致出现这种代码：

nonebot.load_plugin('nonebot_plugin_status')
nonebot.load_plugin('nonebot_plugin_apscheduler')
nonebot.load_plugin('nonebot_plugin_picsearcher')
nonebot.load_plugin('nonebot_plugin_translator')
nonebot.load_plugin('nonebot_plugin_cooldown')
...
nonebot.load_plugins('plugins')

其中存在这样几个问题：

1. 重复代码
2. 插件名字里的下划线很丑！
3. 在每次新安装插件后都需要相应地修改代码，无法自动发现新安装的插件

其中第一项虽然可以通过 nonebot.load_all_plugins, nonebot.load_from_json 或 nonebot.load_from_toml 解决，但剩余问题仍然存在。

可能的解决方案

插件作者方面

依照 PEP 420 修改插件文件布局。例如：

pyproject.toml
nonebot/
    plugins/
        foo.py
        bar.py

框架方面

若需解决上述第二个问题

插件作者修改文件布局后，插件可以在通过 pip 安装后直接使用目前的 nonebot.load_builtin_plugins 导入，例如：

nonebot.load_builtin_plugins('foo')
nonebot.load_builtin_plugins('bar')

考虑到函数名的问题，以及多次调用同一函数带来的不便，可以定义以下函数：

def load_namespace_plugins(names: list[str]) -> list[Plugin]:
    loaded_plugins = [load_builtin_plugins(name) for name in names]
    return loaded_plugins

若需进一步解决上述第三个问题

通过 pkgutil.iter_modules 等函数获得 nonebot.plugins 下的所有模块，并自动加载。

该解决方案的缺点

1. 由于目前已有数十个插件，向命名空间插件迁移需要一定的时间与人力成本
2. 需要同时支持新旧两种风格的插件，需要额外的维护成本
3. 没有养成创建虚拟环境的好习惯的人可能会意外加载不需要的插件

其中第一项随着时间的推移可以慢慢解决，且迁移仅需更改文件夹结构，难度较小。第二项难以避免，用户自行编写而没有发布的插件使用旧风格加载较为方便。第三项不需要考虑，为用户自身的问题；或者提供开关，控制是否自动加载。

参考

• PEP 420
• PyPA 对 namespace package 的介绍
• pkgutil 文档
• 向命名空间插件迁移的案例，该案例目前的插件生态，该案例的相关文档，以及可以借鉴的自动发现所有插件的代码

请项目维护者们考虑该提议是否可行，谢谢！

描述问题：

运行了几周了都正常，刚才突然卡住 console上不动了,我加的log也不增加了 但是bot收到新消息，oicq还会显示新的消息（正常），nonebot2就没反应 OICQ那边没有也显示ws断开，说明还连着

我设置的以下日志卡住后都不动了： logger.add("critical.log", encoding="utf-8", rotation="00:00", diagnose=False, level="CRITICAL", format=default_format)

logger.add("info.log", encoding="utf-8", rotation="00:00", diagnose=False, level="INFO", format=default_format)

重新启动nonebot，之前卡住累计的信息会一次性发出， 但过一会儿又卡住了，是什么原因呢。

日志如下： /home/myuser/.pm2/logs/nonebot2-out.log last 15 lines: 1|nonebot2 | 12-31 23:57:38 [DEBUG] nonebot | Stop event propagation 1|nonebot2 | 12-31 23:57:55 [INFO] nonebot | CQHTTP | 2469785829 [message.group.normal]: Message Klxxu5cTd9gAANvRYPbcxF/t9QMB from 2534635480@[群:710731498]: "我要吃鸡号" 1|nonebot2 | 12-31 23:57:55 [DEBUG] nonebot | Checking for matchers in priority 1... 1|nonebot2 | 12-31 23:57:55 [DEBUG] nonebot | Checking for matchers in priority 5... 1|nonebot2 | 12-31 23:57:55 [INFO] nonebot | Event will be handled by <Matcher from shutup, type=message, priority=5, temp=False> 1|nonebot2 | 12-31 23:57:55 [DEBUG] nonebot | Running matcher <Matcher from shutup, type=message, priority=5, temp=False> 1|nonebot2 | 12-31 23:57:55 [INFO] nonebot | Matcher <Matcher from shutup, type=message, priority=5, temp=False> running complete 1|nonebot2 | 12-31 23:57:55 [DEBUG] nonebot | Stop event propagation 1|nonebot2 | 12-31 23:58:26 [INFO] nonebot | CQHTTP | 2469785829 [message.group.anonymous]: Message Jzeo7QTEtAAAAHB3dFaE3F/t9SIB from 80000000@[群:657359249]: "杨桃有点东西" 1|nonebot2 | 12-31 23:58:26 [DEBUG] nonebot | Checking for matchers in priority 1... 1|nonebot2 | 12-31 23:58:26 [DEBUG] nonebot | Checking for matchers in priority 5... 1|nonebot2 | 12-31 23:58:26 [INFO] nonebot | Event will be handled by <Matcher from shutup, type=message, priority=5, temp=False> 1|nonebot2 | 12-31 23:58:26 [DEBUG] nonebot | Running matcher <Matcher from shutup, type=message, priority=5, temp=False> 1|nonebot2 | 12-31 23:58:26 [CRITICAL] shutup | 啊这 呜呜呜 1|nonebot2 | 青枣HP变为1

/home/myuser/.pm2/logs/oicq-out.log last 15 lines: 0|oicq | [2021-01-01T01:08:47.174] [INFO] [BOT:2469785829] - recv from: [Group: xxxxx(657359249), Member: 匿名消息(80000000)] ？ 0|oicq | [2021-01-01T01:08:49.896] [INFO] [BOT:2469785829] - recv from: [Group: xxxxx(657359249), Member: 匿名消息(80000000)] 你不是几个小时前发过了吗 0|oicq | [2021-01-01T01:09:22.385] [INFO] [BOT:2469785829] - recv from: [Group: xxxxx(657359249), Member: 匿名消息(80000000)] 噢 0|oicq | [2021-01-01T01:09:31.048] [INFO] [BOT:2469785829] - recv from: [Group: xxxxx(657359249), Member: 匿名消息(80000000)] 我脑瘫 0|oicq | [2021-01-01T01:10:02.100] [INFO] [BOT:2469785829] - recv from: [Group: xxxxx(657359249), Member: 匿名消息(80000000)] 九头驸马有点东西 0|oicq | [2021-01-01T01:11:43.683] [INFO] [BOT:2469785829] - recv from: [Group: xxxxx(657359249), Member: 匿名消息(80000000)] 马上上 0|oicq | [2021-01-01T01:12:43.710] [INFO] [BOT:2469785829] - recv from: [Group: xxxxx(657359249), Member: 匿名消息(80000000)] [CQ:reply,id=Jzeo7QTEtAAAAHGRZK0iDV/uBaEB]？ 0|oicq | [2021-01-01T01:13:14.205] [INFO] [BOT:2469785829] - recv from: [Group: xxxxx(657359249), Member: 匿名消息(80000000)] 您是？ 0|oicq | [2021-01-01T01:14:25.105] [INFO] [BOT:2469785829] - recv from: [Group: xxxxx(657359249), Member: 匿名消息(80000000)] [CQ:reply,id=Jzeo7QTEtAAAAHGWQVw3ml/uBosB]别管我，我脑瘫 0|oicq | [2021-01-01T01:14:49.301] [INFO] [BOT:2469785829] - recv from: [Group: xxxxx(657359249), Member: 匿名消息(80000000)] 警告，咱们还是接着聊吧 0|oicq | [2021-01-01T01:15:02.429] [INFO] [BOT:2469785829] - recv from: [Group: xxxxx(657359249), Member: 匿名消息(80000000)] 鼍龙怪有点东西 0|oicq | [2021-01-01T01:15:09.606] [INFO] [BOT:2469785829] - recv from: [Group: xxxxx(657359249), Member: 匿名消息(80000000)] bot好像关了 0|oicq | [2021-01-01T01:16:28.344] [INFO] [BOT:2469785829] - recv from: [Group: xxxxx(657359249), Member: 匿名消息(80000000)] 要不xdm众筹下把bot放服务器上跑？

看oicq日志最后一条的时间是最新的，而nonebot2就卡在卡住的时间之后就不动了

如何复现？ 之前好的，现在就这样了，触发条件不明

环境信息：

• OS: [Centos7]
• Python Version: [3.8]
• Nonebot Version: [2.0.0]

系统Windows 11

D:\NoneBot2>nb init
[?] Project Name:  homura
[?] Where to store the plugin?  2) In a "src" folder
[?] Load NoneBot Builtin Plugin?  Yes
[?] Which adapter(s) would you like to use?  (<up>, <down> to move, <space> to select, <a> to toggle, <i> to invert)
Traceback (most recent call last):
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\prompt_toolkit\cache.py", line 34, in get
    return self._data[key]
KeyError: 1

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "D:\conda_data\envs\Python3.8.15\lib\runpy.py", line 194, in _run_module_as_main
    return _run_code(code, main_globals, None,
  File "D:\conda_data\envs\Python3.8.15\lib\runpy.py", line 87, in _run_code
    exec(code, run_globals)
  File "D:\conda_data\envs\Python3.8.15\Scripts\nb.exe\__main__.py", line 7, in <module>
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\click\core.py", line 829, in __call__
    return self.main(*args, **kwargs)
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\click\core.py", line 782, in main
    rv = self.invoke(ctx)
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\click\core.py", line 1259, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\click\core.py", line 1066, in invoke
    return ctx.invoke(self.callback, **ctx.params)
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\click\core.py", line 610, in invoke
    return callback(*args, **kwargs)
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\nb_cli\__init__.py", line 30, in init
    create_project()
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\nb_cli\handlers.py", line 105, in create_project
    answers2 = prompt(question2, qmark="[?]", style=list_style)
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\PyInquirer\prompt.py", line 69, in prompt
    answer = run_application(
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\prompt_toolkit\shortcuts.py", line 625, in run_application
    result = cli.run()
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\prompt_toolkit\interface.py", line 413, in run
    self._redraw()
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\prompt_toolkit\interface.py", line 358, in _redraw
    self.renderer.render(self, self.layout, is_done=self.is_done)
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\prompt_toolkit\renderer.py", line 424, in render
    layout.write_to_screen(cli, screen, mouse_handlers, WritePosition(
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\prompt_toolkit\layout\containers.py", line 142, in write_to_screen
    sizes = self._divide_heigths(cli, write_position)
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\prompt_toolkit\layout\containers.py", line 177, in _divide_heigths
    dimensions = [get_dimension_for_child(c, index) for index, c in enumerate(self.children)]
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\prompt_toolkit\layout\containers.py", line 177, in <listcomp>
    dimensions = [get_dimension_for_child(c, index) for index, c in enumerate(self.children)]
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\prompt_toolkit\layout\containers.py", line 175, in get_dimension_for_child
    return c.preferred_height(cli, write_position.width, write_position.extended_height)
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\prompt_toolkit\layout\containers.py", line 1652, in preferred_height
    return self.content.preferred_height(cli, width, max_available_height)
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\prompt_toolkit\layout\containers.py", line 999, in preferred_height
    preferred=self.content.preferred_height(
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\prompt_toolkit\layout\controls.py", line 254, in preferred_height
    content = self.create_content(cli, width, None)
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\prompt_toolkit\layout\controls.py", line 259, in create_content
    tokens_with_mouse_handlers = self._get_tokens_cached(cli)
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\prompt_toolkit\layout\controls.py", line 238, in _get_tokens_cached
    return self._token_cache.get(
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\prompt_toolkit\cache.py", line 37, in get
    value = getter_func()
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\prompt_toolkit\layout\controls.py", line 239, in <lambda>
    cli.render_counter, lambda: self.get_tokens(cli))
  File "D:\conda_data\envs\Python3.8.15\lib\site-packages\PyInquirer\prompts\checkbox.py", line 99, in _get_choice_tokens
    tokens.pop()  # Remove last newline.
IndexError: pop from empty list

描述问题：

启动时报错

如何复现？

仅仅是import nonebot就会报错 神奇的是,在将sched.py里面修改后

if AsyncIOScheduler:
    scheduler = AsyncIOScheduler(timezone="Asia/Shanghai")

就解决了~~现在正在这样苟着用~~

期望的结果

可以正常运行

环境信息：

• OS: [win10]
• Python Version: [3.8.5]
• Nonebot Version: [2.0.0a6]

截图

import nonebot
Traceback (most recent call last):
  File "E:\Anaconda3\lib\site-packages\IPython\core\interactiveshell.py", line 3418, in run_code
    exec(code_obj, self.user_global_ns, self.user_ns)
  File "<ipython-input-2-473157fb80ba>", line 1, in <module>
    import nonebot
  File "E:\pycharm\PyCharm 2020.1.2\plugins\python\helpers\pydev\_pydev_bundle\pydev_import_hook.py", line 21, in do_import
    module = self._system_import(name, *args, **kwargs)
  File "E:\Anaconda3\lib\site-packages\nonebot\__init__.py", line 135, in <module>
    from nonebot.sched import scheduler
  File "E:\pycharm\PyCharm 2020.1.2\plugins\python\helpers\pydev\_pydev_bundle\pydev_import_hook.py", line 21, in do_import
    module = self._system_import(name, *args, **kwargs)
  File "E:\Anaconda3\lib\site-packages\nonebot\sched.py", line 19, in <module>
    scheduler = AsyncIOScheduler()
  File "E:\Anaconda3\lib\site-packages\apscheduler\schedulers\base.py", line 87, in __init__
    self.configure(gconfig, **options)
  File "E:\Anaconda3\lib\site-packages\apscheduler\schedulers\base.py", line 126, in configure
    self._configure(config)
  File "E:\Anaconda3\lib\site-packages\apscheduler\schedulers\asyncio.py", line 48, in _configure
    super(AsyncIOScheduler, self)._configure(config)
  File "E:\Anaconda3\lib\site-packages\apscheduler\schedulers\base.py", line 697, in _configure
    self.timezone = astimezone(config.pop('timezone', None)) or get_localzone()
  File "E:\Anaconda3\lib\site-packages\tzlocal\win32.py", line 93, in get_localzone
    _cache_tz = pytz.timezone(get_localzone_name())
  File "E:\Anaconda3\lib\site-packages\tzlocal\win32.py", line 84, in get_localzone_name
    raise pytz.UnknownTimeZoneError('Can not find timezone ' + tzkeyname)
pytz.exceptions.UnknownTimeZoneError: 'Can not find timezone '

描述问题：

nonebot2的变量类型读取能力表格如下： |类型|dotenv|环境变量| |---|---|---| |其他简单类型变量|✅|✅| |dict|✅|✅| |list|✅|❌|

如何复现？

在tests/test_init.py作如下修改，运行测试出现错误：

diff --git a/tests/test_init.py b/tests/test_init.py
index 3d49d5ce..3fbb4965 100644
--- a/tests/test_init.py
+++ b/tests/test_init.py
@@ -3,6 +3,7 @@ import os
 import pytest
 
 os.environ["CONFIG_FROM_ENV"] = '{"test": "test"}'
+os.environ["CONFIG_FROM_ENV_LIST"] = '["test1", "test2"]'
 os.environ["CONFIG_OVERRIDE"] = "new"
 
 
@@ -26,6 +27,7 @@ async def test_init(nonebug_init):
 
     config = get_driver().config
     assert config.config_from_env == {"test": "test"}
+    assert config.config_from_env_list == ["test1", "test2"]
     assert config.config_override == "new"
     assert config.config_from_init == "init"
     assert config.common_config == "common"

# 测试命令参照.github/workflows/codecov.yml
$ poetry run pytest -n auto --cov-report xml

期望的结果

=============================================== short test summary info ================================================
FAILED test_init.py::test_init[nonebug_init0] - AttributeError: 'Config' object has no attribute 'config_from_env_list'
FAILED test_init.py::test_init[nonebug_init1] - AttributeError: 'Config' object has no attribute 'config_from_env_list'
============================================ 2 failed, 109 passed in 14.06s ============================================

环境信息：

该问题在以下环境中可以复现。

|OS|Python|Nonebot| |---|---|---| |Darwin notebook.zeithrold.local 21.6.0 Darwin Kernel Version 21.6.0: Wed Aug 10 14:28:35 PDT 2022; root:xnu-8020.141.5~2/RELEASE_ARM64_T8101 arm64|3.9.12|gitmaster分支HEAD, afd13ed65d6b925bf4f1587a8dfd7fa3c09da152| |Linux codespaces-d7be66 5.4.0-1098-azure #104~18.04.2-Ubuntu SMP Tue Nov 29 12:13:35 UTC 2022 x86_64 x86_64 x86_64 GNU/Linux|3.10.4|gitmaster分支HEAD, afd13ed65d6b925bf4f1587a8dfd7fa3c09da152|

协议端信息：

无

截图或日志

无

备注

这似乎是Pydantic的问题，该库文档提供了一种通过自定义解析的方式获取列表型环境变量：

import os
from typing import Any, List

from pydantic import BaseSettings


class Settings(BaseSettings):
    numbers: List[int]

    class Config:
        @classmethod
        def parse_env_var(cls, field_name: str, raw_val: str) -> Any:
            if field_name == 'numbers':
                return [int(x) for x in raw_val.split(',')]
            return cls.json_loads(raw_val)


os.environ['numbers'] = '1,2,3'
print(Settings().dict())
#> {'numbers': [1, 2, 3]}

从环境变量读取配置的原因在于，使用nonebot必然导致输入机密数据，这些数据不适宜存储在文件当中。部分Adapter要求使用列表型配置，但并不支持通过环境变量读取。

如果只能通过Pydantic读取变量，那么至少要在官方文档中醒目标注：目前无法支持通过环境变量传入列表型变量。

描述问题：

包含 rule=to_me() 的 command 在群聊中无法工作。

如何复现？

自制插件：

from nonebot import on_command, on_keyword
from nonebot.adapters import Bot, Event
from nonebot.rule import to_me
from nonebot.permission import SUPERUSER

matcher = on_keyword({'debug'}, permission=SUPERUSER)
matcher2 = on_command('fail', rule=to_me(), permission=SUPERUSER)

@matcher.handle()
async def _(bot: Bot, event: Event):
    event_raw = event.json(indent=2, ensure_ascii=False)
    await bot.send(event, event_raw)

@matcher2.handle()
async def _(bot: Bot, event: Event):
    event_raw = event.json(indent=2, ensure_ascii=False)
    await bot.send(event, event_raw)

在群聊中发送：@bot fail
无响应

在群聊中发送：@bot debug
回复：
{
  "time": 1620720593,
  "self_id": ******,
  "post_type": "message",
  "sub_type": "normal",
  "user_id": ******,
  "message_type": "group",
  "message_id": 725230510,
  "message": [
    {
      "type": "at",
      "data": {
        "qq": ******
      }
    },
    {
      "type": "text",
      "data": {
        "text": " debug"
      }
    }
  ],
  "raw_message": "[CQ:at,qq=******] debug",
  "font": 0,
  "sender": {},  // 略
  "to_me": false,
  "reply": null,
  "group_id": ******,
  "anonymous": null,
  "ClassType": "GroupMessage"
}

在私聊中发送：fail
回复：
{
  "time": 1620721131,
  "self_id": ******,
  "post_type": "message",
  "sub_type": "friend",
  "user_id": ******,
  "message_type": "private",
  "message_id": 1411144159,
  "message": [],
  "raw_message": "fail",
  "font": 0,
  "sender": {},  // 略
  "to_me": true,
  "reply": null,
  "ClassType": "PrivateMessage"
}

期望的结果

在群聊中发送：@bot fail，有回复 在群聊中发送：@bot debug，回复 "to_me": true

环境信息：

• OS: linux docker python:3.8-slim
• Python Version: 3.8
• Nonebot Version: 2.0.0a13.post1
• Adapter: cqhttp
• Env: command_start=["!", "！", ""]

描述问题：

我在bot开放了一个msg的http接口, 在云端通过http://127.0.0.1:9326/msg?msg=xxxx来发送消息, 但是在发送消息经常会出现无法获取bot的情况(get_bots). 我尝试在代码了增加重试来等待机器人重新连接, cq部署在本地 但是nonbot还是经常出现这种情况.

如何复现？

@app.get("/msg/")
async def hello():
    bots = nonebot.get_bots()
    while not bots:
        nonebot.log.logger.warning("等待中, 没有可用机器人...")
        await asyncio.sleep(1)
        bots = nonebot.get_bots()
    for bot in bots:
        b: Bot = bots.get(bot)
        await b.call_api('send_group_msg', **{
            'group_id': 群号,
            'message': 'test'
        })

期望的结果 正常发送消息

A clear and concise description of what you expected to happen.

环境信息：

• OS: 腾讯云centos7
• Python Version: 3.8
• Nonebot Version: v2.0.0-beta.1

协议端信息：

• 协议端: go-cqhttp
• 协议端版本: v1.0.0-rc1

截图或日志 ===================== 尝试在本地断开CQ再重新连接CQ =========================

主要是想使用一个函数对消息进行预处理，将繁体字转为简体字，方便matcher的匹配

例如

@run_preprocessor
async def _(matcher: Matcher, bot: Bot, event: Event, state: T_State):
    event.message = convert(event.message, "zh-cn")

await asyncio.create_subprocess_shell(cmd)

我平时使用macos和windows环境开发，上面的代码在macos中使用是没有任何问题的，但在windows中会报一个NotImplementedError错误，官方提到

注解 如果使用了 ProactorEventLoop 则子进程将在 Windows 中可用。 详情参见 Windows 上的子进程支持。

结合网上的解决办法，我可以通过修改nonebot/drivers/fastapi.py源码的方式解决这个问题

class Driver(BaseDriver):
    @overrides(BaseDriver)
    def run(self,
            host: Optional[str] = None,
            port: Optional[int] = None,
            *,
            app: Optional[str] = None,
            **kwargs):
        """使用 ``uvicorn`` 启动 FastAPI"""
        super().run(host, port, app, **kwargs)
        LOGGING_CONFIG = {
            "version": 1,
            "disable_existing_loggers": False,
            "handlers": {
                "default": {
                    "class": "nonebot.log.LoguruHandler",
                },
            },
            "loggers": {
                "uvicorn.error": {
                    "handlers": ["default"],
                    "level": "INFO"
                },
                "uvicorn.access": {
                    "handlers": ["default"],
                    "level": "INFO",
                },
            },
        }
        # 以下是修改的内容
        from uvicorn import Config, Server
        from asyncio import ProactorEventLoop, set_event_loop, get_event_loop
        set_event_loop(ProactorEventLoop())
        server = Server(config=Config(
            app or self.server_app,
            host=host or str(self.config.host),
            port=port or self.config.port,
            reload=bool(app) and self.config.debug,
            reload_dirs=self.fastapi_config.fastapi_reload_dirs or None,
            debug=self.config.debug,
            log_config=LOGGING_CONFIG,
            **kwargs,
        ))
        get_event_loop().run_until_complete(server.serve())

        # uvicorn.run(app or self.server_app,
        #             host=host or str(self.config.host),
        #             port=port or self.config.port,
        #             reload=bool(app) and self.config.debug,
        #             reload_dirs=self.fastapi_config.fastapi_reload_dirs or None,
        #             debug=self.config.debug,
        #             log_config=LOGGING_CONFIG,
        #             **kwargs)

但这应该只适用于windows，而且我不知道这样修改是否会带来副作用，希望nb框架能提供更好的解决方案

是否在使用中遇到某些问题而需要新的特性？请描述：

某些情况下需要手动加载某个插件的子插件，而不是在 __init__.py 中使用 load_plugin 或 load_plugins

但手动加载之后，这些插件不会像通过 load_plugin 或 load_plugins 一样自动成为父子插件

描述你所需要的特性：

希望能提供一个注册父子插件的函数

描述问题：

matadata中的

Requires-Dist: fastapi (>=0.87.0,<1.0.0)

会下载fastapi依赖的最新版本0.89.0，而rc2无法调用它

如何复现？

1. 使用 pip install nb-cli 命令安装rc2
2. pip list 中可见fastapi版本号为0.89.0
3. 使用 nb run ，fastapi抛出错误
4. 使用 pip install fastapi==0.88.0 命令安装上一个版本
5. 再次运行，错误消失

期望的结果

fastapi将会抛出

fastapi.exceptions.FastAPIError: Invalid args for response field! Hint: check that <class 'starlette.responses.Response'> is a valid pydantic field type

环境信息：

• OS: Windows 19044.2364
• Python Version: 3.9.13
• Nonebot Version: 2.0.0rc2

协议端信息：

• 协议端: go-cqhttp
• 协议端版本: v1.0.0-rc4

截图或日志

运行失败

降级为0.88.0后，错误消失

移除商店中的过期插件 2023

上一次：#795

计划将插件商店中仍未适配 rc 更新的插件移除，具体移除日期待定。

列表

Git 已适配但未在 PyPI 发版（Warning）

ELF-RSS @Quan666 nonebot-plugin-picsbank @Diaosi1111

未适配

使用了过时的 Export 功能（#1125）

• [ ] nonebot-plugin-broker @mwbimh
• [x] nonebot-plugin-dida @TDK1969

未更新 nonebot-plugin-apscheduler 依赖

• [x] nonebot-plugin-flexperm @rmuchan
• [x] nonebot-plugin-youthstudy @ayanamiblhx
• [ ] nonebot-plugin-fortune @KafCoppelia
• [x] nonebot-plugin-what2eat @KafCoppelia
• [x] nonebot-plugin-morning @KafCoppelia
• [x] nonebot-plugin-today-in-history @AquamarineCyan
• [ ] nonebot-plugin-gamedraw @HibiKier
• [ ] nonebot-plugin-todo-nlp @CofinCup

使用了过时的 State 注入参数（#1160）

• [x] nonebot-plugin-songpicker2 @maxesisn
• [x] nonebot-plugin-biliav @knva
• [ ] nonebot-plugin-setu2 @alphaAE
• [x] nonebot-plugin-qrcode @kexue-z
• [ ] nonebot-plugin-bangumi-search @Ankhyty
• [x] nonebot-plugin-offline-mahjong-helper @Nranphy

缺少依赖

• [x] nonebot-plugin-ncm @kitUIN httpx
• [x] nonebot-plugin-analysis-bilibili @mengshouer nonebot-adapter-onebot
• [ ] nanobot-plugin-splatoon2tools @DrinkOolongTea httpx
• [ ] nonebot-plugin-yulu @bingqiu456 httpx
• [ ] nonebot-plugin-eventdone @PadorFelice nonebot2
• [x] nonebot-plugin-maze @EtherLeaF numpy
• [ ] nonebot-plugin-arktools @NumberSir nonebot-plugin-apscheduler
• [x] nonebot-plugin-firexN @GC-ZF requests
• [x] nonebot-plugin-bfinfo @GC-ZF pillow
• [x] nonebot-plugin-moegoe @Yiyuiii nonebot-adapter-onebot
• [x] nonebot-plugin-workscore @yzyyz1387 httpx
• [x] nonebot-plugin-cqsat @yzyyz1387 nonebot-plugin-apscheduler
• [x] nonebot-plugin-warframe @17TheWord httpx
• [x] nonebot-plugin-bottle @Todysheep requests
• [x] nonebot-plugin-tts-gal @dpm12345 httpx
• [ ] nonebot-plugin-masiro @Ankhyty nonebot-plugin-apscheduler
• [x] nonebot-plugin-bnhhsh @lgc2333 pypinyin
• [x] nonebot-plugin-repeep @p0ise httpx
• [ ] nonebot-plugin-note @Passerby-D nonebot-adapter-onebot
• [x] nonebot-plugin-bilibili-image @jcjrobert bs4
• [ ] nonebot-plugin-idiom @wsdtl pandas
• [x] nonebot-plugin-backup @Yuelioi requests
• [x] nonebot-plugin-hitokoto @A-kirami httpx
• [x] nonebot-plugin-bilicover @A-kirami httpx
• [ ] nonebot-plugin-mcqq-server @KarisAya mcrcon
• [x] nonebot_plugin_kawaii_robot @KarisAya httpx
• [x] nonebot-plugin-BiliRequestAll @Shadow403 requests
• [ ] nonebot-plugin-read-60s @bingganhe123 nonebot-adapter-onebot
• [x] hikari-bot @benx1n urllib3
• [x] nonebot-plugin-apex-api-query @H-xiaoH nonebot-adapter-onebot
• [x] nonebot-plugin-ikun-evolution @RShock dateutil

商店 module_name 与实际模块名不一致

• [ ] nonebot-plugin-russian @HibiKier
• [ ] nonebot-plugin-bVideo @ziru-w
• [x] nonebot-plugin-gpt3 @chrisyy2003

其他

• [x] nonebot-plugin-bilibilibot @TDK1969 No module named 'nonebot_plugin_bilibilibot.bili_src
• [ ] nonebot_plugin_arkrecord @zheuziihau Permission denied: '/root/.arkrecord'
• [x] nonebot-plugin-course @InariInDream setup.py
• [x] nonebot-plugin-zyk-novelai @ZYKsslm setup.py
• [x] nonebot-plugin-zyk-music @ZYKsslm setup.py
• [x] nonebot-plugin-mystool @Ljzd-PRO No such file or directory
• [ ] nonebot-plugin-multi-chatgpt @chrisyy2003 No such file or directory
• [x] nonebot-plugin-abstain-diary @Ikaros-521 No such file or directory
• [ ] nonebot_plugin_groupmate_waifu @KarisAya No such file or directory
• [ ] nonebot-plugin-admin @yzyyz1387 No such file or directory
• [ ] nonebot-plugin-monitor @cjladmin No module named 'monitor_groups'
• [ ] nonebot-plugin-lolmatch @Diaosi1111 nonebot_plugin_tortoise_orm = "^0"

待删除

• nonebot_plugin_flash_silentsave @KarisAya requests
• nonebot-plugin-magiadice @sena-nana wcwidth
• nonebot-plugin-myb-exchange @CMHopeSunshine
• nonebot2-plugin-eth-terminal @Sclock httpx
• nonebot-plugin-vf @snowyfirefly 上次忘删
• nonebot-plugin-auto-teenstudy @ZMXC01 requests
• nonebot-plugin-ykt @sena-nana nonebot-plugin-apscheduler
• nonebot-plugin-xiuxian @s52047qwas No such file or directory

已删除

• nonebot-plugin-filehost @mnixry

数据来源

Lancercmd/nonebot2-store-test

为什么

现在, NoneBot社区内有各种类型的插件, 为了对这些插件查询帮助等, 需要一个统一的规范. 目前存在大量插件自己写了帮助, 导致一个帮助可能会触发大量插件响应, 并且格式不统一

怎么做

目前, 社区对于插件规范有了多种实现, 包括以下两种

• 真寻Bot插件基本标准
• nonebot-plugin-help

所以, 我们可以在插件根中使用字段指定一部分插件元数据

具体规范

字段规范（已部分实现）

以下字段应作为插件根中的全局变量被声明.

__plugin_adapters__ = [OneBotV11Adapter] #插件支持的Adapter, 如果不写就默认支持所有Adapter, 可以考虑根据这个字段进行adapter加载检测
__plugin_name__ = PluginName('unique_name',human='插件人类阅读名称') #如果没有unique name就用插件包名代替
__plugin_name__ = 'unique_name [插件人类阅读名称]' #这样也行, 就不用定义结构体了

__plugin_des__ = '插件介绍' #简短介绍插件的功能(不包括使用方法), 可以给个字数限制?

__plugin_usage__ = '插件用法' #插件使用方法, 可能需要支持很多种定义方式
__plugin_usage__:Dict[Adapter,str] #这样应该也可以被接受
__plugin_usage__:Dict[Type[Matcher],str] #这样可能也得需要支持, 就是直接根据命令生成

__plugin_settings__: Config #插件的配置, 读env出来的那些

__plugin_version__:str #插件版本, 如果没有就从包元数据读取
__plugin_author__ = 'Author <[email protected]>'  #插件作者声明, 不写就没有

@dataclass(eq=False)
class PluginMetadata:
    """插件元信息，由插件编写者提供"""

    name: str
    """插件可阅读名称"""
    description: str
    """插件功能介绍"""
    usage: str
    """插件使用方法（暂时只支持str）"""
    config: Optional[Type[BaseModel]] = None
    """插件配置项"""
    # version: str
    """插件版本, 如果没有就从包元数据读取"""
    # author: str
    """插件作者声明, 不写就没有"""
    extra: Dict[Any, Any] = field(default_factory=dict)
    """额外自定义信息"""

__plugin_meta__ = PluginMetadata(...)

API规范（未确定）

添加一个钩子, 在插件加载完成后调用, 返回包含上述字段的函数

def plugin_load_callback(plugin_name:str,plugin:Module)->Optional[PluginMetadata]:
	"""
	如果返回None就不管了, 如果返回了元数据就取, 如果异常阻止该插件加载并记录该异常
	如果有多个返回元数据的行为呢?
	"""
    	...

添加能够读取全部插件元数据的API

添加一个内建插件叫nonebot.plugin.help提供最简单的帮助支持, 即: 将nonebot-plugin-help合并进来

兼容性

理论上不会break, 如果__plugin_meta__没写就代表没有声明元数据

其他

可以考虑为适配了以上信息的插件在插件商店中优先推荐, 或者进行标识

文档描述不够细致 比如描述关于插件的配置项的 plugin_config.json

{
  "plugins": ["path.to.your.plugin"],
  "plugin_dirs": ["path/to/your/plugins"]
}

在一个新手刚刚入门的情况下,请问这个plugin_config.json 相对于bot.py 是什么位置 这个配置文件是写在项目根目录下还是写在plugin/{plugin_name}/plugin_config.json 作为一个实列 他的目录结构是什么样的 以及 是不是有一个手把手 用每一个commit标注清楚 每一个行为在干什么的模板样例的仓库

所有的文档是及其零散,将每一个配置项单独拿出来说 但是并没有清楚的讲配置所在整个项目当中的位置是怎样的

NoneBot2文档改进计划

Related: #3 ~~#372~~

描述问题或主题

NoneBot2文档由于一些原因~~主要是我们语文太菜~~，它的撰写方法存在各种问题，对新手的理解和使用造成了困难。 我们在这里希望对NoneBot现有的文档结构作出一点改进。

但是这不是我们几位开发者能够完成的。 我们都是普通人，在完成学习和工作之余维护项目代码和文档，实在感觉有些分身乏术。

我们衷心希望，看到这个issue的每一个人，都为这个文档，作出一份自己的贡献。 而一份好的文档，需要你们每个人的帮助。

需作出的修改

我在这里提供一个列表，包含了我个人在阅读文档过程中发现的一些问题 大家可以在Issue下方补充自己的见解，我会加到下面的这个列表中 如果各位看到这里面的一些问题自己有能力解决，可以向我们提交PR进行修改。

• [ ] 在文档开篇介绍NoneBot的组成部分（Adapter，Driver，Plugin...）
  • 这部分不用特别详细，因为进阶会详细讲事件处理流程这里
• [ ] 在安装方式一节给出最推荐的一种
  • [ ] 添加一个使用Conda作为虚拟环境管理工具使用nb-cli的教程
    • 因为它在各种平台上算是比较好装的，也比较适合nb-cli的操作需要
  • 是不是应该把给只使用插件的用户的教程放在这里？
• [ ] 把使用脚手架移到教程一节，将教程以脚手架创建的项目结构为核心展开
  • [ ] 引导式教程，分步骤，第一步创建项目，第二部选择驱动器/注册适配器 这样的
  • [ ] 创建插件一步从脚手架命令开始，讲解创建插件的文件结构，引入Python包的概念
  • [ ] 简化加载插件一节，将各种加载插件方式移动到API参考部分
    • 加一条警告，不要随便动bot.py，除非你知道你在干啥
  • [ ] 详细化定义插件配置一节，加几个常见字段类型的示例，并且告诉开发者，插件配置应该从哪载入，什么时候实例化
    • 结合脚手架创建的文件结构(config.py)进行讲解
  • [ ] 定义事件响应器部分，应该先解释会话的概念
    • [ ] 权限控制这里可以直接说，为了可复用的控制一个事件能否被响应，我们提供了两种解决方案，然后打个表格做对比
    • [ ] 创建事件响应器，这个地方给例子比较好（比如教用户自己写个echo？），然后具体有哪些扔API文档
  • [ ] 定义事件处理流程，把got和receive位置换一下，最好给一个例子做对比
    • [ ] 获取上下文信息这一步可以开始提及简单的依赖注入了，给个例子，说明一些依赖是怎样声明的
      • 具体有哪些依赖就不用报菜名了，直接扔API文档链接
  • [ ] 删除事件响应器操作一节，补全API相关部分，直接扔链接
  • [ ] 优化插件示例一节，按照上面的步骤，构建一个插件应该被打散成了很多步，这里需要给所有文件做个总结，然后可以提一些高阶的东西
  • [ ] 移动自定义日志一节到进阶，因为开发入门似乎用不到
• [ ] 将钩子函数一节和进阶首页工作原理篇合并，在讲解工作原理的时候标示出各个钩子的运行时机，给个API文档链接即可
• [ ] 跨插件访问，加上直接import这一种方法，讲明什么时候该require，什么时候直接import就行
• [ ] 权限控制，这个地方想要表达的本质就是PERMISSION是一个(bot,event)->Awaitable[bool]，可以改一下表述方式
• [ ] 移动发布插件到进阶最后，让用户在发布插件前就对NoneBot有一个完整的了解
• [ ] 删除定时任务的从NoneBot v1迁移一节
  • [ ] 尝试修改scheduler插件为可以直接import的版本

如果对以上部分有任何疑问，也可以在官方交流群里面直接联系我们

最后，在这里感谢你们对NoneBot社区作出的贡献！