EconomyValue

基于SQLAlchemy2的强大经济系统插件！

核心特性

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

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

快速开始

安装

• 使用 nb-cli 安装：

  nb plugin install nonebot-plugin-value

• 使用 uv 安装:

  uv add nonebot-plugin-value

• 使用 pip 安装:

  pip install nonebot-plugin-value

加载插件

使用pip/uv安装需要打开pyproject.toml

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

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

API Docs

配置项

VALUE_PRE_BUILD_CACHE = true # 是否在启动时预构建缓存

更新迁移

1. 升级 nonebot_plugin_value 到最新版本

2. 在机器人根目录使用nb orm upgrade命令升级数据库