semvec/pypi-packages huggingface dataset:
nonebot-plugin-moviewalker 0.1.4
一个基于 NoneBot2 的moviewalker电影资讯订阅插件
License: MIT
Requires Python: <4.0,>=3.9
Keywords: nonebot2, plugin, movie, moviewalker

# nonebot-plugin-moviewalker

_✨ MovieWalker 日本电影资讯订阅插件 ✨_

<div align="center">

[![license](https://img.shields.io/github/license/XueKirby/nonebot-plugin-moviewalker)](LICENSE.txt)
[![pypi](https://img.shields.io/pypi/v/nonebot-plugin-moviewalker)](https://pypi.org/project/nonebot-plugin-moviewalker)
![python](https://img.shields.io/badge/python-3.9+-blue.svg)

</div>

## 📖 介绍

一个基于 NoneBot2 的 MovieWalker 电影资讯订阅插件，可以订阅日本电影的上映信息，自动获取并推送电影的上映馆数变化。

## 💿 安装

### 使用 nb-cli 安装（推荐）

在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装

```bash
nb plugin install nonebot_plugin_moviewalker
```

### 使用包管理器安装

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

<details>
<summary>pip</summary>

```bash
pip install nonebot-plugin-moviewalker
```

</details>
<details>
<summary>pdm</summary>

```bash
pdm add nonebot-plugin-moviewalker
```

</details>
<details>
<summary>poetry</summary>

```bash
poetry add nonebot-plugin-moviewalker
```

</details>
<details>
<summary>conda</summary>

```bash
conda install nonebot-plugin-moviewalker
```

</details>

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

```toml
plugins = ["nonebot_plugin_moviewalker"]
```

## 🎉 使用

### 指令表

| 指令                        | 权限 | 需要@ | 范围    | 说明                     |
|---------------------------|----|-----|-------|------------------------|
| /添加电影 网址 首映日期 中文名称        | 群员 | 否   | 群聊/私聊 | 添加一部电影到订阅列表            |
| /删除电影 mv编号                | 群员 | 否   | 群聊/私聊 | 从订阅列表中删除一部电影           |
| /电影列表                     | 群员 | 否   | 群聊/私聊 | 查看当前订阅的电影列表            |
| /上映馆数日报                   | 群员 | 否   | 群聊/私聊 | 手动获取当日的电影上映馆数日报        |
| /编辑元数据 mv编号 [首映日期] [中文名称] | 群员 | 否   | 群聊/私聊 | 编辑电影的首映日期或中文名称（至少提供一个） |

### 使用示例

```
/添加电影 https://moviewalker.jp/mv87996/ 2025年1月18日首映 Retake

/删除电影 mv87996

/电影列表

/上映馆数日报

/编辑元数据 mv87996 2025年1月18日首映 重拍
```

### 日报示例

```
2024年01月21日日本电影上映馆数日报

【正在上映】
1、【1月17日首映/上映第1周】机动战士高达 SEED FREEDOM，373馆（新）
2、【1月17日首映/上映第1周】剧场版世界计划 破碎的世界，148馆（新）
3、【12月20日首映/上映第5周】剧场版 忍者乱太郎，327馆（-10馆）

【未上映/已下映】
1、【2月1日首映】你的眼睛在诉说（未上映）
2、【12月1日首映】某某电影（已下映）
```

## 📝 更新日志

### 0.1.0

- 首次发布
- 支持添加、删除和查看电影订阅
- 支持手动和自动获取上映馆数日报
- 支持显示电影上映馆数变化

### 0.1.1

- 修复了一些问题

### 0.1.2

- 增加特效厅查询功能

### 0.1.3

- 优化语言表述
- 优化馆数对比逻辑

## 问题反馈

如果您在使用过程中遇到任何问题，欢迎在 GitHub Issues 中反馈。

## 开源协议

本项目使用 MIT 协议开源，详情请参阅 [LICENSE](LICENSE.txt) 文件。