MCPcopy
hub / github.com/zhenxun-org/zhenxun_bot

github.com/zhenxun-org/zhenxun_bot @v0.2.4-fix3 sqlite

repository ↗ · DeepWiki ↗ · release v0.2.4-fix3 ↗
1,715 symbols 7,734 edges 209 files 491 documented · 29%
README

python nonebot onebot

license tencent-qq tencent-qq

文档

绪山真寻 Bot

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

:tada:喜欢真寻,于是真寻就来了!:tada:

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

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

Star Trend

真寻觉得你需要帮助

这是一份扩展

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 后台示例图

x x x x x x x x

~~来点优点?~~ 可爱难道还不够吗

  • 实现了许多功能,且提供了大量功能管理命令,进行了多平台适配,兼容 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 插件文件夹已迁移至其他仓库,当前内置仅保留必要的功能

基础功能

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

管理员功能

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

超级用户功能

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

超级用户的被动技能

  • [x] 邀请入群提醒(别人邀请真寻入群,可配置自动同意)

  • [x] 添加好友提醒(别人添加真寻好友,可配置自动同意)

被动技能

  • [x] 群早晚安

看不见的技能

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

更多插件...

爱发电

爱发电 以及 感谢投喂

感谢名单

(可以告诉我你的 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
爆金币 ...

<!-- ### 2024/1/25

  • 重构webui

2023/12/28

  • 修复B站动态获取失败的时候,会发送空消息

2023/9/6

  • 修正b站订阅

2023/8/28

  • 重构红包功能, 允许一个群聊中有多个用户发起的红包,发送等命令会开启群中所有条件允许的红包,新增红包结算排行,在红包退回或抢完时统计,在塞红包时at可以发送专属红包
  • 开箱添加更新武器箱图片超级用户命令,用于导入数据表后更新图片

2023/8/20

  • 修复词条回答包含at时使用模糊|正则等问时无法正确匹配问题
  • 修复开箱时最后开箱日期数据未更新

2023/8/7

  • 添加 本地图库插件 防吞图特性 @pull/1468

2023/5/28

  • 修复群聊数据无法初始化

2023/5/24

  • 轮盘结算信息使用图片发送

2023/5/23

  • 修复群聊数据无法初始化
  • 修复修改图库配置重载后上传图片时提示的图库与配置不符

2023/5/22

  • 群聊中B站订阅所有管理员共享增删操作
  • 数据库中所有user_qq改名以及user_id和group_id改为字符串
  • 修改查看词条图片等显示问题

2023/5/16

  • 修复因明日方舟新增“中坚寻访”导致抽卡模拟不可用的问题 @pull/1418

2023/4/16

  • 修复开箱更新未登录时没有停止更新
  • 修复更新色图问题
  • fix bug @pull/1368
  • BilibiliSub的部分字段改为字符串

2023/4/5

  • 词条正则回答中允许使用$1.$2..来获取()捕获组

2023/4/3

  • 修复帮助命令-super无效

2023/4/1

  • 修复开箱偶尔出现未抽取到任何皮肤
  • 修改优化开箱显示图片

2023/3/28

  • 补全注释SCRIPT中的sql语句
  • 罕见物品更新时会收录所有包含该物品的箱子,可以通过更新皮肤ALL1 -S强制更新所有罕见物品所属箱子

2023/3/27

  • 优化开箱更新

2023/3/25

  • 删除BUFF_SKIN表约束,新增skin_id字段
  • 开箱新增更新指定刀具皮肤命令(某些箱子金色无法通过api获取)
  • 修复词条At时bug与模糊查询时无法替换占位符问题

2023/3/20

  • 修复BuildImage类text居中类型bug @pull/1301
  • 修复原神今日素材有时发不出图片的问题 @pull/1301
  • 修复首次签到时使用道具后签到报错
  • 修复词条添加错误

2023/3/19

  • 优化代码
  • 查看武器箱及皮肤添加更新次数
  • 修复添加群认证会检测群聊是否存在
  • 修复色图r连发时未检测当前会话是否为群聊

2023/3/18

  • 修复色图重复发送相同图片
  • 修复签到好感度进度条错误

2023/3/12 [v0.1.6.7]

  • 新增更新武器箱ALL命令来更新所有武器箱
  • 新增查看武器箱命令
  • 色图bug修复、增加指令 @pull/1301

2023/3/9

2023/3/5

  • 更新开箱会记录箱子数据以及开箱时箱子价格加入花费
  • 修复开箱BUG

2023/3/4

  • 重写翻译,使用百度翻译API
  • 新增开箱日志以及自动更新武器箱

2023/3/2

  • 修复config.yaml中把False也当成None的问题 @pull/1288
  • 删除道具表无用字段(props) @pull/1287
  • 修复词云
  • 修复我的签到签到图片
  • 更正BuffSkin添加语句
  • 修复词条单图片/表情/at无法添加

2022/3/1

  • 重写开箱更新箱子,允许更新目前所有箱子的皮肤
  • 修复消息统计

2023/2/28

  • 把Config的type字段默认类型由str改为None @pull/1283
  • 修复同意群聊请求以及添加群认证 更新变成查询的问题 @pull/1282

2023/2/26

  • Config提供type字段确定配置项类型
  • 重写开箱功能

2023/2/25

  • 修复ys查询,尘歌壶背景尺寸与内容不匹配的问题 @pull/1270
  • 更换cos url @pull/1270

2023/2/20

  • chat_history部分字段调整为可null @pull/1270

2023/2/19

  • 修正了重载插件的帮助提示
  • 修改BUG

2023/2/18

  • 数据库舍弃gino使用tortoise
  • 昵称提供命令全局昵称设置
  • manager_group群管理操作中退群修改群权限添加/删除群白名单添加/删除群认证在群聊中使用命令时且未指定群聊时,默认指定当前群聊
  • 修复插件帮助命令不生效的问题 @pull/1263
  • 解决开红包经常误触的问题,有红包和未领取的时候才会触发“开”命令 @pull/1257
  • 细节优化,原神今日素材重写 @pull/1258

2023/1/31

2023/1/27

2022/12/31

  • 修复epic报错,优化简介 @pull/1226
  • 修复词条在某些回答下出错
  • 原神黄历改为PIL
  • 允许真寻自身触发命令,提供配置项 self_message:STATUS

2022/12/27 [v0.1.6.6]

  • 添加权限检查依赖注入

2022/12/26

  • 优化gamedraw插件
  • 提供全局被动控制
  • 群被动状态改为图片
  • 修复epic获取到的简介不是中文的bug @pull/1221

2022/12/24

  • 修复群管理员权限检测会阻挡超级用户权限

2022/12/23

  • 优化管理员帮助超级用户帮助图片
  • 重新移植gamedraw
  • 修复pil帮助私聊时无法生成

2022/12/17

  • 修复查看插件仓库当已安装插件版本不一致时出错

2022/12/15

  • 修复自定义群欢迎消息无法使用

Core symbols most depended-on inside this repo

get
called by 553
zhenxun/utils/http_utils.py
build_message
called by 184
zhenxun/utils/message.py
append
called by 181
zhenxun/utils/withdraw_manage.py
filter
called by 161
zhenxun/utils/_build_image.py
get
called by 143
zhenxun/builtin_plugins/web_ui/api/tabs/main/data_source.py
info
called by 140
zhenxun/services/log.py
debug
called by 127
zhenxun/services/log.py
send
called by 90
zhenxun/builtin_plugins/superuser/broadcast/_data_source.py

Shape

Function 1,070
Method 405
Class 221
Route 19

Languages

Python52%
TypeScript48%

Modules by API surface

resources/template/js/echarts.min.js829 symbols
zhenxun/utils/_build_image.py31 symbols
zhenxun/utils/github_utils/models.py30 symbols
zhenxun/configs/utils/__init__.py29 symbols
zhenxun/builtin_plugins/admin/plugin_switch/_data_source.py28 symbols
zhenxun/utils/_build_mat.py26 symbols
zhenxun/utils/utils.py25 symbols
zhenxun/utils/decorator/shop.py22 symbols
zhenxun/builtin_plugins/init/manager.py20 symbols
zhenxun/utils/platform.py18 symbols
zhenxun/builtin_plugins/web_ui/api/tabs/manage/model.py18 symbols
zhenxun/builtin_plugins/hooks/_auth_checker.py18 symbols

Datastores touched

(mysql)Database · 1 repos

For agents

$ claude mcp add zhenxun_bot \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact