create-dwy 0.2.0 → 0.3.1

package/bin/index.js

@@ -1,13 +1,19 @@
 #!/usr/bin/env node
 
+import { readFileSync } from 'fs'
+import { fileURLToPath } from 'url'
+import { dirname, resolve } from 'path'
 import { program } from 'commander'
 import { createProject } from '../src/create.js'
 import { syncClaude, syncProjectClaude } from '../src/sync.js'
 
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf-8'))
+
 program
   .name('dwy')
   .description('Project scaffolding and Claude Code config sync')
-  .version('0.1.0')
+  .version(pkg.version)
 
 program
   .command('create [name]')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-dwy",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Project scaffolding and Claude Code config sync CLI",
   "type": "module",
   "bin": {

package/src/sync.js

@@ -6,7 +6,7 @@ export async function syncClaude() {
   console.log(chalk.blue('Syncing global Claude configuration...'))
 
   const repoDir = await ensureRepoCache()
-  const sourceDir = path.join(repoDir, 'templates', 'claude-global')
+  const sourceDir = path.join(repoDir, 'claude-cli', 'templates', 'claude-global')
   const targetDir = path.join(process.env.HOME, '.claude')
 
   if (!await fs.pathExists(sourceDir)) {
@@ -62,7 +62,7 @@ export async function syncProjectClaude() {
   const template = marker.template || 'web'
 
   const repoDir = await ensureRepoCache()
-  const sourceDir = path.join(repoDir, 'templates', 'project', template, '.claude')
+  const sourceDir = path.join(repoDir, 'claude-cli', 'templates', 'project', template, '.claude')
   const targetDir = path.join(process.cwd(), '.claude')
 
   if (!await fs.pathExists(sourceDir)) {

package/src/utils.js

@@ -9,7 +9,7 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url))
 
 export const PACKAGE_ROOT = path.resolve(__dirname, '..')
 export const CACHE_DIR = path.join(process.env.HOME, '.dwy', 'cache')
-export const DWY_REPO_URL = 'https://gitee.com/snailyuanyuan/dwy-cli.git'
+export const DWY_REPO_URL = 'https://gitee.com/snailyuanyuan/dwy-shared.git'
 
 export async function ensureRepoCache() {
   await fs.ensureDir(CACHE_DIR)

package/templates/claude-global/skills/core/SKILL.md

@@ -0,0 +1,181 @@
+---
+name: core
+description: "@danweiyuan/core 前端工具库速查。触发条件：需要 HTTP 请求封装、localStorage、表单校验、日期格式化、Vue composable 工具时。"
+---
+
+# @danweiyuan/core 工具库速查
+
+Vue 3 项目通用工具库，包含 5 个模块：request、storage、validators、date、hooks。
+
+## 安装
+
+```bash
+pnpm add @danweiyuan/core
+# peerDependencies: axios ^1.0.0, vue ^3.4.0
+```
+
+```ts
+import { createRequest, useStorage, isPhone, formatDate, useDebounce } from '@danweiyuan/core'
+```
+
+## 查阅源码
+
+每个模块源码在 `frontend/core/src/{module}/index.ts`，函数简短可直接阅读。
+
+---
+
+## request — Axios 插件化封装
+
+```ts
+import { createRequest, tokenPlugin, headerPlugin, unwrapPlugin, refreshTokenPlugin } from '@danweiyuan/core'
+```
+
+### createRequest(options?)
+
+创建带插件系统的 Axios 实例。插件按顺序执行请求/响应拦截。
+
+```ts
+const http = createRequest({
+  baseURL: '/api',      // 默认 '/api'
+  timeout: 30000,       // 默认 30000
+  plugins: [
+    tokenPlugin({ getToken: () => localStorage.getItem('token') }),
+    unwrapPlugin(),
+  ],
+})
+```
+
+### 内置插件
+
+| 插件 | 用途 | 参数 |
+|------|------|------|
+| tokenPlugin | 自动注入 Bearer token | `{ getToken: () => string \| null }` |
+| headerPlugin | 注入自定义请求头 | `{ name: string, getValue: () => string \| null }` |
+| unwrapPlugin | 解包 `{ code, data, message }` 响应，code !== 200 时 reject | 无参数 |
+| refreshTokenPlugin | 401 自动刷新 token 并重试 | `{ getRefreshToken, refreshFn, onRefreshFail, isLoginUrl? }` |
+
+### RequestPlugin 接口
+
+```ts
+interface RequestPlugin {
+  onRequest?: (config: InternalAxiosRequestConfig) => config | Promise<config>
+  onResponse?: (response: AxiosResponse) => response | Promise<response>
+  onResponseError?: (error: AxiosError) => any
+}
+```
+
+### refreshTokenPlugin 详解
+
+```ts
+refreshTokenPlugin({
+  getRefreshToken: () => localStorage.getItem('refreshToken'),
+  refreshFn: async (refreshToken) => {
+    // 调用刷新接口，返回新 access token
+    const { data } = await http.post('/auth/refresh', { refreshToken })
+    localStorage.setItem('token', data.token)
+    return data.token
+  },
+  onRefreshFail: () => {
+    // 刷新失败，跳转登录
+    localStorage.clear()
+    window.location.href = '/login'
+  },
+  isLoginUrl: (url) => url.includes('/auth/login'), // 可选，默认检测 /auth/login
+})
+```
+
+---
+
+## storage — localStorage 封装
+
+```ts
+import { useStorage, storage } from '@danweiyuan/core'
+```
+
+### useStorage(key, defaultValue) — 响应式
+
+返回 Vue `Ref<T>`，自动 JSON 序列化，深度 watch 自动同步。设为 null/undefined 时自动 removeItem。
+
+```ts
+const token = useStorage<string>('token', '')
+const config = useStorage<{ theme: string }>('config', { theme: 'light' })
+```
+
+### storage — 静态工具对象
+
+| 方法 | 签名 | 说明 |
+|------|------|------|
+| get | `get<T>(key, defaultValue?): T \| undefined` | JSON 解析失败时返回原始字符串 |
+| set | `set(key, value): void` | JSON.stringify 后存储 |
+| remove | `remove(key): void` | 删除指定 key |
+| clear | `clear(): void` | 清空全部 |
+
+---
+
+## validators — 校验函数
+
+```ts
+import { isPhone, isEmail, isIdCard, isUrl, isRequired, minLength, maxLength } from '@danweiyuan/core'
+```
+
+| 函数 | 签名 | 规则 |
+|------|------|------|
+| isPhone | `(value: string) => boolean` | 中国手机号 1[3-9]开头 11 位 |
+| isEmail | `(value: string) => boolean` | 基础邮箱格式 |
+| isIdCard | `(value: string) => boolean` | 18 位身份证（末位可为 X/x） |
+| isUrl | `(value: string) => boolean` | 使用 `new URL()` 校验 |
+| isRequired | `(value: any) => boolean` | 非 null/undefined/空字符串/空数组。0 和 false 视为有效 |
+| minLength | `(value: string, min: number) => boolean` | 最小长度 |
+| maxLength | `(value: string, max: number) => boolean` | 最大长度 |
+
+---
+
+## date — 日期格式化
+
+```ts
+import { formatDate, formatDateTime, formatTime, formatRelativeTime } from '@danweiyuan/core'
+```
+
+所有函数接收 `string | number | Date` 类型输入。
+
+| 函数 | 输出格式 | 示例 |
+|------|---------|------|
+| formatDate | `YYYY-MM-DD` | `2025-03-15` |
+| formatDateTime | `YYYY-MM-DD HH:mm:ss` | `2025-03-15 14:30:00` |
+| formatTime | `HH:mm` | `14:30` |
+| formatRelativeTime | 中文相对时间 | `刚刚` / `5 分钟前` / `3 小时前` / `7 天前` / 超过 30 天返回 `toLocaleDateString('zh-CN')` |
+
+---
+
+## hooks — Vue Composables
+
+```ts
+import { useDebounce, useClickOutside, useEventListener } from '@danweiyuan/core'
+```
+
+### useDebounce(value, delay?)
+
+```ts
+const search = ref('')
+const debouncedSearch = useDebounce(search, 300) // 默认 300ms
+```
+
+返回防抖后的 `Ref<T>`，仅在源值停止变化 delay 毫秒后更新。
+
+### useClickOutside(target, handler)
+
+```ts
+const popoverRef = ref<HTMLElement | null>(null)
+useClickOutside(popoverRef, () => { isOpen.value = false })
+```
+
+点击 target 元素外部时触发 handler。自动在 onMounted/onBeforeUnmount 绑定/解绑。
+
+### useEventListener(target, event, handler, options?)
+
+```ts
+useEventListener(window, 'resize', onResize)
+useEventListener(elementRef, 'scroll', onScroll, { passive: true })
+```
+
+target 可以是 `EventTarget` 或 `Ref<EventTarget>`。自动在 onMounted/onBeforeUnmount 绑定/解绑。

package/templates/claude-global/skills/danweiyuan-base/SKILL.md

@@ -0,0 +1,279 @@
+---
+name: danweiyuan-base
+description: "danweiyuan-base FastAPI 后端基础设施速查。触发条件：使用 FastAPI 构建后端、配置数据库/Redis/JWT/异常处理时。"
+---
+
+# danweiyuan-base 后端基础设施速查
+
+FastAPI 项目基础设施包，Python 3.11+，全异步。8 个扁平模块，无子包。
+
+## 安装
+
+```bash
+pip install danweiyuan-base
+# 或
+uv add danweiyuan-base
+```
+
+```python
+from danweiyuan_base.config import BaseSettings
+from danweiyuan_base.database import Base, TimestampMixin, create_async_engine_factory, create_session_factory
+from danweiyuan_base.security import hash_password, verify_password, create_token, decode_token
+from danweiyuan_base.exceptions import NotFoundError, BusinessError, register_exception_handlers
+from danweiyuan_base.response import success, fail, paginated
+from danweiyuan_base.pagination import PaginationParams, paginate
+from danweiyuan_base.cache import configure as configure_redis, get_redis, close_redis
+from danweiyuan_base.dependencies import create_get_db
+```
+
+## 查阅源码
+
+每个模块在 `backend/src/danweiyuan_base/{module}.py`，单文件设计可直接阅读。
+
+---
+
+## config — Pydantic Settings
+
+```python
+from danweiyuan_base.config import BaseSettings
+```
+
+子类化后使用，从 `.env` 或环境变量读取配置。
+
+```python
+class Settings(BaseSettings):
+    app_name: str = "My API"
+    # 继承的必填字段：database_url, redis_url, secret_key
+```
+
+| 字段 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| database_url | str | **必填** | 异步数据库 URL |
+| redis_url | str | **必填** | Redis URL |
+| secret_key | str | **必填** | JWT 签名密钥 |
+| jwt_algorithm | str | `"HS256"` | JWT 算法 |
+| access_token_expire_minutes | int | `30` | Token 过期分钟 |
+| debug | bool | `False` | 调试模式 |
+| allowed_origins | list[str] | `[]` | CORS 允许域名 |
+
+---
+
+## database — 异步 SQLAlchemy
+
+```python
+from danweiyuan_base.database import Base, TimestampMixin, create_async_engine_factory, create_session_factory
+```
+
+### 模型定义
+
+```python
+from sqlalchemy.orm import Mapped, mapped_column
+from sqlalchemy import String
+
+class User(Base, TimestampMixin):
+    __tablename__ = "users"
+    id: Mapped[int] = mapped_column(primary_key=True)
+    name: Mapped[str] = mapped_column(String(50))
+    # TimestampMixin 自动添加 created_at, updated_at
+```
+
+### 引擎和会话
+
+```python
+engine = create_async_engine_factory(settings.database_url, echo=settings.debug)
+# 参数: database_url, pool_size=5, max_overflow=10, echo=False
+# SQLite 自动跳过连接池参数
+
+session_factory = create_session_factory(engine)
+# 返回 async_sessionmaker[AsyncSession]，expire_on_commit=False
+```
+
+---
+
+## dependencies — FastAPI 依赖注入
+
+```python
+from danweiyuan_base.dependencies import create_get_db
+```
+
+### create_get_db(session_factory)
+
+生成 `get_db` FastAPI Depends 函数，自动管理会话生命周期。
+
+```python
+get_db = create_get_db(session_factory)
+
+@router.get("/users/{user_id}")
+async def get_user(user_id: int, db: AsyncSession = Depends(get_db)):
+    ...
+```
+
+---
+
+## security — JWT + bcrypt
+
+```python
+from danweiyuan_base.security import hash_password, verify_password, create_token, decode_token
+```
+
+所有函数无状态，密钥通过参数传入。
+
+| 函数 | 签名 | 说明 |
+|------|------|------|
+| hash_password | `(password: str) -> str` | bcrypt 哈希 |
+| verify_password | `(plain: str, hashed: str) -> bool` | 验证密码 |
+| create_token | `(data: dict, secret: str, expires_minutes: int, algorithm="HS256") -> str` | 创建 JWT，自动添加 exp |
+| decode_token | `(token: str, secret: str, algorithm="HS256") -> dict \| None` | 解码 JWT，失败返回 None |
+
+```python
+hashed = hash_password("my-password")
+is_valid = verify_password("my-password", hashed)
+
+token = create_token({"sub": str(user.id)}, settings.secret_key, settings.access_token_expire_minutes)
+payload = decode_token(token, settings.secret_key)  # {"sub": "1", "exp": ...} 或 None
+```
+
+---
+
+## exceptions — 异常体系
+
+```python
+from danweiyuan_base.exceptions import (
+    AppError, NotFoundError, BusinessError, PermissionDeniedError, AuthenticationError,
+    register_exception_handlers,
+)
+```
+
+### 异常层级
+
+| 异常类 | HTTP 状态码 | code | message |
+|--------|-----------|------|---------|
+| AppError(message, code) | — | 自定义 | 自定义 |
+| NotFoundError(resource) | 404 | `NOT_FOUND` | `{resource}不存在` |
+| BusinessError(message, code) | 422 | 自定义 | 自定义 |
+| PermissionDeniedError() | 403 | `PERMISSION_DENIED` | `权限不足` |
+| AuthenticationError() | 401 | `AUTHENTICATION_FAILED` | `认证失败` |
+
+### 注册到 FastAPI
+
+```python
+app = FastAPI()
+register_exception_handlers(app)
+# 之后在 service 层直接 raise NotFoundError("用户") 即可返回 404
+```
+
+响应格式统一为 `{"code": "ERROR_CODE", "message": "描述"}`。
+
+### 使用原则
+
+- **service 层**抛业务异常（NotFoundError, BusinessError 等）
+- **router 层**不写 try/except，由 register_exception_handlers 统一处理
+- **禁止**在 service 层抛 HTTPException
+
+---
+
+## response — 统一响应
+
+```python
+from danweiyuan_base.response import success, fail, paginated
+```
+
+| 函数 | 签名 | 返回结构 |
+|------|------|---------|
+| success | `(data=None, message="success") -> dict` | `{"code": 200, "message": ..., "data": ..., "timestamp": ...}` |
+| fail | `(code=400, message="fail") -> dict` | `{"code": ..., "message": ..., "data": None, "timestamp": ...}` |
+| paginated | `(items, total, page, page_size) -> dict` | success 包装 `{"items": [...], "total": N, "page": N, "page_size": N}` |
+
+```python
+@router.get("/users/{user_id}")
+async def get_user(user_id: int, service=Depends(get_user_service)):
+    user = await service.get_by_id(user_id)
+    return success(data=UserResponse.model_validate(user))
+
+@router.get("/users")
+async def list_users(params: PaginationParams = Depends(), service=Depends(get_user_service)):
+    items, total = await service.list(params)
+    return paginated(items, total, params.page, params.page_size)
+```
+
+---
+
+## pagination — 分页工具
+
+```python
+from danweiyuan_base.pagination import PaginationParams, paginate, OffsetLimit
+```
+
+### PaginationParams
+
+FastAPI Depends 注入的查询参数模型。
+
+| 字段 | 类型 | 默认 | 约束 |
+|------|------|------|------|
+| page | int | 1 | >= 1 |
+| page_size | int | 20 | 1 ~ 100 |
+
+### paginate(page, page_size) -> OffsetLimit
+
+```python
+offset_limit = paginate(params.page, params.page_size)
+# OffsetLimit(offset=0, limit=20) — 可直接用于 SQLAlchemy .offset().limit()
+stmt = select(User).offset(offset_limit.offset).limit(offset_limit.limit)
+```
+
+---
+
+## cache — 异步 Redis
+
+```python
+from danweiyuan_base import cache
+```
+
+| 函数 | 签名 | 说明 |
+|------|------|------|
+| cache.configure | `(redis_url: str) -> None` | 设置 Redis URL（启动时调用一次） |
+| cache.get_redis | `async () -> Redis` | 获取/创建共享连接（未 configure 时抛 RuntimeError） |
+| cache.close_redis | `async () -> None` | 关闭连接（安全幂等） |
+
+```python
+# lifespan 中初始化
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    cache.configure(settings.redis_url)
+    yield
+    await cache.close_redis()
+
+# 业务中使用
+redis = await cache.get_redis()
+await redis.set("key", "value", ex=3600)
+val = await redis.get("key")
+```
+
+---
+
+## 典型项目接入流程
+
+```python
+# config.py
+from danweiyuan_base.config import BaseSettings
+
+class Settings(BaseSettings):
+    app_name: str = "My API"
+
+settings = Settings()
+
+# database.py
+from danweiyuan_base.database import Base, create_async_engine_factory, create_session_factory
+from danweiyuan_base.dependencies import create_get_db
+
+engine = create_async_engine_factory(settings.database_url)
+session_factory = create_session_factory(engine)
+get_db = create_get_db(session_factory)
+
+# main.py
+from danweiyuan_base.exceptions import register_exception_handlers
+from danweiyuan_base import cache
+
+app = FastAPI(lifespan=lifespan)
+register_exception_handlers(app)
+```

package/templates/claude-global/skills/eui/SKILL.md

@@ -0,0 +1,246 @@
+---
+name: eui
+description: "@danweiyuan/eui Vue 3 组件库速查。触发条件：使用 Vue 3 构建页面、选择 UI 组件、查询 eui 组件 API 时。"
+---
+
+# @danweiyuan/eui 组件速查
+
+基于 Reka-ui 原语层 + shadcn-vue 设计风格 + Element Plus 式 API 的 Vue 3 组件库。
+
+## 安装与引入
+
+```bash
+pnpm add @danweiyuan/eui
+```
+
+```ts
+// 按需导入（推荐）
+import { EButton, EInput, ETable } from '@danweiyuan/eui'
+
+// 全局注册（Vue plugin）
+import EUI from '@danweiyuan/eui'
+app.use(EUI)
+```
+
+```ts
+// 主题 CSS（必须引入）
+import '@danweiyuan/eui/theme'          // 基础样式 + tokens
+import '@danweiyuan/eui/theme/dark'     // 暗色模式（可选）
+import '@danweiyuan/eui/theme/tokens'   // 仅 design tokens（可选）
+```
+
+## 命名约定
+
+- 组件前缀 `E`：`EButton`, `EInput`, `EDialog`
+- Props 类型：`E{Name}Props`（如 `EButtonProps`）
+- Events 类型：`E{Name}Emits`（如 `EInputEmits`）
+- CVA 变体：`{name}Variants`（如 `buttonVariants`）
+- 样式合并工具：`cn()` = clsx + tailwind-merge
+- 尺寸统一类型：`Size = 'sm' | 'default' | 'lg'`
+
+## 查阅完整 API
+
+每个组件的完整 props/slots/events 定义在源码中：
+
+```
+frontend/eui/src/components/{component-name}/types.ts
+```
+
+需要具体某个组件的详细 API 时，直接读取对应的 `types.ts` 文件。
+
+---
+
+## 组件索引
+
+### 基础组件
+
+| 组件 | 用途 | 关键 Props |
+|------|------|-----------|
+| EButton | 按钮 | variant(default/destructive/outline/secondary/ghost/link), size(default/sm/lg/icon), loading, disabled |
+| EBadge | 标签徽章 | variant(default/secondary/destructive/outline) |
+| EAlert | 警告提示 | variant(default/destructive), title, description, closable |
+| ECard | 卡片容器 | title, description |
+| ELabel | 标签文本 | for |
+| ESeparator | 分隔线 | orientation(horizontal/vertical) |
+| ETypography | 排版文本 | variant, as |
+| EKbd | 键盘按键展示 | — |
+| ESpinner | 加载动画 | size(sm/default/lg) |
+| EProgress | 进度条 | modelValue(0-100) |
+| ESkeleton | 骨架屏 | — |
+| EEmpty | 空状态 | title, description, icon |
+| EAvatar | 头像 | src, alt, fallback, size |
+| EImage | 图片 | src, alt, fit, lazy, fallback, preview |
+
+### 表单组件
+
+| 组件 | 用途 | 关键 Props |
+|------|------|-----------|
+| EInput | 输入框 | v-model, type, placeholder, size, clearable, showPassword, disabled, readonly, maxlength |
+| ETextarea | 多行输入 | v-model, placeholder, rows, autoResize, maxlength, disabled |
+| ENumberField | 数字输入 | v-model, min, max, step, size, disabled |
+| ESelect | 下拉选择 | v-model, options(Option[]), placeholder, clearable, size, disabled |
+| ENativeSelect | 原生 select | v-model, options(SelectOption[]), placeholder, disabled |
+| ECombobox | 组合框 | v-model, options(Option[]), placeholder, emptyText, disabled |
+| EAutocomplete | 自动补全 | v-model, fetchSuggestions(async fn), debounce, placeholder |
+| ECheckbox | 复选框 | v-model, label, disabled, indeterminate |
+| ERadio | 单选组 | v-model, options(Option[]), direction(horizontal/vertical), disabled |
+| ESwitch | 开关 | v-model, label, size, disabled |
+| ETagsInput | 标签输入 | v-model(string[]), placeholder, max, size, disabled |
+| EDatePicker | 日期选择 | v-model, placeholder, format, clearable, disabled |
+| ETimePicker | 时间选择 | v-model, placeholder, format, hourStep, minuteStep, disabled |
+| EColorPicker | 颜色选择 | v-model, presets(string[]), showAlpha, disabled |
+| ERate | 评分 | v-model, max, allowHalf, showText, disabled |
+| ESlider | 滑块 | v-model(number[]), min, max, step, orientation, disabled |
+| ECascader | 级联选择 | v-model, options(CascaderOption[]), placeholder, filterable, clearable |
+| ETreeSelect | 树选择 | v-model, data(TreeNode[]), placeholder, multiple, checkable, disabled |
+| EMention | @提及输入 | v-model, options(MentionOption[]), prefix, loading, placeholder |
+| EInputOTP | OTP 验证码 | v-model, length, disabled, placeholder |
+| EPinInput | PIN 输入 | v-model(string[]), length, mask, otp, type(text/number) |
+| EUpload | 文件上传 | v-model(UploadFile[]), action, accept, multiple, limit, listType(text/picture/picture-card), drag |
+| ETransfer | 穿梭框 | v-model, data(TransferItem[]), filterable, titles([string, string]) |
+| EForm | 表单容器 | model, rules(Zod/FormRule[]), labelWidth, labelPosition(left/right/top), size, disabled |
+| EFormItem | 表单项 | （配合 EForm 使用） |
+| EField | 字段布局 | orientation(vertical/horizontal/responsive), invalid |
+| EInputGroup | 输入组 | 子组件 EInputGroupAddon(align) |
+
+### 数据展示
+
+| 组件 | 用途 | 关键 Props |
+|------|------|-----------|
+| ETable | 表格 | data, columns(TableColumn[]), loading, rowKey, striped, bordered, selectable, selectedKeys |
+| EVirtualTable | 虚拟滚动表格 | columns(VirtualTableColumn[]), data, height, estimateRowHeight, rowKey, loading |
+| EDescriptions | 描述列表 | items(DescriptionItem[]), columns, bordered, title |
+| ETimeline | 时间线 | items(TimelineItem[]), reverse |
+| EStatistic | 统计数值 | title, value, prefix, suffix, precision |
+| ETree | 树形控件 | data(TreeNode[]), v-model, checkable, expandedKeys, defaultExpandAll |
+| ECalendar | 日历 | v-model, multiple, disabled, locale, minValue, maxValue |
+| ERangeCalendar | 日期范围日历 | v-model({start, end}), disabled, locale, minValue, maxValue |
+| EPagination | 分页 | v-model, total, pageSize, showSizeChanger, pageSizes, showTotal |
+| EBreadcrumb | 面包屑 | items(BreadcrumbItem[]), separator |
+
+### 弹层与反馈
+
+| 组件 | 用途 | 关键 Props |
+|------|------|-----------|
+| EDialog | 对话框 | v-model:open, title, description, showClose, maxWidth |
+| EDrawer | 抽屉 | v-model:open, title, description, direction(top/right/bottom/left), showClose |
+| ESheet | 侧边面板 | v-model:open, title, description, side(top/right/bottom/left), showClose |
+| EAlertDialog | 确认对话框 | v-model:open, title, description, confirmText, cancelText |
+| ETooltip | 提示气泡 | content, side, sideOffset, delayDuration, disabled |
+| EPopover | 弹出卡片 | v-model:open, side, sideOffset, align |
+| EHoverCard | 悬停卡片 | openDelay, closeDelay |
+| EToast | 轻提示 | position, expand, richColors（配合 `toast()` 函数使用） |
+| EContextMenu | 右键菜单 | items(ContextMenuItem[]) |
+
+### 导航与布局
+
+| 组件 | 用途 | 关键 Props |
+|------|------|-----------|
+| ETabs | 标签页 | v-model, items(TabItem[]) |
+| EMenu | 侧边菜单 | v-model, items(MenuItem[]), collapsed |
+| EDropdown | 下拉菜单 | items(DropdownMenuItem[]), side, align, sideOffset |
+| EAccordion | 手风琴 | v-model, items(AccordionItemOption[]), multiple, collapsible |
+| ECollapsible | 折叠面板 | v-model(boolean), disabled |
+| EStepper | 步骤条 | v-model, items(StepperItem[]), direction(horizontal/vertical) |
+| ECarousel | 轮播 | loop, direction, showArrows, showDots, autoplay, interval。子组件 ECarouselItem |
+| EScrollArea | 自定义滚动区 | type(auto/always/scroll/hover) |
+| EInfiniteScroll | 无限滚动 | loading, disabled, distance |
+
+### 复合组件
+
+以下组件由多个子组件组合使用，通过 `provide/inject` 共享状态：
+
+| 组件 | 子组件 | 用途 |
+|------|--------|------|
+| ESidebar | ESidebarProvider, ESidebar, ESidebarTrigger, ESidebarContent, ESidebarHeader, ESidebarFooter, ESidebarGroup, ESidebarGroupLabel, ESidebarGroupContent, ESidebarMenu, ESidebarMenuItem, ESidebarMenuButton | 侧边栏。Provider(defaultOpen, v-model:open) |
+| ECommand | ECommandInput, ECommandList, ECommandEmpty, ECommandGroup, ECommandItem, ECommandSeparator, ECommandShortcut | 命令面板（配合 useCommand） |
+| ENavigationMenu | ENavigationMenuList, ENavigationMenuItem, ENavigationMenuTrigger, ENavigationMenuContent, ENavigationMenuLink, ENavigationMenuViewport | 导航菜单 |
+| EMenubar | EMenubarMenu, EMenubarTrigger, EMenubarContent, EMenubarItem, EMenubarSeparator, EMenubarCheckboxItem, EMenubarRadioGroup, EMenubarRadioItem, EMenubarSub, EMenubarSubTrigger, EMenubarSubContent | 菜单栏 |
+| EResizable | EResizablePanelGroup(direction), EResizablePanel(defaultSize, minSize, maxSize), EResizableHandle(withHandle) | 可调整大小面板 |
+
+### 其他
+
+| 组件 | 用途 | 关键 Props |
+|------|------|-----------|
+| EConfigProvider | 全局配置注入 | size, zIndex, locale(Record) |
+| EToggle | 切换按钮 | v-model, variant(default/outline), size, disabled |
+| EToggleGroup | 切换按钮组 | v-model, type(single/multiple), variant, size, disabled |
+| EButtonGroup | 按钮组 | orientation(horizontal/vertical) |
+| EItem | 列表项 | variant(default/outline/muted), size(default/sm), as |
+| EAspectRatio | 宽高比容器 | ratio |
+| EAffix | 固钉 | offset, position(top/bottom) |
+| EWatermark | 水印 | content, fontSize, rotate, gap, opacity |
+| EChartContainer | 图表容器 | config(ChartConfig), id |
+
+### 业务组件
+
+| 组件 | 用途 | 关键 Props |
+|------|------|-----------|
+| EDataPage | 数据列表页 | columns(TableColumn[]), fetchFn(async), searchable, pageSize。内置表格 + 分页 + 搜索 |
+| EFormDialog | 表单弹窗 | v-model:open, title, size, loading, confirmText, cancelText |
+| EConfirmDialog | 确认弹窗 | v-model:open, title, message, type(info/warning/error), confirmText, cancelText |
+| EAdminLayout | 后台管理布局 | logo, title, menuItems(MenuItem[]), v-model:activeKey, v-model:collapsed, headerHeight, sidebarWidth |
+| ELoginLayout | 登录页布局 | title, logo, background |
+| EAIChat | AI 对话 | messages(ChatMessage[]), loading, placeholder |
+| ETimetableGrid | 课程表/时间表 | data(TimetableItem[]), startHour, endHour, days |
+
+---
+
+## Composables
+
+| Composable | 用途 | 返回值 |
+|------------|------|--------|
+| useMessage() | 全局消息提示 | { success, warning, error, info } — 每个接收 string 或 MessageOptions |
+| useNotification() | 通知 | { success, warning, error, info } — 接收 NotificationOptions(title, message, position, duration) |
+| useMessageBox() | 对话确认 | { alert, confirm, prompt } — 返回 Promise<'confirm' \| 'cancel'> |
+| useTheme() | 主题管理 | { isDark, theme, setTheme, toggleDark, colorTheme, setColorTheme } |
+| useConfigProvider() | 读取全局配置 | { size, zIndex, locale } |
+| useFormField() | 表单字段上下文 | { id, name, formItemId, valid, isDirty, isTouched, error }（需在 FormField 内使用） |
+
+## 主题系统
+
+- **Design Tokens**: CSS 自定义属性，定义在 `tokens.css`，前缀 `--`（如 `--primary`, `--background`）
+- **暗色模式**: `dark.css`，通过 `<html class="dark">` 切换
+- **色彩主题**: 7 种（neutral/blue/green/rose/orange/violet/slate），通过 `useTheme().setColorTheme()` 切换
+- **样式工具**: 使用 `cn()` 合并 Tailwind 类名，自动解决冲突
+
+```ts
+import { cn } from '@danweiyuan/eui'
+cn('px-2 py-1', isActive && 'bg-primary text-white', className)
+```
+
+## 通用类型
+
+```ts
+type Size = 'sm' | 'default' | 'lg'
+
+interface Option {
+  label: string
+  value: string | number
+  disabled?: boolean
+}
+
+interface GroupedOption {
+  label: string
+  options: Option[]
+}
+
+interface MenuItem {
+  key: string
+  label: string
+  icon?: string
+  children?: MenuItem[]
+  disabled?: boolean
+}
+
+interface TableColumn<T = any> {
+  key: string
+  title: string
+  width?: number | string
+  minWidth?: number
+  sortable?: boolean
+  fixed?: 'left' | 'right'
+  align?: 'left' | 'center' | 'right'
+  render?: (row: T, index: number) => any
+}
+```