docs(github): add issue templates for bug, crash and suggest

Add YAML issue forms under .github/ISSUE_TEMPLATE/ with required fields for bug reports (behavior, repro, expected fix), crashes (log, repro) and suggestions. Disable blank issues via config.yml to force template usage. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-23 06:48:12 +08:00
parent 0a50ed3e1c
commit fe1fdea994
4 changed files with 115 additions and 0 deletions
@@ -0,0 +1,58 @@
+name: 功能异常 (Bug)
+description: 提交一个功能不按预期工作的问题
+title: "[Bug] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢你抽出时间反馈 Bug。请尽量详细地填写以下内容,以便我们快速定位与修复。
+
+  - type: textarea
+    id: behavior
+    attributes:
+      label: Bug 表现
+      description: 实际发生了什么?与预期有何不同?
+      placeholder: 例如:点击 ClickGUI 中的 KillAura 按钮后,模块未被启用,且控制台无任何输出。
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: 说明
+      description: 关于该问题的补充说明、上下文、你认为可能的原因等。
+      placeholder: 例如:仅在切换世界后第一次启用模块时出现,重启游戏后正常。
+    validations:
+      required: true
+
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: 截图
+      description: 请粘贴或拖入相关截图 / 录屏。若涉及 UI 错位,务必附图。
+      placeholder: 直接将图片拖到此处即可上传。
+    validations:
+      required: false
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: 复现步骤
+      description: 请提供清晰、可被他人按步骤复现的操作流程。
+      placeholder: |
+        1. 启动客户端并进入任意服务器
+        2. 打开 ClickGUI (默认 RShift)
+        3. 点击 Combat -> KillAura
+        4. 观察到 ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-fix
+    attributes:
+      label: 应当被如何修复
+      description: 你认为这个问题应该怎样被修复?如果有相关代码位置 / 思路也请一并写出。
+      placeholder: 例如:`ModuleManager#toggle` 中似乎未触发 `onEnable` 回调,应在切换状态后调用对应的生命周期方法。
+    validations:
+      required: true
@@ -0,0 +1 @@
+blank_issues_enabled: false
@@ -0,0 +1,38 @@
+name: 崩溃 (Crash)
+description: 提交一个导致客户端 / 游戏崩溃的问题
+title: "[Crash] "
+labels: ["crash"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢你反馈崩溃问题。**请务必附上完整的崩溃日志**,缺失日志的崩溃 issue 几乎无法被定位。
+
+  - type: textarea
+    id: log
+    attributes:
+      label: 日志
+      description: |
+        请粘贴完整的崩溃日志 (crash-report) 或 `logs/latest.log` 中的相关片段。
+        若日志过长,推荐使用 GitHub Gist / [mclo.gs](https://mclo.gs) 上传后贴出链接。
+      placeholder: |
+        ```
+        ---- Minecraft Crash Report ----
+        // ...
+        ```
+      render: text
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: 复现步骤
+      description: 触发崩溃所需的操作步骤。越具体越好,包括是否是必现、概率多大。
+      placeholder: |
+        1. 进入单人世界
+        2. 启用 Scaffold 模块
+        3. 持续向前移动约 5 秒
+        4. 客户端崩溃 (100% 复现)
+    validations:
+      required: true
@@ -0,0 +1,18 @@
+name: 建议 (Suggest)
+description: 提出一个新功能、改进或想法
+title: "[Suggest] "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢你的建议!请尽量清晰地描述你希望看到的改动以及它的价值。
+
+  - type: textarea
+    id: suggestion
+    attributes:
+      label: 建议内容
+      description: 你希望增加 / 修改什么功能?它解决了什么问题?
+      placeholder: 例如:希望 ClickGUI 支持配置面板宽度,目前在 1080p 下默认宽度过窄。
+    validations:
+      required: true