📖 介绍
NoneBot 复盘打卡插件，用于帮助交易者进行每日复盘打卡。支持交易日判断、时间窗口控制、数据统计等功能。
💿 安装
使用 nb-cli 安装
在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装nb plugin install nonebot-plugin-fupan --upgrade
使用 pypi 源安装
nb plugin install nonebot-plugin-fupan --upgrade -i "https://pypi.org/simple"
使用清华源安装
nb plugin install nonebot-plugin-fupan --upgrade -i "https://pypi.tuna.tsinghua.edu.cn/simple"
使用包管理器安装
在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令uv
uv add nonebot-plugin-fupan
安装仓库 master 分支
uv add git+https://github.com/zanderzhng/nonebot-plugin-fupan@master
pdm
pdm add nonebot-plugin-fupan
安装仓库 master 分支
pdm add git+https://github.com/zanderzhng/nonebot-plugin-fupan@master
poetry
poetry add nonebot-plugin-fupan
安装仓库 master 分支
poetry add git+https://github.com/zanderzhng/nonebot-plugin-fupan@master
打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分追加写入
plugins = ["nonebot_plugin_fupan"]
使用 nbr 安装(使用 uv 管理依赖可用)
nbr 是一个基于 uv 的 nb-cli，可以方便地管理 nonebot2
nbr plugin install nonebot-plugin-fupan
使用 pypi 源安装
nbr plugin install nonebot-plugin-fupan -i "https://pypi.org/simple"
使用清华源安装
nbr plugin install nonebot-plugin-fupan -i "https://pypi.tuna.tsinghua.edu.cn/simple"
⚙️ 配置
在 nonebot2 项目的.env文件中添加下表中的配置项
| 配置项 | 必填 | 默认值 | 说明 |
|---|---|---|---|
| fupan_checkin_start_time | 否 | 15:00 | 打卡开始时间（交易日当天） |
| fupan_checkin_end_time | 否 | 09:00 | 打卡结束时间（下一交易日） |
| fupan_checkin_group_time_windows | 否 | {} | 群组特定时间窗口配置 |
| fupan_checkin_user_time_windows | 否 | {} | 用户特定时间窗口配置 |
高级配置示例
群组特定时间窗口配置
fupan_checkin_group_time_windows = {"123456": {"start_time": "16:00", "end_time": "08:00"}}
用户特定时间窗口配置
fupan_checkin_user_time_windows = {"user123": {"start_time": "17:00", "end_time": "07:00"}}
盘后时间窗口说明
盘后时间窗口定义为：T日收盘后到T+1交易日开盘前的时间段。默认配置为15:00至次日09:00。
🎉 使用
指令表
| 指令 | 权限 | 范围 | 说明 |
|---|---|---|---|
| 复盘/打卡/签到 | 群员 | 群聊/私聊 | 进行复盘打卡 |
| 复盘统计 | 群员 | 群聊/私聊 | 查看个人打卡统计 |
| 复盘排行 | 群员 | 群聊/私聊 | 查看打卡排行榜 |
| 复盘撤销/撤销复盘 | 群员 | 群聊/私聊 | 撤销最后一次打卡 |
| 复盘帮助 | 群员 | 群聊/私聊 | 查看帮助信息 |
| 复盘重置 | 超级用户 | 群聊/私聊 | 重置数据（私聊/群组） |
使用说明
- 用户可以在交易日的盘后时间窗口内进行打卡（默认15:00至下一个交易日的09:00）
- 非交易日（周末、节假日）会自动调整打卡时间窗口
- 每个用户每次盘后只能打卡一次
- 支持查看个人统计和群内排行榜（基于连续打卡次数）
- 支持按群组或用户设置特定的时间窗口
- 用户可以使用"复盘撤销"或"撤销复盘"命令撤销最后一次打卡记录
- 群聊和私聊的数据完全分离，互不影响
- 超级用户可以使用"复盘重置"命令重置数据：
/复盘重置 私聊- 重置所有私聊用户数据/复盘重置 当前群组- 重置当前群组数据/复盘重置 群组<群号>- 重置指定群组数据
- 用户可以使用"复盘帮助"命令查看所有可用指令
- 详细的打卡日志记录功能，包括时间戳、星期分布、交易日信息等统计信息
- 连续打卡计数功能，追踪用户的连续交易日打卡记录
平台限制说明
由于官方QQ机器人的平台限制，用户昵称信息无法获取。昵称显示功能在其他Bot适配器上效果更佳。
🎨 效果图
如果有效果图的话
1 maintainer
Metadata
1 maintainer
Release files for nonebot-plugin-fupan 0.1.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| nonebot_plugin_fupan-0.1.8.tar.gz | 11.2 kB | With provenance | Details for nonebot_plugin_fupan-0.1.8.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| nonebot_plugin_fupan-0.1.8-py3-none-any.whl | Python 3 | none | any | Details for nonebot_plugin_fupan-0.1.8-py3-none-any.whl |
Total release size: 22.4 kB
Release files / nonebot_plugin_fupan-0.1.8.tar.gz
| Download URL | nonebot_plugin_fupan-0.1.8.tar.gz |
|---|---|
| Size | 11.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9c6d80e27d7df9ae0245c53ffa068d4107549455cbe453decc57c5c5be121785
|
|
BLAKE2b-256 checksum How to use checksums |
774f6bb8913ac75065c94031158c7681effd5c807c0ea2be265590e3b7a19785
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2025.
Transparency logRelease files / nonebot_plugin_fupan-0.1.8-py3-none-any.whl
| Download URL | nonebot_plugin_fupan-0.1.8-py3-none-any.whl |
|---|---|
| Size | 11.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
94bdfa8a708f9be4246d9629085204afcd169828e88592be0a82197f7a31a6b2
|
|
BLAKE2b-256 checksum How to use checksums |
20076a3633af16d55cbb7dd3e2d6e0ab0225d79ff33c9ecc46121fc199a1ba93
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2025.
Transparency logSecurity for nonebot-plugin-fupan 0.1.8
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for nonebot_plugin_fupan-0.1.8.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2025.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
