king-design-analyzer 2.1.9 → 2.2.1

package/docs_for_llm/message.doc.md

@@ -12,13 +12,13 @@ import { Message } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| content | `string | VNode` | `undefined` | 否 | 提示内容 | `Message.info({ content: '提示内容' })` |
-| duration | `number` | `5000` | 否 | 提示展示多长时间后自动关闭，传入 0 时不自动关闭，单位 ms | `Message.info('提示', 10000)` |
-| type | `"info" | "error" | "success" | "warning"` | `"info"` | 否 | 提示类型 | `Message.success('成功')` |
-| closable | `boolean` | `false` | 否 | 是否展示关闭按钮 | `Message.info({ content: '可关闭', closable: true })` |
-| hideIcon | `boolean` | `false` | 否 | 是否隐藏文字前面的图标 | `Message.info({ content: '无图标', hideIcon: true })` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| content | `string | VNode` | `undefined` | 否 | 提示内容 | - | `Message.info({ content: '提示内容' })` |
+| duration | `number` | `5000` | 否 | 提示展示多长时间后自动关闭，传入 0 时不自动关闭，单位 ms | - | `Message.info('提示', 10000)` |
+| type | `"info" | "error" | "success" | "warning"` | `"info"` | 否 | 提示类型 | - | `Message.success('成功')` |
+| closable | `boolean` | `false` | 否 | 是否展示关闭按钮 | - | `Message.info({ content: '可关闭', closable: true })` |
+| hideIcon | `boolean` | `false` | 否 | 是否隐藏文字前面的图标 | - | `Message.info({ content: '无图标', hideIcon: true })` |
 
 ## 方法 (Methods)
 | 方法名 | 说明 | 参数 | 返回值 |
@@ -28,17 +28,94 @@ import { Message } from '@king-design/vue';
 | warning | 显示警告提示消息 | `content: string | VNode | Partial<MessageProps>, duration: number` | `void` |
 | error | 显示错误提示消息 | `content: string | VNode | Partial<MessageProps>, duration: number` | `void` |
 
+### 方法参数说明
+**info**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| content | `string | VNode | Partial<MessageProps>` | 是 | - | 提示内容或配置对象 |
+| duration | `number` | 是 | - | 可选，显示时长（ms） |
+
+调用示例:
+```typescript
+Message.info('这是一条普通消息');
+```
+
+**success**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| content | `string | VNode | Partial<MessageProps>` | 是 | - | 提示内容或配置对象 |
+| duration | `number` | 是 | - | 可选，显示时长（ms） |
+
+调用示例:
+```typescript
+Message.success('操作成功');
+```
+
+**warning**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| content | `string | VNode | Partial<MessageProps>` | 是 | - | 提示内容或配置对象 |
+| duration | `number` | 是 | - | 可选，显示时长（ms） |
+
+调用示例:
+```typescript
+Message.warning('请注意');
+```
+
+**error**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| content | `string | VNode | Partial<MessageProps>` | 是 | - | 提示内容或配置对象 |
+| duration | `number` | 是 | - | 可选，显示时长（ms） |
+
+调用示例:
+```typescript
+Message.error('操作失败');
+```
+
+### 方法调用示例
+**info**
+
+```typescript
+Message.info('这是一条普通消息');
+```
+
+**success**
+
+```typescript
+Message.success('操作成功');
+```
+
+**warning**
+
+```typescript
+Message.warning('请注意');
+```
+
+**error**
+
+```typescript
+Message.error('操作失败');
+```
+
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 未导入 Message 组件
 > **错误用法**: `Message.success('成功'); // ReferenceError: Message is not defined`
 > **正确写法**: `import { Message } from '@king-design/vue';
 
 Message.success('成功');`
 > **说明**: 使用 Message 前需要先从 @king-design/vue 导入
 
+### duration 使用字符串而非数字
 > **错误用法**: `Message.info('提示', '5000');`
 > **正确写法**: `Message.info('提示', 5000);`
 > **说明**: duration 必须是数字类型，单位是毫秒
 
+### 传入配置对象时忘记设置 content
 > **错误用法**: `Message.info({ duration: 10000 });`
 > **正确写法**: `Message.info({ content: '提示内容', duration: 10000 });`
 > **说明**: 使用配置对象时必须包含 content 属性
@@ -49,6 +126,8 @@ Message.success('成功');`
 
 基本的消息提示
 
+**使用的 API**: 方法: info
+
 ```vue
 <script setup lang="ts">
 import { Button, Message } from '@king-design/vue';
@@ -67,6 +146,8 @@ const showMessage = () => {
 
 四种类型的消息提示
 
+**使用的 API**: 方法: success, warning, error, info
+
 ```vue
 <script setup lang="ts">
 import { Button, Message } from '@king-design/vue';
@@ -89,7 +170,7 @@ const showInfo = () => Message.info('提示信息');
 
 设置消息显示时长
 
-**使用的 API**: 属性: duration
+**使用的 API**: 属性: duration | 方法: info, warning
 
 ```vue
 <script setup lang="ts">
@@ -116,7 +197,7 @@ const showPermanent = () => {
 
 带关闭按钮的消息
 
-**使用的 API**: 属性: content, closable, duration
+**使用的 API**: 属性: content, closable, duration | 方法: info
 
 ```vue
 <script setup lang="ts">
@@ -140,7 +221,7 @@ const showMessage = () => {
 
 不显示图标的消息
 
-**使用的 API**: 属性: content, hideIcon
+**使用的 API**: 属性: content, hideIcon | 方法: success
 
 ```vue
 <script setup lang="ts">
@@ -163,6 +244,8 @@ const showMessage = () => {
 
 常见的 API 请求结果提示
 
+**使用的 API**: 方法: success, error
+
 ```vue
 <script setup lang="ts">
 import { ref } from 'vue';

package/docs_for_llm/notification.doc.md

@@ -0,0 +1,214 @@
+# 通知提醒 (Notification)
+
+全局通知组件，用于展示可停留、可关闭的系统级通知信息。支持不同语义类型、展示位置、自定义图标和点击回调，适合成功反馈、系统公告和后台异步任务提醒。
+
+**关键词**: notification, 通知, 提醒, 全局通知, notice
+
+**使用场景**: 系统公告提醒、异步任务完成通知、操作成功或失败反馈
+
+## 导入语句
+```typescript
+import { Notification } from '@king-design/vue';
+```
+
+## 属性 (Props)
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| title | `Children` | `undefined` | 否 | 通知标题内容 | - | `Notification.notice({ title: '部署完成' })` |
+| content | `Children` | `undefined` | 否 | 通知正文内容 | - | `Notification.notice({ content: '实例已经创建成功' })` |
+| duration | `number` | `5000` | 否 | 通知自动关闭时间，单位 ms；传入 0 表示不自动关闭 | - | `Notification.info({ title: '处理中', duration: 0 })` |
+| type | `"info" | "error" | "success" | "warning" | ""` | `"info"` | 否 | 通知类型 | - | `Notification.success({ title: '发布成功' })` |
+| closable | `boolean` | `true` | 否 | 是否显示关闭按钮 | - | `Notification.notice({ title: '系统公告', closable: false })` |
+| icon | `string | VNode` | `undefined` | 否 | 自定义通知图标 | - | `Notification.notice({ title: '自定义图标', icon: 'k-icon-info' })` |
+| position | `"topRight" | "topLeft" | "bottomRight" | "bottomLeft" | "top" | "bottom"` | `"topRight"` | 否 | 通知展示位置 | - | `Notification.info({ title: '左下角通知', position: 'bottomLeft' })` |
+| className | `string` | `undefined` | 否 | 自定义通知根节点类名 | - | `Notification.notice({ title: '自定义样式', className: 'my-notification' })` |
+| onClick | `(e: MouseEvent) => void` | `undefined` | 否 | 点击通知主体时触发的回调 | - | `Notification.notice({ title: '查看详情', onClick: () => console.log('clicked') })` |
+| onClose | `() => void` | `undefined` | 否 | 通知关闭后触发的回调 | - | `Notification.notice({ title: '关闭回调', onClose: () => console.log('closed') })` |
+
+## 方法 (Methods)
+| 方法名 | 说明 | 参数 | 返回值 |
+| --- | --- | --- | --- |
+| notice | 展示一条通知并返回唯一 ID | `props: Partial<NotificationProps>` | `number` |
+| close | 关闭指定 ID 的通知 | `id: number` | `void` |
+| info | 展示普通类型通知 | `props: Partial<NotificationProps>` | `number` |
+| success | 展示成功类型通知 | `props: Partial<NotificationProps>` | `number` |
+| warning | 展示警告类型通知 | `props: Partial<NotificationProps>` | `number` |
+| error | 展示错误类型通知 | `props: Partial<NotificationProps>` | `number` |
+
+### 方法参数说明
+**notice**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| props | `Partial<NotificationProps>` | 是 | - | 通知配置对象 |
+
+调用示例:
+```typescript
+const id = Notification.notice({ title: '部署完成', content: '实例已创建完成' });
+```
+
+**close**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| id | `number` | 是 | - | 由 notice 返回的通知 ID |
+
+调用示例:
+```typescript
+Notification.close(id);
+```
+
+**info**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| props | `Partial<NotificationProps>` | 是 | - | 通知配置对象 |
+
+调用示例:
+```typescript
+Notification.info({ title: '普通提醒', content: '这是一条信息通知' });
+```
+
+**success**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| props | `Partial<NotificationProps>` | 是 | - | 通知配置对象 |
+
+调用示例:
+```typescript
+Notification.success({ title: '保存成功', content: '配置已更新' });
+```
+
+**warning**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| props | `Partial<NotificationProps>` | 是 | - | 通知配置对象 |
+
+调用示例:
+```typescript
+Notification.warning({ title: '余额不足', content: '请尽快续费' });
+```
+
+**error**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| props | `Partial<NotificationProps>` | 是 | - | 通知配置对象 |
+
+调用示例:
+```typescript
+Notification.error({ title: '提交失败', content: '请稍后重试' });
+```
+
+### 方法调用示例
+**notice**
+
+```typescript
+const id = Notification.notice({ title: '部署完成', content: '实例已创建完成' });
+```
+
+**close**
+
+```typescript
+Notification.close(id);
+```
+
+**info**
+
+```typescript
+Notification.info({ title: '普通提醒', content: '这是一条信息通知' });
+```
+
+**success**
+
+```typescript
+Notification.success({ title: '保存成功', content: '配置已更新' });
+```
+
+**warning**
+
+```typescript
+Notification.warning({ title: '余额不足', content: '请尽快续费' });
+```
+
+**error**
+
+```typescript
+Notification.error({ title: '提交失败', content: '请稍后重试' });
+```
+
+## 使用示例
+### 基础通知
+**场景**: 在页面操作完成后展示全局反馈。
+
+点击按钮展示基础通知。
+
+**使用的 API**: 方法: notice
+
+```vue
+<script setup lang="ts">
+import { Button, Notification } from '@king-design/vue';
+
+const openNotification = () => {
+  Notification.notice({
+    title: 'Hello, King Design',
+    content: '这是一条基础通知',
+  });
+};
+</script>
+<template>
+  <Button @click="openNotification">打开通知</Button>
+</template>
+```
+
+### 不同类型
+**场景**: 根据业务结果展示不同语义反馈。
+
+按语义展示不同类型的通知。
+
+**使用的 API**: 属性: type | 方法: info, success, warning, error
+
+```vue
+<script setup lang="ts">
+import { Button, Notification } from '@king-design/vue';
+</script>
+<template>
+  <div style="display: flex; gap: 8px; flex-wrap: wrap;">
+    <Button @click="Notification.info({ title: '普通提醒', content: '这是一条信息通知' })">Info</Button>
+    <Button @click="Notification.success({ title: '发布成功', content: '版本已上线' })">Success</Button>
+    <Button @click="Notification.warning({ title: '容量不足', content: '请及时清理磁盘' })">Warning</Button>
+    <Button @click="Notification.error({ title: '同步失败', content: '网络连接异常' })">Error</Button>
+  </div>
+</template>
+```
+
+### 位置与常驻
+**场景**: 展示需要用户明确感知和手动关闭的通知。
+
+控制通知位置并让通知常驻直到手动关闭。
+
+**使用的 API**: 属性: position, duration | 方法: notice
+
+```vue
+<script setup lang="ts">
+import { Button, Notification } from '@king-design/vue';
+
+const openPinned = () => {
+  Notification.notice({
+    title: '系统公告',
+    content: '该通知位于底部且不会自动关闭',
+    position: 'bottom',
+    duration: 0,
+  });
+};
+</script>
+<template>
+  <Button @click="openPinned">打开常驻通知</Button>
+</template>
+```
+
+## 相关组件
+Message, Dialog
+

package/docs_for_llm/pagination.doc.md

@@ -12,29 +12,36 @@ import { Pagination } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| value | `number` | `1` | 否 | 当前页码，可用 v-model 双向绑定 | `<Pagination v-model="currentPage" :total="100" />` |
-| total | `number` | `0` | 否 | 数据总条数 | `<Pagination :total="1000" />` |
-| limit | `number` | `10` | 否 | 每页条数，可用 v-model:limit 双向绑定 | `<Pagination v-model:limit="pageSize" :total="100" />` |
-| limits | `Array<number>` | `[10, 20, 50]` | 否 | 可选的每页条数列表 | `<Pagination :limits="[20, 50, 100, 200]" :total="1000" />` |
-| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 尺寸 | `<Pagination size="small" :total="100" />` |
-| counts | `number` | `7` | 否 | 展示的页码按钮个数 | `<Pagination :counts="5" :total="100" />` |
-| flat | `boolean` | `false` | 否 | 是否展示无边框样式 | `<Pagination flat :total="100" />` |
-| simple | `boolean` | `false` | 否 | 是否展示简洁样式 | `<Pagination simple :total="100" />` |
-| showTotal | `boolean` | `true` | 否 | 是否显示总条数 | `<Pagination :showTotal="false" :total="100" />` |
-| showGoto | `boolean` | `false` | 否 | 是否显示快速跳转框 | `<Pagination showGoto :total="100" />` |
-| showLimits | `boolean` | `true` | 否 | 是否显示每页条数选择框 | `<Pagination :showLimits="false" :total="100" />` |
-| disableBtn | `(page: number, limit: number) => boolean` | `undefined` | 否 | 禁用页码按钮的函数，"上一页""下一页"按钮依然可点 | `<Pagination :disableBtn="(page) => page > 10" :total="200" /></Pagination>` |
-| disablePage | `(page: number, limit: number) => boolean` | `undefined` | 否 | 同时禁用页码按钮和"上一页""下一页"按钮的函数 | `<Pagination :disablePage="(page) => page > 10" :total="200" /></Pagination>` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| value | `number` | `1` | 否 | 当前页码，可用 v-model 双向绑定 | - | `<Pagination v-model="currentPage" :total="100" />` |
+| total | `number` | `0` | 否 | 数据总条数 | - | `<Pagination :total="1000" />` |
+| limit | `number` | `10` | 否 | 每页条数，可用 v-model:limit 双向绑定 | - | `<Pagination v-model:limit="pageSize" :total="100" />` |
+| limits | `Array<number>` | `[10, 20, 50]` | 否 | 可选的每页条数列表 | - | `<Pagination :limits="[20, 50, 100, 200]" :total="1000" />` |
+| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 尺寸 | - | `<Pagination size="small" :total="100" />` |
+| counts | `number` | `7` | 否 | 展示的页码按钮个数 | - | `<Pagination :counts="5" :total="100" />` |
+| flat | `boolean` | `false` | 否 | 是否展示无边框样式 | - | `<Pagination flat :total="100" />` |
+| simple | `boolean` | `false` | 否 | 是否展示简洁样式 | - | `<Pagination simple :total="100" />` |
+| showTotal | `boolean` | `true` | 否 | 是否显示总条数 | - | `<Pagination :showTotal="false" :total="100" />` |
+| showGoto | `boolean` | `false` | 否 | 是否显示快速跳转框 | - | `<Pagination showGoto :total="100" />` |
+| showLimits | `boolean` | `true` | 否 | 是否显示每页条数选择框 | - | `<Pagination :showLimits="false" :total="100" />` |
+| disableBtn | `(page: number, limit: number) => boolean` | `undefined` | 否 | 禁用页码按钮的函数，"上一页""下一页"按钮依然可点 | - | `<Pagination :disableBtn="(page) => page > 10" :total="200" /></Pagination>` |
+| disablePage | `(page: number, limit: number) => boolean` | `undefined` | 否 | 同时禁用页码按钮和"上一页""下一页"按钮的函数 | - | `<Pagination :disablePage="(page) => page > 10" :total="200" /></Pagination>` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
 | change | `@change` | value 和 limit 变化时触发，同时变化不会重复触发 | `value: number, limit: number` | `<Pagination @change="handleChange" :total="100" />` |
 
-### 事件处理函数示例
-**change**:
+### 事件参数说明
+**change**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `number` | 是 | - | 当前页码 |
+| limit | `number` | 是 | - | 每页条数 |
+
+事件处理示例:
 ```typescript
 const handleChange = ({value, limit}: {value: number; limit: number}) => {
   console.log(`当前页: ${value}, 每页: ${limit}`);
@@ -43,26 +50,32 @@ const handleChange = ({value, limit}: {value: number; limit: number}) => {
 ```
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 未设置 total 属性
 > **错误用法**: `<Pagination v-model="currentPage" />`
 > **正确写法**: `<Pagination v-model="currentPage" :total="100" />`
 > **说明**: 必须设置 total 属性来指定数据总条数，否则分页无法正确计算总页数
 
+### 使用不存在的 size 值 (Pagination)
 > **错误用法**: `<Pagination size="medium" :total="100" />`
 > **正确写法**: `<Pagination size="default" :total="100" />`
 > **说明**: Pagination 的 size 只支持 large, default, small, mini。常见错误是使用 medium 值。
 
+### limit 值不在 limits 列表中
 > **错误用法**: `<Pagination :limit="15" :limits="[10, 20, 50]" :total="100" />`
 > **正确写法**: `<Pagination :limit="10" :limits="[10, 20, 50]" :total="100" />`
 > **说明**: limit 的初始值应该在 limits 列表中，否则可能导致显示异常
 
+### change 事件参数解构错误
 > **错误用法**: `const handleChange = (value, limit) => {}`
 > **正确写法**: `const handleChange = ({value, limit}: {value: number; limit: number}) => {}`
 > **说明**: change 事件的参数是一个对象，需要解构获取 value 和 limit
 
+### 错误使用 Element UI 风格事件名
 > **错误用法**: `<Pagination @current-change="..." @size-change="..." />`
 > **正确写法**: `<Pagination @change="..." />`
 > **说明**: KPC Pagination 不支持 `@current-change` 或 `@size-change`，请统一使用 `@change` 事件监听页码或每页条数变化。
 
+### 建议使用 v-model 进行双向绑定
 > **错误用法**: `<Pagination :value="page" :limit="size" @change="..." />`
 > **正确写法**: `<Pagination v-model="page" v-model:limit="size" />`
 > **说明**: 推荐使用 `v-model` 绑定当前页码，`v-model:limit` 绑定每页条数，更加简洁。

package/docs_for_llm/paginationplus.doc.md

@@ -2,9 +2,9 @@
 
 集成选中统计和操作的分页组件，继承自 Pagination。
 
-**关键词**: pagination, page, paging, 分页
+**关键词**: pagination, page, paging, 分页, 增强分页, 选中统计分页, 列表底部分页
 
-**使用场景**: 列表页分页控制
+**使用场景**: 列表页分页控制、批量勾选后的分页统计、带选中数量提示的资源列表分页
 
 ## 导入语句
 ```typescript
@@ -12,21 +12,42 @@ import { PaginationPlus } from '@ksyun-internal/versatile';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| modelValue | `number` | `undefined` | 否 | 当前页码 | - |
-| checkedKeys | `any[]` | `undefined` | 否 | 选中的行的 key 列表 | - |
-| checkedLength | `number` | `undefined` | 否 | 选中的总数量 | - |
-| showCheckedTotal | `boolean` | `true` | 否 | 是否显示选中统计信息 | - |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| total | `number` | `0` | 否 | 数据总条数 | `inherited:Pagination` | `<Pagination :total="1000" />` |
+| limit | `number` | `10` | 否 | 每页条数，可用 v-model:limit 双向绑定 | `inherited:Pagination` | `<Pagination v-model:limit="pageSize" :total="100" />` |
+| limits | `Array<number>` | `[10, 20, 50]` | 否 | 可选的每页条数列表 | `inherited:Pagination` | `<Pagination :limits="[20, 50, 100, 200]" :total="1000" />` |
+| size | `"large" | "default" | "small" | "mini"` | `"default"` | 否 | 尺寸 | `inherited:Pagination` | `<Pagination size="small" :total="100" />` |
+| counts | `number` | `7` | 否 | 展示的页码按钮个数 | `inherited:Pagination` | `<Pagination :counts="5" :total="100" />` |
+| flat | `boolean` | `false` | 否 | 是否展示无边框样式 | `inherited:Pagination` | `<Pagination flat :total="100" />` |
+| simple | `boolean` | `false` | 否 | 是否展示简洁样式 | `inherited:Pagination` | `<Pagination simple :total="100" />` |
+| showTotal | `boolean` | `true` | 否 | 是否显示总条数 | `inherited:Pagination` | `<Pagination :showTotal="false" :total="100" />` |
+| showGoto | `boolean` | `false` | 否 | 是否显示快速跳转框 | `inherited:Pagination` | `<Pagination showGoto :total="100" />` |
+| showLimits | `boolean` | `true` | 否 | 是否显示每页条数选择框 | `inherited:Pagination` | `<Pagination :showLimits="false" :total="100" />` |
+| disableBtn | `(page: number, limit: number) => boolean` | `undefined` | 否 | 禁用页码按钮的函数，"上一页""下一页"按钮依然可点 | `inherited:Pagination` | `<Pagination :disableBtn="(page) => page > 10" :total="200" /></Pagination>` |
+| disablePage | `(page: number, limit: number) => boolean` | `undefined` | 否 | 同时禁用页码按钮和"上一页""下一页"按钮的函数 | `inherited:Pagination` | `<Pagination :disablePage="(page) => page > 10" :total="200" /></Pagination>` |
+| modelValue | `number` | `undefined` | 否 | 当前页码 | - | - |
+| checkedKeys | `any[]` | `undefined` | 否 | 选中的行的 key 列表 | - | - |
+| checkedLength | `number` | `undefined` | 否 | 选中的总数量 | - | - |
+| showCheckedTotal | `boolean` | `true` | 否 | 是否显示选中统计信息 | - | - |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
 | change | `change` | 页码或每页条数改变时触发 | `data: { page: number, limit: number }` | `<PaginationPlus @change="onChange" />` |
 
-### 事件处理函数示例
-**change**:
+### 事件参数说明
+**change**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| data | `{ page: number, limit: number }` | 是 | - | 分页信息 |
+
+事件处理示例:
 ```typescript
 ({ page, limit }) => { params.page = page; }
 ```
 
+## 相关组件
+Pagination, ProTable
+

package/docs_for_llm/password.doc.md

@@ -0,0 +1,86 @@
+# 密码输入 (Password)
+
+面向密码录入的业务输入组件，内置校验能力和错误提示展示，适合实例登录密码、数据库密码等安全场景。
+
+**关键词**: password, password input, 密码输入, 密码校验, 数据库密码, 登录密码
+
+**使用场景**: 账号凭证录入、新建实例密码配置、数据库密码复杂度校验
+
+## 导入语句
+```typescript
+import { Password } from '@ksyun-internal/versatile';
+```
+
+## 属性 (Props)
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| modelValue | `string` | `undefined` | 否 | 当前密码值 | - | - |
+| validate | `string | Function` | `undefined` | 否 | 自定义校验函数或校验规则 | - | - |
+| errorMessage | `string` | `undefined` | 否 | 校验失败时的错误提示文案 | - | - |
+
+## 事件 (Events)
+| 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
+| --- | --- | --- | --- | --- |
+| update:modelValue | `@update:modelValue` | 密码内容变化时触发，可与父级表单或强度校验逻辑联动。 | `value?: string` | - |
+
+### 事件参数说明
+**update:modelValue**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `string` | 否 | - | 当前输入的密码值。 |
+
+## 使用示例
+### 实例登录密码录入
+**场景**: 在创建实例或重置密码时录入并校验登录密码。
+
+结合 validate 和错误提示控制密码输入质量。
+
+**使用的 API**: 属性: modelValue, validate, errorMessage | 事件: update:modelValue
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Password } from '@ksyun-internal/versatile';
+
+const password = ref('');
+const validate = (value: string) => /^(?=.*[A-Z])(?=.*\d).{8,}$/.test(value);
+</script>
+
+<template>
+  <Password
+    v-model="password"
+    :validate="validate"
+    error-message="至少 8 位，且必须包含大写字母和数字"
+  />
+</template>
+```
+
+### 数据库密码规则校验
+**场景**: 在数据库创建页中校验更严格的密码复杂度要求。
+
+通过自定义规则约束数据库密码长度和复杂度。
+
+**使用的 API**: 属性: modelValue, validate, errorMessage | 事件: update:modelValue
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Password } from '@ksyun-internal/versatile';
+
+const password = ref('');
+const validate = (value: string) => value.length >= 12 && /[A-Z]/.test(value) && /\d/.test(value);
+</script>
+
+<template>
+  <Password
+    v-model="password"
+    :validate="validate"
+    error-message="至少 12 位，并包含大写字母和数字"
+  />
+</template>
+```
+
+## 相关组件
+Input
+