diff --git a/apps/web-antd/src/components/user-select-modal/user-select-modal.vue b/apps/web-antd/src/components/user-select-modal/user-select-modal.vue
index 6b03d3086..105267b70 100644
--- a/apps/web-antd/src/components/user-select-modal/user-select-modal.vue
+++ b/apps/web-antd/src/components/user-select-modal/user-select-modal.vue
@@ -1,4 +1,5 @@
 <script lang="ts" setup>
+// TODO @芋艿：是否有更好的组织形式？！
 import type { Key } from 'ant-design-vue/es/table/interface';
 
 import type { SystemDeptApi } from '#/api/system/dept';
diff --git a/apps/web-antd/src/layouts/components/help.vue b/apps/web-antd/src/layouts/components/help.vue
index dea84d5fd..ee223ead5 100644
--- a/apps/web-antd/src/layouts/components/help.vue
+++ b/apps/web-antd/src/layouts/components/help.vue
@@ -1,4 +1,5 @@
 <script lang="ts" setup>
+// TODO @xingyu：这个有可能 3 端复用么？想着是把 layouts 下的 components 没有这个目录哈；
 import { useVbenModal, VbenButton, VbenButtonGroup } from '@vben/common-ui';
 import { openWindow } from '@vben/utils';
 
diff --git a/apps/web-antd/src/layouts/components/tenant-dropdown.vue b/apps/web-antd/src/layouts/components/tenant-dropdown.vue
index 5bb888b9d..255db439d 100644
--- a/apps/web-antd/src/layouts/components/tenant-dropdown.vue
+++ b/apps/web-antd/src/layouts/components/tenant-dropdown.vue
@@ -24,6 +24,7 @@ const tenantEnable = isTenantEnable();
 const value = ref<number>(accessStore.visitTenantId ?? undefined); // 当前访问的租户 ID
 const tenants = ref<SystemTenantApi.Tenant[]>([]); // 租户列表
 
+// TODO @xingyu：这个有可能 3 端复用么？
 async function handleChange(id: SelectValue) {
   // 设置访问租户 ID
   accessStore.setVisitTenantId(id as number);
diff --git a/apps/web-ele/src/adapter/vxe-table.ts b/apps/web-ele/src/adapter/vxe-table.ts
index 066852264..c86d95e02 100644
--- a/apps/web-ele/src/adapter/vxe-table.ts
+++ b/apps/web-ele/src/adapter/vxe-table.ts
@@ -2,6 +2,7 @@ import type { Recordable } from '@vben/types';
 
 import { h } from 'vue';
 
+// TODO @puhui999：搜索的重置按钮，颜色不对；antd 是白色的
 import { IconifyIcon } from '@vben/icons';
 import { $te } from '@vben/locales';
 import {
@@ -18,6 +19,7 @@ import { $t } from '#/locales';
 
 import { useVbenForm } from './form';
 
+// TODO @puhui999：貌似新增、和导出按钮，和 antd 有点点差别，这个是要写样式哇？
 setupVbenVxeTable({
   configVxeTable: (vxeUI) => {
     vxeUI.setConfig({
@@ -165,6 +167,8 @@ setupVbenVxeTable({
             text: $t('common.edit'),
           },
         };
+        // TODO @puhui999：貌似按钮相比 antd 版本，小一点？
+        // TODO @puhui999：貌似按钮之间的间距，大了一点？
         const operations: Array<Recordable<any>> = (
           options || ['edit', 'delete']
         )
diff --git a/apps/web-ele/src/components/doc-alert/doc-alert.vue b/apps/web-ele/src/components/doc-alert/doc-alert.vue
index 20590d6ff..58b92b17c 100644
--- a/apps/web-ele/src/components/doc-alert/doc-alert.vue
+++ b/apps/web-ele/src/components/doc-alert/doc-alert.vue
@@ -23,6 +23,7 @@ const goToUrl = () => {
 };
 </script>
 
+<!-- TODO @puhui999：样式有点问题，间隔没了。可以看下 antd 版本的例子哈 -->
 <template>
   <ElAlert
     v-if="isDocAlertEnable()"
diff --git a/apps/web-ele/src/store/dict.ts b/apps/web-ele/src/store/dict.ts
index 37f636d2e..d2c6c73c8 100644
--- a/apps/web-ele/src/store/dict.ts
+++ b/apps/web-ele/src/store/dict.ts
@@ -13,7 +13,7 @@ interface DictState {
   dictCache: Dict;
 }
 
-// TODO @芋艿：可以共享么？
+// TODO @xingyu：@芋艿：可以共享么？
 export const useDictStore = defineStore('dict', {
   actions: {
     getDictData(dictType: string, value: any) {
diff --git a/apps/web-ele/src/views/system/tenant/data.ts b/apps/web-ele/src/views/system/tenant/data.ts
index 16c165414..24f3fa583 100644
--- a/apps/web-ele/src/views/system/tenant/data.ts
+++ b/apps/web-ele/src/views/system/tenant/data.ts
@@ -149,6 +149,7 @@ export function useGridFormSchema(): VbenFormSchema[] {
         options: getDictOptions(DICT_TYPE.COMMON_STATUS, 'number'),
       },
     },
+    // TODO @puhui999：貌似创建时间，出不来；
     {
       fieldName: 'createTime',
       label: '创建时间',
diff --git a/apps/web-naive/src/components/doc-alert/doc-alert.vue b/apps/web-naive/src/components/doc-alert/doc-alert.vue
index 7aba339e9..dde30b2ac 100644
--- a/apps/web-naive/src/components/doc-alert/doc-alert.vue
+++ b/apps/web-naive/src/components/doc-alert/doc-alert.vue
@@ -25,6 +25,7 @@ const goToUrl = () => {
 
 <template>
   <NAlert v-if="isDocAlertEnable()" type="info" show-icon class="mb-2 rounded">
+    <!-- TODO @xingyu：这里不太对，展示不出来字 -->
     <template #message>
       <NText @click="goToUrl"> 【{{ title }}】文档地址：{{ url }} </NText>
     </template>
diff --git a/apps/web-naive/src/components/upload/file-upload.vue b/apps/web-naive/src/components/upload/file-upload.vue
index abbf637e9..2e655f534 100644
--- a/apps/web-naive/src/components/upload/file-upload.vue
+++ b/apps/web-naive/src/components/upload/file-upload.vue
@@ -1,4 +1,5 @@
 <script lang="ts" setup>
+// TODO @xingyu：文件上传，貌似没通
 import type { UploadFile, UploadProps } from 'naive-ui';
 import type { UploadRequestOption } from 'naive-ui/lib/vc-upload/interface';
 
diff --git a/apps/web-naive/src/views/infra/build/index.vue b/apps/web-naive/src/views/infra/build/index.vue
index 93173cbd2..b59ae4315 100644
--- a/apps/web-naive/src/views/infra/build/index.vue
+++ b/apps/web-naive/src/views/infra/build/index.vue
@@ -1,5 +1,6 @@
 <!-- eslint-disable no-useless-escape -->
 <script setup lang="ts">
+// TODO @xingyu：跑不通
 import { onMounted, ref, unref } from 'vue';
 
 import { Page, useVbenModal } from '@vben/common-ui';
diff --git a/apps/web-naive/src/views/infra/codegen/index.vue b/apps/web-naive/src/views/infra/codegen/index.vue
index 0a08f14f3..c0c317274 100644
--- a/apps/web-naive/src/views/infra/codegen/index.vue
+++ b/apps/web-naive/src/views/infra/codegen/index.vue
@@ -1,4 +1,5 @@
 <script lang="ts" setup>
+// TODO @xingyu：跑不通
 import type {
   OnActionClickParams,
   VxeTableGridOptions,
diff --git a/apps/web-naive/src/views/infra/file/modules/form.vue b/apps/web-naive/src/views/infra/file/modules/form.vue
index bdc7f7b7e..58e167a3d 100644
--- a/apps/web-naive/src/views/infra/file/modules/form.vue
+++ b/apps/web-naive/src/views/infra/file/modules/form.vue
@@ -1,4 +1,5 @@
 <script lang="ts" setup>
+// TODO @xingyu：文件上传，有点问题；
 import type { UploadFileInfo } from 'naive-ui';
 
 import { useVbenModal } from '@vben/common-ui';
diff --git a/apps/web-naive/src/views/infra/webSocket/index.vue b/apps/web-naive/src/views/infra/webSocket/index.vue
index bdabc8a2b..425853e88 100644
--- a/apps/web-naive/src/views/infra/webSocket/index.vue
+++ b/apps/web-naive/src/views/infra/webSocket/index.vue
@@ -1,4 +1,5 @@
 <script lang="ts" setup>
+// TODO @xingyu：跑不通
 import type { SystemUserApi } from '#/api/system/user';
 
 import { computed, onMounted, ref, watchEffect } from 'vue';
diff --git a/apps/web-naive/src/views/system/notice/data.ts b/apps/web-naive/src/views/system/notice/data.ts
index a181a534d..caaae93e7 100644
--- a/apps/web-naive/src/views/system/notice/data.ts
+++ b/apps/web-naive/src/views/system/notice/data.ts
@@ -37,6 +37,7 @@ export function useFormSchema(): VbenFormSchema[] {
       },
       rules: 'required',
     },
+    // TODO @xingyu：测试有问题
     {
       fieldName: 'content',
       label: '公告内容',
@@ -54,6 +55,7 @@ export function useFormSchema(): VbenFormSchema[] {
       },
       rules: z.number().default(CommonStatusEnum.ENABLE),
     },
+    // TODO @xingyu：测试有问题
     {
       fieldName: 'remark',
       label: '备注',
diff --git a/apps/web-naive/src/views/system/notify/message/modules/detail.vue b/apps/web-naive/src/views/system/notify/message/modules/detail.vue
index 5a3f2f123..7936bc567 100644
--- a/apps/web-naive/src/views/system/notify/message/modules/detail.vue
+++ b/apps/web-naive/src/views/system/notify/message/modules/detail.vue
@@ -1,4 +1,5 @@
 <script lang="ts" setup>
+// TODO @xingyu：这个展示不出来；从右上角的站内信点进来的
 import type { SystemNotifyMessageApi } from '#/api/system/notify/message';
 
 import { ref } from 'vue';
diff --git a/apps/web-naive/src/views/system/tenant/data.ts b/apps/web-naive/src/views/system/tenant/data.ts
index 16c165414..e5a9c07a8 100644
--- a/apps/web-naive/src/views/system/tenant/data.ts
+++ b/apps/web-naive/src/views/system/tenant/data.ts
@@ -37,6 +37,7 @@ export function useFormSchema(): VbenFormSchema[] {
       label: '租户套餐',
       component: 'ApiSelect',
       componentProps: {
+        // TODO @xingyu：系统租户的情况
         api: () => getTenantPackageList(),
         labelField: 'name',
         valueField: 'id',
@@ -149,6 +150,7 @@ export function useGridFormSchema(): VbenFormSchema[] {
         options: getDictOptions(DICT_TYPE.COMMON_STATUS, 'number'),
       },
     },
+    // TODO @xingyu：时间检索，有问题
     {
       fieldName: 'createTime',
       label: '创建时间',
diff --git a/apps/web-naive/src/views/system/user/data.ts b/apps/web-naive/src/views/system/user/data.ts
index 4bcb6a625..c6ec04e31 100644
--- a/apps/web-naive/src/views/system/user/data.ts
+++ b/apps/web-naive/src/views/system/user/data.ts
@@ -333,10 +333,12 @@ export function useGridColumns<T = SystemUserApi.User>(
             code: 'edit',
             show: hasAccessByCodes(['system:user:update']),
           },
+          // TODO @xingyu：删除一直弹出来
           {
             code: 'delete',
             show: hasAccessByCodes(['system:user:delete']),
           },
+          // TODO @xingyu：后面的按钮，无法展示
           {
             code: 'assign-role',
             text: '分配角色',
diff --git a/apps/web-naive/src/views/system/user/modules/dept-tree.vue b/apps/web-naive/src/views/system/user/modules/dept-tree.vue
index 41d8b949e..2d2c36f15 100644
--- a/apps/web-naive/src/views/system/user/modules/dept-tree.vue
+++ b/apps/web-naive/src/views/system/user/modules/dept-tree.vue
@@ -49,6 +49,7 @@ onMounted(async () => {
     loading.value = false;
   }
 });
+// TODO @xingyu：数据没展示
 </script>
 
 <template>