nonebot-plugin-anime 1.0.0__tar.gz

nonebot_plugin_anime-1.0.0/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: nonebot-plugin-anime
+Version: 1.0.0
+Summary: Bangumi 番剧查询机器人插件
+Author: ShioMI39
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ShioMI39/nonebot-plugin-anime
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: nonebot2>=2.0.0
+Requires-Dist: nonebot-adapter-onebot>=2.0.0
+Requires-Dist: nonebot-plugin-localstore>=0.2
+Requires-Dist: aiohttp>=3.8
+Requires-Dist: Pillow>=10.0
+Requires-Dist: opencc>=1.3.1
+Requires-Dist: pydantic>=2.0
+
+# 番剧小助手
+
+Bangumi 番剧查询 NoneBot 插件。支持多条件组合搜索、本地用户评分管理、季度查看、随机推荐等功能，数据基于 [Bangumi](https://bgm.tv/dev)。
+
+## 效果图
+<details>
+  <summary>点击展开</summary>
+
+![番剧搜索效果](simple.jpg)
+
+</details>
+
+## 安装
+
+使用 nb-cli 安装
+```bash
+nb plugin install nonebot-plugin-anime
+```
+
+或使用 pip：
+
+```bash
+pip install nonebot-plugin-anime
+```
+
+## 配置
+
+在 NoneBot 项目的 `.env` 文件中添加：
+
+```env
+# 必填：资源目录，从网盘下载的 bangumi_resource 解压后的路径
+ANIME__RESOURCE_DIR=/path/to/bangumi_resource
+
+# 可选：HTTP 代理（国内网络访问 Bangumi API 不稳定时建议配置，留空则不开启）
+ANIME__HTTP_PROXY=
+
+# 可选：是否允许私聊使用（默认 true）
+ANIME__PRIVATE_ALLOW=True
+
+# 可选：Bangumi API 令牌（提升请求频率限制）
+ANIME__BGM_API_TOKEN=xxx
+```
+
+申请Bangumi的API可以点击此链接 [Bangumi API](https://next.bgm.tv/demo/access-token)
+
+ 需[网盘](https://pan.baidu.com/s/1sYJjgkrrT9ZBJp11LAZrNg?pwd=wt3p)下载 `bangumi_resource` 资源包并解压
+
+资源包包含预置番剧数据 (`bgm.json`)、字体文件 (`fonts/`) 。
+
+## 适用
+
+个人或和朋友们的小群，本质用来方便查看番剧快照，大部分操作都是基于本地
+
+## 命令列表
+
+| 命令                   | 说明           |
+|----------------------|--------------|
+| `番剧搜索 <关键词> [条件]`    | 支持条件组合搜索番剧   |
+| `cv搜索 <CV名>`         | 按声优搜索配音角色    |
+| `角色搜索 <角色名>`         | 按角色名搜索角色     |
+| `番剧获取 <Bangumi ID>`  | 通过 ID 获取番剧数据 |
+| `番剧评分 <番剧名> <特征名><分数>` | 添加或查看评分      |
+| `评分搜索 <特征名> <分数>`    | 搜索用户评分       |
+| `评分展示 <番剧名>`         | 展示番剧用户所有评分   |
+| `评分图 <特征名>`          | 生成评分图        |
+| `角色评级 <角色名> <特征名><1-5>` | 对角色评级        |
+| `角色评级查看 <特征名>`        | 查看用户角色评级     |
+| `角色评级图 <特征名>`         | 生成角色评级图      |
+| `随机番剧 [条件]`          | 随机推荐番剧       |
+| `番剧查看 <年月>`          | 查看季度番剧       |
+| `标签查看 <番剧名>`         | 查看番剧标签       |
+| `标签添加 <番剧名> <标签>`    | 添加标签         |
+| `标签删除 <番剧名> <标签>`    | 删除标签         |
+
+| 命令 | 说明 |
+|------|------|
+| `番剧群组添加 <群号>` | 添加群组白名单 |
+| `番剧群组移除 <群号>` | 移除群组白名单 |
+| `番剧群组列表` | 查看白名单 |
+| `清理番剧缓存` | 清理图片缓存 |
+
+
+> 群组列表默认为空，想在群聊使用需要先使用`番剧群组添加 <群号>`
+
+
+## 番剧搜索 筛选条件
+
+`番剧搜索` 支持在番剧名后追加多个筛选条件：
+
+| 关键字 | 示例                       | 说明 |
+|--------|--------------------------|------|
+| `标签` | `标签 百合+日常`               | 多标签用 `+` 连接 |
+| `分数` | `分数 6-8.5` / `≥8` / `≤6` | 支持范围和比较 |
+| `cv` | `cv 种田梨沙`                |  |
+| `导演` | `导演 若林信`                 | |
+| `制作` | `制作 CloverWorks`         | |
+| `staff` | `staff 脚本 野岛伸司`          | 可选限定角色 |
+| `季度` | `季度 2021年1月-2022年1月`     | 时间范围筛选 |
+| `类型` | `tv` / `movie`           | |
+| `关键词` | `奇蛋物语`                   | 番剧名 |

nonebot_plugin_anime-1.0.0/README.md

@@ -0,0 +1,100 @@
+# 番剧小助手
+
+Bangumi 番剧查询 NoneBot 插件。支持多条件组合搜索、本地用户评分管理、季度查看、随机推荐等功能，数据基于 [Bangumi](https://bgm.tv/dev)。
+
+## 效果图
+<details>
+  <summary>点击展开</summary>
+
+![番剧搜索效果](simple.jpg)
+
+</details>
+
+## 安装
+
+使用 nb-cli 安装
+```bash
+nb plugin install nonebot-plugin-anime
+```
+
+或使用 pip：
+
+```bash
+pip install nonebot-plugin-anime
+```
+
+## 配置
+
+在 NoneBot 项目的 `.env` 文件中添加：
+
+```env
+# 必填：资源目录，从网盘下载的 bangumi_resource 解压后的路径
+ANIME__RESOURCE_DIR=/path/to/bangumi_resource
+
+# 可选：HTTP 代理（国内网络访问 Bangumi API 不稳定时建议配置，留空则不开启）
+ANIME__HTTP_PROXY=
+
+# 可选：是否允许私聊使用（默认 true）
+ANIME__PRIVATE_ALLOW=True
+
+# 可选：Bangumi API 令牌（提升请求频率限制）
+ANIME__BGM_API_TOKEN=xxx
+```
+
+申请Bangumi的API可以点击此链接 [Bangumi API](https://next.bgm.tv/demo/access-token)
+
+ 需[网盘](https://pan.baidu.com/s/1sYJjgkrrT9ZBJp11LAZrNg?pwd=wt3p)下载 `bangumi_resource` 资源包并解压
+
+资源包包含预置番剧数据 (`bgm.json`)、字体文件 (`fonts/`) 。
+
+## 适用
+
+个人或和朋友们的小群，本质用来方便查看番剧快照，大部分操作都是基于本地
+
+## 命令列表
+
+| 命令                   | 说明           |
+|----------------------|--------------|
+| `番剧搜索 <关键词> [条件]`    | 支持条件组合搜索番剧   |
+| `cv搜索 <CV名>`         | 按声优搜索配音角色    |
+| `角色搜索 <角色名>`         | 按角色名搜索角色     |
+| `番剧获取 <Bangumi ID>`  | 通过 ID 获取番剧数据 |
+| `番剧评分 <番剧名> <特征名><分数>` | 添加或查看评分      |
+| `评分搜索 <特征名> <分数>`    | 搜索用户评分       |
+| `评分展示 <番剧名>`         | 展示番剧用户所有评分   |
+| `评分图 <特征名>`          | 生成评分图        |
+| `角色评级 <角色名> <特征名><1-5>` | 对角色评级        |
+| `角色评级查看 <特征名>`        | 查看用户角色评级     |
+| `角色评级图 <特征名>`         | 生成角色评级图      |
+| `随机番剧 [条件]`          | 随机推荐番剧       |
+| `番剧查看 <年月>`          | 查看季度番剧       |
+| `标签查看 <番剧名>`         | 查看番剧标签       |
+| `标签添加 <番剧名> <标签>`    | 添加标签         |
+| `标签删除 <番剧名> <标签>`    | 删除标签         |
+
+| 命令 | 说明 |
+|------|------|
+| `番剧群组添加 <群号>` | 添加群组白名单 |
+| `番剧群组移除 <群号>` | 移除群组白名单 |
+| `番剧群组列表` | 查看白名单 |
+| `清理番剧缓存` | 清理图片缓存 |
+
+
+> 群组列表默认为空，想在群聊使用需要先使用`番剧群组添加 <群号>`
+
+
+## 番剧搜索 筛选条件
+
+`番剧搜索` 支持在番剧名后追加多个筛选条件：
+
+| 关键字 | 示例                       | 说明 |
+|--------|--------------------------|------|
+| `标签` | `标签 百合+日常`               | 多标签用 `+` 连接 |
+| `分数` | `分数 6-8.5` / `≥8` / `≤6` | 支持范围和比较 |
+| `cv` | `cv 种田梨沙`                |  |
+| `导演` | `导演 若林信`                 | |
+| `制作` | `制作 CloverWorks`         | |
+| `staff` | `staff 脚本 野岛伸司`          | 可选限定角色 |
+| `季度` | `季度 2021年1月-2022年1月`     | 时间范围筛选 |
+| `类型` | `tv` / `movie`           | |
+| `关键词` | `奇蛋物语`                   | 番剧名 |

nonebot_plugin_anime-1.0.0/nonebot_plugin_anime/__init__.py

@@ -0,0 +1,17 @@
+from .core import *
+from .handlers import *
+from .config import Config, ensure_dirs
+
+from nonebot.plugin import PluginMetadata
+
+__plugin_meta__ = PluginMetadata(
+    name="nonebot-plugin-anime",
+    description="Bangumi 番剧查询等查看番剧角色详情",
+    usage="使用anime help查看详情",
+    type="application",
+    config=Config,
+    supported_adapters={"~onebot.v11"},
+    homepage="https://github.com/ShioMI39/nonebot-plugin-anime"
+)
+
+ensure_dirs()

nonebot_plugin_anime-1.0.0/nonebot_plugin_anime/config.py

@@ -0,0 +1,88 @@
+from pathlib import Path
+
+from nonebot import require
+require("nonebot_plugin_localstore")
+import nonebot_plugin_localstore as store
+
+from nonebot.plugin import get_plugin_config
+from pydantic import BaseModel
+
+
+# Bangumi API 固定标识（请勿修改）
+BANGUMI_API_UA = "ShioMI39/nonebot-plugin-anime (https://github.com/ShioMI39/nonebot-plugin-anime)"
+
+class AnimeConfig(BaseModel):
+    """番剧插件配置"""
+    http_proxy: str = ""
+    bgm_api_token: str = ""
+    resource_dir: str = ""
+    private_allow: bool = True
+
+
+class Config(BaseModel):
+    anime: AnimeConfig = AnimeConfig()
+
+
+_cfg = get_plugin_config(Config).anime
+
+HTTP_PROXY = _cfg.http_proxy
+BANGUMI_API_TOKEN = _cfg.bgm_api_token
+PRIVATE_ALLOW = _cfg.private_allow
+
+# ====== 路径配置 ======
+_data_dir = store.get_plugin_data_dir()
+_cache_dir = store.get_plugin_cache_dir()
+
+if not _cfg.resource_dir:
+    raise ValueError(
+        "未配置 ANIME__RESOURCE_DIR，"
+        "请先下载 bangumi_resource 资源包并解压，详见 README"
+    )
+
+RESOURCE_DIR: Path = Path(_cfg.resource_dir)
+CACHE_DIR = _cache_dir
+FONTS_DIR = RESOURCE_DIR / "fonts"
+BGM_JSON = RESOURCE_DIR / "bgm.json"
+
+SCORE_JSON = store.get_plugin_data_file("score.json")
+CHARACTER_SCORE_JSON = store.get_plugin_data_file("character_score.json")
+GROUP_PERMISSION_JSON = store.get_plugin_data_file("group_permission.json")
+
+# ====== 固定常量 ======
+STAFF_ROLE_MAPPING = {
+    "导演": "director", "脚本": "script", "分镜": "storyboard",
+    "演出": "episode_director", "音乐": "music",
+    "人物原案": "character_design", "系列构成": "series_composition",
+    "director": "director", "监督": "director", "script": "script",
+    "storyboard": "storyboard", "episode_director": "episode_director",
+    "music": "music", "character_design": "character_design",
+    "series_composition": "series_composition",
+}
+
+FILTER_KEYWORDS_LOWER = {
+    '标签', 'tag', 'tags',
+    '分数', '评分', 'score',
+    'cv', '声优', '配音',
+    '导演', 'director','监督',
+    '制作', '制作公司', '动画制作',
+    'staff', '制作人员',
+    '季度', '时间',
+    '类型',
+    '关键词', '标题', 'keyword'
+}
+
+MIN_YEAR = 1900
+MONTH_NAMES = {1: "一月", 4: "四月", 7: "七月", 10: "十月"}
+
+SUBJECT_TYPE_LABEL = {1: "书籍", 2: "动画", 3: "音乐", 4: "游戏", 6: "三次元"}
+
+QUARTER_MONTHS = {
+    1: ("01", "03"), 4: ("04", "06"),
+    7: ("07", "09"), 10: ("10", "12"),
+}
+
+
+def ensure_dirs() -> None:
+    RESOURCE_DIR.mkdir(parents=True, exist_ok=True)
+    _cache_dir.mkdir(parents=True, exist_ok=True)
+    _data_dir.mkdir(parents=True, exist_ok=True)

nonebot_plugin_anime-1.0.0/nonebot_plugin_anime/core/__init__.py

@@ -0,0 +1,42 @@
+from .anime_downloader import ImageManager
+from .anime_data import BGMDataManager
+from .anime_tag import TagManager
+from .anime_score import UserScoreManager, CharacterScoreManager
+from .anime_permissons import group_permission_manager
+from .anime_image import CharacterScoreImageGenerator, AnimeScoreImageGenerator
+from .anime_api import BangumiAPIClient
+
+# 1. 图片管理器
+image_manager = ImageManager()
+
+# 2. BGM 数据管理器
+bgm_manager = BGMDataManager(image_manager)
+
+# 3. 标签管理器
+tag_manager = TagManager(bgm_manager)
+
+# 4. 用户评分管理器
+user_score_manager = UserScoreManager()
+
+# 5. 角色评级管理器
+character_score_manager = CharacterScoreManager(bgm_manager)
+
+# 6. Bangumi API
+bgm_api = BangumiAPIClient()
+
+# 7. 图片生成器
+character_image_generator = CharacterScoreImageGenerator(bgm_manager, character_score_manager)
+anime_score_image_generator = AnimeScoreImageGenerator(bgm_manager, user_score_manager)
+
+
+__all__ = [
+    "image_manager",
+    "bgm_manager",
+    "tag_manager",
+    "user_score_manager",
+    "character_score_manager",
+    "bgm_api",
+    "group_permission_manager",
+    "character_image_generator",
+    "anime_score_image_generator",
+]