report.md

报告问题的正确姿势

任何事物都不可能尽善尽美，LittleSkin 也是如此。

如果你在使用 LittleSkin 的过程中遇到了任何问题（包括但不限于材质无法显示、网站出现 Bug 等），不要气急败坏，请充分理解下述内容后正确提问。

遇到问题后的第一反应

DON'T PANIC.

首先，你应该先检查一下是不是你的问题。大部分情况下，LittleSkin 是可以正常运行的。如果你遇到了错误，请先确定这是不是你自己的锅：网络错误、操作错误、甚至是你自己的浏览器出问题都可能导致你无法正常使用 LittleSkin。所以，在提问之前，请先以自己的经验判断一下，这是不是你的问题。

其次，你应该先阅读一遍 常见问题解答。很多情况下你遇到的问题也曾经困扰过很多人，并且已经被总结出了解决方案。这种情况下，直接查阅 FAQ 能更快地解决你的问题。

如果你确定你没有问题，并且你遇到的问题不在 FAQ 中，你可以着手准备报告问题了。

:::tip 推荐阅读：《提问的智慧》

充分理解这篇文章可以帮助你更好地提问并更快地收到回复和正确的解答（不论何时何地）。但请注意，《提问的智慧》的创作团队仅是提供这一篇文章来指导你如何正确提问，他们并不提供针对任何问题的任何技术支持。不要做白痴。 :::

运营团队不是神

看起来你们大多数人好像都不知道的样子？

那就让我们来告诉你们一个真理吧：

运营团队是无法通过你们的只言片语来定位问题的！

所以，报告问题时不要丢下一句「皮肤站出错了」、「无法加载皮肤」就跑，在没有日志、报错截图等信息的辅助下，我们 不可能 知道网线对面的你遇到了什么。

我应该提供哪些信息？

可能需要视情况而定。这里列举几个通用的：

报错截图

如果是 LittleSkin 网站的问题，发生错误时，网站应该会给出相应的提示。请把相关的提示乃至整个页面截图，并在提问时提供。

复现步骤

许多问题只会在特定的操作下出现。提供复现步骤可以让站点管理员了解你的问题是在何种操作下出现的，并快速定位问题所在和解决问题。

日志

各种日志是侦错时不可缺少的信息，所以如果有，提问时请带上这些日志：

• 如果是游戏内材质无法显示，请提供皮肤 Mod 的日志：
  • CustomSkinLoader 的日志位于 .minecraft/CustomSkinLoader/CustomSkinLoader.log
• 如果是 Yggdrasil 外置登录的问题，请在添加 JVM 参数 -Dauthlibinjector.debug=all 并复现问题后，提供以下日志：
  • 服务端从开始到出错的所有日志（最后一次运行服务端生成的日志位于 logs/latest.log）
  • 客户端游戏从开始到出错的所有日志（最后一次游戏生成的日志位于 .minecraft/logs/latest.log）
    • 如果有，请优先使用启动器的「测试游戏」功能导出的日志
  • 服务端和客户端的 authlib-injector 日志（最后一次生成的日志位于游戏目录下的 authlib-injector.log）
  • 启动器日志（请咨询启动器作者以获取日志位置）

提供日志时，请直接发送日志文件，而不是提供日志截图。如果没有这些日志，请在提问时说明清楚；如果你提问后被要求提供更多信息，请提供我们要求的信息以帮助我们查找问题。

我该去哪里提问？

你可以加入我们的 官方用户交流群 来提问，也可以 通过邮件发送工单。

::: warning 在官方用户交流群内提问时，请直接在群内发言，不要随意私聊站点管理员或其他用户。大多数人都不喜欢被不熟悉的人突然打扰，这会让人感到冒犯和困扰。 :::