king-design-analyzer 2.1.7 → 2.2.0

package/docs_for_llm/skeleton.doc.md

@@ -0,0 +1,117 @@
+# 骨架屏 (Skeleton)
+
+骨架屏组件，用于在内容加载阶段展示占位结构，减轻页面空白感。支持内置文本行、头像骨架和自定义骨架项。
+
+**关键词**: skeleton, 骨架屏, loading, 占位, avator, SkeletonItem
+
+**使用场景**: 列表加载占位、详情页内容预加载、卡片骨架、表单异步初始化
+
+## 导入语句
+```typescript
+import { Skeleton, SkeletonItem } from '@king-design/vue';
+```
+
+## 属性 (Props)
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| loading | `boolean` | `undefined` | 是 | 是否处于加载中。为 true 时显示骨架内容，否则渲染为空或交由外层控制真实内容展示。 | - | `<Skeleton :loading="loading" />` |
+| animated | `boolean` | `false` | 否 | 是否启用骨架闪动动画。 | - | `<Skeleton :loading="loading" animated />` |
+| rows | `number` | `2` | 否 | 文本骨架行数，最小按 1 处理。 | - | `<Skeleton :loading="loading" :rows="4" />` |
+| avator | `boolean` | `false` | 否 | 是否展示头像占位。注意组件属性名为 avator，与常见 avatar 拼写不同。 | - | `<Skeleton :loading="loading" avator />` |
+| size | `string` | `"large"` | 否 | 骨架尺寸，影响占位块的高度与间距。 | - | `<Skeleton :loading="loading" size="small" />` |
+
+## 插槽 (Slots)
+| 插槽名 | 说明 | 模板写法 | 示例 |
+| --- | --- | --- | --- |
+| default | 自定义骨架内容。当 loading 为 true 时，默认插槽内容会作为骨架结构渲染。 | `<Skeleton :loading="loading">...</Skeleton>` | `<Skeleton :loading="loading"><div style="display:flex; gap:12px;"><SkeletonItem type="avator" /><div style="flex:1;"><SkeletonItem type="text" /><SkeletonItem type="text" /></div></div></Skeleton>` |
+
+## 子组件 (Sub-Components)
+### SkeletonItem
+单个骨架项组件，用于组合更复杂的骨架布局。
+
+| 属性名 | 类型 | 说明 | 示例 |
+| --- | --- | --- | --- |
+| type | `"text" | "avator" | "image" | "button" | "input"` | 骨架项类型。 | `<SkeletonItem type="image" />` |
+
+## 常见错误与正确用法 (Anti-Hallucination)
+### 误以为 Skeleton 会自动在 loading=false 时渲染真实内容
+> **错误用法**: `<Skeleton :loading="loading"><RealContent /></Skeleton>`
+> **正确写法**: `<Skeleton :loading="loading"><SkeletonItem type="text" /></Skeleton>
+<RealContent v-if="!loading" />`
+> **说明**: 当前 Skeleton 在 loading 为 true 时负责渲染骨架结构，真实内容建议由外层通过条件渲染控制。
+
+### 把 avator 错写成 avatar
+> **错误用法**: `<Skeleton :loading="loading" avatar />`
+> **正确写法**: `<Skeleton :loading="loading" avator />`
+> **说明**: 该组件实际属性名是 avator，需按源码字段使用，否则不会展示头像骨架。
+
+## 使用示例
+### 基础用法
+**场景**: 列表请求中展示文本占位
+
+展示默认文本骨架。
+
+**使用的 API**: 属性: loading, rows, animated
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Skeleton } from '@king-design/vue';
+
+const loading = ref(true);
+</script>
+<template>
+  <Skeleton :loading="loading" :rows="3" animated />
+</template>
+```
+
+### 带头像骨架
+**场景**: 个人信息卡片加载态
+
+适合用户卡片、评论列表等结构。
+
+**使用的 API**: 属性: loading, avator, rows
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Skeleton } from '@king-design/vue';
+
+const loading = ref(true);
+</script>
+<template>
+  <Skeleton :loading="loading" avator :rows="2" />
+</template>
+```
+
+### 自定义骨架布局
+**场景**: 自定义复杂卡片骨架
+
+通过 SkeletonItem 自定义表单或卡片骨架。
+
+**使用的 API**: 属性: loading | 插槽: default
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Skeleton, SkeletonItem } from '@king-design/vue';
+
+const loading = ref(true);
+</script>
+<template>
+  <Skeleton :loading="loading">
+    <div style="display: flex; gap: 12px; align-items: flex-start;">
+      <SkeletonItem type="image" />
+      <div style="flex: 1; display: grid; gap: 8px;">
+        <SkeletonItem type="text" />
+        <SkeletonItem type="input" />
+        <SkeletonItem type="button" />
+      </div>
+    </div>
+  </Skeleton>
+</template>
+```
+
+## 相关组件
+Spin, Card, Image
+

package/docs_for_llm/slider.doc.md

@@ -12,33 +12,40 @@ import { Slider } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| value | `number | [number, number]` | `0` | 否 | 当前值，可用 v-model 双向绑定。范围选择时为 [number, number] 数组 | `<Slider v-model="value" />` |
-| min | `number` | `0` | 否 | 最小值 | `<Slider :min="0" />` |
-| max | `number` | `100` | 否 | 最大值 | `<Slider :max="200" />` |
-| range | `boolean` | `false` | 否 | 是否是范围选择（双滑块） | `<Slider v-model="rangeValue" range />` |
-| step | `number | StepObject | StepFunction` | `1` | 否 | 步长，支持数字、对象配置或函数 | `<Slider :step="10" />` |
-| disabled | `boolean` | `false` | 否 | 是否禁用 | `<Slider disabled />` |
-| unit | `string` | `""` | 否 | 单位，用于刻度展示 | `<Slider unit="%" />` |
-| showEnd | `boolean` | `true` | 否 | 是否展示最小值和最大值刻度 | `<Slider :showEnd="false" />` |
-| showInput | `boolean` | `true` | 否 | 是否展示输入框 | `<Slider :showInput="false" />` |
-| showTooltip | `boolean` | `false` | 否 | 是否展示提示气泡 | `<Slider showTooltip />` |
-| always | `boolean` | `false` | 否 | 当展示气泡时，是否一直展示 | `<Slider showTooltip always />` |
-| points | `boolean | number[]` | `false` | 否 | 是否展示间隔点，或指定哪些值展示间隔点 | `<Slider :points="[25, 50, 75]" />` |
-| marks | `Marks` | `undefined` | 否 | 标注刻度，对象形式指定位置和标签 | `<Slider :marks="{0: '低', 50: '中', 100: '高'}" />` |
-| animate | `boolean` | `true` | 否 | 滑块移动是否使用缓动动画 | `<Slider :animate="false" />` |
-| forceStep | `boolean` | `true` | 否 | 是否限制 value（除边界外）满足 min + step * n | `<Slider :forceStep="false" />` |
-| tooltipProps | `TooltipProps` | `undefined` | 否 | 设置内置 Tooltip 的所有属性 | `<Slider showTooltip :tooltipProps="{position: 'bottom'}" />` |
-| spinnerProps | `SpinnerProps` | `undefined` | 否 | 设置内置 Spinner 输入框的所有属性 | `<Slider :spinnerProps="{precision: 2}" />` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| value | `number | [number, number]` | `0` | 否 | 当前值，可用 v-model 双向绑定。范围选择时为 [number, number] 数组 | - | `<Slider v-model="value" />` |
+| min | `number` | `0` | 否 | 最小值 | - | `<Slider :min="0" />` |
+| max | `number` | `100` | 否 | 最大值 | - | `<Slider :max="200" />` |
+| range | `boolean` | `false` | 否 | 是否是范围选择（双滑块） | - | `<Slider v-model="rangeValue" range />` |
+| step | `number | StepObject | StepFunction` | `1` | 否 | 步长，支持数字、对象配置或函数 | - | `<Slider :step="10" />` |
+| disabled | `boolean` | `false` | 否 | 是否禁用 | - | `<Slider disabled />` |
+| unit | `string` | `""` | 否 | 单位，用于刻度展示 | - | `<Slider unit="%" />` |
+| showEnd | `boolean` | `true` | 否 | 是否展示最小值和最大值刻度 | - | `<Slider :showEnd="false" />` |
+| showInput | `boolean` | `true` | 否 | 是否展示输入框 | - | `<Slider :showInput="false" />` |
+| showTooltip | `boolean` | `false` | 否 | 是否展示提示气泡 | - | `<Slider showTooltip />` |
+| always | `boolean` | `false` | 否 | 当展示气泡时，是否一直展示 | - | `<Slider showTooltip always />` |
+| points | `boolean | number[]` | `false` | 否 | 是否展示间隔点，或指定哪些值展示间隔点 | - | `<Slider :points="[25, 50, 75]" />` |
+| marks | `Marks` | `undefined` | 否 | 标注刻度，对象形式指定位置和标签 | - | `<Slider :marks="{0: '低', 50: '中', 100: '高'}" />` |
+| animate | `boolean` | `true` | 否 | 滑块移动是否使用缓动动画 | - | `<Slider :animate="false" />` |
+| forceStep | `boolean` | `true` | 否 | 是否限制 value（除边界外）满足 min + step * n | - | `<Slider :forceStep="false" />` |
+| tooltipProps | `TooltipProps` | `undefined` | 否 | 设置内置 Tooltip 的所有属性 | - | `<Slider showTooltip :tooltipProps="{position: 'bottom'}" />` |
+| spinnerProps | `SpinnerProps` | `undefined` | 否 | 设置内置 Spinner 输入框的所有属性 | - | `<Slider :spinnerProps="{precision: 2}" />` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
 | change | `@change` | 当值变化时触发，拖动过程中不会触发，拖动结束时触发 | `newValue: number | [number, number], oldValue: number | [number, number]` | `<Slider @change="handleChange" />` |
 
-### 事件处理函数示例
-**change**:
+### 事件参数说明
+**change**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| newValue | `number | [number, number]` | 是 | - | 新的值 |
+| oldValue | `number | [number, number]` | 是 | - | 旧的值 |
+
+事件处理示例:
 ```typescript
 const handleChange = (newVal: number, oldVal: number) => {
   console.log(`值从 ${oldVal} 变为 ${newVal}`);
@@ -51,16 +58,19 @@ const handleChange = (newVal: number, oldVal: number) => {
 | tooltip | 当展示提示气泡，定义气泡的内容，和Tooltip组件行为一样，如果你传入空的内容，则不会展示气泡 | `undefined` | - |
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 范围选择时 value 类型错误
 > **错误用法**: `const value = ref(50);
 <Slider v-model="value" range />`
 > **正确写法**: `const value = ref<[number, number]>([20, 80]);
 <Slider v-model="value" range />`
 > **说明**: 当 range 为 true 时，value 必须是 [number, number] 数组
 
+### step 使用字符串而非数字
 > **错误用法**: `<Slider step="10" />`
 > **正确写法**: `<Slider :step="10" />`
 > **说明**: step 是数字类型，需要使用 v-bind 语法
 
+### marks 格式错误
 > **错误用法**: `const marks = ['低', '中', '高'];`
 > **正确写法**: `const marks = {
   0: '低',

package/docs_for_llm/spin.doc.md

@@ -12,11 +12,11 @@ import { Spin } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 组件尺寸 | `<Spin size="small" />` |
-| center | `boolean` | `false` | 否 | 是否居中展示，需要父元素为定位元素（position: relative/absolute） | `<Spin center />` |
-| overlay | `boolean` | `false` | 否 | 是否展示带遮罩层的加载动画，需要父元素为定位元素 | `<Spin overlay center />` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 组件尺寸 | - | `<Spin size="small" />` |
+| center | `boolean` | `false` | 否 | 是否居中展示，需要父元素为定位元素（position: relative/absolute） | - | `<Spin center />` |
+| overlay | `boolean` | `false` | 否 | 是否展示带遮罩层的加载动画，需要父元素为定位元素 | - | `<Spin overlay center />` |
 
 ## 插槽 (Slots)
 | 插槽名 | 说明 | 模板写法 | 示例 |
@@ -24,6 +24,7 @@ import { Spin } from '@king-design/vue';
 | canvas | 自定义旋转的元素内容 | `undefined` | - |
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 使用 center 但父元素无定位
 > **错误用法**: `<div>
   <Spin center />
 </div>`
@@ -32,6 +33,7 @@ import { Spin } from '@king-design/vue';
 </div>`
 > **说明**: 使用 center 属性时，父元素必须设置 position: relative 或 absolute
 
+### 使用 overlay 但父元素无定位
 > **错误用法**: `<div>
   <Spin overlay />
   <p>内容</p>
@@ -42,6 +44,7 @@ import { Spin } from '@king-design/vue';
 </div>`
 > **说明**: 使用 overlay 时，父元素必须设置定位，且通常配合 center 使用
 
+### size 值拼写错误
 > **错误用法**: `<Spin size="xs" />`
 > **正确写法**: `<Spin size="mini" />`
 > **说明**: size 只支持 large, default, small, mini，不存在 xs 值

package/docs_for_llm/spinner.doc.md

@@ -12,30 +12,36 @@ import { Spinner } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| value | `number` | `0` | 否 | 组件的值，可用 v-model 进行双向绑定 | `<Spinner v-model="count" />` |
-| disabled | `boolean` | `false` | 否 | 是否禁用 | `<Spinner disabled />` |
-| max | `number` | `Number.POSITIVE_INFINITY` | 否 | 最大值 | `<Spinner :max="100" />` |
-| min | `number` | `Number.NEGATIVE_INFINITY` | 否 | 最小值 | `<Spinner :min="0" />` |
-| step | `number | StepObject | StepFunction` | `1` | 否 | 步长，支持数字、对象或函数形式的动态步长 | `<Spinner :step="5" />` |
-| size | `"default" | "small" | "mini"` | `"default"` | 否 | 尺寸 | `<Spinner size="small" />` |
-| vertical | `boolean` | `false` | 否 | 控制按钮是否竖直排列 | `<Spinner vertical />` |
-| precision | `number` | `undefined` | 否 | 控制展示精度，该值必须为正整数或 0 | `<Spinner :precision="2" :step="0.1" />` |
-| formatter | `(value: number) => string` | `undefined` | 否 | 定义格式化展示值的函数 | `<Spinner :formatter="(val) => `${val}%`" :parser="(val) => parseFloat(val)" /></Spinner>` |
-| parser | `(value: string) => number` | `undefined` | 否 | 与 formatter 结合使用，定义解析格式化的值的函数 | `<Spinner :formatter="(val) => `${val}%`" :parser="(val) => parseFloat(val)" /></Spinner>` |
-| prefix | `string` | `undefined` | 否 | 定义展示的值的前缀，优先级低于 formatter | `<Spinner prefix="¥" />` |
-| suffix | `string` | `undefined` | 否 | 定义展示的值的后缀，优先级低于 formatter | `<Spinner suffix="元" />` |
-| width | `string | number` | `undefined` | 否 | 指定 Input 输入框的宽度 | `<Spinner :width="150" />` |
-| forceStep | `boolean` | `false` | 否 | value 值除了边界值，都必须满足 min + step * n（n 为整数） | `<Spinner :min="0" :step="5" forceStep />` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| value | `number` | `0` | 否 | 组件的值，可用 v-model 进行双向绑定 | - | `<Spinner v-model="count" />` |
+| disabled | `boolean` | `false` | 否 | 是否禁用 | - | `<Spinner disabled />` |
+| max | `number` | `Number.POSITIVE_INFINITY` | 否 | 最大值 | - | `<Spinner :max="100" />` |
+| min | `number` | `Number.NEGATIVE_INFINITY` | 否 | 最小值 | - | `<Spinner :min="0" />` |
+| step | `number | StepObject | StepFunction` | `1` | 否 | 步长，支持数字、对象或函数形式的动态步长 | - | `<Spinner :step="5" />` |
+| size | `"default" | "small" | "mini"` | `"default"` | 否 | 尺寸 | - | `<Spinner size="small" />` |
+| vertical | `boolean` | `false` | 否 | 控制按钮是否竖直排列 | - | `<Spinner vertical />` |
+| precision | `number` | `undefined` | 否 | 控制展示精度，该值必须为正整数或 0 | - | `<Spinner :precision="2" :step="0.1" />` |
+| formatter | `(value: number) => string` | `undefined` | 否 | 定义格式化展示值的函数 | - | `<Spinner :formatter="(val) => `${val}%`" :parser="(val) => parseFloat(val)" /></Spinner>` |
+| parser | `(value: string) => number` | `undefined` | 否 | 与 formatter 结合使用，定义解析格式化的值的函数 | - | `<Spinner :formatter="(val) => `${val}%`" :parser="(val) => parseFloat(val)" /></Spinner>` |
+| prefix | `string` | `undefined` | 否 | 定义展示的值的前缀，优先级低于 formatter | - | `<Spinner prefix="¥" />` |
+| suffix | `string` | `undefined` | 否 | 定义展示的值的后缀，优先级低于 formatter | - | `<Spinner suffix="元" />` |
+| width | `string | number` | `undefined` | 否 | 指定 Input 输入框的宽度 | - | `<Spinner :width="150" />` |
+| forceStep | `boolean` | `false` | 否 | value 值除了边界值，都必须满足 min + step * n（n 为整数） | - | `<Spinner :min="0" :step="5" forceStep />` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
 | change | `@change` | value 值变化时触发，仅在输入框 change 事件触发或点击加减按钮改变 value 时触发 | `value: number` | `<Spinner @change="handleChange" />` |
 
-### 事件处理函数示例
-**change**:
+### 事件参数说明
+**change**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `number` | 是 | - | 当前的数值 |
+
+事件处理示例:
 ```typescript
 const handleChange = (value: number) => {
   console.log('当前值:', value);
@@ -43,18 +49,22 @@ const handleChange = (value: number) => {
 ```
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### precision 设置为负数
 > **错误用法**: `<Spinner :precision="-1" />`
 > **正确写法**: `<Spinner :precision="2" />`
 > **说明**: precision 必须为正整数或 0，负数无效
 
+### 使用不存在的 size 值 (Spinner)
 > **错误用法**: `<Spinner size="large" />`
 > **正确写法**: `<Spinner size="default" />`
 > **说明**: Spinner 的 size 只支持 default, small, mini。Spinner 组件目前不支持 large 尺寸。
 
+### 使用 formatter 但未提供 parser
 > **错误用法**: `<Spinner :formatter="(val) => `${val}%`" />`
 > **正确写法**: `<Spinner :formatter="(val) => `${val}%`" :parser="(val) => parseFloat(val)" />`
 > **说明**: 使用 formatter 格式化显示时，必须同时提供 parser 来解析用户输入
 
+### min 大于 max
 > **错误用法**: `<Spinner :min="100" :max="0" />`
 > **正确写法**: `<Spinner :min="0" :max="100" />`
 > **说明**: min 值必须小于或等于 max 值

package/docs_for_llm/split.doc.md

@@ -0,0 +1,157 @@
+# 分栏拖拽 (Split)
+
+可拖拽调整尺寸的分栏布局组件。支持横向和纵向两种模式，通过 `first`、`last` 命名插槽定义两侧内容。
+
+**关键词**: split, 分栏, 拖拽布局, 左右布局, 上下布局, resize
+
+**使用场景**: 侧边栏加主内容区、编辑器与预览区、日志面板、控制台双栏布局
+
+## 导入语句
+```typescript
+import { Split } from '@king-design/vue';
+```
+
+## 属性 (Props)
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| mode | `"horizontal" | "vertical"` | `"horizontal"` | 否 | 分栏方向。 | - | `<Split mode="vertical">` |
+| firstSize | `string` | `"auto"` | 否 | 第一个面板尺寸，支持具体尺寸值或 auto。 | - | `<Split firstSize="240px">` |
+| lastSize | `string` | `"auto"` | 否 | 第二个面板尺寸，支持具体尺寸值或 auto。 | - | `<Split lastSize="320px">` |
+| min | `number | string` | `0` | 否 | 拖拽时允许的最小尺寸。 | - | `<Split firstSize="240px" :min="120" />` |
+| max | `number | string` | `"100%-6"` | 否 | 拖拽时允许的最大尺寸。 | - | `<Split firstSize="240px" max="60%" />` |
+
+## 事件 (Events)
+| 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
+| --- | --- | --- | --- | --- |
+| moveStart | `@moveStart` | 开始拖拽时触发。 | `e: MouseEvent` | `<Split @moveStart="handleMoveStart">` |
+| moving | `@moving` | 拖拽过程中持续触发。 | `e: MouseEvent` | `<Split @moving="handleMoving">` |
+| moveEnd | `@moveEnd` | 拖拽结束时触发。 | `e: MouseEvent | undefined` | `<Split @moveEnd="handleMoveEnd">` |
+
+### 事件参数说明
+**moveStart**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| e | `MouseEvent` | 是 | - | 原生鼠标事件 |
+
+事件处理示例:
+```typescript
+const handleMoveStart = (e: MouseEvent) => {
+  console.log('开始拖拽');
+};
+```
+
+**moving**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| e | `MouseEvent` | 是 | - | 原生鼠标事件 |
+
+事件处理示例:
+```typescript
+const handleMoving = (e: MouseEvent) => {
+  console.log('拖拽中');
+};
+```
+
+**moveEnd**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| e | `MouseEvent | undefined` | 是 | - | 原生鼠标事件 |
+
+事件处理示例:
+```typescript
+const handleMoveEnd = (e?: MouseEvent) => {
+  console.log('拖拽结束');
+};
+```
+
+## 插槽 (Slots)
+| 插槽名 | 说明 | 模板写法 | 示例 |
+| --- | --- | --- | --- |
+| first | 第一个面板内容。 | `<template #first>...</template>` | `<Split><template #first>左侧内容</template><template #last>右侧内容</template></Split>` |
+| last | 第二个面板内容。 | `<template #last>...</template>` | `<Split><template #first>左侧内容</template><template #last>右侧内容</template></Split>` |
+| drag | 自定义拖拽分割条内容。 | `<template #drag>...</template>` | `<Split><template #drag><div class="custom-handle" /></template></Split>` |
+
+## 常见错误与正确用法 (Anti-Hallucination)
+### 未使用 first 和 last 命名插槽
+> **错误用法**: `<Split>
+  <div>左侧</div>
+  <div>右侧</div>
+</Split>`
+> **正确写法**: `<Split>
+  <template #first><div>左侧</div></template>
+  <template #last><div>右侧</div></template>
+</Split>`
+> **说明**: Split 使用命名插槽组织两个面板，直接写默认子节点不会正确分配到两侧区域。
+
+### 同时固定 firstSize 和 lastSize，导致拖拽空间不足
+> **错误用法**: `<Split firstSize="300px" lastSize="500px">...</Split>`
+> **正确写法**: `<Split firstSize="300px" lastSize="auto">...</Split>`
+> **说明**: 实际使用中通常固定一侧，另一侧使用 auto，让拖拽有可调整空间。
+
+## 使用示例
+### 左右分栏
+**场景**: 后台页面侧边栏和主内容区
+
+基础的横向可拖拽布局。
+
+**使用的 API**: 属性: firstSize | 插槽: first, last
+
+```vue
+<template>
+  <Split firstSize="240px" style="height: 320px; border: 1px solid #eee;">
+    <template #first>
+      <div style="padding: 16px;">左侧目录</div>
+    </template>
+    <template #last>
+      <div style="padding: 16px;">右侧内容</div>
+    </template>
+  </Split>
+</template>
+```
+
+### 上下分栏
+**场景**: 上下布局的编辑器和预览区
+
+适合日志面板或上下编辑区。
+
+**使用的 API**: 属性: mode, firstSize | 插槽: first, last
+
+```vue
+<template>
+  <Split mode="vertical" firstSize="120px" style="height: 360px; border: 1px solid #eee;">
+    <template #first>
+      <div style="padding: 16px;">上方面板</div>
+    </template>
+    <template #last>
+      <div style="padding: 16px;">下方面板</div>
+    </template>
+  </Split>
+</template>
+```
+
+### 拖拽范围限制
+**场景**: 限制侧栏宽度的后台布局
+
+限制面板最小和最大尺寸。
+
+**使用的 API**: 属性: firstSize, min, max | 插槽: first, last
+
+```vue
+<template>
+  <Split firstSize="240px" :min="120" :max="480" style="height: 320px; border: 1px solid #eee;">
+    <template #first>
+      <div style="padding: 16px;">可拖拽但不小于 120px</div>
+    </template>
+    <template #last>
+      <div style="padding: 16px;">主面板</div>
+    </template>
+  </Split>
+</template>
+```
+
+## 相关组件
+Layout, Grid, Card
+

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