常见koishi问题解决方案

最新最热!!!!

近期更新发生问题

插件市场中无法搜索到部分插件

(感谢上学dalao!@shangxue

使用教程&wiki

用户文档地址

官网、koishi下载、插件文档、开发文档、官方插件列表

新人快速入门贴!

Koishi Desktop 导航

视频教程、简易入门、配置文件地址、根目录地址、双清、重置、初始化koishi、无图形界面命令行工具

koishi Android更新到最新

服务器部署

上云、服务器、阿里云打不开koishi、dll修复、打不开koishi、koishi闪退、控制台登录、控制台保护

阿里云上云示例:

↓他是一个优秀的上云教程

如果你使用阿里云机器(必看):

当你在阿里云上机器(或者你本地部署的时候)发现koishi点击启动后没有koishi窗口,但是可以通过127.0.0.1:5140访问koishi控制台,你需要看看这个贴。省流:下载并安装vc_redisthttps://aka.ms/vs/17/release/vc_redist.x64.exe

控制台添加登录功能,公网暴露须知:

官方qqbot接入

接入QQ,接入QQ频道、官方QQbot、接入教程

你或许听说过许多种接入QQ的方式,例如onebot、Red、liteloader。

但是,他们都是第三方的接入QQ的方式,可能存在法律风险及封号风险。

koishi用户群、论坛不支持以上接入方式的讨论。在这些地方提问你将不会得到解答。

你可以通过自行访问相关文档,求助非官群群友的方式自行使用上述方法使koishi对接QQ,koishi不承担因此导致的任何责任。

其他平台适配器相关的接入教程

接入:钉钉、Discord、Kook、飞书、LINE、邮件、Matrix、SatoriSlack、Telegram、微信公众号、企业微信、WhatsApp、Zulip

koishi相关群

官方QQ群、第三方QQ群、交流群、开发群、插件讨论群

用户群群规

正确地提问过程、模板和「四项信息」

如何提问,提问模板、四项信息

关于不安全的插件

不安全的插件、红色感叹号标志、解除不安全标志、不安全插件的危害

win7如何使用koishi桌面版

win7、Windows7、koishi桌面

如何查看自己的平台名与用户 ID

koishi镜像一览

koishi官网镜像、koishi软件源镜像、koishi插件市场镜像

常见问题

插件市场无法搜到一些插件

插件安装后,koishi控制台白屏/侧边栏消失

公网部署、需要登录、公网暴露

如何开关某个插件在某个频道/群的相应

更新的时候koishi炸了!(或无侧边栏,白屏等错误)

可能的修复方式:

腾讯官方群聊机器人无法发送图片

相关的链接:

新系统/服务器(点名阿里云)无法启动或安装koishi/新安装的koishi不显示界面/ koishi点击启动后无响应/我的koishi任务栏不能正确打开

Windows安装koishi desktop失败、打不开koishi、启动无反应、可访问127.0.0.1:5140或localhost:5140、阿里云

相关讨论1:心得体会:新系统使用koshi打不开没有界面的解决方法之一 ——dll修复
相关讨论2:koishi无法运行
相关讨论3:启动 Koishi 后报错「找不到 VCRUNTIME」

小火箭一键更新出现问题

not found、白屏、一键更新、小火箭、插件

当你使用一键更新的时候适用此贴

相关帖子:Koishi 窗口变成白色的然后显示「Not Found」,是什么问题啊

通用解决方案——重装(双清):彻底卸载/清理/删除/初始化/重置 Koishi

ps:感觉日常更新插件是好的,长时间好几个版本不更新一下更新的话可能大概率会出控制台白屏什么的问题

当你通过搜索遇到这个问题的时候,你也许需要看看:

安装(或启动)完插件后很秃然控制台炸了

又是not found、白屏、插件

当你仅更新或启动一个插件的的时候适用此贴,小火箭更新导致的问题可尝试上面一个解决方式

在koishi.yml文件内找到你安装插件的那部分,给插件名称前面加上一个~,重启koishi。

koishi.yml位置:「Koishi 配置文件」的位置

例如你安装了一个名为admin的插件,你需要找到

admin: {}

并将其改为

~admin: {}

保存后重启。

此操作的逻辑是通过更改文件的方式更改了插件的启动情况,前方带~代表此插件处于关闭状态。
如果你使用此方法成功启动,你可以将插件问题反馈给作者并处理插件。

安装插件他说我没有安装,启动插件他说我没有启动

此插件尚未安装,点击前往插件市场

省流:按一下F5或者右键控制台刷新一下即可

如何备份koishi/还原备份

备份、backup

如果你的备份时和还原备份时的版本不一样时,你需要可以:

重新安装koishi,将备份的文件放置到此koishi中对应的位置。在数据文件夹中跑一次yarn?)

如何修改/添加权限

提权、修改权限、给予权限、权限不足

相关文档:深入定制机器人 | Koishi

及其操作图文教学?:怎么提升自己的权限(提权)

给所有人某个权限:如何给所有人下发单独一个3级权限的指令的权限?

官方QQ机器人无法收到指令

官方QQbot、不响应指令、前缀、@

艾特机器人,后加上命令,再发送。

更换账号后,在群内机器人无响应/bot仅私聊响应/bot仅在群内接受@+指令

assign、换号、未响应、数据库、assignee

@机器人 assign

你有个问题想要反馈给作者/如何找到作者

问题反馈、寻找作者、issue

找到作者,并且发送信息给他!
或者去github发issue!

不要因此进入开发者群聊,加群搜索可以不要直接@xxx大佬你的插件出问题了

改变默认终端 隐藏控制台

终端、cmd、PowerShell、隐藏控制台

Ubuntu的snap下安装chromium引发的koishi-plugin-puppeteer提示未找到index.html

Ubuntu、Snap、pptr、chromium、puppeteer、未找到index.html、net::ERR_ACCESS_DENIED path to index.html

安装插件时显示安装失败

安装失败、插件、权限?

此问题较为久远或不常见?

更新到market2发生问题

此问题较为久远或已被修复

相关帖子:升级至 market2 后无法无法配置插件的解决方案
相关帖子2:Koishi 控制台持续更新贴 - #19,来自 shigma
相关帖子3:早期小火箭一键更新到 4.13.7 后出现 Not Found 的解决方案

无法连接到插件市场

此问题较为久远或不常见

无法连接到插件市场。这可能是以下原因导致的 无法连接到网络,请检查你的网络连接和代理设置 您所用的 registry 不支持搜索功能(npmmirror),请考虑进行更换

t4佬的插件市场镜像:关于一个插件市场的镜像

资助镜像源:[众筹] 插件市场镜像流量费用

koishi镜像一览:Koishi 镜像一览

论坛相关

论坛如何精准跳转

https://forum.koishi.xyz/t/topic/1536

blockly教程

blockly教程征集帖

https://forum.koishi.xyz/t/topic/2120

其他

t4佬的插件镜像源众筹

https://forum.koishi.xyz/t/topic/6208

backup

紧急!!!

https://forum.koishi.xyz/t/topic/6708

使用教程&wiki

用户文档地址

https://koishi.chat

Koishi Desktop 导航

https://forum.koishi.xyz/t/topic/1651

服务器部署

https://koishi.chat/zh-CN/manual/recipe/server.html

最新qq接入

https://forum.koishi.xyz/t/topic/810

其他平台适配器相关的接入教程

https://koishi.chat/zh-CN/plugins/adapter/kook.html

koishi相关群

https://forum.koishi.xyz/t/topic/6042

正确地提问过程、模板和例子大全!

https://forum.koishi.xyz/t/topic/5687

新人快速入门贴!

https://forum.koishi.xyz/t/topic/556

关于不安全的插件

https://forum.koishi.xyz/t/topic/1930

win7如何使用koishi桌面版

https://forum.koishi.xyz/t/topic/283

提问需提供四项信息是什么?&用户群群规

https://forum.koishi.xyz/t/topic/555

如何查看自己的平台名与用户 ID

koishi镜像一览

Koishi 镜像一览

常见问题

新系统/服务器无法启动安装koishi(Windows server 2022安装koishi desktop失败)

相关帖子:
https://forum.koishi.xyz/t/topic/5254

如何在电脑关机后还运行机器人

https://forum.koishi.xyz/t/topic/5254

无法连接到插件市场

https://forum.koishi.xyz/t/topic/3067

插件市场无法连接

相关帖子:https://forum.koishi.xyz/t/topic/5071

t4佬的插件市场镜像:关于一个插件市场的镜像
koishi镜像一览:https://forum.koishi.xyz/t/topic/6052#koishi-13

小火箭一键更新出现问题

相关帖子:https://forum.koishi.xyz/t/topic/829/3

通用解决方案——重装(双清):彻底卸载/清理/删除/初始化/重置 Koishi

更新到market2发生问题

相关帖子:升级至 market2 后无法无法配置插件的解决方案
相关帖子2:Koishi 控制台持续更新贴 - #19,来自 shigma
相关帖子3:早期小火箭一键更新到 4.13.7 后出现 Not Found 的解决方案

安装完插件后很秃然控制台炸了

在koishi.yml文件内找到你安装插件的那部分,给插件名称前面加上一个~,重启koishi。

koishi.yml位置:「Koishi 配置文件」的位置

ps:感觉日常更新插件是好的,长时间好几个版本不更新一下更新的话可能大概率会出控制台白屏什么的问题

如何备份koishi

备份koishi.yml,data文件夹,以及package.json

如何还原备份

重新安装koishi,将备份的文件放置到此koishi中对应的位置。在数据文件夹中跑一次yarn?)

如何修改/添加权限

相关文档:深入定制机器人 | Koishi

及其操作图文教学?:https://forum.koishi.xyz/t/topic/2034/5

相关帖子:https://forum.koishi.xyz/t/topic/6001/4

接入qq后,机器人无法收到指令

艾特机器人,后加上命令,再发送。

https://forum.koishi.xyz/t/topic/810/10

更换账号后,机器人无响应/bot仅私聊响应

https://forum.koishi.xyz/t/topic/501

你有个问题想要反馈给作者/如何找到作者

找到作者,并且发送信息给他!
或者去github发issue!
相关帖子:https://forum.koishi.xyz/t/topic/2721

改变默认终端 隐藏控制台

https://forum.koishi.xyz/t/topic/6143

Ubuntu的snap下安装chromium引发的koishi-plugin-puppeteer提示未找到index.html

https://forum.koishi.xyz/t/topic/5837/10

安装插件时显示安装失败

https://forum.koishi.xyz/t/topic/292

论坛相关

论坛如何精准跳转

https://forum.koishi.xyz/t/topic/1536

blockly教程

blockly教程征集帖

https://forum.koishi.xyz/t/topic/2120

其他

t4佬的插件镜像源众筹

[众筹] 插件市场镜像流量费用

7 个赞

我觉得这应该变成一个wiki)

4 个赞

wiki 和 toc 都可以上

3 个赞

有趣 帖子&网站 大赏

3 个赞

‎‎‎‎‎‎‎‎

3 个赞

(让我想想还有啥能整理的)))xx

3 个赞

所以这个帖子可以改 wiki 吗,wiki 任何人都可以编辑,更方便

帖子右下角有「…」按钮,里面有「成为 wiki」

4 个赞

唔soda!是这样姆!

4 个赞

重新更新整理了一下
好像这个帖子会沉,不给推送主页了()

4 个赞

顶一个!

2 个赞

wwww!

3 个赞

感谢狐莉莉!

2 个赞