king-design-analyzer 2.1.7 → 2.2.0

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,49 @@ 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） |
+
+**success**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| content | `string | VNode | Partial<MessageProps>` | 是 | - | 提示内容或配置对象 |
+| duration | `number` | 是 | - | 可选，显示时长（ms） |
+
+**warning**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| content | `string | VNode | Partial<MessageProps>` | 是 | - | 提示内容或配置对象 |
+| duration | `number` | 是 | - | 可选，显示时长（ms） |
+
+**error**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| content | `string | VNode | Partial<MessageProps>` | 是 | - | 提示内容或配置对象 |
+| duration | `number` | 是 | - | 可选，显示时长（ms） |
+
 ## 常见错误与正确用法 (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 +81,8 @@ Message.success('成功');`
 
 基本的消息提示
 
+**使用的 API**: 方法: info
+
 ```vue
 <script setup lang="ts">
 import { Button, Message } from '@king-design/vue';
@@ -67,6 +101,8 @@ const showMessage = () => {
 
 四种类型的消息提示
 
+**使用的 API**: 方法: success, warning, error, info
+
 ```vue
 <script setup lang="ts">
 import { Button, Message } from '@king-design/vue';
@@ -89,7 +125,7 @@ const showInfo = () => Message.info('提示信息');
 
 设置消息显示时长
 
-**使用的 API**: 属性: duration
+**使用的 API**: 属性: duration | 方法: info, warning
 
 ```vue
 <script setup lang="ts">
@@ -116,7 +152,7 @@ const showPermanent = () => {
 
 带关闭按钮的消息
 
-**使用的 API**: 属性: content, closable, duration
+**使用的 API**: 属性: content, closable, duration | 方法: info
 
 ```vue
 <script setup lang="ts">
@@ -140,7 +176,7 @@ const showMessage = () => {
 
 不显示图标的消息
 
-**使用的 API**: 属性: content, hideIcon
+**使用的 API**: 属性: content, hideIcon | 方法: success
 
 ```vue
 <script setup lang="ts">
@@ -163,6 +199,8 @@ const showMessage = () => {
 
 常见的 API 请求结果提示
 
+**使用的 API**: 方法: success, error
+
 ```vue
 <script setup lang="ts">
 import { ref } from 'vue';

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
+

package/docs_for_llm/popover.doc.md

@@ -12,77 +12,46 @@ import { Popover } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| title | `string | VNode` | `undefined` | 否 | 提示的标题 | `<Popover title="确认操作"></Popover>` |
-| content | `string | VNode` | `undefined` | 否 | 提示的内容 | `<Popover content="你确定要执行此操作吗？"></Popover>` |
-| type | `"info" | "success" | "error" | "warning"` | `undefined` | 否 | 提示的类型，不同类型显示不同的图标 | `<Popover type="warning"></Popover>` |
-| value | `boolean` | `false` | 否 | 是否展示弹层，可用 v-model 双向绑定 | `<Popover v-model="visible"></Popover>` |
-| disabled | `boolean` | `false` | 否 | 是否禁用组件 | `<Popover disabled></Popover>` |
-| position | `Position | "left" | "bottom" | "right" | "top"` | `{my: 'center bottom-10', at: 'center top', collision: 'flipfit'}` | 否 | 弹层弹出的位置，默认在触发器正上方 | `<Popover position="right"></Popover>` |
-| showArrow | `boolean` | `true` | 否 | 弹层是否展示箭头 | `<Popover :showArrow="false"></Popover>` |
-| always | `boolean` | `false` | 否 | 是否一直保持当前展示/隐藏状态 | `<Popover always></Popover>` |
-| size | `"default" | "small"` | `"default"` | 否 | 弹层尺寸 | `<Popover size="small"></Popover>` |
-| okText | `string` | `"确认"` | 否 | "确认"按钮文案 | `<Popover okText="是"></Popover>` |
-| cancelText | `string` | `"取消"` | 否 | "取消"按钮文案 | `<Popover cancelText="否"></Popover>` |
-| of | `"self" | "parent" | Event` | `"self"` | 否 | 弹出菜单的位置是相对当前触发元素还是父元素 | `<Popover of="parent"></Popover>` |
-| container | `string | ((parentDom: Element, anchor: Node | null) => Element)` | `undefined` | 否 | 指定弹出菜单追加的位置，默认追加到 body | `<Popover :container="() => document.body"></Popover>` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| title | `string | VNode` | `undefined` | 否 | 提示的标题 | - | `<Popover title="确认操作">` |
+| content | `string | VNode` | `undefined` | 否 | 提示的内容 | - | `<Popover content="你确定要执行此操作吗？">` |
+| type | `"info" | "success" | "error" | "warning"` | `undefined` | 否 | 提示的类型，不同类型显示不同的图标 | - | `<Popover type="warning">` |
+| value | `boolean` | `false` | 否 | 是否展示弹层，可用 v-model 双向绑定 | - | `<Popover v-model="visible">` |
+| disabled | `boolean` | `false` | 否 | 是否禁用组件 | - | `<Popover disabled>` |
+| position | `Position | "left" | "bottom" | "right" | "top"` | `{my: 'center bottom-10', at: 'center top', collision: 'flipfit'}` | 否 | 弹层弹出的位置，默认在触发器正上方 | - | `<Popover position="right">` |
+| collison | `Collision | [Collision, Collision]` | `undefined` | 否 | 碰撞检测策略，控制弹层超出边界时的处理方式。注意源码字段名拼写为 collison。 | - | `<Popover :collison="'flipfit'">` |
+| showArrow | `boolean` | `true` | 否 | 弹层是否展示箭头 | - | `<Popover :showArrow="false">` |
+| always | `boolean` | `false` | 否 | 是否一直保持当前展示/隐藏状态 | - | `<Popover always>` |
+| size | `"default" | "small"` | `"default"` | 否 | 弹层尺寸 | - | `<Popover size="small">` |
+| okText | `string` | `"确认"` | 否 | "确认"按钮文案 | - | `<Popover okText="是">` |
+| cancelText | `string` | `"取消"` | 否 | "取消"按钮文案 | - | `<Popover cancelText="否">` |
+| of | `"self" | "parent" | Event` | `"self"` | 否 | 弹出菜单的位置是相对当前触发元素还是父元素 | - | `<Popover of="parent">` |
+| container | `string | ((parentDom: Element, anchor: Node | null) => Element)` | `undefined` | 否 | 指定弹出菜单追加的位置，默认追加到 body | - | `<Popover :container="() => document.body">` |
+| alwaysShowOnClick | `boolean` | `false` | 否 | 不管什么触发方式，重复点击触发器都不隐藏弹层 | - | `<Popover alwaysShowOnClick>` |
 
 ## 事件 (Events)
 | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
 | --- | --- | --- | --- | --- |
-| show | `@show` | 弹层展示时触发 | `-` | `<Popover @show="handleShow"></Popover>` |
-| hide | `@hide` | 弹层隐藏时触发 | `-` | `<Popover @hide="handleHide"></Popover>` |
-| ok | `@ok` | 点击确认按钮时触发 | `-` | `<Popover @ok="handleOk"></Popover>` |
-| cancel | `@cancel` | 点击取消按钮时触发 | `-` | `<Popover @cancel="handleCancel"></Popover>` |
-
-### 事件处理函数示例
-**show**:
-```typescript
-const handleShow = () => {
-  console.log('弹层已展示');
-};
-```
-
-**hide**:
-```typescript
-const handleHide = () => {
-  console.log('弹层已隐藏');
-};
-```
-
-**ok**:
-```typescript
-const handleOk = () => {
-  Message.success('已确认');
-};
-```
-
-**cancel**:
-```typescript
-const handleCancel = () => {
-  console.log('已取消');
-};
-```
-
-## 插槽 (Slots)
-| 插槽名 | 说明 | 模板写法 | 示例 |
-| --- | --- | --- | --- |
-| title | 自定义提示标题 | `undefined` | - |
-| content | 自定义提示内容 | `undefined` | - |
-| footer | 自定义底部按钮 | `undefined` | - |
+| show | `@show` | 弹层展示时触发 | `-` | `<Popover @show="handleShow">` |
+| hide | `@hide` | 弹层隐藏时触发 | `-` | `<Popover @hide="handleHide">` |
+| ok | `@ok` | 点击确认按钮时触发 | `-` | `<Popover @ok="handleOk">` |
+| cancel | `@cancel` | 点击取消按钮时触发 | `-` | `<Popover @cancel="handleCancel">` |
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### 未提供触发元素
 > **错误用法**: `<Popover title="确认" content="内容" />`
 > **正确写法**: `<Popover title="确认" content="内容">
   <Button>点击</Button>
 </Popover>`
 > **说明**: Popover 需要包裹一个子元素作为触发器
 
+### position 值拼写错误
 > **错误用法**: `<Popover position="buttom">`
 > **正确写法**: `<Popover position="bottom">`
 > **说明**: position 只支持 top, bottom, left, right，注意拼写
 
+### 设置 type 但未显示图标
 > **错误用法**: `<Popover type="warning" content="警告内容">`
 > **正确写法**: `<Popover type="warning" title="警告" content="警告内容">`
 > **说明**: 建议同时设置 title 和 content，使提示更加清晰

package/docs_for_llm/progress.doc.md

@@ -12,26 +12,29 @@ import { Progress } from '@king-design/vue';
 ```
 
 ## 属性 (Props)
-| 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
-| --- | --- | --- | --- | --- | --- |
-| percent | `number | string` | `0` | 否 | 当前百分比 (0-100) | `<Progress :percent="50" />` |
-| type | `"bar" | "circle"` | `"bar"` | 否 | 进度条类型 | `<Progress type="circle" :percent="75" />` |
-| status | `"success" | "error" | "active" | "normal" | "warning"` | `"active"` | 否 | 进度条状态，决定颜色 | `<Progress :percent="100" status="success" />` |
-| size | `"default" | "small" | "mini"` | `"default"` | 否 | 进度条尺寸 | `<Progress :percent="50" size="small" />` |
-| showOuterText | `boolean` | `true` | 否 | 是否展示进度条后面的百分比文字 | `<Progress :percent="50" :showOuterText="false" />` |
-| showInnerText | `boolean` | `false` | 否 | 是否展示进度条上面的百分比文字 | `<Progress :percent="50" showInnerText />` |
-| strokeWidth | `number` | `10` | 否 | 圆形进度条的线条宽度，单位 px，只对 type="circle" 有效 | `<Progress type="circle" :percent="50" :strokeWidth="8" />` |
-| color | `string | Color[] | ((percent: number) => string)` | `undefined` | 否 | 进度条背景颜色，支持固定颜色、根据百分比的颜色数组或函数。会覆盖 status 设置的颜色 | `<Progress :percent="50" color="#8e44ad" />` |
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| percent | `number | string` | `0` | 否 | 当前百分比 (0-100) | - | `<Progress :percent="50" />` |
+| type | `"bar" | "circle"` | `"bar"` | 否 | 进度条类型 | - | `<Progress type="circle" :percent="75" />` |
+| status | `"success" | "error" | "active" | "normal" | "warning"` | `"active"` | 否 | 进度条状态，决定颜色 | - | `<Progress :percent="100" status="success" />` |
+| size | `"default" | "small" | "mini"` | `"default"` | 否 | 进度条尺寸 | - | `<Progress :percent="50" size="small" />` |
+| showOuterText | `boolean` | `true` | 否 | 是否展示进度条后面的百分比文字 | - | `<Progress :percent="50" :showOuterText="false" />` |
+| showInnerText | `boolean` | `false` | 否 | 是否展示进度条上面的百分比文字 | - | `<Progress :percent="50" showInnerText />` |
+| strokeWidth | `number` | `10` | 否 | 圆形进度条的线条宽度，单位 px，只对 type="circle" 有效 | - | `<Progress type="circle" :percent="50" :strokeWidth="8" />` |
+| color | `string | Color[] | ((percent: number) => string)` | `undefined` | 否 | 进度条背景颜色，支持固定颜色、根据百分比的颜色数组或函数。会覆盖 status 设置的颜色 | - | `<Progress :percent="50" color="#8e44ad" />` |
 
 ## 常见错误与正确用法 (Anti-Hallucination)
+### percent 使用字符串而非数字
 > **错误用法**: `<Progress percent="50" />`
 > **正确写法**: `<Progress :percent="50" />`
 > **说明**: percent 是数字类型，需要使用 v-bind 语法 (:percent)
 
+### percent 超出 0-100 范围
 > **错误用法**: `<Progress :percent="150" />`
 > **正确写法**: `<Progress :percent="100" />`
 > **说明**: percent 的有效范围是 0-100
 
+### 在条形进度条上使用 strokeWidth
 > **错误用法**: `<Progress type="bar" :percent="50" :strokeWidth="5" /> <!-- strokeWidth 无效 -->`
 > **正确写法**: `<Progress type="circle" :percent="50" :strokeWidth="5" />`
 > **说明**: strokeWidth 只对 type="circle" 圆形进度条有效

package/docs_for_llm/projects.doc.md

@@ -0,0 +1,91 @@
+# 项目选择 (Projects)
+
+用于拉取并选择当前账号项目归属的业务组件，适合在创建资源、共享资源和权限分配场景中选择项目上下文。
+
+**关键词**: projects, project selector, 项目选择, 项目归属, 资源所属项目, project select, 项目下拉, 项目切换
+
+**使用场景**: 项目归属选择、资源所属项目配置、按项目切换资源上下文、选择后联动项目实体信息
+
+## 导入语句
+```typescript
+import { Projects } from '@ksyun-internal/versatile';
+```
+
+## 属性 (Props)
+| 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
+| --- | --- | --- | --- | --- | --- | --- |
+| modelValue | `number` | `undefined` | 否 | 当前选中的项目 ID | - | - |
+| href | `string` | `undefined` | 否 | 跳转到项目管理页的链接 | - | - |
+
+## 事件 (Events)
+| 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
+| --- | --- | --- | --- | --- |
+| update:modelValue | `@update:modelValue` | 选中的项目 ID 变化时触发，适合与表单主值同步。 | `value?: number` | - |
+| update:project | `@update:project` | 选中的完整项目对象变化时触发，便于读取项目名称或配额信息。 | `value?: ProjectItem` | - |
+
+### 事件参数说明
+**update:modelValue**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `number` | 否 | - | 当前选中的项目 ID。 |
+
+**update:project**
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| value | `ProjectItem` | 否 | - | 当前选中的完整项目对象。 |
+
+## 使用示例
+### 选择资源所属项目
+**场景**: 在创建资源或授权时指定资源归属项目。
+
+在创建资源时把项目选择作为基础表单项。
+
+**使用的 API**: 属性: modelValue, href | 事件: update:modelValue, update:project
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Projects } from '@ksyun-internal/versatile';
+
+const projectId = ref(1001);
+</script>
+
+<template>
+  <Projects v-model="projectId" href="/project/list" />
+</template>
+```
+
+### 同步项目实体信息
+**场景**: 在选择项目后联动展示项目名称、配额或权限等附加信息。
+
+监听项目实体变化，在选择项目后立即拿到完整项目信息。
+
+**使用的 API**: 属性: modelValue, href | 事件: update:modelValue, update:project
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Projects } from '@ksyun-internal/versatile';
+
+const projectId = ref<number | undefined>(undefined);
+const projectName = ref('未选择');
+const handleProjectChange = (project: { name?: string }) => {
+  projectName.value = project?.name || '未选择';
+};
+</script>
+
+<template>
+  <Projects
+    v-model="projectId"
+    href="/project/list"
+    @update:project="handleProjectChange"
+  />
+  <div>当前项目：{{ projectName }}</div>
+</template>
+```
+
+## 相关组件
+Region, AZ
+