nonebot-plugin-doroending 0.2.0

获取今日的doro结局

NoneBot-Plugin-DoroEnding

一个有趣的 NoneBot2 插件，随机获取今日的 doro 结局，并支持bot管理员管理结局库

✨ 功能特性

• 🎲 随机获取：每日随机获取一个 doro 结局
• 👑 权限管理：只有超级用户可以管理结局库
• 📝 便捷管理：添加、删除、查看所有结局

📦 安装方法

使用 nb 安装（推荐）

nb plugin install nonebot-plugin-doroending

使用 pip 安装

从 PyPI 安装

pip install nonebot-plugin-doroending

从 git仓库 安装

pip install git+https://github.com/SeeWhyRan/nonebot_plugin_doroending.git
# 备用地址 pip install git+https://gitee.com/seewhy_ran/nonebot_plugin_doroending.git

手动安装

1. 克隆仓库：

git clone https://github.com/yourname/nonebot-plugin-doroending.git
# 备用地址 git clone https://gitee.com/seewhy_ran/doroending_pic_assets.git
cd nonebot-plugin-doroending

2. 将nonebot-plugin-doroending/文件夹放在你的nb项目的src文件夹下

3. 安装依赖：

pip install -e .

⚙️ 配置

在 NoneBot2 项目的 .env 文件中添加以下配置：

# 设置Nonebot全局超级用户（你的QQ号）
SUPERUSERS=["123456789"]

📖 使用方法

基础命令

命令	功能	权限	示例
今日doro结局	随机获取一个 doro 结局	所有人	今日doro结局
doro结局帮助	查看 doro 相关指令列表	所有人	doro结局帮助 或 /doro help
列出doro结局	列出所有 doro 结局（合并转发）	超级用户	列出doro结局
添加doro结局	添加新的 doro 结局	超级用户	添加doro结局 结局名 英文名 [图片] 或对话式
删除doro结局	删除指定的 doro 结局	超级用户	删除doro结局 123 或 删除doro结局 结局名 或对话式
修改doro结局	修改结局的中文名或英文名	超级用户	修改doro结局 123 或对话式

详细说明

1. 获取今日结局

用户：今日doro结局
Bot： [发送随机结局图片]

2. 添加新结局

bot主人：添加doro结局 欧润几结局 OrangeEnd [图片]
Bot：
	doro结局已添加
	ID: 3
	中文名: 欧润几结局
	英文名: OrangeEnd
	图片: 图片url

注意事项：

• 需要同时提供文字和图片
• 会自动生成唯一 ID

对话交互式添加：

现在可以只发送命令开头，让 Bot 逐步引导你补全信息：

bot主人：添加doro结局
Bot： 请输入结局的中文名：
bot主人：欧润几结局
Bot： 请输入结局的英文名：
bot主人：OrangeEnd
Bot： 请发送一张结局图片：
bot主人：[发送图片]
Bot： doro结局 '欧润几结局' 添加成功！

3. 删除结局

bot主人：删除doro结局 3（或删除doro结局 欧润几结局）
Bot：
  ✅ doro结局已成功删除
  ID: 3
  中文名: 欧润几结局
  英文名: OrangeEnd
  图片文件: 00000003_fired.jpg (已删除)

4. 列出所有结局

bot主人：列出doro结局
Bot： [发送合并转发消息，包含所有结局列表]

5. 修改结局

bot主人：修改doro结局 3
Bot： 要修改什么？
1. 中文名
2. 英文名
bot主人：1
Bot： 请输入新的中文名：
bot主人：新中文名
Bot： doro结局修改成功！

对话交互式：如果不提供ID，Bot会引导输入ID，然后选择修改项。

6. 查看 doro 帮助

普通用户与超管看到的帮助内容不同：

用户：doro结局帮助
Bot：
  doro 结局指令列表：
  - 今日doro结局：获取今日的 doro 结局
  - doro结局帮助：查看本帮助
  （如果你是超管，还会额外看到添加/删除/修改/列出等管理指令说明）

📦 数据结构与资源存放

插件数据使用 JSON 格式存储，结构如下：

{
  "datas": [
    {
      "id": 1,
      "name": "结局名称",
      "english_name": "english_name",
      "pic": "00000001_english.jpg"
    }
  ],
  "total": 1,
  "max_id": 1
}

图片资源目录

图片文件存储在以下路径中： {你nonebot_plugin_localstore插件配置的资源目录}/nonebot_plugin_doroending/DoroEndingPic/

文件命名规则为： {ID:08d}_{english_name}.jpg

例如： 00000001_example.jpg

📥 手动获取资源（如自动下载失败）

如果插件自动下载失败，你可以从以下仓库手动下载资源文件：

GitHub：https://github.com/SeeWhyRan/doroending_pic_assets

Gitee（国内备用）：https://gitee.com/seewhy_ran/doroending_pic_assets

操作步骤

下载资源仓库中的 DoroEndingPic/ 文件夹

下载资源仓库中的 doroendings.json 文件

将两者放置在以下目录中： {你的 Bot 根目录}/data/nonebot_plugin_doroending/

最后应该长这样

{你的 Bot 根目录}/
├── data/
│   ├── nonebot_plugin_doroending/
│   │   ├── DoroEndingPic/
│   │   │   ├── 00000001_english.jpg
│   │   │   └── ...
│   │   └── doroendings.json
│   └── ...（其他插件的数据文件夹）
├── pyproject.toml
└── ...（其他项目配置文件与代码文件）

🏗️ 项目结构

nonebot-plugin-doroending/
├── picture/            # README.md中的图片
├── dist/               # 构建完的文件
├── nonebot_plugin_doroending/  # 插件代码
│   ├── __init__.py
│   ├── doro_downloader.py
│   └── doro_manager.py
├── release.sh          # 构建发布脚本
├── .gitignore          # git忽略文件
├── pyproject.toml      # 项目配置
├── requirements.txt    # 项目依赖
├── README.md           # 本文件
└── LICENSE             # MIT许可证

📄 许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

🐛 问题反馈

如果您遇到任何问题或有建议，请通过以下方式反馈：

1. 提交 Issue
2. 联系作者邮箱

💡 TODO

（暂无）

📈 版本历史

v0.2.0 (2026-4-04)

• 新增：集成 nonebot_plugin_alconna，通过 inherit_supported_adapters("nonebot_plugin_alconna") 继承 Alconna 的适配器列表，增强多平台适配能力（例如 OneBot v11 等）。
• 新增：支持 添加doro结局 / 删除doro结局 / 修改doro结局 的对话交互式参数补全，当命令中缺少必要信息时，Bot 会逐步询问并补全。
• 新增：doro结局帮助 指令，根据调用者是否为超级用户，展示不同的 doro 结局指令列表。

v0.1.3 (2026-2-13)

• 优化：使用nonebot_plugin_localstore获取保存目录
• 优化：使用from nonebot.permission import SUPERUSER获取超级用户
• 优化：使用aiohttp、aiofiles下载保存资源
• 重构：简化了下载类和资源管理类

v0.1.2 (2026-2-5)

• 新增：实现真正的每日固定结局
• 新增：准备了结局图片文件，启动插件时检测到没有资源会自动从Github或Gitee上下载
• 优化：将需要保存的数据统一放在./data/nonebot_plugin_doroending/下，与大多数插件统一

v0.1.1 (2026-2-5)

• 重构：将数据操作封装为 DoroDataManager 类，提升代码可维护性
• 优化：在内存中缓存用户每日结局，为“每日固定”做准备

v0.1.0 (2026-2-4)

• 首个发布版本。
• 实现核心功能：随机获取、添加、删除、列出 doro 结局
• 支持 OneBot v11 适配器
• 完善的超级用户权限管理

---

祝您使用愉快！每天都有一个惊喜的 doro 结局！🎉

如果这个插件对您有帮助，请给个 ⭐️ Star 支持一下！