From 503551ddec0eaeb5868466668411a06c6865420d Mon Sep 17 00:00:00 2001
From: Reid <61492567+reidliu41@users.noreply.github.com>
Date: Wed, 13 May 2026 04:37:11 +0800
Subject: [PATCH]   docs: improve issue templates (#1525)

Add clearer prompts to bug reports and feature requests so users provide
  reproduction details, impact, environment context, use cases, and supporting
  materials up front.
---
 .github/ISSUE_TEMPLATE/bug_report.md      | 26 ++++++++++++++++++++---
 .github/ISSUE_TEMPLATE/feature_request.md | 15 +++++++++++++
 2 files changed, 38 insertions(+), 3 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index b27cef23..6a0290ae 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -1,13 +1,17 @@
 ---
 name: Bug report
-about: Report a problem or regression
+about: Report a reproducible problem or regression
 labels: bug
 ---
 
 ## Description
 
+<!-- What happened? Please keep this focused on one bug. -->
+
 ## Steps to reproduce
 
+<!-- Include exact commands, config, or key presses when relevant. -->
+
 1.
 2.
 3.
@@ -16,12 +20,28 @@ labels: bug
 
 ## Actual behavior
 
+## Impact
+
+<!-- How often does this happen, and how much does it block your workflow? -->
+
 ## Environment
 
 - OS:
 - DeepSeek CLI version:
-- Model:
+- Install method:
+- Model/provider:
+- Terminal app:
 - Shell:
 
-## Logs or screenshots
+<!-- Hints:
+OS: Windows 11 / Ubuntu 22.04 / macOS 14
+DeepSeek CLI version: run `deepseek --version`
+Install method: cargo install / release binary / source build
+Model/provider: deepseek-v4-pro / DeepSeek, or qwen2.5-coder / Ollama
+Terminal app: iTerm2 / Windows Terminal / GNOME Terminal / VS Code terminal
+Shell: bash / zsh / fish / PowerShell
+-->
 
+## Logs, screenshots, or recordings
+
+<!-- Add logs, screenshots, config snippets, a short screen recording, or whether this also happens with --no-alt-screen. -->
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
index a20089f9..f9cfc542 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.md
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -6,9 +6,24 @@ labels: enhancement
 
 ## Problem
 
+<!-- What problem are you trying to solve? Who is affected? -->
+
 ## Proposed solution
 
+<!-- What should DeepSeek TUI do differently? Include commands, UI behavior, or config shape if relevant. -->
+
+## Use case
+
+<!-- Describe when you would use this and why the current workflow is not enough. -->
+
 ## Alternatives considered
 
+<!-- What workarounds or other approaches have you tried? -->
+
+## Impact
+
+<!-- How often would you use this, and how much would it improve your workflow? -->
+
 ## Additional context
 
+<!-- Add screenshots, mockups, examples from other tools, links, or config snippets if helpful. -->