king-design-analyzer 2.1.9 → 2.2.0

package/docs_for_llm/copy.doc.md

@@ -12,10 +12,10 @@ import { Copy } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| text | `string` | `undefined` | 否 | 复制文案值，要复制到剪贴板的内容 | `<Copy text="要复制的内容"><Button>复制</Button></Copy>` |
-| showMessage | `boolean` | `true` | 否 | 复制成功/失败时，是否展示 Message 提示 | `<Copy text="内容" :showMessage="false"><Button>静默复制</Button></Copy>` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| text | `string` | `undefined` | 否 | 复制文案值，要复制到剪贴板的内容 | - | `<Copy text="要复制的内容"><Button>复制</Button></Copy>` |
+| showMessage | `boolean` | `true` | 否 | 复制成功/失败时，是否展示 Message 提示 | - | `<Copy text="内容" :showMessage="false"><Button>静默复制</Button></Copy>` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
@@ -23,30 +23,32 @@ import { Copy } from '@king-design/vue';
 | success | `@success` | 复制成功时触发 | `value: string` | `<Copy text="内容" @success="handleSuccess"></Copy>` |
 | error | `@error` | 复制失败时触发 | `-` | `<Copy text="内容" @error="handleError"></Copy>` |
 
-### 事件处理函数示例
-**success**:
+### 事件参数说明
+**success**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `string` | 是 | - | 复制的内容 |
+
+事件处理示例:
 ```typescript
 const handleSuccess = (value: string) => {
   console.log('复制成功:', value);
 };
 ```
 
-**error**:
-```typescript
-const handleError = () => {
-  console.log('复制失败');
-};
-```
-
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 未设置 text 属性
 > **错误用法**: `<Copy><Button>复制</Button></Copy>`
 > **正确写法**: `<Copy text="要复制的内容"><Button>复制</Button></Copy>`
 > **说明**: 必须通过 text 属性指定要复制的内容
 
+### 未提供触发元素
 > **错误用法**: `<Copy text="内容" />`
 > **正确写法**: `<Copy text="内容"><Button>复制</Button></Copy>`
 > **说明**: Copy 组件需要包裹一个子元素作为触发器
 
+### success 事件处理函数参数错误
 > **错误用法**: `const handleSuccess = () => {
   console.log('复制成功');
 }`

package/docs_for_llm/copyhover.doc.md

@@ -0,0 +1,59 @@
+# 悬浮复制 (CopyHover)
+
+在文本悬停时才露出复制图标的轻量组件，适合详情字段、表格单元格等需要降低视觉噪音的复制场景。
+
+**关键词**: copy hover, hover copy, 复制悬浮, 悬停复制, 轻量复制按钮
+
+**使用场景**: 详情字段快速复制、列表项悬浮复制、敏感信息禁用复制
+
+## 导入语句
+```typescript
+import { CopyHover } from '@ksyun-internal/versatile';
+```
+
+## 属性 (Props)
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| text | `string` | `""` | 否 | 待复制文本 | - | - |
+| showMessage | `boolean` | `true` | 否 | 复制成功/失败时，是否展示 Message 提示 | `inherited:Copy` | `<Copy text="内容" :showMessage="false"><Button>静默复制</Button></Copy>` |
+| tooltipText | `string` | `undefined` | 否 | 复制按钮提示文案 | - | - |
+| disabled | `boolean` | `undefined` | 否 | 是否禁用复制 | - | - |
+
+## 使用示例
+### 详情字段悬浮复制
+**场景**: 在详情页展示实例 ID，同时保持界面简洁。
+
+只在悬停时显示复制图标，适合长 ID、Token 等字段。
+
+**使用的 API**: 属性: text, tooltipText
+
+```vue
+<script setup lang="ts">
+import { CopyHover } from '@ksyun-internal/versatile';
+</script>
+
+<template>
+  <CopyHover text="i-2ze7x5a4a92b" tooltip-text="复制实例 ID" />
+</template>
+```
+
+### 敏感字段禁止复制
+**场景**: 在脱敏展示 SecretKey 等敏感内容时显式禁用复制。
+
+对脱敏后的内容保留展示但关闭复制。
+
+**使用的 API**: 属性: text, tooltipText, disabled
+
+```vue
+<script setup lang="ts">
+import { CopyHover } from '@ksyun-internal/versatile';
+</script>
+
+<template>
+  <CopyHover text="sk-******" tooltip-text="敏感信息不可复制" :disabled="true" />
+</template>
+```
+
+## 相关组件
+Copy, CopyRow
+

package/docs_for_llm/copyrow.doc.md

@@ -0,0 +1,71 @@
+# 复制行 (CopyRow)
+
+用于展示并复制一整行文本的业务组件，适合实例 ID、API 地址、回源域名等长文本信息。
+
+**关键词**: copy row, copy text row, 复制行, 文本复制, 长文本复制
+
+**使用场景**: 详情页字段复制、表格文本复制、自定义内容的复制展示行
+
+## 导入语句
+```typescript
+import { CopyRow } from '@ksyun-internal/versatile';
+```
+
+## 属性 (Props)
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| text | `string` | `undefined` | 否 | 待展示和复制的文本内容 | - | - |
+| maxLines | `number` | `undefined` | 否 | 最大展示行数 | - | - |
+| position | `any` | `undefined` | 否 | 复制提示弹出位置 | - | - |
+| disabled | `boolean` | `undefined` | 否 | 是否禁用复制 | - | - |
+| disabledTooltip | `boolean` | `undefined` | 否 | 禁用时是否显示 tooltip | - | - |
+
+## 插槽 (Slots)
+| 插槽名 | 说明 | 模板写法 | 示例 |
+| --- | --- | --- | --- |
+| default | 自定义行内容 | `<CopyRow>...</CopyRow>` | - |
+
+## 使用示例
+### 接口地址一键复制
+**场景**: 在详情页展示并复制较长的接口地址或资源标识。
+
+在单行文本中集成复制能力和超长内容省略。
+
+**使用的 API**: 属性: text, maxLines
+
+```vue
+<script setup lang="ts">
+import { CopyRow } from '@ksyun-internal/versatile';
+</script>
+
+<template>
+  <CopyRow
+    text="https://api.ksyun.com/v1/instance/describe"
+    :max-lines="1"
+  />
+</template>
+```
+
+### 自定义复制行内容
+**场景**: 在详情页用自定义文案组合显示可复制字段。
+
+通过默认插槽自定义展示样式，同时保留复制能力。
+
+**使用的 API**: 属性: text
+
+```vue
+<script setup lang="ts">
+import { CopyRow } from '@ksyun-internal/versatile';
+</script>
+
+<template>
+  <CopyRow text="bucket-logs-001">
+    <strong>日志桶：</strong>
+    <span>bucket-logs-001</span>
+  </CopyRow>
+</template>
+```
+
+## 相关组件
+CopyHover, TableColumnId
+

package/docs_for_llm/datepicker.doc.md

@@ -12,69 +12,81 @@ import { Datepicker } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| value | `Value | Value[] | [Value, Value] | [Value, Value][]` | `""` | 否 | 当前选择的值，可用 v-model 双向绑定。范围选择时为 [Value, Value] | `<Datepicker v-model="date" />` |
-| type | `"date" | "datetime" | "year" | "month"` | `"date"` | 否 | 组件类型 | `<Datepicker type="datetime" />` |
-| range | `boolean` | `false` | 否 | 是否选择日期范围 | `<Datepicker range />` |
-| multiple | `boolean` | `false` | 否 | 是否支持多选 | `<Datepicker multiple />` |
-| disabled | `boolean` | `false` | 否 | 是否禁用 | `<Datepicker disabled />` |
-| clearable | `boolean` | `false` | 否 | 是否可清空 | `<Datepicker clearable />` |
-| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 尺寸 | `<Datepicker size="small" />` |
-| placeholder | `string` | `"请选择日期"` | 否 | 占位文案 | `<Datepicker placeholder="选择开始日期" />` |
-| format | `string` | `"YYYY-MM-DD HH:mm:ss"` | 否 | 日期格式化字符串 | `<Datepicker format="YYYY-MM-DD" />` |
-| valueFormat | `string` | `undefined` | 否 | value 值的日期格式化字符串 | `<Datepicker valueFormat="YYYY-MM-DD" />` |
-| showFormat | `string` | `undefined` | 否 | 展示的日期格式化字符串 | `<Datepicker showFormat="YYYY年MM月DD日" />` |
-| min | `Value` | `undefined` | 否 | 最小可选日期 | `<Datepicker min="2024-01-01" />` |
-| max | `Value` | `undefined` | 否 | 最大可选日期 | `<Datepicker max="2024-12-31" />` |
-| disabledDate | `(v: Dayjs) => boolean` | `undefined` | 否 | 禁用日期的函数，返回 true 表示禁用该日期 | `<Datepicker :disabledDate="(d) => d.day() === 0" /></Datepicker>` |
-| shortcuts | `Shortcut[]` | `undefined` | 否 | 快捷方式配置 | `<Datepicker :shortcuts="shortcuts" />` |
-| hideIcon | `boolean` | `false` | 否 | 是否隐藏后面的图标 | `<Datepicker hideIcon />` |
-| fluid | `boolean` | `false` | 否 | 是否宽度 100% | `<Datepicker fluid />` |
-| inline | `boolean` | `false` | 否 | 是否展示内联模式 | `<Datepicker inline />` |
-| flat | `boolean` | `false` | 否 | 是否展示扁平样式 | `<Datepicker flat />` |
-| width | `number | string` | `undefined` | 否 | 指定宽度，自动添加单位 px | `<Datepicker :width="200" />` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| value | `Value | Value[] | [Value, Value] | [Value, Value][]` | `""` | 否 | 当前选择的值，可用 v-model 双向绑定。范围选择时为 [Value, Value] | - | `<Datepicker v-model="date" />` |
+| type | `"date" | "datetime" | "year" | "month"` | `"date"` | 否 | 组件类型 | - | `<Datepicker type="datetime" />` |
+| range | `boolean` | `false` | 否 | 是否选择日期范围 | - | `<Datepicker range />` |
+| multiple | `boolean` | `false` | 否 | 是否支持多选 | - | `<Datepicker multiple />` |
+| filterable | `boolean` | `false` | 否 | 是否支持筛选输入 | - | `<Datepicker filterable />` |
+| loading | `boolean` | `false` | 否 | 数据加载状态 | - | `<Datepicker :loading="loading" />` |
+| disabled | `boolean` | `false` | 否 | 是否禁用 | - | `<Datepicker disabled />` |
+| name | `string` | `undefined` | 否 | 表单元素的 name 属性 | - | `<Datepicker name="startDate" />` |
+| clearable | `boolean` | `false` | 否 | 是否可清空 | - | `<Datepicker clearable />` |
+| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 尺寸 | - | `<Datepicker size="small" />` |
+| placeholder | `string` | `"请选择日期"` | 否 | 占位文案 | - | `<Datepicker placeholder="选择开始日期" />` |
+| format | `string` | `"YYYY-MM-DD HH:mm:ss"` | 否 | 日期格式化字符串 | - | `<Datepicker format="YYYY-MM-DD" />` |
+| valueFormat | `string` | `undefined` | 否 | value 值的日期格式化字符串 | - | `<Datepicker valueFormat="YYYY-MM-DD" />` |
+| showFormat | `string` | `undefined` | 否 | 展示的日期格式化字符串 | - | `<Datepicker showFormat="YYYY年MM月DD日" />` |
+| min | `Value` | `undefined` | 否 | 最小可选日期 | - | `<Datepicker min="2024-01-01" />` |
+| max | `Value` | `undefined` | 否 | 最大可选日期 | - | `<Datepicker max="2024-12-31" />` |
+| disabledDate | `(v: Dayjs) => boolean` | `undefined` | 否 | 禁用日期的函数，返回 true 表示禁用该日期 | - | `<Datepicker :disabledDate="(d) => d.day() === 0" />` |
+| shortcuts | `Shortcut[]` | `undefined` | 否 | 快捷方式配置 | - | `<Datepicker :shortcuts="shortcuts" />` |
+| hideIcon | `boolean` | `false` | 否 | 是否隐藏后面的图标 | - | `<Datepicker hideIcon />` |
+| fluid | `boolean` | `false` | 否 | 是否宽度 100% | - | `<Datepicker fluid />` |
+| inline | `boolean` | `false` | 否 | 是否展示内联模式 | - | `<Datepicker inline />` |
+| flat | `boolean` | `false` | 否 | 是否展示扁平样式 | - | `<Datepicker flat />` |
+| width | `number | string` | `undefined` | 否 | 指定宽度，自动添加单位 px | - | `<Datepicker :width="200" />` |
+| container | `string | ((parentDom: Element, anchor: Node | null) => Element)` | `undefined` | 否 | 指定弹出菜单追加的位置，默认 Dialog 组件会追加到 Dialog 中，其他追加到 body | - | `<Datepicker :container="() => document.body" />` |
+| show | `boolean` | `false` | 否 | 是否展示菜单项（受控模式） | - | `<Datepicker :show="visible" />` |
+| position | `Position | "left" | "bottom" | "right" | "top"` | `{my: 'left top+8', at: 'left bottom'}` | 否 | 菜单弹出的位置 | - | `<Datepicker position="top" />` |
+| nowrap | `boolean` | `false` | 否 | 选中值区域是否不换行展示，适合单行紧凑布局 | - | `<Datepicker nowrap />` |
+| draggable | `boolean` | `false` | 否 | 多选值是否支持拖动排序 | - | `<Datepicker multiple draggable />` |
+| virtual | `boolean` | `false` | 否 | 是否开启虚拟列表，用于大数据量场景 | - | `<Datepicker virtual />` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
 | show | `@show` | 菜单弹出时触发 | `-` | `<Datepicker @show="handleShow" />` |
 | hide | `@hide` | 菜单隐藏时触发 | `-` | `<Datepicker @hide="handleHide" />` |
-| selecting | `@selecting` | 范围选择时，用户正在操作选择时触发 | `value: [Dayjs, Dayjs?]` | `<Datepicker range @selecting="handleSelecting" />` |
+| selecting | `@selecting` | 范围选择时，用户正在操作选择时触发 | `value: [Dayjs, Dayjs?], confirmed: boolean` | `<Datepicker range @selecting="handleSelecting" />` |
 
-### 事件处理函数示例
-**show**:
-```typescript
-const handleShow = () => {
-  console.log('日期选择器已打开');
-};
-```
+### 事件参数说明
+**selecting**
 
-**hide**:
-```typescript
-const handleHide = () => {
-  console.log('日期选择器已关闭');
-};
-```
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `[Dayjs, Dayjs?]` | 是 | - | 当前选择的值 |
+| confirmed | `boolean` | 是 | - | 当前这次 selecting 是否已经进入确认完成态；常见交互过程中通常为 `false`。 |
 
-**selecting**:
+事件处理示例:
 ```typescript
-const handleSelecting = (value) => {
-  console.log('正在选择:', value);
+const handleSelecting = (value, confirmed) => {
+  console.log('正在选择:', value, confirmed);
 };
 ```
 
+## 方法 (Methods)
+| 方法名 | 说明 | 参数 | 返回值 |
+| --- | --- | --- | --- |
+| show | 主动展开日期选择面板。 | `-` | `void` |
+| hide | 主动关闭日期选择面板。 | `-` | `void` |
+| position | 重新计算日期选择面板的位置。 | `-` | `void` |
+
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 范围选择时 value 类型错误
 > **错误用法**: `const date = ref('');
 <Datepicker v-model="date" range />`
 > **正确写法**: `const dateRange = ref<[string, string]>(['', '']);
 <Datepicker v-model="dateRange" range />`
 > **说明**: 当 range 为 true 时，value 必须是 [string, string] 数组
 
+### type 值拼写错误
 > **错误用法**: `<Datepicker type="dateTime" />`
 > **正确写法**: `<Datepicker type="datetime" />`
 > **说明**: type 值为小写 datetime，不是 dateTime
 
+### disabledDate 函数返回值错误
 > **错误用法**: `const disabledDate = (d) => { if (d.day() === 0) return '禁用'; }`
 > **正确写法**: `const disabledDate = (d) => d.day() === 0;`
 > **说明**: disabledDate 必须返回布尔值，true 表示禁用

package/docs_for_llm/description.doc.md

@@ -0,0 +1,75 @@
+# 描述输入 (Description)
+
+面向资源描述、备注和说明信息的简化输入组件，适合需要统一长度和校验规则的描述类字段。
+
+**关键词**: description, remark input, 描述输入, 备注填写, 说明文本
+
+**使用场景**: 资源描述录入、备注信息填写、编辑页备注预览
+
+## 导入语句
+```typescript
+import { Description } from '@ksyun-internal/versatile';
+```
+
+## 属性 (Props)
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| modelValue | `string | null` | `undefined` | 否 | 描述内容 | - | - |
+
+## 事件 (Events)
+| 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
+| --- | --- | --- | --- | --- |
+| update:modelValue | `@update:modelValue` | 描述内容变化时触发，可直接同步备注或说明字段。 | `value?: string | null` | - |
+
+### 事件参数说明
+**update:modelValue**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `string | null` | 否 | - | 当前备注或描述文本。 |
+
+## 使用示例
+### 实例备注录入
+**场景**: 在创建或编辑资源时填写用途说明和备注信息。
+
+使用 Description 统一承载资源备注或用途说明。
+
+**使用的 API**: 属性: modelValue | 事件: update:modelValue
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Description } from '@ksyun-internal/versatile';
+
+const remark = ref('用于支付链路的核心应用实例');
+</script>
+
+<template>
+  <Description v-model="remark" />
+</template>
+```
+
+### 编辑资源备注
+**场景**: 在编辑资源信息时实时预览备注字段内容。
+
+在编辑表单中回填已有备注并持续同步到父级状态。
+
+**使用的 API**: 属性: modelValue | 事件: update:modelValue
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Description } from '@ksyun-internal/versatile';
+
+const remark = ref('部署于金融业务生产环境');
+</script>
+
+<template>
+  <Description v-model="remark" />
+  <div>预览：{{ remark }}</div>
+</template>
+```
+
+## 相关组件
+FormItemInput
+

package/docs_for_llm/descriptions.doc.md

@@ -12,12 +12,12 @@ import { Descriptions, DescriptionItem } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| title | `string | number | VNode` | `undefined` | 否 | 描述列表的标题，显示在最顶部 | `<Descriptions title="用户信息"></Descriptions>` |
-| vertical | `boolean` | `false` | 否 | 是否垂直排列（label 在上，content 在下） | `<Descriptions vertical></Descriptions>` |
-| columns | `number` | `3` | 否 | 一行的 DescriptionItem 数量 | `<Descriptions :columns="2"></Descriptions>` |
-| items | `DescriptionItemProps[]` | `[]` | 否 | 描述列表项内容数组，可替代使用 DescriptionItem 子组件 | `<Descriptions :items="items" />` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| title | `string | number | VNode` | `undefined` | 否 | 描述列表的标题，显示在最顶部 | - | `<Descriptions title="用户信息"></Descriptions>` |
+| vertical | `boolean` | `false` | 否 | 是否垂直排列（label 在上，content 在下） | - | `<Descriptions vertical></Descriptions>` |
+| columns | `number` | `3` | 否 | 一行的 DescriptionItem 数量 | - | `<Descriptions :columns="2"></Descriptions>` |
+| items | `DescriptionItemProps[]` | `[]` | 否 | 描述列表项内容数组，可替代使用 DescriptionItem 子组件 | - | `<Descriptions :items="items" />` |
 
 ## 插槽 (Slots)
 | 插槽名 | 说明 | 模板写法 | 示例 |
@@ -39,6 +39,7 @@ import { Descriptions, DescriptionItem } from '@king-design/vue';
 - `undefined`: 自定义label
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### DescriptionItem 未设置 label
 > **错误用法**: `<Descriptions>
   <DescriptionItem>张三</DescriptionItem>
 </Descriptions>`
@@ -47,6 +48,7 @@ import { Descriptions, DescriptionItem } from '@king-design/vue';
 </Descriptions>`
 > **说明**: DescriptionItem 应该设置 label 属性来标识字段名称
 
+### items 数组结构错误
 > **错误用法**: `const items = ['姓名', '年龄'];`
 > **正确写法**: `const items = [
   { label: '姓名', content: '张三' },
@@ -54,6 +56,7 @@ import { Descriptions, DescriptionItem } from '@king-design/vue';
 ];`
 > **说明**: items 数组中的每个元素必须是包含 label 和 content 的对象
 
+### columns 使用字符串而非数字
 > **错误用法**: `<Descriptions columns="2">`
 > **正确写法**: `<Descriptions :columns="2">`
 > **说明**: columns 是数字类型，需要使用 v-bind (:columns) 语法传入数字

package/docs_for_llm/dialog.doc.md

@@ -12,114 +12,84 @@ import { Dialog, Button } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| value | `boolean` | `false` | 否 | 弹窗是否展示，可用v-model双向绑定 | `<Dialog v-model="visible"></Dialog>` |
-| title | `string` | `"提示"` | 否 | 弹窗标题 | `<Dialog v-model="visible" title="确认操作"></Dialog>` |
-| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 弹窗尺寸 | `<Dialog v-model="visible" size="small"></Dialog>` |
-| width | `number | string` | `undefined` | 否 | 指定弹窗宽度，number类型时单位为px，string类型需要指定单位 | `<Dialog v-model="visible" :width="800"></Dialog>` |
-| loading | `boolean` | `false` | 否 | "确定"按钮是否为加载状态 | `<Dialog v-model="visible" :loading="isSubmitting"></Dialog>` |
-| disabledOk | `boolean` | `false` | 否 | "确定"按钮是否为禁用状态 | `<Dialog v-model="visible" :disabledOk="!isValid"></Dialog>` |
-| okText | `string` | `"确定"` | 否 | "确定"按钮文案 | `<Dialog v-model="visible" okText="保存"></Dialog>` |
-| cancelText | `string` | `"取消"` | 否 | "取消"按钮文案 | `<Dialog v-model="visible" cancelText="放弃"></Dialog>` |
-| overlay | `boolean` | `true` | 否 | 是否展示遮罩层 | `<Dialog v-model="visible" :overlay="false"></Dialog>` |
-| closable | `boolean` | `true` | 否 | 点击遮罩层是否可以关闭弹窗 | `<Dialog v-model="visible" :closable="false"></Dialog>` |
-| escClosable | `boolean` | `true` | 否 | 是否按ESC键关闭弹窗 | `<Dialog v-model="visible" :escClosable="false"></Dialog>` |
-| hideClose | `boolean` | `false` | 否 | 是否隐藏右上角关闭按钮 | `<Dialog v-model="visible" hideClose></Dialog>` |
-| draggable | `boolean` | `true` | 否 | 弹窗是否可拖拽 | `<Dialog v-model="visible" :draggable="false"></Dialog>` |
-| mode | `"destroy" | "hide"` | `"hide"` | 否 | 指定主体元素在关闭状态下的渲染方式 | `<Dialog v-model="visible" mode="destroy"></Dialog>` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| value | `boolean` | `false` | 否 | 弹窗是否展示，可用v-model双向绑定 | - | `<Dialog v-model="visible">` |
+| title | `string` | `"提示"` | 否 | 弹窗标题 | - | `<Dialog v-model="visible" title="确认操作">` |
+| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 弹窗尺寸 | - | `<Dialog v-model="visible" size="small">` |
+| width | `number | string` | `undefined` | 否 | 指定弹窗宽度，number类型时单位为px，string类型需要指定单位 | - | `<Dialog v-model="visible" :width="800">` |
+| loading | `boolean` | `false` | 否 | "确定"按钮是否为加载状态 | - | `<Dialog v-model="visible" :loading="isSubmitting">` |
+| disabledOk | `boolean` | `false` | 否 | "确定"按钮是否为禁用状态 | - | `<Dialog v-model="visible" :disabledOk="!isValid">` |
+| okText | `string` | `"确定"` | 否 | "确定"按钮文案 | - | `<Dialog v-model="visible" okText="保存">` |
+| cancelText | `string` | `"取消"` | 否 | "取消"按钮文案 | - | `<Dialog v-model="visible" cancelText="放弃">` |
+| ok | `() => void` | `undefined` | 否 | "确定"按钮点击后自定义回调函数 | - | `<Dialog v-model="visible" :ok="handleOk">` |
+| cancel | `() => void` | `undefined` | 否 | "取消"按钮点击后自定义回调函数 | - | `<Dialog v-model="visible" :cancel="handleCancel">` |
+| container | `string | ((parentDom: Element, anchor: Node | null) => Element)` | `undefined` | 否 | 指定弹窗插入的位置，默认追加到 body | - | `<Dialog v-model="visible" :container="() => document.body">` |
+| overlay | `boolean` | `true` | 否 | 是否展示遮罩层 | - | `<Dialog v-model="visible" :overlay="false">` |
+| closable | `boolean` | `true` | 否 | 点击遮罩层是否可以关闭弹窗 | - | `<Dialog v-model="visible" :closable="false">` |
+| terminate | `() => void` | `undefined` | 否 | 用户点击关闭按钮、遮罩层或按 ESC 键时的回调函数 | - | `<Dialog v-model="visible" :terminate="handleTerminate">` |
+| escClosable | `boolean` | `true` | 否 | 是否按ESC键关闭弹窗 | - | `<Dialog v-model="visible" :escClosable="false">` |
+| hideClose | `boolean` | `false` | 否 | 是否隐藏右上角关闭按钮 | - | `<Dialog v-model="visible" hideClose>` |
+| draggable | `boolean` | `true` | 否 | 弹窗是否可拖拽 | - | `<Dialog v-model="visible" :draggable="false">` |
+| mode | `"destroy" | "hide"` | `"hide"` | 否 | 指定主体元素在关闭状态下的渲染方式 | - | `<Dialog v-model="visible" mode="destroy">` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
-| open | `@open` | 弹窗打开后触发 | `-` | `<Dialog v-model="visible" @open="handleOpen"></Dialog>` |
-| close | `@close` | 弹窗关闭后触发，不管是什么原因导致的关闭 | `-` | `<Dialog v-model="visible" @close="handleClose"></Dialog>` |
-| ok | `@ok` | 点击确定按钮时触发 | `-` | `<Dialog v-model="visible" @ok="handleOk"></Dialog>` |
-| cancel | `@cancel` | 点击取消按钮时触发 | `-` | `<Dialog v-model="visible" @cancel="handleCancel"></Dialog>` |
-| terminate | `@terminate` | 用户强行关闭弹窗时触发：点击关闭按钮、点击遮罩层、按ESC键 | `-` | `<Dialog v-model="visible" @terminate="handleTerminate"></Dialog>` |
-| afterClose | `@after-close` | 弹窗退出动画执行完成后触发 | `-` | `<Dialog v-model="visible" @after-close="handleAfterClose"></Dialog>` |
-
-### 事件处理函数示例
-**open**:
-```typescript
-const handleOpen = () => {
-  console.log('弹窗已打开');
-};
-```
-
-**close**:
-```typescript
-const handleClose = () => {
-  console.log('弹窗已关闭');
-};
-```
-
-**ok**:
-```typescript
-const handleOk = () => {
-  // 处理确定逻辑
-  visible.value = false;
-};
-```
-
-**cancel**:
-```typescript
-const handleCancel = () => {
-  visible.value = false;
-};
-```
-
-**terminate**:
-```typescript
-const handleTerminate = () => {
-  console.log('用户强行关闭了弹窗');
-};
-```
-
-**afterClose**:
-```typescript
-const handleAfterClose = () => {
-  // 动画完成后清理
-};
-```
+| open | `@open` | 弹窗打开后触发 | `-` | `<Dialog v-model="visible" @open="handleOpen">` |
+| close | `@close` | 弹窗关闭后触发，不管是什么原因导致的关闭 | `-` | `<Dialog v-model="visible" @close="handleClose">` |
+| ok | `@ok` | 点击确定按钮时触发 | `-` | `<Dialog v-model="visible" @ok="handleOk">` |
+| cancel | `@cancel` | 点击取消按钮时触发 | `-` | `<Dialog v-model="visible" @cancel="handleCancel">` |
+| terminate | `@terminate` | 用户强行关闭弹窗时触发：点击关闭按钮、点击遮罩层、按ESC键 | `-` | `<Dialog v-model="visible" @terminate="handleTerminate">` |
+| afterClose | `@after-close` | 弹窗退出动画执行完成后触发 | `-` | `<Dialog v-model="visible" @after-close="handleAfterClose">` |
 
 ## 插槽 (Slots)
 | 插槽名 | 说明 | 模板写法 | 示例 |
 | --- | --- | --- | --- |
-| content | 定义整个弹窗体，包括header，body，footer | `#content` | `<Dialog v-model="visible">
-  <template #content>
-    <!-- 完全自定义弹窗结构 -->
-  </template>
+| default | 弹窗主体内容（body区域） | `默认插槽` | `<Dialog v-model="visible">
+  <p>弹窗内容</p>
 </Dialog>` |
 | header | 扩展弹窗头部 | `#header` | `<Dialog v-model="visible">
   <template #header>
     <h2>自定义头部</h2>
   </template>
 </Dialog>` |
-| body | 扩展弹窗主体部分 | `#body` | - |
-| footer | 扩展弹窗底部 | `#footer` | `<Dialog v-model="visible">
+| footer | 扩展弹窗底部按钮区域 | `#footer` | `<Dialog v-model="visible">
   <template #footer>
     <Button @click="visible = false">关闭</Button>
     <Button type="primary" @click="handleSubmit">提交</Button>
   </template>
 </Dialog>` |
-| footerWrapper | 扩展弹窗整个底部，上述footer是它下面一个子扩展点 | `#footerWrapper` | - |
+| content | 定义整个弹窗体，包括header、body、footer | `#content` | `<Dialog v-model="visible">
+  <template #content>
+    <!-- 完全自定义弹窗结构 -->
+  </template>
+</Dialog>` |
 
 ## 方法 (Methods)
 | 方法名 | 说明 | 参数 | 返回值 |
 | --- | --- | --- | --- |
-| show | 弹出弹窗 | `` | `Promise` |
-| close | 关闭弹窗 | `` | `void` |
-| showLoading | "确定"按钮变为加载状态 | `` | `void` |
-| hideLoading | "确定"按钮变为正常状态 | `` | `void` |
+| show | 弹出弹窗 | `props?: DialogProps` | `Promise` |
+| close | 关闭弹窗 | `-` | `void` |
+| showLoading | "确定"按钮变为加载状态 | `-` | `void` |
+| hideLoading | "确定"按钮变为正常状态 | `-` | `void` |
+
+### 方法参数说明
+**show**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| props | `DialogProps` | 否 | - | 可选的临时弹窗配置，会在本次显示时覆盖标题、按钮文案或宽度等属性。 |
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 静态方法调用时未正确导入Dialog
 > **错误用法**: `import { confirm } from '@king-design/vue';
 confirm({ title: '确认' });`
 > **正确写法**: `import { Dialog } from '@king-design/vue';
 Dialog.confirm({ title: '确认' });`
 > **说明**: confirm、success、warning、error是Dialog的静态方法，需要通过Dialog.xxx()调用
 
+### @ok事件中未关闭弹窗
 > **错误用法**: `const handleOk = () => {
   // 只处理业务逻辑，忘记关闭弹窗
   submitData();
@@ -130,6 +100,7 @@ Dialog.confirm({ title: '确认' });`
 };`
 > **说明**: 使用@ok事件时，弹窗不会自动关闭，需要在处理函数中手动设置visible为false
 
+### v-model语法错误
 > **错误用法**: `<Dialog :value="visible" @update:value="visible = $event">`
 > **正确写法**: `<Dialog v-model="visible">`
 > **说明**: Vue 3中应使用v-model语法糖，不需要手动拆分:value和@update:value

package/docs_for_llm/divider.doc.md

@@ -12,13 +12,13 @@ import { Divider } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| borderType | `"solid" | "dashed" | "dotted" | "double"` | `"solid"` | 否 | 定义线的类型 | `<Divider borderType="dashed">虚线</Divider>` |
-| position | `"left" | "right" | "center"` | `"center"` | 否 | 定义文字位置 | `<Divider position="left">左侧文字</Divider>` |
-| type | `"vertical" | "horizontal"` | `"vertical"` | 否 | 定义排列方式（水平或垂直）。注意：'horizontal' 用于创建垂直分割线（水平排列），'vertical' 用于创建水平分割线（垂直排列）。 | `<Divider type="horizontal" />` |
-| theme | `"light" | "dark"` | `"light"` | 否 | 定义主题，适用于深/浅色背景 | `<Divider theme="dark" />` |
-| margin | `"large" | "default" | "small" | "none" | number` | `"default"` | 否 | 定义Divider上下（或左右）外边距 | `<Divider margin="large" />` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| borderType | `"solid" | "dashed" | "dotted" | "double"` | `"solid"` | 否 | 定义线的类型 | - | `<Divider borderType="dashed">虚线</Divider>` |
+| position | `"left" | "right" | "center"` | `"center"` | 否 | 定义文字位置 | - | `<Divider position="left">左侧文字</Divider>` |
+| type | `"vertical" | "horizontal"` | `"vertical"` | 否 | 定义排列方式（水平或垂直）。注意：'horizontal' 用于创建垂直分割线（水平排列），'vertical' 用于创建水平分割线（垂直排列）。 | - | `<Divider type="horizontal" />` |
+| theme | `"light" | "dark"` | `"light"` | 否 | 定义主题，适用于深/浅色背景 | - | `<Divider theme="dark" />` |
+| margin | `"large" | "default" | "small" | "none" | number` | `"default"` | 否 | 定义Divider上下（或左右）外边距 | - | `<Divider margin="large" />` |
 
 ## 插槽 (Slots)
 | 插槽名 | 说明 | 模板写法 | 示例 |
@@ -26,10 +26,12 @@ import { Divider } from '@king-design/vue';
 | default | 分割线中间的文字内容 | `#default` | `<Divider>文字内容</Divider>` |
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 混淆 vertical 和 horizontal 的含义
 > **错误用法**: `<Divider type="vertical" /> <!-- 想创建垂直分割线 -->`
 > **正确写法**: `<Divider type="horizontal" /> <!-- vertical是默认值(水平线)，horizontal才是垂直线 -->`
 > **说明**: Divider 的 type 属性指的是排列方式。vertical 表示垂直排列（即上下分隔，产生水平线），horizontal 表示水平排列（即左右分隔，产生垂直线）。
 
+### 自定义 margin 时未使用动态绑定
 > **错误用法**: `<Divider margin="20" />`
 > **正确写法**: `<Divider :margin="20" />`
 > **说明**: 如果传入的是数字类型的 margin，需要使用 v-bind 语法 (:margin)。