From 860848a3104f4059bcb7edb3cb30129769fcd28c Mon Sep 17 00:00:00 2001
From: DrSmoothl <1787882683@qq.com>
Date: Fri, 26 Jun 2026 17:01:42 +0800
Subject: [PATCH] feat(issue-template): require TRACE-level logs in bug reports
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Make the logs textarea required so a bug report can't be submitted empty.
- Document how to enable TRACE: WebUI server log-level switch (+ '开发'
  preset so the export actually contains trace lines) or SNOWLUMA_LOG_LEVEL=trace.
- Add a required preflight checkbox attesting TRACE logs are attached.
---
 .github/ISSUE_TEMPLATE/bug_report.yml | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index 6935ee6b..8a5faf78 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -18,6 +18,8 @@ body:
           required: true
         - label: 我使用的是 [最新 Release](https://github.com/SnowLuma/SnowLuma/releases) 或当前 `dev` 分支构建
           required: true
+        - label: 我已将日志级别调到 TRACE，并在下方「TRACE 日志」一栏附上了复现期间的完整日志
+          required: true
 
   - type: input
     id: snowluma-version
@@ -119,11 +121,21 @@ body:
   - type: textarea
     id: logs
     attributes:
-      label: 相关日志 / 错误堆栈
+      label: TRACE 日志 / 错误堆栈
       description: |
-        粘贴控制台日志、SSE 实时日志或错误堆栈。
-        请注意脱敏：移除 access token、账号密码、私聊内容等敏感信息。
+        **必须提供 TRACE 级别日志**，否则我们几乎无法定位问题。SnowLuma 默认日志级别是 `info`，TRACE 不会输出，请务必先开启再复现。
+
+        开启 TRACE 的两种方式（任选其一）：
+        - **WebUI（推荐）**：进入「日志」页 →「服务端日志级别」切到 `TRACE` → 显示过滤切到「开发」预设（确保 TRACE 行可见，否则导出不含 trace）→ 复现问题 → 点「导出当前视图」得到 `snowluma-logs-*.log`，拖到本输入框上传。
+        - **环境变量**：启动前设置 `SNOWLUMA_LOG_LEVEL=trace` 再运行，复现后复制控制台输出。
+
+        贴出的日志里应当能看到 `TRACE` 字样。请注意脱敏：移除 access token、账号密码、私聊内容等敏感信息。
+      placeholder: |
+        [2026-06-26 12:00:00.000] TRACE [core] ...
+        [2026-06-26 12:00:00.001] DEBUG [bridge] ...
       render: shell
+    validations:
+      required: true
 
   - type: textarea
     id: extra