SnowLuma v2.4.2 source snapshot

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,144 @@
+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 链接等

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: QQ 群
+    url: https://qm.qq.com/q/g3UMLpWALe
+    about: 日常使用问题、快速交流可以先来 QQ 群
+  - name: Telegram
+    url: https://t.me/napcatqq
+    about: 海外用户交流频道
+  - name: Releases
+    url: https://github.com/SnowLuma/SnowLuma/releases
+    about: 在反馈 Bug 前，请先确认已使用最新发布版本

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,78 @@
+name: 功能请求
+description: 提议一个新功能或对现有功能的增强
+title: "[Feature] "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢您的建议。在提交前，请先在 [Issues](https://github.com/SnowLuma/SnowLuma/issues?q=is%3Aissue) 中搜索是否已有类似提案。
+
+  - type: checkboxes
+    id: preflight
+    attributes:
+      label: 提交前检查
+      options:
+        - label: 我已搜索过 Issues，确认没有重复的提案
+          required: true
+
+  - type: dropdown
+    id: scope
+    attributes:
+      label: 涉及范围
+      multiple: true
+      options:
+        - OneBot 协议 / 消息段
+        - WebSocket Server / Client 适配器
+        - HTTP Server / Post 适配器
+        - WebUI 管理面板
+        - SDK (`@snowluma/sdk`)
+        - UI 组件 (`@snowluma/ui`)
+        - Bridge / Core(协议层)
+        - 构建 / 发布流程
+        - 文档
+        - 其他
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: 需求场景 / 当前痛点
+      description: 这个功能要解决什么问题？目前是如何变通处理的？
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: 期望方案
+      description: 您希望它如何工作？如果是 API 改动，建议给出示例输入 / 输出
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 已考虑的替代方案
+      description: 还想过哪些其他实现路径，为什么放弃
+
+  - type: textarea
+    id: references
+    attributes:
+      label: 参考链接
+      description: 例如 OneBot 规范条目、其他实现的对应特性、相关 Issue / PR
+      placeholder: |
+        - OneBot v11 规范: https://github.com/botuniverse/onebot-11/...
+        - 相关讨论: #xxx
+
+  - type: dropdown
+    id: willingness
+    attributes:
+      label: 您是否愿意提交 PR 来实现这个功能？
+      options:
+        - 愿意，但需要维护者讨论方案后再动手
+        - 愿意，已有大致实现思路
+        - 暂时只提建议
+    validations:
+      required: true