Metadata-Version: 2.4
Name: nonebot-plugin-value
Version: 0.0.1.dev1
Summary: Add your description here
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: nonebot-plugin-orm>=0.8.1
Requires-Dist: nonebot2>=2.4.2
Requires-Dist: pydantic>=2.11.7
Requires-Dist: sqlalchemy>=2.0.41
Dynamic: license-file

<div align="center">
  <a href="https://github.com/JohnRichard4096/nonebot_plugin_value/">
    <img src="https://github.com/user-attachments/assets/b5162036-5b17-4cf4-b0cb-8ec842a71bc6" width="200" alt="value Logo">
  </a>
  <h1>Value</h1>
  <h3>新一代经济API</h3>

  <p>
    <a href="https://pypi.org/project/nonebot-plugin-value/">
      <img src="https://img.shields.io/pypi/v/nonebot-plugin-value?color=blue&style=flat-square" alt="PyPI Version">
    </a>
    <a href="https://www.python.org/">
      <img src="https://img.shields.io/badge/python-3.10+-blue?logo=python&style=flat-square" alt="Python Version">
    </a>
    <a href="https://nonebot.dev/">
      <img src="https://img.shields.io/badge/nonebot2-2.0.0rc4+-blue?style=flat-square" alt="NoneBot Version">
    </a>
    <a href="LICENSE">
      <img src="https://img.shields.io/github/license/JohnRichard4096/nonebot_plugin_value?style=flat-square" alt="License">
    </a>
    <a href="https://qm.qq.com/q/PFcfb4296m">
      <img src="https://img.shields.io/badge/QQ%E7%BE%A4-1002495699-blue?style=flat-square" alt="QQ Group">
    </a>
  </p>
</div>

## 插件概述

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

- 多货币支持（创建/管理货币）
- 用户账户与余额管理
- 交易记录追踪
- 钩子机制（交易前后触发）
- 异步数据库操作（基于 SQLAlchemy ORM）

### 核心特性

- 🪙 多货币系统：支持创建任意数量的货币类型
- 💰 原子化交易：保证转账等操作的事务性
- 🔁 钩子系统：支持交易前后触发自定义逻辑
- 📊 完整审计：所有交易记录包含完整上下文信息
- 🔐 安全控制：支持负余额限制、账户锁等机制


### [API Docs](docs/api.md)
