TanTan
fa9c73363d
Dev Build / cleanup (push) Waiting to run
Dev Build / typecheck (push) Waiting to run
Publish MCP to npm / Build, test, and publish MCP (push) Waiting to run
Publish SDK to npm / Build, test, and publish SDK (push) Waiting to run
Sync action catalog to docs / sync (push) Waiting to run
Publish UI to npm / Build and publish UI (push) Waiting to run
Build and Release / preflight (push) Waiting to run
145 lines
4.3 KiB
YAML
145 lines
4.3 KiB
YAML
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 链接等
|