🤝 帮助页面

点击展开查看图片

📦 这是一份扩展

1. 体验一下？

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

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

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

2. 额外扩展

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

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

🐣 小白整合

如果你系统是 Windows 且对于指令一类不熟
可以使用整合包

注意

***Python需要自行安装且版本大于等于3.11***

文档地址：整合包文档

下载地址

• 百度云：
  https://pan.baidu.com/s/1MKGOoIgQW1qom_KT3rNhlg?pwd=t7iz

• 夸克网盘：
  https://pan.quark.cn/s/b4dc6cb8fb08
  访问码：Yi46

• Google Drive：
  https://drive.google.com/drive/folders/1dcTWhPZhSt9WqLehyjF6Gj0CXQCS4OWh?usp=drive_link

🛠️ 简单部署

# 获取代码
git clone https://github.com/zhenxun-org/zhenxun_bot.git

# 进入目录
cd zhenxun_bot

# 安装依赖
pip install uv          # 安装 uv
uv sync                 # 安装依赖

# 开始运行
uv run zx

📝 简单配置

[!TIP] config.yaml 需要启动一次 Bot 后生成

1.在 .env.dev 文件中填写你的机器人配置项

2.在 data/config.yaml 文件中修改你需要修改的插件配置项

数据库地址（DB_URL）配置说明

DB_URL 是基于 Tortoise ORM 的数据库连接字符串，用于指定项目所使用的数据库。以下是 DB_URL 的组成部分以及示例：

格式为： <数据库类型>://<用户名>:<密码>@<主机>:<端口>/<数据库名>?<参数>

• 数据库类型：表示数据库类型，例如 postgres、mysql、sqlite 等。
• 用户名：数据库的用户名，例如 root。
• 密码：数据库的密码，例如 123456。
• 主机：数据库的主机地址，例如 127.0.0.1（本地）或远程服务器 IP。
• 端口：数据库的端口号，例如：PostgreSQL：5432, MySQL：3306
• 数据库名：指定要使用的数据库名称，例如 zhenxun。
• 参数（可选）：用于传递额外的配置，例如字符集设置。

📋 功能列表

[!NOTE] 真寻原 plugins 插件文件夹已迁移至 插件仓库 ，现在本体仅保留核心功能

内置功能

🔧 基础功能

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

🛠️ 管理员功能

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

🧑‍💼 超级用户功能

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

🛡️ 超级用户的被动技能

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

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

🤖 被动技能

• 群早晚安

👻 看不见的技能

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

💖 赞助

爱发电

赞助名单

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

Zer 爱发电用户_HTjk shenghuo2 术樱 飞火 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 爆金币...

特别赞助

📜 贡献指南

欢迎查看我们的 贡献指南 和 行为守则 以了解如何参与贡献。

❔ 需要帮助？

[!TIP] 发起 issue 前，我们希望你能够阅读过或者了解 提问的智慧

• 善用搜索引擎
• 查阅 issue 中是否有类似问题，如果没有请按照模板发起 issue

欢迎前往 issue 中提出你遇到的问题，或者加入我们的 用户群 或 技术群与我们联系

🛠️ 进度追踪

Project zhenxun_bot

🌟 特别感谢

首席设计师：酥酥/coldly-ss

LOGO 设计：FrostN0v0

🙏 感谢

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 查询插件

📊 统计与活跃贡献者

👨‍💻 开发者

感谢以下开发者对 绪山真寻 Bot 作出的贡献：

📸 WebUI 界面展示（仅展示默认主题下的 pc 端）