@qin-ui/element-plus-pro 1.0.7 → 1.0.8

package/AI-CONTEXT.md

@@ -1,37 +1,229 @@
-# @qin-ui/element-plus-pro
+# @qin-ui/element-plus-pro — AI 上下文
 
-> 基于 Element Plus 的配置驱动表单和表格组件库。
+基于 **element-plus**（Vue 3，el- 前缀）的 Schema 驱动高级组件库。用 JS 对象描述 UI，而非模板堆砌组件标签。
 
-## 安装
+---
 
-```bash
-npm install @qin-ui/element-plus-pro element-plus vue
+## 1. 架构概览
+
+### 1.1 三层架构
+
+```
+┌─────────────────────────────────────────────────┐
+│  Field[] 配置层（用户编写的 JS 对象）             │
+│  { path:'name', component:'input', span:8, ... } │
+├─────────────────────────────────────────────────┤
+│  @qin-ui/element-plus-pro（Schema 解析 + 组件解析）│
+│  属性分层剥离 → Grid→el-col, FormItem→el-form-item, 剩余→输入控件 │
+├─────────────────────────────────────────────────┤
+│  element-plus（Vue 3 组件库，el- 前缀）           │
+│  el-input / el-select / el-date-picker / el-table ...│
+└─────────────────────────────────────────────────┘
+```
+
+ProForm/ProTable 是**渲染引擎**，不是组件库。Field 属性被逐层剥离，分发到不同层级的 el-* 组件。
+
+### 1.2 内置组件映射表
+
+| Field `component` | 渲染的 el 组件 | 子类型（`type`） | 常用透传 Props（示例） |
+| :--- | :--- | :--- | :--- |
+| `'input'` | el-input | textarea, password | placeholder, maxlength, clearable, showWordLimit, showPassword, autosize |
+| `'input-number'` | el-input-number | — | min, max, step, precision, controls, placeholder |
+| `'autocomplete'` | el-autocomplete | — | placeholder, clearable, fetchSuggestions, triggerOnFocus |
+| `'select'` | el-select | — | **options**, multiple, filterable, clearable, allowCreate, loading, remote, remoteMethod |
+| `'cascader'` | el-cascader | — | **options**, props, filterable, clearable, showAllLevels |
+| `'date-picker'` | el-date-picker | date, daterange, datetime, datetimerange, week, month, monthrange, year, yearrange | format, valueFormat, disabledDate, clearable, startPlaceholder, endPlaceholder, shortcuts |
+| `'time-picker'` | el-time-picker | — | format, clearable, isRange, startPlaceholder, endPlaceholder |
+| `'time-select'` | el-time-select | — | start, end, step, clearable, minTime, maxTime |
+| `'checkbox-group'` | el-checkbox-group | — | **options**, min, max, disabled |
+| `'radio-group'` | el-radio-group | — | **options**, disabled, size |
+| `'switch'` | el-switch | — | activeText, inactiveText, activeValue, inactiveValue, loading, size |
+| `'slider'` | el-slider | — | min, max, step, showStops, range, marks |
+| `'tree-select'` | el-tree-select | — | **data**, filterable, clearable, checkStrictly, props, multiple, showCheckbox |
+| `'transfer'` | el-transfer | — | **data**, **titles**, filterable, filterMethod, props |
+| `'custom'` | 自定义 | — | component 直接传入 Vue 组件或 h() 渲染函数 |
+
+> **编写任何控件属性前，必须查阅 [element-plus 官方文档](https://element-plus.org/) 确认属性名和类型。**
+
+---
+
+## 2. 属性分层传递（核心规则）
+
+Field 属性按渲染目标逐层剥离：
+
+```
+<el-col :span="8">              <!-- Grid 层 -->
+  <el-form-item label="城市">    <!-- FormItem 层 -->
+    <el-select v-model="..." placeholder="选择" />  <!-- 输入控件层 -->
+  </el-form-item>
+</el-col>
 ```
 
-## 核心导出
+**Grid 层 → `<el-col>`**（仅 grid 启用时）：`span`, `offset`, `push`, `pull`, `xs`, `sm`, `md`, `lg`, `xl`
+
+**FormItem 层 → `<el-form-item>`**：`label`, `rules`, `error`, `required`, `size`, `showMessage`, `inlineMessage`, `labelWidth`；`formItemClass`/`formItemStyle`→`class`/`style`；`formItemDataAttrs`→`data-*`
 
-### 组件
+**输入控件层 → 输入组件**：其余所有属性（`disabled`, `placeholder`, `clearable`, `options`, `filterable`, `maxlength`, `multiple` 等）；`componentClass`/`componentStyle`→`class`/`style`；`componentDataAttrs`→`data-*`
 
-- `ProForm` - 配置驱动表单组件
-- `ProTable` - 配置驱动表格组件
-- `ProComponentProvider` - 全局配置提供者
+**渲染逻辑消费（不绑定 DOM）**：`component`, `fields`, `hidden`, `slots`, `modelProp`, `valueFormatter`, `componentContainer`, `extraProps`
 
-### Hooks
+### 2.1 modelProp
 
-- `useForm<D>()` - 创建表单实例
-- `useFields<D>()` - 字段配置管理
-- `useFormRef()` - 表单组件引用
-- `useTable<D, T>()` - 创建表格实例
+决定 `v-model:xxx` 的绑定变量名：
 
-## 字段配置（Field）
+- 默认 `modelProp: 'modelValue'` → `v-model`（element-plus 惯例）
+- **ProComponentProvider 已为 `switch` 预设 `modelProp: 'modelValue'`**，通常无需手动指定
+- 自定义场景：`modelProp: 'visible'` → `v-model:visible`
+
+### 2.2 element-plus 命名约定
+
+- 使用 `clearable`（不是 `allowClear`）
+- el-form-item 插槽为 `label` 和 `error`；其他 slot key 透传到底层输入组件（如 el-input 的 `prefix`/`suffix`/`append`/`prepend`）
+
+---
+
+## 3. 渐进式用法
+
+### 第一阶段：基础渲染
+
+完全依赖 Field 配置，**禁止手写 `<el-form-item>` 或 `<el-input>`**。
+
+```ts
+const form = useForm({ username: '', password: '' }, [
+  { path: 'username', component: 'input', label: '用户名', placeholder: '请输入',
+    rules: [{ required: true, message: '请输入用户名', trigger: 'blur' }] },
+  { path: 'password', component: 'input', type: 'password', label: '密码',
+    rules: [{ required: true, message: '请输入密码', trigger: 'blur' }] },
+]);
+// 模板：<ProForm :form="form" />
+```
+
+### 第二阶段：字段联动
+
+`disabled`, `hidden`, `rules` 等控制属性支持三种方式：
+
+```ts
+// computed() — 声明式，初始化联动首选
+disabled: computed(() => !form.formData.hasLimit),
+
+// ref() — 外部共享状态
+const isDisabled = ref(false);
+
+// setField() — 运行时命令式
+form.setField('limitCount', { disabled: true });
+```
+
+**选择：初始化联动→`computed()`；事件触发→`setField()`；共享状态→`ref()`。**
+
+### 第三阶段：自定义组件
+
+```ts
+// h() 挂载自定义组件
+{ path: 'key', component: (p, ctx) => h(CustomInput, { ...p, ...ctx.attrs }) }
+```
+
+```html
+<!-- 同名插槽接管渲染，scoped 内置所有绑定参数 -->
+<ProForm :form="form">
+  <template #agreement="scoped">
+    <el-checkbox v-bind="scoped">阅读并同意协议</el-checkbox>
+  </template>
+</ProForm>
+```
+
+---
+
+## 4. 反模式
+
+```html
+<!-- ❌ 禁止在 ProForm 内手写 el-form-item -->
+<ProForm :form="form">
+  <el-form-item label="姓名"><el-input v-model="form.formData.name" /></el-form-item>
+</ProForm>
+```
+
+```ts
+// ❌ 不查文档盲目猜测 — element-plus 用 filterable，不是 searchable
+{ path: 'city', component: 'select', searchable: true }
+// ✅ 查 element-plus 文档确认后
+{ path: 'city', component: 'select', filterable: true }
+
+// span→Grid 层(el-col)；placeholder→控件层(el-input)
+{ path: 'name', component: 'input', span: 12, placeholder: '请输入' }
+```
+
+---
+
+## 5. ProComponentProvider：全局默认配置
+
+统一配置子组件默认属性，避免逐字段重复。
+
+### INJECT_CONFIG 预设默认值
+
+| 组件 | 预设默认值 |
+| :--- | :--- |
+| `switch` | `{ modelProp: 'modelValue' }` |
+| `input` | `{ maxlength: 100, clearable: true, placeholder: '请输入' }` |
+| `input.textarea` | `{ maxlength: 200, autosize: {minRows:3,maxRows:6}, showWordLimit: true, clearable: true, placeholder: '请输入' }` |
+| `input.password` | `{ maxlength: 100, clearable: true, showPassword: true, placeholder: '请输入' }` |
+| `select` / `cascader` | `{ clearable: true, placeholder: '请选择' }` |
+| `input-number` | `{ max: 10^15-1, min: -(10^15+1), controls: false, placeholder: '请输入', style: {width:'100%'} }` |
+| `date-picker` 系列 | `{ style: {width:'100%'} }` + 各子类型专用占位符 |
+| `time-picker` / `time-select` | `{ style: {width:'100%'}, placeholder: '请选择' }` |
+| `tree-select` | `{ clearable: true, placeholder: '请选择' }` |
+| `pro-table` | `{ pagination: {layout:'total,sizes,prev,pager,next,jumper',pageSizes:[10,20,30,40,50,100],background:true}, searchFormConfig: {layout:'grid',expand:{minExpandRows:2,expandStatus:false}}, control: true, addIndexColumn: true }` |
+| `pro-form` | `{ grid: { gutter: 24 } }` |
+| `pro-form-item` | `{ span: 8 }` |
+
+### 优先级（高→低）
+
+1. Field 级别配置
+2. `ProComponentProvider` 的 `componentVars` 参数
+3. `INJECT_CONFIG` 内置预设
+
+### 覆盖示例
+
+```vue
+<template>
+  <ProComponentProvider :component-vars="config">
+    <ProForm :form="form" />
+  </ProComponentProvider>
+</template>
+<script setup lang="ts">
+const config = {
+  'pro-form-item': { span: 6 },
+  input: { maxlength: 200 },
+  select: { filterable: true },
+};
+</script>
+```
+
+---
+
+## 6. ProTable 速览
+
+```ts
+const table = useTable<any, Row>({
+  columns: [
+    { prop: 'id', label: 'ID', width: 80 },
+    { prop: 'name', label: '姓名', width: 120 },
+  ],
+  // searchFields 与 ProForm fields 格式一致，支持相同分层剥离
+  searchFields: [
+    { path: 'name', component: 'input', placeholder: '搜索' },
+    { path: 'status', component: 'select', options: [...] },
+  ],
+  data: [],
+});
+// 模板：<ProTable :table="table" :search="() => fetchData()" immediateSearch />
+```
 
-每个字段支持：`path`, `label`, `component`, `hidden`, `disabled`, `rules`, `valueFormatter`, `fields`, `grid`, `slots`, `componentStyle`, `componentClass`, `componentContainer`, `formItemStyle`, `formItemClass`, `formItemContainer`, `modelProp`
+> element-plus Table Column 用 `prop`（非 `dataIndex`），数据源用 `data`（非 `dataSource`）。
 
-内置组件：input, input-number, autocomplete, select, cascader, date-picker, time-picker, time-select, checkbox-group, radio-group, switch, slider, tree-select, transfer, custom
+---
 
-## 表格列配置（Column）
+## 7. 关键参考
 
-- `dataIndex` - 数据路径（优先使用）
-- `key` - 列标识（dataIndex 不满足时使用）
-- `hidden` - 是否隐藏
-- 所有 Element Plus TableColumn 属性
+1. **`node_modules/@qin-ui/element-plus-pro/api.json`** — 结构化 API 元数据
+2. **`node_modules/@qin-ui/element-plus-pro/README.md`** — 完整文档和示例
+3. **[https://element-plus.org/](https://element-plus.org/)** — 确认控件属性时必查

package/api.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-06-08T06:46:58.908Z",
+  "generatedAt": "2026-07-06T09:28:50.564Z",
   "name": "@qin-ui/element-plus-pro",
   "api": [
     {

package/bin/init-ai.mjs

@@ -1,10 +1,12 @@
 #!/usr/bin/env node
 
 /**
- * @qin-ui/* AI 上下文初始化 CLI 工具
+ * @qin-ui/element-plus-pro AI 上下文初始化 CLI 工具
  *
- * 遵循 Agentic Collaboration Standard (ACS)，
- * 在消费方项目中自动生成统一的 .agents 规范配置文件。
+ * 在消费方项目中生成分层 AI 上下文文件，使 AI 工具能够：
+ * 1. 理解 @qin-ui/element-plus-pro 的 Schema 驱动架构
+ * 2. 掌握属性透传规则（何时查阅 element-plus 文档）
+ * 3. 快速获取完整 API 参考
  *
  * 用法:
  *   npx @qin-ui/element-plus-pro init-ai
@@ -28,46 +30,174 @@ const PKG_SHORT = PKG_NAME.replace(/^@qin-ui\//, '');
 
 // ==================== 终端颜色 ====================
 
-const green = (s) => `\x1b[32m${s}\x1b[0m`;
-const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
-const bold = (s) => `\x1b[1m${s}\x1b[0m`;
-const red = (s) => `\x1b[31m${s}\x1b[0m`;
+const green = s => `\x1b[32m${s}\x1b[0m`;
+const cyan = s => `\x1b[36m${s}\x1b[0m`;
+const bold = s => `\x1b[1m${s}\x1b[0m`;
+const yellow = s => `\x1b[33m${s}\x1b[0m`;
+const dim = s => `\x1b[2m${s}\x1b[0m`;
 
-// ==================== 内容生成 ====================
+// ==================== 内容读取 ====================
 
-function getAiContextContent() {
-  const filePath = path.join(PKG_ROOT, 'AI-CONTEXT.md');
+function readPackageFile(filename) {
+  const filePath = path.join(PKG_ROOT, filename);
   if (fs.existsSync(filePath)) {
     return fs.readFileSync(filePath, 'utf-8').trim();
   }
-  return `# ${PKG_NAME}\n\n> 基于 Vue 3 的配置驱动组件库。`;
+  return null;
+}
+
+function getAiContextContent() {
+  return readPackageFile('AI-CONTEXT.md') || `# ${PKG_NAME}\n\n> 基于 Vue 3 的配置驱动组件库。`;
+}
+
+function getReadmeContent() {
+  return readPackageFile('README.md') || '';
 }
 
-function getUnifiedAgentContent() {
+function getApiJsonContent() {
+  try {
+    const raw = readPackageFile('api.json');
+    if (!raw) return null;
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+// ==================== 内容生成 ====================
+
+/**
+ * 生成 rules 文件内容（Instructions 层）
+ * 包含：架构关系、透传规则、反模式、element-plus 资源链接
+ */
+function getRulesContent() {
   const aiContext = getAiContextContent();
-  const core = [
-    aiContext,
-    '',
-    '## 完整 API 参考',
-    '',
-    `使用 \`${PKG_NAME}\` 时，请阅读以下文件获取完整的 API 定义、类型签名和使用示例：`,
-    `- \`node_modules/${PKG_NAME}/README.md\` — 详细使用文档和代码示例`,
-    `- \`node_modules/${PKG_NAME}/api.json\` — 结构化 API 元数据（组件、Hook、类型的签名和 JSDoc 示例）`,
-    '',
-  ].join('\n');
 
-  // 包含兼容性的 Frontmatter（如 Cursor 支持的 globs 等）
   return [
     '---',
-    `description: "${PKG_NAME} 组件库使用规范"`,
+    `description: "${PKG_NAME} 组件库使用规范 — Schema 驱动、属性透传规则"`,
     'globs: ["**/*.vue", "**/*.ts", "**/*.tsx"]',
     'alwaysApply: false',
     '---',
     '',
-    core,
+    aiContext,
+    '',
+    '---',
+    '',
+    '## 本地参考文件',
+    '',
+    '本规则文件提供了核心架构和用法指南。需要完整 API 参考时，请阅读以下文件：',
+    '',
+    `- **\`.agents/docs/${PKG_SHORT}-api.md\`** — 完整 API 文档（组件、Hooks、类型、Field 配置参考）`,
+    `- **\`node_modules/${PKG_NAME}/api.json\`** — 结构化 API 元数据（函数签名、类型定义）`,
+    '',
+    '## element-plus 文档资源',
+    '',
+    '所有在 Field 配置中编写的非保留属性，最终会透传给 element-plus 组件。编写前务必查阅文档确认属性名：',
+    '',
+    '| 资源 | URL | 说明 |',
+    '|:--|:--|:--|',
+    '| element-plus 官网 | https://element-plus.org/ | 官方文档首页（中文/英文） |',
+    '| 组件文档 | https://element-plus.org/zh-CN/component/button | 组件 API 参考入口（中文） |',
+    '',
   ].join('\n');
 }
 
+/**
+ * 生成 API 文档内容（Resources 层）
+ * 从 README.md + api.json 合并提取完整 API 参考
+ */
+function getApiDocContent() {
+  const readme = getReadmeContent();
+  const apiJson = getApiJsonContent();
+
+  const sections = [];
+
+  sections.push(`# ${PKG_NAME} — 完整 API 参考`, '');
+  sections.push(`> 自动生成自 README.md 和 api.json。版本: ${PKG_JSON.version}`, '');
+
+  // README 内容（已包含完整的使用文档）
+  if (readme) {
+    sections.push(readme);
+    sections.push('');
+  }
+
+  // 结构化 API 元数据
+  if (apiJson && apiJson.api && apiJson.api.length > 0) {
+    sections.push('---');
+    sections.push('');
+    sections.push('## 结构化 API 元数据（自动提取自源码 JSDoc）');
+    sections.push('');
+
+    for (const item of apiJson.api) {
+      const typeLabel = {
+        component: '组件',
+        function: '函数/Hook',
+        type: '类型',
+        interface: '接口',
+        constant: '常量',
+      }[item.type] || '';
+
+      sections.push(`### ${typeLabel} \`${item.name}\``);
+      sections.push('');
+      sections.push(`**类型:** ${item.type}`);
+      if (item.signature) {
+        sections.push('');
+        sections.push('```typescript');
+        sections.push(item.signature);
+        sections.push('```');
+      }
+      if (item.description) {
+        sections.push('');
+        sections.push(item.description);
+      }
+
+      if (item.typeParams && item.typeParams.length > 0) {
+        sections.push('');
+        sections.push('**泛型参数:**');
+        for (const tp of item.typeParams) {
+          const extras = [];
+          if (tp.extends) extras.push(`extends ${tp.extends}`);
+          if (tp.default) extras.push(`默认 ${tp.default}`);
+          const extra = extras.length ? ` (${extras.join(', ')})` : '';
+          sections.push(`- \`${tp.name}\`${extra}`);
+        }
+      }
+
+      if (item.params && item.params.length > 0) {
+        sections.push('');
+        sections.push('**参数:**');
+        sections.push('');
+        sections.push('| 参数名 | 类型 | 可选 | 描述 |');
+        sections.push('| :--- | :--- | :--- | :--- |');
+        for (const p of item.params) {
+          sections.push(`| \`${p.name}\` | \`${p.type}\` | ${p.optional ? '是' : '否'} | ${p.description} |`);
+        }
+      }
+
+      if (item.returns) {
+        sections.push('');
+        sections.push(`**返回值:** ${item.returns}`);
+      }
+
+      if (item.examples && item.examples.length > 0) {
+        sections.push('');
+        sections.push('**示例:**');
+        for (const ex of item.examples) {
+          sections.push('');
+          sections.push(ex);
+        }
+      }
+
+      sections.push('');
+      sections.push('---');
+      sections.push('');
+    }
+  }
+
+  return sections.join('\n');
+}
+
 // ==================== 文件写入 ====================
 
 function ensureDir(dirPath) {
@@ -76,31 +206,43 @@ function ensureDir(dirPath) {
   }
 }
 
+function writeFileWithLog(filePath, content, label) {
+  const dir = path.dirname(filePath);
+  ensureDir(dir);
+  const existed = fs.existsSync(filePath);
+  fs.writeFileSync(filePath, content, 'utf-8');
+  const status = existed ? yellow('[更新]') : green('[创建]');
+  console.log(`  ${status} ${cyan(label)}`);
+}
+
 // ==================== CLI 入口 ====================
 
 function printHelp() {
   console.log(`
-${bold(`${PKG_NAME} CLI`)}
+${bold(`${PKG_NAME} CLI — AI 上下文初始化`)}
 
 ${bold('用法:')}
   npx ${PKG_NAME} init-ai
 
-${bold('命令:')}
-  init-ai    在当前项目中生成统一的 .agents 规范配置文件
+${bold('说明:')}
+  在项目中生成分层 AI 上下文文件，使 AI 工具能够深度理解和规范使用 ${PKG_NAME}。
+
+  生成的文件结构：
+    .agents/
+      rules/
+        ${PKG_SHORT}.md         规则文件（架构、透传规则、反模式）
+      docs/
+        ${PKG_SHORT}-api.md     API 参考（完整文档 + 结构化元数据）
 
 ${bold('选项:')}
   --help     显示帮助信息
-
-${bold('说明:')}
-  该命令将采用统一的 Agentic 标准，在项目的 .agents/rules/ 目录下
-  生成上下文文件。兼容支持读取 .agents 的主流 AI IDE 和 CLI 工具。
 `);
 }
 
 function main() {
   const args = process.argv.slice(2);
-  const subcommand = args.find((a) => !a.startsWith('-'));
-  const flags = args.filter((a) => a.startsWith('-'));
+  const subcommand = args.find(a => !a.startsWith('-'));
+  const flags = args.filter(a => a.startsWith('-'));
 
   if (!subcommand || flags.includes('--help') || flags.includes('-h')) {
     printHelp();
@@ -108,35 +250,55 @@ function main() {
   }
 
   if (subcommand !== 'init-ai') {
-    console.error(red(`\n  未知命令: ${subcommand}\n`));
+    console.error(`\n  ❌ 未知命令: ${subcommand}\n`);
     printHelp();
     process.exit(1);
   }
 
   console.log('');
-  console.log(bold(`📦 ${PKG_NAME} — AI 上下文初始化 (ACS 标准)`));
+  console.log(bold(`📦 ${PKG_NAME} — AI 上下文初始化 v${PKG_JSON.version}`));
+  console.log(dim(`   基于 element-plus 的 Schema 驱动组件库`));
   console.log('');
-  
-  const content = getUnifiedAgentContent();
-  const dirPath = '.agents/rules';
-  const fileName = `${PKG_SHORT}.md`;
-  
-  const fullDir = path.join(process.cwd(), dirPath);
-  const fullPath = path.join(fullDir, fileName);
 
-  ensureDir(fullDir);
-  fs.writeFileSync(fullPath, content, 'utf-8');
+  // 1. 生成 Rules 文件
+  console.log(bold('📋 规则层 (Rules)'));
+  const rulesContent = getRulesContent();
+  writeFileWithLog(
+    path.join(process.cwd(), '.agents/rules', `${PKG_SHORT}.md`),
+    rulesContent,
+    `.agents/rules/${PKG_SHORT}.md`
+  );
+  console.log(dim('   → 架构概览、属性透传决策树、渐进用法、反模式'));
+  console.log('');
 
-  const relPath = path.join(dirPath, fileName);
-  console.log(`  ${green('✔')} ${cyan(relPath)}  ${green('[created/updated]')}`);
+  // 2. 生成 API 文档
+  console.log(bold('📖 参考层 (Docs)'));
+  const apiDocContent = getApiDocContent();
+  writeFileWithLog(
+    path.join(process.cwd(), '.agents/docs', `${PKG_SHORT}-api.md`),
+    apiDocContent,
+    `.agents/docs/${PKG_SHORT}-api.md`
+  );
+  console.log(dim('   → 完整 README 文档 + 结构化 API 元数据'));
+  console.log('');
 
+  // 3. 完成提示
+  console.log(green('✅ 完成！已生成分层 AI 上下文文件。'));
   console.log('');
-  console.log(green('✅ 完成！已生成统一标准规则文件。'));
+  console.log(`${bold('📂 生成的文件:')}`);
+  console.log(`   ${cyan('.agents/')}`);
+  console.log(`   ├── ${cyan('rules/')}`);
+  console.log(`   │   └── ${cyan(PKG_SHORT + '.md')}            ${dim('← 核心规则（AI 优先读取）')}`);
+  console.log(`   └── ${cyan('docs/')}`);
+  console.log(`       └── ${cyan(PKG_SHORT + '-api.md')}        ${dim('← 完整 API 参考')}`);
+  console.log('');
+
+  console.log(`${bold('🔄 建议的下一步:')}`);
+  console.log(`   1. 提交 ${cyan('.agents/')} 目录到 Git 仓库，团队共享`);
+  console.log(`   2. 查阅 element-plus 官方文档确认组件属性：`);
+  console.log(`      ${cyan('https://element-plus.org/')}`);
+  console.log(`   3. ${dim('（可选）将 element-plus 常用组件 API 速查加入项目文档')}`);
   console.log('');
-  console.log(`${bold('下一步:')}`);
-  console.log(
-    `  将 ${cyan(dirPath)} 目录提交到 Git，团队即可自动享受 AI 增强\n`
-  );
 }
 
 main();

package/es/element-plus-pro.css

@@ -1,16 +1,16 @@
 [class*='-form-item'] [class*='-form-item'][data-v-1dd9fcdd] {
   margin-bottom: 18px;
 }
-.pro-table_search-form[data-v-70679e47] [class*='-form-item'] {
+.pro-table_search-form[data-v-d286f62d] [class*='-form-item'] {
   margin: 0;
 }
-.pro-table_search-form_expand-toggle-button[data-v-70679e47] {
+.pro-table_search-form_expand-toggle-button[data-v-d286f62d] {
   display: flex;
   align-items: center;
   padding: 0;
   padding-left: 4px;
 }
-.pro-table_search-form .transition[data-v-70679e47] {
+.pro-table_search-form .transition[data-v-d286f62d] {
   transition: all 0.25s;
 }
 .pro-table_search-form-container[data-v-45e627f4] {

package/es/table/index.js

@@ -227,7 +227,7 @@ const _sfc_main$8 = /* @__PURE__ */ defineComponent({
     };
   }
 });
-const SearchForm = /* @__PURE__ */ _export_sfc(_sfc_main$8, [["__scopeId", "data-v-70679e47"]]);
+const SearchForm = /* @__PURE__ */ _export_sfc(_sfc_main$8, [["__scopeId", "data-v-d286f62d"]]);
 const _sfc_main$7 = {};
 const _hoisted_1$4 = { class: "pro-table_search-form-container" };
 function _sfc_render$3(_ctx, _cache) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qin-ui/element-plus-pro",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "基于 element-plus 的二次封装组件",
   "bin": {
     "element-plus-pro": "./bin/init-ai.mjs"