nonebot-plugin-value 0.1.1

Economy API for NoneBot2

EconomyValue

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

核心特性

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

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

快速开始

安装

• 使用 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. 在机器人根目录使用nb orm upgrade命令升级数据库