From f32c52867f02f2558a3c7023bb2e855c0173c983 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E4=B8=A5=E6=B5=A9?= <me@yanhao.ren>
Date: Tue, 1 Apr 2025 15:28:35 +0800
Subject: [PATCH] =?UTF-8?q?fix:=20=E6=9B=B4=E6=96=B0=E4=BB=A3=E7=A0=81?=
 =?UTF-8?q?=E6=B3=A8=E9=87=8A=E8=A7=84=E8=8C=83=EF=BC=8C=E5=BC=BA=E8=B0=83?=
 =?UTF-8?q?=E6=B3=A8=E9=87=8A=E5=BA=94=E8=A7=A3=E9=87=8A=E5=A4=8D=E6=9D=82?=
 =?UTF-8?q?=E9=80=BB=E8=BE=91=E8=80=8C=E9=9D=9E=E9=87=8D=E5=A4=8D=E4=BB=A3?=
 =?UTF-8?q?=E7=A0=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/copilot-instructions.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
index 1e13659..6a2a52f 100644
--- a/.github/copilot-instructions.md
+++ b/.github/copilot-instructions.md
@@ -11,7 +11,7 @@ This document outlines the core technical choices, coding conventions, and confi
     1.  `<script setup lang="ts">` (Imports, logic, composables, etc.)
     2.  `<template>` (HTML structure)
     3.  `<style>` (Preferably `<style scoped>`)
-*   **Code Comments:** All comments within the codebase **must be written in Chinese**. (代码中的所有注释**必须使用中文**。)
+*   **Code Comments:** All comments within the codebase **must be written in Chinese**. (代码中的所有注释**必须使用中文**。) **注释应解释代码的“为什么”或复杂逻辑，而不是解释“是什么”或重复代码/配置本身。**
 
 ## 📦 UI Libraries & Components
 
@@ -21,6 +21,7 @@ This document outlines the core technical choices, coding conventions, and confi
     *   **PrimeVue:** Use components directly with their standard names (e.g., `<Button>`, `<InputText>`, `<DataTable>`).
     *   **Custom Components:** Local components (e.g., `<MyCustomComponent />` defined in `src/components/MyCustomComponent.vue`) should be used directly in templates without explicit imports in `<script setup>`.
 *   **Custom Icons:** Custom SVG icons are available via `unplugin-icons` with the prefix `icon-`. Usage: `<icon-your-svg-file-name />`.
+*   **No Auto-Import Comments for Components:** When using auto-imported components (UI libraries, local components), **do not** add comments indicating they are auto-imported. Assume this behavior is known.
 
 ## ✨ API Auto-Import (unplugin-auto-import)
 
@@ -34,14 +35,16 @@ This document outlines the core technical choices, coding conventions, and confi
 *   **Auto-Imported Directories:** All exports from files within `src/stores/**` and `src/utils/**` are also auto-imported globally. Functions, variables, or stores defined and exported in these directories can be used directly without explicit import statements.
 *   **Template Usage:** Auto-import functionality also applies within the `<template>` block where appropriate (e.g., accessing store state or using certain utility functions directly).
 *   **Important:** Rely on the auto-import mechanism for the specified libraries and directories. Explicitly importing these APIs clutters the code unnecessarily.
+*   **No Auto-Import Explanation Comments:** When using auto-imported APIs (from libraries like Vue, Pinia, VueUse, or custom directories like `src/utils`, `src/stores`), simply use them directly. **Absolutely avoid adding comments that merely state an item is auto-imported** (e.g., DO NOT add comments like "// xxx is auto-imported from src/utils"). Focus comments on explaining complex logic or intent.
 
 ## ✅ Summary of Key Rules & Conventions
 
 *   **Always** use `<script setup lang="ts">`.
 *   Composition API is the **only** accepted style.
-*   Code comments **must be in Chinese**.
+*   Code comments **must be in Chinese** and explain **why/how**, not what or the build system.
 *   Vue 3 Composition API, Pinia, Vue Router (auto), VueUse functions, `consola`, and exports from `src/stores` & `src/utils` are globally available via auto-import; **do not** import them explicitly.
 *   Ant Design Vue, PrimeVue, and local `src/components` components are auto-imported; use them directly in templates without explicit imports.
+*   **Crucially: Do not add comments solely to explain that an API or component is auto-imported.** Trust the auto-import setup.
 *   Use custom SVG icons via the `<icon-name />` syntax.
 *   Maintain the specified SFC structure: `<script setup>`, `<template>`, `<style>`.