@a2simcode/ui 0.0.303 → 0.0.305

package/.cursor/skills/ui-component-helper/README.md

@@ -1,86 +1,86 @@
-# UI Component Helper Skill
-
-这是一个 Cursor AI Skill，用于在使用 `@a2simcode/ui`（UI 组件）与 `@a2simcode/dui`（DUI 组件）的项目中，快速获取组件的：
-
-- API（Props / Events / Slots / Methods / Types，来自自动生成的 Meta 文件）
-- 文档说明（Markdown Guide）
-- 示例代码（可选：`docs/examples` 与 `docs-dui/examples`，打包后可能不存在）
-
-## 安装方式
-
-### 方式一：复制到项目本地（推荐）
-
-1. 在你的项目根目录创建 `.cursor/skills/ui-component-helper/` 目录
-2. 将 `node_modules/@a2simcode/ui/.cursor/skills/ui-component-helper/SKILL.md` 复制到 `.cursor/skills/ui-component-helper/SKILL.md`
-
-```bash
-mkdir -p .cursor/skills/ui-component-helper
-cp node_modules/@a2simcode/ui/.cursor/skills/ui-component-helper/SKILL.md .cursor/skills/ui-component-helper/SKILL.md
-```
-
-### 方式二：使用符号链接
-
-```bash
-mkdir -p .cursor/skills
-ln -s ../../node_modules/@a2simcode/ui/.cursor/skills/ui-component-helper .cursor/skills/ui-component-helper
-```
-
-## 使用方法
-
-安装后，当你询问组件用法时，Cursor AI 会自动使用此技能来查找：
-
-- 组件的 Props、Events、Slots 定义（从 Meta 数据文件）
-- 组件的使用文档（从 Markdown 文档）
-- 组件的代码示例（如果示例文件不存在，则基于 Meta + 文档描述生成最小示例）
-
-### 面向第三方项目的目标
-
-该 Skill 的目标是让 AI 在第三方项目里生成“可直接运行的 SimCode UI / DUI 用法”，而不是文档站点内部的 Demo 写法。
-
-- 代码示例应使用真实组件标签（如 `j-button`, `d-drag`），不要输出 `<Demo>`、`<ApiTable>` 这类仅文档站点存在的组件
-- 代码示例的 import 应来自 `@a2simcode/ui` / `@a2simcode/dui`，不要引用 `docs/**`、`packages/**` 这类仅组件库仓库存在的路径
-
-### 查找路径（与最新 UI 库结构一致）
-
-- UI：
-  - Meta：`docs/components/meta/*.ts`
-  - 文档：`docs/components/*.md`
-  - 示例（可选）：`docs/examples/<component>/*.vue`
-- DUI：
-  - Meta：`docs-dui/components/meta/*.ts`
-  - 文档：`docs-dui/components/*.md`
-  - 示例（可选）：`docs-dui/examples/<component>/*.vue`
-
-Skill 会优先从 `node_modules` 查找上述目录；找不到时，会回退到项目源码目录（适用于在组件库仓库内开发时）。
-
-### 命名规则提示
-
-- UI 组件在模板中通常使用 `j-` 前缀（例如 `j-button`, `j-table`），对应的文档/Meta 文件名通常为不带前缀的组件名（例如 `button`, `table`）。
-- DUI 组件在模板中通常使用 `d-` 前缀（例如 `d-drag`），Meta 通常为 kebab-case（例如 `flow-design.ts`）。部分 DUI 文档/示例可能是 camelCase（例如 `flowDesign`），遇到查不到时需要尝试名称变体。
-
-### 推荐的引入方式（第三方最常见）
-
-- UI 全量引入后可直接使用 `j-` 组件标签：
-  - `import SimCodeUI from '@a2simcode/ui'`
-  - `app.use(SimCodeUI)`
-- DUI 全量引入后可直接使用 `d-` 组件标签：
-  - `import Dui from '@a2simcode/dui'`
-  - `app.use(Dui)`
-
-样式文件通常位于 `@a2simcode/ui/dist/style.css` 与 `@a2simcode/dui/dist/style.css`（若你的安装包导出为 `ui.css/dui.css`，以实际文件为准）。
-
-## 示例问题
-
-- "j-button 组件有哪些属性？"
-- "怎么使用 j-table 组件？"
-- "d-drag 组件的 API 是什么？"
-- "给我一个 input 组件的示例"
-- "flowDesign 的 meta 文件在哪？为什么文档叫 flowDesign 但 meta 是 flow-design？"
-- "j-slider-captcha 支持哪些事件？给一个最小示例"
-
-## 注意事项
-
-- 此技能会自动从 `node_modules/@a2simcode/ui` 和 `node_modules/@a2simcode/dui` 中查找文档
-- 如果文档不存在于 node_modules 中，会尝试从项目源码路径查找（适用于开发环境）
-- 打包发布后的第三方环境中可能缺少 `docs/examples` / `docs-dui/examples`，此时以 Meta 与文档为准，并自动生成可运行的最小用法片段
-- 确保已安装 `@a2simcode/ui` 或 `@a2simcode/dui` 包
+# UI Component Helper Skill
+
+这是一个 Cursor AI Skill，用于在使用 `@a2simcode/ui`（UI 组件）与 `@a2simcode/dui`（DUI 组件）的项目中，快速获取组件的：
+
+- API（Props / Events / Slots / Methods / Types，来自自动生成的 Meta 文件）
+- 文档说明（Markdown Guide）
+- 示例代码（可选：`docs/examples` 与 `docs-dui/examples`，打包后可能不存在）
+
+## 安装方式
+
+### 方式一：复制到项目本地（推荐）
+
+1. 在你的项目根目录创建 `.cursor/skills/ui-component-helper/` 目录
+2. 将 `node_modules/@a2simcode/ui/.cursor/skills/ui-component-helper/SKILL.md` 复制到 `.cursor/skills/ui-component-helper/SKILL.md`
+
+```bash
+mkdir -p .cursor/skills/ui-component-helper
+cp node_modules/@a2simcode/ui/.cursor/skills/ui-component-helper/SKILL.md .cursor/skills/ui-component-helper/SKILL.md
+```
+
+### 方式二：使用符号链接
+
+```bash
+mkdir -p .cursor/skills
+ln -s ../../node_modules/@a2simcode/ui/.cursor/skills/ui-component-helper .cursor/skills/ui-component-helper
+```
+
+## 使用方法
+
+安装后，当你询问组件用法时，Cursor AI 会自动使用此技能来查找：
+
+- 组件的 Props、Events、Slots 定义（从 Meta 数据文件）
+- 组件的使用文档（从 Markdown 文档）
+- 组件的代码示例（如果示例文件不存在，则基于 Meta + 文档描述生成最小示例）
+
+### 面向第三方项目的目标
+
+该 Skill 的目标是让 AI 在第三方项目里生成“可直接运行的 SimCode UI / DUI 用法”，而不是文档站点内部的 Demo 写法。
+
+- 代码示例应使用真实组件标签（如 `j-button`, `d-drag`），不要输出 `<Demo>`、`<ApiTable>` 这类仅文档站点存在的组件
+- 代码示例的 import 应来自 `@a2simcode/ui` / `@a2simcode/dui`，不要引用 `docs/**`、`packages/**` 这类仅组件库仓库存在的路径
+
+### 查找路径（与最新 UI 库结构一致）
+
+- UI：
+  - Meta：`docs/components/meta/*.ts`
+  - 文档：`docs/components/*.md`
+  - 示例（可选）：`docs/examples/<component>/*.vue`
+- DUI：
+  - Meta：`docs-dui/components/meta/*.ts`
+  - 文档：`docs-dui/components/*.md`
+  - 示例（可选）：`docs-dui/examples/<component>/*.vue`
+
+Skill 会优先从 `node_modules` 查找上述目录；找不到时，会回退到项目源码目录（适用于在组件库仓库内开发时）。
+
+### 命名规则提示
+
+- UI 组件在模板中通常使用 `j-` 前缀（例如 `j-button`, `j-table`），对应的文档/Meta 文件名通常为不带前缀的组件名（例如 `button`, `table`）。
+- DUI 组件在模板中通常使用 `d-` 前缀（例如 `d-drag`），Meta 通常为 kebab-case（例如 `flow-design.ts`）。部分 DUI 文档/示例可能是 camelCase（例如 `flowDesign`），遇到查不到时需要尝试名称变体。
+
+### 推荐的引入方式（第三方最常见）
+
+- UI 全量引入后可直接使用 `j-` 组件标签：
+  - `import SimCodeUI from '@a2simcode/ui'`
+  - `app.use(SimCodeUI)`
+- DUI 全量引入后可直接使用 `d-` 组件标签：
+  - `import Dui from '@a2simcode/dui'`
+  - `app.use(Dui)`
+
+样式文件通常位于 `@a2simcode/ui/dist/style.css` 与 `@a2simcode/dui/dist/style.css`（若你的安装包导出为 `ui.css/dui.css`，以实际文件为准）。
+
+## 示例问题
+
+- "j-button 组件有哪些属性？"
+- "怎么使用 j-table 组件？"
+- "d-drag 组件的 API 是什么？"
+- "给我一个 input 组件的示例"
+- "flowDesign 的 meta 文件在哪？为什么文档叫 flowDesign 但 meta 是 flow-design？"
+- "j-slider-captcha 支持哪些事件？给一个最小示例"
+
+## 注意事项
+
+- 此技能会自动从 `node_modules/@a2simcode/ui` 和 `node_modules/@a2simcode/dui` 中查找文档
+- 如果文档不存在于 node_modules 中，会尝试从项目源码路径查找（适用于开发环境）
+- 打包发布后的第三方环境中可能缺少 `docs/examples` / `docs-dui/examples`，此时以 Meta 与文档为准，并自动生成可运行的最小用法片段
+- 确保已安装 `@a2simcode/ui` 或 `@a2simcode/dui` 包

package/.cursor/skills/ui-component-helper/SKILL.md

@@ -1,115 +1,115 @@
----
-name: 'ui-component-helper'
-description: '获取 @a2simcode/ui 和 @a2simcode/dui 组件的使用说明、Props 定义和示例。当用户询问组件用法或编写组件代码时调用。'
----
-
-# UI Component Helper
-
-此 Skill 用于帮助用户查找和理解 `@a2simcode/ui`（UI 组件）与 `@a2simcode/dui`（DUI 组件）的使用方法。它会结合 **API 元数据（Meta）**、**文档说明（Guide）**、（可选的）**示例（Examples）** 与 **源码（Source）** 来输出可直接使用的答案（包含 Props / Events / Slots / Methods / Types 与代码示例）。
-
-## 查找策略
-
-**优先级：Meta (API) > 文档说明 (Guide) > 示例 (Examples，可选) > 源码 (Source)**
-
-### 组件命名与映射规则
-
-1. UI 组件通常在模板里使用 `j-` 前缀（例如 `j-button`, `j-table`），对应源码组件名常为 `JButton`, `JTable`，文档与 Meta 的文件名通常不带前缀（例如 `button`, `table`）。
-2. DUI 组件通常在模板里使用 `d-` 前缀（例如 `d-drag`, `d-draggable`），对应源码组件名常为 `DDrag`, `DDraggable`，Meta 文件名通常为 kebab-case（例如 `drag`, `flow-design`）。
-3. DUI 的文档（`docs-dui/components/*.md`）与示例目录（`docs-dui/examples/*/`）在部分组件上可能使用 camelCase（例如 `flowDesign`），而 Meta 仍然是 kebab-case（例如 `flow-design.ts`）。当名称对不上时，务必尝试名称变体（见“定位组件和 API 定义”）。
-
-### 路径查找策略
-
-首先尝试从 npm 包中查找（适用于通过 npm 安装的项目），如果找不到则尝试从项目源码中查找：
-
-1. **优先查找 node_modules**：
-   - UI 组件 Meta: `node_modules/@a2simcode/ui/docs/components/meta/`
-   - DUI 组件 Meta: `node_modules/@a2simcode/dui/docs-dui/components/meta/`
-   - UI 组件文档: `node_modules/@a2simcode/ui/docs/components/`
-   - DUI 组件文档: `node_modules/@a2simcode/dui/docs-dui/components/`
-   - UI 组件示例: `node_modules/@a2simcode/ui/docs/examples/`
-   - DUI 组件示例: `node_modules/@a2simcode/dui/docs-dui/examples/`
-
-2. **备选：项目源码路径**（开发环境）：
-   - UI 组件 Meta: `docs/components/meta/`
-   - DUI 组件 Meta: `docs-dui/components/meta/`
-   - UI 组件文档: `docs/components/`
-   - DUI 组件文档: `docs-dui/components/`
-   - UI 组件示例: `docs/examples/`
-   - DUI 组件示例: `docs-dui/examples/`
-
-## 核心步骤
-
-### 输出规则（面向第三方可运行代码）
-
-1. 示例代码必须是“业务项目可直接使用”的写法：
-   - 使用真实组件标签（如 `j-button`, `j-table`, `d-drag`），不要输出文档站点专用的 `<Demo>`、`<ApiTable>` 等组件
-   - import 仅允许来自 `@a2simcode/ui` / `@a2simcode/dui`（或用户项目的既有代码），不要引用 `docs/**`、`docs-dui/**`、`packages/**`
-2. 当用户未说明安装方式时，默认采用“全量引入 + 全局注册”的使用习惯：
-   - UI：`app.use(SimCodeUI)` 后，用 `<j-button />` 这种 kebab-case 标签
-   - DUI：`app.use(Dui)` 后，用 `<d-drag />` 这种 kebab-case 标签
-3. 当用户明确“按需引入”或不想全局注册时：
-   - 提供 `import { JButton } from '@a2simcode/ui'` / `import { DDrag } from '@a2simcode/dui'` 的写法
-   - 模板中优先使用 PascalCase（如 `<JButton />` / `<DDrag />`），避免 Vue `<script setup>` 无法自动识别 kebab-case 的问题
-
-### 第一步：定位组件和 API 定义
-
-1. **识别用户输入的组件标识**：
-   - 若输入是模板标签：去掉 `j-` / `d-` 前缀，得到基础名，例如 `j-button` → `button`，`d-drag` → `drag`。
-   - 若输入是源码组件名：`JButton` / `DDrag` 通常可转换为 `button` / `drag`。
-   - 对 DUI 组件，若名称不匹配（例如 `flowDesign`），需要额外尝试 kebab-case 变体（例如 `flow-design`）。
-2. **查找 Meta 数据**（按优先级顺序，Meta 是回答 Props/Events/Slots/Methods/Types 的最权威来源）：
-   - 首先尝试：`node_modules/@a2simcode/ui/docs/components/meta/<component>.ts` 或 `node_modules/@a2simcode/dui/docs-dui/components/meta/<component>.ts`
-   - 如果不存在，尝试：`docs/components/meta/<component>.ts` 或 `docs-dui/components/meta/<component>.ts`
-   - 若 DUI 查不到：
-     - 尝试将 `<component>` 替换为 kebab-case（例如 `flowDesign` → `flow-design`）
-     - 再尝试将 `<component>` 替换为原始输入（可能文档/示例使用 camelCase，而 Meta 使用 kebab-case）
-   - **关键**：读取 Meta 文件以获取结构化的 `props`, `events`, `slots`, `methods`, `types`。这是回答“有哪些属性/参数/类型”的最准确来源。
-
-### 第二步：查找文档和示例
-
-1. **查找 Markdown 文档**（按优先级顺序）：
-   - 首先尝试：`node_modules/@a2simcode/ui/docs/components/<component>.md` 或 `node_modules/@a2simcode/dui/docs-dui/components/<component>.md`
-   - 如果不存在，尝试：`docs/components/<component>.md` 或 `docs-dui/components/<component>.md`
-   - 获取组件的功能描述。
-
-2. **查找示例代码（可选）**（按优先级顺序）：
-   - 首先尝试：`node_modules/@a2simcode/ui/docs/examples/<component>/basic.vue` 或 `node_modules/@a2simcode/dui/docs-dui/examples/<component>/basic.vue`
-   - 如果不存在，尝试：`docs/examples/<component>/basic.vue` 或 `docs-dui/examples/<component>/basic.vue`
-   - 若 DUI 示例目录找不到：
-     - 尝试 `<component>` 的 camelCase / kebab-case 变体（示例目录与文档命名可能不同）
-   - 优先查看 `basic.vue`（基础用法），再按需查看同目录下其它示例（例如 `disabled.vue`, `events.vue`, `methods.vue` 等）。
-
-### 第三步：查阅源码 (备选)
-
-- 仅当 Meta 数据和文档都缺失，或需要了解内部实现细节时，才去查看源码：
-  - UI: `node_modules/@a2simcode/ui/packages/components/` 或 `packages/components/`
-  - DUI: `node_modules/@a2simcode/dui/packages/components-dui/` 或 `packages/components-dui/`
-  - 若在开发仓库中仍无法定位 DUI 组件的真实源码路径，可参考映射配置：`scripts/dui-component-map.ts`（以组件名映射到源码路径与 Meta 输出路径）。
-
-### 第四步：综合回答
-
-1. **功能概述**：基于 Markdown 文档，说明用途与关键点。
-2. **API 详细说明**：基于 Meta (`.ts`) 列出 Props / Events / Slots / Methods / Types，并包含类型与默认值。
-3. **代码示例**：
-   - 若存在 `examples/`：优先引用其中的用法
-   - 若不存在 `examples/`（第三方安装包中常见）：基于 Meta 的 props / events 与组件命名规则生成“最小可运行示例”，避免依赖文档站点内部的 demo 组件
-
-## 常用组件映射
-
-- UI:
-  - `j-button` → `docs/components/button.md` + `docs/components/meta/button.ts`（`docs/examples/button/` 可选）
-  - `j-table` → `docs/components/table.md` + `docs/components/meta/table.ts`（`docs/examples/table/` 可选）
-  - `j-slider-captcha` → `docs/components/slider-captcha.md` + `docs/components/meta/slider-captcha.ts`（`docs/examples/slider-captcha/` 可选）
-- DUI:
-  - `d-drag` → `docs-dui/components/drag.md` + `docs-dui/components/meta/drag.ts`（`docs-dui/examples/drag/` 可选）
-  - `d-draggable` → `docs-dui/components/draggable.md` + `docs-dui/components/meta/draggable.ts`（`docs-dui/examples/draggable/` 可选）
-  - `flowDesign`（文档/示例）→ `docs-dui/components/flowDesign.md`（可能存在）+（可选）`docs-dui/examples/flowDesign/`；对应 Meta 通常为 `docs-dui/components/meta/flow-design.ts`
-
-## 行动指南
-
-当用户询问"怎么用 [组件名]"或"[组件名] 有哪些属性"时：
-
-1. **首选**：读取 `node_modules/@a2simcode/ui/docs/components/meta/[组件名].ts` 或 `node_modules/@a2simcode/dui/docs-dui/components/meta/[组件名].ts` 获取 API 参数（如果不存在，尝试项目源码路径）。
-2. **次选**：读取 `node_modules/@a2simcode/ui/docs/components/[组件名].md` 获取描述（如果不存在，尝试项目源码路径）。
-3. **可选**：若存在示例目录，读取 `node_modules/@a2simcode/ui/docs/examples/[组件名]/basic.vue` 获取基础示例（如果不存在，尝试项目源码路径）。
-4. **回答**：输出“功能概述 + API 清单 + 可运行示例”。当示例目录缺失时，示例由 Meta 与命名规则自动生成。
+---
+name: 'ui-component-helper'
+description: '获取 @a2simcode/ui 和 @a2simcode/dui 组件的使用说明、Props 定义和示例。当用户询问组件用法或编写组件代码时调用。'
+---
+
+# UI Component Helper
+
+此 Skill 用于帮助用户查找和理解 `@a2simcode/ui`（UI 组件）与 `@a2simcode/dui`（DUI 组件）的使用方法。它会结合 **API 元数据（Meta）**、**文档说明（Guide）**、（可选的）**示例（Examples）** 与 **源码（Source）** 来输出可直接使用的答案（包含 Props / Events / Slots / Methods / Types 与代码示例）。
+
+## 查找策略
+
+**优先级：Meta (API) > 文档说明 (Guide) > 示例 (Examples，可选) > 源码 (Source)**
+
+### 组件命名与映射规则
+
+1. UI 组件通常在模板里使用 `j-` 前缀（例如 `j-button`, `j-table`），对应源码组件名常为 `JButton`, `JTable`，文档与 Meta 的文件名通常不带前缀（例如 `button`, `table`）。
+2. DUI 组件通常在模板里使用 `d-` 前缀（例如 `d-drag`, `d-draggable`），对应源码组件名常为 `DDrag`, `DDraggable`，Meta 文件名通常为 kebab-case（例如 `drag`, `flow-design`）。
+3. DUI 的文档（`docs-dui/components/*.md`）与示例目录（`docs-dui/examples/*/`）在部分组件上可能使用 camelCase（例如 `flowDesign`），而 Meta 仍然是 kebab-case（例如 `flow-design.ts`）。当名称对不上时，务必尝试名称变体（见“定位组件和 API 定义”）。
+
+### 路径查找策略
+
+首先尝试从 npm 包中查找（适用于通过 npm 安装的项目），如果找不到则尝试从项目源码中查找：
+
+1. **优先查找 node_modules**：
+   - UI 组件 Meta: `node_modules/@a2simcode/ui/docs/components/meta/`
+   - DUI 组件 Meta: `node_modules/@a2simcode/dui/docs-dui/components/meta/`
+   - UI 组件文档: `node_modules/@a2simcode/ui/docs/components/`
+   - DUI 组件文档: `node_modules/@a2simcode/dui/docs-dui/components/`
+   - UI 组件示例: `node_modules/@a2simcode/ui/docs/examples/`
+   - DUI 组件示例: `node_modules/@a2simcode/dui/docs-dui/examples/`
+
+2. **备选：项目源码路径**（开发环境）：
+   - UI 组件 Meta: `docs/components/meta/`
+   - DUI 组件 Meta: `docs-dui/components/meta/`
+   - UI 组件文档: `docs/components/`
+   - DUI 组件文档: `docs-dui/components/`
+   - UI 组件示例: `docs/examples/`
+   - DUI 组件示例: `docs-dui/examples/`
+
+## 核心步骤
+
+### 输出规则（面向第三方可运行代码）
+
+1. 示例代码必须是“业务项目可直接使用”的写法：
+   - 使用真实组件标签（如 `j-button`, `j-table`, `d-drag`），不要输出文档站点专用的 `<Demo>`、`<ApiTable>` 等组件
+   - import 仅允许来自 `@a2simcode/ui` / `@a2simcode/dui`（或用户项目的既有代码），不要引用 `docs/**`、`docs-dui/**`、`packages/**`
+2. 当用户未说明安装方式时，默认采用“全量引入 + 全局注册”的使用习惯：
+   - UI：`app.use(SimCodeUI)` 后，用 `<j-button />` 这种 kebab-case 标签
+   - DUI：`app.use(Dui)` 后，用 `<d-drag />` 这种 kebab-case 标签
+3. 当用户明确“按需引入”或不想全局注册时：
+   - 提供 `import { JButton } from '@a2simcode/ui'` / `import { DDrag } from '@a2simcode/dui'` 的写法
+   - 模板中优先使用 PascalCase（如 `<JButton />` / `<DDrag />`），避免 Vue `<script setup>` 无法自动识别 kebab-case 的问题
+
+### 第一步：定位组件和 API 定义
+
+1. **识别用户输入的组件标识**：
+   - 若输入是模板标签：去掉 `j-` / `d-` 前缀，得到基础名，例如 `j-button` → `button`，`d-drag` → `drag`。
+   - 若输入是源码组件名：`JButton` / `DDrag` 通常可转换为 `button` / `drag`。
+   - 对 DUI 组件，若名称不匹配（例如 `flowDesign`），需要额外尝试 kebab-case 变体（例如 `flow-design`）。
+2. **查找 Meta 数据**（按优先级顺序，Meta 是回答 Props/Events/Slots/Methods/Types 的最权威来源）：
+   - 首先尝试：`node_modules/@a2simcode/ui/docs/components/meta/<component>.ts` 或 `node_modules/@a2simcode/dui/docs-dui/components/meta/<component>.ts`
+   - 如果不存在，尝试：`docs/components/meta/<component>.ts` 或 `docs-dui/components/meta/<component>.ts`
+   - 若 DUI 查不到：
+     - 尝试将 `<component>` 替换为 kebab-case（例如 `flowDesign` → `flow-design`）
+     - 再尝试将 `<component>` 替换为原始输入（可能文档/示例使用 camelCase，而 Meta 使用 kebab-case）
+   - **关键**：读取 Meta 文件以获取结构化的 `props`, `events`, `slots`, `methods`, `types`。这是回答“有哪些属性/参数/类型”的最准确来源。
+
+### 第二步：查找文档和示例
+
+1. **查找 Markdown 文档**（按优先级顺序）：
+   - 首先尝试：`node_modules/@a2simcode/ui/docs/components/<component>.md` 或 `node_modules/@a2simcode/dui/docs-dui/components/<component>.md`
+   - 如果不存在，尝试：`docs/components/<component>.md` 或 `docs-dui/components/<component>.md`
+   - 获取组件的功能描述。
+
+2. **查找示例代码（可选）**（按优先级顺序）：
+   - 首先尝试：`node_modules/@a2simcode/ui/docs/examples/<component>/basic.vue` 或 `node_modules/@a2simcode/dui/docs-dui/examples/<component>/basic.vue`
+   - 如果不存在，尝试：`docs/examples/<component>/basic.vue` 或 `docs-dui/examples/<component>/basic.vue`
+   - 若 DUI 示例目录找不到：
+     - 尝试 `<component>` 的 camelCase / kebab-case 变体（示例目录与文档命名可能不同）
+   - 优先查看 `basic.vue`（基础用法），再按需查看同目录下其它示例（例如 `disabled.vue`, `events.vue`, `methods.vue` 等）。
+
+### 第三步：查阅源码 (备选)
+
+- 仅当 Meta 数据和文档都缺失，或需要了解内部实现细节时，才去查看源码：
+  - UI: `node_modules/@a2simcode/ui/packages/components/` 或 `packages/components/`
+  - DUI: `node_modules/@a2simcode/dui/packages/components-dui/` 或 `packages/components-dui/`
+  - 若在开发仓库中仍无法定位 DUI 组件的真实源码路径，可参考映射配置：`scripts/dui-component-map.ts`（以组件名映射到源码路径与 Meta 输出路径）。
+
+### 第四步：综合回答
+
+1. **功能概述**：基于 Markdown 文档，说明用途与关键点。
+2. **API 详细说明**：基于 Meta (`.ts`) 列出 Props / Events / Slots / Methods / Types，并包含类型与默认值。
+3. **代码示例**：
+   - 若存在 `examples/`：优先引用其中的用法
+   - 若不存在 `examples/`（第三方安装包中常见）：基于 Meta 的 props / events 与组件命名规则生成“最小可运行示例”，避免依赖文档站点内部的 demo 组件
+
+## 常用组件映射
+
+- UI:
+  - `j-button` → `docs/components/button.md` + `docs/components/meta/button.ts`（`docs/examples/button/` 可选）
+  - `j-table` → `docs/components/table.md` + `docs/components/meta/table.ts`（`docs/examples/table/` 可选）
+  - `j-slider-captcha` → `docs/components/slider-captcha.md` + `docs/components/meta/slider-captcha.ts`（`docs/examples/slider-captcha/` 可选）
+- DUI:
+  - `d-drag` → `docs-dui/components/drag.md` + `docs-dui/components/meta/drag.ts`（`docs-dui/examples/drag/` 可选）
+  - `d-draggable` → `docs-dui/components/draggable.md` + `docs-dui/components/meta/draggable.ts`（`docs-dui/examples/draggable/` 可选）
+  - `flowDesign`（文档/示例）→ `docs-dui/components/flowDesign.md`（可能存在）+（可选）`docs-dui/examples/flowDesign/`；对应 Meta 通常为 `docs-dui/components/meta/flow-design.ts`
+
+## 行动指南
+
+当用户询问"怎么用 [组件名]"或"[组件名] 有哪些属性"时：
+
+1. **首选**：读取 `node_modules/@a2simcode/ui/docs/components/meta/[组件名].ts` 或 `node_modules/@a2simcode/dui/docs-dui/components/meta/[组件名].ts` 获取 API 参数（如果不存在，尝试项目源码路径）。
+2. **次选**：读取 `node_modules/@a2simcode/ui/docs/components/[组件名].md` 获取描述（如果不存在，尝试项目源码路径）。
+3. **可选**：若存在示例目录，读取 `node_modules/@a2simcode/ui/docs/examples/[组件名]/basic.vue` 获取基础示例（如果不存在，尝试项目源码路径）。
+4. **回答**：输出“功能概述 + API 清单 + 可运行示例”。当示例目录缺失时，示例由 Meta 与命名规则自动生成。

package/LICENSE

@@ -1,53 +1,53 @@
-专有软件许可协议
-
-版权所有 © 2024 苏州极简搭信息技术有限公司。保留所有权利。
-
-本软件及其相关文档("软件")为专有软件,受版权法和国际条约保护。
-
-许可限制:
-
-1. 本软件仅授权给获得明确书面许可的用户使用。
-
-2. 未经版权所有者事先书面同意,您不得:
-   - 复制、修改、改编或翻译本软件
-   - 对本软件进行反向工程、反编译或反汇编
-   - 出租、出借、分发、转让或再许可本软件
-   - 删除或修改本软件中的任何版权声明或其他所有权标记
-
-3. 本软件按"现状"提供,不提供任何明示或暗示的保证,包括但不限于适销性、特定用途适用性和非侵权性的保证。
-
-4. 在任何情况下,版权所有者均不对因使用或无法使用本软件而产生的任何索赔、损害或其他责任负责。
-
-5. 本许可协议受中华人民共和国法律管辖。
-
-如需获得使用许可,请联系版权所有者。
-
----
-
-PROPRIETARY SOFTWARE LICENSE
-
-Copyright © 2024 Suzhou Jijian-da Information Technology Co., Ltd. All rights reserved.
-
-This software and associated documentation files (the "Software") is proprietary 
-software protected by copyright laws and international treaties.
-
-License Restrictions:
-
-1. This Software is licensed only to users who have obtained explicit written permission.
-
-2. Without prior written consent from the copyright holder, you may not:
-   - Copy, modify, adapt, or translate the Software
-   - Reverse engineer, decompile, or disassemble the Software
-   - Rent, lease, distribute, transfer, or sublicense the Software
-   - Remove or modify any copyright notices or other proprietary markings in the Software
-
-3. The Software is provided "as is" without warranty of any kind, express or implied, 
-   including but not limited to warranties of merchantability, fitness for a particular 
-   purpose, and non-infringement.
-
-4. In no event shall the copyright holder be liable for any claims, damages, or other 
-   liability arising from the use or inability to use the Software.
-
-5. This license agreement is governed by the laws of the People's Republic of China.
-
-For licensing inquiries, please contact the copyright holder.
+专有软件许可协议
+
+版权所有 © 2024 苏州极简搭信息技术有限公司。保留所有权利。
+
+本软件及其相关文档("软件")为专有软件,受版权法和国际条约保护。
+
+许可限制:
+
+1. 本软件仅授权给获得明确书面许可的用户使用。
+
+2. 未经版权所有者事先书面同意,您不得:
+   - 复制、修改、改编或翻译本软件
+   - 对本软件进行反向工程、反编译或反汇编
+   - 出租、出借、分发、转让或再许可本软件
+   - 删除或修改本软件中的任何版权声明或其他所有权标记
+
+3. 本软件按"现状"提供,不提供任何明示或暗示的保证,包括但不限于适销性、特定用途适用性和非侵权性的保证。
+
+4. 在任何情况下,版权所有者均不对因使用或无法使用本软件而产生的任何索赔、损害或其他责任负责。
+
+5. 本许可协议受中华人民共和国法律管辖。
+
+如需获得使用许可,请联系版权所有者。
+
+---
+
+PROPRIETARY SOFTWARE LICENSE
+
+Copyright © 2024 Suzhou Jijian-da Information Technology Co., Ltd. All rights reserved.
+
+This software and associated documentation files (the "Software") is proprietary 
+software protected by copyright laws and international treaties.
+
+License Restrictions:
+
+1. This Software is licensed only to users who have obtained explicit written permission.
+
+2. Without prior written consent from the copyright holder, you may not:
+   - Copy, modify, adapt, or translate the Software
+   - Reverse engineer, decompile, or disassemble the Software
+   - Rent, lease, distribute, transfer, or sublicense the Software
+   - Remove or modify any copyright notices or other proprietary markings in the Software
+
+3. The Software is provided "as is" without warranty of any kind, express or implied, 
+   including but not limited to warranties of merchantability, fitness for a particular 
+   purpose, and non-infringement.
+
+4. In no event shall the copyright holder be liable for any claims, damages, or other 
+   liability arising from the use or inability to use the Software.
+
+5. This license agreement is governed by the laws of the People's Republic of China.
+
+For licensing inquiries, please contact the copyright holder.