pit-docs-mcp 1.0.2

package/docs/pitBusinessUi/password-strength.md

@@ -0,0 +1,59 @@
+# pit-password-strength 密码强度指示器
+
+接收密码字符串，实时评估强度并以三段彩色进度条（弱/中/强）可视化展示，通常与密码输入框配合使用。
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value | 待评估的密码字符串 | String | `""` |
+
+## 强度评级规则
+
+| 条件（按优先级从上到下匹配） | 强度等级 | 显示 |
+| --- | --- | --- |
+| 长度 < 8 | 弱 | 🟥 弱 |
+| 纯数字 | 弱 | 🟥 弱 |
+| 纯字母 | 弱 | 🟥 弱 |
+| 数字 + 字母（无特殊字符） | 中 | 🟥🟨 弱·中 |
+| 数字 + 特殊字符（无字母） | 中 | 🟥🟨 弱·中 |
+| 字母 + 特殊字符（无数字） | 中 | 🟥🟨 弱·中 |
+| 数字 + 字母 + 特殊字符（全含） | 强 | 🟥🟨🟩 弱·中·强 |
+
+> 特殊字符：`!@#$%^&*()` 等非字母数字字符。
+
+## 示例
+
+### 搭配密码输入框
+
+```vue
+<el-form-item label="新密码" prop="newPassword">
+  <el-input
+    v-model="form.newPassword"
+    type="password"
+    show-password
+    placeholder="请输入新密码" />
+  <pit-password-strength :value="form.newPassword" />
+</el-form-item>
+```
+
+### 搭配表单验证（强度级别约束）
+
+```vue
+<el-input v-model="pwd" type="password" @input="checkStrength" />
+<pit-password-strength :value="pwd" />
+
+<script>
+methods: {
+  checkStrength(val) {
+    // 业务层自行判断：若 val 不含特殊字符或数字+字母组合，可提示用户加强密码
+  }
+}
+</script>
+```
+
+## 注意事项
+
+- 组件不输出强度级别值，若需在父组件中获取等级（用于表单校验），应在父组件中复写同一套判断逻辑或直接检查密码规则。
+- 连续满足多个条件时仅取最高级：如 `数字+字母+特殊字符` 直接显示**强**（3 段全亮）。
+- 最低安全推荐：≥8 位，含数字+字母+特殊字符（强级别）。

package/docs/pitBusinessUi/positive-number.md

@@ -0,0 +1,63 @@
+# pit-positive-number 正数输入框
+
+对 `el-input` 的封装，自动过滤非数值字符，支持小数精度、范围限制、允许负数开关。
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 绑定值 | String / Number | `""` |
+| clearable | 是否可清空 | Boolean | `true` |
+| decimal | 保留小数位数（不传则不限制） | Number | — |
+| min | 最小值 | String / Number | — |
+| max | 最大值 | String / Number | — |
+| negative | 是否允许输入负数 | Boolean | `false` |
+| rmNegative | 是否强制移除负号（二次过滤） | Boolean | `false` |
+
+> 清空后的默认值由 `$Business.positiveDefaultNumber` 控制（全局配置），默认为 `""`。
+>
+> 其余 `el-input` 属性通过 `v-bind="$attrs"` 透传，插槽通过动态 slot 透传。
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 值变化（v-model） | `String` |
+| change | 失焦后值确认 | `String` |
+
+## 示例
+
+### 基础正数输入（整数）
+
+```vue
+<pit-positive-number v-model="form.qty" />
+```
+
+### 最多 2 位小数，范围 0~100
+
+```vue
+<pit-positive-number
+  v-model="form.percent"
+  :decimal="2"
+  :min="0"
+  :max="100" />
+```
+
+### 允许负数（如温度）
+
+```vue
+<pit-positive-number v-model="form.temperature" :negative="true" :decimal="1" />
+```
+
+### 全局配置清空默认值
+
+```js
+// main.js
+Vue.use(PitBusinessUI, { positiveDefaultNumber: 0 })
+```
+
+## 注意事项
+
+- 组件本质是"字符串输入过滤"，`v-model` 绑定值类型为 `String`，提交前需自行转换为 `Number`。
+- `decimal` 为小数位限制（截断），不做四舍五入。
+- `negative + rmNegative` 同时为 `true` 时，`rmNegative` 优先，负号仍会被移除。

package/docs/pitBusinessUi/preview-image.md

@@ -0,0 +1,62 @@
+# pit-preview-image 图片查看器（全屏覆盖）
+
+基于 `el-image-viewer` 渲染全屏图片查看器叠加层，传入 URL 数组直接展示，关闭时 emit `close` 事件。
+
+## 与 PitImagePreview 的区别
+
+| 组件 | 输入 | 展示方式 |
+| --- | --- | --- |
+| PitImagePreview | 文件 ID（自动转 URL） | 内嵌图片 + 点击放大 |
+| PitPreviewImage | URL 数组（直接使用） | 全屏查看器叠加层 |
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| previewList | 图片 URL 数组 | Array | `[]` |
+
+> `el-image-viewer` 原生属性通过 `v-bind="$attrs"` 透传（如 `z-index`）。
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| close | 查看器关闭时触发 | — |
+
+## 示例
+
+```vue
+<template>
+  <div>
+    <el-button @click="openPreview">查看图片</el-button>
+    <pit-preview-image
+      v-if="previewVisible"
+      :preview-list="imageUrls"
+      @close="previewVisible = false" />
+  </div>
+</template>
+
+<script>
+export default {
+  data() {
+    return {
+      previewVisible: false,
+      imageUrls: []
+    }
+  },
+  methods: {
+    async openPreview() {
+      // 先获取 URL，再展示
+      const res = await this.$api.getImageUrls(this.fileIds)
+      this.imageUrls = res.data
+      this.previewVisible = true
+    }
+  }
+}
+</script>
+```
+
+## 注意事项
+
+- 组件自身不处理 ID 转 URL，调用方需提前完成转换后传入 URL 列表。
+- 通过 `v-if` 控制渲染/销毁（而非 `v-show`），关闭后组件内部 `showViewer` 会设为 `false`，需配合外部 `v-if` 完全移除。

package/docs/pitBusinessUi/preview-office.md

@@ -0,0 +1,50 @@
+# pit-preview-office Office 文件预览页
+
+独立路由页面组件，通过路由 query 参数接收预览 URL，在 `<iframe>` 中全屏渲染 Office 文件预览，支持水印叠加。
+
+> **注意**：本组件是一个**独立路由页面**（非嵌入组件），由 `pit-business-ui` 安装时通过 `router.addRoutes` 自动注册路由 `/previewOffice_0X1`，通常不直接 `<pit-preview-office>` 引用，而是通过导航跳转打开。
+
+## 路由注册
+
+安装 `PitBusinessUI` 时自动注册（无需手动配置）：
+
+```
+路径：/previewOffice_0X1
+Query 参数：
+  url        - encodeURIComponent 编码的预览 URL（必填）
+  watermark  - encodeURIComponent 编码的水印配置 JSON（选填）
+```
+
+## 水印配置
+
+`watermark` 参数为 JSON 字符串（encodeURIComponent 编码），对应 `watermark-dom` 的选项：
+
+```json
+{
+  "text": "张三 2026-03-05",
+  "watermark_alpha": 0.2,
+  "watermark_angle": 15
+}
+```
+
+若 `text` 为空字符串，不叠加水印。
+
+## 打开方式
+
+```js
+// 新窗口打开 Office 文件预览
+const url = encodeURIComponent('https://your-preview-service/file.pdf')
+const watermark = encodeURIComponent(JSON.stringify({
+  text: `${userInfo.username} ${dayjs().format('YYYY-MM-DD HH:mm:ss')}`
+}))
+window.open(`/previewOffice_0X1?url=${url}&watermark=${watermark}`, '_blank')
+
+// 或通过 $openFilePreview 间接触发（推荐，业务层不直接操作路由）
+this.$openFilePreview(fileId, 'office')
+```
+
+## 注意事项
+
+- 组件挂载时调用 `watermark-dom` 叠加水印，销毁时自动清除。
+- `url` 参数在组件 `data` 中通过 `decodeURIComponent(this.$route.query.url)` 解析，请确保编码正确。
+- 若项目使用 Hash 路由（`history: createWebHashHistory()`），路径前需加 `/#`。

package/docs/pitBusinessUi/preview.md

@@ -0,0 +1,57 @@
+# pit-preview 文件预览（弹窗）
+
+根据文件类型自动路由到对应预览方式：图片调用 `$openFilePreview`，视频用内置 `<video>` 标签，文档（PDF/Office）和 BIM 模型在弹窗中渲染。
+
+## 前置依赖
+
+- `this.$openFilePreview` — 图片预览全局方法（由 `pit-business-ui` 注册）
+- `pit-business-utils` — `reqOssInfo`、`reqOssPresignedObjectUrl`、`fileType`
+- `PitDocumentPreview` — 文档预览组件（内部自动引用）
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| visible / .sync | 是否显示弹窗 | Boolean | `false` |
+| fileObj | 文件对象（含 `fileUploadRecordId`、`originalFilename`、`format` 等字段） | Object | `{}` |
+| isOpen | 是否以外部新窗口打开（`true` 时不渲染弹窗，直接调用外部预览） | Boolean | `true` |
+| previewType | 预览方式：`"preview"` / `"openFilePreview"` | String | `"preview"` |
+
+## 文件类型路由
+
+| 文件类型 | 处理方式 |
+| --- | --- |
+| `image` | 调用 `this.$openFilePreview(id, 'url')` |
+| `video` | 弹窗内嵌 `<video>` 标签 |
+| `document` | 弹窗内嵌 `PitDocumentPreview` |
+| `bimModel` | 弹窗内嵌 BIM 查看器（需 bimUrl/bimToken cookie） |
+
+## 示例
+
+```vue
+<el-button @click="openPreview(row)">预览</el-button>
+
+<pit-preview
+  :visible.sync="previewVisible"
+  :file-obj="currentFile"
+  :is-open="false" />
+
+<script>
+methods: {
+  openPreview(row) {
+    this.currentFile = {
+      fileUploadRecordId: row.fileId,
+      originalFilename: row.fileName,
+      format: row.fileFormat
+    }
+    this.previewVisible = true
+  }
+}
+</script>
+```
+
+## 注意事项
+
+- `fileObj.format` 决定渲染分支，请确保传入正确的文件扩展名（如 `"pdf"`、`"mp4"`、`"docx"` 等）。
+- 图片类型不显示弹窗，`visible` 会自动关闭，预览通过 `$openFilePreview` 完成。
+- `isOpen=true` 时组件模板输出为空，直接在 `created` 阶段调用外部预览，需配合 `v-if` 避免无效渲染。

package/docs/pitBusinessUi/quill.md

@@ -0,0 +1,52 @@
+# pit-quill 富文本编辑器（Quill）
+
+基于 `vue-quill-editor` 封装的富文本编辑器，提供 Snow 主题工具栏，值失焦时更新（`blur` 触发 `input`）。
+
+## 前置依赖
+
+- `vue-quill-editor`
+- `quill`（CSS：`quill.core.css`、`quill.snow.css`）
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 编辑器 HTML 内容 | String | `""` |
+| placeholder | 占位文字 | String | 国际化默认值 |
+| prefixCls | 根元素 class 前缀 | String | `"pit-editor-quill"` |
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 编辑器失焦时触发（v-model） | `String`（HTML） |
+
+## 工具栏功能
+
+加粗、斜体、下划线、删除线、标题（H1-H6）、字号、字体颜色/背景色、引用、代码块、有序/无序列表、缩进、对齐、文字方向（RTL）、清除格式、链接、图片。
+
+## 示例
+
+```vue
+<pit-quill v-model="form.content" />
+
+<pit-quill
+  v-model="form.remark"
+  placeholder="请输入备注信息" />
+```
+
+## 与 PitEditor 的区别
+
+| 特性 | PitEditor（WangEditor） | PitQuill |
+| --- | --- | --- |
+| 底层库 | `@wangeditor/editor-for-vue` | `vue-quill-editor` |
+| 图片/视频上传 | ✅ 内置 OSS 上传 | ❌ 仅 base64 嵌入 |
+| 禁用/只读 | ✅ `disabled` prop | ❌ 无（需自行覆盖样式） |
+| 值更新时机 | 实时（`onChange`） | 失焦（`blur`） |
+
+> 推荐新项目使用 `PitEditor`；`PitQuill` 适用于兼容老项目的场景。
+
+## 注意事项
+
+- `input` 事件仅在 **失焦（blur）** 时触发，若需实时同步内容，可监听 Quill 原生 `text-change` 事件（通过 `this.$refs.myQuillEditor.quill`）。
+- `placeholder` prop 变化时会自动更新编辑器选项。

package/docs/pitBusinessUi/runflow-btn.md

@@ -0,0 +1,52 @@
+# pit-runflow-btn 流程发起按钮
+
+根据路由元信息和审批状态决定是否渲染的流程发起按钮，支持 Loading 状态，事件通过 `v-on="$listeners"` 透传。
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| text | 按钮文字 | String | 国际化"发起流程" |
+| loading | 是否加载中 | Boolean | `false` |
+| approvalStatus | 当前审批状态（决定按钮是否显示） | String | `""` |
+
+## 显示条件
+
+按钮仅在同时满足以下两个条件时渲染：
+
+1. `this.$route.meta.hasFlow === true`（路由配置了流程）
+2. `approvalStatus` 在 `["", null, "draft", "reject", "withdraw", "termination"]` 中
+
+## Events
+
+所有事件通过 `v-on="$listeners"` 透传，主要监听 `@click`：
+
+| 事件名 | 说明 |
+| --- | --- |
+| click | 按钮点击 |
+
+## 示例
+
+### 基础用法
+
+```vue
+<pit-runflow-btn
+  :approval-status="form.approvalStatus"
+  :loading="submitting"
+  @click="submitFlow" />
+```
+
+### 自定义文字
+
+```vue
+<pit-runflow-btn
+  text="提交审批"
+  :approval-status="form.approvalStatus"
+  @click="handleSubmit" />
+```
+
+## 注意事项
+
+- 路由元信息需配置 `meta.hasFlow = true`，否则按钮始终不显示。
+- 当 `approvalStatus` 为 `"auditing"`（审批中）、`"approved"`（已通过）等状态时，按钮自动隐藏，无需在业务端手动控制。
+- `loading` 状态需由父组件自行管理（在点击处理函数中设置/清除），与 `PitLoadingBtn` 不同（后者自动管理）。

package/docs/pitBusinessUi/search-date-picker.md

@@ -0,0 +1,60 @@
+# pit-search-date-picker 搜索日期选择器
+
+专为列表页搜索条件设计的日期区间选择器，内置"近 N 天"快捷选项，支持正向/逆向快捷方式切换。
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 绑定值（日期字符串数组 `[start, end]`） | Array | `[]` |
+| type | 选择器类型 | String | `"daterange"` |
+| valueFormat | 绑定值格式 | String | `"yyyy-MM-dd"` |
+| startPlaceholder | 开始日期占位文本 | String | `"开始日期"` |
+| endPlaceholder | 结束日期占位文本 | String | `"结束日期"` |
+| clearable | 是否可清空 | Boolean | `true` |
+| startTime | 开始时间，支持 `.sync` | String | `""` |
+| endTime | 结束时间，支持 `.sync` | String | `""` |
+| isForwardQuery | `true` 显示"过去 N 天"快捷项；`false` 显示"未来 N 天"快捷项 | Boolean | `true` |
+| isExcludeInternationalize | 是否跳过国际化时区转换 | Boolean | `false` |
+
+> 其余 `el-date-picker` 属性通过 `v-bind="$attrs"` 透传（不含 `editable`，已固定为 `false`）。
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 值变化（v-model） | `Array` `[startStr, endStr]` |
+| update:startTime | 开始时间变化，配合 `.sync` | `String` |
+| update:endTime | 结束时间变化，配合 `.sync` | `String` |
+
+## 内置快捷选项
+
+**isForwardQuery = true（默认）**：近 1 周、近 2 周、近 1 月、近 3 月、近半年、近 1 年
+
+**isForwardQuery = false**：未来 1 周、未来 2 周、未来 1 月、未来 3 月、未来半年、未来 1 年
+
+## 示例
+
+### 基础搜索日期区间
+
+```vue
+<pit-search-date-picker
+  v-model="query.dateRange"
+  :start-time.sync="query.startDate"
+  :end-time.sync="query.endDate" />
+```
+
+### 未来日期快捷选项（如计划日期）
+
+```vue
+<pit-search-date-picker
+  v-model="query.planRange"
+  :is-forward-query="false"
+  :start-time.sync="query.planStart"
+  :end-time.sync="query.planEnd" />
+```
+
+## 注意事项
+
+- 该组件 `editable` 固定为 `false`（不可手动输入），仅支持面板选择或使用快捷选项。
+- 与 `PitAddDatePicker` 的区别：本组件快捷选项面向"历史查询"，后者面向"新增计划（未来）"。

package/docs/pitBusinessUi/select-bid-list.md

@@ -0,0 +1,66 @@
+# pit-select-bid-list 标段列表选择器（弹窗）
+
+弹窗形式的标段选择器，通过内部表格（`el-form-base`）分页查询并选择标段，支持按标段名称搜索。
+
+## 前置依赖
+
+- `localStorage.projectId` — 当前项目 ID
+- `this.$route.meta.bidType` — 路由元信息中的标段类型
+- 后端接口：`/api/project/pj-bid-entity/List`
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 已选标段 ID | String | `""` |
+| initInnerValue | 回显用的标段名称（显示在触发输入框中） | String | `""` |
+| currencyId | 货币 ID（预留，传递给查询接口） | String | `""` |
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 值变化（v-model） | `String`（标段 ID） |
+| change | 表格行确认选中 | `rowData`（标段完整对象） |
+
+## Methods
+
+| 方法名 | 说明 |
+| --- | --- |
+| `open()` | 用 ref 调用，手动打开弹窗 |
+
+## 示例
+
+### 嵌入表单
+
+```vue
+<el-form-item label="标段" prop="bidId">
+  <pit-input
+    v-model="form.bidName"
+    readonly
+    placeholder="请选择标段"
+    @click.native="$refs.bidList.open()">
+    <i slot="suffix" class="el-icon-arrow-down" />
+  </pit-input>
+  <pit-select-bid-list
+    ref="bidList"
+    v-model="form.bidId"
+    :init-inner-value="form.bidName"
+    @change="onBidSelected" />
+</el-form-item>
+
+<script>
+methods: {
+  onBidSelected(row) {
+    this.form.bidName = row.bidName
+    this.form.bidCode = row.bidCode
+  }
+}
+</script>
+```
+
+## 注意事项
+
+- 弹窗内查询参数自动读取 `localStorage.projectId` 和 `this.$route.meta.*`，使用本组件前需保证路由元信息配置正确。
+- 表格样式高度通过 `this.$Business.selectBidListStyle` 全局配置（默认 `{ height: '461px' }`）。
+- 与 `PitSelectSection` 的区别：本组件为弹窗表格形式，适合需要展示更多标段信息（编号、合同单位等）的场景。

package/docs/pitBusinessUi/select-color.md

@@ -0,0 +1,38 @@
+# pit-select-color 颜色选择器
+
+使用 `vue-color` Chrome 面板选取颜色，以十六进制 HEX 字符串作为绑定值，支持清空。
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 颜色值（HEX 字符串，如 `"#ff0000"`） | String | `""` |
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 值变化（v-model） | `String`（HEX） |
+
+## 示例
+
+### 基础用法
+
+```vue
+<pit-select-color v-model="form.labelColor" />
+```
+
+### 在表单中使用
+
+```vue
+<el-form-item label="节点颜色" prop="color">
+  <pit-select-color v-model="form.color" />
+</el-form-item>
+```
+
+## 注意事项
+
+- 颜色面板通过 Popover 展示，点击输入框或色块触发。
+- 点击"清空"将值响应为 `""`，色块消失。  
+- 点击"取消"关闭面板且不更新值；点击"确认"才提交新选颜色。
+- 组件注入了 `elForm`，在 `el-form` 的 `disabled` 状态下，点击不会打开颜色面板。

package/docs/pitBusinessUi/select-contract-tree.md

@@ -0,0 +1,41 @@
+# pit-select-contract-tree 合同树选择器
+
+自动拉取合同树数据的树形下拉，展示字段优先 `contractShortName`（合同短名称），其次 `contractName`，节点键为 `id`。
+
+## 前置依赖
+
+- `localStorage.projectId` — 当前项目 ID
+- 后端接口：`/api/contract/contract-metering/getContractNameList`
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 已选合同 ID（逗号分隔字符串） | String | `null` |
+| multiple | 是否多选 | Boolean | `false` |
+| disabled | 是否禁用 | Boolean | `false` |
+| clearable | 是否可清空 | Boolean | `true` |
+| appendToBody | 下拉插入 body | Boolean | `true` |
+| isSelectedFirstVal | 自动选中第一个 | Boolean | `false` |
+| callback | 选中回调 | Function | `() => {}` |
+| filterType | 合同过滤类型（`"filterNoCycle"` 过滤无周期合同） | String | `""` |
+| contractBidSG | 是否过滤施工标合同 | Boolean | `null` |
+| type | 合同类型筛选 | String | `""` |
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 值变化（v-model） | `value` |
+| change | 值变化 | `value, nodeData` |
+
+## 示例
+
+```vue
+<pit-select-contract-tree v-model="form.contractId" />
+
+<!-- 过滤掉没有计量周期的合同 -->
+<pit-select-contract-tree
+  v-model="form.contractId"
+  filter-type="filterNoCycle" />
+```

package/docs/pitBusinessUi/select-dept.md

@@ -0,0 +1,38 @@
+# pit-select-dept 部门选择器
+
+自动拉取与标段关联的部门/组织机构树，基于 `PitTreeSelectPlus`，字段 label 为 `organizationName`，节点键为 `id`。
+
+## 前置依赖
+
+- `localStorage.projectId` — 当前项目 ID
+- 后端接口：`getDeptRelationBidList`
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 已选部门 ID（逗号分隔字符串） | String | `null` |
+| multiple | 是否多选 | Boolean | `false` |
+| disabled | 是否禁用 | Boolean | `false` |
+| clearable | 是否可清空 | Boolean | `true` |
+| appendToBody | 下拉插入 body | Boolean | `true` |
+| isSelectedFirstVal | 自动选中第一个 | Boolean | `false` |
+| callback | 选中回调 | Function | `() => {}` |
+| filterType | 数据过滤类型 | String | `""` |
+| contractBidSG | 是否过滤施工标数据 | Boolean | `null` |
+| type | 额外类型参数 | String | `""` |
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 值变化（v-model） | `value` |
+| change | 值变化 | `value, nodeData` |
+
+## 示例
+
+```vue
+<pit-select-dept v-model="form.deptId" />
+
+<pit-select-dept v-model="form.deptIds" multiple is-all />
+```