create-dwy 0.19.0 → 0.20.0

package/templates/ai-tools/skills/Python/dwy-eapi/v0/providers-email.md

@@ -0,0 +1,49 @@
+# 邮件 Provider（0.x）
+
+内置与自定义走同一注册表。`make_email_provider` 只按 `EMAIL__PROVIDER` 查名。
+
+当前内置仅 `resend`，extra：`dwyeapi[email-resend]`。`dwyeapi[email]` = 全部内置 extra（现在就这一个）。
+
+```python
+from dwyeapi.providers.email import (
+    EmailProviderBase,
+    EmailSettings,
+    make_email_provider,
+    register_email_provider,
+)
+
+provider = make_email_provider(settings.email)
+await provider.send_code("user@qq.com")
+```
+
+自定义（**不用改 eapi**）：
+
+```python
+class TencentSesProvider(EmailProviderBase):
+    async def _send(self, target: str, code: str) -> bool:
+        html = self._render_code_html(code)
+        text = self._render_code_text(code)
+        return True
+
+register_email_provider(
+    "tencent_ses",
+    lambda s: TencentSesProvider(
+        code_ttl=s.code_ttl,
+        require_common_domain=s.require_common_domain,
+        extra_allow_domains=s.extra_allow_domain_list(),
+        allow_edu=s.allow_edu,
+        allow_edu_cn=s.allow_edu_cn,
+    ),
+)
+# .env: EMAIL__PROVIDER=tencent_ses
+```
+
+- 验证码 Redis + 品牌化模板由基类复用，子类只实现 `_send`
+- 内置名 `resend` 不可覆盖
+- 自定义同名二次注册会覆盖并 warning
+- 必须在 `make_email_provider` **之前** register
+- `send_code` / `verify_code` 的 Redis key 自 **0.9.6** 走 `canonicalize_email`；发信信封仍用用户输入地址
+- `send_code` **默认**校验常见邮箱域名（`EMAIL__REQUIRE_COMMON_DOMAIN`，≥0.10.0）；失败不发信。详见 `email-canonical.md`
+- 缺 extra 构造内置 provider → `ImportError`，提示 `pip install dwyeapi[email-resend]`
+
+0.9.0 删除了内置 mock / 阿里云占位 / 整个 sms 模块，见 `breaking.md`。

package/templates/ai-tools/skills/Python/dwy-eapi/versions.yml

@@ -0,0 +1,13 @@
+# dwyeapi 安装版本 → 文档线。匹配从上到下第一条。
+# 大版本破坏才新开 vN/；0.x 内部 breaking 写 v0/breaking.md，细节 clone 对应 tag。
+repo: https://github.com/danweiyuancircle/dwy-ai-experience.git
+tag_prefix: "dwyeapi@"
+sparse:
+  - backend/src/dwyeapi
+lines:
+  - match: ">=2.0.0"
+    dir: v2
+  - match: ">=1.0.0"
+    dir: v1
+  - match: ">=0.0.0"
+    dir: v0

package/templates/ai-tools/skills/Vue/dwy-eui/SKILL.md

@@ -1,333 +1,89 @@
 ---
 name: dwy-eui
-description: "@dwydev/eui Vue 3 组件库使用指南。当用户在使用 Vue 3 构建页面、选择 UI 组件、查询组件 API、写表单/表格/弹层/导航、配置主题或国际化、使用中后台或落地页设计规范时，**必须**使用此 skill。即使用户没有明确说 'eui'，只要涉及 Vue 3 组件选型、页面布局、表单设计、数据展示、弹层交互、主题切换，也应触发。"
-eui_baseline_version: "2.1.0"
+description: "Use when building Vue 3 UI with @dwydev/eui: pick components, forms, tables, overlays, admin layout, theme, i18n, EConfigProvider. The single navigation skill for @dwydev/eui."
 ---
 
-# @dwydev/eui 组件库使用指南
+# @dwydev/eui
 
-Vue 3 组件库：Reka-ui 原语层 + shadcn-vue 设计风格 + Element Plus 式 API + Tailwind CSS 4。
+Vue 3 组件库（Reka-ui + shadcn 视觉 + Element Plus 式 API + Tailwind 4）。本文件只做**路由**：探测安装版本 → 选文档线 → 不够再读源码（先 clone tag，拿不到再读 `node_modules`）。
 
-本 skill 的索引信息基于 EUI **2.1.0**。消费方项目实际版本可能不同 — 见 [版本兼容规则](#版本兼容规则)。
+对外只有这一个 skill。`v1/` `v2/` 不是独立 skill，禁止当多个入口用。
 
----
-
-## 集成与设计规范
-
-| 场景 | 读取文件 |
-|------|---------|
-| 新项目集成 EUI | `references/eui-integration-guide.md` |
-| 中后台页面设计规范 | `references/eui-design-guide.md` |
-| 落地页/营销页设计规范 | `references/eui-landing-design-guide.md` |
-
----
-
-## 查 API 标准动作（核心：每次用组件前都做）
-
-EUI 有 87 个组件目录、117 个对外组件。**本文档不再镜像 props/emits 列表** —— 因为它们会随版本漂移。AI 想用某个组件时，按下面顺序拿到精确 API：
-
-### 第一步：定位 EUI 真实版本
-
-读消费方项目的 `package.json`，找 `dependencies["@dwydev/eui"]` 或 `peerDependencies["@dwydev/eui"]`。这个版本号才是 AI 写代码的依据，不是 skill frontmatter 里的 baseline。
+## 每次写 @dwydev/eui 代码前（强制）
 
-### 第二步：读 component-manifest.json（一次拿组件地图）
+1. **探测安装版本**（按顺序，命中即停）
+   ```bash
+   node -p "require('@dwydev/eui/package.json').version"
+   ```
+   失败则读 `pnpm-workspace.yaml` catalog `'@dwydev/eui'`，再读 `package.json` 的 `dependencies` / `peerDependencies`。
+   仍失败：按 `v2` 给脚手架，并声明「未探测到安装版本」。
 
-从 EUI 2.1.0 起，npm 包带一份组件清单：
+2. **选线**：读同目录 `versions.yml`。`2.y.z` → `v2/`，`1.y.z` → `v1/`。目录不存在（例如装了 3.x 但还没有 `v3/`）→ 不要用 `v2` 冒充；按下面「读源码」拿该版本代码，并说明文档线未建。
 
-```
-<project-root>/node_modules/@dwydev/eui/dist/component-manifest.json
-```
+3. **读文档**：先 `shared/`（跨大版本不变），再该线 `vN/`。能力标了版本下限（如 `component-manifest.json` ≥2.1.0、`useEuiMobile` ≥2.4）时，安装版本低于下限 → 当不存在。
 
-结构（精简示例）：
-```json
-{
-  "version": "2.1.0",
-  "componentToDir": { "EButton": "button", "ECommandInput": "command" },
-  "directories": {
-    "button":  { "types": "components/button/types.d.ts",  "components": ["EButton"] },
-    "command": { "types": null, "components": ["ECommand", "ECommandInput", "..."] }
-  },
-  "composables": ["useMessage", "useTheme", "..."]
-}
-```
+4. **文档不够 / 和记忆冲突 / 下限对不上** → 读代码，顺序如下（命中即停）：
+   1. clone 安装版本对应 tag（见下）
+   2. tag 不存在 / clone 失败 → 读**当前项目** `node_modules/@dwydev/eui`
+   3. `node_modules` 也没有 → **停下来问人**，禁止猜 props，禁止拿旁边 dwy-shared master 冒充
 
-用法：
-- 知道组件名（如 `EButton`） → 查 `componentToDir["EButton"]` 拿到目录 `"button"`
-- 查 `directories["button"].types` 拿到类型文件相对路径
-- 拼接：`<project-root>/node_modules/@dwydev/eui/dist/{types}` 就是要读的 .d.ts
+## 读源码
 
-manifest 不存在的回退：
-- 消费方装的是 EUI < 2.1.0（旧版本没有 manifest） → 直接走第三步用约定路径
-- 仓库无 node_modules（裸 monorepo / 未 install） → 走第三步的 dwy-shared 路径
+### 1. clone tag（优先）
 
-### 第三步：读组件 types.d.ts（精确 props + emits）
-
-按存在性回退：
+```bash
+VER=2.4.0                          # 换成第 1 步探测到的版本
+TAG="@dwydev/eui@${VER}"
+DEST=".dwy/eui-src/${VER}"         # 项目内缓存，已 gitignore
 
+if [ ! -d "$DEST/frontend/eui/src" ]; then
+  git clone --depth 1 --branch "$TAG" \
+    --filter=blob:none --sparse \
+    https://github.com/danweiyuancircle/dwy-ai-experience.git \
+    "$DEST"
+  git -C "$DEST" sparse-checkout set frontend/eui/src frontend/eui/package.json
+fi
+# 只读 $DEST/frontend/eui/src/ 的组件 types.ts / .vue
 ```
-a. 优先：<project-root>/node_modules/@dwydev/eui/dist/components/{kebab}/types.d.ts
-   —— 下游消费方默认场景，含完整 props + emits + JSDoc 注释
-
-b. 次选：<dwy-shared-root>/frontend/eui/src/components/{kebab}/types.ts
-   —— 仅当在 dwy-shared monorepo 内或并列 clone 时可用，等价信息
-
-c. 都拿不到 → 退到本文档下方的 [组件目录索引](#组件目录索引)（粗略，仅做导航）
-```
-
-`{kebab}` 是目录名规则：组件名去 `E` 前缀后转 kebab-case。
-- `EButton` → `button`
-- `EDatePicker` → `date-picker`
-- `EAdminLayout` → `admin-layout`
-- `EAIChat` → `ai-chat`（连续大写视为整体）
-
-**不确定目录名时**：`ls node_modules/@dwydev/eui/dist/components/` 或 `ls frontend/eui/src/components/`，**不要靠猜**。
-
-### 第四步：slots 看 .vue 模板（不在 .d.ts 里）
-
-vue-tsc 输出的 `.d.ts` 中，slots 类型大多被擦平成 `any`。需要 slot 用法（默认插槽、具名插槽、作用域插槽）时，读源码 `.vue` 文件，搜索 `<slot` 看模板里实际定义。
-
-- node_modules 路径下 `.vue` 文件**不存在**（只有 .d.ts），slots 必须回 dwy-shared 源码看
-- 拿不到源码时：参考 reka-ui / shadcn-vue 的同名组件 slots 规范，多数 EUI 组件直接转发
-
-### 第五步：冲突时永远信 node_modules
-
-当本 SKILL.md 的描述与消费方项目的 node_modules `.d.ts` 不一致：**无条件以 node_modules 为准**。本文档是导航与心智模型，不是 API 真相。
-
----
-
-## 版本兼容规则
-
-- 本 skill `eui_baseline_version: 2.1.0`，组件索引、composables 列表、踩坑提示都基于这个版本
-- 消费方项目用的是不同版本时（无论更新或更旧），**必须按"查 API 标准动作"流程读 .d.ts**，不要默认本文档准确
-- EUI < 2.1.0 没有 `component-manifest.json`：直接走第三步的 types.d.ts 约定路径
-- 主版本号变更（1.x → 2.x、2.x → 3.x）时，本文档的索引可能完全失效：必须先 `ls node_modules/@dwydev/eui/dist/components/` 重建认知
-
----
-
-## 命名约定
-
-- 组件前缀 `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'`
-- 复合组件用 `provide/inject` 共享状态，子组件目录与主组件同处（如 `command/` 下含 ECommand、ECommandInput、ECommandList...）
-
----
-
-## 重要约束与已知陷阱
-
-源码读不出来的"踩坑经验"，每次写 EUI 代码都遵守：
-
-### 表单
-- **禁止用原生 `<form>` 标签**，所有表单必须用 `<EForm>`。EForm 内置 vee-validate 校验、provide/inject 上下文、统一 label 布局和 reset/validate API，原生 `<form>` 无法集成
-- `ESelect` 的 `option.value` **不能为空字符串**，reka-ui 不支持
-- 表单校验优先用 zod schema 传给 `EForm` 的 `rules` prop
 
-### 弹层
-- `EDialog` body 区域有 `overflow-y-auto`，**首尾位置的 input/select 等表单控件的 focus-ring 会被裁切**。规避：在内容区域加 `p-1` 或 `py-1` padding
-- 弹层组件统一用 `v-model:open` 控制显隐，不要用 `:visible` / `@update:visible`
+- `--branch` 必须是 `@dwydev/eui@x.y.z`（含 `-beta.N`），禁止 clone 默认 branch。
+- 必须 sparse，只要 `frontend/eui/src`。
 
-### reka-ui 绑定约定
-- 封装 reka-ui 组件时统一用 `v-model`（`modelValue` / `update:modelValue`），**不是** `:checked` / `@update:checked`
-- 自己写组件包 reka-ui 原语时必须用 `v-model` 或 writable computed 绑定
+### 2. node_modules（clone 拿不到时）
 
-### 全局配置
-- `EConfigProvider` 必须包裹 App 根组件，提供国际化（locale）/ 默认尺寸 / zIndex
-- `locale.name` 字段必须是 BCP 47 语言标签（如 `zh-CN`、`en-US`），默认 `zh-CN`
-
-### 样式
-- 使用 `cn()` 合并 Tailwind 类名（解决冲突）：`cn('px-2 py-1', isActive && 'bg-primary text-white', className)`
-- 主题切换通过 `useTheme()` 的 `setColorTheme()` / `toggleDark()`，**不要**手动操作 `<html class="dark">`
-
----
-
-## Composables 速查
-
-| Composable | 用途 |
-|------------|------|
-| `useMessage()` | 全局消息提示（success / warning / error / info） |
-| `useNotification()` | 通知（含 title / message / position / duration） |
-| `useMessageBox()` | 对话确认（alert / confirm / prompt），返回 Promise |
-| `useTheme()` | 主题管理（isDark / setTheme / setColorTheme / toggleDark） |
-| `useConfigProvider()` | 读取全局配置（size / zIndex / locale） |
-| `useFormField()` | 表单字段上下文（id / name / valid / error），需在 FormField 内使用 |
-| `useSecureValue()` | 敏感输入安全绑定（DOM property 赋值，避免密码泄露到 HTML attribute） |
-
-精确签名读 `<project-root>/node_modules/@dwydev/eui/dist/composables/{name}.d.ts`。
-
----
-
-## 主题系统
-
-- **Design Tokens**：CSS 自定义属性，定义在 `tokens.css`，前缀 `--`（如 `--primary`、`--background`）
-- **暗色模式**：`dark.css`，通过 `<html class="dark">` 切换（用 `useTheme().toggleDark()`，不手写）
-- **色彩主题**：7 种（neutral / blue / green / rose / orange / violet / slate），通过 `useTheme().setColorTheme()` 切换
-- 样式入口：`import '@dwydev/eui/theme'`
-
----
-
-## 通用类型速查
-
-精确定义读 `<project-root>/node_modules/@dwydev/eui/dist/types.d.ts`。常用：
-
-```ts
-type Size = 'sm' | 'default' | 'lg'
-
-interface Option {
-  label: string
-  value: string | number  // ⚠️ 不能为空字符串
-  disabled?: boolean
-}
-
-interface MenuItem {
-  key: string
-  label: string
-  icon?: string
-  path?: string           // router 模式下的路由路径
-  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
-}
+```bash
+# 版本与清单
+node -p "require('@dwydev/eui/package.json').version"
+ls node_modules/@dwydev/eui/dist/component-manifest.json
+# props/emits：dist/components/{kebab}/types.d.ts
+# slots：.d.ts 常被擦成 any，clone 源码搜 <slot
 ```
 
----
-
-## 组件目录索引
-
-按用途分类的导航表，**只提供组件名 + 一句话用途**，精确 props/emits 一律按 [查 API 标准动作](#查-api-标准动作核心每次用组件前都做) 读 `types.d.ts`。
-
-### 基础展示
-
-| 组件 | 用途 |
-|------|------|
-| `EButton` | 按钮（含 loading 状态） |
-| `EButtonGroup` | 按钮组 |
-| `EBadge` | 标签徽章 |
-| `EAlert` | 警告提示 |
-| `ECard` | 卡片容器 |
-| `ELabel` | 标签文本 |
-| `ESeparator` | 分隔线 |
-| `ETypography` | 排版文本 |
-| `EKbd` | 键盘按键展示 |
-| `ESpinner` | 加载动画 |
-| `EProgress` | 进度条 |
-| `ESkeleton` | 骨架屏 |
-| `EEmpty` | 空状态 |
-| `EAvatar` | 头像 |
-| `EImage` | 图片（含懒加载/预览） |
-| `EAspectRatio` | 宽高比容器 |
-| `EAffix` | 固钉 |
-| `EWatermark` | 水印 |
-
-### 表单输入
-
-| 组件 | 用途 |
-|------|------|
-| `EForm` / `EFormItem` | 表单容器与表单项（必用，禁用原生 form） |
-| `EField` | 字段布局（垂直/水平/响应式） |
-| `EInput` | 输入框（含 password / clearable / 字数统计） |
-| `EInputGroup` | 输入组（含 prefix/suffix addon） |
-| `ETextarea` | 多行输入（含自适应高度） |
-| `ENumberField` | 数字输入 |
-| `ESelect` | 下拉选择（option.value ≠ ''） |
-| `ENativeSelect` | 原生 select |
-| `ECombobox` | 组合框（可输入下拉） |
-| `EAutocomplete` | 自动补全 |
-| `ECheckbox` | 复选框/复选组 |
-| `ERadio` | 单选组 |
-| `ESwitch` | 开关 |
-| `ETagsInput` | 标签输入 |
-| `EDatePicker` | 日期/范围/月/年选择 |
-| `ETimePicker` | 时间选择 |
-| `EColorPicker` | 颜色选择 |
-| `ERate` | 评分 |
-| `ESlider` | 滑块 |
-| `ECascader` | 级联选择 |
-| `ETreeSelect` | 树选择 |
-| `EMention` | @提及输入 |
-| `EInputOTP` | OTP 验证码 |
-| `EPinInput` | PIN 输入 |
-| `EUpload` | 文件上传（含拖拽/图片墙） |
-| `ETransfer` | 穿梭框 |
-
-### 数据展示
-
-| 组件 | 用途 |
-|------|------|
-| `ETable` | 表格（含排序/选择/展开/虚拟滚动/列固定） |
-| `EVirtualTable` | 虚拟滚动表格（大数据专用） |
-| `EDescriptions` | 描述列表 |
-| `ETimeline` | 时间线 |
-| `EStatistic` | 统计数值 |
-| `ETree` | 树形控件 |
-| `ECalendar` | 日历 |
-| `ERangeCalendar` | 日期范围日历 |
-| `EPagination` | 分页 |
-| `EBreadcrumb` | 面包屑 |
-| `EChartContainer` | 图表容器 |
-
-### 弹层与反馈
-
-| 组件 | 用途 |
-|------|------|
-| `EDialog` | 对话框（v-model:open，body 区域 padding 见踩坑提示） |
-| `EDrawer` | 抽屉 |
-| `ESheet` | 侧边面板 |
-| `EAlertDialog` | 确认对话框 |
-| `ETooltip` | 提示气泡 |
-| `EPopover` | 弹出卡片 |
-| `EHoverCard` | 悬停卡片 |
-| `EToast` | 轻提示（配合 useToast / `toast()`） |
-| `EContextMenu` | 右键菜单 |
-
-### 导航与布局
-
-| 组件 | 用途 |
-|------|------|
-| `ETabs` | 标签页 |
-| `EMenu` | 侧边菜单 |
-| `EDropdown` | 下拉菜单 |
-| `EAccordion` | 手风琴 |
-| `ECollapsible` | 折叠面板 |
-| `EStepper` | 步骤条 |
-| `ECarousel` | 轮播 |
-| `EScrollArea` | 自定义滚动区 |
-| `EInfiniteScroll` | 无限滚动 |
-| `EToggle` / `EToggleGroup` | 切换按钮 |
-| `EItem` | 列表项 |
-| `EResizablePanelGroup` 等 | 可调整大小面板（复合组件） |
+`node_modules` 是消费方正在跑的代码，当作安装版本真相。
 
-### 复合组件（子组件需配合使用）
+文档与源码冲突：信源码。clone 与 node_modules 都读到且不一致：以 **node_modules** 为准，回复里写明。
 
-| 主组件 | 用途 |
-|--------|------|
-| `ECommand` | 命令面板（含 ECommandInput / List / Empty / Group / Item / Separator / Shortcut） |
-| `ENavigationMenu` | 导航菜单（含 List / Item / Trigger / Content / Link / Viewport） |
-| `EMenubar` | 菜单栏（含 Menu / Trigger / Content / Item / Separator / Checkbox / Radio / Sub） |
-| `EResizable` | 可调整大小（含 PanelGroup / Panel / Handle） |
+## 文档地图
 
-复合组件的全部子组件名查 `component-manifest.json` 的 `directories[{kebab}].components`。
+| 路径 | 何时读 |
+|------|--------|
+| `shared/form.md` | 禁原生 form、ESelect 空 value、zod rules |
+| `shared/overlay.md` | `v-model:open`、Dialog padding、Sheet zIndex |
+| `shared/reka.md` | 封装 reka 必须 v-model |
+| `shared/config-theme.md` | EConfigProvider、useTheme、cn() |
+| `v2/index.md` | 2.x 组件导航、composables、陷阱 |
+| `v2/lookup.md` | manifest / types.d.ts 怎么查 |
+| `v2/breaking.md` | 2.x 内部 breaking（含 2.4.0 删组件） |
+| `v1/index.md` | 1.x 导航；无 manifest 时怎么查 |
+| `references/eui-integration-guide.md` | 新项目接入 |
+| `references/eui-design-guide.md` | 中后台设计 |
+| `references/eui-landing-design-guide.md` | 落地页设计 |
 
-### 业务组件
+## 禁止
 
-| 组件 | 用途 |
+| 借口 | 实际 |
 |------|------|
-| `EDataPage` | 数据列表页（内置表格 + 分页 + 搜索） |
-| `EFormDialog` | 表单弹窗 |
-| `EConfirmDialog` | 确认弹窗（类型: info / warning / error） |
-| `EAdminLayout` | 后台管理布局（顶部 + 侧边栏 + 主内容） |
-| `EAIChat` | AI 对话 |
-| `ETimetableGrid` | 课程表/时间表 |
-| `EConfigProvider` | 全局配置（必须包裹 App 根） |
+| 读旁边 dwy-shared master | 消费方版本可能不同。先 clone 安装版本的 tag，不行再读本项目 node_modules |
+| 文档是 2.1，装的 2.4.0，差不多 | 有下限的能力必须对照版本；已删组件当不存在 |
+| tag 没有就猜 / 直接停 | clone 失败后读 node_modules；也没有才停 |
+| 再开一个 `dwy-eui-v2` skill | 对外只有 `dwy-eui` |

package/templates/ai-tools/skills/Vue/dwy-eui/references/eui-design-guide.md

@@ -213,7 +213,14 @@ neutral（默认）| blue | green | rose | orange | violet | slate
 | lg | 1024px | 小桌面 |
 | xl | 1280px | 标准桌面 |
 
-中后台页面最小支持 `md`（768px），不强求手机适配。
+中后台**壳**必须在 375px 可用：`EAdminLayout` 默认窄屏抽屉，不要再假设最小 `md`。
+
+| 场景 | 要求 |
+|------|------|
+| 布局壳 | `EAdminLayout` 375px 可开抽屉；顶栏不裁切 |
+| 列表 | 默认横滑。内容型列表（摘要、说明）用 `mobile-layout="stack"` 出卡片键值。操作密的后台表保持 `scroll`。**禁止**页面 `if (isMobile) 删 columns`。`EPagination` 默认 `mode="auto"` |
+| 表单 | 标签置顶 / `EField orientation="responsive"` |
+| 提示 | 禁止 hover-only 作为唯一入口（`ETooltip trigger="auto"`） |
 
 ## 八、ESelect 特殊约束
 

package/templates/ai-tools/skills/Vue/dwy-eui/references/eui-integration-guide.md

@@ -210,37 +210,6 @@ const { isDark, toggleDark, colorTheme, setColorTheme } = useTheme()
 
 ## 7. Composables
 
-### useToast
-
-轻量 toast 通知。需要在根组件挂载 `<EToast />` 容器：
-
-```vue
-<!-- App.vue -->
-<template>
-  <router-view />
-  <EToast rich-colors />
-</template>
-```
-
-使用：
-
-```ts
-import { useToast } from '@dwydev/eui'
-
-const toast = useToast()
-
-toast.success('操作成功')
-toast.error('操作失败')
-toast.warning('警告信息')
-toast.info('提示信息')
-
-// 带描述
-toast.success('保存成功', { description: '数据已持久化' })
-
-// 自定义时长（毫秒）
-toast.info('处理中...', { duration: 5000 })
-```
-
 ### useMessage
 
 ```ts

package/templates/ai-tools/skills/Vue/dwy-eui/shared/config-theme.md

@@ -0,0 +1,8 @@
+# 配置与主题
+
+- **必须**在 App 根包 `EConfigProvider`（locale / 默认尺寸 / zIndex）。缺了日期英文、z-index 乱、文案回退。
+- `locale.name` 用 BCP 47（`zh-CN` / `en-US`），默认 `zh-CN`。
+- 类名合并走 `cn()`（clsx + tailwind-merge）。
+- 主题走 `useTheme()` 的 `setColorTheme` / `toggleDark`，**不要**手改 `<html class="dark">`。
+- 样式入口：`import '@dwydev/eui/theme'`。
+- 轻提示用 `useMessage()`，不要当 Toast 再包一层。

package/templates/ai-tools/skills/Vue/dwy-eui/shared/form.md

@@ -0,0 +1,6 @@
+# 表单
+
+- **禁止原生 `<form>`**，一律 `<EForm>`。EForm 带 vee-validate、provide/inject、label 布局、`reset` / `validate`。
+- `ESelect` 的 `option.value` **不能是 `''`**，reka-ui 不支持。筛选项用哨兵（如 `'all'`），请求时再转 `undefined`。
+- 校验优先 zod schema 交给 `EForm` 的 `rules`。
+- `useFormField` 只在 `EFormItem` 内有值；表单外返回 `null`，不要当 vee-validate `<FormField>` 用。

package/templates/ai-tools/skills/Vue/dwy-eui/shared/overlay.md

@@ -0,0 +1,6 @@
+# 弹层
+
+- 显隐统一 `v-model:open`，不要 `:visible` / `@update:visible`。
+- `EDialog` body 有 `overflow-y-auto`，首尾表单控件的 focus-ring 会被裁。内容区加 `p-1` / `py-1`。
+- `ESheet` 与 `EDrawer` 场景不同：Sheet 侧向覆盖（手机导航），Drawer 底部抓手。不要合成一个组件。
+- `EAlertDialog` / `EConfirmDialog` / `useMessageBox` 场景不同，不要互相替换当「唯一确认框」。

package/templates/ai-tools/skills/Vue/dwy-eui/shared/reka.md

@@ -0,0 +1,5 @@
+# reka-ui 绑定
+
+封装 reka-ui 原语时统一 `v-model`（`modelValue` / `update:modelValue`），**不是** `:checked` / `@update:checked`。
+
+自己写包一层时用 `v-model` 或 writable computed。

package/templates/ai-tools/skills/Vue/dwy-eui/v1/index.md

@@ -0,0 +1,8 @@
+# @dwydev/eui 1.x
+
+1.x 没有 `v2/` 那套删减。精确 API clone `@dwydev/eui@1.y.z` 或读该版本 `node_modules`。
+
+- **没有** `component-manifest.json`（2.1.0 才有）。`ls node_modules/@dwydev/eui/dist/components/` 定位目录。
+- 轻提示可能是 `useToast`，不是 `useMessage`。
+- 可能仍有 `EInputOTP`、`EVirtualTable`、`EDataPage`、`EAIChat` 等；不要按 2.4.0 清单当成已删除。
+- 升 2.4.0 前读 `v2/breaking.md`，全仓替换已删符号。

package/templates/ai-tools/skills/Vue/dwy-eui/v2/breaking.md

@@ -0,0 +1,14 @@
+# 2.x 内部 breaking
+
+2.x 的 minor / beta 也可以不兼容。整条线仍用 `v2/`，破坏点记在这里。细节 clone `@dwydev/eui@x.y.z`，不要另开 `v2.4/` 目录。
+
+完整段落以该 tag 的 `frontend/eui/CHANGELOG.md` 为准。
+
+| 版本 | 破坏点 |
+|------|--------|
+| 2.4.0 | 正式线。删除 `EAIChat`、`ETimetableGrid`、`EDataPage`、`EVirtualTable`、`EInputOTP`、`EChartContainer`、`useToast`。OTP 用 `EPinInput` + `otp`；虚拟表用 `ETable virtual`；轻提示用 `useMessage`。`ETable` 不用 `w-max`，列宽之和写入 `minWidth` |
+| 2.4.0-beta.8 | 上表删除在 beta 线落地；停在 beta.1–7 的项目按此行 |
+| 2.4.0-beta.9 | `ETable` 去掉 `w-max`，长单元格不再把末列撑出视口 |
+| 2.4.0-beta.4 | 曾把表改成 `w-max` 以支持窄屏横滑；被 beta.9 / 2.4.0 修正 |
+
+2.3.0 仍有上表删除前的组件。从 2.3 升 2.4 先全仓搜这些符号。仍停在 2.4.0-beta.N 的项目对照上表对应行，不要用 2.4.0 正式线冒充。

package/templates/ai-tools/skills/Vue/dwy-eui/v2/index.md

@@ -0,0 +1,55 @@
+# @dwydev/eui 2.x
+
+精确签名以安装版本为准（见上级 SKILL.md：先 clone tag，拿不到再读 node_modules）。本页是 2.x 导航与陷阱。
+
+跨大版本不变的表单 / 弹层 / reka / 主题在 `shared/`。查 props 走 `lookup.md`。
+
+## Composables
+
+| 名 | 用途 | 下限 |
+|----|------|------|
+| `useMessage` | 轻提示 success / error / warning / info | |
+| `useNotification` | 带标题通知 | |
+| `useMessageBox` | alert / confirm / prompt，返回 Promise | |
+| `useTheme` | 亮暗与色板 | |
+| `useConfigProvider` | size / zIndex / locale | |
+| `useFormField` | EFormItem 内 id / error；表单外 `null` | 2.4 起不依赖 vee-validate FormField |
+| `useSecureValue` | 密码不写进 HTML attribute | |
+| `useEuiMobile` | `max-width: 767` 是否手机布局 | ≥2.4 |
+
+2.4.0 **删除** `useToast`，改 `useMessage`。仍停在 2.3 的项目读 `breaking.md`。
+
+## 组件导航（只列名）
+
+用途一句话够导航；props 读 types.d.ts。
+
+**展示**：EButton、EButtonGroup、EBadge、EAlert、ECard、ELabel、ESeparator、ETypography、EKbd、ESpinner、EProgress、ESkeleton、EEmpty、EAvatar、EImage、EAspectRatio、EAffix、EWatermark
+
+**表单**：EForm / EFormItem、EField、EInput、EInputGroup、ETextarea、ENumberField、ESelect、ENativeSelect、ECombobox、EAutocomplete、ECheckbox、ERadio、ESwitch、ETagsInput、EDatePicker、ETimePicker、EColorPicker、ERate、ESlider、ECascader、ETreeSelect、EMention、EPinInput（OTP 用 `otp` + `mask`）、EUpload、ETransfer
+
+**数据**：ETable（`virtual` 走 TanStack Virtual）、EDescriptions、ETimeline、EStatistic、ETree、ECalendar、ERangeCalendar、EPagination、EBreadcrumb
+
+**弹层**：EDialog、EDrawer、ESheet、EAlertDialog、ETooltip、EPopover、EHoverCard、EToast（Toaster 挂载点）、EContextMenu、EFormDialog、EConfirmDialog
+
+**布局**：ETabs、EMenu、EDropdown、EAccordion、ECollapsible、EStepper、ECarousel、EScrollArea、EInfiniteScroll、EToggle / EToggleGroup、EItem、EResizable*、ECommand*、ENavigationMenu*、EMenubar*、EAdminLayout、EConfigProvider
+
+已删组件见 `breaking.md`，不要再 import。
+
+## 2.x 陷阱
+
+### 汉堡 / 抽屉
+
+- `ESheet` / `EAdminLayout` 的 Boolean `open` / `mobileOpen` **缺省必须是 `undefined`**，不能是 `false`。`false` 会让非受控开关永远打不开（≥2.4.0）。
+- 关闭态 overlay 必须卸掉（`unmountOnHide`），否则挡住汉堡。
+- 打开态 overlay 用 `EConfigProvider.zIndex`（默认 2000），压过应用顶栏 `z-50`（≥2.4.0）。
+- 手机抽屉打开时 `EAdminLayout` 把 header 槽设 `invisible`，避免用户名和关闭钮抢角（≥2.4.0）。
+
+### ETable
+
+- 列 `width` 用数字 px，不要百分比。表 `minWidth` = 列宽之和：宽于容器横滑，窄于容器铺满（≥2.4.0）。
+- 不要再上 `EVirtualTable`，用 `ETable` 的 `virtual`。
+- 排序对外仍 `@sort` + `TableColumn.sortable`。
+
+### 手机布局
+
+- 断点与 Tailwind `md` 对齐：`max-width: 767`。`useEuiMobile()` 与 `EAdminLayout` / `EPagination` 同一套。

package/templates/ai-tools/skills/Vue/dwy-eui/v2/lookup.md

@@ -0,0 +1,29 @@
+# 2.x 查 API
+
+精确 props/emits **不要**写进 skill。按安装版本读类型。
+
+## manifest（≥2.1.0）
+
+```
+node_modules/@dwydev/eui/dist/component-manifest.json
+```
+
+- 组件名 → `componentToDir["EButton"]` → 目录 `button`
+- `directories["button"].types` → `components/button/types.d.ts`
+- 拼接 `node_modules/@dwydev/eui/dist/` + 该路径
+
+`<2.1.0` 没有 manifest：直接 `ls dist/components/`。
+
+## types
+
+```
+node_modules/@dwydev/eui/dist/components/{kebab}/types.d.ts
+```
+
+`{kebab}`：去 `E` 前缀后 kebab-case（`EDatePicker` → `date-picker`）。不确定就 `ls`，不要猜。
+
+## slots
+
+`.d.ts` 里 slot 常是 `any`。需要具名/作用域插槽时 clone 该版本 tag，在 `frontend/eui/src/components/{kebab}/*.vue` 搜 `<slot`。
+
+npm 包 `files` 不含 `.vue`，`node_modules` 里没有模板。