From c829eaaf710d7cdeded6dd779ab702bf29f54978 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 16:15:39 +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=E5=92=8C=E8=AE=BE=E8=AE=A1=E6=84=8F=E5=9B=BE?=
 =?UTF-8?q?=EF=BC=8C=E8=80=8C=E9=9D=9E=E9=87=8D=E5=A4=8D=E4=BB=A3=E7=A0=81?=
 =?UTF-8?q?=E6=88=96=E6=8F=8F=E8=BF=B0=E4=BD=8D=E7=BD=AE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
index 6a2a52f..dc0dc71 100644
--- a/.github/copilot-instructions.md
+++ b/.github/copilot-instructions.md
@@ -11,7 +11,10 @@ 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**. (代码中的所有注释**必须使用中文**。)
+    *   **注释应解释代码的“为什么”（设计意图、选择某方案的原因）或复杂逻辑/算法的“如何”，而不是解释“是什么”（重复代码功能）或“在哪里”（描述定义位置）。**
+    *   **严禁添加仅说明代码被移动、重构或提取到其他文件的注释。** 例如，避免 `// XxxState 接口已移至 types.ts` 或 `// 提取为 useXYZ composable` 这样的注释。依赖代码结构、类型系统和 IDE 功能（如 Go To Definition）来理解这些信息，而不是通过注释。Focus comments on the *logic* itself, not its location or history.
 
 ## 📦 UI Libraries & Components
 
@@ -21,7 +24,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.
+*   **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. Trust the tooling.
 
 ## ✨ API Auto-Import (unplugin-auto-import)
 
@@ -41,13 +44,9 @@ This document outlines the core technical choices, coding conventions, and confi
 
 *   **Always** use `<script setup lang="ts">`.
 *   Composition API is the **only** accepted style.
-*   Code comments **must be in Chinese** and explain **why/how**, not what or the build system.
+*   Code comments **must be in Chinese** and explain **why/how (logic, intent)**, **strictly avoiding** comments that explain **what (code repetition), where (definition location), refactoring history, or auto-import mechanisms.**
 *   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.
+*   **Crucially: Do not add comments solely to explain that an API or component is auto-imported OR where code has been moved/refactored.** Trust the auto-import setup and IDE navigation.
 *   Use custom SVG icons via the `<icon-name />` syntax.
 *   Maintain the specified SFC structure: `<script setup>`, `<template>`, `<style>`.
-
----
-
-*(Further details regarding state management patterns, routing configuration, specific linting rules, testing setup, or detailed coding style guides can be added to this document as needed.)*
\ No newline at end of file