安装可爱的小真寻
版本警告
真寻Bot需要python版本为 3.10或3.11
Tip
Python3.9 同样也可以使用,但是需要将pyproject.toml中的版本改为3.9
下载
从 HibiKier / zhenxun_bot clone代码 或 直接下载 压缩包 解压
安装依赖包
pip3 install poetry # 使用poetry管理python包
poetry install # 安装依赖
poetry shell # 进入虚拟环境
基础配置
设置超级用户,打开 .env.dev 文件,在SUPERUSERS
和qq
中添加自己的QQ
env.dev
SUPERUSERS=["123456789"]
PLATFORM_SUPERUSERS = '
{
"qq": ["123456789"],
"dodo": [],
"kaiheila": [],
"discord": []
}
'
数据库配置
- Postgresql
- Sqlite
- Mysql
建议的数据库,嫌麻烦请使用Sqlite
env.dev
# 示例: "postgres://user:password@127.0.0.1:5432/database"
DB_URL = "postgres://用户名:密码@127.0.0.1:端口/数据库名称"
# 如果你是与教程一模一样的命令代码,且数据库也在该服务器上,可以直接复制以下URL
DB_URL = "postgres://postgres:zhenxun_bot@127.0.0.1:5432/zhenxun_bot"
Sqlite可以放置在任何位置,sqlite:
之后为存放路径,但建议在data文件夹下新建db文件夹后使用以下
env.dev
# 示例: "sqlite:data/db/zhenxun.db"
DB_URL = "sqlite:data/db/zhenxun.db"
与Postgresql
相同
env.dev
# 示例: "mysql://user:password@127.0.0.1:3306/database"
DB_URL = "mysql://用户名:密码@127.0.0.1:端口/数据库名称"
基础插件配置
文件保存在 data/config.yaml,所有真寻相关插件都在使用该配置文件,按需修改
启动
python3 bot.py
# or
python bot.py
当你的控制台出现以下日志,说明你已经成功了🎉🎉
08-14 23:18:44 [INFO] zhenxun | CMD[Web UI] API启动成功
08-14 23:18:44 [INFO] uvicorn | Application startup complete.
08-14 23:18:44 [INFO] uvicorn | Uvicorn running on http://127.0.0.1:8080 (Press CTRL+C to quit)
提示
当前版本真寻本体与插件库分离,你可以在以下获取插件或其他相关,或通过与真寻的对话命令安装插件(插件商店)
项目名称 | 主要用途 | 仓库作者 | 备注 |
---|---|---|---|
插件库 | 插件 | zhenxun-org | 原 plugins 文件夹插件 |
插件索引库 | 插件 | zhenxun-org | 扩展插件索引库 |
一键安装 | 安装 | soloxiaoye2022 | 第三方 |
WebUi | 管理 | hibikier | 基于真寻 WebApi 的 webui 实现 |
安卓 app(WebUi) | 安装 | YuS1aN | 第三方 |