npm - @dtt_siye/atool - Versions diffs - 1.1.0 - Mend

@dtt_siye/atool 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (463) hide show

package/skills/project-analyze/rules/web-nextjs.md ADDED Viewed

@@ -0,0 +1,364 @@
+# Next.js 项目分析规则（栈特定）
+Next.js 项目专属分析规则，与 `rules/web.md` 配合使用。本文件中的规则优先于 `web.md` 中的同名字段。适用于 Next.js 13+（App Router）和 Next.js 12-（Pages Router）。
+## 分析粒度
+Next.js 项目按 App Router / Pages Router 路由结构 + Server/Client 组件 + API Routes 分层分析：
+```
+Next.js 应用结构
+    ├── App Router（推荐，Next.js 13+）
+    │   ├── app/layout.tsx（根布局）
+    │   ├── app/page.tsx（首页）
+    │   ├── app/[动态路由]/
+    │   ├── app/api/（Route Handlers）
+    │   ├── app/(路由组)/
+    │   ├── Server Components（默认）
+    │   └── Client Components（'use client'）
+    ├── Pages Router（传统）
+    │   ├── pages/_app.tsx（自定义 App）
+    │   ├── pages/_document.tsx（自定义 Document）
+    │   ├── pages/index.tsx（首页）
+    │   ├── pages/api/（API Routes）
+    │   └── pages/[动态路由]/
+    ├── Middleware
+    │   └── middleware.ts（请求拦截）
+    ├── Server Actions
+    │   └── 'use server' 函数
+    └── 共享模块
+        ├── components/（UI 组件）
+        ├── lib/（工具函数）
+        ├── hooks/（自定义 Hooks）
+        ├── stores/（状态管理）
+        ├── types/（TypeScript 类型）
+        └── styles/（样式文件）
+```
+## 目录扫描策略
+### 1. 识别 Next.js 路由模式
+**信号检测：**
+| 模式 | 信号文件 | 说明 |
+|------|----------|------|
+| App Router | `app/layout.tsx` 或 `app/layout.js` 存在 | Next.js 13+ App Router |
+| Pages Router | `pages/_app.tsx` 或 `pages/_app.js` 存在 | 传统 Pages Router |
+| 混合模式 | `app/` 和 `pages/` 同时存在 | 两种路由共存 |
+**扫描文件**: `app/**/layout.tsx`, `app/**/page.tsx`, `pages/**/*.tsx`, `next.config.*`
+### 2. App Router 分析
+**扫描文件**: `app/**/*.tsx`, `app/**/*.ts`
+**提取内容**:
+- 路由结构（目录 → URL 映射）
+- 布局层级（嵌套 layout.tsx）
+- 路由组 `(...)` 和平行路由 `@folder`
+- 拦截路由 `(.)` 和 `(..)`
+- Server Components vs Client Components（`'use client'` 指令）
+- Loading UI（`loading.tsx`）
+- Error Boundary（`error.tsx`）
+- Not Found 页面（`not-found.tsx`）
+- 路由元数据（`generateMetadata`, `metadata` 导出）
+- Route Handlers（`app/api/**/route.ts`）
+**输出示例**:
+```
+### App Router 结构
+app/
+├── layout.tsx              → 根布局（html + body 标签，全局 Provider）
+├── page.tsx                → /（首页，Server Component）
+├── loading.tsx             → 全局加载 UI
+├── error.tsx               → 全局错误边界
+├── (auth)/
+│   ├── layout.tsx          → AuthLayout（居中布局，无侧边栏）
+│   ├── login/page.tsx      → /login（Client Component，表单交互）
+│   └── register/page.tsx   → /register
+├── (dashboard)/
+│   ├── layout.tsx          → DashboardLayout（侧边栏 + 顶栏）
+│   ├── dashboard/page.tsx  → /dashboard（Server Component，数据预取）
+│   ├── settings/page.tsx   → /settings
+│   └── settings/
+│       ├── loading.tsx     → settings 加载骨架屏
+│       └── error.tsx       → settings 错误边界
+├── admin/
+│   ├── layout.tsx          → AdminLayout
+│   ├── users/
+│   │   ├── page.tsx        → /admin/users（列表页）
+│   │   ├── [id]/page.tsx   → /admin/users/:id（详情页）
+│   │   └── new/page.tsx    → /admin/users/new（创建页）
+│   └── @modal/
+│       ├── (.)users/[id]/page.tsx  → 用户详情弹窗（平行路由）
+│       └── default.tsx      → 弹窗关闭时的默认内容
+└── api/
+    ├── auth/[...nextauth]/route.ts → /api/auth/*（NextAuth）
+    └── users/route.ts      → /api/users（CRUD Route Handler）
+### 组件类型统计
+| 类型 | 数量 | 说明 |
+|------|------|------|
+| Server Component | 12 | 默认，支持 async/await |
+| Client Component | 5 | 标记 'use client' |
+| Route Handler | 3 | app/api/**/route.ts |
+```
+### 3. Pages Router 分析
+**扫描文件**: `pages/**/*.tsx`, `pages/**/*.ts`
+**提取内容**:
+- 路由结构（文件 → URL 映射，含动态路由 `[param]` 和通配符 `[...slug]`）
+- `getStaticProps` / `getServerSideProps` / `getStaticPaths` 数据获取策略
+- 自定义 App 组件（`_app.tsx` 中的全局布局、Provider、页面级状态持久化）
+- 自定义 Document 组件（`_document.tsx` 中的 `<Html>`, `<Head>`, `<Main>`, `<NextScript>`）
+- API Routes（`pages/api/**/*.ts`，含请求方法处理）
+- 中间件（`middleware.ts`，请求匹配和重写规则）
+**输出示例**:
+```
+### Pages Router 结构
+pages/
+├── _app.tsx                → 全局 App（ThemeProvider + SessionProvider + Layout）
+├── _document.tsx           → 自定义 Document（Google Fonts 加载、PWA meta）
+├── _error.tsx              → 自定义错误页
+├── index.tsx               → /（SSG，getStaticProps）
+├── login.tsx               → /login（CSR，客户端表单）
+├── dashboard/
+│   └── index.tsx           → /dashboard（SSR + Auth guard，getServerSideProps）
+├── users/
+│   ├── index.tsx           → /users（SSG，getStaticPaths + getStaticProps）
+│   └── [id].tsx            → /users/:id（ISR，revalidate: 60）
+└── api/
+    ├── auth/[...nextauth].ts → NextAuth API
+    ├── users/index.ts      → GET /api/users, POST /api/users
+    └── users/[id].ts       → GET/PATCH/DELETE /api/users/:id
+### 数据获取策略
+| 页面 | 策略 | 函数 | 说明 |
+|------|------|------|------|
+| / | SSG | getStaticProps | 首页静态生成，revalidate: 3600 |
+| /dashboard | SSR | getServerSideProps | 服务端渲染，需鉴权 |
+| /users | SSG | getStaticPaths + getStaticProps | 用户列表，fallback: 'blocking' |
+| /users/:id | ISR | getStaticPaths + getStaticProps | 用户详情，revalidate: 60 |
+| /login | CSR | - | 纯客户端渲染 |
+```
+### 4. Server Actions 分析
+**扫描文件**: `app/**/*.tsx`, `app/**/*.ts`, `lib/**/*.ts`
+**提取内容**:
+- Server Action 函数（标记 `'use server'`）
+- 表单绑定（`action` 属性）
+- `useActionState` / `useFormState` 使用
+- `useOptimistic` 乐观更新
+- 输入验证（zod / yup schema）
+- 重定向逻辑（`redirect()`）
+- Cookie 操作（`cookies()`）
+**输出示例**:
+```
+### Server Actions
+#### createUser
+- **文件**: `app/admin/users/actions.ts`
+- **签名**:
+  ```typescript
+  'use server'
+  async function createUser(prevState: FormState, formData: FormData): Promise<FormState>
+  ```
+- **输入验证**: zod schema (name: string, email: string, role: enum)
+- **返回值**: `{ success: true, user: User } | { success: false, errors: FieldErrors }`
+- **副作用**: 创建用户后 redirect('/admin/users')
+- **使用位置**: `app/admin/users/new/page.tsx` 中 `<form action={createUser}>`
+```
+### 5. Middleware 分析
+**扫描文件**: `middleware.ts`, `middleware.js`
+**提取内容**:
+- 匹配路径（matcher 配置）
+- 请求拦截逻辑
+- 重定向规则
+- Header 操作
+- 认证/鉴权检查
+- 国际化路由处理
+**输出示例**:
+```
+### Middleware
+- **文件**: `middleware.ts`
+- **匹配路径**: `/dashboard/:path*`, `/admin/:path*`, `/api/:path*`
+- **逻辑流程**:
+  1. 检查 session token (cookies.get('session'))
+  2. 未认证 → redirect('/login')
+  3. API 请求未认证 → return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })
+  4. 检查角色权限（admin 路径需要 admin 角色）
+  5. 添加安全 headers（X-Frame-Options, CSP）
+```
+### 6. Next.js 配置分析
+**扫描文件**: `next.config.js`, `next.config.mjs`, `next.config.ts`
+**提取内容**:
+- `output` 模式（standalone, export）
+- `images` 配置（remotePatterns, domains, deviceSizes）
+- `rewrites` / `redirects` / `headers` 规则
+- `env` 环境变量
+- `experimental` 实验性特性
+- `basePath` / `i18n` 配置
+- Webpack / Turbopack 自定义配置
+- `transpilePackages` 列表
+- 插件列表（`withXXX` 包装函数）
+**输出示例**:
+```
+### Next.js 配置
+- **文件**: `next.config.mjs`
+- **关键配置**:
+  | 配置项 | 值 | 说明 |
+  |--------|-----|------|
+  | output | 'standalone' | Docker 部署模式 |
+  | images.remotePatterns | [{ hostname: 'cdn.example.com' }] | 允许的外部图片域名 |
+  | rewrites | [{ source: '/api/v1/:path*', destination: '/api/:path*' }] | API 版本重写 |
+  | i18n.locales | ['zh', 'en'] | 支持语言 |
+  | i18n.defaultLocale | 'zh' | 默认语言 |
+  | experimental.serverActions | true | 启用 Server Actions |
+```
+### 7. 数据获取模式分析
+**App Router 模式**:
+- `fetch()` + `cache` / `no-store` 选项
+- `unstable_cache` / `revalidateTag` / `revalidatePath`
+- Database 直接查询（Prisma / Drizzle / Kysely）
+- 并行数据获取（Promise.all）
+**Pages Router 模式**:
+- `getStaticProps`（静态生成）
+- `getServerSideProps`（服务端渲染）
+- `getStaticPaths`（动态路由预生成）
+- `unstable_revalidate`（ISR 重新验证）
+- SWR / React Query（客户端数据获取）
+**输出示例**:
+```
+### 数据获取模式（App Router）
+| 页面 | 模式 | 缓存策略 | 数据源 |
+|------|------|----------|--------|
+| /dashboard | 并行 fetch | revalidate: 60 | 内部 API |
+| /users/:id | Prisma 直接查询 | cache('force-cache') | PostgreSQL |
+| /api/users | Route Handler | no-store | PostgreSQL |
+### 客户端数据获取
+| 库 | 使用位置 | Query Key | 说明 |
+|------|----------|-----------|------|
+| SWR | components/UserTable.tsx | ['/api/users', filters] | 用户列表 |
+| TanStack Query | components/Analytics.tsx | ['analytics', dateRange] | 统计数据 |
+```
+## 状态管理分析
+与 `rules/web-react.md` 的状态管理分析规则一致，额外关注：
+- Next.js 特有的 Server/Client 状态边界
+- `cookies()` / `headers()` 服务端状态读取
+- `useRouter()` / `useSearchParams()` 路由状态
+- `useFormStatus()` / `useFormState()` 表单状态
+## 样式分析
+### CSS Modules
+**扫描文件**: `app/**/*.module.css`, `app/**/*.module.scss`, `components/**/*.module.css`
+**提取内容**: 与 `rules/web-react.md` 一致。
+### Tailwind CSS
+**扫描文件**: `tailwind.config.*`, `postcss.config.*`
+**提取内容**: 与 `rules/web-react.md` 一致。
+### CSS-in-JS
+**扫描文件**: `styled-components/`, `@emotion/`, `stitches` 相关文件
+**提取内容**:
+- 使用的库及版本
+- Theme Provider 配置
+- 全局样式定义
+## 输出模板
+### COMPONENT.md 章节结构（Next.js 特有）
+```markdown
+# Next.js 组件文档
+## 路由结构
+### App Router（如适用）
+路由目录树 + URL 映射 + 组件类型标注
+### Pages Router（如适用）
+路由文件列表 + 数据获取策略表
+## Middleware
+请求拦截逻辑 + 重定向规则 + 权限检查
+## Server Actions
+函数签名 + 输入验证 + 使用位置
+## API Routes / Route Handlers
+端点列表 + 请求/响应格式 + 认证要求
+## Components
+### Server Components
+### Client Components
+## 状态管理
+全局状态 + 服务端状态 + 客户端缓存策略
+## 数据获取
+按页面列出数据获取模式 + 缓存策略
+## Next.js 配置
+关键配置项 + 自定义插件
+```
+## 模块边界识别
+以下目录模式下的每个子目录视为独立模块（L2+ 分析时生成 MODULE-DOC.md）：
+| 层 | 扫描路径 | 模块判定规则 | MODULE-DOC slug 来源 |
+|----|----------|-------------|---------------------|
+| 页面/视图层 | `app/{route}/`, `pages/{route}/` | 每个路由目录 | 路由路径 kebab-case |
+| API/服务层 | `app/api/` | 每个路由目录 | 路由路径 kebab-case |
+| 状态管理层 | `src/store/`, `src/stores/` | 每个子目录 | 目录名 kebab-case |
+| 组件层 | `src/components/{name}/` | 3+ 文件的子目录 | 目录名 kebab-case |
+| Hooks 层 | `src/hooks/` | 每个文件 | 文件名去后缀 kebab-case |
+**特殊处理**：
+- Route Handler（`app/api/{route}/route.ts`）每文件一个模块
+- Layout 和 Page 文件归入对应路由模块，不单独成模块
+**不视为独立模块的情况**：
+- 单文件入口（如 `layout.tsx`, `page.tsx` 归入父模块）
+- 纯导出桶文件（`index.ts` 仅有 re-export）
+- 工具函数目录（`utils/`, `helpers/`, `lib/`）— 合并为一个模块
+- `.next/`, `public/`, `node_modules/` 跳过
+## Token 管理
+- 每个子任务分析 <=10 个 `.tsx` / `.ts` 文件
+- `app/` 和 `pages/` 目录按路由分组，每个路由组为一个子任务
+- Server Actions 文件单独分组
+- API Routes / Route Handlers 单独分组
+- `next.config.*` 单独作为一个子任务
+- `middleware.ts` 单独分析
+- `node_modules/`、`.next/`、`out/` 跳过
+- `.generated.*` 或 `*.generated.ts` 文件可跳过或简要分析

package/skills/project-analyze/rules/web-react.md ADDED Viewed

@@ -0,0 +1,298 @@
+# React 项目分析规则（栈特定）
+React 项目专属分析规则，与 `rules/web.md` 配合使用。本文件中的规则优先于 `web.md` 中的同名字段。适用于 React SPA、Next.js（App Router / Pages Router）。
+## 分析粒度
+React 项目按组件树 + Hooks + 状态管理分层分析：
+```
+React 组件树
+    ├── Pages（路由级组件）
+    ├── Components（UI 组件）
+    │   ├── UI 组件（纯展示）
+    │   └── Container 组件（含逻辑）
+    ├── Hooks（自定义 Hook）
+    ├── Context / Store（全局状态）
+    ├── Services（API 调用）
+    ├── Types（TypeScript 类型）
+    └── Styles（CSS Modules / Tailwind）
+```
+## JSX 组件分析
+**扫描文件**: `src/**/*.tsx`, `app/**/*.tsx`
+**提取内容**:
+- 组件名 + 文件路径
+- Props TypeScript interface（完整字段定义）
+- Children 类型
+- 使用的自定义 Hooks（`useXxx()`）
+- JSX Element Tree（子组件结构，1-2 层深度）
+- 条件渲染逻辑
+- `key` 使用模式
+**输出示例**:
+```
+### UserList（Container 组件）
+- **路径**: `src/pages/system/UserList.tsx`
+- **Props Interface**:
+  ```typescript
+  interface UserListProps {
+    /** 筛选的角色 ID */
+    roleId?: string;
+    /** 是否为只读模式 */
+    readonly?: boolean;
+  }
+  ```
+- **使用的 Hooks**:
+  | Hook | 来源 | 用途 |
+  |------|------|------|
+  | useUserStore | stores/userStore | 获取用户列表和操作方法 |
+  | usePagination | hooks/usePagination | 分页逻辑 |
+  | useDebounce | hooks/useDebounce | 搜索输入防抖 |
+- **JSX 结构**（1 层）:
+  <PageHeader title="用户管理" />
+  <SearchForm onSearch={handleSearch} />
+  {loading ? <Spin /> : <UserTable data={users} onSelect={handleSelect} />}
+  <Pagination {...paginationProps} />
+  <UserFormDialog visible={dialogVisible} onClose={handleClose} />
+- **条件渲染**:
+  | 条件 | 渲染内容 |
+  |------|----------|
+  | loading | <Spin /> 加载动画 |
+  | users.length === 0 | <Empty description="暂无数据" /> |
+```
+## 状态管理分析
+### Redux Toolkit
+**扫描文件**: `src/store/**/*.ts`, `src/stores/**/*.ts`
+**提取内容**:
+- Slice 名称 + Reducer 路径
+- State 接口（所有字段 + 类型 + 初始值）
+- Reducers（名称 + 参数 + 修改的 state）
+- ExtraReducers（异步 Thunk 的 pending/fulfilled/rejected）
+- Selectors（名称 + 返回类型）
+**输出示例**:
+```
+### userSlice
+- **文件**: `src/store/slices/userSlice.ts`
+- **Reducer Path**: `'user'`
+- **State 接口**:
+  ```typescript
+  interface UserState {
+    list: UserVO[];
+    total: number;
+    current: UserVO | null;
+    loading: boolean;
+    error: string | null;
+  }
+  ```
+- **Reducers**:
+  | Reducer | 参数 | 说明 |
+  |---------|------|------|
+  | setCurrentUser | (state, action: PayloadAction<UserVO>) | 设置当前用户 |
+  | clearError | (state) | 清除错误信息 |
+- **ExtraReducers**:
+  | Action | State 变更 |
+  |--------|-----------|
+  | fetchUsers.pending | loading = true |
+  | fetchUsers.fulfilled | list = payload.list, total = payload.total, loading = false |
+  | fetchUsers.rejected | error = payload, loading = false |
+- **Selectors**:
+  | 名称 | 返回类型 | 说明 |
+  |------|----------|------|
+  | selectUserList | UserVO[] | 用户列表 |
+  | selectCurrentUser | UserVO \| null | 当前选中用户 |
+```
+### Zustand
+**扫描文件**: `src/stores/**/*.ts`
+**提取内容**:
+- Store 名称 + 创建方式（`create`）
+- State 字段（名称 + 类型）
+- Actions（签名 + 说明）
+- 中间件配置（persist, devtools, immer）
+**输出示例**:
+```
+### useAuthStore
+- **文件**: `src/stores/authStore.ts`
+- **State**:
+  | 字段 | 类型 | 说明 |
+  |------|------|------|
+  | token | string \| null | JWT token |
+  | user | User \| null | 当前用户 |
+  | isAuthenticated | boolean | 是否已认证 |
+- **Actions**:
+  | Action | 签名 | 说明 |
+  |--------|------|------|
+  | login | (credentials: LoginForm) => Promise<void> | 登录 |
+  | logout | () => void | 登出 |
+  | setUser | (user: User) => void | 设置用户信息 |
+- **中间件**: persist (key: 'auth-store', storage: localStorage)
+```
+## React Router 分析
+**扫描文件**: `src/routes/**/*.tsx`, `src/App.tsx`, `app/**/page.tsx`, `app/**/layout.tsx`
+**提取内容**:
+- 路由配置（path + element + loader）
+- 嵌套布局（Layout + Outlet）
+- 路由参数（useParams, useSearchParams）
+- 受保护路由（ProtectedRoute 模式）
+- 代码分割（React.lazy + Suspense）
+**输出示例**:
+```
+### 路由结构
+**App Router (Next.js)**:
+app/
+├── layout.tsx              → RootLayout (全局)
+├── page.tsx                → /
+├── (auth)/
+│   ├── layout.tsx          → AuthLayout (居中卡片)
+│   ├── login/page.tsx      → /login
+│   └── register/page.tsx   → /register
+├── (dashboard)/
+│   ├── layout.tsx          → DashboardLayout (侧边栏+顶栏)
+│   ├── dashboard/page.tsx  → /dashboard
+│   └── settings/page.tsx   → /settings
+└── admin/
+    ├── layout.tsx          → AdminLayout
+    └── users/
+        ├── page.tsx        → /admin/users
+        └── [id]/page.tsx   → /admin/users/:id
+### 受保护路由
+- **组件**: `<ProtectedRoute fallback={<Redirect to="/login" />} />`
+- **检查逻辑**: useAuthStore().isAuthenticated → false → 重定向
+- **角色检查**: `<RoleGate roles={['admin']}><AdminPanel /></RoleGate>`
+```
+## 自定义 Hooks 分析
+**扫描文件**: `src/hooks/**/*.ts`, `src/hooks/**/*.tsx`
+**提取内容**:
+- Hook 名称 + 路径
+- 参数签名（TypeScript 类型）
+- 返回值签名（TypeScript 类型）
+- 内部依赖（API 调用、其他 Hook、Context）
+- 副作用（useEffect 中的逻辑）
+**输出示例**:
+```
+### useFetch
+- **路径**: `src/hooks/useFetch.ts`
+- **签名**:
+  ```typescript
+  function useFetch<T>(
+    url: string,
+    options?: {
+      params?: Record<string, string>;
+      enabled?: boolean;
+      retry?: number;
+    }
+  ): {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+  }
+  ```
+- **内部依赖**: axios 实例, useAuthStore (获取 token)
+- **副作用**: 组件挂载时自动请求；`enabled` 参数控制是否自动请求
+```
+## 样式分析
+### CSS Modules
+**扫描文件**: `src/**/*.module.css`, `src/**/*.module.scss`
+**提取内容**:
+- CSS Module 文件列表
+- 导出的 class 名称
+### Tailwind CSS
+**扫描文件**: `tailwind.config.*`, `src/**/*.tsx` 中的 Tailwind 类名
+**提取内容**:
+- 自定义颜色（`theme.extend.colors`）
+- 自定义间距（`theme.extend.spacing`）
+- 自定义断点（`theme.extend.screens`）
+- 常用组件的 Tailwind 类模式
+**输出示例**:
+```
+### Tailwind 自定义配置
+**来源**: `tailwind.config.ts`
+| Token | 值 | 用途 |
+|-------|------|------|
+| colors.primary | '#3B82F6' | 主色调 |
+| colors.secondary | '#8B5CF6' | 辅助色 |
+| screens.xl | '1440px' | 超大屏 |
+| spacing.sidebar | '280px' | 侧边栏宽度 |
+```
+## 输出模板
+### COMPONENT.md 章节结构（React 特有）
+```markdown
+# 组件文档
+## Pages（页面组件）
+按路由分组，每个页面包含:
+- 路径 + 布局组件
+- Props Interface
+- 使用的 Hooks
+- JSX 结构（1-2 层）
+- 路由参数 / Query 参数
+## Components（UI 组件）
+### Container 组件（含业务逻辑）
+### UI 组件（纯展示）
+## Hooks
+自定义 Hook 列表及文档
+## Store 详解
+Redux Slices / Zustand Stores 完整文档
+## 路由详解
+路由结构 + 保护逻辑 + 代码分割
+```
+## 模块边界识别
+以下目录模式下的每个子目录视为独立模块（L2+ 分析时生成 MODULE-DOC.md）：
+| 层 | 扫描路径 | 模块判定规则 | MODULE-DOC slug 来源 |
+|----|----------|-------------|---------------------|
+| 页面/视图层 | `src/pages/`, `src/app/` | 每个子目录 | 目录名 kebab-case |
+| API/服务层 | `src/services/`, `src/api/` | 每个子目录 | 目录名 kebab-case |
+| 状态管理层 | `src/store/`, `src/stores/` | 每个子目录 | 目录名 kebab-case |
+| 组件层 | `src/components/{name}/` | 3+ 文件的子目录 | 目录名 kebab-case |
+| Hooks 层 | `src/hooks/` | 每个文件 | 文件名去后缀 kebab-case |
+**不视为独立模块的情况**：
+- 单文件入口（如 `main.tsx`, `App.tsx`, `index.ts`）
+- 纯导出桶文件（`index.ts` 仅有 re-export）
+- 工具函数目录（`utils/`, `helpers/`）— 合并为一个模块
+## Token 管理
+- 每个子任务分析 ≤10 个 `.tsx` 文件
+- Store / Slice 文件单独分组
+- 自定义 Hook 文件单独分组
+- Context Provider 文件单独分组