king-design-analyzer 2.1.7 → 2.2.0

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)。

package/docs_for_llm/drawer.doc.md

@@ -12,108 +12,67 @@ import { Drawer } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| value | `boolean` | `false` | 否 | 抽屉是否展示，可用 v-model 双向绑定 | `<Drawer v-model="visible"></Drawer>` |
-| title | `string` | `"提示"` | 否 | 抽屉标题 | `<Drawer title="抽屉标题"></Drawer>` |
-| placement | `"top" | "bottom" | "left" | "right"` | `"right"` | 否 | 抽屉弹出的位置 | `<Drawer placement="left"></Drawer>` |
-| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 抽屉尺寸 | `<Drawer size="large"></Drawer>` |
-| width | `number | string` | `undefined` | 否 | 指定抽屉宽度，number 类型时单位为 px，string 类型需指定单位 | `<Drawer :width="500"></Drawer>` |
-| loading | `boolean` | `false` | 否 | "确定"按钮是否为加载状态 | `<Drawer :loading="isSubmitting"></Drawer>` |
-| disabledOk | `boolean` | `false` | 否 | "确定"按钮是否为禁用状态 | `<Drawer :disabledOk="!isFormValid"></Drawer>` |
-| okText | `string` | `"确定"` | 否 | "确定"按钮文案 | `<Drawer okText="保存"></Drawer>` |
-| cancelText | `string` | `"取消"` | 否 | "取消"按钮文案 | `<Drawer cancelText="关闭"></Drawer>` |
-| ok | `() => void` | `undefined` | 否 | "确定"按钮点击后自定义回调函数 | `<Drawer :ok="handleOk"></Drawer>` |
-| cancel | `() => void` | `undefined` | 否 | "取消"按钮点击后自定义回调函数 | `<Drawer :cancel="handleCancel"></Drawer>` |
-| hideClose | `boolean` | `false` | 否 | 是否隐藏右上角关闭按钮 | `<Drawer hideClose></Drawer>` |
-| overlay | `boolean` | `true` | 否 | 是否展示遮罩层 | `<Drawer :overlay="false"></Drawer>` |
-| closable | `boolean` | `true` | 否 | 点击遮罩层是否可以关闭抽屉 | `<Drawer :closable="false"></Drawer>` |
-| escClosable | `boolean` | `true` | 否 | 是否按 ESC 键时关闭抽屉 | `<Drawer :escClosable="false"></Drawer>` |
-| terminate | `() => void` | `undefined` | 否 | 用户点击关闭按钮、遮罩层或按 ESC 键时的回调函数 | `<Drawer :terminate="handleTerminate"></Drawer>` |
-| container | `string | ((parentDom: Element, anchor: Node | null) => Element)` | `undefined` | 否 | 指定抽屉插入的位置，默认追加到 body | `<Drawer :container="() => document.body"></Drawer>` |
-| mode | `"destroy" | "hide"` | `"hide"` | 否 | 指定关闭状态下的渲染方式 | `<Drawer mode="destroy"></Drawer>` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| value | `boolean` | `false` | 否 | 抽屉是否展示，可用 v-model 双向绑定 | - | `<Drawer v-model="visible">` |
+| title | `string` | `"提示"` | 否 | 抽屉标题 | - | `<Drawer title="抽屉标题">` |
+| placement | `"top" | "bottom" | "left" | "right"` | `"right"` | 否 | 抽屉弹出的位置 | - | `<Drawer placement="left">` |
+| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 抽屉尺寸 | - | `<Drawer size="large">` |
+| width | `number | string` | `undefined` | 否 | 指定抽屉宽度，number 类型时单位为 px，string 类型需指定单位 | - | `<Drawer :width="500">` |
+| loading | `boolean` | `false` | 否 | "确定"按钮是否为加载状态 | - | `<Drawer :loading="isSubmitting">` |
+| disabledOk | `boolean` | `false` | 否 | "确定"按钮是否为禁用状态 | - | `<Drawer :disabledOk="!isFormValid">` |
+| okText | `string` | `"确定"` | 否 | "确定"按钮文案 | - | `<Drawer okText="保存">` |
+| cancelText | `string` | `"取消"` | 否 | "取消"按钮文案 | - | `<Drawer cancelText="关闭">` |
+| ok | `() => void` | `undefined` | 否 | "确定"按钮点击后自定义回调函数 | - | `<Drawer :ok="handleOk">` |
+| cancel | `() => void` | `undefined` | 否 | "取消"按钮点击后自定义回调函数 | - | `<Drawer :cancel="handleCancel">` |
+| hideClose | `boolean` | `false` | 否 | 是否隐藏右上角关闭按钮 | - | `<Drawer hideClose>` |
+| overlay | `boolean` | `true` | 否 | 是否展示遮罩层 | - | `<Drawer :overlay="false">` |
+| closable | `boolean` | `true` | 否 | 点击遮罩层是否可以关闭抽屉 | - | `<Drawer :closable="false">` |
+| escClosable | `boolean` | `true` | 否 | 是否按 ESC 键时关闭抽屉 | - | `<Drawer :escClosable="false">` |
+| draggable | `boolean` | `true` | 否 | 抽屉是否可拖拽 | - | `<Drawer :draggable="false">` |
+| terminate | `() => void` | `undefined` | 否 | 用户点击关闭按钮、遮罩层或按 ESC 键时的回调函数 | - | `<Drawer :terminate="handleTerminate">` |
+| container | `string | ((parentDom: Element, anchor: Node | null) => Element)` | `undefined` | 否 | 指定抽屉插入的位置，默认追加到 body | - | `<Drawer :container="() => document.body">` |
+| mode | `"destroy" | "hide"` | `"hide"` | 否 | 指定关闭状态下的渲染方式 | - | `<Drawer mode="destroy">` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
-| open | `@open` | 抽屉打开后触发 | `-` | `<Drawer @open="handleOpen"></Drawer>` |
-| close | `@close` | 抽屉关闭后触发，不管是什么原因导致的关闭 | `-` | `<Drawer @close="handleClose"></Drawer>` |
-| ok | `@ok` | 点击确定按钮时触发 | `-` | `<Drawer @ok="handleOk"></Drawer>` |
-| cancel | `@cancel` | 点击取消按钮时触发 | `-` | `<Drawer @cancel="handleCancel"></Drawer>` |
-| terminate | `@terminate` | 用户强行关闭抽屉时触发（点击关闭按钮、遮罩层或按 ESC） | `-` | `<Drawer @terminate="handleTerminate"></Drawer>` |
-| afterClose | `@afterClose` | 抽屉退出动画执行完成后触发 | `-` | `<Drawer @afterClose="handleAfterClose"></Drawer>` |
-
-### 事件处理函数示例
-**open**:
-```typescript
-const handleOpen = () => {
-  console.log('抽屉已打开');
-};
-```
-
-**close**:
-```typescript
-const handleClose = () => {
-  console.log('抽屉已关闭');
-};
-```
-
-**ok**:
-```typescript
-const handleOk = () => {
-  console.log('点击了确定');
-};
-```
-
-**cancel**:
-```typescript
-const handleCancel = () => {
-  console.log('点击了取消');
-};
-```
-
-**terminate**:
-```typescript
-const handleTerminate = () => {
-  console.log('用户强行关闭');
-};
-```
-
-**afterClose**:
-```typescript
-const handleAfterClose = () => {
-  console.log('动画完成');
-};
-```
-
-## 插槽 (Slots)
-| 插槽名 | 说明 | 模板写法 | 示例 |
-| --- | --- | --- | --- |
-| content | 定义整个弹窗体，包括header，body，footer | `undefined` | - |
-| header | 扩展弹窗头部 | `undefined` | - |
-| body | 扩展弹窗主体部分 | `undefined` | - |
-| footer | 扩展弹窗底部 | `undefined` | - |
-| footer-wrapper | 扩展弹窗整个底部，上述footer是它下面一个子扩展点 | `undefined` | - |
+| open | `@open` | 抽屉打开后触发 | `-` | `<Drawer @open="handleOpen">` |
+| close | `@close` | 抽屉关闭后触发，不管是什么原因导致的关闭 | `-` | `<Drawer @close="handleClose">` |
+| ok | `@ok` | 点击确定按钮时触发 | `-` | `<Drawer @ok="handleOk">` |
+| cancel | `@cancel` | 点击取消按钮时触发 | `-` | `<Drawer @cancel="handleCancel">` |
+| terminate | `@terminate` | 用户强行关闭抽屉时触发（点击关闭按钮、遮罩层或按 ESC） | `-` | `<Drawer @terminate="handleTerminate">` |
+| afterClose | `@afterClose` | 抽屉退出动画执行完成后触发 | `-` | `<Drawer @afterClose="handleAfterClose">` |
 
 ## 方法 (Methods)
 | 方法名 | 说明 | 参数 | 返回值 |
 | --- | --- | --- | --- |
-| show | 弹出抽屉 | `` | `Promise` |
-| close | 关闭抽屉 | `` | `void` |
-| showLoading | "确定"按钮变为加载状态 | `` | `void` |
-| hideLoading | "确定"按钮变为正常状态 | `` | `void` |
-| disableOk | "确定"按钮变为禁用状态 | `` | `void` |
-| enableOk | "确定"按钮变为正常状态 | `` | `void` |
+| show | 弹出抽屉 | `props?: DrawerProps` | `Promise` |
+| close | 关闭抽屉 | `-` | `void` |
+| showLoading | "确定"按钮变为加载状态 | `-` | `void` |
+| hideLoading | "确定"按钮变为正常状态 | `-` | `void` |
+| disableOk | "确定"按钮变为禁用状态 | `-` | `void` |
+| enableOk | "确定"按钮变为正常状态 | `-` | `void` |
+
+### 方法参数说明
+**show**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| props | `DrawerProps` | 否 | - | 可选的临时抽屉配置，会在本次显示时覆盖标题、方向、宽度或按钮状态。 |
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### placement 值拼写错误
 > **错误用法**: `<Drawer placement="center">`
 > **正确写法**: `<Drawer placement="right">`
 > **说明**: placement 只支持 top, bottom, left, right，不存在 center 值
 
+### 使用错误的 v-model 属性名
 > **错误用法**: `<Drawer v-model:visible="visible">`
 > **正确写法**: `<Drawer v-model="visible">`
 > **说明**: Drawer 使用 v-model 控制显示状态，不是 v-model:visible
 
+### 混淆 closable 和 hideClose
 > **错误用法**: `<Drawer :closable="true"> <!-- 想隐藏关闭按钮 -->`
 > **正确写法**: `<Drawer hideClose> <!-- 隐藏关闭按钮 -->
 <Drawer :closable="false"> <!-- 禁止点击遮罩关闭 -->`

package/docs_for_llm/dropdown.doc.md

@@ -12,37 +12,65 @@ import { Dropdown, DropdownMenu, DropdownItem } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| trigger | `"hover" | "click" | "contextmenu" | "focus"` | `"hover"` | 否 | 触发方式 | `<Dropdown trigger="click"></Dropdown>` |
-| value | `boolean` | `false` | 否 | 是否展示菜单，可用 v-model 双向绑定 | `<Dropdown v-model="visible"></Dropdown>` |
-| disabled | `boolean` | `false` | 否 | 是否禁用整个菜单 | `<Dropdown disabled></Dropdown>` |
-| position | `Position | "left" | "bottom" | "right" | "top"` | `{my: 'left top+8', at: 'left bottom'}` | 否 | 菜单弹出的位置 | `<Dropdown position="right"></Dropdown>` |
-| of | `"self" | "parent" | Event` | `"self"` | 否 | 弹出菜单的位置是相对当前触发元素还是触发元素所在的菜单元素 | `<Dropdown of="parent"></Dropdown>` |
-| container | `string | ((parentDom: Element, anchor: Node | null) => Element)` | `undefined` | 否 | 指定弹出菜单追加的位置，默认追加到 body | `<Dropdown :container="() => document.body"></Dropdown>` |
-| alwaysShowOnClick | `boolean` | `false` | 否 | 不管什么触发方式，重复点击触发器都不隐藏弹层 | `<Dropdown alwaysShowOnClick></Dropdown>` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| trigger | `"hover" | "click" | "contextmenu" | "focus"` | `"hover"` | 否 | 触发方式 | - | `<Dropdown trigger="click">` |
+| value | `boolean` | `false` | 否 | 是否展示菜单，可用 v-model 双向绑定 | - | `<Dropdown v-model="visible">` |
+| disabled | `boolean` | `false` | 否 | 是否禁用整个菜单 | - | `<Dropdown disabled>` |
+| position | `Position | "left" | "bottom" | "right" | "top"` | `{my: 'left top+8', at: 'left bottom'}` | 否 | 菜单弹出的位置 | - | `<Dropdown position="right">` |
+| collison | `Collision | [Collision, Collision]` | `undefined` | 否 | 碰撞检测策略，控制弹层超出边界时的处理方式。注意源码字段名拼写为 collison。 | - | `<Dropdown :collison="'flipfit'">` |
+| of | `"self" | "parent" | Event` | `"self"` | 否 | 弹出菜单的位置是相对当前触发元素还是触发元素所在的菜单元素 | - | `<Dropdown of="parent">` |
+| container | `string | ((parentDom: Element, anchor: Node | null) => Element)` | `undefined` | 否 | 指定弹出菜单追加的位置，默认追加到 body | - | `<Dropdown :container="() => document.body">` |
+| alwaysShowOnClick | `boolean` | `false` | 否 | 不管什么触发方式，重复点击触发器都不隐藏弹层 | - | `<Dropdown alwaysShowOnClick>` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
-| show | `@show` | 菜单展示时触发 | `-` | `<Dropdown @show="handleShow"></Dropdown>` |
-| hide | `@hide` | 菜单隐藏时触发 | `-` | `<Dropdown @hide="handleHide"></Dropdown>` |
+| show | `@show` | 菜单展示时触发 | `-` | `<Dropdown @show="handleShow">` |
+| hide | `@hide` | 菜单隐藏时触发 | `-` | `<Dropdown @hide="handleHide">` |
+| positioned | `@positioned` | 下拉菜单完成定位计算后触发，可用于读取最终落位方向和坐标。 | `feedback: Feedback` | `<Dropdown @positioned="handlePositioned">` |
 
-### 事件处理函数示例
-**show**:
-```typescript
-const handleShow = () => {
-  console.log('菜单已展示');
-};
-```
+### 事件参数说明
+**positioned**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| feedback | `Feedback` | 是 | - | 定位反馈对象，描述当前菜单的最终 placement 和坐标信息。 |
 
-**hide**:
+事件处理示例:
 ```typescript
-const handleHide = () => {
-  console.log('菜单已隐藏');
+const handlePositioned = (feedback: Feedback) => {
+  console.log('最终位置', feedback.placement);
 };
 ```
 
+## 方法 (Methods)
+| 方法名 | 说明 | 参数 | 返回值 |
+| --- | --- | --- | --- |
+| show | 主动展开下拉菜单。 | `shouldFocus?: boolean` | `void` |
+| hide | 主动隐藏下拉菜单。 | `immediately?: boolean` | `void` |
+| focusFirst | 把焦点移动到菜单中的第一个可聚焦项。 | `-` | `void` |
+| position | 重新计算当前下拉菜单的位置。 | `callback?: (feedback: Feedback) => void` | `void` |
+
+### 方法参数说明
+**show**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| shouldFocus | `boolean` | 否 | - | 展开后是否尝试把焦点移动到菜单内容，用于键盘可访问性场景。 |
+
+**hide**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| immediately | `boolean` | 否 | - | 是否立即隐藏并跳过延迟关闭逻辑。 |
+
+**position**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| callback | `(feedback: Feedback) => void` | 否 | - | 定位完成后的回调，可读取最终 placement 和坐标。 |
+
 ## 子组件 (Sub-Components)
 ### DropdownMenu
 下拉菜单容器，用于包裹菜单项
@@ -60,6 +88,7 @@ const handleHide = () => {
 - `@click`: 菜单项被点击时触发
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 未使用 #menu 插槽
 > **错误用法**: `<Dropdown>
   <Button>菜单</Button>
   <DropdownMenu>
@@ -76,10 +105,12 @@ const handleHide = () => {
 </Dropdown>`
 > **说明**: DropdownMenu 必须放在 #menu 插槽中
 
+### trigger 值拼写错误
 > **错误用法**: `<Dropdown trigger="rightclick">`
 > **正确写法**: `<Dropdown trigger="contextmenu">`
 > **说明**: 右键触发应使用 contextmenu，不是 rightclick
 
+### DropdownItem 未放在 DropdownMenu 中
 > **错误用法**: `<Dropdown>
   <Button>菜单</Button>
   <template #menu>

package/docs_for_llm/duration.doc.md

@@ -0,0 +1,76 @@
+# 时长选择 (Duration)
+
+用于购买、续费和策略配置场景的时长选择器，支持按月或按小时切换，并可配合内置刻度快速选择常用周期。
+
+**关键词**: duration, period, 时长选择, 购买时长, 按小时时长, 续费周期
+
+**使用场景**: 购买链路时长选择、资源续费时长选择、按小时设置临时资源周期
+
+## 导入语句
+```typescript
+import { Duration } from '@ksyun-internal/versatile';
+```
+
+## 属性 (Props)
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| modelValue | `number` | `undefined` | 否 | 当前选中的时长值 | - | - |
+| marksType | `string` | `"month"` | 否 | 刻度类型，控制内置 marks 的生成方式 | - | - |
+| type | `string` | `"month"` | 否 | 时长类型，通常为 month 或 hour | - | - |
+
+## 事件 (Events)
+| 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
+| --- | --- | --- | --- | --- |
+| update:modelValue | `@update:modelValue` | 用户选择新的时长后触发，通常用于联动价格或到期时间计算。 | `value?: number` | - |
+
+### 事件参数说明
+**update:modelValue**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `number` | 否 | - | 当前选中的时长值。 |
+
+## 使用示例
+### 续费时长选择
+**场景**: 在购买或续费流程中选择资源有效时长。
+
+按月展示常用刻度，并把结果同步到续费表单。
+
+**使用的 API**: 属性: modelValue, type, marksType | 事件: update:modelValue
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Duration } from '@ksyun-internal/versatile';
+
+const duration = ref(3);
+</script>
+
+<template>
+  <Duration v-model="duration" type="month" marks-type="month" />
+</template>
+```
+
+### 按小时选择时长
+**场景**: 在临时测试机或弹性资源场景中按小时设置有效时长。
+
+在临时资源场景中切换到按小时的时长选择。
+
+**使用的 API**: 属性: modelValue, type, marksType | 事件: update:modelValue
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Duration } from '@ksyun-internal/versatile';
+
+const duration = ref(12);
+</script>
+
+<template>
+  <Duration v-model="duration" type="hour" marks-type="hour" />
+</template>
+```
+
+## 相关组件
+Slider, TimeRange
+