请务必在提问/提需求之前一条一条看完本文章!花费五到十分钟,这很可能帮你剩下数个小时的时间,并避免被管理员警告或踢出群聊的风险!
[本文章还在持续更新,最后更新:2023/3/24]
在你提问之前,你应该先:
- 资料! 检查和搜索论坛、文档,确保文档和论坛中没有该问题的回答或解决方案
- 搜索! STFW(Search the fxxking Web),使用Google/百度/ChatGPT检索你的问题,也许你的问题不是Koishi本身的问题
在你提问中:
- 如何提问?
-
场合! 不是任何场合都能进行提问!
- 帖子! 尽量使用Koishi论坛或者Github Issue进行提问和问题、新特性反馈,他们都是以帖子的形式呈现的。这有利于后来的解答者对你的问题给出更详细的解答,而不会干扰群内其他聊天或者被群内其他聊天干扰,也能方便后来者能找到你的问题并轻松解决
- 级别! 你需要注意你提问的地方是否适合你的问题(如尽量不要在用户群讨论技术问题,不要在开发群讨论用户问题),因为如果你的地方不合适,解答者可能对你的印象不同!比如你在开发群讨论用户问题,很可能解答者认为你已经具备了基本的开发常识,因此回答出你看不懂的内容
- 重复! 尽量不要一个帖子/问题重复提问,特别是当有人解答你的问题之后还重复提问!这有可能被重复解答,也可能被视为发送垃圾信息而被警告或移除
-
描述! 请准确描述问题!
- XY! 在写下问题之前,先确保自己想提出的问题不是XY问题(XY问题指的是你原本想问X,但因为你认为Y是解决X的最佳方案,因此在群内只问Y而只字不提X)。XY问题很可能浪费解答者的大量时间来弄清你的大需求(X问题),或者给出一个在X条件下无法使用的解答!因此如果你认为某种方案是解决该问题的最佳方案,最好的方法是先问X然后提出自己的看法Y!
-
标题!使用准确的标题是准确描述问题的第一步!优秀的标题需要一针见血地指出你遇到了什么问题!这不仅是方便后来者能准确地在论坛中搜索到问题,也是给你问题的回答者一个明确的问题导向,使得你的问题能更快地解决。以下是一些优秀的和不准确的标题的例子。请务必不要写出和下列"非常不准确的标题"一样的标题,这可能会使得你的问题无人解答!
- 比较优秀的标题
- Koishi在启动后报错Uncaught Error: Cannot read properties of undefined
- XXXX插件指令执行后无反应,控制台显示"Axios Error:500"
- Koishi安装时出现“该Windows Installer 软件包xxxxxxx“
- Blocky能实现@全体成员功能吗
- 不太准确的标题
-
各位大佬好,可以告诉我Blockly指令后面的空格如何取消 - dialogue插件突然失灵,日志无信息,cq不往日志输出信息~~,不知道咋解决~~
-
怎样才能做到让人机对同一消息次数不同时有相应的不同回答(缺少关键信息"Blockly",修改为:让Blockly对同一消息次数不同时有相应的不同回答) - 人人图画审核插件是不是没用了(缺少错误日志描述,正确修改:人人图画审核插件失效,报错"service component:censor has been registered")
-
- 非常不准确的标题
- 救命!大佬帮我看看这个插件怎么回事(没有有效信息)
- Koishi安装失败(没有有效信息)
- 机器人没反应了,怎么回事啊(没有有效信息)
- 比较优秀的标题
-
内容! 准确地描述你的问题内容准确且内容丰富,可以使你获得正确解答的速度成倍提升,因为解答者不需要或者很少追问其他问题。
-
准确! 在社区提问和你写作文一样,你要尽量把你想表达的内容在尽可能多的情况下尽量减少表述,一个准确的问题提问应该包含以下几个内容中的一部分(如果你不知道要不要包含那就包含进去)
- 上下文,包括你的系统版本,Koishi版本,开启了哪些插件
- 过程,包括出现问题前一段时间(不是最后一个,而是出现前一段时间!)的操作、日志、聊天平台截图
- 详细! 提供尽可能多的信息给解答者,也许你认为他可能用不上。 很多人认为”日志没有报错“就没有提供的意义,但实际上日志不仅包括了程序出现异常时的内容,他也包含了正常情况下的流程检查。因此请在提问时给解答者尽可能多的信息
- 格式! 提供格式清楚的信息!这有利于解答者解决你的问题!比如尽量避免使用拍屏等方式提供错误信息,正确的做法是截图或复制粘贴,对于比较长的信息请使用PasteBin或者群文件
-
准确! 在社区提问和你写作文一样,你要尽量把你想表达的内容在尽可能多的情况下尽量减少表述,一个准确的问题提问应该包含以下几个内容中的一部分(如果你不知道要不要包含那就包含进去)
-
场合! 不是任何场合都能进行提问!
- 提问应该有的态度
- 诚恳! Koishi是开源社区,只要你没有向开发者/解答者支付报酬,他们是没有义务进行帮助你的。因此请不要以过高的姿态进行提问,否则不仅可能没有人解答你的问题还可能被大家看笑话
- 感谢! 多感谢解答你问题或者帮助你的人
- 尝试! 在提问的同时,你也应该自己尝试解决这个问题。