Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 19 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
<img src="https://github.com/user-attachments/assets/b5162036-5b17-4cf4-b0cb-8ec842a71bc6" width="200" alt="value Logo">
</a>
<h1>EconomyValue</h1>
<h3>基于SQLAlchemy长期存储的新一代经济API</h3>
<h3>基于SQLAlchemy2的强大经济系统插件!</h3>

<p>
<a href="https://pypi.org/project/nonebot-plugin-value/">
Expand All @@ -26,23 +26,29 @@

## 核心特性

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

- 📈 账户系统: 各货币账户独立
- 🪙 多货币系统: 支持创建任意数量的货币类型
- 💰 原子化交易: 保证转账等操作的事务性
- 🔁 钩子系统: 支持交易前后触发自定义逻辑
- 📊 完整审计: 所有交易记录包含完整上下文信息
- 🔐 安全控制: 支持负余额限制
- 📝 批量操作: 支持批量修改用户的货币数据
- 🔍 时间范围审计日志: 从时间范围获取交易记录
- 🚀 导出数据: 支持从Json文件导入/导出到Json文件
`nonebot_plugin_value` 是一个基于 NoneBot2 的通用经济系统插件,提供以下核心功能:

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

### 快速开始

#### 安装

- 使用 nb-cli 安装:

```bash
nb plugin install nonebot-plugin-value
```

- 使用 uv 安装:

```bash
Expand All @@ -57,7 +63,7 @@

#### 加载插件

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

```toml
[tool.nonebot]
Expand Down
2 changes: 1 addition & 1 deletion nonebot_plugin_value/api/api_currency.py
Original file line number Diff line number Diff line change
Expand Up @@ -102,4 +102,4 @@ async def get_or_create_currency(currency_data: CurrencyData) -> CurrencyData:
"""
async with get_session() as session:
currency, _ = await _get_or_create_currency(currency_data, session)
return CurrencyData.model_validate(currency)
return CurrencyData.model_validate(currency, from_attributes=True)
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "nonebot-plugin-value"
version = "0.1.3"
version = "0.1.3.post1"
description = "Economy API for NoneBot2"
readme = "README.md"
requires-python = ">=3.10, <4.0.0"
Expand Down
Loading