From 8691fea12dd7d291340795bdf79866513e1c769c Mon Sep 17 00:00:00 2001
From: aiyezi <424161078@qq.com>
Date: Wed, 28 Oct 2026 15:40:32 +0800
Subject: [PATCH] build: add issue templates

---
 .gitea/ISSUE_TEMPLATE/bug_report.yaml      | 59 ++++++++++++++++++++++
 .gitea/ISSUE_TEMPLATE/feature_request.yaml | 42 +++++++++++++++
 2 files changed, 101 insertions(+)
 create mode 100644 .gitea/ISSUE_TEMPLATE/bug_report.yaml
 create mode 100644 .gitea/ISSUE_TEMPLATE/feature_request.yaml

diff --git a/.gitea/ISSUE_TEMPLATE/bug_report.yaml b/.gitea/ISSUE_TEMPLATE/bug_report.yaml
new file mode 100644
index 0000000..4c3411f
--- /dev/null
+++ b/.gitea/ISSUE_TEMPLATE/bug_report.yaml
@@ -0,0 +1,59 @@
+name: "Bug 报告 (Bug Report)"
+description: "提交系统运行中出现的异常、错误或崩溃"
+title: "[Bug]: "
+labels:
+  - "kind/bug"
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢提交 Bug！为了快速定位问题，请尽可能详细填写以下信息。
+
+  - type: input
+    id: environment
+    attributes:
+      label: "运行环境 / 版本"
+      description: "例如：系统版本 (Linux/macOS/Windows)、软件版本、Docker 镜像 tag 或 Commit ID"
+      placeholder: "e.g., Linux 6.6 / v1.2.0 / Docker"
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction_steps
+    attributes:
+      label: "复现步骤"
+      description: "清晰列出触发该问题的最小复现步骤"
+      placeholder: |
+        1. 执行命令 `...` 或访问页面 `...`
+        2. 点击或配置 `...`
+        3. 触发异常
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected_vs_actual
+    attributes:
+      label: "期望行为 vs 实际行为"
+      description: "描述你期望得到的结果，以及实际发生了什么"
+      placeholder: |
+        - 期望结果：
+        - 实际结果：
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: "日志与错误堆栈 (Logs / Trace)"
+      description: "附上相关终端输出、后端日志或浏览器 Console 报错"
+      render: shell
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: "确认清单"
+      options:
+        - label: "我已在现有 Issue / Commit 记录中搜索过，确认没有重复报告"
+          required: true
+        - label: "该问题在最新版本/主分支上依然可以复现"
+          required: false
diff --git a/.gitea/ISSUE_TEMPLATE/feature_request.yaml b/.gitea/ISSUE_TEMPLATE/feature_request.yaml
new file mode 100644
index 0000000..9e44255
--- /dev/null
+++ b/.gitea/ISSUE_TEMPLATE/feature_request.yaml
@@ -0,0 +1,42 @@
+name: "功能建议 (Feature Request)"
+description: "提出新功能设想、架构优化或现有体验改进"
+title: "[Feature]: "
+labels:
+  - "kind/feature"
+body:
+  - type: textarea
+    id: problem_statement
+    attributes:
+      label: "背景与现状痛点"
+      description: "请描述当前的局限性，或者你遇到了什么具体场景需要此功能"
+      placeholder: "在进行某项操作时，当前缺少了……导致……"
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposed_solution
+    attributes:
+      label: "期望的解决方案"
+      description: "清晰阐述你希望新增的 API、CLI 命令、配置项或 UI 行为"
+      placeholder: "建议增加参数 `--xxx` 或新增配置字段……"
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: "替代方案或临时融通方法"
+      description: "是否考虑过或尝试过现有的替代手段？"
+    validations:
+      required: false
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: "紧迫程度"
+      options:
+        - "Nice to have (优化项，有则更好)"
+        - "Important (重要，能显著提升开发或使用效率)"
+        - "Critical (关键阻断，缺失此功能将无法推进后续流程)"
+    validations:
+      required: true