From 448f073143bf2aa527a6f2a0c54bfa6a494bae44 Mon Sep 17 00:00:00 2001
From: YunaiV <zhijiantianya@gmail.com>
Date: Thu, 29 Jan 2026 21:20:24 +0800
Subject: [PATCH] =?UTF-8?q?review=EF=BC=9A=E3=80=90antd/ele=E3=80=91?=
 =?UTF-8?q?=E3=80=90bpm=E3=80=91=E5=B7=A5=E4=BD=9C=E6=B5=81=E7=9B=B8?=
 =?UTF-8?q?=E5=85=B3=E7=9A=84=E4=BB=A3=E7=A0=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../form-create/components/dept-select.vue    | 51 ++++++++----------
 .../src/components/form-create/helpers.ts     |  4 +-
 .../form-create/components/dept-select.vue    | 52 +++++++++----------
 .../src/components/form-create/helpers.ts     |  4 +-
 .../penal/task/task-components/UserTask.vue   |  1 -
 .../nodes-config/user-task-node-config.vue    |  2 +
 .../simple-process-design/helpers.ts          |  1 +
 .../components/simple-process-design/index.ts |  1 +
 .../model/form/modules/bpm-model-editor.vue   |  1 +
 .../components/select-modal.vue               |  1 +
 .../bpm/processListener/components/data.ts    |  1 +
 .../components/select-modal.vue               |  1 +
 12 files changed, 59 insertions(+), 61 deletions(-)

diff --git a/apps/web-antd/src/components/form-create/components/dept-select.vue b/apps/web-antd/src/components/form-create/components/dept-select.vue
index 9f70ff0aa..98fa25490 100644
--- a/apps/web-antd/src/components/form-create/components/dept-select.vue
+++ b/apps/web-antd/src/components/form-create/components/dept-select.vue
@@ -1,4 +1,4 @@
-<!-- 部门选择器 - 树形结构显示 (Ant Design Vue 版本) -->
+<!-- 部门选择器 - 树形结构显示 -->
 <script lang="ts" setup>
 import { onMounted, ref, watch } from 'vue';
 
@@ -26,7 +26,8 @@ const emit = defineEmits<{
   ): void;
 }>();
 
-// 部门数据接口
+// todo @puhui999：是不是可以简化，使用 api 的；
+/** 部门数据接口 */
 interface DeptVO {
   id: number;
   name: string;
@@ -38,7 +39,8 @@ interface DeptVO {
   status?: number;
 }
 
-// 接受父组件参数
+// TODO @puhui999：linter 报错；
+/** 接受父组件参数 */
 interface Props {
   modelValue?: number | number[] | string | string[];
   multiple?: boolean;
@@ -49,14 +51,11 @@ interface Props {
   formCreateInject?: any;
 }
 
-// 部门树形数据
-const deptTree = ref<any[]>([]);
-// 原始部门列表（用于 returnType='name' 时查找名称）
-const deptList = ref<DeptVO[]>([]);
-// 当前选中值
-const selectedValue = ref<number | number[] | undefined>();
+const deptTree = ref<any[]>([]); // 部门树形数据
+const deptList = ref<DeptVO[]>([]); // 原始部门列表（用于 returnType='name' 时查找名称）
+const selectedValue = ref<number | number[] | undefined>(); // 当前选中值
 
-// 加载部门树形数据
+/** 加载部门树形数据 */
 async function loadDeptTree(): Promise<void> {
   try {
     const data = await requestClient.get<DeptVO[]>('/system/dept/simple-list');
@@ -68,22 +67,22 @@ async function loadDeptTree(): Promise<void> {
   }
 }
 
-// 根据 ID 获取部门名称
+/** 根据 ID 获取部门名称 */
 function getDeptNameById(id: number): string | undefined {
-  const dept = deptList.value.find((item) => item.id === id);
+  const dept = deptList.value.find((item: DeptVO) => item.id === id);
   if (!dept) {
     console.warn(`[DeptSelect] 未找到 ID 为 ${id} 的部门`);
   }
   return dept?.name;
 }
 
-// 根据名称获取部门 ID
+/** 根据名称获取部门 ID */
 function getDeptIdByName(name: string): number | undefined {
-  const dept = deptList.value.find((item) => item.name === name);
+  const dept = deptList.value.find((item: DeptVO) => item.name === name);
   return dept?.id;
 }
 
-// 处理选中值变化
+/** 处理选中值变化 */
 function handleChange(value: number | number[] | undefined): void {
   if (value === undefined || value === null) {
     emit('update:modelValue', props.multiple ? [] : undefined);
@@ -106,13 +105,13 @@ function handleChange(value: number | number[] | undefined): void {
   }
 }
 
-// 树节点过滤方法（支持搜索过滤）
+/** 树节点过滤方法（支持搜索过滤） */
 function filterTreeNode(inputValue: string, treeNode: any): boolean {
   if (!inputValue) return true;
   return treeNode.name?.toLowerCase().includes(inputValue.toLowerCase());
 }
 
-// 同步 modelValue 到内部选中值
+/** 同步 modelValue 到内部选中值 */
 function syncSelectedValue(): void {
   const newValue = props.modelValue;
   if (newValue === undefined || newValue === null) {
@@ -127,26 +126,24 @@ function syncSelectedValue(): void {
       return;
     }
     if (props.multiple && Array.isArray(newValue)) {
-      const ids = (newValue as string[])
+      selectedValue.value = (newValue as string[])
         .map((name) => getDeptIdByName(name))
         .filter(Boolean) as number[];
-      selectedValue.value = ids;
     } else if (!props.multiple && typeof newValue === 'string') {
-      const id = getDeptIdByName(newValue);
-      selectedValue.value = id;
+      selectedValue.value = getDeptIdByName(newValue);
     }
   } else {
     selectedValue.value = newValue as number | number[];
   }
 }
 
-// 监听 modelValue 变化，同步到内部选中值
+/** 监听 modelValue 变化，同步到内部选中值 */
 watch(() => props.modelValue, syncSelectedValue, { immediate: true });
 
-// 监听 deptList 变化，重新同步选中值（解决数据加载完成后的回显问题）
+/** 监听 deptList 变化，重新同步选中值（解决数据加载完成后的回显问题） */
 watch(() => deptList.value, syncSelectedValue);
 
-// 检查是否有有效的预设值
+/** 检查是否有有效的预设值 */
 function hasValidPresetValue(): boolean {
   const value = props.modelValue;
   if (value === undefined || value === null || value === '') {
@@ -158,13 +155,12 @@ function hasValidPresetValue(): boolean {
   return true;
 }
 
-// 设置默认值（当前用户部门）
+/** 设置默认值（当前用户部门） */
 function setDefaultValue(): void {
   // 仅当 defaultCurrentDept 为 true 时处理
   if (!props.defaultCurrentDept) {
     return;
   }
-
   // 检查是否已有预设值（预设值优先级高于默认当前部门）
   if (hasValidPresetValue()) {
     return;
@@ -173,7 +169,6 @@ function setDefaultValue(): void {
   // 获取当前用户的部门 ID
   const userStore = useUserStore();
   const deptId = userStore.userInfo?.deptId as number | undefined;
-
   // 处理 deptId 为空或 0 的边界情况
   if (!deptId || deptId === 0) {
     return;
@@ -184,7 +179,7 @@ function setDefaultValue(): void {
   emit('update:modelValue', defaultValue);
 }
 
-// 组件挂载时加载数据并设置默认值
+/** 组件挂载时加载数据并设置默认值 */
 onMounted(async () => {
   await loadDeptTree();
   // 数据加载完成后设置默认值
diff --git a/apps/web-antd/src/components/form-create/helpers.ts b/apps/web-antd/src/components/form-create/helpers.ts
index f04638945..010d27afc 100644
--- a/apps/web-antd/src/components/form-create/helpers.ts
+++ b/apps/web-antd/src/components/form-create/helpers.ts
@@ -194,7 +194,7 @@ export async function useFormCreateDesigner(designer: Ref) {
         type: 'switch',
         field: 'defaultCurrentUser',
         title: '默认选中当前用户',
-        value: true,
+        value: false,
       },
     ],
   });
@@ -217,7 +217,7 @@ export async function useFormCreateDesigner(designer: Ref) {
         type: 'switch',
         field: 'defaultCurrentDept',
         title: '默认选中当前部门',
-        value: true,
+        value: false,
       },
     ],
   });
diff --git a/apps/web-ele/src/components/form-create/components/dept-select.vue b/apps/web-ele/src/components/form-create/components/dept-select.vue
index ffe3a7c75..073d30767 100644
--- a/apps/web-ele/src/components/form-create/components/dept-select.vue
+++ b/apps/web-ele/src/components/form-create/components/dept-select.vue
@@ -1,4 +1,4 @@
-<!-- 部门选择器 - 树形结构显示 (Element Plus 版本) -->
+<!-- 部门选择器 - 树形结构显示 -->
 <script lang="ts" setup>
 import { onMounted, ref, watch } from 'vue';
 
@@ -26,7 +26,8 @@ const emit = defineEmits<{
   ): void;
 }>();
 
-// 部门数据接口
+// todo @puhui999：是不是可以简化，使用 api 的；
+/** 部门数据接口 */
 interface DeptVO {
   id: number;
   name: string;
@@ -38,7 +39,8 @@ interface DeptVO {
   status?: number;
 }
 
-// 接受父组件参数
+// TODO @puhui999：linter 报错；
+/** 接受父组件参数 */
 interface Props {
   modelValue?: number | number[] | string | string[];
   multiple?: boolean;
@@ -49,6 +51,7 @@ interface Props {
   formCreateInject?: any;
 }
 
+// TODO @AI：可以使用 element plus 自带的对象么？
 // Element Plus TreeSelect 的 props 配置
 const treeProps = {
   label: 'name',
@@ -56,14 +59,11 @@ const treeProps = {
   children: 'children',
 };
 
-// 部门树形数据
-const deptTree = ref<any[]>([]);
-// 原始部门列表（用于 returnType='name' 时查找名称）
-const deptList = ref<DeptVO[]>([]);
-// 当前选中值
-const selectedValue = ref<number | number[] | undefined>();
+const deptTree = ref<any[]>([]); // 部门树形数据
+const deptList = ref<DeptVO[]>([]); // 原始部门列表（用于 returnType='name' 时查找名称）
+const selectedValue = ref<number | number[] | undefined>(); // 当前选中值
 
-// 加载部门树形数据
+/** 加载部门树形数据 */
 async function loadDeptTree(): Promise<void> {
   try {
     const data = await requestClient.get<DeptVO[]>('/system/dept/simple-list');
@@ -75,22 +75,22 @@ async function loadDeptTree(): Promise<void> {
   }
 }
 
-// 根据 ID 获取部门名称
+/** 根据 ID 获取部门名称 */
 function getDeptNameById(id: number): string | undefined {
-  const dept = deptList.value.find((item) => item.id === id);
+  const dept = deptList.value.find((item: DeptVO) => item.id === id);
   if (!dept) {
     console.warn(`[DeptSelect] 未找到 ID 为 ${id} 的部门`);
   }
   return dept?.name;
 }
 
-// 根据名称获取部门 ID
+/** 根据名称获取部门 ID */
 function getDeptIdByName(name: string): number | undefined {
-  const dept = deptList.value.find((item) => item.name === name);
+  const dept = deptList.value.find((item: DeptVO) => item.name === name);
   return dept?.id;
 }
 
-// 处理选中值变化
+/** 处理选中值变化 */
 function handleChange(value: number | number[] | undefined): void {
   if (value === undefined || value === null) {
     emit('update:modelValue', props.multiple ? [] : undefined);
@@ -113,13 +113,13 @@ function handleChange(value: number | number[] | undefined): void {
   }
 }
 
-// 树节点过滤方法（支持搜索过滤）
+/** 树节点过滤方法（支持搜索过滤） */
 function filterNode(value: string, data: any): boolean {
   if (!value) return true;
   return data.name?.toLowerCase().includes(value.toLowerCase());
 }
 
-// 同步 modelValue 到内部选中值
+/** 同步 modelValue 到内部选中值 */
 function syncSelectedValue(): void {
   const newValue = props.modelValue;
   if (newValue === undefined || newValue === null) {
@@ -134,26 +134,24 @@ function syncSelectedValue(): void {
       return;
     }
     if (props.multiple && Array.isArray(newValue)) {
-      const ids = (newValue as string[])
+      selectedValue.value = (newValue as string[])
         .map((name) => getDeptIdByName(name))
         .filter(Boolean) as number[];
-      selectedValue.value = ids;
     } else if (!props.multiple && typeof newValue === 'string') {
-      const id = getDeptIdByName(newValue);
-      selectedValue.value = id;
+      selectedValue.value = getDeptIdByName(newValue);
     }
   } else {
     selectedValue.value = newValue as number | number[];
   }
 }
 
-// 监听 modelValue 变化，同步到内部选中值
+/** 监听 modelValue 变化，同步到内部选中值 */
 watch(() => props.modelValue, syncSelectedValue, { immediate: true });
 
-// 监听 deptList 变化，重新同步选中值（解决数据加载完成后的回显问题）
+/** 监听 deptList 变化，重新同步选中值（解决数据加载完成后的回显问题） */
 watch(() => deptList.value, syncSelectedValue);
 
-// 检查是否有有效的预设值
+/** 检查是否有有效的预设值 */
 function hasValidPresetValue(): boolean {
   const value = props.modelValue;
   if (value === undefined || value === null || value === '') {
@@ -165,13 +163,12 @@ function hasValidPresetValue(): boolean {
   return true;
 }
 
-// 设置默认值（当前用户部门）
+/** 设置默认值（当前用户部门） */
 function setDefaultValue(): void {
   // 仅当 defaultCurrentDept 为 true 时处理
   if (!props.defaultCurrentDept) {
     return;
   }
-
   // 检查是否已有预设值（预设值优先级高于默认当前部门）
   if (hasValidPresetValue()) {
     return;
@@ -180,7 +177,6 @@ function setDefaultValue(): void {
   // 获取当前用户的部门 ID
   const userStore = useUserStore();
   const deptId = userStore.userInfo?.deptId as number | undefined;
-
   // 处理 deptId 为空或 0 的边界情况
   if (!deptId || deptId === 0) {
     return;
@@ -191,7 +187,7 @@ function setDefaultValue(): void {
   emit('update:modelValue', defaultValue);
 }
 
-// 组件挂载时加载数据并设置默认值
+/** 组件挂载时加载数据并设置默认值 */
 onMounted(async () => {
   await loadDeptTree();
   // 数据加载完成后设置默认值
diff --git a/apps/web-ele/src/components/form-create/helpers.ts b/apps/web-ele/src/components/form-create/helpers.ts
index dbe938a5e..a7d750a99 100644
--- a/apps/web-ele/src/components/form-create/helpers.ts
+++ b/apps/web-ele/src/components/form-create/helpers.ts
@@ -194,7 +194,7 @@ export async function useFormCreateDesigner(designer: Ref) {
         type: 'switch',
         field: 'defaultCurrentUser',
         title: '默认选中当前用户',
-        value: true,
+        value: false,
       },
     ],
   });
@@ -217,7 +217,7 @@ export async function useFormCreateDesigner(designer: Ref) {
         type: 'switch',
         field: 'defaultCurrentDept',
         title: '默认选中当前部门',
-        value: true,
+        value: false,
       },
     ],
   });
diff --git a/apps/web-ele/src/views/bpm/components/bpmn-process-designer/package/penal/task/task-components/UserTask.vue b/apps/web-ele/src/views/bpm/components/bpmn-process-designer/package/penal/task/task-components/UserTask.vue
index b2b33fda4..632505a83 100644
--- a/apps/web-ele/src/views/bpm/components/bpmn-process-designer/package/penal/task/task-components/UserTask.vue
+++ b/apps/web-ele/src/views/bpm/components/bpmn-process-designer/package/penal/task/task-components/UserTask.vue
@@ -43,7 +43,6 @@ import {
   MULTI_LEVEL_DEPT,
 } from '#/views/bpm/components/simple-process-design/consts';
 import { useFormFieldsPermission } from '#/views/bpm/components/simple-process-design/helpers';
-// TODO @jason：antd 是不是导入对齐这个？
 import { ProcessExpressionSelectModal } from '#/views/bpm/processExpression/components';
 
 defineOptions({ name: 'UserTask' });
diff --git a/apps/web-ele/src/views/bpm/components/simple-process-design/components/nodes-config/user-task-node-config.vue b/apps/web-ele/src/views/bpm/components/simple-process-design/components/nodes-config/user-task-node-config.vue
index 41f232fe1..496d4a867 100644
--- a/apps/web-ele/src/views/bpm/components/simple-process-design/components/nodes-config/user-task-node-config.vue
+++ b/apps/web-ele/src/views/bpm/components/simple-process-design/components/nodes-config/user-task-node-config.vue
@@ -108,6 +108,8 @@ const [Drawer, drawerApi] = useVbenDrawer({
   },
 });
 
+// TODO @jason：和 antd 对应的文件，逻辑有点不一样；
+
 // 节点名称配置
 const { nodeName, showInput, clickIcon, changeNodeName, inputRef } =
   useNodeName(BpmNodeTypeEnum.USER_TASK_NODE);
diff --git a/apps/web-ele/src/views/bpm/components/simple-process-design/helpers.ts b/apps/web-ele/src/views/bpm/components/simple-process-design/helpers.ts
index 3ffc2a303..0971c7d2c 100644
--- a/apps/web-ele/src/views/bpm/components/simple-process-design/helpers.ts
+++ b/apps/web-ele/src/views/bpm/components/simple-process-design/helpers.ts
@@ -46,6 +46,7 @@ export function useWatchNode(props: {
 }
 
 // 解析 formCreate 所有表单字段, 并返回
+// TODO @jason：这个逻辑，和 antd 对应的逻辑不太一致；
 function parseFormCreateFields(formFields?: string[]) {
   const result: Array<Record<string, any>> = [];
   if (formFields) {
diff --git a/apps/web-ele/src/views/bpm/components/simple-process-design/index.ts b/apps/web-ele/src/views/bpm/components/simple-process-design/index.ts
index 41269eae8..91f11f4bd 100644
--- a/apps/web-ele/src/views/bpm/components/simple-process-design/index.ts
+++ b/apps/web-ele/src/views/bpm/components/simple-process-design/index.ts
@@ -8,4 +8,5 @@ export { default as SimpleProcessViewer } from './components/simple-process-view
 
 export type { SimpleFlowNode } from './consts';
 
+// TODO @jaosn：和 antd 对应的文件，不太一样
 export { parseFormFields } from './helpers';
diff --git a/apps/web-ele/src/views/bpm/model/form/modules/bpm-model-editor.vue b/apps/web-ele/src/views/bpm/model/form/modules/bpm-model-editor.vue
index 9ea0516d0..c1a2e677f 100644
--- a/apps/web-ele/src/views/bpm/model/form/modules/bpm-model-editor.vue
+++ b/apps/web-ele/src/views/bpm/model/form/modules/bpm-model-editor.vue
@@ -40,6 +40,7 @@ const xmlString = inject('processData') as Ref; // 注入流程数据
 const modelData = inject('modelData') as Ref; // 注入模型数据
 
 const modeler = shallowRef(); // BPMN Modeler
+// TODO @AI：和对应的 antd 文件，略微有点不一样；
 const processDesigner = ref();
 const controlForm = ref({
   simulation: true,
diff --git a/apps/web-ele/src/views/bpm/processExpression/components/select-modal.vue b/apps/web-ele/src/views/bpm/processExpression/components/select-modal.vue
index dc1fb4984..f293b34e6 100644
--- a/apps/web-ele/src/views/bpm/processExpression/components/select-modal.vue
+++ b/apps/web-ele/src/views/bpm/processExpression/components/select-modal.vue
@@ -17,6 +17,7 @@ const emit = defineEmits<{
 }>();
 
 // 查询参数
+// TODO @jason：这里的风格，和 antd 对应的不一致；
 const queryParams = ref({
   status: CommonStatusEnum.ENABLE,
 });
diff --git a/apps/web-ele/src/views/bpm/processListener/components/data.ts b/apps/web-ele/src/views/bpm/processListener/components/data.ts
index 37725d839..48a9b4048 100644
--- a/apps/web-ele/src/views/bpm/processListener/components/data.ts
+++ b/apps/web-ele/src/views/bpm/processListener/components/data.ts
@@ -3,6 +3,7 @@ import type { VxeTableGridOptions } from '#/adapter/vxe-table';
 import { DICT_TYPE } from '@vben/constants';
 
 /** 选择监听器弹窗的列表字段 */
+// TODO @jason：和 antd 对应的，不太一致；
 export function useGridColumns(): VxeTableGridOptions['columns'] {
   return [
     { field: 'name', title: '名字', minWidth: 120 },
diff --git a/apps/web-ele/src/views/bpm/processListener/components/select-modal.vue b/apps/web-ele/src/views/bpm/processListener/components/select-modal.vue
index ef1237eca..f18ed0d08 100644
--- a/apps/web-ele/src/views/bpm/processListener/components/select-modal.vue
+++ b/apps/web-ele/src/views/bpm/processListener/components/select-modal.vue
@@ -19,6 +19,7 @@ const emit = defineEmits<{
 }>();
 
 // 查询参数
+// TODO @jason：这里的风格，和 antd 对应的不一致；
 const queryParams = ref({
   type: '',
   status: CommonStatusEnum.ENABLE,