nonebot-plugin-value 0.1.0

Economy API for NoneBot2

EconomyValue

基于SQLAlchemy长期存储的新一代经济API

核心特性

nonebot_plugin_value 是一个基于 NoneBot2 的通用经济系统插件，提供以下核心功能：

• 📈 账户系统：各货币账户独立
• 🪙 多货币系统：支持创建任意数量的货币类型
• 💰 原子化交易：保证转账等操作的事务性
• 🔁 钩子系统：支持交易前后触发自定义逻辑
• 📊 完整审计：所有交易记录包含完整上下文信息
• 🔐 安全控制：支持负余额限制
• 📝 批量操作：支持批量修改用户的货币数据
• 🔍 时间范围审计日志：从时间范围获取交易记录
• 🚀 导出数据：支持从Json文件导入，导出到Json文件
• 🛠 CLI指令：在nb-cli可执行的维护操作指令

快速开始

安装

• 使用 uv 安装:

  uv add nonebot-plugin-value
  

• 使用 pip 安装:

  pip install nonebot-plugin-value
  

加载插件

打开pyproject.toml

[tool.nonebot]
plugins = ["nonebot_plugin_value"]

添加依赖后，请重新启动 nonebot2

API Docs

更新迁移

1. 升级 nonebot_plugin_value 到最新版本

2. 生成并运行迁移脚本(（如果 Bot 根目录下没有迁移脚本目录，请使用nb orm init来初始化。）在 bot 根目录使用nb orm revison再nb orm upgrade进行迁移)