king-design-analyzer 2.1.9 → 2.2.0

package/docs_for_llm/sshkeys.doc.md

@@ -0,0 +1,88 @@
+# SSH 密钥选择 (SSHKeys)
+
+用于拉取并选择 SSH 密钥的业务组件，适合实例创建、重置登录方式和批量授权等需要登录凭证选择的场景。
+
+**关键词**: ssh keys, ssh key, SSH 密钥, 登录凭证, 密钥选择, ssh credential, 密钥下拉, linux 登录
+
+**使用场景**: 实例创建 SSH 登录凭证选择、批量实例登录方式配置、禁用不合规密钥选项、选择后联动密钥实体信息
+
+## 导入语句
+```typescript
+import { SSHKeys } from '@ksyun-internal/versatile';
+```
+
+## 属性 (Props)
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| modelValue | `string` | `undefined` | 否 | 当前选中的密钥 ID | - | - |
+| href | `string` | `undefined` | 否 | 跳转到密钥管理页的链接 | - | - |
+| disableOption | `any` | `undefined` | 否 | 禁用选项的配置或函数 | - | - |
+
+## 事件 (Events)
+| 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
+| --- | --- | --- | --- | --- |
+| update:modelValue | `@update:modelValue` | 所选 SSH 密钥 ID 变化时触发，可直接同步表单主值。 | `value?: string` | - |
+| update:key | `@update:key` | 所选完整密钥对象变化时触发，便于读取密钥名称、指纹等信息。 | `value?: SSHKeyItem` | - |
+
+### 事件参数说明
+**update:modelValue**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `string` | 否 | - | 当前选中的 SSH 密钥 ID。 |
+
+**update:key**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `SSHKeyItem` | 否 | - | 当前选中的完整 SSH 密钥对象。 |
+
+## 使用示例
+### 创建实例时选择 SSH 密钥
+**场景**: 在创建 Linux 实例时选择已有 SSH 密钥作为登录凭证。
+
+把 SSH 密钥选择作为登录方式的一部分。
+
+**使用的 API**: 属性: modelValue, href | 事件: update:modelValue, update:key
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { SSHKeys } from '@ksyun-internal/versatile';
+
+const keyId = ref('key-001');
+</script>
+
+<template>
+  <SSHKeys v-model="keyId" href="/ssh-key/list" />
+</template>
+```
+
+### 禁用不合规的 SSH 密钥
+**场景**: 在创建实例时禁用过期或不符合规范的 SSH 密钥。
+
+根据业务规则禁用部分密钥选项，避免被误选。
+
+**使用的 API**: 属性: modelValue, href, disableOption | 事件: update:modelValue, update:key
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { SSHKeys } from '@ksyun-internal/versatile';
+
+const keyId = ref('');
+const disableOption = (item: { expired?: boolean }) => Boolean(item?.expired);
+</script>
+
+<template>
+  <SSHKeys
+    v-model="keyId"
+    href="/ssh-key/list"
+    :disable-option="disableOption"
+  />
+</template>
+```
+
+## 相关组件
+Projects
+

package/docs_for_llm/status.doc.md

@@ -2,9 +2,9 @@
 
 显示状态图标和文本，支持旋转动画。
 
-**关键词**: status, indicator, loading, 状态
+**关键词**: status, indicator, loading, 状态, 状态指示器, 加载状态, 进度状态
 
-**使用场景**: 表格行状态展示、详情页资源状态
+**使用场景**: 表格行状态展示、详情页资源状态、带进度的任务状态展示、支持刷新动作的状态提示
 
 ## 导入语句
 ```typescript
@@ -12,11 +12,16 @@ import { Status } from '@ksyun-internal/versatile';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| type | `StatusType` | `undefined` | 否 | 状态类型 | - |
-| color | `string` | `undefined` | 否 | 自定义颜色 | - |
-| text | `string` | `undefined` | 否 | 状态文本 | - |
-| rotate | `boolean` | `undefined` | 否 | 是否旋转图标 | - |
-| refresh | `() => Promise<void>` | `undefined` | 否 | 刷新函数，传递此属性时会显示刷新按钮 | - |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| type | `StatusType` | `undefined` | 否 | 状态类型 | - | - |
+| color | `string` | `undefined` | 否 | 自定义颜色 | - | - |
+| text | `string` | `undefined` | 否 | 状态文本 | - | - |
+| rotate | `boolean` | `undefined` | 否 | 是否旋转图标 | - | - |
+| rotationDuration | `string | number` | `undefined` | 否 | 旋转动画时长，支持字符串或数字 | - | - |
+| refresh | `() => Promise<void>` | `undefined` | 否 | 刷新函数，传递此属性时会显示刷新按钮 | - | - |
+| tip | `string` | `undefined` | 否 | 状态说明提示文案 | - | - |
+| progress | `number` | `undefined` | 否 | 进度值，传入后可展示带进度语义的状态 | - | - |
+| refreshTip | `string` | `undefined` | 否 | 刷新按钮的 tooltip 文案 | - | - |
+| position | `"left" | "right" | "top" | "bottom" | Options` | `undefined` | 否 | 状态提示或刷新按钮的弹出位置 | - | - |
 

package/docs_for_llm/steps.doc.md

@@ -12,13 +12,13 @@ import { Steps, Step } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| value | `number` | `undefined` | 否 | 当前第几步，从 0 开始，可用 v-model 双向绑定 | `<Steps :value="current"></Steps>` |
-| status | `"normal" | "error"` | `"normal"` | 否 | 步骤条的状态 | `<Steps status="error"></Steps>` |
-| type | `"default" | "line" | "simple" | "line-compact"` | `"default"` | 否 | 步骤条样式 | `<Steps type="line"></Steps>` |
-| clickable | `boolean` | `false` | 否 | 是否支持快速切换已完成的步骤 | `<Steps v-model="current" clickable></Steps>` |
-| vertical | `boolean` | `false` | 否 | 是否垂直排列 | `<Steps vertical></Steps>` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| value | `number` | `undefined` | 否 | 当前第几步，从 0 开始，可用 v-model 双向绑定 | - | `<Steps :value="current"></Steps>` |
+| status | `"normal" | "error"` | `"normal"` | 否 | 步骤条的状态 | - | `<Steps status="error"></Steps>` |
+| type | `"default" | "line" | "simple" | "line-compact"` | `"default"` | 否 | 步骤条样式 | - | `<Steps type="line"></Steps>` |
+| clickable | `boolean` | `false` | 否 | 是否支持快速切换已完成的步骤 | - | `<Steps v-model="current" clickable></Steps>` |
+| vertical | `boolean` | `false` | 否 | 是否垂直排列 | - | `<Steps vertical></Steps>` |
 
 ## 子组件 (Sub-Components)
 ### Step
@@ -29,16 +29,19 @@ import { Steps, Step } from '@king-design/vue';
 | title | `string` | 步骤标题 | `<Step title="步骤1" />` |
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### value 从 1 开始而非 0
 > **错误用法**: `const current = ref(1); // 期望第一步
 <Steps :value="current">`
 > **正确写法**: `const current = ref(0); // 第一步
 <Steps :value="current">`
 > **说明**: Steps 的 value 从 0 开始，0 表示第一步
 
+### 使用 clickable 但未用 v-model
 > **错误用法**: `<Steps :value="current" clickable> <!-- 点击不会改变值 -->`
 > **正确写法**: `<Steps v-model="current" clickable>`
 > **说明**: 使用 clickable 时需要用 v-model 进行双向绑定才能响应点击
 
+### type 值拼写错误
 > **错误用法**: `<Steps type="compact">`
 > **正确写法**: `<Steps type="line-compact">`
 > **说明**: type 只支持 default, line, simple, line-compact

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 事件手动移除选项卡