king-design-analyzer 2.1.7 → 2.2.0

package/docs_for_llm/actions.doc.md

@@ -0,0 +1,77 @@
+# 操作按钮集 (Actions)
+
+用于组织主操作和次操作的按钮集合组件，常放在表格操作列、详情页头部和工具栏右侧，避免页面出现过多平铺按钮。
+
+**关键词**: actions, action buttons, 操作按钮集, 更多操作, 主次操作, 操作列按钮
+
+**使用场景**: 表格操作列、页面头部操作区、主次操作分层展示
+
+## 导入语句
+```typescript
+import { Actions } from '@ksyun-internal/versatile';
+```
+
+## 属性 (Props)
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| primaries | `ActionConfig[]` | `[]` | 否 | 一级操作按钮列表 | - | - |
+| secondaries | `ActionConfig[]` | `[]` | 否 | 二级操作按钮列表，通常展示在“更多”菜单中 | - | - |
+
+## 插槽 (Slots)
+| 插槽名 | 说明 | 模板写法 | 示例 |
+| --- | --- | --- | --- |
+| btnText | 自定义按钮文案渲染 | `<template #btnText="{ action }">...</template>` | - |
+
+## 使用示例
+### 表格操作列中的主次操作
+**场景**: 在列表行内同时承载高频与低频操作，减少操作列拥挤。
+
+将高频操作直接展示，低频操作折叠到更多菜单中。
+
+**使用的 API**: 属性: primaries, secondaries
+
+```vue
+<script setup lang="ts">
+import { Actions } from '@ksyun-internal/versatile';
+
+const primaries = [
+  { text: '重启', type: 'primary', onClick: () => console.log('restart') },
+];
+const secondaries = [
+  { text: '续费', onClick: () => console.log('renew') },
+  { text: '释放', danger: true, onClick: () => console.log('delete') },
+];
+</script>
+
+<template>
+  <Actions :primaries="primaries" :secondaries="secondaries" />
+</template>
+```
+
+### 自定义操作按钮文案
+**场景**: 在操作区给危险动作补充更明确的文案提示。
+
+使用 btnText 插槽为危险操作补充风险提示。
+
+**使用的 API**: 属性: primaries, secondaries
+
+```vue
+<script setup lang="ts">
+import { Actions } from '@ksyun-internal/versatile';
+
+const primaries = [{ text: '启动', onClick: () => console.log('start') }];
+const secondaries = [{ text: '释放', danger: true, onClick: () => console.log('release') }];
+</script>
+
+<template>
+  <Actions :primaries="primaries" :secondaries="secondaries">
+    <template #btnText="{ action }">
+      {{ action.danger ? action.text + '（高风险）' : action.text }}
+    </template>
+  </Actions>
+</template>
+```
+
+## 相关组件
+ButtonLink, IconTooltip
+

package/docs_for_llm/advancedset.doc.md

@@ -0,0 +1,89 @@
+# 高级设置开关 (AdvancedSet)
+
+用于折叠和展开高级配置区域的业务组件，适合购买页、创建页中把非高频参数收进“高级设置”。
+
+**关键词**: advanced set, advanced options, 高级设置, 折叠配置区, 高级参数
+
+**使用场景**: 高级参数开关、可折叠配置区、编辑页默认展开高级设置
+
+## 导入语句
+```typescript
+import { AdvancedSet } from '@ksyun-internal/versatile';
+```
+
+## 属性 (Props)
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| modelValue | `boolean` | `undefined` | 否 | 是否展开高级设置 | - | - |
+| label | `string` | `undefined` | 否 | 标题文案 | - | - |
+| appendTip | `string` | `undefined` | 否 | 追加提示文案 | - | - |
+
+## 事件 (Events)
+| 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
+| --- | --- | --- | --- | --- |
+| update:modelValue | `@update:modelValue` | 用户展开或收起高级设置区域时触发，可用于同步表单状态或埋点。 | `value?: boolean` | - |
+
+### 事件参数说明
+**update:modelValue**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `boolean` | 否 | - | 当前高级设置区域的展开状态。 |
+
+## 插槽 (Slots)
+| 插槽名 | 说明 | 模板写法 | 示例 |
+| --- | --- | --- | --- |
+| default | 高级设置内容区域 | `<AdvancedSet>...</AdvancedSet>` | - |
+
+## 使用示例
+### 购买页中的高级设置折叠区
+**场景**: 创建实例时把网络、命名等低频参数收纳到高级设置区。
+
+默认收起高级参数，只在用户主动展开后展示额外配置。
+
+**使用的 API**: 属性: modelValue, label, appendTip | 事件: update:modelValue
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { AdvancedSet, FormItemInput, FormItemSpinner } from '@ksyun-internal/versatile';
+
+const advanced = ref(false);
+const hostname = ref('web-01');
+const bandwidth = ref(20);
+</script>
+
+<template>
+  <AdvancedSet v-model="advanced" label="高级设置" append-tip="修改后将影响实例网络配置">
+    <FormItemInput v-model="hostname" label="主机名" />
+    <FormItemSpinner v-model="bandwidth" label="带宽峰值" unit="Mbps" />
+  </AdvancedSet>
+</template>
+```
+
+### 默认展开高级设置
+**场景**: 在编辑页面中默认展开高级参数，方便用户快速核对设置。
+
+在编辑已有配置时直接展开高级区域，减少额外点击。
+
+**使用的 API**: 属性: modelValue, label, appendTip | 事件: update:modelValue
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { AdvancedSet, FormItemSwitch } from '@ksyun-internal/versatile';
+
+const advanced = ref(true);
+const enableMonitor = ref(false);
+</script>
+
+<template>
+  <AdvancedSet v-model="advanced" label="高级设置" append-tip="修改后即时生效">
+    <FormItemSwitch v-model="enableMonitor" label="开启监控增强" />
+  </AdvancedSet>
+</template>
+```
+
+## 相关组件
+FormItemInput, FormItemSpinner
+

package/docs_for_llm/affix.doc.md

@@ -12,25 +12,33 @@ import { Affix } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| top | `number` | `undefined` | 否 | 距离窗口顶部的偏移量，设置为 undefined 则不生效 | `<Affix :top="100"></Affix>` |
-| bottom | `number` | `undefined` | 否 | 距离窗口底部的偏移量，设置为 undefined 则不生效 | `<Affix :bottom="50"></Affix>` |
-| shouldFix | `Function` | `undefined` | 否 | 自定义是否需要固定的函数，返回 boolean | `<Affix :shouldFix="checkFix"></Affix>` |
-| exclude | `Function` | `undefined` | 否 | 自定义排除固定的函数，返回 boolean 表示不固定 | `<Affix :exclude="checkExclude"></Affix>` |
-| disabled | `boolean` | `false` | 否 | 是否禁用固定功能 | `<Affix disabled></Affix>` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| top | `number` | `undefined` | 否 | 距离窗口顶部的偏移量，设置为 undefined 则不生效 | - | `<Affix :top="100"></Affix>` |
+| bottom | `number` | `undefined` | 否 | 距离窗口底部的偏移量，设置为 undefined 则不生效 | - | `<Affix :bottom="50"></Affix>` |
+| shouldFix | `Function` | `undefined` | 否 | 自定义是否需要固定的函数，返回 boolean | - | `<Affix :shouldFix="checkFix"></Affix>` |
+| exclude | `Function` | `undefined` | 否 | 自定义排除固定的函数，返回 boolean 表示不固定 | - | `<Affix :exclude="checkExclude"></Affix>` |
+| disabled | `boolean` | `false` | 否 | 是否禁用固定功能 | - | `<Affix disabled></Affix>` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
 | change | `@change` | 固定状态改变时触发 | `isFixed: boolean` | `<Affix @change="handleChange"></Affix>` |
 
+### 事件参数说明
+**change**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| isFixed | `boolean` | 是 | - | 当前是否处于固定状态 |
+
 ## 插槽 (Slots)
 | 插槽名 | 说明 | 模板写法 | 示例 |
 | --- | --- | --- | --- |
 | default | 需要被固定的元素 | `#default` | `<Affix><Button>Fixed Button</Button></Affix>` |
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 父容器滚动问题
 > **错误用法**: `<div style="overflow: auto; height: 200px;">
   <Affix :top="10">...</Affix>
 </div>`

package/docs_for_llm/aksk.doc.md

@@ -0,0 +1,111 @@
+# AK/SK 配置 (AKSK)
+
+用于录入 AccessKey / SecretKey 并控制是否沿用原始凭证的业务表单组件，常见于任务同步、数据接入和跨账号授权场景。
+
+**关键词**: aksk, access key, secret key, 凭证配置, ak sk, 云服务凭证
+
+**使用场景**: 云服务凭证录入、数据集或任务凭证配置、切换原始凭证或自定义凭证
+
+## 导入语句
+```typescript
+import { AKSK } from '@ksyun-internal/versatile';
+```
+
+## 属性 (Props)
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| ak | `string | null` | `undefined` | 否 | 当前 AccessKey | - | - |
+| sk | `string | null` | `undefined` | 否 | 当前 SecretKey | - | - |
+| isUseOriginal | `boolean | null` | `false` | 否 | 是否使用原始 AK/SK | - | - |
+| isShowUseOriginal | `boolean | null` | `false` | 否 | 是否展示“使用原始凭证”选项 | - | - |
+| inDataSet | `boolean | null` | `undefined` | 否 | 是否处于数据集场景 | - | - |
+
+## 事件 (Events)
+| 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
+| --- | --- | --- | --- | --- |
+| update:ak | `@update:ak` | AccessKey 变更时触发，便于和父级表单状态保持同步。 | `value?: string | null` | - |
+| update:sk | `@update:sk` | SecretKey 变更时触发，通常用于同步加密存储前的表单值。 | `value?: string | null` | - |
+| update:isUseOriginal | `@update:isUseOriginal` | “使用原始凭证”开关变化时触发，可据此切换输入项显隐。 | `value?: boolean | null` | - |
+
+### 事件参数说明
+**update:ak**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `string | null` | 否 | - | 当前输入的 AccessKey 值。 |
+
+**update:sk**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `string | null` | 否 | - | 当前输入的 SecretKey 值。 |
+
+**update:isUseOriginal**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `boolean | null` | 否 | - | 当前是否使用原始凭证。 |
+
+## 使用示例
+### 任务配置中的 AK/SK 凭证录入
+**场景**: 录入任务访问外部对象存储或服务所需的访问凭证。
+
+通过多个 v-model 同步 AccessKey、SecretKey 和原始凭证开关。
+
+**使用的 API**: 属性: ak, sk, isUseOriginal, isShowUseOriginal | 事件: update:ak, update:sk, update:isUseOriginal
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { AKSK } from '@ksyun-internal/versatile';
+
+const ak = ref('AKLTxxxxxxxx');
+const sk = ref('********');
+const isUseOriginal = ref(false);
+</script>
+
+<template>
+  <AKSK
+    v-model:ak="ak"
+    v-model:sk="sk"
+    v-model:isUseOriginal="isUseOriginal"
+    :is-show-use-original="true"
+  />
+</template>
+```
+
+### 切换是否沿用原始凭证
+**场景**: 在数据同步任务中切换使用系统默认凭证或自定义凭证。
+
+结合 update:isUseOriginal 在不同凭证来源之间切换。
+
+**使用的 API**: 属性: ak, sk, isUseOriginal, isShowUseOriginal, inDataSet | 事件: update:isUseOriginal
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { AKSK } from '@ksyun-internal/versatile';
+
+const ak = ref('AKLTxxxx');
+const sk = ref('******');
+const isUseOriginal = ref(true);
+const handleToggle = (value: boolean) => {
+  console.log('use original credentials:', value);
+};
+</script>
+
+<template>
+  <AKSK
+    v-model:ak="ak"
+    v-model:sk="sk"
+    v-model:isUseOriginal="isUseOriginal"
+    :is-show-use-original="true"
+    :in-data-set="true"
+    @update:isUseOriginal="handleToggle"
+  />
+</template>
+```
+
+## 相关组件
+FormItemInput
+

package/docs_for_llm/az.doc.md

@@ -2,9 +2,9 @@
 
 可用区（Availability Zone）选择组件。
 
-**关键词**: az, zone, 可用区, 机房
+**关键词**: az, zone, 可用区, 机房, availability zone, az select, 可用区选择
 
-**使用场景**: 购买页选择可用区
+**使用场景**: 购买页选择可用区、与地域联动切换机房、资源部署位置选择、高可用架构中选择目标可用区
 
 ## 导入语句
 ```typescript
@@ -12,21 +12,27 @@ import { AZ } from '@ksyun-internal/versatile';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| modelValue | `string` | `undefined` | 否 | 选中的可用区编码 | `<AZ v-model="azCode" />` |
-| regionCode | `string` | `undefined` | 否 | 所属地域编码 | `<AZ regionCode="cn-beijing-6" />` |
-| packages | `AZ[]` | `undefined` | 否 | 可用区配置列表（通常从Region组件联动获取，或通过API获取） | `<AZ :packages="packages" />` |
-| showLearnMore | `boolean` | `true` | 否 | 是否显示了解更多 | - |
-| learnMoreUrl | `number` | `undefined` | 否 | 了解更多链接ID | - |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| modelValue | `string` | `undefined` | 否 | 选中的可用区编码 | - | `<AZ v-model="azCode" />` |
+| regionCode | `string` | `undefined` | 否 | 所属地域编码 | - | `<AZ regionCode="cn-beijing-6" />` |
+| packages | `AZ[]` | `undefined` | 否 | 可用区配置列表（通常从Region组件联动获取，或通过API获取） | - | `<AZ :packages="packages" />` |
+| showLearnMore | `boolean` | `true` | 否 | 是否显示了解更多 | - | - |
+| learnMoreUrl | `number` | `undefined` | 否 | 了解更多链接ID | - | - |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
 | change | `update:modelValue` | 可用区改变时触发 | `value: string` | `<AZ @update:modelValue="v => console.log(v)" /></AZ>` |
 
-### 事件处理函数示例
-**change**:
+### 事件参数说明
+**change**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `string` | 是 | - | 新的AZCode |
+
+事件处理示例:
 ```typescript
 (val) => { console.log(val); }
 ```

package/docs_for_llm/badge.doc.md

@@ -12,11 +12,11 @@ import { Badge } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| text | `string | number` | `undefined` | 否 | 显示的文本内容或数字。如果不传，则显示为一个小红点。 | `<Badge :text="10"></Badge>` |
-| max | `number` | `undefined` | 否 | 显示的最大数值，超过最大值会显示为 max+。仅在 text 为 numeric 时生效。 | `<Badge :text="100" :max="99"></Badge>` |
-| disabled | `boolean` | `false` | 否 | 是否隐藏徽标 | `<Badge disabled></Badge>` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| text | `string | number` | `undefined` | 否 | 显示的文本内容或数字。如果不传，则显示为一个小红点。 | - | `<Badge :text="10"></Badge>` |
+| max | `number` | `undefined` | 否 | 显示的最大数值，超过最大值会显示为 max+。仅在 text 为 numeric 时生效。 | - | `<Badge :text="100" :max="99"></Badge>` |
+| disabled | `boolean` | `false` | 否 | 是否隐藏徽标 | - | `<Badge disabled></Badge>` |
 
 ## 插槽 (Slots)
 | 插槽名 | 说明 | 模板写法 | 示例 |
@@ -24,6 +24,7 @@ import { Badge } from '@king-design/vue';
 | default | 徽标包裹的元素 | `#default` | `<Badge><Button>Button</Button></Badge>` |
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 数字作为字符串传入
 > **错误用法**: `<Badge text="10" :max="9">`
 > **正确写法**: `<Badge :text="10" :max="9">`
 > **说明**: 如果 text 传入的是字符串 "10"，max 属性可能无法正确比较。建议数字类型使用 v-bind 传入。

package/docs_for_llm/billtypes.doc.md

@@ -2,9 +2,9 @@
 
 计费类型选择组件，支持按量付费、包年包月等多种计费模式展示与选择。
 
-**关键词**: bill, price, charge, 计费, 价格
+**关键词**: bill, price, charge, 计费, 价格, 计费模式, 按量付费, 包年包月
 
-**使用场景**: 购买页选择计费模式
+**使用场景**: 购买页选择计费模式、切换按量和包年包月、试用与正式计费方式选择
 
 ## 导入语句
 ```typescript
@@ -12,21 +12,27 @@ import { BillTypes } from '@ksyun-internal/versatile';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| modelValue | `number` | `undefined` | 否 | 选中的计费类型ID | `<BillTypes v-model="billType" />` |
-| packages | `BillType[]` | `undefined` | 否 | 计费类型配置列表 | `<BillTypes :packages="packages" />` |
-| showTrial | `boolean` | `false` | 否 | 是否显示试用选项 | `<BillTypes showTrial />` |
-| showLearnMore | `boolean` | `true` | 否 | 是否显示了解更多链接 | `<BillTypes showLearnMore />` |
-| learnMoreUrl | `number` | `undefined` | 否 | 了解更多链接的帮助文档ID | `<BillTypes :learnMoreUrl="123" />` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| modelValue | `number` | `undefined` | 否 | 选中的计费类型ID | - | `<BillTypes v-model="billType" />` |
+| packages | `BillType[]` | `undefined` | 否 | 计费类型配置列表 | - | `<BillTypes :packages="packages" />` |
+| showTrial | `boolean` | `false` | 否 | 是否显示试用选项 | - | `<BillTypes showTrial />` |
+| showLearnMore | `boolean` | `true` | 否 | 是否显示了解更多链接 | - | `<BillTypes showLearnMore />` |
+| learnMoreUrl | `number` | `undefined` | 否 | 了解更多链接的帮助文档ID | - | `<BillTypes :learnMoreUrl="123" />` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
 | change | `update:modelValue` | 选中值改变时触发 | `value: number` | `<BillTypes @update:modelValue="v => console.log(v)" /></BillTypes>` |
 
-### 事件处理函数示例
-**change**:
+### 事件参数说明
+**change**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `number` | 是 | - | 新的计费类型ID |
+
+事件处理示例:
 ```typescript
 (val) => { console.log(val); }
 ```

package/docs_for_llm/breadcrumb.doc.md

@@ -12,9 +12,9 @@ import { Breadcrumb, BreadcrumbItem } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| separator | `string` | `undefined` | 否 | 指定分隔符 | `<Breadcrumb separator=">"></Breadcrumb>` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| separator | `string` | `undefined` | 否 | 指定分隔符 | - | `<Breadcrumb separator=">"></Breadcrumb>` |
 
 ## 插槽 (Slots)
 | 插槽名 | 说明 | 模板写法 | 示例 |
@@ -30,6 +30,7 @@ import { Breadcrumb, BreadcrumbItem } from '@king-design/vue';
 | to | `string | object` | 指定超链接地址，支持字符串路径或 Vue Router 路由对象 | `<BreadcrumbItem to="/products">产品中心</BreadcrumbItem>` |
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 最后一项不应该有链接
 > **错误用法**: `<Breadcrumb>
   <BreadcrumbItem to="/">首页</BreadcrumbItem>
   <BreadcrumbItem to="/current">当前页面</BreadcrumbItem>
@@ -40,6 +41,7 @@ import { Breadcrumb, BreadcrumbItem } from '@king-design/vue';
 </Breadcrumb>`
 > **说明**: 面包屑最后一项表示当前页面，不应该设置链接
 
+### 直接使用 Breadcrumb 未包含 BreadcrumbItem
 > **错误用法**: `<Breadcrumb>
   <span>首页</span>
   <span>产品</span>
@@ -50,6 +52,7 @@ import { Breadcrumb, BreadcrumbItem } from '@king-design/vue';
 </Breadcrumb>`
 > **说明**: Breadcrumb 组件必须配合 BreadcrumbItem 子组件使用
 
+### 路由对象未使用绑定语法
 > **错误用法**: `<BreadcrumbItem to="{path: '/home'}">首页</BreadcrumbItem>`
 > **正确写法**: `<BreadcrumbItem :to="{path: '/home'}">首页</BreadcrumbItem>`
 > **说明**: 传入对象类型时需要使用 v-bind (:to) 语法

package/docs_for_llm/button.doc.md

@@ -12,22 +12,35 @@ import { Button, ButtonGroup } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| type | `"default" | "primary" | "warning" | "danger" | "success" | "secondary" | "link" | "flat" | "none"` | `"default"` | 否 | 按钮类型，决定按钮的视觉样式 | `<Button type="primary">主要按钮</Button>` |
-| size | `"default" | "small" | "mini" | "large"` | `"default"` | 否 | 按钮尺寸 | `<Button size="small">小按钮</Button>` |
-| icon | `boolean` | `false` | 否 | 是否为图标按钮（宽高相等） | `<Button icon><Icon class="k-icon-search" /></Button>` |
-| circle | `boolean` | `false` | 否 | 是否为圆角按钮 | `<Button icon circle><Icon class="k-icon-plus" /></Button>` |
-| loading | `boolean` | `false` | 否 | 是否为正在加载中的按钮，加载时按钮会禁用点击 | `<Button type="primary" :loading="isLoading">提交中...</Button>` |
-| disabled | `boolean` | `false` | 否 | 是否禁用状态 | `<Button disabled>禁用按钮</Button>` |
-| fluid | `boolean` | `false` | 否 | 是否宽度100% | `<Button fluid>块级按钮</Button>` |
-| htmlType | `string` | `"button"` | 否 | 按钮<button>元素的type属性 | `<Button htmlType="submit">提交表单</Button>` |
-| tagName | `string` | `"button"` | 否 | 按钮渲染后的实际HTML元素，例如可以传入"a"来渲染成超链接 | `<Button tagName="a" href="https://example.com" target="_blank">链接按钮</Button>` |
-| value | `*` | `undefined` | 否 | 对于radio/checkbox类型的按钮组，给按钮指定选中时的值 | `<Button value="option1">选项1</Button>` |
-| ghost | `boolean` | `false` | 否 | 展示透明背景的按钮，适用于深色背景 | `<div style="background: #001529; padding: 16px;">
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| type | `"default" | "primary" | "warning" | "danger" | "success" | "secondary" | "link" | "flat" | "none"` | `"default"` | 否 | 按钮类型，决定按钮的视觉样式 | - | `<Button type="primary">主要按钮</Button>` |
+| size | `"default" | "small" | "mini" | "large"` | `"default"` | 否 | 按钮尺寸 | - | `<Button size="small">小按钮</Button>` |
+| icon | `boolean` | `false` | 否 | 是否为图标按钮（宽高相等） | - | `<Button icon><Icon class="k-icon-search" /></Button>` |
+| circle | `boolean` | `false` | 否 | 是否为圆角按钮 | - | `<Button icon circle><Icon class="k-icon-plus" /></Button>` |
+| loading | `boolean` | `false` | 否 | 是否为正在加载中的按钮，加载时按钮会禁用点击 | - | `<Button type="primary" :loading="isLoading">提交中...</Button>` |
+| disabled | `boolean` | `false` | 否 | 是否禁用状态 | - | `<Button disabled>禁用按钮</Button>` |
+| fluid | `boolean` | `false` | 否 | 是否宽度100% | - | `<Button fluid>块级按钮</Button>` |
+| htmlType | `string` | `"button"` | 否 | 按钮<button>元素的type属性 | - | `<Button htmlType="submit">提交表单</Button>` |
+| color | `string` | `undefined` | 否 | 自定义按钮颜色，通常用于细粒度的主题色控制 | - | `<Button color="#1677ff">自定义颜色按钮</Button>` |
+| tagName | `string` | `"button"` | 否 | 按钮渲染后的实际HTML元素，例如可以传入"a"来渲染成超链接 | - | `<Button tagName="a" href="https://example.com" target="_blank">链接按钮</Button>` |
+| autofocus | `boolean` | `undefined` | 否 | 原生 autofocus 属性，页面加载后自动聚焦按钮 | `native` | `<Button autofocus>自动聚焦</Button>` |
+| form | `string` | `undefined` | 否 | 原生 form 属性，指定按钮关联的表单 id | `native` | `<Button form="loginForm" htmlType="submit">提交</Button>` |
+| formaction | `string` | `undefined` | 否 | 原生 formaction 属性，覆盖表单提交地址 | `native` | `<Button formaction="/api/submit" htmlType="submit">提交</Button>` |
+| formenctype | `string` | `undefined` | 否 | 原生 formenctype 属性，指定表单提交编码类型 | `native` | `<Button formenctype="multipart/form-data" htmlType="submit">上传</Button>` |
+| formmethod | `"post" | "get" | "dialog" | string` | `undefined` | 否 | 原生 formmethod 属性，指定表单提交方法 | `native` | `<Button formmethod="post" htmlType="submit">提交</Button>` |
+| formnovalidate | `boolean` | `undefined` | 否 | 原生 formnovalidate 属性，提交时跳过原生表单校验 | `native` | `<Button formnovalidate htmlType="submit">跳过校验</Button>` |
+| formtarget | `string` | `undefined` | 否 | 原生 formtarget 属性，指定表单响应的打开位置 | `native` | `<Button formtarget="_blank" htmlType="submit">新窗口提交</Button>` |
+| href | `string` | `undefined` | 否 | 原生 href 属性，当 tagName="a" 时指定跳转链接 | `native` | `<Button tagName="a" href="https://example.com">外部链接</Button>` |
+| target | `string` | `undefined` | 否 | 原生 target 属性，当 tagName="a" 时指定打开方式 | `native` | `<Button tagName="a" href="https://example.com" target="_blank">新窗口打开</Button>` |
+| download | `string` | `undefined` | 否 | 原生 download 属性，当 tagName="a" 时提示浏览器下载资源 | `native` | `<Button tagName="a" href="/file.pdf" download="demo.pdf">下载文件</Button>` |
+| value | `*` | `undefined` | 否 | 对于radio/checkbox类型的按钮组，给按钮指定选中时的值 | - | `<Button value="option1">选项1</Button>` |
+| name | `string` | `undefined` | 否 | 原生 name 属性 | `native` | `<Button name="submitBtn">提交</Button>` |
+| tabindex | `string | number` | `undefined` | 否 | 原生 tabindex 属性，控制键盘 Tab 导航顺序 | `native` | `<Button :tabindex="-1">跳过焦点</Button>` |
+| ghost | `boolean` | `false` | 否 | 展示透明背景的按钮，适用于深色背景 | - | `<div style="background: #001529; padding: 16px;">
   <Button ghost>幽灵按钮</Button>
 </div>` |
-| class | `string | Record<string, boolean>` | `undefined` | 否 | 给按钮添加自定义类名，通常用于通过 CSS 类名来定义按钮的具体视觉样式 | `<Button class="my-custom-btn">自定义类名按钮</Button>` |
+| class | `string | Record<string, boolean>` | `undefined` | 否 | 给按钮添加自定义类名，通常用于通过 CSS 类名来定义按钮的具体视觉样式 | - | `<Button class="my-custom-btn">自定义类名按钮</Button>` |
 
 ## 插槽 (Slots)
 | 插槽名 | 说明 | 模板写法 | 示例 |
@@ -37,10 +50,10 @@ import { Button, ButtonGroup } from '@king-design/vue';
 ## 方法 (Methods)
 | 方法名 | 说明 | 参数 | 返回值 |
 | --- | --- | --- | --- |
-| showLoading | 展示 loading 状态 | `` | `void` |
-| hideLoading | 取消 loading 状态 | `` | `void` |
-| disable | 禁用按钮 | `` | `void` |
-| enable | 启用按钮 | `` | `void` |
+| showLoading | 展示 loading 状态 | `-` | `void` |
+| hideLoading | 取消 loading 状态 | `-` | `void` |
+| disable | 禁用按钮 | `-` | `void` |
+| enable | 启用按钮 | `-` | `void` |
 
 ## 子组件 (Sub-Components)
 ### ButtonGroup
@@ -66,14 +79,17 @@ import { Button, ButtonGroup } from '@king-design/vue';
 | btnWidth | `number | string` | 指定按钮组每个按钮的固定宽度 | `<ButtonGroup btnWidth="100px"></ButtonGroup>` |
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### type 属性值拼写错误
 > **错误用法**: `<Button type="primay">`
 > **正确写法**: `<Button type="primary">`
 > **说明**: type 必须使用预定义的值：default, primary, warning, danger, success, secondary, link, flat, none。常见错误是 primary 拼写为 primay
 
+### 使用不存在的 size 值 (Button)
 > **错误用法**: `<Button size="medium">`
 > **正确写法**: `<Button size="default">`
 > **说明**: Button 的 size 只支持 large, default, small, mini。常见错误是使用 medium 值。
 
+### 单选/复选按钮组未给 Button 设置 value
 > **错误用法**: `<ButtonGroup checkType="radio" v-model="selected">
   <Button>选项A</Button>
   <Button>选项B</Button>

package/docs_for_llm/buttonlink.doc.md

@@ -0,0 +1,55 @@
+# 链接按钮 (ButtonLink)
+
+外观接近按钮但语义偏链接的操作组件，适合放在详情页头部、说明区或空状态中承载跳转型动作。
+
+**关键词**: button link, link button, 链接按钮, 跳转按钮, 文档入口
+
+**使用场景**: 操作区链接按钮、详情页跳转入口、空状态引导操作
+
+## 导入语句
+```typescript
+import { ButtonLink } from '@ksyun-internal/versatile';
+```
+
+## 插槽 (Slots)
+| 插槽名 | 说明 | 模板写法 | 示例 |
+| --- | --- | --- | --- |
+| default | 按钮内容 | `<ButtonLink>...</ButtonLink>` | - |
+
+## 使用示例
+### 详情页中的文档跳转入口
+**场景**: 在操作区提供“查看文档”“前往控制台”等跳转动作。
+
+用按钮样式突出跳转动作，同时保持链接语义。
+
+```vue
+<script setup lang="ts">
+import { ButtonLink } from '@ksyun-internal/versatile';
+</script>
+
+<template>
+  <ButtonLink>查看 API 文档</ButtonLink>
+</template>
+```
+
+### 空状态跳转入口
+**场景**: 在空状态或帮助提示区提供跳转型操作。
+
+在空状态说明区域中用链接按钮承载引导操作。
+
+```vue
+<script setup lang="ts">
+import { ButtonLink } from '@ksyun-internal/versatile';
+</script>
+
+<template>
+  <div>
+    <p>当前没有可用项目。</p>
+    <ButtonLink>前往创建项目</ButtonLink>
+  </div>
+</template>
+```
+
+## 相关组件
+IconTooltip, Actions
+