name: Bug 反馈
description: 报告一个可复现的问题
title: "[Bug] "
labels: ["bug"]
body:
  - type: markdown
    attributes:
      value: |
        感谢花时间反馈 Bug。请尽量填全以下信息，方便我们定位问题。
        在提交前，请先在 [Issues](https://github.com/SnowLuma/SnowLuma/issues?q=is%3Aissue) 中搜索是否已有相同问题。

  - type: checkboxes
    id: preflight
    attributes:
      label: 提交前检查
      options:
        - label: 我已搜索过 Issues，确认没有重复的反馈
          required: true
        - label: 我使用的是 [最新 Release](https://github.com/SnowLuma/SnowLuma/releases) 或当前 `dev` 分支构建
          required: true
        - label: 我已将日志级别调到 TRACE，并在下方「TRACE 日志」一栏附上了复现期间的完整日志
          required: true

  - type: input
    id: snowluma-version
    attributes:
      label: SnowLuma 版本
      description: 启动日志首行或 `package.json` 里的版本号
      placeholder: "例如 1.10.2"
    validations:
      required: true

  - type: dropdown
    id: adapter
    attributes:
      label: 出问题的适配器
      description: 可多选
      multiple: true
      options:
        - WebSocket Server
        - WebSocket Client
        - HTTP Server
        - HTTP Post
        - WebUI
        - Bridge / Core(协议层)
        - 其他 / 不确定
    validations:
      required: true

  - type: input
    id: os
    attributes:
      label: 操作系统
      placeholder: "例如 Windows 11 23H2 / macOS 14.5 / Ubuntu 22.04"
    validations:
      required: true

  - type: dropdown
    id: deploy
    attributes:
      label: 部署方式
      description: 如何运行 SnowLuma
      options:
        - 源码运行（pnpm dev / start）
        - 预构建包
        - Docker
        - 其他 / 不确定
    validations:
      required: true

  - type: input
    id: node-version
    attributes:
      label: Node.js 版本
      description: '`node -v` 的输出。如果使用预构建包可填"预构建包"'
      placeholder: "例如 v20.11.0 或 预构建包"
    validations:
      required: true

  - type: input
    id: qq-version
    attributes:
      label: QQ 客户端版本
      description: QQ NT 客户端的版本号
      placeholder: "例如 9.9.15-29722"

  - type: textarea
    id: description
    attributes:
      label: 问题描述
      description: 简要说明发生了什么
    validations:
      required: true

  - type: textarea
    id: reproduce
    attributes:
      label: 复现步骤
      description: 详细列出如何触发这个问题
      placeholder: |
        1. 启动 SnowLuma 并登录账号 ...
        2. 通过 HTTP Server 调用 `send_group_msg` ...
        3. 观察到 ...
    validations:
      required: true

  - type: textarea
    id: expected
    attributes:
      label: 期望行为
    validations:
      required: true

  - type: textarea
    id: actual
    attributes:
      label: 实际行为
    validations:
      required: true

  - type: textarea
    id: logs
    attributes:
      label: TRACE 日志 / 错误堆栈
      description: |
        **必须提供 TRACE 级别日志**，否则我们几乎无法定位问题。SnowLuma 默认日志级别是 `info`，TRACE 不会输出，请务必先开启再复现，务必保留原始报文和完整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
    attributes:
      label: 补充信息
      description: 配置片段（脱敏后）、截图、相关 Issue / PR 链接等