🔖 Release 2.0.0-beta.3

Co-authored-by: MeetWq <MeetWq@users.noreply.github.com>

.devcontainer/Dockerfile

@@ -0,0 +1,20 @@
+# See here for image contents: https://github.com/microsoft/vscode-dev-containers/tree/v0.233.0/containers/codespaces-linux/.devcontainer/base.Dockerfile
+
+FROM mcr.microsoft.com/vscode/devcontainers/universal:linux
+
+# ** [Optional] Uncomment this section to install additional packages. **
+# USER root
+#
+# RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
+#     && apt-get -y install --no-install-recommends <your-package-list-here>
+
+USER codespace
+
+# [Required] Poetry
+RUN curl -sSL https://install.python-poetry.org | python - -y
+RUN poetry config virtualenvs.in-project true
+
+# [Required] Gitmoji CLI
+# Deprecated: Maybe removed once nonemoji is done
+RUN yarn global add gitmoji-cli
+ENV PATH="$PATH:/home/codespace/.yarn/bin"

.devcontainer/devcontainer.json

@@ -0,0 +1,83 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the README at:
+// https://github.com/microsoft/vscode-dev-containers/tree/v0.233.0/containers/codespaces-linux
+{
+  "name": "NoneBot",
+  "build": {
+    "dockerfile": "Dockerfile",
+    "context": ".."
+  },
+  "settings": {
+    "go.toolsManagement.checkForUpdates": "local",
+    "go.useLanguageServer": true,
+    "go.gopath": "/go",
+    "python.defaultInterpreterPath": "/opt/python/latest/bin/python",
+    "python.formatting.autopep8Path": "/usr/local/py-utils/bin/autopep8",
+    "python.formatting.blackPath": "/usr/local/py-utils/bin/black",
+    "python.formatting.yapfPath": "/usr/local/py-utils/bin/yapf",
+    "python.linting.banditPath": "/usr/local/py-utils/bin/bandit",
+    "python.linting.flake8Path": "/usr/local/py-utils/bin/flake8",
+    "python.linting.mypyPath": "/usr/local/py-utils/bin/mypy",
+    "python.linting.pycodestylePath": "/usr/local/py-utils/bin/pycodestyle",
+    "python.linting.pydocstylePath": "/usr/local/py-utils/bin/pydocstyle",
+    "python.linting.pylintPath": "/usr/local/py-utils/bin/pylint",
+    "python.analysis.diagnosticMode": "workspace",
+    "python.analysis.typeCheckingMode": "basic",
+    "[python]":{
+      "editor.defaultFormatter": "ms-python.black-formatter",
+      "editor.codeActionsOnSave": {
+        "source.organizeImports": true
+      }
+    },
+    "[javascript]": {
+      "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[html]": {
+      "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[typescript]": {
+      "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[javascriptreact]": {
+      "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[typescriptreact]": {
+      "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "lldb.executable": "/usr/bin/lldb",
+    "files.exclude": {
+      "**/__pycache__": true
+    },
+    "files.watcherExclude": {
+      "**/target/**": true,
+      "**/__pycache__": true
+    }
+  },
+  "remoteUser": "codespace",
+  "overrideCommand": false,
+  "mounts": ["source=codespaces-linux-var-lib-docker,target=/var/lib/docker,type=volume"],
+  "runArgs": [
+    "--cap-add=SYS_PTRACE",
+    "--security-opt",
+    "seccomp=unconfined",
+    "--privileged",
+    "--init"
+  ],
+
+  // Add the IDs of extensions you want installed when the container is created.
+  "extensions": [
+    "GitHub.vscode-pull-request-github",
+    "ms-python.python",
+    "ms-python.vscode-pylance",
+    "ms-python.isort",
+    "ms-python.black-formatter",
+    "EditorConfig.EditorConfig",
+    "esbenp.prettier-vscode",
+    "bradlc.vscode-tailwindcss"
+  ],
+
+  // Use 'forwardPorts' to make a list of ports inside the container available locally.
+  // "forwardPorts": [],
+
+  // "oryx build" will automatically install your dependencies and attempt to build your project
+  "postCreateCommand": "poetry install -E all && poetry run pre-commit install && yarn install"
+}

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+open_collective: nonebot
+custom: ["https://afdian.net/@nonebot"]

.github/ISSUE_TEMPLATE/bug-report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a bug report to help us improve
+title: 'Bug: Something went wrong'
+labels: bug
+assignees: ''
+
+---
+
+**描述问题：**
+
+A clear and concise description of what the bug is.
+
+**如何复现？**
+
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**期望的结果**
+
+A clear and concise description of what you expected to happen.
+
+**环境信息：**
+
+ - OS: [e.g. Linux]
+ - Python Version: [e.g. 3.8]
+ - Nonebot Version: [e.g. 2.0.0]
+
+**协议端信息：**
+
+ - 协议端: [e.g. go-cqhttp]
+ - 协议端版本: [e.g. 1.0.0]
+
+**截图或日志**
+
+If applicable, add screenshots to help explain your problem.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,14 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Question
+    url: https://discussions.nonebot.dev/
+    about: Ask questions about nonebot
+  - name: Plugin Publish
+    url: https://v2.nonebot.dev/store
+    about: Publish your plugin to nonebot homepage and nb-cli
+  - name: Adapter Publish
+    url: https://v2.nonebot.dev/store
+    about: Publish your adapter to nonebot homepage and nb-cli
+  - name: Bot Publish
+    url: https://v2.nonebot.dev/store
+    about: Publish your bot to nonebot homepage and nb-cli

.github/ISSUE_TEMPLATE/document.md

@@ -0,0 +1,17 @@
+---
+name: Document improvement
+about: Feedback on documentation, including errors and ideas
+title: 'Docs: some description'
+labels: documentation
+assignees: ''
+
+---
+
+**描述问题或主题：**
+
+
+**需做出的修改：**
+
+* [ ]  一些修改
+* [ ]  一些修改
+* [ ]  一些修改

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,16 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: 'Feature: Something you want'
+labels: enhancement
+assignees: ''
+
+---
+
+**是否在使用中遇到某些问题而需要新的特性？请描述：**
+
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**描述你所需要的特性：**
+
+A clear and concise description of what you want to happen.

.github/actions/build-api-doc/action.yml

@@ -0,0 +1,11 @@
+name: Build API Doc
+description: Build API Doc
+
+runs:
+  using: "composite"
+  steps:
+    - run: |
+        poetry run nb-autodoc nonebot
+        cp -r ./build/nonebot/* ./website/docs/api/
+        yarn prettier
+      shell: bash

.github/actions/setup-node/action.yml

@@ -0,0 +1,21 @@
+name: Setup Node
+description: Setup Node
+
+runs:
+  using: "composite"
+  steps:
+    - uses: actions/setup-node@v2
+      with:
+        node-version: "16"
+
+    - id: yarn-cache-dir-path
+      run: echo "::set-output name=dir::$(yarn cache dir)"
+      shell: bash
+
+    - uses: actions/cache@v2
+      with:
+        path: ${{ steps.yarn-cache-dir-path.outputs.dir }}
+        key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
+
+    - run: yarn install
+      shell: bash

.github/actions/setup-python/action.yml

@@ -0,0 +1,26 @@
+name: Setup Python
+description: Setup Python
+
+inputs:
+  python-version:
+    description: Python version
+    required: false
+    default: "3.9"
+
+runs:
+  using: "composite"
+  steps:
+    - uses: actions/setup-python@v2
+      with:
+        python-version: ${{ inputs.python-version }}
+        architecture: "x64"
+
+    - uses: Gr1N/setup-poetry@v7
+
+    - uses: actions/cache@v2
+      with:
+        path: ~/.cache/pypoetry/virtualenvs
+        key: ${{ runner.os }}-poetry-${{ inputs.python-version }}-${{ hashFiles('**/poetry.lock') }}
+
+    - run: poetry install -E all
+      shell: bash

.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: daily

.github/release-drafter.yml

@@ -0,0 +1,43 @@
+template: $CHANGES
+category-template: "### $TITLE"
+name-template: "Release v$RESOLVED_VERSION 🌈"
+tag-template: "v$RESOLVED_VERSION"
+change-template: "- $TITLE [@$AUTHOR](https://github.com/$AUTHOR) ([#$NUMBER]($URL))"
+change-title-escapes: '\<&'
+exclude-labels:
+  - "dependencies"
+  - "skip-changelog"
+categories:
+  - title: "💥 破坏性变更"
+    labels:
+      - "Breaking"
+  - title: "🚀 新功能"
+    labels:
+      - "feature"
+      - "enhancement"
+  - title: "🐛 Bug 修复"
+    labels:
+      - "fix"
+      - "bugfix"
+      - "bug"
+  - title: "📝 文档"
+    labels:
+      - "documentation"
+  - title: "💫 杂项"
+  - title: "🍻 插件发布"
+    label: "Plugin"
+  - title: "🍻 机器人发布"
+    label: "Bot"
+  - title: "🍻 适配器发布"
+    label: "Adapter"
+version-resolver:
+  major:
+    labels:
+      - "major"
+  minor:
+    labels:
+      - "minor"
+  patch:
+    labels:
+      - "patch"
+  default: patch

.github/workflows/api_docs.yml

@@ -1,41 +0,0 @@
-name: Build API Doc
-
-on:
-  pull_request:
-    types: [ opened, synchronize, reopened ]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v2
-        with:
-          ref: ${{ github.event.pull_request.head.sha }}
-
-      - name: Set up Python
-        uses: actions/setup-python@v2
-        with:
-          python-version: 3.8
-          architecture: "x64"
-
-      - name: Install Dependences
-        run: |
-          python -m pip install --upgrade pip
-          pip install poetry
-          poetry install
-
-      - name: Build Doc
-        run: poetry run sphinx-build -M markdown ./docs_build ./build
-
-      - name: Copy Files
-        run: cp -r ./build/markdown/* ./docs/api/
-
-      - run: |
-          git config user.name nonebot
-          git config user.email nonebot@nonebot.dev
-          git add .
-          git diff-index --quiet HEAD || git commit -m ":memo: update api docs"
-          git remote -vv
-          git remote add target ${{github.event.pull_request.head.repo.clone_url}}
-          git push target HEAD:${{github.event.pull_request.head.ref}}

.github/workflows/codecov.yml

@@ -0,0 +1,43 @@
+name: Code Coverage
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+
+jobs:
+  test:
+    name: Test Coverage
+    runs-on: ${{ matrix.os }}
+    concurrency:
+      group: test-coverage-${{ github.ref }}-${{ matrix.os }}-${{ matrix.python-version }}
+      cancel-in-progress: true
+    strategy:
+      matrix:
+        python-version: ["3.7", "3.8", "3.9", "3.10"]
+        os: [ubuntu-latest, windows-latest, macos-latest]
+      fail-fast: false
+    env:
+      OS: ${{ matrix.os }}
+      PYTHON_VERSION: ${{ matrix.python-version }}
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Setup Python environment
+        uses: ./.github/actions/setup-python
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Run Pytest
+        run: |
+          cd tests/
+          poetry run pytest -n auto --cov-report xml
+
+      - name: Upload coverage report
+        uses: codecov/codecov-action@v3
+        with:
+          env_vars: OS,PYTHON_VERSION
+          files: ./tests/coverage.xml
+          flags: unittests

.github/workflows/publish-bot.yml

@@ -0,0 +1,29 @@
+name: NoneBot2 Publish Bot
+
+on:
+  issues:
+    types: [opened, reopened, edited]
+  pull_request_target:
+    types: [closed]
+
+jobs:
+  publish_bot:
+    runs-on: ubuntu-latest
+    name: nonebot2 publish bot
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+        with:
+          token: ${{ secrets.GH_TOKEN }}
+
+      - name: NoneBot2 Publish Bot
+        uses: docker://ghcr.io/nonebot/nonebot2-publish-bot:main
+        with:
+          token: ${{ secrets.GH_TOKEN }}
+          config: >
+            {
+              "base": "master",
+              "plugin_path": "website/static/plugins.json",
+              "bot_path": "website/static/bots.json",
+              "adapter_path": "website/static/adapters.json"
+            }

.github/workflows/release-drafter.yml

@@ -0,0 +1,97 @@
+name: Release Drafter
+
+on:
+  push:
+    tags:
+      - v*
+  pull_request_target:
+    branches:
+      - master
+    types:
+      - closed
+
+jobs:
+  update-release-draft:
+    if: github.event_name == 'pull_request_target'
+    runs-on: ubuntu-latest
+    concurrency:
+      group: pull-request-changelog
+      cancel-in-progress: true
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          token: ${{ secrets.GH_TOKEN }}
+
+      - name: Setup Node Environment
+        uses: ./.github/actions/setup-node
+
+      - uses: release-drafter/release-drafter@v5
+        id: release-drafter
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Update Changelog
+        uses: docker://ghcr.io/nonebot/auto-changelog:master
+        with:
+          changelog_file: website/src/pages/changelog.md
+          latest_changes_position: '# 更新日志\n\n'
+          latest_changes_title: '## 最近更新'
+          replace_regex: '(?<=## 最近更新\n)[\s\S]*?(?=\n## )'
+          changelog_body: ${{ steps.release-drafter.outputs.body }}
+          commit_and_push: false
+
+      - name: Commit and Push
+        run: |
+          yarn prettier
+          git config user.name github-actions[bot]
+          git config user.email github-actions[bot]@users.noreply.github.com
+          git add .
+          git diff-index --quiet HEAD || git commit -m ":memo: Update changelog"
+          git push
+
+
+  release:
+    if: startsWith(github.ref, 'refs/tags/')
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Setup Python Environment
+        uses: ./.github/actions/setup-python
+
+      - name: Setup Node Environment
+        uses: ./.github/actions/setup-node
+
+      - name: Build API Doc
+        uses: ./.github/actions/build-api-doc
+
+      - run: |
+          echo "TAG_NAME=${GITHUB_REF#refs/tags/}" >> $GITHUB_ENV
+
+      - uses: release-drafter/release-drafter@v5
+        with:
+          name: Release ${{ env.TAG_NAME }} 🌈
+          tag: ${{ env.TAG_NAME }}
+          publish: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and Publish Package
+        run: |
+          poetry build
+          poetry publish -u ${{secrets.PYPI_USERNAME}} -p ${{secrets.PYPI_PASSWORD}}
+          gh release upload --clobber ${{ env.TAG_NAME }} dist/*.tar.gz dist/*.whl
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and Publish Doc Package
+        run: |
+          yarn build:plugin --out-dir ../packages/nonebot-plugin-docs/nonebot_plugin_docs/dist
+          export NONEBOT_VERSION=`poetry version -s`
+          cd packages/nonebot-plugin-docs/
+          poetry version $NONEBOT_VERSION
+          poetry build
+          poetry publish -u ${{secrets.PYPI_USERNAME}} -p ${{secrets.PYPI_PASSWORD}}
+          gh release upload --clobber ${{ env.TAG_NAME }} dist/*.tar.gz dist/*.whl
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/release.yml

@@ -0,0 +1,47 @@
+name: Release
+
+on:
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          ref: master
+          token: ${{ secrets.GH_TOKEN }}
+
+      - name: Setup Python Environment
+        uses: ./.github/actions/setup-python
+
+      - name: Setup Node Environment
+        uses: ./.github/actions/setup-node
+
+      - name: Build API Doc
+        uses: ./.github/actions/build-api-doc
+
+      - run: echo "TAG_NAME=v$(poetry version -s)" >> $GITHUB_ENV
+
+      - name: Archive Changelog
+        uses: docker://ghcr.io/nonebot/auto-changelog:master
+        with:
+          changelog_file: website/src/pages/changelog.md
+          archive_regex: '(?<=## )最近更新(?=\n)'
+          archive_title: ${{ env.TAG_NAME }}
+          commit_and_push: false
+
+      - name: Archive Files
+        run: |
+          yarn archive $(poetry version -s)
+          yarn prettier
+
+      - name: Push Tag
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email github-actions[bot]@users.noreply.github.com
+          git add .
+          git commit -m ":bookmark: Release $(poetry version -s)"
+          git tag ${{ env.TAG_NAME }}
+          git push && git push --tags

.github/workflows/website-deploy.yml

@@ -0,0 +1,44 @@
+name: Site Deploy
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    concurrency:
+      group: website-deploy-${{ github.ref }}
+      cancel-in-progress: true
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Setup Python Environment
+        uses: ./.github/actions/setup-python
+
+      - name: Setup Node Environment
+        uses: ./.github/actions/setup-node
+
+      - name: Build API Doc
+        uses: ./.github/actions/build-api-doc
+
+      - name: Build Doc
+        run: yarn build
+
+      - name: Get Branch Name
+        run: echo "BRANCH_NAME=$(echo ${GITHUB_REF#refs/heads/})" >> $GITHUB_ENV
+
+      - name: Deploy to Netlify
+        uses: nwtgck/actions-netlify@v1
+        with:
+          publish-dir: "./website/build"
+          production-deploy: true
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          deploy-message: "Deploy ${{ env.BRANCH_NAME }}@${{ github.sha }}"
+          enable-commit-comment: false
+          alias: ${{ env.BRANCH_NAME }}
+        env:
+          NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
+          NETLIFY_SITE_ID: ${{ secrets.SITE_ID }}

.github/workflows/website-preview.yml

@@ -0,0 +1,45 @@
+name: Site Deploy(Preview)
+
+on:
+  pull_request_target:
+
+jobs:
+  preview:
+    runs-on: ubuntu-latest
+    concurrency:
+      group: pull-request-preview-${{ github.event.number }}
+      cancel-in-progress: true
+
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+
+      - name: Setup Python Environment
+        uses: ./.github/actions/setup-python
+
+      - name: Setup Node Environment
+        uses: ./.github/actions/setup-node
+
+      - name: Build API Doc
+        uses: ./.github/actions/build-api-doc
+
+      - name: Build Doc
+        run: yarn build
+
+      - name: Get Deploy Name
+        run: |
+          echo "DEPLOY_NAME=deploy-preview-${{ github.event.number }}" >> $GITHUB_ENV
+
+      - name: Deploy to Netlify
+        uses: nwtgck/actions-netlify@v1
+        with:
+          publish-dir: "./website/build"
+          production-deploy: false
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          deploy-message: "Deploy ${{ env.DEPLOY_NAME }}@${{ github.sha }}"
+          enable-commit-comment: false
+          alias: ${{ env.DEPLOY_NAME }}
+        env:
+          NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
+          NETLIFY_SITE_ID: ${{ secrets.SITE_ID }}

.gitignore

@@ -1,5 +1,296 @@
-# ----- Python -----
+# ----- Project -----
 
+.idea
+.vscode
+dev
+docs_build/_build
+!tests/.env
+.docusaurus
+website/docs/api/**/*.md
+
+# Created by https://www.toptal.com/developers/gitignore/api/python,node,visualstudiocode,jetbrains,macos,windows,linux
+# Edit at https://www.toptal.com/developers/gitignore?templates=python,node,visualstudiocode,jetbrains,macos,windows,linux
+
+### JetBrains ###
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# AWS User-specific
+.idea/**/aws.xml
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+# .idea/artifacts
+# .idea/compiler.xml
+# .idea/jarRepositories.xml
+# .idea/modules.xml
+# .idea/*.iml
+# .idea/modules
+# *.iml
+# *.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+### JetBrains Patch ###
+# Comment Reason: https://github.com/joeblau/gitignore.io/issues/186#issuecomment-215987721
+
+# *.iml
+# modules.xml
+# .idea/misc.xml
+# *.ipr
+
+# Sonarlint plugin
+# https://plugins.jetbrains.com/plugin/7973-sonarlint
+.idea/**/sonarlint/
+
+# SonarQube Plugin
+# https://plugins.jetbrains.com/plugin/7238-sonarqube-community-plugin
+.idea/**/sonarIssues.xml
+
+# Markdown Navigator plugin
+# https://plugins.jetbrains.com/plugin/7896-markdown-navigator-enhanced
+.idea/**/markdown-navigator.xml
+.idea/**/markdown-navigator-enh.xml
+.idea/**/markdown-navigator/
+
+# Cache file creation bug
+# See https://youtrack.jetbrains.com/issue/JBR-2257
+.idea/$CACHE_FILE$
+
+# CodeStream plugin
+# https://plugins.jetbrains.com/plugin/12206-codestream
+.idea/codestream.xml
+
+### Linux ###
+*~
+
+# temporary files which can be created if a process still has a handle open of a deleted file
+.fuse_hidden*
+
+# KDE directory preferences
+.directory
+
+# Linux trash folder which might appear on any partition or disk
+.Trash-*
+
+# .nfs files are created when an open file is removed but is still being accessed
+.nfs*
+
+### macOS ###
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+### Node ###
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+.env.test
+.env.production
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+### Node Patch ###
+# Serverless Webpack directories
+.webpack/
+
+# Optional stylelint cache
+.stylelintcache
+
+# SvelteKit build / generate output
+.svelte-kit
+
+### Python ###
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]
@@ -22,6 +313,7 @@ parts/
 sdist/
 var/
 wheels/
+share/python-wheels/
 *.egg-info/
 .installed.cfg
 *.egg
@@ -40,23 +332,25 @@ pip-delete-this-directory.txt
 # Unit test / coverage reports
 htmlcov/
 .tox/
+.nox/
 .coverage
 .coverage.*
-.cache
 nosetests.xml
 coverage.xml
 *.cover
+*.py,cover
 .hypothesis/
 .pytest_cache/
+cover/
 
 # Translations
 *.mo
 *.pot
 
 # Django stuff:
-*.log
 local_settings.py
 db.sqlite3
+db.sqlite3-journal
 
 # Flask stuff:
 instance/
@@ -69,22 +363,39 @@ instance/
 docs/_build/
 
 # PyBuilder
+.pybuilder/
 target/
 
 # Jupyter Notebook
 .ipynb_checkpoints
 
-# pyenv
-.python-version
+# IPython
+profile_default/
+ipython_config.py
 
-# celery beat schedule file
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
 celerybeat-schedule
+celerybeat.pid
 
 # SageMath parsed files
 *.sage.py
 
 # Environments
-.env
 .venv
 env/
 venv/
@@ -104,87 +415,61 @@ venv.bak/
 
 # mypy
 .mypy_cache/
+.dmypy.json
+dmypy.json
 
-# ----- Node -----
+# Pyre type checker
+.pyre/
 
-# Logs
-logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
+# pytype static type analyzer
+.pytype/
 
-# Runtime data
-pids
-*.pid
-*.seed
-*.pid.lock
+# Cython debug symbols
+cython_debug/
 
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
+### VisualStudioCode ###
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+*.code-workspace
 
-# Coverage directory used by tools like istanbul
-coverage
+# Local History for Visual Studio Code
+.history/
 
-# nyc test coverage
-.nyc_output
+### VisualStudioCode Patch ###
+# Ignore all local history of files
+.history
+.ionide
 
-# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
+# Support for Project snippet scope
+!.vscode/*.code-snippets
 
-# Bower dependency directory (https://bower.io/)
-bower_components
+### Windows ###
+# Windows thumbnail cache files
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
 
-# node-waf configuration
-.lock-wscript
+# Dump file
+*.stackdump
 
-# Compiled binary addons (https://nodejs.org/api/addons.html)
-build/Release
+# Folder config file
+[Dd]esktop.ini
 
-# Dependency directories
-node_modules/
-jspm_packages/
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
 
-# TypeScript v1 declaration files
-typings/
+# Windows Installer files
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
 
-# Optional npm cache directory
-.npm
+# Windows shortcuts
+*.lnk
 
-# Optional eslint cache
-.eslintcache
-
-# Optional REPL history
-.node_repl_history
-
-# Output of 'npm pack'
-*.tgz
-
-# Yarn Integrity file
-.yarn-integrity
-
-# dotenv environment variables file
-.env
-
-# parcel-bundler cache (https://parceljs.org/)
-.cache
-
-# next.js build output
-.next
-
-# nuxt.js build output
-.nuxt
-
-# vuepress build output
-.vuepress/dist
-
-# Serverless directories
-.serverless
-
-# ----- Project -----
-
-.idea
-.vscode
-dev
-docs_build/_build
-!tests/.env
+# End of https://www.toptal.com/developers/gitignore/api/python,node,visualstudiocode,jetbrains,macos,windows,linux

.pre-commit-config.yaml

@@ -0,0 +1,22 @@
+ci:
+  autofix_commit_msg: ":rotating_light: auto fix by pre-commit hooks"
+  autofix_prs: true
+  autoupdate_branch: master
+  autoupdate_schedule: monthly
+  autoupdate_commit_msg: ":arrow_up: auto update by pre-commit hooks"
+repos:
+  - repo: https://github.com/pycqa/isort
+    rev: 5.10.1
+    hooks:
+      - id: isort
+
+  - repo: https://github.com/psf/black
+    rev: 22.3.0
+    hooks:
+      - id: black
+
+  - repo: https://github.com/pre-commit/mirrors-prettier
+    rev: v2.6.2
+    hooks:
+      - id: prettier
+        types_or: [javascript, jsx, ts, tsx, markdown]

.prettierignore

@@ -0,0 +1 @@
+.github/**/*.md

.prettierrc

@@ -0,0 +1,9 @@
+{
+  "tabWidth": 2,
+  "useTabs": false,
+  "endOfLine": "lf",
+  "arrowParens": "always",
+  "singleQuote": false,
+  "trailingComma": "es5",
+  "semi": true
+}

.style.yapf

@@ -1,2 +0,0 @@
-[style]
-based_on_style = google

.yarnrc

@@ -0,0 +1 @@
+registry "https://registry.npmjs.org/"

CHANGELOG.md

@@ -0,0 +1,3 @@
+# Changelog
+
+See [changelog.md](./website/src/pages/changelog.md) or <https://v2.nonebot.dev/changelog>

CODE_OF_CONDUCT.md

@@ -0,0 +1,86 @@
+# NoneBot2 贡献者公约
+
+## 我们的承诺
+
+身为项目成员、贡献者、负责人，我们保证参与此社区的每个人都不受骚扰，不论其年龄、体型、身体条件、民族、性征、性别认同与表现、经验水平、教育程度、社会地位、国籍、相貌、种族、宗教信仰及性取向如何。
+
+我们承诺致力于建设开放、友善、多元、包容、健康的社区环境。
+
+## 我们的准则
+
+有助于促进本社区积极环境的行为包括但不限于：
+
+- 与人为善、推己及人
+- 尊重不同的主张、观点和经历
+- 积极提出、耐心接受有益批评
+- 面对过失，承担责任、认真道歉、从中学习
+- 关注社区共同诉求，而非一己私利
+
+不当行为包括但不限于：
+
+- 发布与性有关的言论或图像，以及任何形式的献殷勤或勾引
+- 挑衅行为、侮辱或贬损的言论、人身及政治攻击
+- 公开或私下骚扰
+- 未获明确授权擅自发布他人的资料，如地址、电子邮箱等
+- 其他有理由认定为违反职业操守的不当行为
+
+## 落实之义务
+
+社区负责人有责任诠释什么是“妥当行为”，并据此准则，妥善公正地认定与处置不当、威胁、冒犯及有害的行为。
+
+社区负责人有权利和义务删除、编辑、拒绝违背本公约的评论（comment）、提交（commit）、代码、维基（wiki）编辑、问题（issue）等贡献。如有必要，需告知采取措施的理由。
+
+## 适用范围
+
+此行为标准适用于本社区全部场合，以及在其他场合代表本社区的个人。
+
+代表本社区的情形包括但不限于：使用官方电子邮件与社交平台、作为指定代表参与在线或线下活动。
+
+## 贯彻落实
+
+如遇滥用、骚扰等不当行为，请通过 contact@nonebot.dev 向我们举报。我们将迅速审议并调查全部投诉。
+
+社区全体负责人有义务保密举报者信息。
+
+## 指导方针
+
+社区负责人将依据下列方案判断并处置违纪行为：
+
+### 一、督促
+
+**社区影响**：用语不当、举止不符合道德或不受社区欢迎。
+
+**处理意见**：由社区负责人予以非公开的书面警告，阐明违纪事由、解释举止如何不妥。或要求公开道歉。
+
+### 二、警告
+
+**社区影响**：一起或多起事件中的违纪行为。
+
+**处理意见**：警告继续违纪的后果、违纪者在特定时间内禁止与当事人往来、不得擅自与社区执法者往来，禁令涵盖社区内外、社交网络在内的一切联络。如有违反，可致封禁乃至开除。
+
+### 三、封禁
+
+**社区影响**：严重违纪行为，包括屡教不改。
+
+**处理意见**：违纪者在特定时间内禁止与社区的任何往来或公开联络，禁止任何与当事人公开或私下往来，不得擅自与社区管理者往来。如有违反，可导致开除。
+
+### 四、开除
+
+**社区影响**：典型违纪行为，例如屡教不改、骚扰某个人、敌对或贬低某个群体。
+
+**处理意见**：无限期禁止违纪者与项目社区的一切公开往来。
+
+## 来源
+
+本行为标准改编自[参与者公约][homepage]2.0 版，可在此查阅：[https://www.contributor-covenant.org/zh-cn/version/2/0/code_of_conduct.html][v2.0]
+
+指导方针借鉴自[Mozilla 纪检分级][mozilla coc]。
+
+此行为标准常见问题请洽：[https://www.contributor-covenant.org/faq][faq]。
+另有诸译本：[https://www.contributor-covenant.org/translations][translations]。
+
+[homepage]: https://www.contributor-covenant.org
+[v2.0]: https://www.contributor-covenant.org/version/2/0/code_of_conduct.html
+[mozilla coc]: https://github.com/mozilla/diversity
+[faq]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

CONTRIBUTING.md

@@ -0,0 +1,78 @@
+# NoneBot2 贡献指南
+
+首先，感谢你愿意为 NoneBot2 贡献自己的一份力量！
+
+本指南旨在引导你更规范地向 NoneBot2 提交贡献，请务必认真阅读。
+
+## 提交 Issue
+
+在提交 Issue 前，我们建议你先查看 [FAQ](https://github.com/nonebot/discussions/discussions/13) 与 [已有的 Issues](https://github.com/nonebot/nonebot2/issues)，以防重复提交。
+
+### 报告问题、故障与漏洞
+
+NoneBot2 仍然是一个不够稳定的开发中项目，如果你在使用过程中发现问题并确信是由 NoneBot2 引起的，欢迎提交 Issue。
+
+### 建议功能
+
+NoneBot2 还未进入正式版，欢迎在 Issue 中提议要加入哪些新功能。
+
+为了让开发者更好地理解你的意图，请认真描述你所需要的特性，可能的话可以提出你认为可行的解决方案。
+
+## Pull Request
+
+NoneBot 使用 [poetry](https://python-poetry.org/) 管理项目依赖，由于 pre-commit 也经其管理，所以在此一并说明。
+
+下面的命令能在已安装 poetry 和 yarn 的情况下帮你快速配置开发环境。
+
+```bash
+# 安装 python 依赖
+poetry install
+# 安装 pre-commit git hook
+pre-commit install
+# 安装 gitmoji git hook
+yarn global add gitmoji-cli
+gitmoji -i
+```
+
+### 使用 GitHub Codespaces (Dev Container)
+
+使用 GitHub Codespaces 选择 `NoneBot2` 项目，然后选择 `.devcontainer/devcontainer.json` 配置即可。
+
+### Commit 规范
+
+请确保你的每一个 commit 都能清晰地描述其意图，一个 commit 尽量只有一个意图。
+
+NoneBot 的 commit message 格式遵循 [gitmoji](https://gitmoji.dev/) 规范，在创建 commit 时请牢记这一点。
+
+### 撰写文档
+
+NoneBot2 的文档使用 [docusaurus](https://docusaurus.io/)，它有一些 [Markdown 特性](https://docusaurus.io/zh-CN/docs/markdown-features) 可能会帮助到你。
+
+NoneBot2 文档并没有具体的行文风格规范，但我们建议你尽量写得简单易懂。
+
+如果你需要在本地预览修改后的文档，可以使用 yarn 安装文档依赖后启动 dev server，如下所示：
+
+```bash
+yarn install
+yarn start
+```
+
+### 参与开发
+
+NoneBot2 的代码风格遵循 [PEP 8](https://www.python.org/dev/peps/pep-0008/) 与 [PEP 484](https://www.python.org/dev/peps/pep-0484/) 规范，请确保你的代码风格和项目已有的代码保持一致，变量命名清晰，有适当的注释与测试代码。
+
+## 为社区做贡献
+
+你可以在 NoneBot 商店上架自己的适配器、插件、机器人，具体步骤可参考 [发布插件](https://v2.nonebot.dev/docs/advanced/publish-plugin) 一节。
+
+我们仅对插件的兼容性进行简单测试，并会在下一个版本发布前对与该版本不兼容的插件作出处理。
+
+虽然对插件的内容没有严格限制，但我们还是建议在上架插件之前先查看商店有无功能一致的插件。如果你想要上架商店的插件功能与现有插件不完全重合，请在插件说明中补充其与现有插件的区别。
+
+同时，如果你参考或基于他人发行的代码进行开发，请注意遵守各代码所使用的开源许可协议。
+
+## Git 工作流
+
+`master` 分支为 NoneBot 的开发分支，请在任何情况下都不要直接修改 `master` 分支，而是创建一个目标分支为 `nonebot:master` 的 Pull Request 来提交修改。
+
+如果你不是 NoneBot 团队的成员，可在 fork 本仓库后，向本仓库的 `master` 分支发起 Pull Request，注意遵循先前提到的 commit message 规范创建 commit。我们将在 code review 通过后通过 squash merge 方式将您的贡献合并到主分支。

LICENSE

@@ -1,5 +1,5 @@
 The MIT License (MIT)
-Copyright (c) 2018 Richard Chien
+Copyright (c) 2020 NoneBot Team
 
 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

README.md

@@ -1,37 +1,187 @@
-<div align=center>
-  <img src="./docs/.vuepress/public/logo.png" width="200" height="200">
+<!-- markdownlint-disable MD033 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
 
-[![License](https://img.shields.io/github/license/nonebot/nonebot2.svg)](LICENSE)
-[![PyPI](https://img.shields.io/pypi/v/nonebot2.svg)](https://pypi.python.org/pypi/nonebot2)
-![Python Version](https://img.shields.io/badge/python-3.7+-blue.svg)
-![CQHTTP Version](https://img.shields.io/badge/cqhttp-11+-black.svg)
-[![QQ 群](https://img.shields.io/badge/qq%E7%BE%A4-768887710-orange.svg)](https://jq.qq.com/?_wv=1027&k=5OFifDh)
-[![Telegram](https://img.shields.io/badge/telegram-chat-blue.svg)](https://t.me/cqhttp)
-[![QQ 版本发布群](https://img.shields.io/badge/%E7%89%88%E6%9C%AC%E5%8F%91%E5%B8%83%E7%BE%A4-218529254-green.svg)](https://jq.qq.com/?_wv=1027&k=5Nl0zhE)
-[![Telegram 版本发布频道](https://img.shields.io/badge/%E7%89%88%E6%9C%AC%E5%8F%91%E5%B8%83%E9%A2%91%E9%81%93-join-green.svg)](https://t.me/cqhttp_release)
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable-next-line MD036 -->
+_✨ 跨平台 Python 异步机器人框架 ✨_
+<!-- prettier-ignore-end -->
 
 </div>
 
+<p align="center">
+  <a href="https://raw.githubusercontent.com/nonebot/nonebot2/master/LICENSE">
+    <img src="https://img.shields.io/github/license/nonebot/nonebot2" alt="license">
+  </a>
+  <a href="https://pypi.python.org/pypi/nonebot2">
+    <img src="https://img.shields.io/pypi/v/nonebot2" alt="pypi">
+  </a>
+  <img src="https://img.shields.io/badge/python-3.7.3+-blue" alt="python">
+  <a href="https://codecov.io/gh/nonebot/nonebot2">
+    <img src="https://codecov.io/gh/nonebot/nonebot2/branch/master/graph/badge.svg?token=2P0G0VS7N4" alt="codecov"/>
+  </a>
+  <a href="https://github.com/nonebot/nonebot2/actions/workflows/website-deploy.yml">
+    <img src="https://github.com/nonebot/nonebot2/actions/workflows/website-deploy.yml/badge.svg?branch=master&event=push" alt="site"/>
+  </a>
+  <a href="https://results.pre-commit.ci/latest/github/nonebot/nonebot2/master">
+    <img src="https://results.pre-commit.ci/badge/github/nonebot/nonebot2/master.svg" />
+  </a>
+  <br />
+  <a href="https://onebot.dev/">
+    <img src="https://img.shields.io/badge/OneBot-v11-black?style=social&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABABAMAAABYR2ztAAAAIVBMVEUAAAAAAAADAwMHBwceHh4UFBQNDQ0ZGRkoKCgvLy8iIiLWSdWYAAAAAXRSTlMAQObYZgAAAQVJREFUSMftlM0RgjAQhV+0ATYK6i1Xb+iMd0qgBEqgBEuwBOxU2QDKsjvojQPvkJ/ZL5sXkgWrFirK4MibYUdE3OR2nEpuKz1/q8CdNxNQgthZCXYVLjyoDQftaKuniHHWRnPh2GCUetR2/9HsMAXyUT4/3UHwtQT2AggSCGKeSAsFnxBIOuAggdh3AKTL7pDuCyABcMb0aQP7aM4AnAbc/wHwA5D2wDHTTe56gIIOUA/4YYV2e1sg713PXdZJAuncdZMAGkAukU9OAn40O849+0ornPwT93rphWF0mgAbauUrEOthlX8Zu7P5A6kZyKCJy75hhw1Mgr9RAUvX7A3csGqZegEdniCx30c3agAAAABJRU5ErkJggg==" alt="cqhttp">
+  </a>
+  <a href="https://ding-doc.dingtalk.com/document#/org-dev-guide/elzz1p">
+    <img src="https://img.shields.io/badge/%E9%92%89%E9%92%89-Bot-lightgrey?style=social&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAAAnFBMVEUAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD4jUzeAAAAM3RSTlMAQKSRaA+/f0YyFevh29R3cyklIfrlyrGsn41tVUs48c/HqJm9uZdhX1otGwkF9IN8V1CX0Q+IAAABY0lEQVRYw+3V2W7CMBAF0JuNQAhhX9OEfYdu9///rUVWpagE27Ef2gfO+0zGozsKnv6bMGzAhkNytIe5gDdzrwtTCwrbI8x4/NF668NAxgI3Q3UtFi3TyPwNQtPLUUmDd8YfqGLNe4v22XwEYb5zoOuF5baHq2UHtsKe5ivWfGAwrWu2mC34QM0PoCAuqZdOmiwV+5BLyMRtZ7dTSEcs48rzWfzwptMLyzpApka1SJ5FtR4kfCqNIBPEVDmqoqgwUYY5plQOlf6UEjNoOPnuKB6wzDyCrks///TDza8+PnR109WQdxLo8RKWq0PPnuXG0OXKQ6wWLFnCg75uYYbhmMIVVdQ709q33aHbGIj6Duz+2k1HQFX9VwqmY8xYsEJll2ahvhWgsjYLHFRXvIi2Qb0jzMQCzC3FAoydxCma88UCzE3JCWwkjCNYyMUCzHX4DiuTMawEwwhW6hnshPhjZzzJfAH0YacpbmRd7QAAAABJRU5ErkJggg==" alt="ding">
+  </a>
+  <a href="https://core.telegram.org/bots/api">
+    <img src="https://img.shields.io/badge/telegram-Bot-lightgrey?style=social&logo=telegram">
+  </a>
+  <a href="https://open.feishu.cn/document/home/index">
+    <img src="https://img.shields.io/badge/%E9%A3%9E%E4%B9%A6-Bot-lightgrey?style=social&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAMgAAADICAMAAACahl6sAAAAk1BMVEX///8zMzNJSUlSUlJcXFxtbW0zMzNLS0szMzMzMzNBQUGVlZUzMzM1NTU0NDQzMzMzMzM0NDQ0NDQ0NDQ3NzdDQ0M0NDQ2NjY4ODg9PT0zMzM0NDQ5OTk7OzszMzM0NDQ3NzczMzM0NDQ0NDQ0NDQ0NDQ3Nzc2NjY4ODg2NjY7Ozs0NDQ6Ojo6Ojo3Nzc4ODgzMzNGdMWJAAAAMHRSTlMD6h0TDgr8GNf0KQbvhLT45KKTmm4jwHVJLdLFQzbcjFTgzsq7rl58T2kyqD46Y1riMDRhAAAFr0lEQVR42uzZWXKiUACF4YMyqKAQhyjOc7STmLP/1bVlLukESIJ3sLGKbwFU/Q8HuIBKpVKpVCqVSqVSqVQqlUqlUvmNM10Mcfda/U6TPdw3e9lb8ayLO+bPniYu+amjNcPd8U7PFhML0RE5uCvnaY/5SVt0WFvckcu0vxjiYmDxbu5cl2mn9UVHRMa4B2LaP3RYKD1vL6adccRFLSLL/izxxbRz7UXHimdLlFdq2mlvnztYRznZh96cP3G/dkxQRrOnR5c/c5eiQ+S2UTbe/sHir9zD1w6+okz8aXvMItyRqE46ApSHmHYRYdLRoPCMcrAP3TkLC6fpDp5QAn/EtItqij3UG/zgQZH5aWc7ZqJjzA9jKFGf9ppXC3I6uMB/Mzh2mpQQ/Mnp4BSy1Kctx4pFx5qfhA4kqE87pCyrldfBDm6sLqat2mGnttXHDfkvYtryooHo2PCrFm5lcNw1qWr1XUeEm7BH3QYVRJNGcOmoietNmNKDWeKFnCo6b3Wc1drW/NsOLpFRqmmT4xgfPFw42Q7XhkFi2kq2DtKcR2Y8wpTacRdQ3aZYB59ggiOmrS6sFevgDNr9GW6pzRAZdsQsC3rV3x4i6uQha8+sB2h9am9c6rVBDj9ixr5k007rIs+CGV65pl3wXjRi2hrKYjFtM/rI02JaW3XaPYtGtZHHY9qL0lN7QuO2yBMzpenLTvtkZNos+AY1ZcpObtoLtWmrj6TNlCOuJqZ9M3PkaDBlIBHCmwpHyHpjSgMS2ryhcIqsmsWULmR0eTPhK7LsMdMOKHdJM+nw8E+8ZoYDOT3eRDDDuz6HNt7VeszaQtYDJch+38WRZ51TDO+0Y54hylzy0XHib2JI83c0zIoLd1hAeUus1jenQe2HQ79Dg6wB3i1d/uoNpS2JrulgHWqcRxqySjoObrFjfUlLVrVrOtiGMmdCA+ZJx8hlEa9QZ2+oXcNLOkIWEUAHe22sYxqykGdoUV//5w6eoKlkTI3Gdbx7CVmQB10lDWqzSTpemyyoAW28ubYO++oOLqBPbUUtJknHrMnCRihdyaOTdAQsLHSgtSTS2BEHLK4DvQYWFW2lOtiHZi3Fko6fXCjgNVooV0nHl7tMBP1aAaXtJDvYgwGxdMmzLzu1JUyYNSU7IAwiiZ8OJrxKlTzI38QnMORFoqSn8Fh9gikvIa/UVejgDMZMQ9mOOa8WwKCRyysslF6hn2HSwZX4+ew1KGEPCSZKhoqHMw9mLd1rO8aUMYZpexbRV/2AsYBxy7/t3NtuglAQheFR6wEPVEQtaq1WxQNqnfd/urY08QJFYHZS15D9vcHckMzOz/QWA9/3jqHrbmbr1bT10a90ncQcoiclgKY/Vq81q6P2JJqfI+NHPqdDSMRzsEtIXmYGcQcQk2fwKgHxTCIVJGMWwTu6sWGxPSFx+QpkOfz3QcYEJWQhtGsbR5aKCIrHInjXNsSDeITFZ6ELYZEMAnltY8AyawKz4KJAr21IBzkRmB6LOIRGOEhIaHYsciA0uxIshwa/DLQIzrAEy2HswBIBwck9yNOvbWT4YgHEU4zbEiyHsQsXhnmKccmxp2cbxvb8CyDbMBXwD4hsw1BQguUw9s4Mk20YOTFQtmHiDJVtGJhjZRtyEVi2ITbhnLBOMd5qOvqXwz9RFy3bkJpU0LINeTCsJdvIztHVZhsJo77SbOPG6FNltpFQqMxsE7hmS+9ymJxE7XKYUGupyzZS1Kbaso00tbWybONBTadyObyjPlaVbTycRFO28Uh9oyjbEJ/E2JImnVDXy1y6zpHvW5E2npJsI5unI9vIwVe3HKYZaMg2clkoyDby6Wl5mcv0Bp9t5DVEzzZyG4JnG/kdsLONArbQ2UYRlwZwtlHIsoGbbRSdRNtymGbf0LYcpgleQbMNwdUCbcthmrP2j++VjqdSy7Isy7Isy4LxDTcBnqEPd5jdAAAAAElFTkSuQmCC" alt="feishu">
+  </a>
+  <a href="https://bot.q.qq.com/wiki/">
+    <img src="https://img.shields.io/badge/QQ%E9%A2%91%E9%81%93-Bot-lightgrey?style=social&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAAC+lBMVEUAAAApRHRAbvYyVI4dMlsNGjcvTH5anN0/a5xdo+Vdpvpms/dMfvdcoPZjr/hJfu5krvA9Z+8/a+M9adxQjNdYmdVAbdU4XtRRjcxFd8wyVbM+aZowUJwpRJlZneRIevU5YORWl+1fqOZVle9ZnOpEdOk/aelepus/a+NQiuVKgeQ6YeRQi905X91EdtxAbthZnNlRjdk5YdpQjuhLgehhquc7Y+c6Y8k3XctWlcs0V8tJfMMzVsM9aMJVksdHebVKgLQyVJknP5REdKD///9irv9Ccf5EdP9GfP9jsf7+/f5SkP9mtf9GeP/+/vxJfv5Ukv9Ng/9boP9Gef1ls/9Ulf9Wl//+//5KgP9Nhv9dpP9Oiv9Tk/5Abv9Lg/9Fdv9NiP7///5Qj/7+/fxfpv9Nh/xhq/9QjP9Wm/79//1co/9ir/5fqf5bov9Qi//8/f1XmP1Wl/1ksv/7/v38/vv9/vlgqv9Znf9IfPzZ5fdeqP9nt/5anv5Xmf9Uk/1anvxpuf73/P34+/tot/9hrf1anvpMhvpSjv1pt/9ZnP1aofxTkfxNivza5/dOhPf+//1Ri/z+//vz+fvw9/tIf/v6/fpdofrI2PlYmfnF3Pe0y/Pm7/jW4/e0zvRapPxXlfpTkvpGevri7ffS3vVMiP5XnvxXnPtQivn3/Ph0r/dgpPZ1qfXi6/S9z/NYmf/z+v5Yn/7L2vlfmflUk/hXi/dRgvSw0fGnu+1dqP3t9Pthq/vA1vjc6vfU4vd4sfdepPdsn/dam/fU5fawzfRjjfRhi/NJhP0/a/y80fhTjfhrrfeXvvZuk/WyyPR9rvSqz/OcwfOmv/OSuPO0yfKguPCWr/BPi+9MheRKgv1gsPzq9PpgpvpVjvrN2/jG1vdonvbA0PSrx/OtxPCkxPDp8PvN4ftnuPuCufloqPiex/a3z/WPuvWQqvR2mfRplvReivSOqvOKufKGufKCrPKBoPJzlfFjr+88Ze6ftux8nOxxq/SGr/CFr/Cvx+3R19+QAAAARHRSTlMAEP4ZEwUEvC3S/v7+/Pv08PDXvJqampqSgEtJLS3f/Pz4+O/n5+bl4tTU1Lq6ure2trGdnZ2dlI6Afl5eXldMS0lJLRAR2gcAAAewSURBVFjDlZcFfBJRHMdvdnd3d3cn1qk3h4Et7EQ965h3KKgTQUGdOgYMHII6a5vO2d3d3d3d3X4+/t974A51xvfDu7vfP348HsdxR6VAulaN6lUu8SHVgQOpPpSoXK9Rq3TUf5CmSdWcB/oFcCBn1SZp/rG9aP6c/X5LzvxF/6W9Vqq2KZKq1t8sgvKT9pQt8gf9qb9QOVLWjux+K8oVSrE9bYNU7f6BVA3SpjD93O3+kdy//Ripcw34QefOnaViwM8iV+rf9Ffo7Kdr166du87vSgQGZGcIJocq/OIQlAv1EbAHDL/0hXzOhFxBP61f7vbJdJ0PFfN1RBB0MIPAUO7Alazvz+l0WY4+Pbthw4az66QG63Do6dEsuh+W9QO+//moVRet071L8phomUzBGPcGBwe3hxdmn5FVyGS0yZP0TodpHzy/kGQBygYjonUvbtpFraDwGUjYZ2JRVNSKK26+0EXjWNnkZciH26OjPy3gOZ5nVVCq+p0BzfK8wC/4FB2MLfL5+4sU7wkER7/dhN6aYxia0zKmvT0l7DUxHE1zHMcoVLJNb6ODUbB4EYpQHddcPHpXK5OpWNHp8CxbtmzmPqnBvpnLAIeTQdPT3j16EUer+yaQpT8i8pqAVi9h4cu1kZGR69bt7y9h/7p1EFz7cmEC+iTiwkgczUKmkC8ECkIs54wiI4j2j5EXQwj9QyCBNgCRIZbIj3ZRYET+nCVkP4TwKqTJHoJTXlbFscZzlv6WXr1CkpGKXhb0PozVynoj1SiTHV3lmvYC1JZnCQzNOG9a1BY1aAlKqbBYLEm8jWYSnpGypmBQTQ0sUp9iVCqr/bl60SK1UqlchIIzYCABB/BCIRR/breqVMwp9SIlUA2u39mVCPUWBlZQHz8DiT591t5euPD2WiUR6rXfiAKhnBHvhXVkrs9AGWX2dFTLGX0AZfxCTiaTHYwChTjl1LL8HZ+YccvJa52nfCL+IHyT3Lb4kVi1pAqOBPqMjPfSYHBmZBQSI6Nm0TTDXicCFCsy9HWfiDqGDPTxIzEFqTqDMVF6BTIYHEXUKhDMrMGEKddstIr2qajQYzT6sIeIrENVCsVc1VuRQeiU0FAYU4gBEkhfY5CBT4TCDJABkZWoCx0xxGB26BSspqyiFSowwAKUSNvoWUQQA1p/NRTLC9R5El+jZ5BBR9Qzffr0VbTICrNiQSC9yskKrN9g+hkoVOljp2N5njrUBdExlhj07UI4qGVZ7ePpREw/KLJa5xxfqu9sBRjMjCXJQ5SvaI3ehg0mELlz94oVu3ei3IQJE2J3eu0rdt/AAvAZoEMwp2L7Iias0aOlAYO+hHmrV89De5KVqAndicEaUhlLremOCJuHDeZ0D+v+V4jBPFK5hjrfA+E3CAvr8RfCwvwGWJ6nLmgQYTF6Gr4cZACCELN6Z+Kbr1/eJO5cHaOBBAyNpkeYZg86kWbGgAAuUBXDw8OXh4fH6BlkoNGgY43mxumkbR6HySiIomBKcHi2JZ2+odHELIdSzR5YbevMmHBMRar2EEyMXgXxOcvD4Viza88mnuNYhmNpDMMwIr9pzy4NJMOXIwMGDHBfbaog3k+LQzNgHscNmTZkSNwut0mgaQH6OK0NtmDG8yb3rrghY8YMiZuD5jozbhoSQwpShaeNAaYt3obWYIt58TQkzKe3JYisKCoUNKegwUFI8J7257agSi8SIAtT6UqPRxjc+De2axocLzYbzObjSVtX8Dyj1TICv2Jr0nEzsHLMmPFxZvS75d2GMSDGl4bbxypyuXy8wXBLUMloe6JBvtJgGB8BjitdiUfmuO/dc885kuhaaRg/fiVUwUi00zKVcAuqoLEKRVGN5UCE4bhJRdPiFrPZJZcQESEPwOUybxFpWmU6bsCZxuiyXnKEfIQ8wjWTZxSs6WRExNwRfiCByn4IOSRPwr+kit/qikChkvjmNc/Qob2HznWd5G1WgXbc2TF36A9GkI0fqLrj4AWrjT/pmju0d++heShEhqy9EUt3CwKso9F75OHSHTuWLp3bW8LcpSj28IjXCCsoCLuv4GjWDBSm5sCBSG6/zMNJDldjh2fBggVbEwdicOXAz1sh5HHwrBbON3bTdpKoCc1kCrg00xMHzICzwanD0VrTkoESlpi06L/dZuMUMoXjSaaNKIgmQMgzFti48corj1aEk88KJwpjXDJWwhIjSysUVi0HJ4bn1ZWNG1EwT/ItTpnhhCVuO8sKCjDgjNuHSwAD9M8lsJzdvcQXKyO502ueaTQwaNDmza/dl50+g9EStsMMwMB52f168+bho4dDKFNzSkKBQX4mH37w6MT69etPHCaacBiHHj04PHnQoNGkrkDgjWb6NslMJrSRhjZPHhQYSp+WCiCoWHJu2LBhl2BIDSASGMoY9MvNdjFfKUA2RCRHpQbFfne7nrHDqA4dOozCG/Qie6mAQURG6P+VoPS4DED7wONAkT4ohUeeAtm6/QPZCqSlUqJF+U6dOnVDA23Q/ldRvsUfH/vyZuv0R7LlDaL+TOsamSdNmjTuBwEic43W1N/JkDfH1EmIqT78xznyZvjXh+9m6XNM/Ikc6Zulof6DdIUb1s1Y6n3m+/czvy+VsW7Dwik9/n8HzjZEy9x05tIAAAAASUVORK5CYII=" alt="QQ频道">
+  </a>
+  <br />
+  <a href="https://jq.qq.com/?_wv=1027&k=5OFifDh">
+    <img src="https://img.shields.io/badge/QQ%E7%BE%A4-768887710-orange?style=flat-square" alt="QQ Chat Group">
+  </a>
+  <a href="https://qun.qq.com/qqweb/qunpro/share?_wv=3&_wwv=128&appChannel=share&inviteCode=7b4a3&appChannel=share&businessType=9&from=246610&biz=ka">
+    <img src="https://img.shields.io/badge/QQ%E9%A2%91%E9%81%93-NoneBot-5492ff?style=flat-square" alt="QQ Channel">
+  </a>
+  <a href="https://t.me/botuniverse">
+    <img src="https://img.shields.io/badge/telegram-botuniverse-blue?style=flat-square" alt="Telegram Channel">
+  </a>
+  <a href="https://discord.gg/VKtE6Gdc4h">
+    <img src="https://discordapp.com/api/guilds/847819937858584596/widget.png?style=shield" alt="Discord Server">
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://v2.nonebot.dev/">文档</a>
+  ·
+  <a href="https://v2.nonebot.dev/docs/start/installation">安装</a>
+  ·
+  <a href="https://v2.nonebot.dev/docs/tutorial/create-project">开始使用</a>
+  ·
+  <a href="#插件">文档打不开？</a>
+</p>
+
+<p align="center">
+  <a href="https://asciinema.org/a/464654">
+    <img src="https://v2.nonebot.dev/img/setup.svg">
+  </a>
+</p>
+
 ## 简介
 
-NoneBot2 是一个可扩展的 Python 异步机器人框架，它会对机器人收到的消息进行解析和处理，并以插件化的形式，分发给消息所对应的命令处理器和自然语言处理器，来完成具体的功能。
+NoneBot2 是一个现代、跨平台、可扩展的 Python 聊天机器人框架，它基于 Python 的类型注解和异步特性，能够为你的需求实现提供便捷灵活的支持。
 
-除了起到解析消息的作用，NoneBot 还为插件提供了大量实用的预设操作和权限控制机制，尤其对于命令处理器，它更是提供了完善且易用的会话机制和内部调用机制，以分别适应命令的连续交互和插件内部功能复用等需求。
+## 特色
 
-目前 NoneBot2 在 [FastAPI](https://fastapi.tiangolo.com/) 的基础上封装了与 [CQHTTP(OneBot) 协议](http://cqhttp.cc/)插件的网络交互。
+- 异步优先：基于 Python 的异步特性，即使是~~非常~~大量的消息，也能吞吐自如
+- 易于开发：配合 NB-CLI 脚手架，代码编写上手简单，没有过多的冗余代码，可以让开发者专注于业务逻辑
+- 生而可靠：100% 类型注解覆盖，配合编辑器的类型推导功能，能将绝大多数的 Bug 杜绝在编辑器中 ([编辑器支持](https://v2.nonebot.dev/docs/start/editor-support))
+- 社区丰富：社区用户众多，直接和间接用户超过十万人，每天都有大量的活跃用户 ([社区资源](#社区资源))
+- 海纳百川：一个框架，支持多个聊天软件平台，可自定义通信协议
+  - [OneBot 协议](https://onebot.dev/) (QQ 等)
+  - [钉钉](https://ding-doc.dingtalk.com/document#/org-dev-guide/elzz1p)
+  - [Telegram](https://core.telegram.org/bots/api)
+  - [飞书](https://open.feishu.cn/document/home/index)
+  - [QQ 频道](https://bot.q.qq.com/wiki/)
+- 坚实后盾：支持多种 web 框架，可自定义替换
+  - [FastAPI](https://fastapi.tiangolo.com/)
+  - [Quart](https://pgjones.gitlab.io/quart/) (异步 Flask)
+  - [aiohttp](https://docs.aiohttp.org/en/stable/)
+  - [httpx](https://www.python-httpx.org/)
+  - [websockets](https://websockets.readthedocs.io/en/stable/)
 
-得益于 Python 的 [asyncio](https://docs.python.org/3/library/asyncio.html) 机制，NoneBot 处理消息的吞吐量有了很大的保障，再配合 WebSocket 通信方式（也是最建议的通信方式），NoneBot 的性能可以达到 HTTP 通信方式的两倍以上，相较于传统同步 I/O 的 HTTP 通信，更是有质的飞跃。
+更多：[概览](https://v2.nonebot.dev/docs/)
 
-需要注意的是，NoneBot 仅支持 Python 3.7+ 及 CQHTTP(OneBot) 插件 v11+。
+## 什么不是 NoneBot2
 
-## 文档
+NoneBot2 不是某个平台或者协议的具体实现，它只负责和已有协议适配器通信，并处理接收到的事件。所以，“NoneBot 有 blabla 平台的 blabla 功能吗？”这种问题是与 NoneBot2 无关的。请在相应平台的功能文档中确认，或与相应平台的协议适配开发者联系。
 
-文档目前尚未完成，「API」部分由 sphinx 自动生成，你可以在 [这里](https://v2.nonebot.dev/) 查看。
+NoneBot2 不是 NoneBot1 的替代品。事实上，它们都在被积极的维护着。但是，如果你想尝试一些新功能，或者想要支持更多的平台，可以考虑使用 NoneBot2。
+
+> ~~NoneBot2 和 NoneBot1 的区别，就像是 VisualStudio Code 和 VisualStudio 一样~~
+
+## 即刻开始
+
+~~完整~~文档可以在 [这里](https://v2.nonebot.dev/) 查看。
+
+懒得看文档？下面是快速安装指南：
+
+1. (**强烈建议**)使用你喜欢的 Python 环境管理工具创建新的虚拟环境。
+
+2. 使用 `pip` (或其他) 安装 NoneBot 脚手架。
+
+   ```bash
+   pip install nb-cli
+   ```
+
+3. 使用脚手架创建项目
+
+   ```bash
+   nb create
+   ```
+
+## 社区资源
+
+### 常见问题
+
+- [常见问题解答(FAQ)](https://faq.nonebot.dev/)
+- [论坛(Discussion)](https://discussions.nonebot.dev/)
+
+### 教程/实际项目/经验分享
+
+- [awesome-nonebot](https://github.com/nonebot/awesome-nonebot)
+
+### 插件
+
+此外，NoneBot2 还有丰富的官方以及第三方现成的插件供大家使用：
+
+- [NoneBot-Plugin-Docs](https://github.com/nonebot/nonebot2/tree/master/packages/nonebot-plugin-docs)：离线文档至本地项目使用 (别再说文档打不开了！)
+
+  在项目目录下执行：
+
+  ```bash
+  nb plugin install nonebot_plugin_docs
+  ```
+
+  或者尝试以下镜像：
+
+  - [文档镜像(中国境内)](https://nb2.baka.icu)
+  - [文档镜像(Vercel)](https://nonebot2-vercel-mirror.vercel.app)
+
+- 其他插件请查看 [商店](https://v2.nonebot.dev/store)
+
+## 许可证
+
+`NoneBot` 采用 `MIT` 许可证进行开源
+
+```text
+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.
+```
 
 ## 贡献
 
-如果你在使用过程中发现任何问题，可以 [提交 issue](https://github.com/nonebot/nonebot2/issues/new) 或自行 fork 修改后提交 pull request。
+请参考 [贡献指南](./CONTRIBUTING.md)
 
-如果你要提交 pull request，请确保你的代码风格和项目已有的代码保持一致，遵循 [PEP 8](https://www.python.org/dev/peps/pep-0008/)，变量命名清晰，有适当的注释。
+### 鸣谢
+
+感谢以下开发者对 NoneBot2 作出的贡献：
+
+<a href="https://github.com/nonebot/nonebot2/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=nonebot/nonebot2" />
+</a>

archive/2.0.0a3/README.md

@@ -1,15 +0,0 @@
----
-home: true
-heroImage: /logo.png
-tagline: An asynchronous QQ bot framework.
-actionText: 开始使用
-actionLink: /guide/
-features:
-  - title: 简洁
-    details: 提供极其简洁易懂的 API，使你可以毫无压力地开始验证你的绝佳创意，只需编写最少量的代码，即可实现丰富的功能。
-  - title: 易于扩展
-    details: 精心设计的消息处理流程使得你可以很方便地将原型扩充为具有大量实用功能的完整聊天机器人，并持续保证扩展性。
-  - title: 高性能
-    details: 采用异步 I/O，利用 WebSocket 进行通信，以获得极高的性能；同时，支持使用多账号同时接入，减少业务宕机的可能。
-footer: MIT Licensed | Copyright © 2020 NoneBot Team
----

archive/2.0.0a3/api/README.md

@@ -1,46 +0,0 @@
-# NoneBot Api Reference
-
-
-* **模块索引**
-
-    
-    * [nonebot](nonebot.html)
-
-
-    * [nonebot.config](config.html)
-
-
-    * [nonebot.matcher](matcher.html)
-
-
-    * [nonebot.rule](rule.html)
-
-
-    * [nonebot.permission](permission.html)
-
-
-    * [nonebot.sched](sched.html)
-
-
-    * [nonebot.log](log.html)
-
-
-    * [nonebot.utils](utils.html)
-
-
-    * [nonebot.typing](typing.html)
-
-
-    * [nonebot.exception](exception.html)
-
-
-    * [nonebot.drivers](drivers/)
-
-
-    * [nonebot.drivers.fastapi](drivers/fastapi.html)
-
-
-    * [nonebot.adapters](adapters/)
-
-
-    * [nonebot.adapters.cqhttp](adapters/cqhttp.html)

archive/2.0.0a3/api/adapters/README.md

@@ -1,323 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.adapters 模块
-
-## 协议适配基类
-
-各协议请继承以下基类，并使用 `driver.register_adapter` 注册适配器
-
-
-## _class_ `BaseBot`
-
-基类：`abc.ABC`
-
-Bot 基类。用于处理上报消息，并提供 API 调用接口。
-
-
-### _abstract_ `__init__(driver, connection_type, config, self_id, *, websocket=None)`
-
-
-* **参数**
-
-    
-    * `driver: Driver`: Driver 对象
-
-
-    * `connection_type: str`: http 或者 websocket
-
-
-    * `config: Config`: Config 对象
-
-
-    * `self_id: str`: 机器人 ID
-
-
-    * `websocket: Optional[WebSocket]`: Websocket 连接对象
-
-
-
-### `driver`
-
-Driver 对象
-
-
-### `connection_type`
-
-连接类型
-
-
-### `config`
-
-Config 配置对象
-
-
-### `self_id`
-
-机器人 ID
-
-
-### `websocket`
-
-Websocket 连接对象
-
-
-### _abstract property_ `type`
-
-Adapter 类型
-
-
-### _abstract async_ `handle_message(message)`
-
-
-* **说明**
-
-    处理上报消息的函数，转换为 `Event` 事件后调用 `nonebot.message.handle_event` 进一步处理事件。
-
-
-
-* **参数**
-
-    
-    * `message: dict`: 收到的上报消息
-
-
-
-### _abstract async_ `call_api(api, **data)`
-
-
-* **说明**
-
-    调用机器人 API 接口，可以通过该函数或直接通过 bot 属性进行调用
-
-
-
-* **参数**
-
-    
-    * `api: str`: API 名称
-
-
-    * `**data`: API 数据
-
-
-
-* **示例**
-
-
-```python
-await bot.call_api("send_msg", data={"message": "hello world"})
-await bot.send_msg(message="hello world")
-```
-
-
-### _abstract async_ `send(event, message, **kwargs)`
-
-
-* **说明**
-
-    调用机器人基础发送消息接口
-
-
-
-* **参数**
-
-    
-    * `event: Event`: 上报事件
-
-
-    * `message: Union[str, Message, MessageSegment]`: 要发送的消息
-
-
-    * `**kwargs`
-
-
-
-## _class_ `BaseEvent`
-
-基类：`abc.ABC`
-
-Event 基类。提供上报信息的关键信息，其余信息可从原始上报消息获取。
-
-
-### `__init__(raw_event)`
-
-
-* **参数**
-
-    
-    * `raw_event: dict`: 原始上报消息
-
-
-
-### _property_ `raw_event`
-
-原始上报消息
-
-
-### _abstract property_ `id`
-
-事件 ID
-
-
-### _abstract property_ `name`
-
-事件名称
-
-
-### _abstract property_ `self_id`
-
-机器人 ID
-
-
-### _abstract property_ `time`
-
-事件发生时间
-
-
-### _abstract property_ `type`
-
-事件主类型
-
-
-### _abstract property_ `detail_type`
-
-事件详细类型
-
-
-### _abstract property_ `sub_type`
-
-事件子类型
-
-
-### _abstract property_ `user_id`
-
-触发事件的主体 ID
-
-
-### _abstract property_ `group_id`
-
-触发事件的主体群 ID
-
-
-### _abstract property_ `to_me`
-
-事件是否为发送给机器人的消息
-
-
-### _abstract property_ `message`
-
-消息内容
-
-
-### _abstract property_ `reply`
-
-回复的消息
-
-
-### _abstract property_ `raw_message`
-
-原始消息
-
-
-### _abstract property_ `plain_text`
-
-纯文本消息
-
-
-### _abstract property_ `sender`
-
-消息发送者信息
-
-
-## _class_ `BaseMessageSegment`
-
-基类：`abc.ABC`
-
-消息段基类
-
-
-### `type`
-
-
-* 类型: `str`
-
-
-* 说明: 消息段类型
-
-
-### `data`
-
-
-* 类型: `Dict[str, Union[str, list]]`
-
-
-* 说明: 消息段数据
-
-
-## _class_ `BaseMessage`
-
-基类：`list`, `abc.ABC`
-
-消息数组
-
-
-### `__init__(message=None, *args, **kwargs)`
-
-
-* **参数**
-
-    
-    * `message: Union[str, dict, list, MessageSegment, Message]`: 消息内容
-
-
-
-### `append(obj)`
-
-
-* **说明**
-
-    添加一个消息段到消息数组末尾
-
-
-
-* **参数**
-
-    
-    * `obj: Union[str, MessageSegment]`: 要添加的消息段
-
-
-
-### `extend(obj)`
-
-
-* **说明**
-
-    拼接一个消息数组或多个消息段到消息数组末尾
-
-
-
-* **参数**
-
-    
-    * `obj: Union[Message, Iterable[MessageSegment]]`: 要添加的消息数组
-
-
-
-### `reduce()`
-
-
-* **说明**
-
-    缩减消息数组，即拼接相邻纯文本消息段
-
-
-
-### `extract_plain_text()`
-
-
-* **说明**
-
-    提取消息内纯文本消息

archive/2.0.0a3/api/adapters/cqhttp.md

@@ -1,411 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.adapters.cqhttp 模块
-
-## CQHTTP (OneBot) v11 协议适配
-
-协议详情请看: [CQHTTP](http://cqhttp.cc/) | [OneBot](https://github.com/howmanybots/onebot)
-
-
-## `log(level, message)`
-
-
-* **说明**
-
-    用于打印 CQHTTP 日志。
-
-
-
-* **参数**
-
-    
-    * `level: str`: 日志等级
-
-
-    * `message: str`: 日志信息
-
-
-
-## `escape(s, *, escape_comma=True)`
-
-
-* **说明**
-
-    对字符串进行 CQ 码转义。
-
-
-
-* **参数**
-
-    
-    * `s: str`: 需要转义的字符串
-
-
-    * `escape_comma: bool`: 是否转义逗号（`,`）。
-
-
-
-## `unescape(s)`
-
-
-* **说明**
-
-    对字符串进行 CQ 码去转义。
-
-
-
-* **参数**
-
-    
-    * `s: str`: 需要转义的字符串
-
-
-
-## `_b2s(b)`
-
-转换布尔值为字符串。
-
-
-## _async_ `_check_reply(bot, event)`
-
-
-* **说明**
-
-    检查消息中存在的回复，去除并赋值 `event.reply`, `event.to_me`
-
-
-
-* **参数**
-
-    
-    * `bot: Bot`: Bot 对象
-
-
-    * `event: Event`: Event 对象
-
-
-
-## `_check_at_me(bot, event)`
-
-
-* **说明**
-
-    检查消息开头或结尾是否存在 @机器人，去除并赋值 `event.to_me`
-
-
-
-* **参数**
-
-    
-    * `bot: Bot`: Bot 对象
-
-
-    * `event: Event`: Event 对象
-
-
-
-## `_check_nickname(bot, event)`
-
-
-* **说明**
-
-    检查消息开头是否存在，去除并赋值 `event.to_me`
-
-
-
-* **参数**
-
-    
-    * `bot: Bot`: Bot 对象
-
-
-    * `event: Event`: Event 对象
-
-
-
-## `_handle_api_result(result)`
-
-
-* **说明**
-
-    处理 API 请求返回值。
-
-
-
-* **参数**
-
-    
-    * `result: Optional[Dict[str, Any]]`: API 返回数据
-
-
-
-* **返回**
-
-    
-    * `Any`: API 调用返回数据
-
-
-
-* **异常**
-
-    
-    * `ActionFailed`: API 调用失败
-
-
-
-## _class_ `Bot`
-
-基类：[`nonebot.adapters.BaseBot`](#None)
-
-CQHTTP 协议 Bot 适配。继承属性参考 [BaseBot](./#class-basebot) 。
-
-
-### _property_ `type`
-
-
-* 返回: `"cqhttp"`
-
-
-### _async_ `handle_message(message)`
-
-
-* **说明**
-
-    调用 [_check_reply](#async-check-reply-bot-event), [_check_at_me](#check-at-me-bot-event), [_check_nickname](#check-nickname-bot-event) 处理事件并转换为 [Event](#class-event)
-
-
-
-### _async_ `call_api(api, **data)`
-
-
-* **说明**
-
-    调用 CQHTTP 协议 API
-
-
-
-* **参数**
-
-    
-    * `api: str`: API 名称
-
-
-    * `**data: Any`: API 参数
-
-
-
-* **返回**
-
-    
-    * `Any`: API 调用返回数据
-
-
-
-* **异常**
-
-    
-    * `NetworkError`: 网络错误
-
-
-    * `ActionFailed`: API 调用失败
-
-
-
-### _async_ `send(event, message, at_sender=False, **kwargs)`
-
-
-* **说明**
-
-    根据 `event`  向触发事件的主体发送消息。
-
-
-
-* **参数**
-
-    
-    * `event: Event`: Event 对象
-
-
-    * `message: Union[str, Message, MessageSegment]`: 要发送的消息
-
-
-    * `at_sender: bool`: 是否 @ 事件主体
-
-
-    * `**kwargs`: 覆盖默认参数
-
-
-
-* **返回**
-
-    
-    * `Any`: API 调用返回数据
-
-
-
-* **异常**
-
-    
-    * `ValueError`: 缺少 `user_id`, `group_id`
-
-
-    * `NetworkError`: 网络错误
-
-
-    * `ActionFailed`: API 调用失败
-
-
-
-## _class_ `Event`
-
-基类：[`nonebot.adapters.BaseEvent`](#None)
-
-CQHTTP 协议 Event 适配。继承属性参考 [BaseEvent](./#class-baseevent) 。
-
-
-### _property_ `id`
-
-
-* 类型: `Optional[int]`
-
-
-* 说明: 事件/消息 ID
-
-
-### _property_ `name`
-
-
-* 类型: `str`
-
-
-* 说明: 事件名称，由类型与 `.` 组合而成
-
-
-### _property_ `self_id`
-
-
-* 类型: `str`
-
-
-* 说明: 机器人自身 ID
-
-
-### _property_ `time`
-
-
-* 类型: `int`
-
-
-* 说明: 事件发生时间
-
-
-### _property_ `type`
-
-
-* 类型: `str`
-
-
-* 说明: 事件类型
-
-
-### _property_ `detail_type`
-
-
-* 类型: `str`
-
-
-* 说明: 事件详细类型
-
-
-### _property_ `sub_type`
-
-
-* 类型: `Optional[str]`
-
-
-* 说明: 事件子类型
-
-
-### _property_ `user_id`
-
-
-* 类型: `Optional[int]`
-
-
-* 说明: 事件主体 ID
-
-
-### _property_ `group_id`
-
-
-* 类型: `Optional[int]`
-
-
-* 说明: 事件主体群 ID
-
-
-### _property_ `to_me`
-
-
-* 类型: `Optional[bool]`
-
-
-* 说明: 消息是否与机器人相关
-
-
-### _property_ `message`
-
-
-* 类型: `Optional[Message]`
-
-
-* 说明: 消息内容
-
-
-### _property_ `reply`
-
-
-* 类型: `Optional[dict]`
-
-
-* 说明: 回复消息详情
-
-
-### _property_ `raw_message`
-
-
-* 类型: `Optional[str]`
-
-
-* 说明: 原始消息
-
-
-### _property_ `plain_text`
-
-
-* 类型: `Optional[str]`
-
-
-* 说明: 纯文本消息内容
-
-
-### _property_ `sender`
-
-
-* 类型: `Optional[dict]`
-
-
-* 说明: 消息发送者信息
-
-
-## _class_ `MessageSegment`
-
-基类：[`nonebot.adapters.BaseMessageSegment`](#None)
-
-
-## _class_ `Message`
-
-基类：[`nonebot.adapters.BaseMessage`](#None)

archive/2.0.0a3/api/config.md

@@ -1,265 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.config 模块
-
-## 配置
-
-NoneBot 使用 [pydantic](https://pydantic-docs.helpmanual.io/) 以及 [python-dotenv](https://saurabh-kumar.com/python-dotenv/) 来读取配置。
-
-配置项需符合特殊格式或 json 序列化格式。详情见 [pydantic Field Type](https://pydantic-docs.helpmanual.io/usage/types/) 文档。
-
-
-## _class_ `Env`
-
-基类：`pydantic.env_settings.BaseSettings`
-
-运行环境配置。大小写不敏感。
-
-将会从 `nonebot.init 参数` > `环境变量` > `.env 环境配置文件` 的优先级读取配置。
-
-
-### `environment`
-
-
-* 类型: `str`
-
-
-* 默认值: `"prod"`
-
-
-* 说明:
-当前环境名。 NoneBot 将从 `.env.{environment}` 文件中加载配置。
-
-
-## _class_ `Config`
-
-基类：`nonebot.config.BaseConfig`
-
-NoneBot 主要配置。大小写不敏感。
-
-除了 NoneBot 的配置项外，还可以自行添加配置项到 `.env.{environment}` 文件中。
-这些配置将会在 json 反序列化后一起带入 `Config` 类中。
-
-
-### `driver`
-
-
-* 类型: `str`
-
-
-* 默认值: `"nonebot.drivers.fastapi"`
-
-
-* 说明:
-NoneBot 运行所使用的 `Driver` 。继承自 `nonebot.driver.BaseDriver` 。
-
-
-### `host`
-
-
-* 类型: `IPvAnyAddress`
-
-
-* 默认值: `127.0.0.1`
-
-
-* 说明:
-NoneBot 的 HTTP 和 WebSocket 服务端监听的 IP/主机名。
-
-
-### `port`
-
-
-* 类型: `int`
-
-
-* 默认值: `8080`
-
-
-* 说明:
-NoneBot 的 HTTP 和 WebSocket 服务端监听的端口。
-
-
-### `debug`
-
-
-* 类型: `bool`
-
-
-* 默认值: `False`
-
-
-* 说明:
-是否以调试模式运行 NoneBot。
-
-
-### `api_root`
-
-
-* 类型: `Dict[str, str]`
-
-
-* 默认值: `{}`
-
-
-* 说明:
-以机器人 ID 为键，上报地址为值的字典，环境变量或文件中应使用 json 序列化。
-
-
-* 示例:
-
-```default
-API_ROOT={"123456": "http://127.0.0.1:5700"}
-```
-
-
-### `api_timeout`
-
-
-* 类型: `Optional[float]`
-
-
-* 默认值: `30.`
-
-
-* 说明:
-API 请求超时时间，单位: 秒。
-
-
-### `access_token`
-
-
-* 类型: `Optional[str]`
-
-
-* 默认值: `None`
-
-
-* 说明:
-API 请求以及上报所需密钥，在请求头中携带。
-
-
-* 示例:
-
-```http
-POST /cqhttp/ HTTP/1.1
-Authorization: Bearer kSLuTF2GC2Q4q4ugm3
-```
-
-
-### `secret`
-
-
-* 类型: `Optional[str]`
-
-
-* 默认值: `None`
-
-
-* 说明:
-HTTP POST 形式上报所需签名，在请求头中携带。
-
-
-* 示例:
-
-```http
-POST /cqhttp/ HTTP/1.1
-X-Signature: sha1=f9ddd4863ace61e64f462d41ca311e3d2c1176e2
-```
-
-
-### `superusers`
-
-
-* 类型: `Set[int]`
-
-
-* 默认值: `set()`
-
-
-* 说明:
-机器人超级用户。
-
-
-* 示例:
-
-```default
-SUPER_USERS=[12345789]
-```
-
-
-### `nickname`
-
-
-* 类型: `Set[str]`
-
-
-* 默认值: `set()`
-
-
-* 说明:
-机器人昵称。
-
-
-### `command_start`
-
-
-* 类型: `Set[str]`
-
-
-* 默认值: `{"/"}`
-
-
-* 说明:
-命令的起始标记，用于判断一条消息是不是命令。
-
-
-### `command_sep`
-
-
-* 类型: `Set[str]`
-
-
-* 默认值: `{"."}`
-
-
-* 说明:
-命令的分隔标记，用于将文本形式的命令切分为元组（实际的命令名）。
-
-
-### `session_expire_timeout`
-
-
-* 类型: `timedelta`
-
-
-* 默认值: `timedelta(minutes=2)`
-
-
-* 说明:
-等待用户回复的超时时间。
-
-
-* 示例:
-
-```default
-SESSION_EXPIRE_TIMEOUT=120  # 单位: 秒
-SESSION_EXPIRE_TIMEOUT=[DD ][HH:MM]SS[.ffffff]
-SESSION_EXPIRE_TIMEOUT=P[DD]DT[HH]H[MM]M[SS]S  # ISO 8601
-```
-
-
-### `apscheduler_config`
-
-
-* 类型: `dict`
-
-
-* 默认值: `{"apscheduler.timezone": "Asia/Shanghai"}`
-
-
-* 说明:
-APScheduler 的配置对象，见 [Configuring the Scheduler](https://apscheduler.readthedocs.io/en/latest/userguide.html#configuring-the-scheduler)

archive/2.0.0a3/api/drivers/README.md

@@ -1,37 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.drivers 模块
-
-## 后端驱动适配基类
-
-各驱动请继承以下基类
-
-
-## _class_ `BaseDriver`
-
-基类：`abc.ABC`
-
-Driver 基类。将后端框架封装，以满足适配器使用。
-
-
-### `_adapters`
-
-
-* **类型**
-
-    `Dict[str, Type[Bot]]`
-
-
-
-* **说明**
-
-    已注册的适配器列表
-
-
-
-### _abstract_ `__init__(env, config)`
-
-Initialize self.  See help(type(self)) for accurate signature.

archive/2.0.0a3/api/drivers/fastapi.md

@@ -1,16 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.drivers.fastapi 模块
-
-
-## _class_ `Driver`
-
-基类：[`nonebot.drivers.BaseDriver`](#None)
-
-
-### `__init__(env, config)`
-
-Initialize self.  See help(type(self)) for accurate signature.

archive/2.0.0a3/api/exception.md

@@ -1,156 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.exception 模块
-
-## 异常
-
-下列文档中的异常是所有 NoneBot 运行时可能会抛出的。
-这些异常并非所有需要用户处理，在 NoneBot 内部运行时被捕获，并进行对应操作。
-
-
-## _exception_ `IgnoredException`
-
-基类：`Exception`
-
-
-* **说明**
-
-    指示 NoneBot 应该忽略该事件。可由 PreProcessor 抛出。
-
-
-
-* **参数**
-
-    
-    * `reason`: 忽略事件的原因
-
-
-
-## _exception_ `PausedException`
-
-基类：`Exception`
-
-
-* **说明**
-
-    指示 NoneBot 结束当前 `Handler` 并等待下一条消息后继续下一个 `Handler`。
-    可用于用户输入新信息。
-
-
-
-* **用法**
-
-    可以在 `Handler` 中通过 `Matcher.pause()` 抛出。
-
-
-
-## _exception_ `RejectedException`
-
-基类：`Exception`
-
-
-* **说明**
-
-    指示 NoneBot 结束当前 `Handler` 并等待下一条消息后重新运行当前 `Handler`。
-    可用于用户重新输入。
-
-
-
-* **用法**
-
-    可以在 `Handler` 中通过 `Matcher.reject()` 抛出。
-
-
-
-## _exception_ `FinishedException`
-
-基类：`Exception`
-
-
-* **说明**
-
-    指示 NoneBot 结束当前 `Handler` 且后续 `Handler` 不再被运行。
-    可用于结束用户会话。
-
-
-
-* **用法**
-
-    可以在 `Handler` 中通过 `Matcher.finish()` 抛出。
-
-
-
-## _exception_ `ExpiredException`
-
-基类：`Exception`
-
-
-* **说明**
-
-    指示 NoneBot 当前 `Matcher` 已失效。
-
-
-
-* **用法**
-
-    当 `Matcher` 运行前检查时抛出。
-
-
-
-## _exception_ `StopPropagation`
-
-基类：`Exception`
-
-
-* **说明**
-
-    指示 NoneBot 终止事件向下层传播。
-
-
-
-* **用法**
-
-    在 `Matcher.block == True` 时抛出。
-
-
-
-## _exception_ `ApiNotAvailable`
-
-基类：`Exception`
-
-
-* **说明**
-
-    在 API 连接不可用时抛出。
-
-
-
-## _exception_ `NetworkError`
-
-基类：`Exception`
-
-
-* **说明**
-
-    在网络出现问题时抛出，如: API 请求地址不正确, API 请求无返回或返回状态非正常等。
-
-
-
-## _exception_ `ActionFailed`
-
-基类：`Exception`
-
-
-* **说明**
-
-    API 请求成功返回数据，但 API 操作失败。
-
-
-
-* **参数**
-
-    
-    * `retcode`: 错误代码

archive/2.0.0a3/api/log.md

@@ -1,55 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.log 模块
-
-## 日志
-
-NoneBot 使用 [loguru](https://github.com/Delgan/loguru) 来记录日志信息。
-
-自定义 logger 请参考 [loguru](https://github.com/Delgan/loguru) 文档。
-
-
-## `logger`
-
-
-* **说明**
-
-    NoneBot 日志记录器对象。
-
-
-
-* **默认信息**
-
-    
-    * 格式: `[%(asctime)s %(name)s] %(levelname)s: %(message)s`
-
-
-    * 等级: `DEBUG` / `INFO` ，根据 config 配置改变
-
-
-    * 输出: 输出至 stdout
-
-
-
-* **用法**
-
-
-```python
-from nonebot.log import logger
-```
-
-
-## _class_ `LoguruHandler`
-
-基类：`logging.Handler`
-
-
-### `emit(record)`
-
-Do whatever it takes to actually log the specified logging record.
-
-This version is intended to be implemented by subclasses and so
-raises a NotImplementedError.

archive/2.0.0a3/api/matcher.md

@@ -1,485 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.matcher 模块
-
-## 事件响应器
-
-该模块实现事件响应器的创建与运行，并提供一些快捷方法来帮助用户更好的与机器人进行 对话 。
-
-
-## `matchers`
-
-
-* **类型**
-
-    `Dict[int, List[Type[Matcher]]]`
-
-
-
-* **说明**
-
-    用于存储当前所有的事件响应器
-
-
-
-## _class_ `Matcher`
-
-基类：`object`
-
-事件响应器类
-
-
-### `module`
-
-
-* **类型**
-
-    `Optional[str]`
-
-
-
-* **说明**
-
-    事件响应器所在模块名称
-
-
-
-### `type`
-
-
-* **类型**
-
-    `str`
-
-
-
-* **说明**
-
-    事件响应器类型
-
-
-
-### `rule`
-
-
-* **类型**
-
-    `Rule`
-
-
-
-* **说明**
-
-    事件响应器匹配规则
-
-
-
-### `permission`
-
-
-* **类型**
-
-    `Permission`
-
-
-
-* **说明**
-
-    事件响应器触发权限
-
-
-
-### `priority`
-
-
-* **类型**
-
-    `int`
-
-
-
-* **说明**
-
-    事件响应器优先级
-
-
-
-### `block`
-
-
-* **类型**
-
-    `bool`
-
-
-
-* **说明**
-
-    事件响应器是否阻止事件传播
-
-
-
-### `temp`
-
-
-* **类型**
-
-    `bool`
-
-
-
-* **说明**
-
-    事件响应器是否为临时
-
-
-
-### `expire_time`
-
-
-* **类型**
-
-    `Optional[datetime]`
-
-
-
-* **说明**
-
-    事件响应器过期时间点
-
-
-
-### `_default_state`
-
-
-* **类型**
-
-    `dict`
-
-
-
-* **说明**
-
-    事件响应器默认状态
-
-
-
-### `_default_parser`
-
-
-* **类型**
-
-    `Optional[ArgsParser]`
-
-
-
-* **说明**
-
-    事件响应器默认参数解析函数
-
-
-
-### `__init__()`
-
-实例化 Matcher 以便运行
-
-
-### `handlers`
-
-
-* **类型**
-
-    `List[Handler]`
-
-
-
-* **说明**
-
-    事件响应器拥有的事件处理函数列表
-
-
-
-### _classmethod_ `new(type_='', rule=None, permission=None, handlers=None, temp=False, priority=1, block=False, *, module=None, default_state=None, expire_time=None)`
-
-
-* **说明**
-
-    创建一个新的事件响应器，并存储至 [matchers](#matchers)
-
-
-
-* **参数**
-
-    
-    * `type_: str`: 事件响应器类型，与 `event.type` 一致时触发，空字符串表示任意
-
-
-    * `rule: Optional[Rule]`: 匹配规则
-
-
-    * `permission: Optional[Permission]`: 权限
-
-
-    * `handlers: Optional[List[Handler]]`: 事件处理函数列表
-
-
-    * `temp: bool`: 是否为临时事件响应器，即触发一次后删除
-
-
-    * `priority: int`: 响应优先级
-
-
-    * `block: bool`: 是否阻止事件向更低优先级的响应器传播
-
-
-    * `module: Optional[str]`: 事件响应器所在模块名称
-
-
-    * `default_state: Optional[dict]`: 默认状态 `state`
-
-
-    * `expire_time: Optional[datetime]`: 事件响应器最终有效时间点，过时即被删除
-
-
-
-* **返回**
-
-    
-    * `Type[Matcher]`: 新的事件响应器类
-
-
-
-### _async classmethod_ `check_perm(bot, event)`
-
-
-* **说明**
-
-    检查是否满足触发权限
-
-
-
-* **参数**
-
-    
-    * `bot: Bot`: Bot 对象
-
-
-    * `event: Event`: 上报事件
-
-
-
-* **返回**
-
-    
-    * `bool`: 是否满足权限
-
-
-
-### _async classmethod_ `check_rule(bot, event, state)`
-
-
-* **说明**
-
-    检查是否满足匹配规则
-
-
-
-* **参数**
-
-    
-    * `bot: Bot`: Bot 对象
-
-
-    * `event: Event`: 上报事件
-
-
-    * `state: dict`: 当前状态
-
-
-
-* **返回**
-
-    
-    * `bool`: 是否满足匹配规则
-
-
-
-### _classmethod_ `args_parser(func)`
-
-
-* **说明**
-
-    装饰一个函数来更改当前事件响应器的默认参数解析函数
-
-
-
-* **参数**
-
-    
-    * `func: ArgsParser`: 参数解析函数
-
-
-
-### _classmethod_ `handle()`
-
-
-* **说明**
-
-    装饰一个函数来向事件响应器直接添加一个处理函数
-
-
-
-* **参数**
-
-    
-    * 无
-
-
-
-### _classmethod_ `receive()`
-
-
-* **说明**
-
-    装饰一个函数来指示 NoneBot 在接收用户新的一条消息后继续运行该函数
-
-
-
-* **参数**
-
-    
-    * 无
-
-
-
-### _classmethod_ `got(key, prompt=None, args_parser=None)`
-
-
-* **说明**
-
-    装饰一个函数来指示 NoneBot 当要获取的 `key` 不存在时接收用户新的一条消息并经过 `ArgsParser` 处理后再运行该函数，如果 `key` 已存在则直接继续运行
-
-
-
-* **参数**
-
-    
-    * `key: str`: 参数名
-
-
-    * `prompt: Optional[Union[str, Message, MessageSegment]]`: 在参数不存在时向用户发送的消息
-
-
-    * `args_parser: Optional[ArgsParser]`: 可选参数解析函数，空则使用默认解析函数
-
-
-
-### _async classmethod_ `send(message)`
-
-
-* **说明**
-
-    发送一条消息给当前交互用户
-
-
-
-* **参数**
-
-    
-    * `message: Union[str, Message, MessageSegment]`: 消息内容
-
-
-
-### _async classmethod_ `finish(message=None)`
-
-
-* **说明**
-
-    发送一条消息给当前交互用户并结束当前事件响应器
-
-
-
-* **参数**
-
-    
-    * `message: Union[str, Message, MessageSegment]`: 消息内容
-
-
-
-### _async classmethod_ `pause(prompt=None)`
-
-
-* **说明**
-
-    发送一条消息给当前交互用户并暂停事件响应器，在接收用户新的一条消息后继续下一个处理函数
-
-
-
-* **参数**
-
-    
-    * `prompt: Union[str, Message, MessageSegment]`: 消息内容
-
-
-
-### _async classmethod_ `reject(prompt=None)`
-
-
-* **说明**
-
-    发送一条消息给当前交互用户并暂停事件响应器，在接收用户新的一条消息后重新运行当前处理函数
-
-
-
-* **参数**
-
-    
-    * `prompt: Union[str, Message, MessageSegment]`: 消息内容
-
-
-
-## _class_ `MatcherGroup`
-
-基类：`object`
-
-事件响应器组合，统一管理。用法同 `Matcher`
-
-
-### `__init__(type_='', rule=None, permission=None, handlers=None, temp=False, priority=1, block=False, *, module=None, default_state=None, expire_time=None)`
-
-
-* **说明**
-
-    创建一个事件响应器组合，参数为默认值，与 `Matcher.new` 一致
-
-
-
-### `matchers`
-
-
-* **类型**
-
-    `List[Type[Matcher]]`
-
-
-
-* **说明**
-
-    组内事件响应器列表
-
-
-
-### `new(type_='', rule=None, permission=None, handlers=None, temp=False, priority=1, block=False, *, module=None, default_state=None, expire_time=None)`
-
-
-* **说明**
-
-    在组中创建一个新的事件响应器，参数留空则使用组合默认值
-
-
-:::danger 警告
-如果使用 handlers 参数覆盖组合默认值则该事件响应器不会随组合一起添加新的事件处理函数
-:::

archive/2.0.0a3/api/nonebot.md

@@ -1,257 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot 模块
-
-## 快捷导入
-
-为方便使用，`nonebot` 模块从子模块导入了部分内容
-
-
-* `on_message` => `nonebot.plugin.on_message`
-
-
-* `on_notice` => `nonebot.plugin.on_notice`
-
-
-* `on_request` => `nonebot.plugin.on_request`
-
-
-* `on_metaevent` => `nonebot.plugin.on_metaevent`
-
-
-* `on_startswith` => `nonebot.plugin.on_startswith`
-
-
-* `on_endswith` => `nonebot.plugin.on_endswith`
-
-
-* `on_command` => `nonebot.plugin.on_command`
-
-
-* `on_regex` => `nonebot.plugin.on_regex`
-
-
-* `on_regex` => `nonebot.plugin.on_regex`
-
-
-* `on_regex` => `nonebot.plugin.on_regex`
-
-
-* `CommandGroup` => `nonebot.plugin.CommandGroup`
-
-
-* `load_plugin` => `nonebot.plugin.load_plugin`
-
-
-* `load_plugins` => `nonebot.plugin.load_plugins`
-
-
-* `load_builtin_plugins` => `nonebot.plugin.load_builtin_plugins`
-
-
-* `get_loaded_plugins` => `nonebot.plugin.get_loaded_plugins`
-
-
-## `get_driver()`
-
-
-* **说明**
-
-    获取全局 Driver 对象。可用于在计划任务的回调中获取当前 Driver 对象。
-
-
-
-* **返回**
-
-    
-    * `Driver`: 全局 Driver 对象
-
-
-
-* **异常**
-
-    
-    * `ValueError`: 全局 Driver 对象尚未初始化 (nonebot.init 尚未调用)
-
-
-
-* **用法**
-
-
-```python
-driver = nonebot.get_driver()
-```
-
-
-## `get_app()`
-
-
-* **说明**
-
-    获取全局 Driver 对应 Server App 对象。
-
-
-
-* **返回**
-
-    
-    * `Any`: Server App 对象
-
-
-
-* **异常**
-
-    
-    * `ValueError`: 全局 Driver 对象尚未初始化 (nonebot.init 尚未调用)
-
-
-
-* **用法**
-
-
-```python
-app = nonebot.get_app()
-```
-
-
-## `get_asgi()`
-
-
-* **说明**
-
-    获取全局 Driver 对应 Asgi 对象。
-
-
-
-* **返回**
-
-    
-    * `Any`: Asgi 对象
-
-
-
-* **异常**
-
-    
-    * `ValueError`: 全局 Driver 对象尚未初始化 (nonebot.init 尚未调用)
-
-
-
-* **用法**
-
-
-```python
-asgi = nonebot.get_asgi()
-```
-
-
-## `get_bots()`
-
-
-* **说明**
-
-    获取所有通过 ws 连接 NoneBot 的 Bot 对象。
-
-
-
-* **返回**
-
-    
-    * `Dict[str, Bot]`: 一个以字符串 ID 为键，Bot 对象为值的字典
-
-
-
-* **异常**
-
-    
-    * `ValueError`: 全局 Driver 对象尚未初始化 (nonebot.init 尚未调用)
-
-
-
-* **用法**
-
-
-```python
-bots = nonebot.get_bots()
-```
-
-
-## `init(*, _env_file=None, **kwargs)`
-
-
-* **说明**
-
-    初始化 NoneBot 以及 全局 Driver 对象。
-
-    NoneBot 将会从 .env 文件中读取环境信息，并使用相应的 env 文件配置。
-
-    你也可以传入自定义的 _env_file 来指定 NoneBot 从该文件读取配置。
-
-
-
-* **参数**
-
-    
-    * `_env_file: Optional[str]`: 配置文件名，默认从 .env.{env_name} 中读取配置
-
-
-    * `**kwargs`: 任意变量，将会存储到 Config 对象里
-
-
-
-* **返回**
-
-    
-    * `None`
-
-
-
-* **用法**
-
-
-```python
-nonebot.init(database=Database(...))
-```
-
-
-## `run(host=None, port=None, *args, **kwargs)`
-
-
-* **说明**
-
-    启动 NoneBot，即运行全局 Driver 对象。
-
-
-
-* **参数**
-
-    
-    * `host: Optional[str]`: 主机名／IP，若不传入则使用配置文件中指定的值
-
-
-    * `port: Optional[int]`: 端口，若不传入则使用配置文件中指定的值
-
-
-    * `*args`: 传入 Driver.run 的位置参数
-
-
-    * `**kwargs`: 传入 Driver.run 的命名参数
-
-
-
-* **返回**
-
-    
-    * `None`
-
-
-
-* **用法**
-
-
-```python
-nonebot.run(host="127.0.0.1", port=8080)
-```

archive/2.0.0a3/api/permission.md

@@ -1,121 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.permission 模块
-
-## 权限
-
-每个 `Matcher` 拥有一个 `Permission` ，其中是 **异步** `PermissionChecker` 的集合，只要有一个 `PermissionChecker` 检查结果为 `True` 时就会继续运行。
-
-:::tip 提示
-`PermissionChecker` 既可以是 async function 也可以是 sync function
-:::
-
-
-## `MESSAGE`
-
-
-* **说明**: 匹配任意 `message` 类型事件，仅在需要同时捕获不同类型事件时使用。优先使用 message type 的 Matcher。
-
-
-## `NOTICE`
-
-
-* **说明**: 匹配任意 `notice` 类型事件，仅在需要同时捕获不同类型事件时使用。优先使用 notice type 的 Matcher。
-
-
-## `REQUEST`
-
-
-* **说明**: 匹配任意 `request` 类型事件，仅在需要同时捕获不同类型事件时使用。优先使用 request type 的 Matcher。
-
-
-## `METAEVENT`
-
-
-* **说明**: 匹配任意 `meta_event` 类型事件，仅在需要同时捕获不同类型事件时使用。优先使用 meta_event type 的 Matcher。
-
-
-## `USER(*user, perm=<nonebot.permission.Permission object>)`
-
-
-* **说明**
-
-    在白名单内且满足 perm
-
-
-
-* **参数**
-
-    
-    * `*user: int`: 白名单
-
-
-    * `perm: Permission`: 需要同时满足的权限
-
-
-
-## `PRIVATE`
-
-
-* **说明**: 匹配任意私聊消息类型事件
-
-
-## `PRIVATE_FRIEND`
-
-
-* **说明**: 匹配任意好友私聊消息类型事件
-
-
-## `PRIVATE_GROUP`
-
-
-* **说明**: 匹配任意群临时私聊消息类型事件
-
-
-## `PRIVATE_OTHER`
-
-
-* **说明**: 匹配任意其他私聊消息类型事件
-
-
-## `GROUP`
-
-
-* **说明**: 匹配任意群聊消息类型事件
-
-
-## `GROUP_MEMBER`
-
-
-* **说明**: 匹配任意群员群聊消息类型事件
-
-:::warning 警告
-该权限通过 event.sender 进行判断且不包含管理员以及群主！
-:::
-
-
-## `GROUP_ADMIN`
-
-
-* **说明**: 匹配任意群管理员群聊消息类型事件
-
-
-## `GROUP_OWNER`
-
-
-* **说明**: 匹配任意群主群聊消息类型事件
-
-
-## `SUPERUSER`
-
-
-* **说明**: 匹配任意超级用户消息类型事件
-
-
-## `EVERYBODY`
-
-
-* **说明**: 匹配任意消息类型事件

archive/2.0.0a3/api/rule.md

@@ -1,202 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.rule 模块
-
-## 规则
-
-每个事件响应器 `Matcher` 拥有一个匹配规则 `Rule` ，其中是 **异步** `RuleChecker` 的集合，只有当所有 `RuleChecker` 检查结果为 `True` 时继续运行。
-
-:::tip 提示
-`RuleChecker` 既可以是 async function 也可以是 sync function，但在最终会被 `nonebot.utils.run_sync` 转换为 async function
-:::
-
-
-## _class_ `Rule`
-
-基类：`object`
-
-
-* **说明**
-
-    `Matcher` 规则类，当事件传递时，在 `Matcher` 运行前进行检查。
-
-
-
-* **示例**
-
-
-```python
-Rule(async_function) & sync_function
-# 等价于
-from nonebot.utils import run_sync
-Rule(async_function, run_sync(sync_function))
-```
-
-
-### `__init__(*checkers)`
-
-
-* **参数**
-
-    
-    * `*checkers: Callable[[Bot, Event, dict], Awaitable[bool]]`: **异步** RuleChecker
-
-
-
-### `checkers`
-
-
-* **说明**
-
-    存储 `RuleChecker`
-
-
-
-* **类型**
-
-    
-    * `Set[Callable[[Bot, Event, dict], Awaitable[bool]]]`
-
-
-
-### _async_ `__call__(bot, event, state)`
-
-
-* **说明**
-
-    检查是否符合所有规则
-
-
-
-* **参数**
-
-    
-    * `bot: Bot`: Bot 对象
-
-
-    * `event: Event`: Event 对象
-
-
-    * `state: dict`: 当前 State
-
-
-
-* **返回**
-
-    
-    * `bool`
-
-
-
-## `startswith(msg)`
-
-
-* **说明**
-
-    匹配消息开头
-
-
-
-* **参数**
-
-    
-    * `msg: str`: 消息开头字符串
-
-
-
-## `endswith(msg)`
-
-
-* **说明**
-
-    匹配消息结尾
-
-
-
-* **参数**
-
-    
-    * `msg: str`: 消息结尾字符串
-
-
-
-## `keyword(msg)`
-
-
-* **说明**
-
-    匹配消息关键词
-
-
-
-* **参数**
-
-    
-    * `msg: str`: 关键词
-
-
-
-## `command(command)`
-
-
-* **说明**
-
-    命令形式匹配，根据配置里提供的 `command_start`, `command_sep` 判断消息是否为命令。
-
-
-
-* **参数**
-
-    
-    * `command: Tuples[str, ...]`: 命令内容
-
-
-
-* **示例**
-
-    使用默认 `command_start`, `command_sep` 配置
-
-    命令 `("test",)` 可以匹配：`/test` 开头的消息
-    命令 `("test", "sub")` 可以匹配”`/test.sub` 开头的消息
-
-
-:::tip 提示
-命令内容与后续消息间无需空格！
-:::
-
-
-## `regex(regex, flags=0)`
-
-
-* **说明**
-
-    根据正则表达式进行匹配
-
-
-
-* **参数**
-
-    
-    * `regex: str`: 正则表达式
-
-
-    * `flags: Union[int, re.RegexFlag]`: 正则标志
-
-
-
-## `to_me()`
-
-
-* **说明**
-
-    通过 `event.to_me` 判断消息是否是发送给机器人
-
-
-
-* **参数**
-
-    
-    * 无

archive/2.0.0a3/api/sched.md

@@ -1,41 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.sched 模块
-
-## 计划任务
-
-计划任务使用第三方库 [APScheduler](https://github.com/agronholm/apscheduler) ，使用文档请参考 [APScheduler使用文档](https://apscheduler.readthedocs.io/en/latest/) 。
-
-
-## `scheduler`
-
-
-* **类型**
-
-    `Optional[apscheduler.schedulers.asyncio.AsyncIOScheduler]`
-
-
-
-* **说明**
-
-    当可选依赖 `APScheduler` 未安装时，`scheduler` 为 None
-
-    使用 `pip install nonebot[scheduler]` 安装可选依赖
-
-
-
-* **常用示例**
-
-
-```python
-from nonebot import scheduler
-
-@scheduler.scheduled_job("cron", hour="*/2", id="xxx", args=[1], kwargs={arg2: 2})
-async def run_every_2_hour(arg1, arg2):
-    pass
-
-scheduler.add_job(run_every_day_from_program_start, "interval", days=1, id="xxx")
-```

archive/2.0.0a3/api/typing.md

@@ -1,252 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.typing 模块
-
-## 类型
-
-下面的文档中，「类型」部分使用 Python 的 Type Hint 语法，见 [PEP 484](https://www.python.org/dev/peps/pep-0484/)、[PEP 526](https://www.python.org/dev/peps/pep-0526/) 和 [typing](https://docs.python.org/3/library/typing.html)。
-
-除了 Python 内置的类型，下面还出现了如下 NoneBot 自定类型，实际上它们是 Python 内置类型的别名。
-
-以下类型均可从 nonebot.typing 模块导入。
-
-
-## `Driver`
-
-
-* **类型**
-
-    `BaseDriver`
-
-
-
-* **说明**
-
-    所有 Driver 的基类。
-
-
-
-
-## `WebSocket`
-
-
-* **类型**
-
-    `BaseWebSocket`
-
-
-
-* **说明**
-
-    所有 WebSocket 的基类。
-
-
-
-
-## `Bot`
-
-
-* **类型**
-
-    `BaseBot`
-
-
-
-* **说明**
-
-    所有 Bot 的基类。
-
-
-
-
-## `Event`
-
-
-* **类型**
-
-    `BaseEvent`
-
-
-
-* **说明**
-
-    所有 Event 的基类。
-
-
-
-
-## `Message`
-
-
-* **类型**
-
-    `BaseMessage`
-
-
-
-* **说明**
-
-    所有 Message 的基类。
-
-
-
-
-## `MessageSegment`
-
-
-* **类型**
-
-    `BaseMessageSegment`
-
-
-
-* **说明**
-
-    所有 MessageSegment 的基类。
-
-
-
-
-## `PreProcessor`
-
-
-* **类型**
-
-    `Callable[[Bot, Event, dict], Union[Awaitable[None], Awaitable[NoReturn]]]`
-
-
-
-* **说明**
-
-    消息预处理函数 PreProcessor 类型
-
-
-
-
-## `Matcher`
-
-
-* **类型**
-
-    `Matcher`
-
-
-
-* **说明**
-
-    Matcher 即响应事件的处理类。通过 Rule 判断是否响应事件，运行 Handler。
-
-
-
-
-## `MatcherGroup`
-
-
-* **类型**
-
-    `MatcherGroup`
-
-
-
-* **说明**
-
-    MatcherGroup 为 Matcher 的集合。可以共享 Handler。
-
-
-
-
-## `Rule`
-
-
-* **类型**
-
-    `Rule`
-
-
-
-* **说明**
-
-    Rule 即判断是否响应事件的处理类。内部存储 RuleChecker ，返回全为 True 则响应事件。
-
-
-
-
-## `RuleChecker`
-
-
-* **类型**
-
-    `Callable[[Bot, Event, dict], Union[bool, Awaitable[bool]]]`
-
-
-
-* **说明**
-
-    RuleChecker 即判断是否响应事件的处理函数。
-
-
-
-
-## `Permission`
-
-
-* **类型**
-
-    `Permission`
-
-
-
-* **说明**
-
-    Permission 即判断是否响应消息的处理类。内部存储 PermissionChecker ，返回只要有一个 True 则响应消息。
-
-
-
-
-## `PermissionChecker`
-
-
-* **类型**
-
-    `Callable[[Bot, Event], Union[bool, Awaitable[bool]]]`
-
-
-
-* **说明**
-
-    RuleChecker 即判断是否响应消息的处理函数。
-
-
-
-
-## `Handler`
-
-
-* **类型**
-
-    `Callable[[Bot, Event, dict], Union[Awaitable[None], Awaitable[NoReturn]]]`
-
-
-
-* **说明**
-
-    Handler 即事件的处理函数。
-
-
-
-
-## `ArgsParser`
-
-
-* **类型**
-
-    `Callable[[Bot, Event, dict], Union[Awaitable[None], Awaitable[NoReturn]]]`
-
-
-
-* **说明**
-
-    ArgsParser 即消息参数解析函数，在 Matcher.got 获取参数时被运行。

archive/2.0.0a3/api/utils.md

@@ -1,62 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.utils 模块
-
-
-## `escape_tag(s)`
-
-
-* **说明**
-
-    用于记录带颜色日志时转义 `<tag>` 类型特殊标签
-
-
-
-* **参数**
-
-    
-    * `s: str`: 需要转义的字符串
-
-
-
-* **返回**
-
-    
-    * `str`
-
-
-
-## `run_sync(func)`
-
-
-* **说明**
-
-    一个用于包装 sync function 为 async function 的装饰器
-
-
-
-* **参数**
-
-    
-    * `func: Callable[..., Any]`: 被装饰的同步函数
-
-
-
-* **返回**
-
-    
-    * `Callable[..., Awaitable[Any]]`
-
-
-
-## _class_ `DataclassEncoder`
-
-基类：`json.encoder.JSONEncoder`
-
-
-* **说明**
-
-    在JSON序列化 `Message` (List[Dataclass]) 时使用的 `JSONEncoder`

archive/2.0.0a3/guide/README.md

@@ -1,34 +0,0 @@
-# 概览
-
-:::tip 提示
-如果在阅读本文档时遇到难以理解的词汇，请随时查阅 [术语表](../glossary.md) 或使用 [Google 搜索](https://www.google.com/)。
-:::
-
-:::tip 提示
-初次使用时可能会觉得这里的概览过于枯燥，可以先简单略读之后直接前往 [安装](./installation.md) 查看安装方法，并进行后续的基础使用教程。
-:::
-
-NoneBot2 是一个可扩展的 Python 异步机器人框架，它会对机器人收到的消息进行解析和处理，并以插件化的形式，分发给消息所对应的命令处理器和自然语言处理器，来完成具体的功能。
-
-除了起到解析消息的作用，NoneBot 还为插件提供了大量实用的预设操作和权限控制机制，尤其对于命令处理器，它更是提供了完善且易用的会话机制和内部调用机制，以分别适应命令的连续交互和插件内部功能复用等需求。
-
-目前 NoneBot2 在 [FastAPI](https://fastapi.tiangolo.com/) 的基础上封装了与 [CQHTTP(OneBot) 协议](http://cqhttp.cc/)插件的网络交互。
-
-得益于 Python 的 [asyncio](https://docs.python.org/3/library/asyncio.html) 机制，NoneBot 处理消息的吞吐量有了很大的保障，再配合 WebSocket 通信方式（也是最建议的通信方式），NoneBot 的性能可以达到 HTTP 通信方式的两倍以上，相较于传统同步 I/O 的 HTTP 通信，更是有质的飞跃。
-
-需要注意的是，NoneBot 仅支持 Python 3.7+ 及 CQHTTP(OneBot) 插件 v11+。
-
-## 它如何工作？
-
-~~未填坑~~
-
-## 特色
-
-- 提供直观的测试前端
-- 提供使用简易的脚手架
-- 基于异步 I/O
-- 同时支持 HTTP 和反向 WebSocket 通信方式
-- 支持多个机器人账号负载均衡
-- 提供直观的交互式会话接口
-- 提供可自定义的权限控制机制
-- 多种方式渲染要发送的消息内容，使对话足够自然

archive/2.0.0a3/guide/basic-configuration.md

@@ -1,68 +0,0 @@
-# 基本配置
-
-到目前为止我们还在使用 NoneBot 的默认行为，在开始编写自己的插件之前，我们先尝试在配置文件上动动手脚，让 NoneBot 表现出不同的行为。
-
-在上一章节中，我们创建了默认的项目结构，其中 `.env`, `.env.*` 均为项目的配置文件，下面将介绍几种 NoneBot 配置方式。
-
-:::danger 警告
-请勿将敏感信息写入配置文件并提交至开源仓库！
-:::
-
-## .env 文件
-
-NoneBot 在启动时将会从系统环境变量或者 `.env` 文件中寻找变量 `ENVIRONMENT` (大小写不敏感)，默认值为 `prod`。  
-这将引导 NoneBot 从系统环境变量或者 `.env.{ENVIRONMENT}` 文件中进一步加载具体配置。
-
-现在，我们在 `.env` 文件中写入当前环境信息
-
-```bash
-# .env
-ENVIRONMENT=dev
-```
-
-## .env.\* 文件
-
-详细配置文件，使用 [pydantic](https://pydantic-docs.helpmanual.io/) 加载配置。在 NoneBot 初始化时可以指定忽略 `.env` 中的环境信息转而加载某个配置文件: `nonebot.init(_env_file=".env.dev")`。
-
-:::warning 提示
-由于 `pydantic` 使用 JSON 加载配置项，请确保配置项值为 JSON 能够解析的数据。如果 JSON 解析失败将作为字符串处理。
-:::
-
-示例及说明：
-
-```bash
-HOST=0.0.0.0  # 配置 NoneBot 监听的 IP/主机名
-PORT=8080  # 配置 NoneBot 监听的端口
-DEBUG=true  # 开启 debug 模式 **请勿在生产环境开启**
-SUPERUSERS=["123456789", "987654321"]  # 配置 NoneBot 超级用户
-NICKNAME=["awesome", "bot"]  # 配置机器人的昵称
-COMMAND_START=["/", ""]  # 配置命令起始字符
-COMMAND_SEP=["."]  # 配置命令分割字符
-
-# Custom Configs
-CUSTOM_CONFIG1="config in env file"
-CUSTOM_CONFIG2=  # 留空则从系统环境变量读取，如不存在则为空字符串
-```
-
-详细的配置项参考 [Config Reference](../api/config.md) 。
-
-## bot.py 文件
-
-配置项也可以在 NoneBot 初始化时传入。此处可以传入任意合法 Python 变量。当然也可以在初始化完成后修改或新增。
-
-示例：
-
-```python
-# bot.py
-import nonebot
-
-nonebot.init(custom_config3="config on init")
-
-config = nonebot.get_driver().config
-config.custom_config3 = "changed after init"
-config.custom_config4 = "new config after init"
-```
-
-## 优先级
-
-`bot.py init` > `env file` > `system env`

archive/2.0.0a3/guide/creating-a-project.md

@@ -1,55 +0,0 @@
-# 创建一个完整的项目
-
-上一章中我们已经运行了一个最小的 NoneBot 实例，在这一章，我们将从零开始一个完整的项目。
-
-## 目录结构
-
-首先，我们可以使用 `nb-cli` 或者自行创建项目目录：
-
-```bash
-pip install nonebot2[cli]
-# pip install nb-cli
-nb create
-```
-
-这将创建默认的目录结构
-
-<!-- prettier-ignore-start -->
-:::vue
-AweSome-Bot
-├── `awesome_bot` _(**或是 src**)_
-│   └── `plugins`
-├── `.env` _(**可选的**)_
-├── `.env.dev` _(**可选的**)_
-├── `.env.prod` _(**可选的**)_
-├── .gitignore
-├── `bot.py`
-├── docker-compose.yml
-├── Dockerfile
-├── `pyproject.toml`
-└── README.md
-:::
-<!-- prettier-ignore-end -->
-
-- `awesome_bot/plugins` 或 `src/plugins`: 用于存放编写的 bot 插件
-- `.env`, `.env.dev`, `.env.prod`: 各环境配置文件
-- `bot.py`: bot 入口文件
-- `pyproject.toml`: 项目依赖管理文件，默认使用 [poetry](https://python-poetry.org/)
-
-## 启动 Bot
-
-如果你使用 `nb-cli`
-
-```bash
-nb run [--file=bot.py] [--app=app]
-```
-
-或者使用
-
-```bash
-python bot.py
-```
-
-:::tip 提示
-如果在 bot 入口文件内定义了 asgi server， `nb-cli` 将会为你启动**冷重载模式**
-:::

archive/2.0.0a3/guide/getting-started.md

@@ -1,146 +0,0 @@
-# 开始使用
-
-一切都安装成功后，你就已经做好了进行简单配置以运行一个最小的 NoneBot 实例的准备。
-
-## 最小实例
-
-使用你最熟悉的编辑器或 IDE，创建一个名为 `bot.py` 的文件，内容如下：
-
-```python{3,4,7}
-import nonebot
-
-nonebot.init()
-nonebot.load_builtin_plugins()
-
-if __name__ == "__main__":
-    nonebot.run()
-```
-
-这几行高亮代码将依次：
-
-1. 使用默认配置初始化 NoneBot 包
-2. 加载 NoneBot 内置的插件
-3. 在地址 `127.0.0.1:8080` 运行 NoneBot
-
-在命令行使用如下命令即可运行这个 NoneBot 实例：
-
-```bash
-python bot.py
-```
-
-运行后会产生如下日志：
-
-```default
-09-14 21:02:00 [INFO] nonebot | Succeeded to import "nonebot.plugins.base"
-09-14 21:02:00 [INFO] nonebot | Running NoneBot...
-09-14 21:02:00 [INFO] uvicorn | Started server process [1234]
-09-14 21:02:00 [INFO] uvicorn | Waiting for application startup.
-09-14 21:02:00 [INFO] nonebot | Scheduler Started
-09-14 21:02:00 [INFO] uvicorn | Application startup complete.
-09-14 21:02:00 [INFO] uvicorn | Uvicorn running on http://127.0.0.1:8080 (Press CTRL+C to quit)
-```
-
-## 配置 QQ 协议端
-
-单纯运行 NoneBot 实例并不会产生任何效果，因为此刻 QQ 这边还不知道 NoneBot 的存在，也就无法把消息发送给它，因此现在需要使用一个无头 QQ 来把消息等事件上报给 NoneBot。
-
-目前支持的协议有:
-
-- [OneBot(CQHTTP)](https://github.com/howmanybots/onebot)
-
-QQ 协议端举例:
-
-- [Mirai](https://github.com/mamoe/mirai) + [cqhttp-mirai](https://github.com/yyuueexxiinngg/cqhttp-mirai)
-- [cqhttp-mirai-embedded](https://github.com/yyuueexxiinngg/cqhttp-mirai/tree/embedded)
-- [Mirai](https://github.com/mamoe/mirai) + [Mirai Native](https://github.com/iTXTech/mirai-native) + [CQHTTP](https://github.com/richardchien/coolq-http-api)
-- [go-cqhttp](https://github.com/Mrs4s/go-cqhttp) (基于 [MiraiGo](https://github.com/Mrs4s/MiraiGo))
-- [OICQ-http-api](https://github.com/takayama-lily/onebot) (基于 [OICQ](https://github.com/takayama-lily/oicq))
-
-这里以 [go-cqhttp](https://github.com/Mrs4s/go-cqhttp) 为例
-
-1. 下载 go-cqhttp 对应平台的 release 文件
-2. 双击 exe 文件或者使用 `./go-cqhttp` 启动
-3. 生成默认配置文件并修改默认配置
-
-```json{2,3,30-31}
-{
-  "uin": 你的QQ号,
-  "password": "你的密码",
-  "encrypt_password": false,
-  "password_encrypted": "",
-  "enable_db": true,
-  "access_token": "",
-  "relogin": {
-    "enabled": true,
-    "relogin_delay": 3,
-    "max_relogin_times": 0
-  },
-  "ignore_invalid_cqcode": false,
-  "force_fragmented": true,
-  "heartbeat_interval": 0,
-  "http_config": {
-    "enabled": false,
-    "host": "0.0.0.0",
-    "port": 5700,
-    "timeout": 0,
-    "post_urls": {}
-  },
-  "ws_config": {
-    "enabled": false,
-    "host": "0.0.0.0",
-    "port": 6700
-  },
-  "ws_reverse_servers": [
-    {
-      "enabled": true,
-      "reverse_url": "ws://127.0.0.1:8080/cqhttp/ws",
-      "reverse_api_url": "",
-      "reverse_event_url": "",
-      "reverse_reconnect_interval": 3000
-    }
-  ],
-  "post_message_format": "string",
-  "debug": false,
-  "log_level": ""
-}
-```
-
-其中 `ws://127.0.0.1:8080/cqhttp/ws` 中的 `127.0.0.1` 和 `8080` 应分别对应 nonebot 配置的 HOST 和 PORT
-
-## 历史性的第一次对话
-
-一旦新的配置文件正确生效之后，NoneBot 所在的控制台（如果正在运行的话）应该会输出类似下面的内容（两条访问日志）：
-
-```default
-09-14 21:31:16 [INFO] uvicorn | ('127.0.0.1', 12345) - "WebSocket /cqhttp/ws" [accepted]
-09-14 21:31:16 [INFO] nonebot | WebSocket Connection from CQHTTP Bot 你的QQ号 Accepted!
-```
-
-这表示 QQ 协议端已经成功地使用 CQHTTP 协议连接上了 NoneBot。
-
-:::warning 注意
-如果到这一步你没有看到上面这样的成功日志，CQHTTP 的日志中在不断地重连或无反应，请注意检查配置中的 IP 和端口是否确实可以访问。比较常见的出错点包括：
-
-- NoneBot 监听 `0.0.0.0`，然后在 CQHTTP 配置中填了 `ws://0.0.0.0:8080/cqhttp/ws`
-- 在 Docker 容器内运行 CQHTTP，并通过 `127.0.0.1` 访问宿主机上的 NoneBot
-- 想从公网访问，但没有修改云服务商的安全组策略或系统防火墙
-- NoneBot 所监听的端口存在冲突，已被其它程序占用
-- 弄混了 NoneBot 的 `host`、`port` 参数与 CQHTTP 配置中的 `host`、`port` 参数
-- 使用了 `ws_reverse_api_url` 和 `ws_reverse_event_url` 而非 universal client
-- `ws://` 错填为 `http://`
-- CQHTTP 或 NoneBot 启动时遭到外星武器干扰
-
-请尝试重启 CQHTTP、重启 NoneBot、更换端口、修改防火墙、重启系统、仔细阅读前面的文档及提示、更新 CQHTTP 和 NoneBot 到最新版本等方式来解决。
-:::
-
-现在，尝试向你的 QQ 机器人账号发送如下内容：
-
-```default
-/say 你好，世界
-```
-
-到这里如果一切 OK，你应该会收到机器人给你回复了 `你好，世界`。这一历史性的对话标志着你已经成功地运行了一个 NoneBot 的最小实例，开始了编写更强大的 QQ 机器人的创意之旅！
-
-<ClientOnly>
-  <Messenger :messages="[{ position: 'right', msg: '/say 你好，世界' }, { position: 'left', msg: '你好，世界' }]"/>
-</ClientOnly>

archive/2.0.0a3/guide/installation.md

@@ -1,73 +0,0 @@
-# 安装
-
-## NoneBot
-
-:::warning 注意
-请确保你的 Python 版本 >= 3.7。
-:::
-
-```bash
-pip install nonebot2
-```
-
-如果你需要使用最新的（可能尚未发布的）特性，可以克隆 Git 仓库后手动安装：
-
-```bash
-git clone https://github.com/nonebot/nonebot2.git
-cd nonebot2
-poetry install --no-dev  # 推荐
-pip install .  # 不推荐
-```
-
-## 额外依赖
-
-### APScheduler
-
-A task scheduling library for Python.
-
-可用于计划任务，后台执行任务等
-
-```bash
-pip install nonebot2[scheduler]
-poetry add nonebot2[scheduler]
-```
-
-[View On GitHub](https://github.com/agronholm/apscheduler)
-
-### NoneBot-Test
-
-A test frontend for nonebot2.
-
-通过前端展示 nonebot 已加载的插件以及运行状态，同时可以用于模拟发送事件测试机器人
-
-```bash
-pip install nonebot2[test]
-poetry add nonebot2[test]
-```
-
-[View On GitHub](https://github.com/nonebot/nonebot-test)
-
-### CLI
-
-CLI for nonebot2.
-
-一个多功能脚手架
-
-```bash
-pip install nonebot2[cli]
-poetry add nonebot2[cli]
-```
-
-[View On GitHub](https://github.com/yanyongyu/nb-cli)
-
-### 我全都要
-
-```bash
-pip install nonebot2[full]
-poetry add nonebot2[full]
-```
-
-```bash
-pip install nonebot2[cli,scheduler]
-poetry add nonebot2[cli,scheduler]
-```

archive/2.0.0a3/guide/writing-a-plugin.md

@@ -1,290 +0,0 @@
-# 编写插件
-
-本章将以一个天气查询插件为例，教学如何编写自己的命令。
-
-## 加载插件
-
-在 [创建一个完整的项目](creating-a-project) 一章节中，我们已经创建了插件目录 `awesome_bot/plugins`，现在我们在机器人入口文件中加载它。当然，你也可以单独加载一个插件。
-
-:::tip 提示
-加载插件目录时，目录下以 `_` 下划线开头的插件将不会被加载！
-:::
-
-在 `bot.py` 文件中添加以下行：
-
-```python{5,7}
-import nonebot
-
-nonebot.init()
-# 加载单独的一个插件，参数为合法的python包名
-nonebot.load_plugin("nonebot.plugins.base")
-# 加载插件目录，该目录下为各插件，以下划线开头的插件将不会被加载
-nonebot.load_plugins("awesome_bot/plugins")
-
-app = nonebot.get_asgi()
-
-if __name__ == "__main__":
-    nonebot.run()
-```
-
-尝试运行 `nb run` 或者 `python bot.py`，可以看到日志输出了类似如下内容：
-
-```plain
-09-19 21:51:59 [INFO] nonebot | Succeeded to import "nonebot.plugins.base"
-09-19 21:51:59 [INFO] nonebot | Succeeded to import "plugin_in_folder"
-```
-
-## 创建插件
-
-现在我们已经有了一个空的插件目录，我们可以开始创建插件了！插件有两种形式
-
-### 单文件形式
-
-在插件目录下创建名为 `weather.py` 的 Python 文件，暂时留空，此时目录结构如下：
-
-<!-- prettier-ignore-start -->
-:::vue
-AweSome-Bot
-├── awesome_bot
-│   └── plugins
-│      └── `weather.py`
-├── .env
-├── .env.dev
-├── .env.prod
-├── .gitignore
-├── bot.py
-├── docker-compose.yml
-├── Dockerfile
-├── pyproject.toml
-└── README.md
-:::
-<!-- prettier-ignore-end -->
-
-这个时候它已经可以被称为一个插件了，尽管它还什么都没做。
-
-### 包形式
-
-在插件目录下创建文件夹 `weather`，并在该文件夹下创建文件 `__init__.py`，此时目录结构如下：
-
-<!-- prettier-ignore-start -->
-:::vue
-AweSome-Bot
-├── awesome_bot
-│   └── plugins
-│      └── `weather`
-│         └── `__init__.py`
-├── .env
-├── .env.dev
-├── .env.prod
-├── .gitignore
-├── bot.py
-├── docker-compose.yml
-├── Dockerfile
-├── pyproject.toml
-└── README.md
-:::
-<!-- prettier-ignore-end -->
-
-这个时候 `weather` 就是一个合法的 Python 包了，同时也是合法的 NoneBot 插件，插件内容可以在 `__init__.py` 中编写。
-
-## 编写真正的内容
-
-好了，现在插件已经可以正确加载，我们可以开始编写命令的实际代码了。在 `weather.py` 中添加如下代码：
-
-```python
-from nonebot import on_command
-from nonebot.rule import to_me
-from nonebot.adapters.cqhttp import Bot, Event
-
-weather = on_command("天气", rule=to_me(), priority=5)
-
-
-@weather.handle()
-async def handle_first_receive(bot: Bot, event: Event, state: dict):
-    args = str(event.message).strip()  # 首次发送命令时跟随的参数，例：/天气 上海，则args为上海
-    if args:
-        state["city"] = args  # 如果用户发送了参数则直接赋值
-
-
-@weather.got("city", prompt="你想查询哪个城市的天气呢？")
-async def handle_city(bot: Bot, event: Event, state: dict):
-    city = state["city"]
-    if city not in ["上海", "北京"]:
-        await weather.reject("你想查询的城市暂不支持，请重新输入！")
-    city_weather = await get_weather(city)
-    await weather.finish(city_weather)
-
-
-async def get_weather(city: str):
-    return f"{city}的天气是..."
-```
-
-为了简单起见，我们在这里的例子中没有接入真实的天气数据，但要接入也非常简单，你可以使用中国天气网、和风天气等网站提供的 API。
-
-下面我们来说明这段代码是如何工作的。
-
-:::tip 提示
-从这里开始，你需要对 Python 的 asyncio 编程有所了解，因为 NoneBot 是完全基于 asyncio 的，具体可以参考 [廖雪峰的 Python 教程](https://www.liaoxuefeng.com/wiki/1016959663602400/1017959540289152)
-:::
-
-### 注册一个 [事件响应器](../api/matcher.md)
-
-```python{4}
-from nonebot import on_command
-from nonebot.rule import to_me
-from nonebot.permission import Permission
-
-weather = on_command("天气", rule=to_me(), permission=Permission(), priority=5)
-```
-
-在上方代码中，我们注册了一个事件响应器 `Matcher`，它由几个部分组成：
-
-1. `on_command` 注册一个消息类型的命令处理器
-2. `"天气"` 指定 command 参数 - 命令名
-3. `rule` 补充事件响应器的匹配规则
-4. `priority` 事件响应器优先级
-5. `block` 是否阻止事件传递
-
-其他详细配置可以参考 API 文档，下面我们详细说明各个部分：
-
-#### 事件响应器类型 type
-
-事件响应器类型其实就是对应 `Event.type` ，NoneBot 提供了一个基础类型事件响应器 `on()` 以及一些内置的事件响应器。
-
-- `on("事件类型")`: 基础事件响应器，第一个参数为事件类型，空字符串表示不限
-- `on_metaevent()` ~ `on("meta_event")`: 元事件响应器
-- `on_message()` ~ `on("message")`: 消息事件响应器
-- `on_request()` ~ `on("request")`: 请求事件响应器
-- `on_notice()` ~ `on("notice")`: 通知事件响应器
-- `on_startswith(str)` ~ `on("message", startswith(str))`: 消息开头匹配处理器
-- `on_endswith(str)` ~ `on("message", endswith(str))`: 消息结尾匹配处理器
-- `on_command(str|tuple)` ~ `on("message", command(str|tuple))`: 命令处理器
-- `on_regex(pattern_str)` ~ `on("message", regex(pattern_str))`: 正则匹配处理器
-
-#### 匹配规则 rule
-
-事件响应器的匹配规则即 `Rule`，由非负个 `RuleChecker` 组成，当所有 `RuleChecker` 返回 `True` 时匹配成功。这些 `RuleChecker` 的形式如下：
-
-```python
-async def check(bot: Bot, event: Event, state: dict) -> bool:
-    return True
-
-def check(bot: Bot, event: Event, state: dict) -> bool:
-    return True
-```
-
-`Rule` 和 `RuleChecker` 之间可以使用 `与 &` 互相组合：
-
-```python
-from nonebot.rule import Rule
-
-Rule(async_checker1) & sync_checker & async_checker2
-```
-
-:::danger 警告
-`Rule(*checkers)` 只接受 async function，或使用 `nonebot.utils.run_sync` 自行包裹 sync function。在使用 `与 &` 时，NoneBot 会自动包裹 sync function
-:::
-
-#### 优先级 priority
-
-事件响应器的优先级代表事件响应器的执行顺序，同一优先级的事件响应器会 **同时执行！**
-
-:::tip 提示
-使用 `nonebot-test` 可以看到当前所有事件响应器的执行流程，有助理解事件响应流程！
-
-```bash
-pip install nonebot2[test]
-```
-
-:::
-
-#### 阻断 block
-
-当有任意事件响应器发出了阻止事件传递信号时，该事件将不再会传递给下一优先级，直接结束处理。
-
-NoneBot 内置的事件响应器中，所有 `message` 类的事件响应器默认会阻断事件传递，其他则不会。
-
-### 编写事件处理函数 [Handler](../api/typing.md#handler)
-
-```python{1,2,8,9}
-@weather.handle()
-async def handle_first_receive(bot: Bot, event: Event, state: dict):
-    args = str(event.message).strip()  # 首次发送命令时跟随的参数，例：/天气 上海，则args为上海
-    if args:
-        state["city"] = args  # 如果用户发送了参数则直接赋值
-
-
-@weather.got("city", prompt="你想查询哪个城市的天气呢？")
-async def handle_city(bot: Bot, event: Event, state: dict):
-    city = state["city"]
-    if city not in ["上海", "北京"]:
-        await weather.reject("你想查询的城市暂不支持，请重新输入！")
-    city_weather = await get_weather(city)
-    await weather.finish(city_weather)
-```
-
-在上面的代码中，我们给 `weather` 事件响应器添加了两个事件处理函数：`handle_first_receive`, `handle_city`
-
-其中有几个要点，我们一一解释：
-
-#### 添加一个事件处理函数
-
-在事件响应器响应事件时，事件处理函数会依次顺序执行，也就是说，与添加顺序一致。
-
-我们可以使用 `@matcher.handle()` 装饰器来简单地为该事件响应器添加一个处理函数。
-
-同时，NoneBot 内置了几种添加事件处理函数方式以方便处理：
-
-- `@matcher.receive()`: 指示 NoneBot 接收一条新的用户消息以继续执行后续处理函数。
-- `@matcher.got(key, [prompt="请输入key"], [args_parser=function])`: 指示 NoneBot 当 `state` 中不存在 `key` 时向用户发送 `prompt` 等待用户回复并赋值给 `state[key]`
-
-这些装饰器可以套娃使用！例如：
-
-```python
-@matcher.got("key1")
-@matcher.got("key2")
-async def handle(bot: Bot, event: Event, state: dict):
-    pass
-```
-
-#### 事件处理函数参数
-
-事件处理函数类型为 `Callable[[Bot, Event, dict], Union[Awaitable[None], Awaitable[NoReturn]]]` 。
-
-参数分别为：
-
-1. [nonebot.typing.Bot](../api/typing.md#bot): 即事件上报连接对应的 Bot 对象，为 BaseBot 的子类。特别注意，此处的类型注释可以替换为指定的 Bot 类型，例如：`nonebot.adapters.cqhttp.Bot`，只有在上报事件的 Bot 类型与类型注释相符时才会执行该处理函数！可用于多平台进行不同的处理。
-2. [nonebot.typing.Event](../api/typing.md#event): 即上报事件对象，可以获取到上报的所有信息。
-3. `state`: 状态字典，可以存储任意的信息
-
-#### 处理事件
-
-在事件处理函数中，我们只需要对 `event` 做出相应的处理，存入状态字典 `state` 中，或者向用户发送消息、调用某个机器人 API 等等。
-
-在 NoneBot 中，提供了几种特殊的处理函数：
-
-##### `@matcher.args_parser`
-
-这是一个装饰器，装饰一个函数来使它成为参数的默认解析函数，当使用 `matcher.got(xxx, [args_parser])` 获取到一条消息时，会运行 `matcher.got` 的 `args_parser` ，如果不存在则运行 `@matcher.args_parser`。
-
-##### `matcher.pause`
-
-这个函数用于结束当前事件处理函数，强制接收一条新的消息再运行**下一个消息处理函数**。
-
-##### `matcher.reject`
-
-这个函数用于结束当前事件处理函数，强制接收一条新的消息再**再次运行当前消息处理函数**。
-
-##### `matcher.finish`
-
-这个函数用于直接结束当前事件处理。
-
-以上三个函数都拥有一个参数 `prompt`，用于向用户发送一条消息。
-
-## 结语
-
-至此，相信你已经能够写出一个基础的插件了，更多的用法将会在 进阶 部分进行介绍，这里给出几个小提示：
-
-- 请千万注意事件处理器的优先级设定
-- 在匹配规则中请勿使用耗时极长的函数
-- 同一个用户可以跨群（私聊）继续他的事件处理（除非做出权限限制，将在后续介绍）

archive/2.0.0a3/sidebar.config.json

@@ -1,108 +0,0 @@
-{
-  "locales": {
-    "/": {
-      "label": "简体中文",
-      "selectText": "Languages",
-      "editLinkText": "在 GitHub 上编辑此页",
-      "lastUpdated": "上次更新",
-      "nav": [
-        {
-          "text": "主页",
-          "link": "/"
-        },
-        {
-          "text": "指南",
-          "link": "/guide/"
-        },
-        {
-          "text": "API",
-          "link": "/api/"
-        }
-      ],
-      "sidebarDepth": 2,
-      "sidebar": {
-        "/guide/": [
-          {
-            "title": "指南",
-            "path": "",
-            "collapsable": false,
-            "sidebar": "auto",
-            "children": [
-              "",
-              "installation",
-              "getting-started",
-              "creating-a-project",
-              "basic-configuration",
-              "writing-a-plugin"
-            ]
-          }
-        ],
-        "/api/": [
-          {
-            "title": "NoneBot Api Reference",
-            "path": "",
-            "collapsable": false,
-            "children": [
-              {
-                "title": "nonebot 模块",
-                "path": "nonebot"
-              },
-              {
-                "title": "nonebot.config 模块",
-                "path": "config"
-              },
-              {
-                "title": "nonebot.matcher 模块",
-                "path": "matcher"
-              },
-              {
-                "title": "nonebot.rule 模块",
-                "path": "rule"
-              },
-              {
-                "title": "nonebot.permission 模块",
-                "path": "permission"
-              },
-              {
-                "title": "nonebot.sched 模块",
-                "path": "sched"
-              },
-              {
-                "title": "nonebot.log 模块",
-                "path": "log"
-              },
-              {
-                "title": "nonebot.utils 模块",
-                "path": "utils"
-              },
-              {
-                "title": "nonebot.typing 模块",
-                "path": "typing"
-              },
-              {
-                "title": "nonebot.exception 模块",
-                "path": "exception"
-              },
-              {
-                "title": "nonebot.drivers 模块",
-                "path": "drivers/"
-              },
-              {
-                "title": "nonebot.drivers.fastapi 模块",
-                "path": "drivers/fastapi"
-              },
-              {
-                "title": "nonebot.adapters 模块",
-                "path": "adapters/"
-              },
-              {
-                "title": "nonebot.adapters.cqhttp 模块",
-                "path": "adapters/cqhttp"
-              }
-            ]
-          }
-        ]
-      }
-    }
-  }
-}

docs/.vuepress/components/Messenger.vue

@@ -1,219 +0,0 @@
-<template>
-  <div class="qq-chat">
-    <v-app>
-      <v-main>
-        <v-card class="elevation-6">
-          <v-toolbar color="primary" dark dense flat>
-            <v-row no-gutters>
-              <v-col>
-                <v-row no-gutters justify="space-between">
-                  <v-col cols="auto">
-                    <v-icon small>fa-chevron-left</v-icon>
-                  </v-col>
-                  <v-col cols="auto">
-                    <h3>🔥</h3>
-                  </v-col>
-                </v-row>
-              </v-col>
-              <v-col cols="auto">
-                <h3 class="white--text">NoneBot</h3>
-              </v-col>
-              <v-col class="text-right">
-                <v-icon small>fa-user</v-icon>
-              </v-col>
-            </v-row>
-          </v-toolbar>
-          <v-container fluid ref="chat" class="chat chat-bg">
-            <template v-for="(item, index) in messages">
-              <v-row
-                v-if="item.position === 'right'"
-                justify="end"
-                :key="index"
-                class="message wow animate__fadeInRight"
-                data-wow-duration="0.7s"
-              >
-                <div
-                  class="message-box"
-                  v-html="
-                    item.msg.replace(/\n/g, '<br/>').replace(/ /g, '&nbsp;')
-                  "
-                ></div>
-                <v-avatar color="blue lighten-2" size="36">
-                  <v-icon small>fa-user</v-icon>
-                </v-avatar>
-              </v-row>
-              <v-row
-                v-else-if="item.position === 'left'"
-                justify="start"
-                :key="index"
-                class="message wow animate__fadeInLeft"
-                data-wow-duration="0.7s"
-              >
-                <v-avatar color="transparent" size="36">
-                  <v-img src="/logo.png"></v-img>
-                </v-avatar>
-                <div
-                  class="message-box"
-                  v-html="
-                    item.msg.replace(/\n/g, '<br/>').replace(/ /g, '&nbsp;')
-                  "
-                ></div>
-              </v-row>
-              <v-row
-                v-else
-                justify="center"
-                :key="index"
-                class="notify mt-1 wow animate__fadeIn"
-                data-wow-duration="0.7s"
-              >
-                <div class="notify-box">
-                  <span style="display: inline; white-space: nowrap">
-                    <v-icon x-small color="blue" left>fa-info-circle</v-icon>
-                  </span>
-                  <span
-                    v-html="
-                      item.msg.replace(/\n/g, '<br/>').replace(/ /g, '&nbsp;')
-                    "
-                  ></span>
-                </div>
-              </v-row>
-            </template>
-          </v-container>
-          <v-container fluid class="chat-bg py-0">
-            <v-row dense class="mx-0">
-              <v-col>
-                <v-text-field
-                  dense
-                  solo
-                  hide-details
-                  height="28px"
-                ></v-text-field>
-              </v-col>
-              <v-col cols="auto">
-                <v-btn
-                  style="font-size: 0.8rem"
-                  color="primary"
-                  small
-                  rounded
-                  depressed
-                  >发送</v-btn
-                >
-              </v-col>
-            </v-row>
-            <v-row class="text-center" no-gutters>
-              <v-col class="pa-1" cols="2">
-                <v-icon small>fa-microphone</v-icon>
-              </v-col>
-              <v-col class="pa-1" cols="2">
-                <v-icon small>fa-image</v-icon>
-              </v-col>
-              <v-col class="pa-1" cols="2">
-                <v-icon small>fa-camera</v-icon>
-              </v-col>
-              <v-col class="pa-1" cols="2">
-                <v-icon small>fa-wallet</v-icon>
-              </v-col>
-              <v-col class="pa-1" cols="2">
-                <v-icon small>fa-smile-wink</v-icon>
-              </v-col>
-              <v-col class="pa-1" cols="2">
-                <v-icon small>fa-plus-circle</v-icon>
-              </v-col>
-            </v-row>
-          </v-container>
-        </v-card>
-      </v-main>
-    </v-app>
-  </div>
-</template>
-
-<script>
-import { WOW } from "wowjs";
-import "animate.css/animate.min.css";
-
-export default {
-  name: "Messenger",
-  props: {
-    messages: {
-      type: Array,
-      default: () => []
-    }
-  },
-  methods: {
-    initWOW: function() {
-      new WOW({
-        noxClass: "wow",
-        animateClass: "animate__animated",
-        offset: 0,
-        mobile: true,
-        live: true
-      }).init();
-    }
-  },
-  mounted() {
-    this.initWOW();
-  }
-};
-</script>
-
-<style scoped>
-.wow {
-  visibility: hidden;
-}
-
-.chat {
-  min-height: 150px;
-  overflow-x: hidden;
-}
-.chat-bg {
-  background-color: #f3f6f9;
-}
-
-.message {
-  position: relative;
-  margin: 0;
-}
-.message .message-box {
-  position: relative;
-  width: fit-content;
-  max-width: 55%;
-  border-radius: 0.5rem;
-  padding: 0.6rem 0.8rem;
-  margin: 0.4rem 0.8rem;
-  background-color: #fff;
-}
-.message .message-box::after {
-  content: "";
-  position: absolute;
-  right: 100%;
-  top: 0;
-  width: 8px;
-  height: 12px;
-  color: #fff;
-  border: 0 solid transparent;
-  border-bottom: 7px solid;
-  border-radius: 0 0 0 8px;
-}
-.message.justify-end .message-box::after {
-  left: 100%;
-  right: auto;
-  border-radius: 0 0 8px 0;
-}
-
-.notify {
-  position: relative;
-}
-.notify .notify-box {
-  max-width: 70%;
-  background: #e0e0e0;
-  border-radius: 10px;
-  padding: 5px 12px;
-  font-size: 12px;
-}
-</style>
-
-<style>
-.v-application--wrap {
-  min-height: 0 !important;
-}
-</style>

docs/.vuepress/config.js

@@ -1,173 +0,0 @@
-const path = require("path");
-
-module.exports = context => ({
-  title: "NoneBot",
-  description: "基于 酷Q 的 Python 异步 QQ 机器人框架",
-  markdown: {
-    lineNumbers: true
-  },
-  /**
-   * Extra tags to be injected to the page HTML `<head>`
-   *
-   * ref：https://v1.vuepress.vuejs.org/config/#head
-   */
-  head: [
-    ["link", { rel: "icon", href: "/logo.png" }],
-    ["meta", { name: "theme-color", content: "#d32f2f" }],
-    ["meta", { name: "application-name", content: "NoneBot" }],
-    ["meta", { name: "apple-mobile-web-app-title", content: "NoneBot" }],
-    ["meta", { name: "apple-mobile-web-app-capable", content: "yes" }],
-    [
-      "meta",
-      { name: "apple-mobile-web-app-status-bar-style", content: "black" }
-    ],
-    [
-      "link",
-      {
-        rel: "stylesheet",
-        href:
-          "https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@5/css/all.min.css"
-      }
-    ]
-  ],
-  locales: {
-    "/": {
-      lang: "zh-CN",
-      title: "NoneBot",
-      description: "基于 酷Q 的 Python 异步 QQ 机器人框架"
-    }
-  },
-
-  theme: "titanium",
-  themeConfig: {
-    logo: "/logo.png",
-    repo: "nonebot/nonebot",
-    docsDir: "docs",
-    docsBranch: "dev2",
-    docsDirVersioned: "archive",
-    docsDirPages: "pages",
-    editLinks: true,
-    smoothScroll: true,
-
-    locales: {
-      "/": {
-        label: "简体中文",
-        selectText: "Languages",
-        editLinkText: "在 GitHub 上编辑此页",
-        lastUpdated: "上次更新",
-        nav: [
-          { text: "主页", link: "/" },
-          { text: "指南", link: "/guide/" },
-          { text: "API", link: "/api/" }
-        ],
-        sidebarDepth: 2,
-        sidebar: {
-          "/guide/": [
-            {
-              title: "指南",
-              path: "",
-              collapsable: false,
-              sidebar: "auto",
-              children: [
-                "",
-                "installation",
-                "getting-started",
-                "creating-a-project",
-                "basic-configuration",
-                "writing-a-plugin"
-              ]
-            }
-          ],
-          "/api/": [
-            {
-              title: "NoneBot Api Reference",
-              path: "",
-              collapsable: false,
-              children: [
-                {
-                  title: "nonebot 模块",
-                  path: "nonebot"
-                },
-                {
-                  title: "nonebot.config 模块",
-                  path: "config"
-                },
-                {
-                  title: "nonebot.matcher 模块",
-                  path: "matcher"
-                },
-                {
-                  title: "nonebot.rule 模块",
-                  path: "rule"
-                },
-                {
-                  title: "nonebot.permission 模块",
-                  path: "permission"
-                },
-                {
-                  title: "nonebot.sched 模块",
-                  path: "sched"
-                },
-                {
-                  title: "nonebot.log 模块",
-                  path: "log"
-                },
-                {
-                  title: "nonebot.utils 模块",
-                  path: "utils"
-                },
-                {
-                  title: "nonebot.typing 模块",
-                  path: "typing"
-                },
-                {
-                  title: "nonebot.exception 模块",
-                  path: "exception"
-                },
-                {
-                  title: "nonebot.drivers 模块",
-                  path: "drivers/"
-                },
-                {
-                  title: "nonebot.drivers.fastapi 模块",
-                  path: "drivers/fastapi"
-                },
-                {
-                  title: "nonebot.adapters 模块",
-                  path: "adapters/"
-                },
-                {
-                  title: "nonebot.adapters.cqhttp 模块",
-                  path: "adapters/cqhttp"
-                }
-              ]
-            }
-          ]
-        }
-      }
-    }
-  },
-
-  plugins: [
-    "@vuepress/plugin-back-to-top",
-    "@vuepress/plugin-medium-zoom",
-    [
-      "versioning",
-      {
-        versionedSourceDir: path.resolve(context.sourceDir, "..", "archive"),
-        pagesSourceDir: path.resolve(context.sourceDir, "..", "pages"),
-        onNewVersion(version, versionDestPath) {
-          console.log(`Created version ${version} in ${versionDestPath}`);
-        }
-      }
-    ],
-    [
-      "container",
-      {
-        type: "vue",
-        before: '<pre class="vue-container"><code>',
-        after: "</code></pre>"
-      }
-    ]
-  ]
-});

docs/.vuepress/enhanceApp.js

@@ -1,42 +0,0 @@
-/**
- * Client app enhancement file.
- *
- * https://v1.vuepress.vuejs.org/guide/basic-config.html#app-level-enhancements
- */
-
-import Vuetify from "vuetify";
-import "vuetify/dist/vuetify.min.css";
-
-export default ({
-  Vue, // the version of Vue being used in the VuePress app
-  options, // the options for the root Vue instance
-  router, // the router instance for the app
-  siteData // site metadata
-}) => {
-  Vue.use(Vuetify);
-  options.vuetify = new Vuetify({
-    icons: {
-      iconfont: "fa",
-      values: {
-        //
-      }
-    }
-  });
-
-  if (typeof process === "undefined" || process.env.VUE_ENV !== "server") {
-    router.onReady(() => {
-      const { app } = router;
-      app.$once("hook:mounted", () => {
-        // temporary fix for https://github.com/vuejs/vuepress/issues/2428
-        setTimeout(() => {
-          const { hash } = document.location;
-          if (hash.length > 1) {
-            const id = decodeURI(hash.substring(1));
-            const element = document.getElementById(id);
-            if (element) element.scrollIntoView();
-          }
-        }, 500);
-      });
-    });
-  }
-};

docs/.vuepress/styles/index.styl

@@ -1,8 +0,0 @@
-/**
- * Custom Styles here.
- *
- * ref：https://v1.vuepress.vuejs.org/config/#index-styl
- */
-
-.home .hero img
-  max-width 450px!important

docs/.vuepress/styles/palette.styl

@@ -1,10 +0,0 @@
-/**
- * Custom palette here.
- *
- * ref：https://v1.vuepress.vuejs.org/zh/config/#palette-styl
- */
-
-$accentColor = #ea5252
-$textColor = #2c3e50
-$borderColor = #eaecef
-$codeBgColor = #282c34

docs/.vuepress/versions.json

@@ -1,3 +0,0 @@
-[
-  "2.0.0a3"
-]

docs/README.md

@@ -1,15 +0,0 @@
----
-home: true
-heroImage: /logo.png
-tagline: An asynchronous QQ bot framework.
-actionText: 开始使用
-actionLink: /guide/
-features:
-  - title: 简洁
-    details: 提供极其简洁易懂的 API，使你可以毫无压力地开始验证你的绝佳创意，只需编写最少量的代码，即可实现丰富的功能。
-  - title: 易于扩展
-    details: 精心设计的消息处理流程使得你可以很方便地将原型扩充为具有大量实用功能的完整聊天机器人，并持续保证扩展性。
-  - title: 高性能
-    details: 采用异步 I/O，利用 WebSocket 进行通信，以获得极高的性能；同时，支持使用多账号同时接入，减少业务宕机的可能。
-footer: MIT Licensed | Copyright © 2020 NoneBot Team
----

docs/api/README.md

@@ -1,46 +0,0 @@
-# NoneBot Api Reference
-
-
-* **模块索引**
-
-    
-    * [nonebot](nonebot.html)
-
-
-    * [nonebot.config](config.html)
-
-
-    * [nonebot.matcher](matcher.html)
-
-
-    * [nonebot.rule](rule.html)
-
-
-    * [nonebot.permission](permission.html)
-
-
-    * [nonebot.sched](sched.html)
-
-
-    * [nonebot.log](log.html)
-
-
-    * [nonebot.utils](utils.html)
-
-
-    * [nonebot.typing](typing.html)
-
-
-    * [nonebot.exception](exception.html)
-
-
-    * [nonebot.drivers](drivers/)
-
-
-    * [nonebot.drivers.fastapi](drivers/fastapi.html)
-
-
-    * [nonebot.adapters](adapters/)
-
-
-    * [nonebot.adapters.cqhttp](adapters/cqhttp.html)

docs/api/adapters/README.md

@@ -1,323 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.adapters 模块
-
-## 协议适配基类
-
-各协议请继承以下基类，并使用 `driver.register_adapter` 注册适配器
-
-
-## _class_ `BaseBot`
-
-基类：`abc.ABC`
-
-Bot 基类。用于处理上报消息，并提供 API 调用接口。
-
-
-### _abstract_ `__init__(driver, connection_type, config, self_id, *, websocket=None)`
-
-
-* **参数**
-
-    
-    * `driver: Driver`: Driver 对象
-
-
-    * `connection_type: str`: http 或者 websocket
-
-
-    * `config: Config`: Config 对象
-
-
-    * `self_id: str`: 机器人 ID
-
-
-    * `websocket: Optional[WebSocket]`: Websocket 连接对象
-
-
-
-### `driver`
-
-Driver 对象
-
-
-### `connection_type`
-
-连接类型
-
-
-### `config`
-
-Config 配置对象
-
-
-### `self_id`
-
-机器人 ID
-
-
-### `websocket`
-
-Websocket 连接对象
-
-
-### _abstract property_ `type`
-
-Adapter 类型
-
-
-### _abstract async_ `handle_message(message)`
-
-
-* **说明**
-
-    处理上报消息的函数，转换为 `Event` 事件后调用 `nonebot.message.handle_event` 进一步处理事件。
-
-
-
-* **参数**
-
-    
-    * `message: dict`: 收到的上报消息
-
-
-
-### _abstract async_ `call_api(api, **data)`
-
-
-* **说明**
-
-    调用机器人 API 接口，可以通过该函数或直接通过 bot 属性进行调用
-
-
-
-* **参数**
-
-    
-    * `api: str`: API 名称
-
-
-    * `**data`: API 数据
-
-
-
-* **示例**
-
-
-```python
-await bot.call_api("send_msg", data={"message": "hello world"})
-await bot.send_msg(message="hello world")
-```
-
-
-### _abstract async_ `send(event, message, **kwargs)`
-
-
-* **说明**
-
-    调用机器人基础发送消息接口
-
-
-
-* **参数**
-
-    
-    * `event: Event`: 上报事件
-
-
-    * `message: Union[str, Message, MessageSegment]`: 要发送的消息
-
-
-    * `**kwargs`
-
-
-
-## _class_ `BaseEvent`
-
-基类：`abc.ABC`
-
-Event 基类。提供上报信息的关键信息，其余信息可从原始上报消息获取。
-
-
-### `__init__(raw_event)`
-
-
-* **参数**
-
-    
-    * `raw_event: dict`: 原始上报消息
-
-
-
-### _property_ `raw_event`
-
-原始上报消息
-
-
-### _abstract property_ `id`
-
-事件 ID
-
-
-### _abstract property_ `name`
-
-事件名称
-
-
-### _abstract property_ `self_id`
-
-机器人 ID
-
-
-### _abstract property_ `time`
-
-事件发生时间
-
-
-### _abstract property_ `type`
-
-事件主类型
-
-
-### _abstract property_ `detail_type`
-
-事件详细类型
-
-
-### _abstract property_ `sub_type`
-
-事件子类型
-
-
-### _abstract property_ `user_id`
-
-触发事件的主体 ID
-
-
-### _abstract property_ `group_id`
-
-触发事件的主体群 ID
-
-
-### _abstract property_ `to_me`
-
-事件是否为发送给机器人的消息
-
-
-### _abstract property_ `message`
-
-消息内容
-
-
-### _abstract property_ `reply`
-
-回复的消息
-
-
-### _abstract property_ `raw_message`
-
-原始消息
-
-
-### _abstract property_ `plain_text`
-
-纯文本消息
-
-
-### _abstract property_ `sender`
-
-消息发送者信息
-
-
-## _class_ `BaseMessageSegment`
-
-基类：`abc.ABC`
-
-消息段基类
-
-
-### `type`
-
-
-* 类型: `str`
-
-
-* 说明: 消息段类型
-
-
-### `data`
-
-
-* 类型: `Dict[str, Union[str, list]]`
-
-
-* 说明: 消息段数据
-
-
-## _class_ `BaseMessage`
-
-基类：`list`, `abc.ABC`
-
-消息数组
-
-
-### `__init__(message=None, *args, **kwargs)`
-
-
-* **参数**
-
-    
-    * `message: Union[str, dict, list, MessageSegment, Message]`: 消息内容
-
-
-
-### `append(obj)`
-
-
-* **说明**
-
-    添加一个消息段到消息数组末尾
-
-
-
-* **参数**
-
-    
-    * `obj: Union[str, MessageSegment]`: 要添加的消息段
-
-
-
-### `extend(obj)`
-
-
-* **说明**
-
-    拼接一个消息数组或多个消息段到消息数组末尾
-
-
-
-* **参数**
-
-    
-    * `obj: Union[Message, Iterable[MessageSegment]]`: 要添加的消息数组
-
-
-
-### `reduce()`
-
-
-* **说明**
-
-    缩减消息数组，即拼接相邻纯文本消息段
-
-
-
-### `extract_plain_text()`
-
-
-* **说明**
-
-    提取消息内纯文本消息

docs/api/adapters/cqhttp.md

@@ -1,411 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.adapters.cqhttp 模块
-
-## CQHTTP (OneBot) v11 协议适配
-
-协议详情请看: [CQHTTP](http://cqhttp.cc/) | [OneBot](https://github.com/howmanybots/onebot)
-
-
-## `log(level, message)`
-
-
-* **说明**
-
-    用于打印 CQHTTP 日志。
-
-
-
-* **参数**
-
-    
-    * `level: str`: 日志等级
-
-
-    * `message: str`: 日志信息
-
-
-
-## `escape(s, *, escape_comma=True)`
-
-
-* **说明**
-
-    对字符串进行 CQ 码转义。
-
-
-
-* **参数**
-
-    
-    * `s: str`: 需要转义的字符串
-
-
-    * `escape_comma: bool`: 是否转义逗号（`,`）。
-
-
-
-## `unescape(s)`
-
-
-* **说明**
-
-    对字符串进行 CQ 码去转义。
-
-
-
-* **参数**
-
-    
-    * `s: str`: 需要转义的字符串
-
-
-
-## `_b2s(b)`
-
-转换布尔值为字符串。
-
-
-## _async_ `_check_reply(bot, event)`
-
-
-* **说明**
-
-    检查消息中存在的回复，去除并赋值 `event.reply`, `event.to_me`
-
-
-
-* **参数**
-
-    
-    * `bot: Bot`: Bot 对象
-
-
-    * `event: Event`: Event 对象
-
-
-
-## `_check_at_me(bot, event)`
-
-
-* **说明**
-
-    检查消息开头或结尾是否存在 @机器人，去除并赋值 `event.to_me`
-
-
-
-* **参数**
-
-    
-    * `bot: Bot`: Bot 对象
-
-
-    * `event: Event`: Event 对象
-
-
-
-## `_check_nickname(bot, event)`
-
-
-* **说明**
-
-    检查消息开头是否存在，去除并赋值 `event.to_me`
-
-
-
-* **参数**
-
-    
-    * `bot: Bot`: Bot 对象
-
-
-    * `event: Event`: Event 对象
-
-
-
-## `_handle_api_result(result)`
-
-
-* **说明**
-
-    处理 API 请求返回值。
-
-
-
-* **参数**
-
-    
-    * `result: Optional[Dict[str, Any]]`: API 返回数据
-
-
-
-* **返回**
-
-    
-    * `Any`: API 调用返回数据
-
-
-
-* **异常**
-
-    
-    * `ActionFailed`: API 调用失败
-
-
-
-## _class_ `Bot`
-
-基类：[`nonebot.adapters.BaseBot`](#None)
-
-CQHTTP 协议 Bot 适配。继承属性参考 [BaseBot](./#class-basebot) 。
-
-
-### _property_ `type`
-
-
-* 返回: `"cqhttp"`
-
-
-### _async_ `handle_message(message)`
-
-
-* **说明**
-
-    调用 [_check_reply](#async-check-reply-bot-event), [_check_at_me](#check-at-me-bot-event), [_check_nickname](#check-nickname-bot-event) 处理事件并转换为 [Event](#class-event)
-
-
-
-### _async_ `call_api(api, **data)`
-
-
-* **说明**
-
-    调用 CQHTTP 协议 API
-
-
-
-* **参数**
-
-    
-    * `api: str`: API 名称
-
-
-    * `**data: Any`: API 参数
-
-
-
-* **返回**
-
-    
-    * `Any`: API 调用返回数据
-
-
-
-* **异常**
-
-    
-    * `NetworkError`: 网络错误
-
-
-    * `ActionFailed`: API 调用失败
-
-
-
-### _async_ `send(event, message, at_sender=False, **kwargs)`
-
-
-* **说明**
-
-    根据 `event`  向触发事件的主体发送消息。
-
-
-
-* **参数**
-
-    
-    * `event: Event`: Event 对象
-
-
-    * `message: Union[str, Message, MessageSegment]`: 要发送的消息
-
-
-    * `at_sender: bool`: 是否 @ 事件主体
-
-
-    * `**kwargs`: 覆盖默认参数
-
-
-
-* **返回**
-
-    
-    * `Any`: API 调用返回数据
-
-
-
-* **异常**
-
-    
-    * `ValueError`: 缺少 `user_id`, `group_id`
-
-
-    * `NetworkError`: 网络错误
-
-
-    * `ActionFailed`: API 调用失败
-
-
-
-## _class_ `Event`
-
-基类：[`nonebot.adapters.BaseEvent`](#None)
-
-CQHTTP 协议 Event 适配。继承属性参考 [BaseEvent](./#class-baseevent) 。
-
-
-### _property_ `id`
-
-
-* 类型: `Optional[int]`
-
-
-* 说明: 事件/消息 ID
-
-
-### _property_ `name`
-
-
-* 类型: `str`
-
-
-* 说明: 事件名称，由类型与 `.` 组合而成
-
-
-### _property_ `self_id`
-
-
-* 类型: `str`
-
-
-* 说明: 机器人自身 ID
-
-
-### _property_ `time`
-
-
-* 类型: `int`
-
-
-* 说明: 事件发生时间
-
-
-### _property_ `type`
-
-
-* 类型: `str`
-
-
-* 说明: 事件类型
-
-
-### _property_ `detail_type`
-
-
-* 类型: `str`
-
-
-* 说明: 事件详细类型
-
-
-### _property_ `sub_type`
-
-
-* 类型: `Optional[str]`
-
-
-* 说明: 事件子类型
-
-
-### _property_ `user_id`
-
-
-* 类型: `Optional[int]`
-
-
-* 说明: 事件主体 ID
-
-
-### _property_ `group_id`
-
-
-* 类型: `Optional[int]`
-
-
-* 说明: 事件主体群 ID
-
-
-### _property_ `to_me`
-
-
-* 类型: `Optional[bool]`
-
-
-* 说明: 消息是否与机器人相关
-
-
-### _property_ `message`
-
-
-* 类型: `Optional[Message]`
-
-
-* 说明: 消息内容
-
-
-### _property_ `reply`
-
-
-* 类型: `Optional[dict]`
-
-
-* 说明: 回复消息详情
-
-
-### _property_ `raw_message`
-
-
-* 类型: `Optional[str]`
-
-
-* 说明: 原始消息
-
-
-### _property_ `plain_text`
-
-
-* 类型: `Optional[str]`
-
-
-* 说明: 纯文本消息内容
-
-
-### _property_ `sender`
-
-
-* 类型: `Optional[dict]`
-
-
-* 说明: 消息发送者信息
-
-
-## _class_ `MessageSegment`
-
-基类：[`nonebot.adapters.BaseMessageSegment`](#None)
-
-
-## _class_ `Message`
-
-基类：[`nonebot.adapters.BaseMessage`](#None)

docs/api/config.md

@@ -1,265 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.config 模块
-
-## 配置
-
-NoneBot 使用 [pydantic](https://pydantic-docs.helpmanual.io/) 以及 [python-dotenv](https://saurabh-kumar.com/python-dotenv/) 来读取配置。
-
-配置项需符合特殊格式或 json 序列化格式。详情见 [pydantic Field Type](https://pydantic-docs.helpmanual.io/usage/types/) 文档。
-
-
-## _class_ `Env`
-
-基类：`pydantic.env_settings.BaseSettings`
-
-运行环境配置。大小写不敏感。
-
-将会从 `nonebot.init 参数` > `环境变量` > `.env 环境配置文件` 的优先级读取配置。
-
-
-### `environment`
-
-
-* 类型: `str`
-
-
-* 默认值: `"prod"`
-
-
-* 说明:
-当前环境名。 NoneBot 将从 `.env.{environment}` 文件中加载配置。
-
-
-## _class_ `Config`
-
-基类：`nonebot.config.BaseConfig`
-
-NoneBot 主要配置。大小写不敏感。
-
-除了 NoneBot 的配置项外，还可以自行添加配置项到 `.env.{environment}` 文件中。
-这些配置将会在 json 反序列化后一起带入 `Config` 类中。
-
-
-### `driver`
-
-
-* 类型: `str`
-
-
-* 默认值: `"nonebot.drivers.fastapi"`
-
-
-* 说明:
-NoneBot 运行所使用的 `Driver` 。继承自 `nonebot.driver.BaseDriver` 。
-
-
-### `host`
-
-
-* 类型: `IPvAnyAddress`
-
-
-* 默认值: `127.0.0.1`
-
-
-* 说明:
-NoneBot 的 HTTP 和 WebSocket 服务端监听的 IP/主机名。
-
-
-### `port`
-
-
-* 类型: `int`
-
-
-* 默认值: `8080`
-
-
-* 说明:
-NoneBot 的 HTTP 和 WebSocket 服务端监听的端口。
-
-
-### `debug`
-
-
-* 类型: `bool`
-
-
-* 默认值: `False`
-
-
-* 说明:
-是否以调试模式运行 NoneBot。
-
-
-### `api_root`
-
-
-* 类型: `Dict[str, str]`
-
-
-* 默认值: `{}`
-
-
-* 说明:
-以机器人 ID 为键，上报地址为值的字典，环境变量或文件中应使用 json 序列化。
-
-
-* 示例:
-
-```default
-API_ROOT={"123456": "http://127.0.0.1:5700"}
-```
-
-
-### `api_timeout`
-
-
-* 类型: `Optional[float]`
-
-
-* 默认值: `30.`
-
-
-* 说明:
-API 请求超时时间，单位: 秒。
-
-
-### `access_token`
-
-
-* 类型: `Optional[str]`
-
-
-* 默认值: `None`
-
-
-* 说明:
-API 请求以及上报所需密钥，在请求头中携带。
-
-
-* 示例:
-
-```http
-POST /cqhttp/ HTTP/1.1
-Authorization: Bearer kSLuTF2GC2Q4q4ugm3
-```
-
-
-### `secret`
-
-
-* 类型: `Optional[str]`
-
-
-* 默认值: `None`
-
-
-* 说明:
-HTTP POST 形式上报所需签名，在请求头中携带。
-
-
-* 示例:
-
-```http
-POST /cqhttp/ HTTP/1.1
-X-Signature: sha1=f9ddd4863ace61e64f462d41ca311e3d2c1176e2
-```
-
-
-### `superusers`
-
-
-* 类型: `Set[int]`
-
-
-* 默认值: `set()`
-
-
-* 说明:
-机器人超级用户。
-
-
-* 示例:
-
-```default
-SUPER_USERS=[12345789]
-```
-
-
-### `nickname`
-
-
-* 类型: `Set[str]`
-
-
-* 默认值: `set()`
-
-
-* 说明:
-机器人昵称。
-
-
-### `command_start`
-
-
-* 类型: `Set[str]`
-
-
-* 默认值: `{"/"}`
-
-
-* 说明:
-命令的起始标记，用于判断一条消息是不是命令。
-
-
-### `command_sep`
-
-
-* 类型: `Set[str]`
-
-
-* 默认值: `{"."}`
-
-
-* 说明:
-命令的分隔标记，用于将文本形式的命令切分为元组（实际的命令名）。
-
-
-### `session_expire_timeout`
-
-
-* 类型: `timedelta`
-
-
-* 默认值: `timedelta(minutes=2)`
-
-
-* 说明:
-等待用户回复的超时时间。
-
-
-* 示例:
-
-```default
-SESSION_EXPIRE_TIMEOUT=120  # 单位: 秒
-SESSION_EXPIRE_TIMEOUT=[DD ][HH:MM]SS[.ffffff]
-SESSION_EXPIRE_TIMEOUT=P[DD]DT[HH]H[MM]M[SS]S  # ISO 8601
-```
-
-
-### `apscheduler_config`
-
-
-* 类型: `dict`
-
-
-* 默认值: `{"apscheduler.timezone": "Asia/Shanghai"}`
-
-
-* 说明:
-APScheduler 的配置对象，见 [Configuring the Scheduler](https://apscheduler.readthedocs.io/en/latest/userguide.html#configuring-the-scheduler)

docs/api/drivers/README.md

@@ -1,37 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.drivers 模块
-
-## 后端驱动适配基类
-
-各驱动请继承以下基类
-
-
-## _class_ `BaseDriver`
-
-基类：`abc.ABC`
-
-Driver 基类。将后端框架封装，以满足适配器使用。
-
-
-### `_adapters`
-
-
-* **类型**
-
-    `Dict[str, Type[Bot]]`
-
-
-
-* **说明**
-
-    已注册的适配器列表
-
-
-
-### _abstract_ `__init__(env, config)`
-
-Initialize self.  See help(type(self)) for accurate signature.

docs/api/drivers/fastapi.md

@@ -1,16 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.drivers.fastapi 模块
-
-
-## _class_ `Driver`
-
-基类：[`nonebot.drivers.BaseDriver`](#None)
-
-
-### `__init__(env, config)`
-
-Initialize self.  See help(type(self)) for accurate signature.

docs/api/exception.md

@@ -1,156 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.exception 模块
-
-## 异常
-
-下列文档中的异常是所有 NoneBot 运行时可能会抛出的。
-这些异常并非所有需要用户处理，在 NoneBot 内部运行时被捕获，并进行对应操作。
-
-
-## _exception_ `IgnoredException`
-
-基类：`Exception`
-
-
-* **说明**
-
-    指示 NoneBot 应该忽略该事件。可由 PreProcessor 抛出。
-
-
-
-* **参数**
-
-    
-    * `reason`: 忽略事件的原因
-
-
-
-## _exception_ `PausedException`
-
-基类：`Exception`
-
-
-* **说明**
-
-    指示 NoneBot 结束当前 `Handler` 并等待下一条消息后继续下一个 `Handler`。
-    可用于用户输入新信息。
-
-
-
-* **用法**
-
-    可以在 `Handler` 中通过 `Matcher.pause()` 抛出。
-
-
-
-## _exception_ `RejectedException`
-
-基类：`Exception`
-
-
-* **说明**
-
-    指示 NoneBot 结束当前 `Handler` 并等待下一条消息后重新运行当前 `Handler`。
-    可用于用户重新输入。
-
-
-
-* **用法**
-
-    可以在 `Handler` 中通过 `Matcher.reject()` 抛出。
-
-
-
-## _exception_ `FinishedException`
-
-基类：`Exception`
-
-
-* **说明**
-
-    指示 NoneBot 结束当前 `Handler` 且后续 `Handler` 不再被运行。
-    可用于结束用户会话。
-
-
-
-* **用法**
-
-    可以在 `Handler` 中通过 `Matcher.finish()` 抛出。
-
-
-
-## _exception_ `ExpiredException`
-
-基类：`Exception`
-
-
-* **说明**
-
-    指示 NoneBot 当前 `Matcher` 已失效。
-
-
-
-* **用法**
-
-    当 `Matcher` 运行前检查时抛出。
-
-
-
-## _exception_ `StopPropagation`
-
-基类：`Exception`
-
-
-* **说明**
-
-    指示 NoneBot 终止事件向下层传播。
-
-
-
-* **用法**
-
-    在 `Matcher.block == True` 时抛出。
-
-
-
-## _exception_ `ApiNotAvailable`
-
-基类：`Exception`
-
-
-* **说明**
-
-    在 API 连接不可用时抛出。
-
-
-
-## _exception_ `NetworkError`
-
-基类：`Exception`
-
-
-* **说明**
-
-    在网络出现问题时抛出，如: API 请求地址不正确, API 请求无返回或返回状态非正常等。
-
-
-
-## _exception_ `ActionFailed`
-
-基类：`Exception`
-
-
-* **说明**
-
-    API 请求成功返回数据，但 API 操作失败。
-
-
-
-* **参数**
-
-    
-    * `retcode`: 错误代码

docs/api/log.md

@@ -1,55 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.log 模块
-
-## 日志
-
-NoneBot 使用 [loguru](https://github.com/Delgan/loguru) 来记录日志信息。
-
-自定义 logger 请参考 [loguru](https://github.com/Delgan/loguru) 文档。
-
-
-## `logger`
-
-
-* **说明**
-
-    NoneBot 日志记录器对象。
-
-
-
-* **默认信息**
-
-    
-    * 格式: `[%(asctime)s %(name)s] %(levelname)s: %(message)s`
-
-
-    * 等级: `DEBUG` / `INFO` ，根据 config 配置改变
-
-
-    * 输出: 输出至 stdout
-
-
-
-* **用法**
-
-
-```python
-from nonebot.log import logger
-```
-
-
-## _class_ `LoguruHandler`
-
-基类：`logging.Handler`
-
-
-### `emit(record)`
-
-Do whatever it takes to actually log the specified logging record.
-
-This version is intended to be implemented by subclasses and so
-raises a NotImplementedError.

docs/api/matcher.md

@@ -1,485 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.matcher 模块
-
-## 事件响应器
-
-该模块实现事件响应器的创建与运行，并提供一些快捷方法来帮助用户更好的与机器人进行 对话 。
-
-
-## `matchers`
-
-
-* **类型**
-
-    `Dict[int, List[Type[Matcher]]]`
-
-
-
-* **说明**
-
-    用于存储当前所有的事件响应器
-
-
-
-## _class_ `Matcher`
-
-基类：`object`
-
-事件响应器类
-
-
-### `module`
-
-
-* **类型**
-
-    `Optional[str]`
-
-
-
-* **说明**
-
-    事件响应器所在模块名称
-
-
-
-### `type`
-
-
-* **类型**
-
-    `str`
-
-
-
-* **说明**
-
-    事件响应器类型
-
-
-
-### `rule`
-
-
-* **类型**
-
-    `Rule`
-
-
-
-* **说明**
-
-    事件响应器匹配规则
-
-
-
-### `permission`
-
-
-* **类型**
-
-    `Permission`
-
-
-
-* **说明**
-
-    事件响应器触发权限
-
-
-
-### `priority`
-
-
-* **类型**
-
-    `int`
-
-
-
-* **说明**
-
-    事件响应器优先级
-
-
-
-### `block`
-
-
-* **类型**
-
-    `bool`
-
-
-
-* **说明**
-
-    事件响应器是否阻止事件传播
-
-
-
-### `temp`
-
-
-* **类型**
-
-    `bool`
-
-
-
-* **说明**
-
-    事件响应器是否为临时
-
-
-
-### `expire_time`
-
-
-* **类型**
-
-    `Optional[datetime]`
-
-
-
-* **说明**
-
-    事件响应器过期时间点
-
-
-
-### `_default_state`
-
-
-* **类型**
-
-    `dict`
-
-
-
-* **说明**
-
-    事件响应器默认状态
-
-
-
-### `_default_parser`
-
-
-* **类型**
-
-    `Optional[ArgsParser]`
-
-
-
-* **说明**
-
-    事件响应器默认参数解析函数
-
-
-
-### `__init__()`
-
-实例化 Matcher 以便运行
-
-
-### `handlers`
-
-
-* **类型**
-
-    `List[Handler]`
-
-
-
-* **说明**
-
-    事件响应器拥有的事件处理函数列表
-
-
-
-### _classmethod_ `new(type_='', rule=None, permission=None, handlers=None, temp=False, priority=1, block=False, *, module=None, default_state=None, expire_time=None)`
-
-
-* **说明**
-
-    创建一个新的事件响应器，并存储至 [matchers](#matchers)
-
-
-
-* **参数**
-
-    
-    * `type_: str`: 事件响应器类型，与 `event.type` 一致时触发，空字符串表示任意
-
-
-    * `rule: Optional[Rule]`: 匹配规则
-
-
-    * `permission: Optional[Permission]`: 权限
-
-
-    * `handlers: Optional[List[Handler]]`: 事件处理函数列表
-
-
-    * `temp: bool`: 是否为临时事件响应器，即触发一次后删除
-
-
-    * `priority: int`: 响应优先级
-
-
-    * `block: bool`: 是否阻止事件向更低优先级的响应器传播
-
-
-    * `module: Optional[str]`: 事件响应器所在模块名称
-
-
-    * `default_state: Optional[dict]`: 默认状态 `state`
-
-
-    * `expire_time: Optional[datetime]`: 事件响应器最终有效时间点，过时即被删除
-
-
-
-* **返回**
-
-    
-    * `Type[Matcher]`: 新的事件响应器类
-
-
-
-### _async classmethod_ `check_perm(bot, event)`
-
-
-* **说明**
-
-    检查是否满足触发权限
-
-
-
-* **参数**
-
-    
-    * `bot: Bot`: Bot 对象
-
-
-    * `event: Event`: 上报事件
-
-
-
-* **返回**
-
-    
-    * `bool`: 是否满足权限
-
-
-
-### _async classmethod_ `check_rule(bot, event, state)`
-
-
-* **说明**
-
-    检查是否满足匹配规则
-
-
-
-* **参数**
-
-    
-    * `bot: Bot`: Bot 对象
-
-
-    * `event: Event`: 上报事件
-
-
-    * `state: dict`: 当前状态
-
-
-
-* **返回**
-
-    
-    * `bool`: 是否满足匹配规则
-
-
-
-### _classmethod_ `args_parser(func)`
-
-
-* **说明**
-
-    装饰一个函数来更改当前事件响应器的默认参数解析函数
-
-
-
-* **参数**
-
-    
-    * `func: ArgsParser`: 参数解析函数
-
-
-
-### _classmethod_ `handle()`
-
-
-* **说明**
-
-    装饰一个函数来向事件响应器直接添加一个处理函数
-
-
-
-* **参数**
-
-    
-    * 无
-
-
-
-### _classmethod_ `receive()`
-
-
-* **说明**
-
-    装饰一个函数来指示 NoneBot 在接收用户新的一条消息后继续运行该函数
-
-
-
-* **参数**
-
-    
-    * 无
-
-
-
-### _classmethod_ `got(key, prompt=None, args_parser=None)`
-
-
-* **说明**
-
-    装饰一个函数来指示 NoneBot 当要获取的 `key` 不存在时接收用户新的一条消息并经过 `ArgsParser` 处理后再运行该函数，如果 `key` 已存在则直接继续运行
-
-
-
-* **参数**
-
-    
-    * `key: str`: 参数名
-
-
-    * `prompt: Optional[Union[str, Message, MessageSegment]]`: 在参数不存在时向用户发送的消息
-
-
-    * `args_parser: Optional[ArgsParser]`: 可选参数解析函数，空则使用默认解析函数
-
-
-
-### _async classmethod_ `send(message)`
-
-
-* **说明**
-
-    发送一条消息给当前交互用户
-
-
-
-* **参数**
-
-    
-    * `message: Union[str, Message, MessageSegment]`: 消息内容
-
-
-
-### _async classmethod_ `finish(message=None)`
-
-
-* **说明**
-
-    发送一条消息给当前交互用户并结束当前事件响应器
-
-
-
-* **参数**
-
-    
-    * `message: Union[str, Message, MessageSegment]`: 消息内容
-
-
-
-### _async classmethod_ `pause(prompt=None)`
-
-
-* **说明**
-
-    发送一条消息给当前交互用户并暂停事件响应器，在接收用户新的一条消息后继续下一个处理函数
-
-
-
-* **参数**
-
-    
-    * `prompt: Union[str, Message, MessageSegment]`: 消息内容
-
-
-
-### _async classmethod_ `reject(prompt=None)`
-
-
-* **说明**
-
-    发送一条消息给当前交互用户并暂停事件响应器，在接收用户新的一条消息后重新运行当前处理函数
-
-
-
-* **参数**
-
-    
-    * `prompt: Union[str, Message, MessageSegment]`: 消息内容
-
-
-
-## _class_ `MatcherGroup`
-
-基类：`object`
-
-事件响应器组合，统一管理。用法同 `Matcher`
-
-
-### `__init__(type_='', rule=None, permission=None, handlers=None, temp=False, priority=1, block=False, *, module=None, default_state=None, expire_time=None)`
-
-
-* **说明**
-
-    创建一个事件响应器组合，参数为默认值，与 `Matcher.new` 一致
-
-
-
-### `matchers`
-
-
-* **类型**
-
-    `List[Type[Matcher]]`
-
-
-
-* **说明**
-
-    组内事件响应器列表
-
-
-
-### `new(type_='', rule=None, permission=None, handlers=None, temp=False, priority=1, block=False, *, module=None, default_state=None, expire_time=None)`
-
-
-* **说明**
-
-    在组中创建一个新的事件响应器，参数留空则使用组合默认值
-
-
-:::danger 警告
-如果使用 handlers 参数覆盖组合默认值则该事件响应器不会随组合一起添加新的事件处理函数
-:::

docs/api/nonebot.md

@@ -1,257 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot 模块
-
-## 快捷导入
-
-为方便使用，`nonebot` 模块从子模块导入了部分内容
-
-
-* `on_message` => `nonebot.plugin.on_message`
-
-
-* `on_notice` => `nonebot.plugin.on_notice`
-
-
-* `on_request` => `nonebot.plugin.on_request`
-
-
-* `on_metaevent` => `nonebot.plugin.on_metaevent`
-
-
-* `on_startswith` => `nonebot.plugin.on_startswith`
-
-
-* `on_endswith` => `nonebot.plugin.on_endswith`
-
-
-* `on_command` => `nonebot.plugin.on_command`
-
-
-* `on_regex` => `nonebot.plugin.on_regex`
-
-
-* `on_regex` => `nonebot.plugin.on_regex`
-
-
-* `on_regex` => `nonebot.plugin.on_regex`
-
-
-* `CommandGroup` => `nonebot.plugin.CommandGroup`
-
-
-* `load_plugin` => `nonebot.plugin.load_plugin`
-
-
-* `load_plugins` => `nonebot.plugin.load_plugins`
-
-
-* `load_builtin_plugins` => `nonebot.plugin.load_builtin_plugins`
-
-
-* `get_loaded_plugins` => `nonebot.plugin.get_loaded_plugins`
-
-
-## `get_driver()`
-
-
-* **说明**
-
-    获取全局 Driver 对象。可用于在计划任务的回调中获取当前 Driver 对象。
-
-
-
-* **返回**
-
-    
-    * `Driver`: 全局 Driver 对象
-
-
-
-* **异常**
-
-    
-    * `ValueError`: 全局 Driver 对象尚未初始化 (nonebot.init 尚未调用)
-
-
-
-* **用法**
-
-
-```python
-driver = nonebot.get_driver()
-```
-
-
-## `get_app()`
-
-
-* **说明**
-
-    获取全局 Driver 对应 Server App 对象。
-
-
-
-* **返回**
-
-    
-    * `Any`: Server App 对象
-
-
-
-* **异常**
-
-    
-    * `ValueError`: 全局 Driver 对象尚未初始化 (nonebot.init 尚未调用)
-
-
-
-* **用法**
-
-
-```python
-app = nonebot.get_app()
-```
-
-
-## `get_asgi()`
-
-
-* **说明**
-
-    获取全局 Driver 对应 Asgi 对象。
-
-
-
-* **返回**
-
-    
-    * `Any`: Asgi 对象
-
-
-
-* **异常**
-
-    
-    * `ValueError`: 全局 Driver 对象尚未初始化 (nonebot.init 尚未调用)
-
-
-
-* **用法**
-
-
-```python
-asgi = nonebot.get_asgi()
-```
-
-
-## `get_bots()`
-
-
-* **说明**
-
-    获取所有通过 ws 连接 NoneBot 的 Bot 对象。
-
-
-
-* **返回**
-
-    
-    * `Dict[str, Bot]`: 一个以字符串 ID 为键，Bot 对象为值的字典
-
-
-
-* **异常**
-
-    
-    * `ValueError`: 全局 Driver 对象尚未初始化 (nonebot.init 尚未调用)
-
-
-
-* **用法**
-
-
-```python
-bots = nonebot.get_bots()
-```
-
-
-## `init(*, _env_file=None, **kwargs)`
-
-
-* **说明**
-
-    初始化 NoneBot 以及 全局 Driver 对象。
-
-    NoneBot 将会从 .env 文件中读取环境信息，并使用相应的 env 文件配置。
-
-    你也可以传入自定义的 _env_file 来指定 NoneBot 从该文件读取配置。
-
-
-
-* **参数**
-
-    
-    * `_env_file: Optional[str]`: 配置文件名，默认从 .env.{env_name} 中读取配置
-
-
-    * `**kwargs`: 任意变量，将会存储到 Config 对象里
-
-
-
-* **返回**
-
-    
-    * `None`
-
-
-
-* **用法**
-
-
-```python
-nonebot.init(database=Database(...))
-```
-
-
-## `run(host=None, port=None, *args, **kwargs)`
-
-
-* **说明**
-
-    启动 NoneBot，即运行全局 Driver 对象。
-
-
-
-* **参数**
-
-    
-    * `host: Optional[str]`: 主机名／IP，若不传入则使用配置文件中指定的值
-
-
-    * `port: Optional[int]`: 端口，若不传入则使用配置文件中指定的值
-
-
-    * `*args`: 传入 Driver.run 的位置参数
-
-
-    * `**kwargs`: 传入 Driver.run 的命名参数
-
-
-
-* **返回**
-
-    
-    * `None`
-
-
-
-* **用法**
-
-
-```python
-nonebot.run(host="127.0.0.1", port=8080)
-```

docs/api/permission.md

@@ -1,121 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.permission 模块
-
-## 权限
-
-每个 `Matcher` 拥有一个 `Permission` ，其中是 **异步** `PermissionChecker` 的集合，只要有一个 `PermissionChecker` 检查结果为 `True` 时就会继续运行。
-
-:::tip 提示
-`PermissionChecker` 既可以是 async function 也可以是 sync function
-:::
-
-
-## `MESSAGE`
-
-
-* **说明**: 匹配任意 `message` 类型事件，仅在需要同时捕获不同类型事件时使用。优先使用 message type 的 Matcher。
-
-
-## `NOTICE`
-
-
-* **说明**: 匹配任意 `notice` 类型事件，仅在需要同时捕获不同类型事件时使用。优先使用 notice type 的 Matcher。
-
-
-## `REQUEST`
-
-
-* **说明**: 匹配任意 `request` 类型事件，仅在需要同时捕获不同类型事件时使用。优先使用 request type 的 Matcher。
-
-
-## `METAEVENT`
-
-
-* **说明**: 匹配任意 `meta_event` 类型事件，仅在需要同时捕获不同类型事件时使用。优先使用 meta_event type 的 Matcher。
-
-
-## `USER(*user, perm=<nonebot.permission.Permission object>)`
-
-
-* **说明**
-
-    在白名单内且满足 perm
-
-
-
-* **参数**
-
-    
-    * `*user: int`: 白名单
-
-
-    * `perm: Permission`: 需要同时满足的权限
-
-
-
-## `PRIVATE`
-
-
-* **说明**: 匹配任意私聊消息类型事件
-
-
-## `PRIVATE_FRIEND`
-
-
-* **说明**: 匹配任意好友私聊消息类型事件
-
-
-## `PRIVATE_GROUP`
-
-
-* **说明**: 匹配任意群临时私聊消息类型事件
-
-
-## `PRIVATE_OTHER`
-
-
-* **说明**: 匹配任意其他私聊消息类型事件
-
-
-## `GROUP`
-
-
-* **说明**: 匹配任意群聊消息类型事件
-
-
-## `GROUP_MEMBER`
-
-
-* **说明**: 匹配任意群员群聊消息类型事件
-
-:::warning 警告
-该权限通过 event.sender 进行判断且不包含管理员以及群主！
-:::
-
-
-## `GROUP_ADMIN`
-
-
-* **说明**: 匹配任意群管理员群聊消息类型事件
-
-
-## `GROUP_OWNER`
-
-
-* **说明**: 匹配任意群主群聊消息类型事件
-
-
-## `SUPERUSER`
-
-
-* **说明**: 匹配任意超级用户消息类型事件
-
-
-## `EVERYBODY`
-
-
-* **说明**: 匹配任意消息类型事件

docs/api/rule.md

@@ -1,202 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.rule 模块
-
-## 规则
-
-每个事件响应器 `Matcher` 拥有一个匹配规则 `Rule` ，其中是 **异步** `RuleChecker` 的集合，只有当所有 `RuleChecker` 检查结果为 `True` 时继续运行。
-
-:::tip 提示
-`RuleChecker` 既可以是 async function 也可以是 sync function，但在最终会被 `nonebot.utils.run_sync` 转换为 async function
-:::
-
-
-## _class_ `Rule`
-
-基类：`object`
-
-
-* **说明**
-
-    `Matcher` 规则类，当事件传递时，在 `Matcher` 运行前进行检查。
-
-
-
-* **示例**
-
-
-```python
-Rule(async_function) & sync_function
-# 等价于
-from nonebot.utils import run_sync
-Rule(async_function, run_sync(sync_function))
-```
-
-
-### `__init__(*checkers)`
-
-
-* **参数**
-
-    
-    * `*checkers: Callable[[Bot, Event, dict], Awaitable[bool]]`: **异步** RuleChecker
-
-
-
-### `checkers`
-
-
-* **说明**
-
-    存储 `RuleChecker`
-
-
-
-* **类型**
-
-    
-    * `Set[Callable[[Bot, Event, dict], Awaitable[bool]]]`
-
-
-
-### _async_ `__call__(bot, event, state)`
-
-
-* **说明**
-
-    检查是否符合所有规则
-
-
-
-* **参数**
-
-    
-    * `bot: Bot`: Bot 对象
-
-
-    * `event: Event`: Event 对象
-
-
-    * `state: dict`: 当前 State
-
-
-
-* **返回**
-
-    
-    * `bool`
-
-
-
-## `startswith(msg)`
-
-
-* **说明**
-
-    匹配消息开头
-
-
-
-* **参数**
-
-    
-    * `msg: str`: 消息开头字符串
-
-
-
-## `endswith(msg)`
-
-
-* **说明**
-
-    匹配消息结尾
-
-
-
-* **参数**
-
-    
-    * `msg: str`: 消息结尾字符串
-
-
-
-## `keyword(msg)`
-
-
-* **说明**
-
-    匹配消息关键词
-
-
-
-* **参数**
-
-    
-    * `msg: str`: 关键词
-
-
-
-## `command(command)`
-
-
-* **说明**
-
-    命令形式匹配，根据配置里提供的 `command_start`, `command_sep` 判断消息是否为命令。
-
-
-
-* **参数**
-
-    
-    * `command: Tuples[str, ...]`: 命令内容
-
-
-
-* **示例**
-
-    使用默认 `command_start`, `command_sep` 配置
-
-    命令 `("test",)` 可以匹配：`/test` 开头的消息
-    命令 `("test", "sub")` 可以匹配”`/test.sub` 开头的消息
-
-
-:::tip 提示
-命令内容与后续消息间无需空格！
-:::
-
-
-## `regex(regex, flags=0)`
-
-
-* **说明**
-
-    根据正则表达式进行匹配
-
-
-
-* **参数**
-
-    
-    * `regex: str`: 正则表达式
-
-
-    * `flags: Union[int, re.RegexFlag]`: 正则标志
-
-
-
-## `to_me()`
-
-
-* **说明**
-
-    通过 `event.to_me` 判断消息是否是发送给机器人
-
-
-
-* **参数**
-
-    
-    * 无

docs/api/sched.md

@@ -1,41 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.sched 模块
-
-## 计划任务
-
-计划任务使用第三方库 [APScheduler](https://github.com/agronholm/apscheduler) ，使用文档请参考 [APScheduler使用文档](https://apscheduler.readthedocs.io/en/latest/) 。
-
-
-## `scheduler`
-
-
-* **类型**
-
-    `Optional[apscheduler.schedulers.asyncio.AsyncIOScheduler]`
-
-
-
-* **说明**
-
-    当可选依赖 `APScheduler` 未安装时，`scheduler` 为 None
-
-    使用 `pip install nonebot[scheduler]` 安装可选依赖
-
-
-
-* **常用示例**
-
-
-```python
-from nonebot import scheduler
-
-@scheduler.scheduled_job("cron", hour="*/2", id="xxx", args=[1], kwargs={arg2: 2})
-async def run_every_2_hour(arg1, arg2):
-    pass
-
-scheduler.add_job(run_every_day_from_program_start, "interval", days=1, id="xxx")
-```

docs/api/typing.md

@@ -1,252 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.typing 模块
-
-## 类型
-
-下面的文档中，「类型」部分使用 Python 的 Type Hint 语法，见 [PEP 484](https://www.python.org/dev/peps/pep-0484/)、[PEP 526](https://www.python.org/dev/peps/pep-0526/) 和 [typing](https://docs.python.org/3/library/typing.html)。
-
-除了 Python 内置的类型，下面还出现了如下 NoneBot 自定类型，实际上它们是 Python 内置类型的别名。
-
-以下类型均可从 nonebot.typing 模块导入。
-
-
-## `Driver`
-
-
-* **类型**
-
-    `BaseDriver`
-
-
-
-* **说明**
-
-    所有 Driver 的基类。
-
-
-
-
-## `WebSocket`
-
-
-* **类型**
-
-    `BaseWebSocket`
-
-
-
-* **说明**
-
-    所有 WebSocket 的基类。
-
-
-
-
-## `Bot`
-
-
-* **类型**
-
-    `BaseBot`
-
-
-
-* **说明**
-
-    所有 Bot 的基类。
-
-
-
-
-## `Event`
-
-
-* **类型**
-
-    `BaseEvent`
-
-
-
-* **说明**
-
-    所有 Event 的基类。
-
-
-
-
-## `Message`
-
-
-* **类型**
-
-    `BaseMessage`
-
-
-
-* **说明**
-
-    所有 Message 的基类。
-
-
-
-
-## `MessageSegment`
-
-
-* **类型**
-
-    `BaseMessageSegment`
-
-
-
-* **说明**
-
-    所有 MessageSegment 的基类。
-
-
-
-
-## `PreProcessor`
-
-
-* **类型**
-
-    `Callable[[Bot, Event, dict], Union[Awaitable[None], Awaitable[NoReturn]]]`
-
-
-
-* **说明**
-
-    消息预处理函数 PreProcessor 类型
-
-
-
-
-## `Matcher`
-
-
-* **类型**
-
-    `Matcher`
-
-
-
-* **说明**
-
-    Matcher 即响应事件的处理类。通过 Rule 判断是否响应事件，运行 Handler。
-
-
-
-
-## `MatcherGroup`
-
-
-* **类型**
-
-    `MatcherGroup`
-
-
-
-* **说明**
-
-    MatcherGroup 为 Matcher 的集合。可以共享 Handler。
-
-
-
-
-## `Rule`
-
-
-* **类型**
-
-    `Rule`
-
-
-
-* **说明**
-
-    Rule 即判断是否响应事件的处理类。内部存储 RuleChecker ，返回全为 True 则响应事件。
-
-
-
-
-## `RuleChecker`
-
-
-* **类型**
-
-    `Callable[[Bot, Event, dict], Union[bool, Awaitable[bool]]]`
-
-
-
-* **说明**
-
-    RuleChecker 即判断是否响应事件的处理函数。
-
-
-
-
-## `Permission`
-
-
-* **类型**
-
-    `Permission`
-
-
-
-* **说明**
-
-    Permission 即判断是否响应消息的处理类。内部存储 PermissionChecker ，返回只要有一个 True 则响应消息。
-
-
-
-
-## `PermissionChecker`
-
-
-* **类型**
-
-    `Callable[[Bot, Event], Union[bool, Awaitable[bool]]]`
-
-
-
-* **说明**
-
-    RuleChecker 即判断是否响应消息的处理函数。
-
-
-
-
-## `Handler`
-
-
-* **类型**
-
-    `Callable[[Bot, Event, dict], Union[Awaitable[None], Awaitable[NoReturn]]]`
-
-
-
-* **说明**
-
-    Handler 即事件的处理函数。
-
-
-
-
-## `ArgsParser`
-
-
-* **类型**
-
-    `Callable[[Bot, Event, dict], Union[Awaitable[None], Awaitable[NoReturn]]]`
-
-
-
-* **说明**
-
-    ArgsParser 即消息参数解析函数，在 Matcher.got 获取参数时被运行。

docs/api/utils.md

@@ -1,62 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-# NoneBot.utils 模块
-
-
-## `escape_tag(s)`
-
-
-* **说明**
-
-    用于记录带颜色日志时转义 `<tag>` 类型特殊标签
-
-
-
-* **参数**
-
-    
-    * `s: str`: 需要转义的字符串
-
-
-
-* **返回**
-
-    
-    * `str`
-
-
-
-## `run_sync(func)`
-
-
-* **说明**
-
-    一个用于包装 sync function 为 async function 的装饰器
-
-
-
-* **参数**
-
-    
-    * `func: Callable[..., Any]`: 被装饰的同步函数
-
-
-
-* **返回**
-
-    
-    * `Callable[..., Awaitable[Any]]`
-
-
-
-## _class_ `DataclassEncoder`
-
-基类：`json.encoder.JSONEncoder`
-
-
-* **说明**
-
-    在JSON序列化 `Message` (List[Dataclass]) 时使用的 `JSONEncoder`

docs/guide/README.md

@@ -1,34 +0,0 @@
-# 概览
-
-:::tip 提示
-如果在阅读本文档时遇到难以理解的词汇，请随时查阅 [术语表](../glossary.md) 或使用 [Google 搜索](https://www.google.com/)。
-:::
-
-:::tip 提示
-初次使用时可能会觉得这里的概览过于枯燥，可以先简单略读之后直接前往 [安装](./installation.md) 查看安装方法，并进行后续的基础使用教程。
-:::
-
-NoneBot2 是一个可扩展的 Python 异步机器人框架，它会对机器人收到的消息进行解析和处理，并以插件化的形式，分发给消息所对应的命令处理器和自然语言处理器，来完成具体的功能。
-
-除了起到解析消息的作用，NoneBot 还为插件提供了大量实用的预设操作和权限控制机制，尤其对于命令处理器，它更是提供了完善且易用的会话机制和内部调用机制，以分别适应命令的连续交互和插件内部功能复用等需求。
-
-目前 NoneBot2 在 [FastAPI](https://fastapi.tiangolo.com/) 的基础上封装了与 [CQHTTP(OneBot) 协议](http://cqhttp.cc/)插件的网络交互。
-
-得益于 Python 的 [asyncio](https://docs.python.org/3/library/asyncio.html) 机制，NoneBot 处理消息的吞吐量有了很大的保障，再配合 WebSocket 通信方式（也是最建议的通信方式），NoneBot 的性能可以达到 HTTP 通信方式的两倍以上，相较于传统同步 I/O 的 HTTP 通信，更是有质的飞跃。
-
-需要注意的是，NoneBot 仅支持 Python 3.7+ 及 CQHTTP(OneBot) 插件 v11+。
-
-## 它如何工作？
-
-~~未填坑~~
-
-## 特色
-
-- 提供直观的测试前端
-- 提供使用简易的脚手架
-- 基于异步 I/O
-- 同时支持 HTTP 和反向 WebSocket 通信方式
-- 支持多个机器人账号负载均衡
-- 提供直观的交互式会话接口
-- 提供可自定义的权限控制机制
-- 多种方式渲染要发送的消息内容，使对话足够自然

docs/guide/basic-configuration.md

@@ -1,68 +0,0 @@
-# 基本配置
-
-到目前为止我们还在使用 NoneBot 的默认行为，在开始编写自己的插件之前，我们先尝试在配置文件上动动手脚，让 NoneBot 表现出不同的行为。
-
-在上一章节中，我们创建了默认的项目结构，其中 `.env`, `.env.*` 均为项目的配置文件，下面将介绍几种 NoneBot 配置方式。
-
-:::danger 警告
-请勿将敏感信息写入配置文件并提交至开源仓库！
-:::
-
-## .env 文件
-
-NoneBot 在启动时将会从系统环境变量或者 `.env` 文件中寻找变量 `ENVIRONMENT` (大小写不敏感)，默认值为 `prod`。  
-这将引导 NoneBot 从系统环境变量或者 `.env.{ENVIRONMENT}` 文件中进一步加载具体配置。
-
-现在，我们在 `.env` 文件中写入当前环境信息
-
-```bash
-# .env
-ENVIRONMENT=dev
-```
-
-## .env.\* 文件
-
-详细配置文件，使用 [pydantic](https://pydantic-docs.helpmanual.io/) 加载配置。在 NoneBot 初始化时可以指定忽略 `.env` 中的环境信息转而加载某个配置文件: `nonebot.init(_env_file=".env.dev")`。
-
-:::warning 提示
-由于 `pydantic` 使用 JSON 加载配置项，请确保配置项值为 JSON 能够解析的数据。如果 JSON 解析失败将作为字符串处理。
-:::
-
-示例及说明：
-
-```bash
-HOST=0.0.0.0  # 配置 NoneBot 监听的 IP/主机名
-PORT=8080  # 配置 NoneBot 监听的端口
-DEBUG=true  # 开启 debug 模式 **请勿在生产环境开启**
-SUPERUSERS=["123456789", "987654321"]  # 配置 NoneBot 超级用户
-NICKNAME=["awesome", "bot"]  # 配置机器人的昵称
-COMMAND_START=["/", ""]  # 配置命令起始字符
-COMMAND_SEP=["."]  # 配置命令分割字符
-
-# Custom Configs
-CUSTOM_CONFIG1="config in env file"
-CUSTOM_CONFIG2=  # 留空则从系统环境变量读取，如不存在则为空字符串
-```
-
-详细的配置项参考 [Config Reference](../api/config.md) 。
-
-## bot.py 文件
-
-配置项也可以在 NoneBot 初始化时传入。此处可以传入任意合法 Python 变量。当然也可以在初始化完成后修改或新增。
-
-示例：
-
-```python
-# bot.py
-import nonebot
-
-nonebot.init(custom_config3="config on init")
-
-config = nonebot.get_driver().config
-config.custom_config3 = "changed after init"
-config.custom_config4 = "new config after init"
-```
-
-## 优先级
-
-`bot.py init` > `env file` > `system env`

docs/guide/creating-a-project.md

@@ -1,55 +0,0 @@
-# 创建一个完整的项目
-
-上一章中我们已经运行了一个最小的 NoneBot 实例，在这一章，我们将从零开始一个完整的项目。
-
-## 目录结构
-
-首先，我们可以使用 `nb-cli` 或者自行创建项目目录：
-
-```bash
-pip install nonebot2[cli]
-# pip install nb-cli
-nb create
-```
-
-这将创建默认的目录结构
-
-<!-- prettier-ignore-start -->
-:::vue
-AweSome-Bot
-├── `awesome_bot` _(**或是 src**)_
-│   └── `plugins`
-├── `.env` _(**可选的**)_
-├── `.env.dev` _(**可选的**)_
-├── `.env.prod` _(**可选的**)_
-├── .gitignore
-├── `bot.py`
-├── docker-compose.yml
-├── Dockerfile
-├── `pyproject.toml`
-└── README.md
-:::
-<!-- prettier-ignore-end -->
-
-- `awesome_bot/plugins` 或 `src/plugins`: 用于存放编写的 bot 插件
-- `.env`, `.env.dev`, `.env.prod`: 各环境配置文件
-- `bot.py`: bot 入口文件
-- `pyproject.toml`: 项目依赖管理文件，默认使用 [poetry](https://python-poetry.org/)
-
-## 启动 Bot
-
-如果你使用 `nb-cli`
-
-```bash
-nb run [--file=bot.py] [--app=app]
-```
-
-或者使用
-
-```bash
-python bot.py
-```
-
-:::tip 提示
-如果在 bot 入口文件内定义了 asgi server， `nb-cli` 将会为你启动**冷重载模式**
-:::

docs/guide/getting-started.md

@@ -1,146 +0,0 @@
-# 开始使用
-
-一切都安装成功后，你就已经做好了进行简单配置以运行一个最小的 NoneBot 实例的准备。
-
-## 最小实例
-
-使用你最熟悉的编辑器或 IDE，创建一个名为 `bot.py` 的文件，内容如下：
-
-```python{3,4,7}
-import nonebot
-
-nonebot.init()
-nonebot.load_builtin_plugins()
-
-if __name__ == "__main__":
-    nonebot.run()
-```
-
-这几行高亮代码将依次：
-
-1. 使用默认配置初始化 NoneBot 包
-2. 加载 NoneBot 内置的插件
-3. 在地址 `127.0.0.1:8080` 运行 NoneBot
-
-在命令行使用如下命令即可运行这个 NoneBot 实例：
-
-```bash
-python bot.py
-```
-
-运行后会产生如下日志：
-
-```default
-09-14 21:02:00 [INFO] nonebot | Succeeded to import "nonebot.plugins.base"
-09-14 21:02:00 [INFO] nonebot | Running NoneBot...
-09-14 21:02:00 [INFO] uvicorn | Started server process [1234]
-09-14 21:02:00 [INFO] uvicorn | Waiting for application startup.
-09-14 21:02:00 [INFO] nonebot | Scheduler Started
-09-14 21:02:00 [INFO] uvicorn | Application startup complete.
-09-14 21:02:00 [INFO] uvicorn | Uvicorn running on http://127.0.0.1:8080 (Press CTRL+C to quit)
-```
-
-## 配置 QQ 协议端
-
-单纯运行 NoneBot 实例并不会产生任何效果，因为此刻 QQ 这边还不知道 NoneBot 的存在，也就无法把消息发送给它，因此现在需要使用一个无头 QQ 来把消息等事件上报给 NoneBot。
-
-目前支持的协议有:
-
-- [OneBot(CQHTTP)](https://github.com/howmanybots/onebot)
-
-QQ 协议端举例:
-
-- [Mirai](https://github.com/mamoe/mirai) + [cqhttp-mirai](https://github.com/yyuueexxiinngg/cqhttp-mirai)
-- [cqhttp-mirai-embedded](https://github.com/yyuueexxiinngg/cqhttp-mirai/tree/embedded)
-- [Mirai](https://github.com/mamoe/mirai) + [Mirai Native](https://github.com/iTXTech/mirai-native) + [CQHTTP](https://github.com/richardchien/coolq-http-api)
-- [go-cqhttp](https://github.com/Mrs4s/go-cqhttp) (基于 [MiraiGo](https://github.com/Mrs4s/MiraiGo))
-- [OICQ-http-api](https://github.com/takayama-lily/onebot) (基于 [OICQ](https://github.com/takayama-lily/oicq))
-
-这里以 [go-cqhttp](https://github.com/Mrs4s/go-cqhttp) 为例
-
-1. 下载 go-cqhttp 对应平台的 release 文件
-2. 双击 exe 文件或者使用 `./go-cqhttp` 启动
-3. 生成默认配置文件并修改默认配置
-
-```json{2,3,30-31}
-{
-  "uin": 你的QQ号,
-  "password": "你的密码",
-  "encrypt_password": false,
-  "password_encrypted": "",
-  "enable_db": true,
-  "access_token": "",
-  "relogin": {
-    "enabled": true,
-    "relogin_delay": 3,
-    "max_relogin_times": 0
-  },
-  "ignore_invalid_cqcode": false,
-  "force_fragmented": true,
-  "heartbeat_interval": 0,
-  "http_config": {
-    "enabled": false,
-    "host": "0.0.0.0",
-    "port": 5700,
-    "timeout": 0,
-    "post_urls": {}
-  },
-  "ws_config": {
-    "enabled": false,
-    "host": "0.0.0.0",
-    "port": 6700
-  },
-  "ws_reverse_servers": [
-    {
-      "enabled": true,
-      "reverse_url": "ws://127.0.0.1:8080/cqhttp/ws",
-      "reverse_api_url": "",
-      "reverse_event_url": "",
-      "reverse_reconnect_interval": 3000
-    }
-  ],
-  "post_message_format": "string",
-  "debug": false,
-  "log_level": ""
-}
-```
-
-其中 `ws://127.0.0.1:8080/cqhttp/ws` 中的 `127.0.0.1` 和 `8080` 应分别对应 nonebot 配置的 HOST 和 PORT
-
-## 历史性的第一次对话
-
-一旦新的配置文件正确生效之后，NoneBot 所在的控制台（如果正在运行的话）应该会输出类似下面的内容（两条访问日志）：
-
-```default
-09-14 21:31:16 [INFO] uvicorn | ('127.0.0.1', 12345) - "WebSocket /cqhttp/ws" [accepted]
-09-14 21:31:16 [INFO] nonebot | WebSocket Connection from CQHTTP Bot 你的QQ号 Accepted!
-```
-
-这表示 QQ 协议端已经成功地使用 CQHTTP 协议连接上了 NoneBot。
-
-:::warning 注意
-如果到这一步你没有看到上面这样的成功日志，CQHTTP 的日志中在不断地重连或无反应，请注意检查配置中的 IP 和端口是否确实可以访问。比较常见的出错点包括：
-
-- NoneBot 监听 `0.0.0.0`，然后在 CQHTTP 配置中填了 `ws://0.0.0.0:8080/cqhttp/ws`
-- 在 Docker 容器内运行 CQHTTP，并通过 `127.0.0.1` 访问宿主机上的 NoneBot
-- 想从公网访问，但没有修改云服务商的安全组策略或系统防火墙
-- NoneBot 所监听的端口存在冲突，已被其它程序占用
-- 弄混了 NoneBot 的 `host`、`port` 参数与 CQHTTP 配置中的 `host`、`port` 参数
-- 使用了 `ws_reverse_api_url` 和 `ws_reverse_event_url` 而非 universal client
-- `ws://` 错填为 `http://`
-- CQHTTP 或 NoneBot 启动时遭到外星武器干扰
-
-请尝试重启 CQHTTP、重启 NoneBot、更换端口、修改防火墙、重启系统、仔细阅读前面的文档及提示、更新 CQHTTP 和 NoneBot 到最新版本等方式来解决。
-:::
-
-现在，尝试向你的 QQ 机器人账号发送如下内容：
-
-```default
-/say 你好，世界
-```
-
-到这里如果一切 OK，你应该会收到机器人给你回复了 `你好，世界`。这一历史性的对话标志着你已经成功地运行了一个 NoneBot 的最小实例，开始了编写更强大的 QQ 机器人的创意之旅！
-
-<ClientOnly>
-  <Messenger :messages="[{ position: 'right', msg: '/say 你好，世界' }, { position: 'left', msg: '你好，世界' }]"/>
-</ClientOnly>

docs/guide/installation.md

@@ -1,73 +0,0 @@
-# 安装
-
-## NoneBot
-
-:::warning 注意
-请确保你的 Python 版本 >= 3.7。
-:::
-
-```bash
-pip install nonebot2
-```
-
-如果你需要使用最新的（可能尚未发布的）特性，可以克隆 Git 仓库后手动安装：
-
-```bash
-git clone https://github.com/nonebot/nonebot2.git
-cd nonebot2
-poetry install --no-dev  # 推荐
-pip install .  # 不推荐
-```
-
-## 额外依赖
-
-### APScheduler
-
-A task scheduling library for Python.
-
-可用于计划任务，后台执行任务等
-
-```bash
-pip install nonebot2[scheduler]
-poetry add nonebot2[scheduler]
-```
-
-[View On GitHub](https://github.com/agronholm/apscheduler)
-
-### NoneBot-Test
-
-A test frontend for nonebot2.
-
-通过前端展示 nonebot 已加载的插件以及运行状态，同时可以用于模拟发送事件测试机器人
-
-```bash
-pip install nonebot2[test]
-poetry add nonebot2[test]
-```
-
-[View On GitHub](https://github.com/nonebot/nonebot-test)
-
-### CLI
-
-CLI for nonebot2.
-
-一个多功能脚手架
-
-```bash
-pip install nonebot2[cli]
-poetry add nonebot2[cli]
-```
-
-[View On GitHub](https://github.com/yanyongyu/nb-cli)
-
-### 我全都要
-
-```bash
-pip install nonebot2[full]
-poetry add nonebot2[full]
-```
-
-```bash
-pip install nonebot2[cli,scheduler]
-poetry add nonebot2[cli,scheduler]
-```

docs/guide/writing-a-plugin.md

@@ -1,290 +0,0 @@
-# 编写插件
-
-本章将以一个天气查询插件为例，教学如何编写自己的命令。
-
-## 加载插件
-
-在 [创建一个完整的项目](creating-a-project) 一章节中，我们已经创建了插件目录 `awesome_bot/plugins`，现在我们在机器人入口文件中加载它。当然，你也可以单独加载一个插件。
-
-:::tip 提示
-加载插件目录时，目录下以 `_` 下划线开头的插件将不会被加载！
-:::
-
-在 `bot.py` 文件中添加以下行：
-
-```python{5,7}
-import nonebot
-
-nonebot.init()
-# 加载单独的一个插件，参数为合法的python包名
-nonebot.load_plugin("nonebot.plugins.base")
-# 加载插件目录，该目录下为各插件，以下划线开头的插件将不会被加载
-nonebot.load_plugins("awesome_bot/plugins")
-
-app = nonebot.get_asgi()
-
-if __name__ == "__main__":
-    nonebot.run()
-```
-
-尝试运行 `nb run` 或者 `python bot.py`，可以看到日志输出了类似如下内容：
-
-```plain
-09-19 21:51:59 [INFO] nonebot | Succeeded to import "nonebot.plugins.base"
-09-19 21:51:59 [INFO] nonebot | Succeeded to import "plugin_in_folder"
-```
-
-## 创建插件
-
-现在我们已经有了一个空的插件目录，我们可以开始创建插件了！插件有两种形式
-
-### 单文件形式
-
-在插件目录下创建名为 `weather.py` 的 Python 文件，暂时留空，此时目录结构如下：
-
-<!-- prettier-ignore-start -->
-:::vue
-AweSome-Bot
-├── awesome_bot
-│   └── plugins
-│      └── `weather.py`
-├── .env
-├── .env.dev
-├── .env.prod
-├── .gitignore
-├── bot.py
-├── docker-compose.yml
-├── Dockerfile
-├── pyproject.toml
-└── README.md
-:::
-<!-- prettier-ignore-end -->
-
-这个时候它已经可以被称为一个插件了，尽管它还什么都没做。
-
-### 包形式
-
-在插件目录下创建文件夹 `weather`，并在该文件夹下创建文件 `__init__.py`，此时目录结构如下：
-
-<!-- prettier-ignore-start -->
-:::vue
-AweSome-Bot
-├── awesome_bot
-│   └── plugins
-│      └── `weather`
-│         └── `__init__.py`
-├── .env
-├── .env.dev
-├── .env.prod
-├── .gitignore
-├── bot.py
-├── docker-compose.yml
-├── Dockerfile
-├── pyproject.toml
-└── README.md
-:::
-<!-- prettier-ignore-end -->
-
-这个时候 `weather` 就是一个合法的 Python 包了，同时也是合法的 NoneBot 插件，插件内容可以在 `__init__.py` 中编写。
-
-## 编写真正的内容
-
-好了，现在插件已经可以正确加载，我们可以开始编写命令的实际代码了。在 `weather.py` 中添加如下代码：
-
-```python
-from nonebot import on_command
-from nonebot.rule import to_me
-from nonebot.adapters.cqhttp import Bot, Event
-
-weather = on_command("天气", rule=to_me(), priority=5)
-
-
-@weather.handle()
-async def handle_first_receive(bot: Bot, event: Event, state: dict):
-    args = str(event.message).strip()  # 首次发送命令时跟随的参数，例：/天气 上海，则args为上海
-    if args:
-        state["city"] = args  # 如果用户发送了参数则直接赋值
-
-
-@weather.got("city", prompt="你想查询哪个城市的天气呢？")
-async def handle_city(bot: Bot, event: Event, state: dict):
-    city = state["city"]
-    if city not in ["上海", "北京"]:
-        await weather.reject("你想查询的城市暂不支持，请重新输入！")
-    city_weather = await get_weather(city)
-    await weather.finish(city_weather)
-
-
-async def get_weather(city: str):
-    return f"{city}的天气是..."
-```
-
-为了简单起见，我们在这里的例子中没有接入真实的天气数据，但要接入也非常简单，你可以使用中国天气网、和风天气等网站提供的 API。
-
-下面我们来说明这段代码是如何工作的。
-
-:::tip 提示
-从这里开始，你需要对 Python 的 asyncio 编程有所了解，因为 NoneBot 是完全基于 asyncio 的，具体可以参考 [廖雪峰的 Python 教程](https://www.liaoxuefeng.com/wiki/1016959663602400/1017959540289152)
-:::
-
-### 注册一个 [事件响应器](../api/matcher.md)
-
-```python{4}
-from nonebot import on_command
-from nonebot.rule import to_me
-from nonebot.permission import Permission
-
-weather = on_command("天气", rule=to_me(), permission=Permission(), priority=5)
-```
-
-在上方代码中，我们注册了一个事件响应器 `Matcher`，它由几个部分组成：
-
-1. `on_command` 注册一个消息类型的命令处理器
-2. `"天气"` 指定 command 参数 - 命令名
-3. `rule` 补充事件响应器的匹配规则
-4. `priority` 事件响应器优先级
-5. `block` 是否阻止事件传递
-
-其他详细配置可以参考 API 文档，下面我们详细说明各个部分：
-
-#### 事件响应器类型 type
-
-事件响应器类型其实就是对应 `Event.type` ，NoneBot 提供了一个基础类型事件响应器 `on()` 以及一些内置的事件响应器。
-
-- `on("事件类型")`: 基础事件响应器，第一个参数为事件类型，空字符串表示不限
-- `on_metaevent()` ~ `on("meta_event")`: 元事件响应器
-- `on_message()` ~ `on("message")`: 消息事件响应器
-- `on_request()` ~ `on("request")`: 请求事件响应器
-- `on_notice()` ~ `on("notice")`: 通知事件响应器
-- `on_startswith(str)` ~ `on("message", startswith(str))`: 消息开头匹配处理器
-- `on_endswith(str)` ~ `on("message", endswith(str))`: 消息结尾匹配处理器
-- `on_command(str|tuple)` ~ `on("message", command(str|tuple))`: 命令处理器
-- `on_regex(pattern_str)` ~ `on("message", regex(pattern_str))`: 正则匹配处理器
-
-#### 匹配规则 rule
-
-事件响应器的匹配规则即 `Rule`，由非负个 `RuleChecker` 组成，当所有 `RuleChecker` 返回 `True` 时匹配成功。这些 `RuleChecker` 的形式如下：
-
-```python
-async def check(bot: Bot, event: Event, state: dict) -> bool:
-    return True
-
-def check(bot: Bot, event: Event, state: dict) -> bool:
-    return True
-```
-
-`Rule` 和 `RuleChecker` 之间可以使用 `与 &` 互相组合：
-
-```python
-from nonebot.rule import Rule
-
-Rule(async_checker1) & sync_checker & async_checker2
-```
-
-:::danger 警告
-`Rule(*checkers)` 只接受 async function，或使用 `nonebot.utils.run_sync` 自行包裹 sync function。在使用 `与 &` 时，NoneBot 会自动包裹 sync function
-:::
-
-#### 优先级 priority
-
-事件响应器的优先级代表事件响应器的执行顺序，同一优先级的事件响应器会 **同时执行！**
-
-:::tip 提示
-使用 `nonebot-test` 可以看到当前所有事件响应器的执行流程，有助理解事件响应流程！
-
-```bash
-pip install nonebot2[test]
-```
-
-:::
-
-#### 阻断 block
-
-当有任意事件响应器发出了阻止事件传递信号时，该事件将不再会传递给下一优先级，直接结束处理。
-
-NoneBot 内置的事件响应器中，所有 `message` 类的事件响应器默认会阻断事件传递，其他则不会。
-
-### 编写事件处理函数 [Handler](../api/typing.md#handler)
-
-```python{1,2,8,9}
-@weather.handle()
-async def handle_first_receive(bot: Bot, event: Event, state: dict):
-    args = str(event.message).strip()  # 首次发送命令时跟随的参数，例：/天气 上海，则args为上海
-    if args:
-        state["city"] = args  # 如果用户发送了参数则直接赋值
-
-
-@weather.got("city", prompt="你想查询哪个城市的天气呢？")
-async def handle_city(bot: Bot, event: Event, state: dict):
-    city = state["city"]
-    if city not in ["上海", "北京"]:
-        await weather.reject("你想查询的城市暂不支持，请重新输入！")
-    city_weather = await get_weather(city)
-    await weather.finish(city_weather)
-```
-
-在上面的代码中，我们给 `weather` 事件响应器添加了两个事件处理函数：`handle_first_receive`, `handle_city`
-
-其中有几个要点，我们一一解释：
-
-#### 添加一个事件处理函数
-
-在事件响应器响应事件时，事件处理函数会依次顺序执行，也就是说，与添加顺序一致。
-
-我们可以使用 `@matcher.handle()` 装饰器来简单地为该事件响应器添加一个处理函数。
-
-同时，NoneBot 内置了几种添加事件处理函数方式以方便处理：
-
-- `@matcher.receive()`: 指示 NoneBot 接收一条新的用户消息以继续执行后续处理函数。
-- `@matcher.got(key, [prompt="请输入key"], [args_parser=function])`: 指示 NoneBot 当 `state` 中不存在 `key` 时向用户发送 `prompt` 等待用户回复并赋值给 `state[key]`
-
-这些装饰器可以套娃使用！例如：
-
-```python
-@matcher.got("key1")
-@matcher.got("key2")
-async def handle(bot: Bot, event: Event, state: dict):
-    pass
-```
-
-#### 事件处理函数参数
-
-事件处理函数类型为 `Callable[[Bot, Event, dict], Union[Awaitable[None], Awaitable[NoReturn]]]` 。
-
-参数分别为：
-
-1. [nonebot.typing.Bot](../api/typing.md#bot): 即事件上报连接对应的 Bot 对象，为 BaseBot 的子类。特别注意，此处的类型注释可以替换为指定的 Bot 类型，例如：`nonebot.adapters.cqhttp.Bot`，只有在上报事件的 Bot 类型与类型注释相符时才会执行该处理函数！可用于多平台进行不同的处理。
-2. [nonebot.typing.Event](../api/typing.md#event): 即上报事件对象，可以获取到上报的所有信息。
-3. `state`: 状态字典，可以存储任意的信息
-
-#### 处理事件
-
-在事件处理函数中，我们只需要对 `event` 做出相应的处理，存入状态字典 `state` 中，或者向用户发送消息、调用某个机器人 API 等等。
-
-在 NoneBot 中，提供了几种特殊的处理函数：
-
-##### `@matcher.args_parser`
-
-这是一个装饰器，装饰一个函数来使它成为参数的默认解析函数，当使用 `matcher.got(xxx, [args_parser])` 获取到一条消息时，会运行 `matcher.got` 的 `args_parser` ，如果不存在则运行 `@matcher.args_parser`。
-
-##### `matcher.pause`
-
-这个函数用于结束当前事件处理函数，强制接收一条新的消息再运行**下一个消息处理函数**。
-
-##### `matcher.reject`
-
-这个函数用于结束当前事件处理函数，强制接收一条新的消息再**再次运行当前消息处理函数**。
-
-##### `matcher.finish`
-
-这个函数用于直接结束当前事件处理。
-
-以上三个函数都拥有一个参数 `prompt`，用于向用户发送一条消息。
-
-## 结语
-
-至此，相信你已经能够写出一个基础的插件了，更多的用法将会在 进阶 部分进行介绍，这里给出几个小提示：
-
-- 请千万注意事件处理器的优先级设定
-- 在匹配规则中请勿使用耗时极长的函数
-- 同一个用户可以跨群（私聊）继续他的事件处理（除非做出权限限制，将在后续介绍）

docs_build/Makefile

@@ -1,20 +0,0 @@
-# Minimal makefile for Sphinx documentation
-#
-
-# You can set these variables from the command line, and also
-# from the environment for the first two.
-SPHINXOPTS    ?=
-SPHINXBUILD   ?= sphinx-build
-SOURCEDIR     = .
-BUILDDIR      = _build
-
-# Put it first so that "make" without argument is like "make help".
-help:
-	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
-
-.PHONY: help Makefile
-
-# Catch-all target: route all unknown targets to Sphinx using the new
-# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
-%: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs_build/README.rst

@@ -1,18 +0,0 @@
-NoneBot Api Reference
-=====================
-
-:模块索引:
-  - `nonebot <nonebot.html>`_
-  - `nonebot.config <config.html>`_
-  - `nonebot.matcher <matcher.html>`_
-  - `nonebot.rule <rule.html>`_
-  - `nonebot.permission <permission.html>`_
-  - `nonebot.sched <sched.html>`_
-  - `nonebot.log <log.html>`_
-  - `nonebot.utils <utils.html>`_
-  - `nonebot.typing <typing.html>`_
-  - `nonebot.exception <exception.html>`_
-  - `nonebot.drivers <drivers/>`_
-  - `nonebot.drivers.fastapi <drivers/fastapi.html>`_
-  - `nonebot.adapters <adapters/>`_
-  - `nonebot.adapters.cqhttp <adapters/cqhttp.html>`_

docs_build/adapters/README.rst

@@ -1,13 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-NoneBot.adapters 模块
-=====================
-
-.. automodule:: nonebot.adapters
-   :members:
-   :private-members:
-   :special-members: __init__
-   :show-inheritance:

docs_build/adapters/cqhttp.rst

@@ -1,12 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-NoneBot.adapters.cqhttp 模块
-============================
-
-.. automodule:: nonebot.adapters.cqhttp
-   :members:
-   :private-members:
-   :show-inheritance:

docs_build/conf.py

@@ -1,79 +0,0 @@
-# Configuration file for the Sphinx documentation builder.
-#
-# This file only contains a selection of the most common options. For a full
-# list see the documentation:
-# https://www.sphinx-doc.org/en/master/usage/configuration.html
-
-# -- Path setup --------------------------------------------------------------
-
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-#
-import os
-import sys
-sys.path.insert(0, os.path.abspath(os.path.dirname(os.path.dirname(__file__))))
-
-# -- Project information -----------------------------------------------------
-
-project = 'nonebot'
-copyright = '2020, richardchien'
-author = 'richardchien'
-
-# The short X.Y version
-version = '2.0.0'
-
-# The full version, including alpha/beta/rc tags
-release = '2.0.0'
-
-# -- General configuration ---------------------------------------------------
-
-# Add any Sphinx extension module names here, as strings. They can be
-# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
-# ones.
-extensions = [
-    'sphinx.ext.autodoc',
-    'sphinx.ext.viewcode',
-    'sphinx.ext.todo',
-]
-
-# Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
-
-# The language for content autogenerated by Sphinx. Refer to documentation
-# for a list of supported languages.
-#
-# This is also used if you do content translation via gettext catalogs.
-# Usually you set "language" from the command line for these cases.
-language = 'zh'
-
-master_doc = "README"
-
-# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-# This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
-
-# -- Options for HTML output -------------------------------------------------
-
-# The theme to use for HTML and HTML Help pages.  See the documentation for
-# a list of builtin themes.
-#
-html_theme = 'alabaster'
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
-
-# html_baseurl = '/api/'
-
-# -- Extension configuration -------------------------------------------------
-
-# -- Options for autodoc extension ----------------------------------------------
-autodoc_default_options = {'member-order': 'bysource'}
-
-# -- Options for todo extension ----------------------------------------------
-
-# If true, `todo` and `todoList` produce output, else they produce nothing.
-todo_include_todos = True

docs_build/config.rst

@@ -1,11 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-NoneBot.config 模块
-===================
-
-.. automodule:: nonebot.config
-   :members: Env, Config
-   :show-inheritance:

docs_build/drivers/README.rst

@@ -1,13 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-NoneBot.drivers 模块
-=====================
-
-.. automodule:: nonebot.drivers
-   :members:
-   :private-members:
-   :special-members: __init__
-   :show-inheritance:

docs_build/drivers/fastapi.rst

@@ -1,13 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-NoneBot.drivers.fastapi 模块
-=====================
-
-.. automodule:: nonebot.drivers.fastapi
-   :members:
-   :private-members:
-   :special-members: __init__
-   :show-inheritance:

docs_build/exception.rst

@@ -1,11 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-NoneBot.exception 模块
-======================
-
-.. automodule:: nonebot.exception
-   :members:
-   :show-inheritance:

docs_build/log.rst

@@ -1,11 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-NoneBot.log 模块
-=================
-
-.. automodule:: nonebot.log
-   :members:
-   :show-inheritance:

docs_build/make.bat

@@ -1,35 +0,0 @@
-@ECHO OFF
-
-pushd %~dp0
-
-REM Command file for Sphinx documentation
-
-if "%SPHINXBUILD%" == "" (
-	set SPHINXBUILD=sphinx-build
-)
-set SOURCEDIR=.
-set BUILDDIR=_build
-
-if "%1" == "" goto help
-
-%SPHINXBUILD% >NUL 2>NUL
-if errorlevel 9009 (
-	echo.
-	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
-	echo.installed, then set the SPHINXBUILD environment variable to point
-	echo.to the full path of the 'sphinx-build' executable. Alternatively you
-	echo.may add the Sphinx directory to PATH.
-	echo.
-	echo.If you don't have Sphinx installed, grab it from
-	echo.http://sphinx-doc.org/
-	exit /b 1
-)
-
-%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
-goto end
-
-:help
-%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
-
-:end
-popd

docs_build/matcher.rst

@@ -1,13 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-NoneBot.matcher 模块
-====================
-
-.. automodule:: nonebot.matcher
-   :members:
-   :private-members:
-   :special-members: __init__
-   :show-inheritance:

docs_build/nonebot.rst

@@ -1,11 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-NoneBot 模块
-===============
-
-.. automodule:: nonebot
-   :members:
-   :show-inheritance:

docs_build/permission.rst

@@ -1,11 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-NoneBot.permission 模块
-=======================
-
-.. automodule:: nonebot.permission
-   :members:
-   :show-inheritance:

docs_build/rule.rst

@@ -1,12 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-NoneBot.rule 模块
-====================
-
-.. automodule:: nonebot.rule
-   :members:
-   :special-members:
-   :show-inheritance:

docs_build/sched.rst

@@ -1,11 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-NoneBot.sched 模块
-===================
-
-.. automodule:: nonebot.sched
-   :members:
-   :show-inheritance:

docs_build/typing.rst

@@ -1,11 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-NoneBot.typing 模块
-===================
-
-.. automodule:: nonebot.typing
-   :members:
-   :show-inheritance:

docs_build/utils.rst

@@ -1,13 +0,0 @@
----
-contentSidebar: true
-sidebarDepth: 0
----
-
-NoneBot.utils 模块
-==================
-
-
-.. autofunction:: nonebot.utils.escape_tag
-.. autodecorator:: nonebot.utils.run_sync
-.. autoclass:: nonebot.utils.DataclassEncoder
-  :show-inheritance:

nonebot/__init__.py

@@ -1,240 +1,288 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-快捷导入
-========
+"""本模块主要定义了 NoneBot 启动所需函数，供 bot 入口文件调用。
 
-为方便使用，``nonebot`` 模块从子模块导入了部分内容
+## 快捷导入
 
-- ``on_message`` => ``nonebot.plugin.on_message``
-- ``on_notice`` => ``nonebot.plugin.on_notice``
-- ``on_request`` => ``nonebot.plugin.on_request``
-- ``on_metaevent`` => ``nonebot.plugin.on_metaevent``
-- ``on_startswith`` => ``nonebot.plugin.on_startswith``
-- ``on_endswith`` => ``nonebot.plugin.on_endswith``
-- ``on_command`` => ``nonebot.plugin.on_command``
-- ``on_regex`` => ``nonebot.plugin.on_regex``
-- ``on_regex`` => ``nonebot.plugin.on_regex``
-- ``on_regex`` => ``nonebot.plugin.on_regex``
-- ``CommandGroup`` => ``nonebot.plugin.CommandGroup``
-- ``load_plugin`` => ``nonebot.plugin.load_plugin``
-- ``load_plugins`` => ``nonebot.plugin.load_plugins``
-- ``load_builtin_plugins`` => ``nonebot.plugin.load_builtin_plugins``
-- ``get_loaded_plugins`` => ``nonebot.plugin.get_loaded_plugins``
+为方便使用，本模块从子模块导入了部分内容，以下内容可以直接通过本模块导入:
+
+- `on` => {ref}``on` <nonebot.plugin.on.on>`
+- `on_metaevent` => {ref}``on_metaevent` <nonebot.plugin.on.on_metaevent>`
+- `on_message` => {ref}``on_message` <nonebot.plugin.on.on_message>`
+- `on_notice` => {ref}``on_notice` <nonebot.plugin.on.on_notice>`
+- `on_request` => {ref}``on_request` <nonebot.plugin.on.on_request>`
+- `on_startswith` => {ref}``on_startswith` <nonebot.plugin.on.on_startswith>`
+- `on_endswith` => {ref}``on_endswith` <nonebot.plugin.on.on_endswith>`
+- `on_fullmatch` => {ref}``on_fullmatch` <nonebot.plugin.on.on_fullmatch>`
+- `on_keyword` => {ref}``on_keyword` <nonebot.plugin.on.on_keyword>`
+- `on_command` => {ref}``on_command` <nonebot.plugin.on.on_command>`
+- `on_shell_command` => {ref}``on_shell_command` <nonebot.plugin.on.on_shell_command>`
+- `on_regex` => {ref}``on_regex` <nonebot.plugin.on.on_regex>`
+- `CommandGroup` => {ref}``CommandGroup` <nonebot.plugin.on.CommandGroup>`
+- `Matchergroup` => {ref}``MatcherGroup` <nonebot.plugin.on.MatcherGroup>`
+- `load_plugin` => {ref}``load_plugin` <nonebot.plugin.load.load_plugin>`
+- `load_plugins` => {ref}``load_plugins` <nonebot.plugin.load.load_plugins>`
+- `load_all_plugins` => {ref}``load_all_plugins` <nonebot.plugin.load.load_all_plugins>`
+- `load_from_json` => {ref}``load_from_json` <nonebot.plugin.load.load_from_json>`
+- `load_from_toml` => {ref}``load_from_toml` <nonebot.plugin.load.load_from_toml>`
+- `load_builtin_plugin` => {ref}``load_builtin_plugin` <nonebot.plugin.load.load_builtin_plugin>`
+- `load_builtin_plugins` => {ref}``load_builtin_plugins` <nonebot.plugin.load.load_builtin_plugins>`
+- `get_plugin` => {ref}``get_plugin` <nonebot.plugin.plugin.get_plugin>`
+- `get_loaded_plugins` => {ref}``get_loaded_plugins` <nonebot.plugin.plugin.get_loaded_plugins>`
+- `export` => {ref}``export` <nonebot.plugin.export.export>`
+- `require` => {ref}``require` <nonebot.plugin.load.require>`
+
+FrontMatter:
+    sidebar_position: 0
+    description: nonebot 模块
 """
 
 import importlib
-from nonebot.typing import Bot, Dict, Type, Union, Driver, Optional, NoReturn
+from typing import Any, Dict, Type, Optional
+
+import pkg_resources
+
+from nonebot.adapters import Bot
+from nonebot.utils import escape_tag
+from nonebot.config import Env, Config
+from nonebot.log import logger, default_filter
+from nonebot.drivers import Driver, ReverseDriver, combine_driver
+
+try:
+    _dist: pkg_resources.Distribution = pkg_resources.get_distribution("nonebot2")
+    __version__ = _dist.version
+    VERSION = _dist.parsed_version
+except pkg_resources.DistributionNotFound:  # pragma: no cover
+    __version__ = None
+    VERSION = None
 
 _driver: Optional[Driver] = None
 
 
-def get_driver() -> Union[NoReturn, Driver]:
-    """
-    :说明:
+def get_driver() -> Driver:
+    """获取全局 {ref}`nonebot.drivers.Driver` 实例。
 
-      获取全局 Driver 对象。可用于在计划任务的回调中获取当前 Driver 对象。
+    可用于在计划任务的回调等情形中获取当前 {ref}`nonebot.drivers.Driver` 实例。
 
-    :返回:
+    返回:
+        全局 {ref}`nonebot.drivers.Driver` 对象
 
-      * ``Driver``: 全局 Driver 对象
-
-    :异常:
-
-      * ``ValueError``: 全局 Driver 对象尚未初始化 (nonebot.init 尚未调用)
-
-    :用法:
-
-    .. code-block:: python
+    异常:
+        ValueError: 全局 {ref}`nonebot.drivers.Driver` 对象尚未初始化 ({ref}`nonebot.init <nonebot.init>` 尚未调用)
 
+    用法:
+        ```python
         driver = nonebot.get_driver()
-
+        ```
     """
     if _driver is None:
         raise ValueError("NoneBot has not been initialized.")
     return _driver
 
 
-def get_app():
-    """
-    :说明:
+def get_app() -> Any:
+    """获取全局 {ref}`nonebot.drivers.ReverseDriver` 对应的 Server App 对象。
 
-      获取全局 Driver 对应 Server App 对象。
+    返回:
+        Server App 对象
 
-    :返回:
-
-      * ``Any``: Server App 对象
-
-    :异常:
-
-      * ``ValueError``: 全局 Driver 对象尚未初始化 (nonebot.init 尚未调用)
-
-    :用法:
-
-    .. code-block:: python
+    异常:
+        AssertionError: 全局 Driver 对象不是 {ref}`nonebot.drivers.ReverseDriver` 类型
+        ValueError: 全局 {ref}`nonebot.drivers.Driver` 对象尚未初始化 ({ref}`nonebot.init <nonebot.init>` 尚未调用)
 
+    用法:
+        ```python
         app = nonebot.get_app()
-
+        ```
     """
     driver = get_driver()
+    assert isinstance(
+        driver, ReverseDriver
+    ), "app object is only available for reverse driver"
     return driver.server_app
 
 
-def get_asgi():
-    """
-    :说明:
+def get_asgi() -> Any:
+    """获取全局 {ref}`nonebot.drivers.ReverseDriver` 对应 [ASGI](https://asgi.readthedocs.io/) 对象。
 
-      获取全局 Driver 对应 Asgi 对象。
+    返回:
+        ASGI 对象
 
-    :返回:
-
-      * ``Any``: Asgi 对象
-
-    :异常:
-
-      * ``ValueError``: 全局 Driver 对象尚未初始化 (nonebot.init 尚未调用)
-
-    :用法:
-
-    .. code-block:: python
+    异常:
+        AssertionError: 全局 Driver 对象不是 {ref}`nonebot.drivers.ReverseDriver` 类型
+        ValueError: 全局 {ref}`nonebot.drivers.Driver` 对象尚未初始化 ({ref}`nonebot.init <nonebot.init>` 尚未调用)
 
+    用法:
+        ```python
         asgi = nonebot.get_asgi()
-
+        ```
     """
     driver = get_driver()
+    assert isinstance(
+        driver, ReverseDriver
+    ), "asgi object is only available for reverse driver"
     return driver.asgi
 
 
-def get_bots() -> Union[NoReturn, Dict[str, Bot]]:
+def get_bot(self_id: Optional[str] = None) -> Bot:
+    """获取一个连接到 NoneBot 的 {ref}`nonebot.adapters.Bot` 对象。
+
+    当提供 `self_id` 时，此函数是 `get_bots()[self_id]` 的简写；
+    当不提供时，返回一个 {ref}`nonebot.adapters.Bot`。
+
+    参数:
+        self_id: 用来识别 {ref}`nonebot.adapters.Bot` 的 {ref}`nonebot.adapters.Bot.self_id` 属性
+
+    返回:
+        {ref}`nonebot.adapters.Bot` 对象
+
+    异常:
+        KeyError: 对应 self_id 的 Bot 不存在
+        ValueError: 没有传入 self_id 且没有 Bot 可用
+        ValueError: 全局 {ref}`nonebot.drivers.Driver` 对象尚未初始化 ({ref}`nonebot.init <nonebot.init>` 尚未调用)
+
+    用法:
+        ```python
+        assert nonebot.get_bot("12345") == nonebot.get_bots()["12345"]
+
+        another_unspecified_bot = nonebot.get_bot()
+        ```
     """
-    :说明:
+    bots = get_bots()
+    if self_id is not None:
+        return bots[self_id]
 
-      获取所有通过 ws 连接 NoneBot 的 Bot 对象。
+    for bot in bots.values():
+        return bot
 
-    :返回:
+    raise ValueError("There are no bots to get.")
 
-      * ``Dict[str, Bot]``: 一个以字符串 ID 为键，Bot 对象为值的字典
 
-    :异常:
+def get_bots() -> Dict[str, Bot]:
+    """获取所有连接到 NoneBot 的 {ref}`nonebot.adapters.Bot` 对象。
 
-      * ``ValueError``: 全局 Driver 对象尚未初始化 (nonebot.init 尚未调用)
+    返回:
+        一个以 {ref}`nonebot.adapters.Bot.self_id` 为键，{ref}`nonebot.adapters.Bot` 对象为值的字典
 
-    :用法:
-
-    .. code-block:: python
+    异常:
+        ValueError: 全局 {ref}`nonebot.drivers.Driver` 对象尚未初始化 ({ref}`nonebot.init <nonebot.init>` 尚未调用)
 
+    用法:
+        ```python
         bots = nonebot.get_bots()
-
+        ```
     """
     driver = get_driver()
     return driver.bots
 
 
-from nonebot.sched import scheduler
-from nonebot.utils import escape_tag
-from nonebot.config import Env, Config
-from nonebot.log import logger, default_filter
-from nonebot.adapters.cqhttp import Bot as CQBot
-
-try:
-    import nonebot_test
-except ImportError:
-    nonebot_test = None
+def _resolve_dot_notation(
+    obj_str: str, default_attr: str, default_prefix: Optional[str] = None
+) -> Any:
+    modulename, _, cls = obj_str.partition(":")
+    if default_prefix is not None and modulename.startswith("~"):
+        modulename = default_prefix + modulename[1:]
+    module = importlib.import_module(modulename)
+    if not cls:
+        return getattr(module, default_attr)
+    instance = module
+    for attr_str in cls.split("."):
+        instance = getattr(instance, attr_str)
+    return instance
 
 
-def init(*, _env_file: Optional[str] = None, **kwargs):
-    """
-    :说明:
+def _resolve_combine_expr(obj_str: str) -> Type[Driver]:
+    drivers = obj_str.split("+")
+    DriverClass = _resolve_dot_notation(
+        drivers[0], "Driver", default_prefix="nonebot.drivers."
+    )
+    if len(drivers) == 1:
+        logger.trace(f"Detected driver {DriverClass} with no mixins.")
+        return DriverClass
+    mixins = [
+        _resolve_dot_notation(mixin, "Mixin", default_prefix="nonebot.drivers.")
+        for mixin in drivers[1:]
+    ]
+    logger.trace(f"Detected driver {DriverClass} with mixins {mixins}.")
+    return combine_driver(DriverClass, *mixins)
 
-      初始化 NoneBot 以及 全局 Driver 对象。
+
+def init(*, _env_file: Optional[str] = None, **kwargs: Any) -> None:
+    """初始化 NoneBot 以及 全局 {ref}`nonebot.drivers.Driver` 对象。
 
     NoneBot 将会从 .env 文件中读取环境信息，并使用相应的 env 文件配置。
 
-      你也可以传入自定义的 _env_file 来指定 NoneBot 从该文件读取配置。
+    也可以传入自定义的 `_env_file` 来指定 NoneBot 从该文件读取配置。
 
-    :参数:
-
-      * ``_env_file: Optional[str]``: 配置文件名，默认从 .env.{env_name} 中读取配置
-      * ``**kwargs``: 任意变量，将会存储到 Config 对象里
-
-    :返回:
-
-      - ``None``
-
-    :用法:
-
-    .. code-block:: python
+    参数:
+        _env_file: 配置文件名，默认从 `.env.{env_name}` 中读取配置
+        kwargs: 任意变量，将会存储到 {ref}`nonebot.drivers.Driver.config` 对象里
 
+    用法:
+        ```python
         nonebot.init(database=Database(...))
-
+        ```
     """
     global _driver
     if not _driver:
-        logger.info("NoneBot is initializing...")
+        logger.success("NoneBot is initializing...")
         env = Env()
-        logger.opt(
-            colors=True).info(f"Current <y><b>Env: {env.environment}</b></y>")
-        config = Config(**kwargs,
-                        _env_file=_env_file or f".env.{env.environment}")
+        config = Config(
+            **kwargs,
+            _common_config=env.dict(),
+            _env_file=_env_file or f".env.{env.environment}",
+        )
 
-        default_filter.level = "DEBUG" if config.debug else "INFO"
+        default_filter.level = config.log_level
+        logger.opt(colors=True).info(
+            f"Current <y><b>Env: {escape_tag(env.environment)}</b></y>"
+        )
         logger.opt(colors=True).debug(
-            f"Loaded <y><b>Config</b></y>: {escape_tag(str(config.dict()))}")
+            f"Loaded <y><b>Config</b></y>: {escape_tag(str(config.dict()))}"
+        )
 
-        DriverClass: Type[Driver] = getattr(
-            importlib.import_module(config.driver), "Driver")
+        DriverClass: Type[Driver] = _resolve_combine_expr(config.driver)
         _driver = DriverClass(env, config)
 
-        # register build-in adapters
-        _driver.register_adapter("cqhttp", CQBot)
 
-        # load nonebot test frontend if debug
-        if config.debug and nonebot_test:
-            logger.debug("Loading nonebot test frontend...")
-            nonebot_test.init()
+def run(*args: Any, **kwargs: Any) -> None:
+    """启动 NoneBot，即运行全局 {ref}`nonebot.drivers.Driver` 对象。
 
-    if scheduler:
-        _driver.on_startup(_start_scheduler)
-
-
-def run(host: Optional[str] = None,
-        port: Optional[int] = None,
-        *args,
-        **kwargs):
-    """
-    :说明:
-
-      启动 NoneBot，即运行全局 Driver 对象。
-
-    :参数:
-
-      * ``host: Optional[str]``: 主机名／IP，若不传入则使用配置文件中指定的值
-      * ``port: Optional[int]``: 端口，若不传入则使用配置文件中指定的值
-      * ``*args``: 传入 Driver.run 的位置参数
-      * ``**kwargs``: 传入 Driver.run 的命名参数
-
-    :返回:
-
-      - ``None``
-
-    :用法:
-
-    .. code-block:: python
+    参数:
+        args: 传入 {ref}`nonebot.drivers.Driver.run` 的位置参数
+        kwargs: 传入 {ref}`nonebot.drivers.Driver.run` 的命名参数
 
+    用法:
+        ```python
         nonebot.run(host="127.0.0.1", port=8080)
-
+        ```
     """
-    logger.info("Running NoneBot...")
-    get_driver().run(host, port, *args, **kwargs)
+    logger.success("Running NoneBot...")
+    get_driver().run(*args, **kwargs)
 
 
-async def _start_scheduler():
-    if scheduler and not scheduler.running:
-        scheduler.configure(_driver.config.apscheduler_config)
-        scheduler.start()
-        logger.opt(colors=True).info("<y>Scheduler Started</y>")
+from nonebot.plugin import on as on
+from nonebot.plugin import export as export
+from nonebot.plugin import require as require
+from nonebot.plugin import on_regex as on_regex
+from nonebot.plugin import on_notice as on_notice
+from nonebot.plugin import get_plugin as get_plugin
+from nonebot.plugin import on_command as on_command
+from nonebot.plugin import on_keyword as on_keyword
+from nonebot.plugin import on_message as on_message
+from nonebot.plugin import on_request as on_request
+from nonebot.plugin import load_plugin as load_plugin
+from nonebot.plugin import on_endswith as on_endswith
+from nonebot.plugin import CommandGroup as CommandGroup
+from nonebot.plugin import MatcherGroup as MatcherGroup
+from nonebot.plugin import load_plugins as load_plugins
+from nonebot.plugin import on_fullmatch as on_fullmatch
+from nonebot.plugin import on_metaevent as on_metaevent
+from nonebot.plugin import on_startswith as on_startswith
+from nonebot.plugin import load_from_json as load_from_json
+from nonebot.plugin import load_from_toml as load_from_toml
+from nonebot.plugin import load_all_plugins as load_all_plugins
+from nonebot.plugin import on_shell_command as on_shell_command
+from nonebot.plugin import get_loaded_plugins as get_loaded_plugins
+from nonebot.plugin import load_builtin_plugin as load_builtin_plugin
+from nonebot.plugin import load_builtin_plugins as load_builtin_plugins
 
-
-from nonebot.plugin import on_message, on_notice, on_request, on_metaevent
-from nonebot.plugin import on_startswith, on_endswith, on_command, on_regex, CommandGroup
-from nonebot.plugin import load_plugin, load_plugins, load_builtin_plugins, get_loaded_plugins
+__autodoc__ = {"internal": False}