快速安装教程

环境要求

• Node.js 16.14 或更高版本（下载地址）
• Yunzai-Bot v3（确保已正确安装并能正常运行）
• Git（用于克隆仓库，下载地址）
• pnpm（推荐使用，可通过 npm install -g pnpm 安装）

开始安装

1

进入 Yunzai-Bot 根目录

请确保您在正确的目录下进行操作

2

克隆插件仓库

您可以选择以下任一地址进行克隆：

# 使用 Gitee（国内推荐）
git clone --depth=1 https://gitee.com/wan13877501248/y-tian-plugin.git ./plugins/y-tian-plugin/

# 或者使用 GitHub
git clone --depth=1 https://github.com/yuanplussfive/y-tian-plugin.git ./plugins/y-tian-plugin/

3

安装依赖(插件内置依赖自动安装脚本,仅失败需要手动安装!)

推荐使用 pnpm 安装依赖，如果安装失败可以尝试其他包管理器

cd ./plugins/y-tian-plugin && pnpm install

# 如果 pnpm 安装失败，可以尝试：
npm install

4

重启 Bot

安装完成后需要重启 Bot 使插件生效

# 对你的bot发送 #重启 使热更新生效或手动pm2重启
pnpm restart

# 如果 pnpm 安装失败，可以尝试：
npm run restart

常见问题

1. 依赖安装失败？

   • 检查网络连接是否正常
   • 尝试切换 npm 源：npm config set registry https://registry.npmmirror.com
   • 尝试使用其他包管理器（npm/yarn）
   • 确保 Node.js 版本符合要求（>= 16.14）

2. 插件无法加载？

   • 检查插件目录名称是否为 y-tian-plugin
   • 确认是否已正确安装所有依赖
   • 查看 Yunzai-Bot 运行日志排查错误
   • 确保 Yunzai-Bot 版本为 v3

3. 需要帮助？

   • 访问项目主页：
     • Gitee
     • GitHub
   • 提交 Issues 反馈问题