report.md

报告问题的正确姿势

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

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

遇到问题后的第一反应

DON'T PANIC.

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

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

如果你确定不是你自己的问题，并且你遇到的问题并未列举在 FAQ 中，你可以着手准备报告问题了。

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

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

:::

运营团队，或是帮助你的人，并不是神

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

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

不管是谁，不可能通过你们的只言片语快速定位你的问题！

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

我应该提供哪些信息？

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

报错截图

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

复现步骤

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

日志

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

::: warning

考虑到版本隔离，部分日志将会提供两个路径方便查找。

版本隔离路径的 {version} 是你的 Minecraft 版本号，实际路径不需要带大括号。

:::

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

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

我该去哪里提问？

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