king-design-analyzer 2.1.7 → 2.2.0

package/docs_for_llm/switch.doc.md

@@ -12,20 +12,20 @@ import { Switch } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| value | `any` | `false` | 否 | 开关当前值，可用 v-model 双向绑定 | `<Switch v-model="value" />` |
-| trueValue | `any` | `true` | 否 | 开启时的值 | `<Switch trueValue="on" falseValue="off" />` |
-| falseValue | `any` | `false` | 否 | 关闭时的值 | `<Switch trueValue="1" falseValue="0" />` |
-| on | `string` | `undefined` | 否 | 开启时显示的文案 | `<Switch on="开" off="关" />` |
-| off | `string` | `undefined` | 否 | 关闭时显示的文案 | `<Switch on="ON" off="OFF" />` |
-| disabled | `boolean` | `false` | 否 | 是否禁用 | `<Switch disabled />` |
-| loading | `boolean` | `false` | 否 | 是否显示加载状态 | `<Switch :loading="isLoading" />` |
-| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 尺寸 | `<Switch size="small" />` |
-| width | `number | string` | `undefined` | 否 | 开关的宽度 | `<Switch :width="60" />` |
-| height | `number | string` | `undefined` | 否 | 开关的高度 | `<Switch :height="24" />` |
-| name | `string` | `undefined` | 否 | 开关的名称，用于表单提交 | `<Switch name="enable" />` |
-| beforeChange | `(from: any, to: any) => boolean | Promise<boolean>` | `undefined` | 否 | 切换前的拦截函数，返回 false 阻止切换，支持异步 | `<Switch :beforeChange="handleBeforeChange" />` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| value | `any` | `false` | 否 | 开关当前值，可用 v-model 双向绑定 | - | `<Switch v-model="value" />` |
+| trueValue | `any` | `true` | 否 | 开启时的值 | - | `<Switch trueValue="on" falseValue="off" />` |
+| falseValue | `any` | `false` | 否 | 关闭时的值 | - | `<Switch trueValue="1" falseValue="0" />` |
+| on | `string` | `undefined` | 否 | 开启时显示的文案 | - | `<Switch on="开" off="关" />` |
+| off | `string` | `undefined` | 否 | 关闭时显示的文案 | - | `<Switch on="ON" off="OFF" />` |
+| disabled | `boolean` | `false` | 否 | 是否禁用 | - | `<Switch disabled />` |
+| loading | `boolean` | `false` | 否 | 是否显示加载状态 | - | `<Switch :loading="isLoading" />` |
+| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 尺寸 | - | `<Switch size="small" />` |
+| width | `number | string` | `undefined` | 否 | 开关的宽度 | - | `<Switch :width="60" />` |
+| height | `number | string` | `undefined` | 否 | 开关的高度 | - | `<Switch :height="24" />` |
+| name | `string` | `undefined` | 否 | 开关的名称，用于表单提交 | - | `<Switch name="enable" />` |
+| beforeChange | `(from: any, to: any) => boolean | Promise<boolean>` | `undefined` | 否 | 切换前的拦截函数，返回 false 阻止切换，支持异步 | - | `<Switch :beforeChange="handleBeforeChange" />` |
 
 ## 插槽 (Slots)
 | 插槽名 | 说明 | 模板写法 | 示例 |
@@ -34,12 +34,14 @@ import { Switch } from '@king-design/vue';
 | off | 扩展关闭时的文案 | `undefined` | - |
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 在 Vue 中使用保留字 Switch
 > **错误用法**: `import { Switch } from '@king-design/vue';
 // 可能在某些情况下与 Vue 保留字冲突`
 > **正确写法**: `import { Switch as KSwitch } from '@king-design/vue';
 // 或直接使用 Switch，现代 Vue 3 通常没问题`
 > **说明**: 在某些 Vue 版本中，Switch 可能是保留字，可以重命名为 KSwitch
 
+### beforeChange 函数未正确返回布尔值
 > **错误用法**: `const beforeChange = async () => {
   await Dialog.confirm({});
   // 忘记返回 true
@@ -54,6 +56,7 @@ import { Switch } from '@king-design/vue';
 }`
 > **说明**: beforeChange 必须返回布尔值，true 允许切换，false 阻止切换
 
+### 自定义值类型与初始值不匹配
 > **错误用法**: `const value = ref(false);
 <Switch v-model="value" trueValue="yes" falseValue="no" />`
 > **正确写法**: `const value = ref('no');

package/docs_for_llm/table.doc.md

@@ -12,46 +12,46 @@ import { Table, TableColumn } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| data | `T[]` | `undefined` | 否 | 表格数据数组 | `<Table :data="tableData"></Table>` |
-| fixHeader | `boolean | number | string` | `false` | 否 | 表头固定，给定需要固定高度的具体数值，当超出该值时，展示滚动条 | `<Table :data="data" :fixHeader="300"></Table>` |
-| stickHeader | `boolean | number | string` | `false` | 否 | 表头吸顶，给定需要吸顶的高度，当表头在页面滚动滚动时，距离视窗顶部的距离等于该高度时，将表头固定在此高度处 | - |
-| stickScrollbar | `boolean | number | string` | `false` | 否 | 当出现横向滚动条时，设置是否当表格底部没有滚动到视窗中时，将横向滚动条固定在页面底部；取值为number类型时，用来指定距离视窗底部的距离 | - |
-| checkType | `"checkbox" | "radio" | "none"` | `"checkbox"` | 否 | 当行可选择时，定义选择的类型: 单选 "radio" , 复选 "checkbox", 不可选 "none" | - |
-| checkedKeys | `TableRowKey[]` | `[]` | 否 | 通过key数组来指定哪些行被选中，可用v-model:checkedKeys双向绑定 | - |
-| rowKey | `(value: T, index: number) => TableRowKey` | `(value, index) => index` | 否 | 设置每行的key | `<Table :data="tableData" :rowKey="(value, index) => index"></Table>` |
-| rowCheckable | `boolean` | `true` | 否 | 当行可选时，是否点击该行任意区域都可选中 | - |
-| disableRow | `(value: T, index: number, key: TableRowKey) => boolean` | `undefined` | 否 | 定义行禁用可选的逻辑，返回true，则该行被禁用选择 | - |
-| type | `"default" | "border" | "grid"` | `"default"` | 否 | 表格类型，默认左右无边框，"border"类型会添加边框, "grid"类型会展示栅格边框 | - |
-| stripe | `boolean` | `false` | 否 | 相邻行是否展示不同的背景色 | - |
-| rowClassName | `(value: T, index: number, key: TableRowKey) => string | undefined` | `undefined` | 否 | 通过一个函数定义行的className，该函数会传入该行数据，索引和key当做参数，返回的字符串将被设为该行的className | - |
-| group | `TableGroupValue` | `undefined` | 否 | 分组配置 | - |
-| sort | `TableSortValue` | `undefined` | 否 | 排序配置，可用v-model:sort双向绑定 | - |
-| loading | `boolean` | `false` | 否 | 是否展示加载状态 | - |
-| merge | `TableMerge` | `undefined` | 否 | 指定表格单元格合并逻辑 | - |
-| expandedKeys | `TableRowKey[]` | `undefined` | 否 | 通过key来指定哪些行展开，可用v-model:expandedKeys绑定 | - |
-| rowExpandable | `boolean` | `true` | 否 | 是否点击该行任意区域即展开 | - |
-| selectedKeys | `TableRowKey[]` | `undefined` | 否 | 当rowSelectable取值为非false时，指定哪些行高亮 | - |
-| rowSelectable | `boolean | "single" | "multiple"` | `false` | 否 | 是否点击行时高亮该行，取值为multiple时，可以同时高亮多行 | - |
-| childrenKey | `string` | `"children"` | 否 | 树形表格指定子元素键名 | - |
-| indent | `number` | `32` | 否 | 树形表格指定子元素缩进宽度 | - |
-| spreadKeys | `TableRowKey[]` | `undefined` | 否 | 树形表格指定展开的行，可用v-model:spreadKeys绑定 | - |
-| tooltipPosition | `"left" | "bottom" | "right" | "top" | Position` | `"top"` | 否 | 行提示的位置 | - |
-| tooltipContainer | `Container` | `undefined` | 否 | 指定行提示弹层追加的位置，支持函数或 CSS 选择器 | - |
-| keepStatus | `boolean` | `false` | 否 | 是否在行销毁的时候，保持该行在checkedKeys | selectedKeys | spreadKeys | expandedKeys中的key值 | - |
-| showIndeterminate | `boolean` | `true` | 否 | 表头的Checkbox是否支持展示半选中状态 | - |
-| resizable | `boolean` | `false` | 否 | 是否可以表头拖动调整列宽 | - |
-| minColWidth | `number` | `40` | 否 | 指定所有列拖动时的最小宽度 | - |
-| widthStoreKey | `string` | `undefined` | 否 | 如果要保存表格拖动后的列宽信息，可以通过该属性设置保存到localStorage中的key | - |
-| draggable | `boolean` | `false` | 否 | 表格行是否可拖动排序 | - |
-| animation | `boolean | [boolean, boolean]` | `true` | 否 | 是否开启动效，可以通过数组单独设置行和列的动效 | - |
-| hideHeader | `boolean` | `false` | 否 | 是否隐藏表头 | - |
-| pagination | `boolean | PaginationProps` | `false` | 否 | 是否支持分页，可传入对象配置分页参数 | - |
-| fixFooter | `boolean` | `false` | 否 | table给定需要固定高度时，自定义footer固定 | - |
-| load | `(node: any) => Promise<any[]> | void` | `undefined` | 否 | 指定异步加载节点数据的函数，该函数通过Promise返回数组来添加子节点数据 | - |
-| spreadArrowIndex | `number` | `0` | 否 | 指定树形表格展开Icon的所在列，默认在第一列 | - |
-| virtual | `boolean` | `false` | 否 | 是否开启虚拟滚动，适用于大数据量场景 | - |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| data | `T[]` | `undefined` | 否 | 表格数据数组 | - | `<Table :data="tableData"></Table>` |
+| fixHeader | `boolean | number | string` | `false` | 否 | 表头固定，给定需要固定高度的具体数值，当超出该值时，展示滚动条 | - | `<Table :data="data" :fixHeader="300"></Table>` |
+| stickHeader | `boolean | number | string` | `false` | 否 | 表头吸顶，给定需要吸顶的高度，当表头在页面滚动滚动时，距离视窗顶部的距离等于该高度时，将表头固定在此高度处 | - | - |
+| stickScrollbar | `boolean | number | string` | `false` | 否 | 当出现横向滚动条时，设置是否当表格底部没有滚动到视窗中时，将横向滚动条固定在页面底部；取值为number类型时，用来指定距离视窗底部的距离 | - | - |
+| checkType | `"checkbox" | "radio" | "none"` | `"checkbox"` | 否 | 当行可选择时，定义选择的类型: 单选 "radio" , 复选 "checkbox", 不可选 "none" | - | - |
+| checkedKeys | `TableRowKey[]` | `[]` | 否 | 通过key数组来指定哪些行被选中，可用v-model:checkedKeys双向绑定 | - | - |
+| rowKey | `(value: T, index: number) => TableRowKey` | `(value, index) => index` | 否 | 设置每行的key | - | `<Table :data="tableData" :rowKey="(value, index) => index"></Table>` |
+| rowCheckable | `boolean` | `true` | 否 | 当行可选时，是否点击该行任意区域都可选中 | - | - |
+| disableRow | `(value: T, index: number, key: TableRowKey) => boolean` | `undefined` | 否 | 定义行禁用可选的逻辑，返回true，则该行被禁用选择 | - | - |
+| type | `"default" | "border" | "grid"` | `"default"` | 否 | 表格类型，默认左右无边框，"border"类型会添加边框, "grid"类型会展示栅格边框 | - | - |
+| stripe | `boolean` | `false` | 否 | 相邻行是否展示不同的背景色 | - | - |
+| rowClassName | `(value: T, index: number, key: TableRowKey) => string | undefined` | `undefined` | 否 | 通过一个函数定义行的className，该函数会传入该行数据，索引和key当做参数，返回的字符串将被设为该行的className | - | - |
+| group | `TableGroupValue` | `undefined` | 否 | 分组配置 | - | - |
+| sort | `TableSortValue` | `undefined` | 否 | 排序配置，可用v-model:sort双向绑定 | - | - |
+| loading | `boolean` | `false` | 否 | 是否展示加载状态 | - | - |
+| merge | `TableMerge` | `undefined` | 否 | 指定表格单元格合并逻辑 | - | - |
+| expandedKeys | `TableRowKey[]` | `undefined` | 否 | 通过key来指定哪些行展开，可用v-model:expandedKeys绑定 | - | - |
+| rowExpandable | `boolean` | `true` | 否 | 是否点击该行任意区域即展开 | - | - |
+| selectedKeys | `TableRowKey[]` | `undefined` | 否 | 当rowSelectable取值为非false时，指定哪些行高亮 | - | - |
+| rowSelectable | `boolean | "single" | "multiple"` | `false` | 否 | 是否点击行时高亮该行，取值为multiple时，可以同时高亮多行 | - | - |
+| childrenKey | `string` | `"children"` | 否 | 树形表格指定子元素键名 | - | - |
+| indent | `number` | `32` | 否 | 树形表格指定子元素缩进宽度 | - | - |
+| spreadKeys | `TableRowKey[]` | `undefined` | 否 | 树形表格指定展开的行，可用v-model:spreadKeys绑定 | - | - |
+| tooltipPosition | `"left" | "bottom" | "right" | "top" | Position` | `"top"` | 否 | 行提示的位置 | - | - |
+| tooltipContainer | `Container` | `undefined` | 否 | 指定行提示弹层追加的位置，支持函数或 CSS 选择器 | - | - |
+| keepStatus | `boolean` | `false` | 否 | 是否在行销毁的时候，保持该行在checkedKeys | selectedKeys | spreadKeys | expandedKeys中的key值 | - | - |
+| showIndeterminate | `boolean` | `true` | 否 | 表头的Checkbox是否支持展示半选中状态 | - | - |
+| resizable | `boolean` | `false` | 否 | 是否可以表头拖动调整列宽 | - | - |
+| minColWidth | `number` | `40` | 否 | 指定所有列拖动时的最小宽度 | - | - |
+| widthStoreKey | `string` | `undefined` | 否 | 如果要保存表格拖动后的列宽信息，可以通过该属性设置保存到localStorage中的key | - | - |
+| draggable | `boolean` | `false` | 否 | 表格行是否可拖动排序 | - | - |
+| animation | `boolean | [boolean, boolean]` | `true` | 否 | 是否开启动效，可以通过数组单独设置行和列的动效 | - | - |
+| hideHeader | `boolean` | `false` | 否 | 是否隐藏表头 | - | - |
+| pagination | `boolean | PaginationProps` | `false` | 否 | 是否支持分页，可传入对象配置分页参数 | - | - |
+| fixFooter | `boolean` | `false` | 否 | table给定需要固定高度时，自定义footer固定 | - | - |
+| load | `(node: any) => Promise<any[]> | void` | `undefined` | 否 | 指定异步加载节点数据的函数，该函数通过Promise返回数组来添加子节点数据 | - | - |
+| spreadArrowIndex | `number` | `0` | 否 | 指定树形表格展开Icon的所在列，默认在第一列 | - | - |
+| virtual | `boolean` | `false` | 否 | 是否开启虚拟滚动，适用于大数据量场景 | - | - |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
@@ -65,15 +65,35 @@ import { Table, TableColumn } from '@king-design/vue';
 | uncheckAll | `@uncheck-all` | 手动取消全选触发 | `-` | `<Table @uncheck-all="handleUncheckAll" />` |
 | page | `@page` | 当内置翻页改变页码或每页数量时触发 | `data: {value: number, limit: number}` | `<Table :data="data" :pagination="true" @page="handlePage"></Table>` |
 
-### 事件处理函数示例
-**clickRow**:
+### 事件参数说明
+**clickRow**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| data | `T` | 是 | - | 行数据 |
+| index | `number` | 是 | - | 行索引 |
+| key | `TableRowKey` | 是 | - | 行key |
+
+事件处理示例:
 ```typescript
 const handleClickRow = (data: any, index: number, key: string | number) => {
   console.log('点击行:', data);
 };
 ```
 
-**dragend**:
+**dragstart**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| data | `{key: TableRowKey, from: number}` | 是 | - | 拖动开始信息 |
+
+**dragend**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| data | `{key: TableRowKey, from: number, to: number}` | 是 | - | 拖动结束信息 |
+
+事件处理示例:
 ```typescript
 const handleDragEnd = (info: {key: number, from: number, to: number}) => {
   const item = data.value.splice(info.from, 1)[0];
@@ -81,21 +101,43 @@ const handleDragEnd = (info: {key: number, from: number, to: number}) => {
 };
 ```
 
-**checkRow**:
+**checkRow**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| data | `T` | 是 | - | 选中行数据 |
+| index | `number` | 是 | - | 行索引 |
+| key | `TableRowKey` | 是 | - | 行key |
+
+事件处理示例:
 ```typescript
 const handleCheckRow = (data: any, index: number, key: string | number) => {
   console.log('选中行:', data);
 };
 ```
 
-**uncheckRow**:
+**uncheckRow**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| data | `T` | 是 | - | 取消选中行数据 |
+| index | `number` | 是 | - | 行索引 |
+| key | `TableRowKey` | 是 | - | 行key |
+
+事件处理示例:
 ```typescript
 const handleUncheckRow = (data: any, index: number, key: string | number) => {
   console.log('取消选中:', data);
 };
 ```
 
-**page**:
+**page**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| data | `{value: number, limit: number}` | 是 | - | 分页信息 |
+
+事件处理示例:
 ```typescript
 const handlePage = (pageInfo: {value: number, limit: number}) => {
   console.log('当前页:', pageInfo.value, '每页:', pageInfo.limit);
@@ -129,13 +171,33 @@ const handlePage = (pageInfo: {value: number, limit: number}) => {
 ## 方法 (Methods)
 | 方法名 | 说明 | 参数 | 返回值 |
 | --- | --- | --- | --- |
-| getCheckedData | 获取选中数据信息 | `` | `T[]` |
-| getSelectedData | 获取高亮行数据信息 | `` | `T[]` |
-| checkAll | 全部选中 | `` | `void` |
-| uncheckAll | 全不选中 | `` | `void` |
+| getCheckedData | 获取选中数据信息 | `-` | `T[]` |
+| getSelectedData | 获取高亮行数据信息 | `-` | `T[]` |
+| checkAll | 全部选中 | `-` | `void` |
+| uncheckAll | 全不选中 | `-` | `void` |
 | scrollToRowByIndex | 通过索引指定滚动的行 | `index: number` | `Promise<void>` |
 | scrollToRowByKey | 通过key指定滚动的行 | `key: TableRowKey` | `Promise<void>` |
-| exportTable | 导出表格 | `data: T[], filename: string` | `Promise<string>` |
+| exportTable | 导出表格 | `data?: T[], filename?: string` | `Promise<string>` |
+
+### 方法参数说明
+**scrollToRowByIndex**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| index | `number` | 是 | - | 行索引 |
+
+**scrollToRowByKey**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| key | `TableRowKey` | 是 | - | 行key |
+
+**exportTable**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| data | `T[]` | 否 | `this.data` | 要导出的数据 |
+| filename | `string` | 否 | `"table"` | 导出文件名 |
 
 ## 子组件 (Sub-Components)
 ### TableColumn
@@ -166,22 +228,27 @@ const handlePage = (pageInfo: {value: number, limit: number}) => {
 - `#default="[data, index]"`: 与template扩展点等价，为了方便vue中使用的别名
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### TableColumn 作用域插槽参数解构方式错误
 > **错误用法**: `<template #default="{ row }">`
 > **正确写法**: `<template #default="[row]">`
 > **说明**: KPC 组件库使用数组形式传递作用域插槽参数，而非对象解构。正确写法是 [row] 或 [row, index]，不是 { row } 或 { row, index }
 
+### TableColumn 未设置 key 属性
 > **错误用法**: `<TableColumn title="姓名" />`
 > **正确写法**: `<TableColumn key="name" title="姓名" />`
 > **说明**: TableColumn 的 key 属性是必须的，用于标识列和数据映射
 
+### 使用选择功能时未设置 rowKey
 > **错误用法**: `<Table :data="data" checkType="checkbox" v-model:checkedKeys="keys">`
 > **正确写法**: `<Table :data="data" checkType="checkbox" v-model:checkedKeys="keys" :rowKey="row => row.id">`
 > **说明**: 使用 checkType 进行行选择时，应该设置 rowKey 来唯一标识每行，否则默认使用数组索引，数据变化时可能导致选中状态错乱
 
+### TableColumn 错误使用 prop 属性
 > **错误用法**: `<TableColumn prop="name" />`
 > **正确写法**: `<TableColumn key="name" />`
 > **说明**: KPC TableColumn 使用 `key` 属性来指定数据字段，而不是 `prop`。
 
+### TableColumn 错误使用 label 属性
 > **错误用法**: `<TableColumn label="姓名" />`
 > **正确写法**: `<TableColumn title="姓名" />`
 > **说明**: KPC TableColumn 使用 `title` 属性来指定列标题，而不是 `label`。

package/docs_for_llm/tablecolumnid.doc.md

@@ -2,9 +2,9 @@
 
 用于表格中的ID列展示，支持复制功能和禁用状态。
 
-**关键词**: id, column, table, 表格列
+**关键词**: id, column, table, 表格列, ID列, 名称ID列, 资源标识列
 
-**使用场景**: 资源列表ID列展示
+**使用场景**: 资源列表ID列展示、支持复制的名称和 ID 展示、表格中可点击资源名称列
 
 ## 导入语句
 ```typescript
@@ -12,20 +12,20 @@ import { TableColumnId } from '@ksyun-internal/versatile';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| name | `string` | `""` | 否 | 显示的名称 | - |
-| id | `string` | `""` | 否 | 显示的 id | - |
-| disabled | `boolean` | `false` | 否 | 是否禁止复制功能 | - |
-| disabledClickName | `boolean` | `false` | 否 | 是否置灰名称 | - |
-| disabledEditable | `boolean` | `false` | 否 | 是否置灰编辑按钮 | - |
-| type | `"link" | "none"` | `"link"` | 否 | 样式模式 | - |
-| editable | `boolean` | `false` | 否 | 名称是否支持编辑 | - |
-| editableTip | `string` | `"编辑"` | 否 | 编辑图标的 tooltip 提示，默认编辑 | - |
-| editableProps | `Record<string, any>` | `undefined` | 否 | Editable 组件支持的属性 | - |
-| to | `string | RouteLocationAsRelativeGeneric | RouteLocationAsPathGeneric` | `undefined` | 否 | 链接跳转路径，当 type 为 'link' 时生效，同 router-link 的 to 属性一致；当使用 to 属性进行跳转时，右键菜单栏才会出现 '在新标签页中打开' | - |
-| target | `'_blank' | '_self' | '_parent' | '_top'` | `'_self'` | 否 | 链接跳转目标，当 type 为 'link' 且使用 to 时生效，同 a 标签的 target 属性一致 | - |
-| maxLines | `number` | `1` | 否 | 名称/ID 展示的最大行数，超出部分会被省略号代替 | - |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| name | `string` | `""` | 否 | 显示的名称 | - | - |
+| id | `string` | `""` | 否 | 显示的 id | - | - |
+| disabled | `boolean` | `false` | 否 | 是否禁止复制功能 | - | - |
+| disabledClickName | `boolean` | `false` | 否 | 是否置灰名称 | - | - |
+| disabledEditable | `boolean` | `false` | 否 | 是否置灰编辑按钮 | - | - |
+| type | `"link" | "none"` | `"link"` | 否 | 样式模式 | - | - |
+| editable | `boolean` | `false` | 否 | 名称是否支持编辑 | - | - |
+| editableTip | `string` | `"编辑"` | 否 | 编辑图标的 tooltip 提示，默认编辑 | - | - |
+| editableProps | `Record<string, any>` | `undefined` | 否 | Editable 组件支持的属性 | - | - |
+| to | `string | RouteLocationAsRelativeGeneric | RouteLocationAsPathGeneric` | `undefined` | 否 | 链接跳转路径，当 type 为 'link' 时生效，同 router-link 的 to 属性一致；当使用 to 属性进行跳转时，右键菜单栏才会出现 '在新标签页中打开' | - | - |
+| target | `'_blank' | '_self' | '_parent' | '_top'` | `'_self'` | 否 | 链接跳转目标，当 type 为 'link' 且使用 to 时生效，同 a 标签的 target 属性一致 | - | - |
+| maxLines | `number` | `1` | 否 | 名称/ID 展示的最大行数，超出部分会被省略号代替 | - | - |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
@@ -34,3 +34,23 @@ import { TableColumnId } from '@ksyun-internal/versatile';
 | click:id | `@click:id` | 当点击 id 时触发 | `value: string` | `<TableColumnId @click:id="handleClickId" />` |
 | change:name | `@change:name` | 当编辑名称，名称内容改变时触发 | `newValue: string, oldValue: string` | `<TableColumnId @change:name="(newVal, oldVal) => handleNameChange(newVal, oldVal)" /></TableColumnId>` |
 
+### 事件参数说明
+**click:name**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `string` | 是 | - | 名称的值 |
+
+**click:id**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `string` | 是 | - | id 的值 |
+
+**change:name**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| newValue | `string` | 是 | - | 新的名称值 |
+| oldValue | `string` | 是 | - | 旧的名称值 |
+

package/docs_for_llm/tabs.doc.md

@@ -12,22 +12,28 @@ import { Tabs, Tab } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| value | `any` | `undefined` | 否 | 被选中的选项卡，可用 v-model 双向绑定 | `<Tabs v-model="activeTab"></Tabs>` |
-| type | `"default" | "card" | "flat-card"` | `"default"` | 否 | 选项卡类型 | `<Tabs type="card"></Tabs>` |
-| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 选项卡尺寸 | `<Tabs size="small"></Tabs>` |
-| vertical | `boolean` | `undefined` | 否 | 是否垂直排列 | `<Tabs vertical></Tabs>` |
-| closable | `boolean` | `false` | 否 | 是否展示选项卡关闭按钮 | `<Tabs closable @remove="handleRemove"></Tabs>` |
-| beforeChange | `(value: any) => boolean | Promise<boolean>` | `undefined` | 否 | 切换选项卡之前的拦截函数，返回 false 阻止切换，支持异步 | `<Tabs :beforeChange="handleBeforeChange"></Tabs>` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| value | `any` | `undefined` | 否 | 被选中的选项卡，可用 v-model 双向绑定 | - | `<Tabs v-model="activeTab"></Tabs>` |
+| type | `"default" | "card" | "flat-card"` | `"default"` | 否 | 选项卡类型 | - | `<Tabs type="card"></Tabs>` |
+| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 选项卡尺寸 | - | `<Tabs size="small"></Tabs>` |
+| vertical | `boolean` | `undefined` | 否 | 是否垂直排列 | - | `<Tabs vertical></Tabs>` |
+| closable | `boolean` | `false` | 否 | 是否展示选项卡关闭按钮 | - | `<Tabs closable @remove="handleRemove"></Tabs>` |
+| beforeChange | `(value: any) => boolean | Promise<boolean>` | `undefined` | 否 | 切换选项卡之前的拦截函数，返回 false 阻止切换，支持异步 | - | `<Tabs :beforeChange="handleBeforeChange"></Tabs>` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
 | remove | `@remove` | 关闭选项卡时触发 | `value: any` | `<Tabs @remove="handleRemove"></Tabs>` |
 
-### 事件处理函数示例
-**remove**:
+### 事件参数说明
+**remove**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `any` | 是 | - | 被关闭选项卡的 value |
+
+事件处理示例:
 ```typescript
 const handleRemove = (value: string) => {
   const index = tabs.value.indexOf(value);
@@ -50,6 +56,7 @@ const handleRemove = (value: string) => {
 - `@click`: Tab 点击事件，发生在 value 改变之后，disabled 状态不触发
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 期望 Tabs 自动切换内容
 > **错误用法**: `<Tabs v-model="activeTab">
   <Tab value="home">首页内容</Tab> <!-- 期望显示内容 -->
 </Tabs>`
@@ -59,10 +66,12 @@ const handleRemove = (value: string) => {
 <div v-if="activeTab === 'home'">首页内容</div>`
 > **说明**: Tabs 仅提供头部样式，内容区域需要使用 v-if 自行切换
 
+### Tab 未设置 value
 > **错误用法**: `<Tab>选项卡</Tab>`
 > **正确写法**: `<Tab value="tab1">选项卡</Tab>`
 > **说明**: 每个 Tab 必须设置 value 用于标识
 
+### 使用 closable 但未处理 remove 事件
 > **错误用法**: `<Tabs closable> <!-- 点击关闭不会真正移除 -->`
 > **正确写法**: `<Tabs closable @remove="handleRemove">`
 > **说明**: closable 只显示关闭按钮，需要监听 remove 事件手动移除选项卡

package/docs_for_llm/tag.doc.md

@@ -12,22 +12,28 @@ import { Tag, Tags } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| type | `"default" | "primary" | "success" | "warning" | "danger"` | `"default"` | 否 | 组件类型，决定标签的视觉样式 | `<Tag type="primary">主要标签</Tag>` |
-| closable | `boolean` | `false` | 否 | 是否可关闭，显示关闭按钮 | `<Tag closable @close="handleClose">可关闭标签</Tag>` |
-| closed | `boolean` | `false` | 否 | 是否已关闭（受控模式） | `<Tag closable :closed="isClosed" @close="handleClose">标签</Tag>` |
-| disabled | `boolean` | `false` | 否 | 是否展示禁用状态 | `<Tag disabled>禁用标签</Tag>` |
-| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 组件尺寸 | `<Tag size="small">小标签</Tag>` |
-| border | `"solid" | "dashed" | "none"` | `"none"` | 否 | 定义边框样式 | `<Tag border="solid">带边框标签</Tag>` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| type | `"default" | "primary" | "success" | "warning" | "danger"` | `"default"` | 否 | 组件类型，决定标签的视觉样式 | - | `<Tag type="primary">主要标签</Tag>` |
+| closable | `boolean` | `false` | 否 | 是否可关闭，显示关闭按钮 | - | `<Tag closable @close="handleClose">可关闭标签</Tag>` |
+| closed | `boolean` | `false` | 否 | 是否已关闭（受控模式） | - | `<Tag closable :closed="isClosed" @close="handleClose">标签</Tag>` |
+| disabled | `boolean` | `false` | 否 | 是否展示禁用状态 | - | `<Tag disabled>禁用标签</Tag>` |
+| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 组件尺寸 | - | `<Tag size="small">小标签</Tag>` |
+| border | `"solid" | "dashed" | "none"` | `"none"` | 否 | 定义边框样式 | - | `<Tag border="solid">带边框标签</Tag>` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
 | close | `@close` | 标签关闭事件，点击关闭按钮时触发 | `e: MouseEvent` | `<Tag closable @close="handleClose">可关闭</Tag>` |
 
-### 事件处理函数示例
-**close**:
+### 事件参数说明
+**close**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| e | `MouseEvent` | 是 | - | 原生鼠标事件对象 |
+
+事件处理示例:
 ```typescript
 const handleClose = (e: MouseEvent) => {
   console.log('标签已关闭');
@@ -53,14 +59,17 @@ const handleClose = (e: MouseEvent) => {
 - `undefined`: 追加到后面的元素，不参与到Tags对Tag的管理中
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 可关闭标签未使用受控模式
 > **错误用法**: `<Tag closable>标签</Tag>`
 > **正确写法**: `<Tag closable :closed="isClosed" @close="handleClose">标签</Tag>`
 > **说明**: closable 只显示关闭按钮，需要配合 closed 属性和 @close 事件来控制关闭行为
 
+### 使用不存在的 type 值
 > **错误用法**: `<Tag type="info">信息标签</Tag>`
 > **正确写法**: `<Tag type="primary">主要标签</Tag>`
 > **说明**: Tag 的 type 只支持 default, primary, success, warning, danger，不存在 info 值
 
+### 拖拽标签组未设置 key
 > **错误用法**: `<Tags draggable>
   <Tag v-for="tag in tags">{{ tag }}</Tag>
 </Tags>`

package/docs_for_llm/timeline.doc.md

@@ -0,0 +1,109 @@
+# 时间轴 (Timeline)
+
+时间轴组件，用于按时间顺序展示事件或流程记录。配合 TimelineItem 子组件使用，支持不同状态类型和自定义节点。
+
+**关键词**: timeline, 时间轴, 操作记录, 流程日志, TimelineItem, dot
+
+**使用场景**: 操作日志、订单轨迹、发布流程、任务执行记录
+
+## 导入语句
+```typescript
+import { Timeline, TimelineItem } from '@king-design/vue';
+```
+
+## 插槽 (Slots)
+| 插槽名 | 说明 | 模板写法 | 示例 |
+| --- | --- | --- | --- |
+| default | 时间轴内容，通常由多个 TimelineItem 组成。 | `<Timeline>...</Timeline>` | `<Timeline><TimelineItem>创建完成</TimelineItem><TimelineItem>审核通过</TimelineItem></Timeline>` |
+
+## 子组件 (Sub-Components)
+### TimelineItem
+时间轴节点项。
+
+| 属性名 | 类型 | 说明 | 示例 |
+| --- | --- | --- | --- |
+| type | `"primary" | "warning" | "danger" | "success"` | 节点状态类型。 | `<TimelineItem type="success">发布成功</TimelineItem>` |
+| size | `"large" | "default" | "small" | "mini"` | 节点尺寸。 | `<TimelineItem size="small">日志记录</TimelineItem>` |
+
+**插槽**:
+- `<template #dot>...</template>`: 自定义时间轴节点圆点。
+
+## 常见错误与正确用法 (Anti-Hallucination)
+### 在 Timeline 中直接写普通 div，而不是 TimelineItem
+> **错误用法**: `<Timeline><div>创建成功</div><div>发布完成</div></Timeline>`
+> **正确写法**: `<Timeline><TimelineItem>创建成功</TimelineItem><TimelineItem>发布完成</TimelineItem></Timeline>`
+> **说明**: Timeline 负责整体容器结构，具体节点应使用 TimelineItem 渲染，才能获得连线、圆点和状态样式。
+
+### 把 dot 插槽写在 Timeline 上
+> **错误用法**: `<Timeline><template #dot>1</template></Timeline>`
+> **正确写法**: `<Timeline><TimelineItem><template #dot>1</template>步骤一</TimelineItem></Timeline>`
+> **说明**: dot 是 TimelineItem 的插槽，不属于 Timeline 容器本身。
+
+## 使用示例
+### 基础用法
+**场景**: 展示任务处理过程
+
+按时间顺序展示操作记录。
+
+**使用的 API**: 属性: type | 插槽: default
+
+```vue
+<template>
+  <Timeline>
+    <TimelineItem>2026-04-20 10:00 创建任务</TimelineItem>
+    <TimelineItem>2026-04-20 10:10 分配负责人</TimelineItem>
+    <TimelineItem type="success">2026-04-20 10:30 处理完成</TimelineItem>
+  </Timeline>
+</template>
+```
+
+### 不同状态节点
+**场景**: 用时间轴展示状态变更
+
+用颜色区分不同阶段。
+
+**使用的 API**: 属性: type | 插槽: default
+
+```vue
+<template>
+  <Timeline>
+    <TimelineItem type="primary">等待执行</TimelineItem>
+    <TimelineItem type="warning">处理中</TimelineItem>
+    <TimelineItem type="danger">执行失败</TimelineItem>
+    <TimelineItem type="success">重新执行成功</TimelineItem>
+  </Timeline>
+</template>
+```
+
+### 自定义节点
+**场景**: 用图标增强时间轴状态表达
+
+通过 dot 插槽渲染图标或编号。
+
+**使用的 API**: 属性: type | 插槽: dot
+
+```vue
+<script setup lang="ts">
+import { Icon, Timeline, TimelineItem } from '@king-design/vue';
+</script>
+<template>
+  <Timeline>
+    <TimelineItem>
+      <template #dot>
+        <Icon class="k-icon-play-circle" />
+      </template>
+      服务启动
+    </TimelineItem>
+    <TimelineItem type="success">
+      <template #dot>
+        <Icon class="k-icon-check" />
+      </template>
+      健康检查通过
+    </TimelineItem>
+  </Timeline>
+</template>
+```
+
+## 相关组件
+Steps, Tag, Icon
+