Metadata-Version: 2.4
Name: nonebot-plugin-aawarframe
Version: 0.6.0
Summary: aa 的 Warframe 助手
Author-email: nekox41 <aameow@outlook.com>
License-Expression: MIT
Requires-Python: ==3.12.*
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: nonebot2>=2.5.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: nonebot-adapter-onebot>=2.4.6
Requires-Dist: nonebot-plugin-htmlrender>=0.8.0
Requires-Dist: playwright>=1.61.0
Requires-Dist: rapidfuzz>=3.14.5
Requires-Dist: datetime>=6.0
Dynamic: license-file

<div align="center">
  <a href="https://v2.nonebot.dev/store"><img src="https://github.com/nekox41/nonebot-plugin-aawarframe/blob/master/imgs/logo.png" width="180" height="180" alt="aawarframeLogo"></a>
  <br>
  <p><img src="https://github.com/nekox41/nonebot-plugin-aawarframe/blob/master/imgs/logo.svg" width="240" alt="aawarframeLogo"></p>
</div>

<div align="center">

# nonebot-plugin-aawarframe

_✨ Aa 的 Warframe 助手，用于查询游戏状态。 ✨_


<a href="./LICENSE">
    <img src="https://img.shields.io/github/license/nekox41/nonebot-plugin-aawarframe.svg" alt="license">
</a>
<a href="https://pypi.python.org/pypi/nonebot-plugin-aawarframe">
    <img src="https://img.shields.io/pypi/v/nonebot-plugin-aawarframe.svg" alt="pypi">
</a>
<img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="python">

</div>

## 介绍

这是一个用于游戏 Warframe 的插件，提供游戏内的信息查询功能。

功能列表：
- [x] 查询夜灵平原时间
- [x] 查询本周科研任务
  - [x] 时光科研
  - [x] 深层科研
- [x] 查询仲裁任务
  - [x] 当前仲裁任务与下一次仲裁
  - [x] 今日所有仲裁
  - [x] 未来 5 个 S 级仲裁时间
- [x] Warframe Market 商品信息查询
  - [x] 物品价格查询、满级物品价格查询
  - [ ] 紫卡价格查询
## 安装
### 安装插件
<details open>
<summary>使用 nb-cli 安装</summary>
在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装

    nb plugin install nonebot-plugin-aawarframe

</details>

<details>
<summary>使用包管理器安装</summary>
在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令

<details>
<summary>pip</summary>

    pip install nonebot-plugin-aawarframe
</details>
<details>
<summary>pdm</summary>

    pdm add nonebot-plugin-aawarframe
</details>
<details>
<summary>poetry</summary>

    poetry add nonebot-plugin-aawarframe
</details>
<details>
<summary>conda</summary>

    conda install nonebot-plugin-aawarframe
</details>

打开 nonebot2 项目根目录下的 `pyproject.toml` 文件, 在 `[tool.nonebot]` 部分追加写入

    plugins = ["nonebot_plugin_template"]

</details>

### 安装 Playwright
建议手动安装`Playwright`，并指定目录，随后在下面的配置中指定相同的目录，避免`nonebot-plugin-htmlrender`插件报错。  

Linux：
```bash
PLAYWRIGHT_BROWSERS_PATH=YOUR/PATH python -m playwright install --with-deps chromium
```

Windows：
```Powershell
$Env:PLAYWRIGHT_BROWSERS_PATH="YOUR/PATH"
playwright install --with-deps chromium
```
## 配置
### nonebot-plugin-htmlrender

> [!IMPORTANT]
> 
> 项目的图片渲染依赖 `nonebot-plugin-htmlrender >= 0.8`
> 
> 此版本的`htmlrender`需要配置渲染图片所使用的后端，项目依赖`playwright`后端。`htmlrender`会在启动时自动检测并安装`playwright`，但探测路径与默认安装路径不一致，若不手动配置会出现错误。
> 
> 下面是使用本地浏览器的配置说明，如果你希望使用`htmlrender`推荐的`Docker`部署，请查看：[远程 Playwright 部署¶
](https://kexue-z.github.io/nonebot-plugin-htmlrender/0.8.1/configuration/remote-playwright/)

|配置项| 值        | 是否必须 |说明|
|---|----------|-----|---|
|RENDER__PROVIDER| playwright |是|指定`playwright`后端|
|RENDER__PROVIDER_CONFIG__STORAGE_PATH|先前的安装目录|是|指定浏览器安装与探测路径|

## 使用
### 指令表
|  指令  | 权限  | 需要@ | 范围 |        说明        |
|:----:|:---:|:---:|:--:|:----------------:|
| 夜灵平原 | 所有人 |  否  | 群聊 |     返回夜灵平原时间     |
| 时光科研 | 所有人 |  否  | 群聊 |     返回本周时光科研     |
| 深层科研 | 所有人 |  否  | 群聊 |     返回本周深层科研     |
|  仲裁  | 所有人 |  否  | 群聊 |   返回当前仲裁和下一次仲裁   |
| 今日仲裁 | 所有人 |  否  | 群聊 |     返回今日所有仲裁     |
| 高效仲裁 | 所有人 |  否  | 群聊 | 返回 5 个接下来的 S 级仲裁 |
### 效果图
<p><img src="https://github.com/nekox41/nonebot-plugin-aawarframe/blob/master/imgs/example1.png" alt="效果图1"></p>
<p><img src="https://github.com/nekox41/nonebot-plugin-aawarframe/blob/master/imgs/example2.png" alt="效果图2"></p>
