NoneBot Plugin User

✨ NoneBot 用户插件 ✨

python

简介

使用方式

加载插件后发送 /user 或 /bind。

查看用户信息

通过 user 命令可查看用户信息:

平台名：qq
平台 ID：10000
用户名：uy/sun
创建日期：2023-11-02 04:52:42

绑定用户

通过 bind 命令可将不同用户的数据绑定:

命令 bind 可用于在多个平台间绑定用户数据。绑定过程中，原始平台的用户数据将完全保留，而目标平台的用户数据将被原始平台的数据所覆盖。
请确认当前平台是你的目标平台，并在 5 分钟内使用你的账号在原始平台内向机器人发送以下文本：
/bind nonebot/123456
绑定完成后，你可以随时使用「bind -r」来解除绑定状态。

插件适配

先在插件代码最前面声明依赖

from nonebot import require
require("nonebot_plugin_user")

获取用户信息

from nonebot_plugin_user import User

@matcher.handle()
async def _(user: User):
    await matcher.finish(user.id)

获取用户会话信息

from nonebot_plugin_user import UserSession


@matcher.handle()
async def _(session: UserSession):
  await matcher.finish(session.platform_user.id)

配置项

配置方式：直接在 NoneBot 全局配置文件中添加以下配置项即可。

user_token_prefix

类型: str
默认: nonebot/
说明: 生成令牌的前缀

鸣谢

Koishi: 本项目直接参考
nonebot-plugin-session: 获取用户信息
nonebot-plugin-uninfo: 通用的会话信息插件

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nonebot_plugin_user-0.6.1.tar.gz (11.5 kB view details)

Uploaded Jul 24, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

nonebot_plugin_user-0.6.1-py3-none-any.whl (15.8 kB view details)

Uploaded Jul 24, 2026 Python 3

File details

Details for the file nonebot_plugin_user-0.6.1.tar.gz.

File metadata

Download URL: nonebot_plugin_user-0.6.1.tar.gz
Upload date: Jul 24, 2026
Size: 11.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for nonebot_plugin_user-0.6.1.tar.gz
Algorithm	Hash digest
SHA256	`e50d78b6f1a33c9fa9a47c5cdad1b3cee1bc04565de8d3058d3fde794ad376e0`
MD5	`9bd7c2f2a4b9b8e2b72dfa9a7f501280`
BLAKE2b-256	`6376bc28a7e1a4f14dac66f2d5a4da6923b0c4f8f46e79b9b1e21029a56971db`

See more details on using hashes here.

Provenance

The following attestation bundles were made for nonebot_plugin_user-0.6.1.tar.gz:

Publisher: release.yml on he0119/nonebot-plugin-user

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: nonebot_plugin_user-0.6.1.tar.gz
- Subject digest: e50d78b6f1a33c9fa9a47c5cdad1b3cee1bc04565de8d3058d3fde794ad376e0
- Sigstore transparency entry: 2231124323
- Sigstore integration time: Jul 24, 2026
Source repository:
- Permalink: he0119/nonebot-plugin-user@717ff9fbc4f9239436d9b50fe39cb2ec2802b2bd
- Branch / Tag: refs/tags/v0.6.1
- Owner: https://github.com/he0119
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@717ff9fbc4f9239436d9b50fe39cb2ec2802b2bd
- Trigger Event: push