安装指南
本指南将帮助您安装 YesImBot 插件到您的 Koishi 环境中。确保您已完成环境准备中的所有步骤,然后按照以下说明进行操作。
通过 Koishi 插件市场安装(推荐)
使用 Koishi 插件市场是安装 YesImBot 最简单的方法,特别适合新手用户。
步骤 1: 打开 Koishi 控制台
启动 Koishi 应用程序,并在浏览器中打开控制台(通常是 http://localhost:5140
)。
步骤 2: 访问插件市场
- 在 Koishi 控制台左侧菜单中,点击"插件市场"
- 在搜索框中输入
yesimbot
- 在搜索结果中找到
koishi-plugin-yesimbot
步骤 3: 安装插件
- 点击
koishi-plugin-yesimbot
插件卡片 - 点击"安装"按钮
- 等待安装完成
步骤 4: 安装扩展(可选)
如果您需要 MCP 扩展功能,可以同样的方式搜索并安装 koishi-plugin-yesimbot-extension-mcp
。
通过 npm 命令行安装
如果您使用命令行方式管理 Koishi,可以通过 npm 安装 YesImBot。
步骤 1: 进入 Koishi 项目目录
步骤 2: 安装 YesImBot 核心插件
步骤 3: 安装 MCP 扩展(可选)
步骤 4: 更新 Koishi 配置
编辑您的 koishi.yml
或 koishi.config.js
文件,添加 YesImBot 插件:
对于 YAML 配置:
对于 JavaScript 配置:
module.exports = {
plugins: {
yesimbot: {
// 这里将添加 YesImBot 的配置
},
'yesimbot-extension-mcp': {
// 这里将添加 MCP 扩展的配置(如果已安装)
}
}
}
从源代码安装(开发者选项)
如果您是开发者或需要最新的功能,可以从源代码安装 YesImBot。
步骤 1: 克隆仓库
步骤 2: 安装依赖
步骤 3: 构建项目
步骤 4: 链接到您的 Koishi 项目
验证安装
安装完成后,您可以通过以下步骤验证 YesImBot 是否正确安装:
- 重启 Koishi 服务
- 在 Koishi 控制台中,导航到"插件配置"
- 检查是否存在 YesImBot 的配置选项
- 如果安装了 MCP 扩展,也应该能看到相应的配置选项
常见安装问题
找不到插件
如果在插件市场中搜索不到 YesImBot,可能是因为:
- 您的 Koishi 版本过低,需要更新到最新版本
- 插件市场连接不稳定,可以尝试刷新页面或稍后再试
- 您可能需要添加自定义插件源
解决方案:
- 更新 Koishi 到最新版本
- 检查网络连接
- 如果问题仍然存在,尝试通过 npm 命令行安装
安装失败
如果安装过程中出现错误,可能是因为:
- 网络连接问题
- 依赖冲突
- 权限问题
解决方案:
- 检查网络连接
- 尝试清除 npm 缓存:
npm cache clean --force
- 确保您有足够的权限安装插件
- 查看错误日志,了解具体问题
版本兼容性问题
如果安装后插件无法正常工作,可能是版本兼容性问题:
- YesImBot 与当前 Koishi 版本不兼容
- YesImBot 核心与 MCP 扩展版本不匹配
解决方案:
- 确保您使用的是最新版本的 Koishi
- 确保 YesImBot 核心与 MCP 扩展版本匹配
- 查看 YesImBot 的 GitHub 仓库,了解版本兼容性信息
下一步
成功安装 YesImBot 后,您需要进行基本配置才能开始使用。