king-design-analyzer 2.1.7 → 2.2.0

package/docs_for_llm/transfer.doc.md

@@ -12,42 +12,43 @@ import { Transfer } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| data | `TransferDataItem[]` | `undefined` | 是 | 需要展示的列表数据，包含 label、key、disabled 属性 | `<Transfer :data="data"></Transfer>` |
-| value | `string[]` | `[]` | 否 | 已选择的 key 数组，可用 v-model 双向绑定 | `<Transfer v-model="selectedKeys"></Transfer>` |
-| keyName | `string` | `"key"` | 否 | 指定数据的 key 属性名 | `<Transfer keyName="id"></Transfer>` |
-| labelName | `string` | `"label"` | 否 | 指定数据的 label 属性名 | `<Transfer labelName="name"></Transfer>` |
-| leftCheckedKeys | `string[]` | `[]` | 否 | 左侧勾选的节点 key 数组，可用 v-model:leftCheckedKeys | `<Transfer v-model:leftCheckedKeys="leftChecked"></Transfer>` |
-| rightCheckedKeys | `string[]` | `[]` | 否 | 右侧勾选的节点 key 数组，可用 v-model:rightCheckedKeys | `<Transfer v-model:rightCheckedKeys="rightChecked"></Transfer>` |
-| filterable | `boolean` | `false` | 否 | 是否启用过滤功能 | `<Transfer filterable></Transfer>` |
-| filter | `(data: TransferDataItem, keywords: string) => boolean` | `(data, keywords) => data.label.includes(keywords)` | 否 | 自定义过滤函数 | `<Transfer :filter="customFilter"></Transfer>` |
-| placeholder | `string` | `"请输入"` | 否 | 过滤输入框的占位文案 | `<Transfer placeholder="搜索..."></Transfer>` |
-| leftKeywords | `string` | `undefined` | 否 | 左侧筛选关键字 | `<Transfer v-model:leftKeywords="leftSearch"></Transfer>` |
-| rightKeywords | `string` | `undefined` | 否 | 右侧筛选关键字 | `<Transfer v-model:rightKeywords="rightSearch"></Transfer>` |
-| leftTitle | `string | VNode` | `"请选择"` | 否 | 左侧标题 | `<Transfer leftTitle="待选列表"></Transfer>` |
-| rightTitle | `string | VNode` | `"已选择"` | 否 | 右侧标题 | `<Transfer rightTitle="已选列表"></Transfer>` |
-| enableAdd | `() => boolean` | `undefined` | 否 | 控制右箭头按钮的可用状态 | `<Transfer :enableAdd="canAdd"></Transfer>` |
-| enableRemove | `() => boolean` | `undefined` | 否 | 控制左箭头按钮的可用状态 | `<Transfer :enableRemove="canRemove"></Transfer>` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| data | `TransferDataItem[]` | `undefined` | 是 | 需要展示的列表数据，包含 label、key、disabled 属性 | - | `<Transfer :data="data"></Transfer>` |
+| value | `string[]` | `[]` | 否 | 已选择的 key 数组，可用 v-model 双向绑定 | - | `<Transfer v-model="selectedKeys"></Transfer>` |
+| keyName | `string` | `"key"` | 否 | 指定数据的 key 属性名 | - | `<Transfer keyName="id"></Transfer>` |
+| labelName | `string` | `"label"` | 否 | 指定数据的 label 属性名 | - | `<Transfer labelName="name"></Transfer>` |
+| leftCheckedKeys | `string[]` | `[]` | 否 | 左侧勾选的节点 key 数组，可用 v-model:leftCheckedKeys | - | `<Transfer v-model:leftCheckedKeys="leftChecked"></Transfer>` |
+| rightCheckedKeys | `string[]` | `[]` | 否 | 右侧勾选的节点 key 数组，可用 v-model:rightCheckedKeys | - | `<Transfer v-model:rightCheckedKeys="rightChecked"></Transfer>` |
+| filterable | `boolean` | `false` | 否 | 是否启用过滤功能 | - | `<Transfer filterable></Transfer>` |
+| filter | `(data: TransferDataItem, keywords: string) => boolean` | `(data, keywords) => data.label.includes(keywords)` | 否 | 自定义过滤函数 | - | `<Transfer :filter="customFilter"></Transfer>` |
+| placeholder | `string` | `"请输入"` | 否 | 过滤输入框的占位文案 | - | `<Transfer placeholder="搜索..."></Transfer>` |
+| leftKeywords | `string` | `undefined` | 否 | 左侧筛选关键字 | - | `<Transfer v-model:leftKeywords="leftSearch"></Transfer>` |
+| rightKeywords | `string` | `undefined` | 否 | 右侧筛选关键字 | - | `<Transfer v-model:rightKeywords="rightSearch"></Transfer>` |
+| leftTitle | `string | VNode` | `"请选择"` | 否 | 左侧标题 | - | `<Transfer leftTitle="待选列表"></Transfer>` |
+| rightTitle | `string | VNode` | `"已选择"` | 否 | 右侧标题 | - | `<Transfer rightTitle="已选列表"></Transfer>` |
+| enableAdd | `() => boolean` | `undefined` | 否 | 控制右箭头按钮的可用状态 | - | `<Transfer :enableAdd="canAdd"></Transfer>` |
+| enableRemove | `() => boolean` | `undefined` | 否 | 控制左箭头按钮的可用状态 | - | `<Transfer :enableRemove="canRemove"></Transfer>` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
 | add | `@add` | 点击右箭头按钮时触发 | `-` | `<Transfer @add="handleAdd"></Transfer>` |
 | remove | `@remove` | 点击左箭头按钮时触发 | `-` | `<Transfer @remove="handleRemove"></Transfer>` |
+| page | `@page` | 启用分页时，左右面板任一侧翻页后触发。 | `model: 'left' | 'right', data: PaginationChangeData` | `<Transfer :pagination="true" @page="handlePage"></Transfer>` |
 
-### 事件处理函数示例
-**add**:
-```typescript
-const handleAdd = () => {
-  console.log('数据已添加到右侧');
-};
-```
+### 事件参数说明
+**page**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| model | `'left' | 'right'` | 是 | - | 触发翻页的面板标识，`left` 表示候选列表，`right` 表示已选列表。 |
+| data | `PaginationChangeData` | 是 | - | 当前分页变更数据，通常包含页码和每页数量。 |
 
-**remove**:
+事件处理示例:
 ```typescript
-const handleRemove = () => {
-  console.log('数据已移回左侧');
+const handlePage = (model: 'left' | 'right', data: { value: number; limit: number }) => {
+  console.log(model, data.value, data.limit);
 };
 ```
 
@@ -63,17 +64,27 @@ const handleRemove = () => {
 | 方法名 | 说明 | 参数 | 返回值 |
 | --- | --- | --- | --- |
 | getData | 获取右侧已选择的节点数据 | `-` | `TransferDataItem[]` |
-| getCheckedData | 获取勾选的节点数据 | `-` | `TransferDataItem[]` |
+| getCheckedData | 获取勾选的节点数据 | `model: 'left' | 'right'` | `TransferDataItem[]` |
+
+### 方法参数说明
+**getCheckedData**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| model | `'left' | 'right'` | 是 | - | 指定读取左侧候选列表或右侧已选列表中的勾选数据。 |
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### data 中缺少 key 属性
 > **错误用法**: `const data = [{ label: '选项1' }]; // 缺少 key`
 > **正确写法**: `const data = [{ label: '选项1', key: 1 }];`
 > **说明**: 每个数据项必须有 key 属性（或通过 keyName 指定的属性）
 
+### value 类型错误
 > **错误用法**: `const value = ref(0); // 应该是数组`
 > **正确写法**: `const value = ref<number[]>([]);`
 > **说明**: value 必须是数组类型
 
+### keyName 与实际属性名不匹配
 > **错误用法**: `const data = [{ id: 1, name: '张三' }];
 <Transfer :data="data" /> <!-- 默认使用 key，但数据中是 id -->`
 > **正确写法**: `const data = [{ id: 1, name: '张三' }];
@@ -222,7 +233,7 @@ const value = ref<string[]>([]);
 
 使用方法获取穿梭框数据
 
-**使用的 API**: 属性: data, value
+**使用的 API**: 属性: data, value | 方法: getData
 
 ```vue
 <script setup lang="ts">

package/docs_for_llm/tree.doc.md

@@ -12,23 +12,23 @@ import { Tree } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| data | `TreeDataItem[]` | `undefined` | 是 | 要渲染的树形数据 | `<Tree :data="treeData"></Tree>` |
-| expandedKeys | `K[]` | `undefined` | 否 | 指定展开的节点 key 数组，可用 v-model:expandedKeys | `<Tree v-model:expandedKeys="expandedKeys"></Tree>` |
-| defaultExpandAll | `boolean` | `false` | 否 | 是否默认展开所有节点 | `<Tree defaultExpandAll></Tree>` |
-| checkbox | `boolean` | `false` | 否 | 是否展示复选框 | `<Tree checkbox></Tree>` |
-| checkedKeys | `K[]` | `undefined` | 否 | 指定勾选的节点 key 数组，可用 v-model:checkedKeys | `<Tree checkbox v-model:checkedKeys="checkedKeys"></Tree>` |
-| uncorrelated | `boolean` | `false` | 否 | 父子 checkbox 选中状态是否互不关联 | `<Tree checkbox uncorrelated></Tree>` |
-| selectable | `boolean` | `true` | 否 | 节点是否可选中 | `<Tree :selectable="false"></Tree>` |
-| selectedKeys | `K[]` | `undefined` | 否 | 指定选中的节点 key 数组，可用 v-model:selectedKeys | `<Tree v-model:selectedKeys="selectedKeys"></Tree>` |
-| multiple | `boolean` | `false` | 否 | selectedKeys 是否支持多选 | `<Tree multiple></Tree>` |
-| filter | `(data: TreeDataItem, node: TreeNode) => boolean` | `undefined` | 否 | 节点过滤函数，返回 true 则展示，否则过滤掉 | `<Tree :filter="filterFn"></Tree>` |
-| load | `(node: TreeNode) => Promise<void> | void` | `undefined` | 否 | 异步加载节点数据的函数 | `<Tree :load="loadData"></Tree>` |
-| showLine | `boolean` | `true` | 否 | 是否展示左侧对齐线 | `<Tree :showLine="false"></Tree>` |
-| draggable | `boolean` | `false` | 否 | 是否支持拖拽 | `<Tree draggable></Tree>` |
-| allowDrag | `(node: TreeNode) => boolean` | `undefined` | 否 | 指定哪些节点可拖拽 | `<Tree draggable :allowDrag="allowDragFn"></Tree>` |
-| allowDrop | `(node: TreeNode, srcNode: TreeNode) => boolean` | `undefined` | 否 | 指定哪些节点可以插入子节点 | `<Tree draggable :allowDrop="allowDropFn"></Tree>` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| data | `TreeDataItem[]` | `undefined` | 是 | 要渲染的树形数据 | - | `<Tree :data="treeData"></Tree>` |
+| expandedKeys | `K[]` | `undefined` | 否 | 指定展开的节点 key 数组，可用 v-model:expandedKeys | - | `<Tree v-model:expandedKeys="expandedKeys"></Tree>` |
+| defaultExpandAll | `boolean` | `false` | 否 | 是否默认展开所有节点 | - | `<Tree defaultExpandAll></Tree>` |
+| checkbox | `boolean` | `false` | 否 | 是否展示复选框 | - | `<Tree checkbox></Tree>` |
+| checkedKeys | `K[]` | `undefined` | 否 | 指定勾选的节点 key 数组，可用 v-model:checkedKeys | - | `<Tree checkbox v-model:checkedKeys="checkedKeys"></Tree>` |
+| uncorrelated | `boolean` | `false` | 否 | 父子 checkbox 选中状态是否互不关联 | - | `<Tree checkbox uncorrelated></Tree>` |
+| selectable | `boolean` | `true` | 否 | 节点是否可选中 | - | `<Tree :selectable="false"></Tree>` |
+| selectedKeys | `K[]` | `undefined` | 否 | 指定选中的节点 key 数组，可用 v-model:selectedKeys | - | `<Tree v-model:selectedKeys="selectedKeys"></Tree>` |
+| multiple | `boolean` | `false` | 否 | selectedKeys 是否支持多选 | - | `<Tree multiple></Tree>` |
+| filter | `(data: TreeDataItem, node: TreeNode) => boolean` | `undefined` | 否 | 节点过滤函数，返回 true 则展示，否则过滤掉 | - | `<Tree :filter="filterFn"></Tree>` |
+| load | `(node: TreeNode) => Promise<void> | void` | `undefined` | 否 | 异步加载节点数据的函数 | - | `<Tree :load="loadData"></Tree>` |
+| showLine | `boolean` | `true` | 否 | 是否展示左侧对齐线 | - | `<Tree :showLine="false"></Tree>` |
+| draggable | `boolean` | `false` | 否 | 是否支持拖拽 | - | `<Tree draggable></Tree>` |
+| allowDrag | `(node: TreeNode) => boolean` | `undefined` | 否 | 指定哪些节点可拖拽 | - | `<Tree draggable :allowDrag="allowDragFn"></Tree>` |
+| allowDrop | `(node: TreeNode, srcNode: TreeNode) => boolean` | `undefined` | 否 | 指定哪些节点可以插入子节点 | - | `<Tree draggable :allowDrop="allowDropFn"></Tree>` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
@@ -37,14 +37,34 @@ import { Tree } from '@king-design/vue';
 | denydrag | `@denydrag` | 拖拽不允许拖拽的节点时触发 | `node: TreeNode` | `<Tree @denydrag="handleDenyDrag"></Tree>` |
 | denydrop | `@denydrop` | 插入到不允许插入的节点时触发 | `node: TreeNode, srcNode: TreeNode, mode: TreeMode` | `<Tree @denydrop="handleDenyDrop"></Tree>` |
 
-### 事件处理函数示例
-**dragend**:
+### 事件参数说明
+**dragend**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| data | `DragEndData` | 是 | - | 拖拽数据，包含 srcNode、toNode、mode |
+
+事件处理示例:
 ```typescript
 const handleDragEnd = (data) => {
   console.log(`${data.srcNode.data.label} -> ${data.toNode.data.label}`);
 };
 ```
 
+**denydrag**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| node | `TreeNode` | 是 | - | 被拒绝拖拽的节点 |
+
+**denydrop**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| node | `TreeNode` | 是 | - | 目标节点 |
+| srcNode | `TreeNode` | 是 | - | 源节点 |
+| mode | `TreeMode` | 是 | - | 插入模式 |
+
 ## 插槽 (Slots)
 | 插槽名 | 说明 | 模板写法 | 示例 |
 | --- | --- | --- | --- |
@@ -53,22 +73,44 @@ const handleDragEnd = (data) => {
 ## 方法 (Methods)
 | 方法名 | 说明 | 参数 | 返回值 |
 | --- | --- | --- | --- |
-| getCheckedData | 获取勾选的节点数据 | `-` | `TreeDataItem[]` |
+| getCheckedData | 获取勾选的节点数据 | `leafOnly?: boolean` | `TreeDataItem[]` |
 | getSelectedData | 获取选中的节点数据 | `-` | `TreeDataItem[]` |
-| expand | 展开指定节点 | `-` | `void` |
-| shrink | 收起指定节点 | `-` | `void` |
+| expand | 展开指定节点 | `key: K` | `void` |
+| shrink | 收起指定节点 | `key: K` | `void` |
 | expandAll | 展开所有节点 | `-` | `void` |
 | getNodes | 返回一级节点数组 | `-` | `TreeNode[]` |
 
+### 方法参数说明
+**getCheckedData**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| leafOnly | `boolean` | 否 | `false` | 是否只返回叶子节点；传 `true` 时会过滤掉父级节点。 |
+
+**expand**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| key | `K` | 是 | - | 要展开的节点 key |
+
+**shrink**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| key | `K` | 是 | - | 要收起的节点 key |
+
 ## 常见错误与正确用法 (Anti-Hallucination)
+### data 中缺少 key 属性
 > **错误用法**: `const data = [{ label: '节点1' }]; // 缺少 key`
 > **正确写法**: `const data = [{ label: '节点1', key: 'node1' }];`
 > **说明**: 每个节点必须有唯一的 key 属性
 
+### 异步加载时未设置 children 为空数组
 > **错误用法**: `const data = [{ label: '父节点', key: 'parent' }]; // 无 children，不会显示展开箭头`
 > **正确写法**: `const data = [{ label: '父节点', key: 'parent', children: [] }];`
 > **说明**: 异步加载节点需要设置 children 为空数组，才会显示展开箭头
 
+### checkbox 模式下 checkedKeys 类型错误
 > **错误用法**: `const checkedKeys = ref('node1'); // 应该是数组`
 > **正确写法**: `const checkedKeys = ref<string[]>(['node1']);`
 > **说明**: checkedKeys 必须是数组类型
@@ -118,7 +160,7 @@ const data = reactive([
 
 带复选框的树形控件
 
-**使用的 API**: 属性: data, checkbox, checkedKeys, expandedKeys
+**使用的 API**: 属性: data, checkbox, checkedKeys, expandedKeys | 方法: getCheckedData
 
 ```vue
 <script setup lang="ts">

package/docs_for_llm/treeselect.doc.md

@@ -12,75 +12,64 @@ import { TreeSelect } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| value | `any` | `""` | 否 | 当前选择的值，可用 v-model 双向绑定 | `<TreeSelect v-model="value"></TreeSelect>` |
-| data | `TreeDataItem[]` | `undefined` | 是 | 要渲染的树形数据 | `<TreeSelect :data="treeData"></TreeSelect>` |
-| multiple | `boolean` | `false` | 否 | 是否支持多选 | `<TreeSelect multiple></TreeSelect>` |
-| checkbox | `boolean` | `false` | 否 | 是否展示复选框 | `<TreeSelect checkbox></TreeSelect>` |
-| uncorrelated | `boolean` | `false` | 否 | 父子 checkbox 选中状态是否互不关联 | `<TreeSelect checkbox uncorrelated></TreeSelect>` |
-| filterable | `boolean` | `false` | 否 | 是否支持筛选 | `<TreeSelect filterable></TreeSelect>` |
-| filter | `(keywords: string, data: TreeDataItem) => boolean` | `undefined` | 否 | 自定义筛选规则函数 | `<TreeSelect filterable :filter="customFilter"></TreeSelect>` |
-| load | `(node: TreeNode) => Promise<void> | void` | `undefined` | 否 | 异步加载节点数据的函数 | `<TreeSelect :load="loadData"></TreeSelect>` |
-| defaultExpandAll | `boolean` | `false` | 否 | 是否默认展开所有节点 | `<TreeSelect defaultExpandAll></TreeSelect>` |
-| showLine | `boolean` | `true` | 否 | 是否展示 Tree 的对齐线 | `<TreeSelect :showLine="false"></TreeSelect>` |
-| disabled | `boolean` | `false` | 否 | 是否禁用 | `<TreeSelect disabled></TreeSelect>` |
-| clearable | `boolean` | `false` | 否 | 是否可清空 | `<TreeSelect clearable></TreeSelect>` |
-| loading | `boolean` | `false` | 否 | 数据加载状态 | `<TreeSelect :loading="isLoading"></TreeSelect>` |
-| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 尺寸 | `<TreeSelect size="small"></TreeSelect>` |
-| placeholder | `string` | `"请选择"` | 否 | 占位文案 | `<TreeSelect placeholder="请选择节点"></TreeSelect>` |
-| fluid | `boolean` | `false` | 否 | 是否宽度 100% | `<TreeSelect fluid></TreeSelect>` |
-| width | `number | string` | `undefined` | 否 | 指定宽度，自动添加单位 px | `<TreeSelect :width="300"></TreeSelect>` |
-| hideIcon | `boolean` | `false` | 否 | 是否隐藏后面的图标 | `<TreeSelect hideIcon></TreeSelect>` |
-| inline | `boolean` | `false` | 否 | 是否展示内联模式 | `<TreeSelect inline></TreeSelect>` |
-| flat | `boolean` | `false` | 否 | 是否展示扁平样式 | `<TreeSelect flat></TreeSelect>` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| value | `any` | `""` | 否 | 当前选择的值，可用 v-model 双向绑定 | - | `<TreeSelect v-model="value">` |
+| data | `TreeDataItem[]` | `undefined` | 是 | 要渲染的树形数据 | - | `<TreeSelect :data="treeData">` |
+| multiple | `boolean` | `false` | 否 | 是否支持多选 | - | `<TreeSelect multiple>` |
+| checkbox | `boolean` | `false` | 否 | 是否展示复选框 | - | `<TreeSelect checkbox>` |
+| uncorrelated | `boolean` | `false` | 否 | 父子 checkbox 选中状态是否互不关联 | - | `<TreeSelect checkbox uncorrelated>` |
+| filterable | `boolean` | `false` | 否 | 是否支持筛选 | - | `<TreeSelect filterable>` |
+| filter | `(keywords: string, data: TreeDataItem) => boolean` | `undefined` | 否 | 自定义筛选规则函数 | - | `<TreeSelect filterable :filter="customFilter">` |
+| load | `(node: TreeNode) => Promise<void> | void` | `undefined` | 否 | 异步加载节点数据的函数 | - | `<TreeSelect :load="loadData">` |
+| defaultExpandAll | `boolean` | `false` | 否 | 是否默认展开所有节点 | - | `<TreeSelect defaultExpandAll>` |
+| showLine | `boolean` | `true` | 否 | 是否展示 Tree 的对齐线 | - | `<TreeSelect :showLine="false">` |
+| disabled | `boolean` | `false` | 否 | 是否禁用 | - | `<TreeSelect disabled>` |
+| name | `string` | `undefined` | 否 | 表单元素的 name 属性 | - | `<TreeSelect name="node">` |
+| clearable | `boolean` | `false` | 否 | 是否可清空 | - | `<TreeSelect clearable>` |
+| loading | `boolean` | `false` | 否 | 数据加载状态 | - | `<TreeSelect :loading="isLoading">` |
+| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 尺寸 | - | `<TreeSelect size="small">` |
+| placeholder | `string` | `"请选择"` | 否 | 占位文案 | - | `<TreeSelect placeholder="请选择节点">` |
+| fluid | `boolean` | `false` | 否 | 是否宽度 100% | - | `<TreeSelect fluid>` |
+| width | `number | string` | `undefined` | 否 | 指定宽度，自动添加单位 px | - | `<TreeSelect :width="300">` |
+| container | `string | ((parentDom: Element, anchor: Node | null) => Element)` | `undefined` | 否 | 指定弹出菜单追加的位置，默认 Dialog 组件会追加到 Dialog 中，其他追加到 body | - | `<TreeSelect :container="() => document.body">` |
+| hideIcon | `boolean` | `false` | 否 | 是否隐藏后面的图标 | - | `<TreeSelect hideIcon>` |
+| inline | `boolean` | `false` | 否 | 是否展示内联模式 | - | `<TreeSelect inline>` |
+| flat | `boolean` | `false` | 否 | 是否展示扁平样式 | - | `<TreeSelect flat>` |
+| show | `boolean` | `false` | 否 | 是否展示菜单项（受控模式） | - | `<TreeSelect :show="visible">` |
+| position | `Position | "left" | "bottom" | "right" | "top"` | `{my: 'left top+8', at: 'left bottom'}` | 否 | 菜单弹出的位置 | - | `<TreeSelect position="top">` |
+| nowrap | `boolean` | `false` | 否 | 选中值区域是否不换行展示，适合单行紧凑布局 | - | `<TreeSelect nowrap>` |
+| draggable | `boolean` | `false` | 否 | 多选值是否支持拖动排序 | - | `<TreeSelect multiple draggable>` |
+| virtual | `boolean` | `false` | 否 | 是否开启虚拟列表，用于大数据量场景 | - | `<TreeSelect virtual>` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
-| show | `@show` | 菜单弹出时触发 | `-` | `<TreeSelect @show="handleShow"></TreeSelect>` |
-| hide | `@hide` | 菜单隐藏时触发 | `-` | `<TreeSelect @hide="handleHide"></TreeSelect>` |
-
-### 事件处理函数示例
-**show**:
-```typescript
-const handleShow = () => {
-  console.log('下拉菜单已打开');
-};
-```
-
-**hide**:
-```typescript
-const handleHide = () => {
-  console.log('下拉菜单已关闭');
-};
-```
-
-## 插槽 (Slots)
-| 插槽名 | 说明 | 模板写法 | 示例 |
-| --- | --- | --- | --- |
-| value | 自定义选择结果的展示 | `undefined` | - |
-| values | 自定义多选的选择结果的展示 | `undefined` | - |
-| prefix | 自定义输入框前面展示的内容 | `undefined` | - |
-| suffix | 自定义输入框后面展示的内容 | `undefined` | - |
-| menu | 自定义整个菜单的内容 | `undefined` | - |
+| show | `@show` | 菜单弹出时触发 | `-` | `<TreeSelect @show="handleShow">` |
+| hide | `@hide` | 菜单隐藏时触发 | `-` | `<TreeSelect @hide="handleHide">` |
 
 ## 方法 (Methods)
 | 方法名 | 说明 | 参数 | 返回值 |
 | --- | --- | --- | --- |
+| show | 主动展开下拉树面板。 | `-` | `void` |
+| hide | 主动关闭下拉树面板。 | `-` | `void` |
+| position | 重新计算下拉树面板的位置。 | `-` | `void` |
 | expandAll | 展开所有节点 | `-` | `void` |
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### data 中缺少 key 属性
 > **错误用法**: `const data = [{ label: '节点1' }]; // 缺少 key`
 > **正确写法**: `const data = [{ label: '节点1', key: 'node1' }];`
 > **说明**: 每个节点必须有唯一的 key 属性，key 同时也是选中时的取值
 
+### 多选时 value 类型错误
 > **错误用法**: `const value = ref('');
 <TreeSelect v-model="value" multiple />`
 > **正确写法**: `const values = ref<string[]>([]);
 <TreeSelect v-model="values" multiple />`
 > **说明**: multiple 模式下 value 必须是数组类型
 
+### 混淆 checkbox 和 multiple
 > **错误用法**: `<TreeSelect checkbox multiple /> <!-- 通常不需要同时使用 -->`
 > **正确写法**: `<TreeSelect checkbox /> <!-- checkbox 已隐含多选 -->`
 > **说明**: checkbox 模式已经支持多选，通常不需要同时设置 multiple

package/docs_for_llm/upload.doc.md

@@ -12,74 +12,98 @@ import { Upload } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| action | `string` | `undefined` | 是 | 上传地址 | `<Upload action="/api/upload" />` |
-| files | `UploadFile[]` | `[]` | 否 | 已上传和待上传的文件列表，可用 v-model:files 双向绑定 | `<Upload v-model:files="fileList" />` |
-| type | `"select" | "drag" | "gallery"` | `"select"` | 否 | 组件风格 | `<Upload type="drag" />` |
-| accept | `string` | `undefined` | 否 | 支持上传的文件类型 | `<Upload accept=".jpg, .png, .gif" />` |
-| multiple | `boolean` | `false` | 否 | 是否支持多选文件 | `<Upload multiple />` |
-| maxSize | `number` | `undefined` | 否 | 最大上传文件大小限制(kb) | `<Upload :maxSize="500" />` |
-| limit | `number` | `undefined` | 否 | 最大上传文件数量限制 | `<Upload :limit="5" />` |
-| autoUpload | `boolean` | `true` | 否 | 是否选择文件后自动上传 | `<Upload :autoUpload="false" />` |
-| beforeUpload | `(file: UploadFile, files: UploadFile[]) => boolean | Promise<boolean>` | `undefined` | 否 | 上传前的回调函数，返回 false 取消上传，支持异步 | `<Upload :beforeUpload="handleBeforeUpload" />` |
-| beforeRemove | `(file: UploadFile, files: UploadFile[]) => boolean | Promise<boolean>` | `undefined` | 否 | 删除前的回调函数，返回 false 取消删除，支持异步 | `<Upload :beforeRemove="handleBeforeRemove" />` |
-| data | `object | ((file: UploadFile) => object)` | `undefined` | 否 | 上传附加的请求数据，可以是对象或函数 | `<Upload :data="{userId: '123'}" />` |
-| headers | `Record<string, string>` | `undefined` | 否 | 上传的请求头 | `<Upload :headers="{Authorization: 'Bearer token'}" />` |
-| name | `string` | `undefined` | 否 | 上传文件字段名 | `<Upload name="file" />` |
-| withCredentials | `boolean` | `false` | 否 | 跨域请求是否允许传送 cookie | `<Upload withCredentials />` |
-| directory | `boolean` | `false` | 否 | 是否支持上传文件夹 | `<Upload directory />` |
-| disabled | `boolean` | `false` | 否 | 是否禁用上传 | `<Upload disabled />` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| action | `string` | `undefined` | 是 | 上传地址 | - | `<Upload action="/api/upload" />` |
+| files | `UploadFile[]` | `[]` | 否 | 已上传和待上传的文件列表，可用 v-model:files 双向绑定 | - | `<Upload v-model:files="fileList" />` |
+| defaultFiles | `(Partial<UploadFile> & Pick<UploadFile, 'name' | 'url'>)[]` | `[]` | 否 | 默认文件列表，用于初始化已上传文件，不与 files 双向绑定 | - | `<Upload :defaultFiles="[{ name: 'demo.png', url: 'https://example.com/demo.png' }]" />` |
+| type | `"select" | "drag" | "gallery"` | `"select"` | 否 | 组件风格 | - | `<Upload type="drag" />` |
+| accept | `string` | `undefined` | 否 | 支持上传的文件类型 | - | `<Upload accept=".jpg, .png, .gif" />` |
+| multiple | `boolean` | `false` | 否 | 是否支持多选文件 | - | `<Upload multiple />` |
+| maxSize | `number` | `undefined` | 否 | 最大上传文件大小限制(kb) | - | `<Upload :maxSize="500" />` |
+| limit | `number` | `undefined` | 否 | 最大上传文件数量限制 | - | `<Upload :limit="5" />` |
+| autoUpload | `boolean` | `true` | 否 | 是否选择文件后自动上传 | - | `<Upload :autoUpload="false" />` |
+| beforeUpload | `(file: UploadFile, files: UploadFile[]) => boolean | Promise<boolean>` | `undefined` | 否 | 上传前的回调函数，返回 false 取消上传，支持异步 | - | `<Upload :beforeUpload="handleBeforeUpload" />` |
+| beforeRemove | `(file: UploadFile, files: UploadFile[]) => boolean | Promise<boolean>` | `undefined` | 否 | 删除前的回调函数，返回 false 取消删除，支持异步 | - | `<Upload :beforeRemove="handleBeforeRemove" />` |
+| data | `object | ((file: UploadFile) => object)` | `undefined` | 否 | 上传附加的请求数据，可以是对象或函数 | - | `<Upload :data="{userId: '123'}" />` |
+| headers | `Record<string, string>` | `undefined` | 否 | 上传的请求头 | - | `<Upload :headers="{Authorization: 'Bearer token'}" />` |
+| name | `string` | `undefined` | 否 | 上传文件字段名 | - | `<Upload name="file" />` |
+| withCredentials | `boolean` | `false` | 否 | 跨域请求是否允许传送 cookie | - | `<Upload withCredentials />` |
+| directory | `boolean` | `false` | 否 | 是否支持上传文件夹 | - | `<Upload directory />` |
+| disabled | `boolean` | `false` | 否 | 是否禁用上传 | - | `<Upload disabled />` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
-| progress | `@progress` | 文件上传过程中触发 | `event: ProgressEvent, xhr: XMLHttpRequest, file: UploadFile, files: UploadFile[]` | `<Upload @progress="handleProgress"></Upload>` |
-| success | `@success` | 文件上传成功时触发 | `res: any, xhr: XMLHttpRequest, file: UploadFile, files: UploadFile[]` | `<Upload @success="handleSuccess"></Upload>` |
-| error | `@error` | 文件超出限制或上传失败时触发 | `err: Error | RequestError, file: File | File[] | UploadFile, files: UploadFile[]` | `<Upload @error="handleError"></Upload>` |
+| progress | `@progress` | 文件上传过程中触发 | `event: ProgressEvent, xhr: XMLHttpRequest, file: UploadFile, files: UploadFile[]` | `<Upload @progress="handleProgress">` |
+| success | `@success` | 文件上传成功时触发 | `res: any, xhr: XMLHttpRequest, file: UploadFile, files: UploadFile[]` | `<Upload @success="handleSuccess">` |
+| error | `@error` | 文件超出限制或上传失败时触发 | `err: Error | RequestError, file: File | File[] | UploadFile, files: UploadFile[]` | `<Upload @error="handleError">` |
 
-### 事件处理函数示例
-**progress**:
+### 事件参数说明
+**progress**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| event | `ProgressEvent` | 是 | - | 进度事件 |
+| xhr | `XMLHttpRequest` | 是 | - | 请求对象 |
+| file | `UploadFile` | 是 | - | 当前文件 |
+| files | `UploadFile[]` | 是 | - | 所有文件列表 |
+
+事件处理示例:
 ```typescript
 const handleProgress = (e, xhr, file, files) => {
   console.log('进度:', file.percent);
 };
 ```
 
-**success**:
+**success**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| res | `any` | 是 | - | 服务器响应 |
+| xhr | `XMLHttpRequest` | 是 | - | 请求对象 |
+| file | `UploadFile` | 是 | - | 当前文件 |
+| files | `UploadFile[]` | 是 | - | 所有文件列表 |
+
+事件处理示例:
 ```typescript
 const handleSuccess = (res, xhr, file, files) => {
   console.log('上传成功:', res);
 };
 ```
 
-**error**:
+**error**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| err | `Error | RequestError` | 是 | - | 错误信息 |
+| file | `File | File[] | UploadFile` | 是 | - | 相关文件 |
+| files | `UploadFile[]` | 是 | - | 所有文件列表 |
+
+事件处理示例:
 ```typescript
 const handleError = (err, file, files) => {
   Message.error(err.message);
 };
 ```
 
-## 插槽 (Slots)
-| 插槽名 | 说明 | 模板写法 | 示例 |
-| --- | --- | --- | --- |
-| content | 组件展示的内容，当没有子元素时，默认会根据type展示不同的内容 | `undefined` | - |
-| tip | 组件展示的提示信息 | `undefined` | - |
-
 ## 方法 (Methods)
 | 方法名 | 说明 | 参数 | 返回值 |
 | --- | --- | --- | --- |
 | submit | 手动上传时，调用该方法开始上传 | `-` | `void` |
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 未设置 action 属性
 > **错误用法**: `<Upload /> <!-- 缺少上传地址 -->`
 > **正确写法**: `<Upload action="/api/upload" />`
 > **说明**: 必须设置 action 属性指定上传地址
 
+### maxSize 单位理解错误
 > **错误用法**: `<Upload :maxSize="1024 * 1024" /> <!-- 期望 1MB，实际是 1GB -->`
 > **正确写法**: `<Upload :maxSize="1024" /> <!-- 1MB = 1024KB -->`
 > **说明**: maxSize 单位是 KB，1MB = 1024KB
 
+### 设置 autoUpload 为 false 但忘记调用 submit
 > **错误用法**: `<Upload :autoUpload="false" /> <!-- 文件不会自动上传 -->`
 > **正确写法**: `<Upload ref="upload" :autoUpload="false" />
 // 需要手动调用 upload.value?.submit()`
@@ -195,7 +219,7 @@ const handleError = (err: any) => {
 
 手动控制上传时机
 
-**使用的 API**: 属性: action, autoUpload, multiple
+**使用的 API**: 属性: action, autoUpload, multiple | 方法: submit
 
 ```vue
 <script setup lang="ts">

package/docs_for_llm/useCRUD.doc.md

@@ -0,0 +1,49 @@
+# 增删行状态管理 (useCRUD)
+
+管理数组型表单项的新增与删除能力，并根据最大最小数量约束生成可直接用于按钮禁用态的结果。
+
+**关键词**: useCRUD, 动态表单, 新增 删除, 数组项, canAdd, canDelete
+
+## 导入语句
+```typescript
+import { useCRUD } from '@ksyun-internal/versatile';
+```
+
+## 参数 (Params)
+| 参数名 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| models | `Ref<T[]>` | 是 | 当前表单项数组 |
+| initItem | `() => T` | 是 | 新增项的初始化工厂函数 |
+| maxInstanceNum | `number` | 否 | 最大可新增数量 |
+| minInstanceNum | `number` | 否 | 最小保留数量 |
+
+## 返回值
+```typescript
+{ canAdd: ComputedRef<{ disabled: boolean; msg: string }>; canDelete: ComputedRef<{ disabled: boolean; msg: string }>; addItem: () => void; deleteItem: (index: number) => void; }
+```
+
+## 常见错误与正确用法 (Anti-Hallucination)
+### 直接复用同一个默认对象，导致新增项互相串值
+> **错误用法**: `const defaultItem = { name: '', value: '' }; useCRUD(models, () => defaultItem);`
+> **正确写法**: `useCRUD(models, () => ({ name: '', value: '' }));`
+> **说明**: initItem 应返回新的对象实例，避免多个表单项共享引用。
+
+## 使用示例
+### 动态表单行增删
+控制实例配置行的新增与删除
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { useCRUD } from '@ksyun-internal/versatile';
+
+const models = ref([{ name: '', value: '' }]);
+const { canAdd, canDelete, addItem, deleteItem } = useCRUD(
+  models,
+  () => ({ name: '', value: '' }),
+  5,
+  1
+);
+</script>
+```
+

package/docs_for_llm/useCountdown.doc.md

@@ -0,0 +1,43 @@
+# 倒计时 (useCountdown)
+
+管理秒级或自定义间隔的倒计时流程，提供 start、reset、stop 和 pause/resume 等控制能力。
+
+**关键词**: useCountdown, 倒计时, remaining, 短信验证码, start stop, pause resume
+
+## 导入语句
+```typescript
+import { useCountdown } from '@ksyun-internal/versatile';
+```
+
+## 参数 (Params)
+| 参数名 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| initialCountdown | `MaybeRefOrGetter<number>` | 是 | 初始倒计时值 |
+| options | `UseCountdownOptions` | 否 | 倒计时配置，可设置 interval、immediate、onTick 和 onComplete |
+
+## 返回值
+```typescript
+{ remaining: ShallowRef<number>; isActive: Readonly<ShallowRef<boolean>>; pause: () => void; resume: () => void; reset: (countdown?: MaybeRefOrGetter<number>) => void; stop: () => void; start: (countdown?: MaybeRefOrGetter<number>) => void; }
+```
+
+## 常见错误与正确用法 (Anti-Hallucination)
+### 把 resume 当作重新开始倒计时使用
+> **错误用法**: `resume();`
+> **正确写法**: `start(); // 或 reset(60) 后再 start()`
+> **说明**: resume 只用于恢复暂停中的倒计时，不会重置剩余时间。
+
+## 使用示例
+### 短信验证码倒计时
+点击发送验证码后开始倒计时
+
+```vue
+<script setup lang="ts">
+import { useCountdown } from '@ksyun-internal/versatile';
+
+const { remaining, start, stop } = useCountdown(60, {
+  immediate: false,
+  onComplete: () => console.log('倒计时结束'),
+});
+</script>
+```
+