zhenxun_bot

mirror of https://github.com/zhenxun-org/zhenxun_bot.git synced 2025-12-14 21:52:56 +08:00

基于 Nonebot2 开发，实现多平台适配和多Bot管理的，非常可爱的绪山真寻Bot

Go to file

HibiKier 3b1a399d5f ✨ 添加小真寻的口癖配置 (#1738 )		2024-11-23 21:37:00 +08:00
.github	📝 使用 issue 表单替换 issue 模板 (#1727 )	2024-11-17 06:49:23 +08:00
.vscode	🐛 修复图片模板方法	2024-11-16 17:59:15 +08:00
data	🔥 移除过期原神日历文件	2024-11-22 17:02:14 +08:00
docs_image	🎨 修改md	2024-11-05 15:54:53 +08:00
resources	✨ 本地引入echart.js	2024-10-20 13:34:47 +08:00
scripts	✨ 更好的Bot运行检查	2024-08-27 23:30:14 +08:00
tests	✨ 更新插件商店功能，支持通过模块名操作插件(#1670 )	2024-10-02 18:32:21 +08:00
zhenxun	✨ 添加小真寻的口癖配置 (#1738 )	2024-11-23 21:37:00 +08:00
__version__	🎨 排行榜代码优化与修改版本	2024-11-22 10:05:54 +08:00
.dockerignore	✨ Dockerfile	2024-08-14 13:35:03 +08:00
.env	first_commit .gitignore	2021-05-20 18:37:51 +08:00
.env.dev	🐛 修复admin_check	2024-10-22 10:38:40 +08:00
.gitignore	✨ 新增个人信息命令 (#1657 )	2024-09-29 17:00:31 +08:00
.pre-commit-config.yaml	✨添加代码检查 (#1583 )	2024-08-26 23:54:07 +08:00
bot.py	🐛 修复签到金币排行bug以及添加官bot监控	2024-10-19 00:36:19 +08:00
CODE_OF_CONDUCT.md	Document/add conduct and contributing (#1736 )	2024-11-22 08:33:46 +08:00
CONTRIBUTING.md	Document/add conduct and contributing (#1736 )	2024-11-22 08:33:46 +08:00
Dockerfile	🚀 更新Dockerfile (#1599 )	2024-09-02 23:12:27 +08:00
LICENSE	Create LICENSE	2021-10-23 15:09:11 +08:00
logo.png	UPDATE README.md	2022-08-22 20:47:32 +08:00
poetry.lock	✨ 部分功能适配QQ BOT (#1701 )	2024-10-18 18:57:55 +08:00
pyproject.toml	✨ 部分功能适配QQ BOT (#1701 )	2024-10-18 18:57:55 +08:00
README.md	💬 修改md	2024-11-09 13:53:38 +08:00
requirements.txt	🎨 修改requirements (#1665 )	2024-10-01 00:29:29 +08:00

绪山真寻 Bot

“真寻是椛椛的好朋友！”

🎉喜欢真寻，于是真寻就来了！🎉

本项目符合 OneBot 标准，可基于以下项目与机器人框架/平台进行交互

项目地址	平台	核心作者	备注
LLOneBot	NTQQ	linyuchen	可用
Napcat	NTQQ	NapNeko	可用
Lagrange.Core	NTQQ	LagrangeDev/Linwenxuan04	可用

真寻觉得你需要帮助

这是一份扩展

1. 体验一下？

这是一个免费的，版本为 dev 的 zhenxun，你可以通过 napcat 或拉格朗日以及 matcha 等直接连接用于体验与测试
（球球了测试君！）

Url: ws://test.zhenxun.org:8080/onebot/v11/ws
AccessToken: PUBLIC_ZHENXUN_TEST

注：你无法获得超级用户权限

2. 额外扩展

“不要害怕，你的背后还有千千万万的伙伴啊！”

项目名称	主要用途	仓库作者	备注
插件库	插件	zhenxun-org	原 plugins 文件夹插件
插件索引库	插件	zhenxun-org	扩展插件索引库
一键安装	安装	soloxiaoye2022	第三方
WebUi	管理	hibikier	基于真寻 WebApi 的 webui 实现
安卓 app(WebUi)	安装	YuS1aN	第三方

WebUI 后台示例图

来点优点？可爱难道还不够吗

实现了许多功能，且提供了大量功能管理命令，进行了多平台适配，兼容 nb2 商店插件
拥有完善可用的 webui
通过 Config 配置项将所有插件配置统计保存至 config.yaml，利于统一用户修改
方便增删插件，原生 nonebot2 matcher，不需要额外修改，仅仅通过简单的配置属性就可以生成帮助图片和帮助信息
提供了 cd，阻塞，每日次数等限制，仅仅通过简单的属性就可以生成一个限制，例如：PluginCdBlock 等
..... 更多详细请通过[传送门]查看文档！

简单部署

# 获取代码
git clone https://github.com/HibiKier/zhenxun_bot.git

# 进入目录
cd zhenxun_bot

# 安装依赖
pip install poetry      # 安装 poetry
poetry install          # 安装依赖

# 开始运行
poetry shell            # 进入虚拟环境
python bot.py

# 首次后会在data目录下生成config.yaml文件
# config.yaml用户配置插件

简单配置

1.在.env.dev文件中

  SUPERUSERS = [""]   # 填写你的QQ

  PLATFORM_SUPERUSERS = '
  {
    "qq": [""],   # 在此处填写你的qq
    "dodo": [],
    "kaiheila": [],
    "discord": []
  }
  '
  # 此处填写你的数据库地址
  # 示例: "postgres://user:password@127.0.0.1:5432/database"
  # 示例: "mysql://user:password@127.0.0.1:5432/database"
  # 示例: "sqlite:data/db/zhenxun.db"   在data目录下建立db文件夹
  DB_URL = ""   # 数据库地址


2.在configs/config.yaml文件中 # 该文件需要启动一次后生成
  * 修改插件配置项

功能列表

内置功能

真寻原 plugins 插件文件夹已迁移至其他仓库，当前内置仅保留必要的功能

基础功能

昵称系统（群与群与私聊分开）
签到/我的签到/好感度排行/好感度总排行（影响色图概率和开箱次数，支持配置）
商店/我的金币/购买道具/使用道具/金币排行（完整的商店添加/购买/使用流程）
查看当前群欢迎消息
个人信息查看（群组内权限，聊天频率等）
消息撤回
功能统计可视化
关于
三种样式的帮助菜单

管理员功能

管理员帮助
更新群组成员信息
95%的群功能开关
查看群内被动技能状态
自定义群欢迎消息（是真寻的不是管家的！）
ban/unban（支持设置 ban 时长）= 群组及用户的黑名单
休息吧/醒来（群组内真寻状态）

超级用户功能

超级用户帮助
添加/删除权限（是真寻的管理员权限，不是群管理员）
群组管理，退群指令等
广播
自检（检查系统状态）
所有群组/所有好友
退出指定群
更新好友信息/更新群信息
修改群权限
检查更新
重启
添加/删除/查看群白名单
功能开关(更多设置)
功能状态
执行 SQL
重载配置
清理临时数据
增删群认证
同意/拒绝好友/群聊请求
添加/移除/更新插件/插件商店（plugins 库以及扩展库）
WebUI API（对真寻前端的支持）

超级用户的被动技能

邀请入群提醒(别人邀请真寻入群，可配置自动同意)
添加好友提醒(别人添加真寻好友，可配置自动同意)

被动技能

群早晚安

看不见的技能

功能调用统计
聊天记录统计
检测恶意触发命令（将被最高权限 ban 掉 30 分钟，只有最高权限(9 级)可以进行 unban）
自动同意好友/群组请求，加群请求将会提醒管理员，退群提示，加群欢迎等等
群聊时间检测（当群聊最后一人发言时间大于当前 48 小时后将关闭该群所有通知（即被动技能））
群管理员监控，自动为新晋管理员增加权限，为失去群管理员的用户删除权限
群权限系统
定时更新权限
自动配置重载
强制入群保护
自定备份（可配置）
笨蛋检测（当使用功能名称当指令时真寻会跳出来狠狠嘲笑并帮助）

爱发电

爱发电以及感谢投喂

感谢名单

(可以告诉我你的 github 地址，我偷偷换掉 0v|)

shenqi A_Kyuu 疯狂混沌投冥茶喵 AemokpaTNR 爱发电用户_wrxn qqw 溫一壺月光下酒
 伝木
 阿奎
 醉梦尘逸
 Abc
本喵无敌哒
 椎名冬羽
 kaito
笑柒 XIAO_Q7
请问一份爱多少钱
 咸鱼鱼鱼鱼
 Kafka
墨然爱发电用户_T9e4
笑柒 XIAO_Q7
noahzark
腊条
 ze roller
爱发电用户_4jrf
爱发电用户_TBsd
烟寒若雨
 ln
爱发电用户_b9S4
爱发电用户_c58s
爱发电用户_eNr9 MangataAkihi 炀爱发电用户_Bc6j
大魔王 CopilotLaLaLa
嘿小欧回忆的秋千
 十年くん哇
 yajiwa
爆金币 ...

..... 更多更新信息请查看文档

Todo

web 管理

感谢

botuniverse / onebot ：超棒的机器人协议
Mrs4s / go-cqhttp ：cqhttp 的 golang 实现，轻量、原生跨平台.
nonebot / nonebot2 ：跨平台 Python 异步机器人框架
Angel-Hair / XUN_Bot ：一个基于 NoneBot 和酷 Q 的功能性 QQ 机器人
pcrbot / cappuccilo_plugins ：hoshino 插件合集
MeetWq /nonebot-plugin-withdraw ：A simple withdraw plugin for Nonebot2
maxesisn / nonebot_plugin_songpicker2 ：适用于 nonebot2 的点歌插件
nonepkg / nonebot-plugin-manager ：Nonebot Plugin Manager base on import hook
H-K-Y / Genshin_Impact_bot ：原神 bot，这是一个基于 nonebot 和 HoshinoBot 的原神娱乐及信息查询插件
NothAmor / nonebot2_luxun_says ：基于 nonebot2 机器人框架的鲁迅说插件
Kyomotoi / AnimeThesaurus ：一个~~特二刺螈~~（文爱）的适用于任何 bot 的词库
Ailitonia / omega-miya ：基于 nonebot2 的 qq 机器人
KimigaiiWuyi / GenshinUID ：一个基于 HoshinoBot/NoneBot2 的原神 UID 查询插件

README.md Unescape Escape