【优化】调整 ai Image 方法注释

src/views/ai/image/ImageDetailDrawer.vue

@@ -85,24 +85,18 @@ const props = defineProps({
   }
 })
 
-/**
+/**  抽屉 - close  */
- * 抽屉 - close
- */
 const handlerDrawerClose = async () => {
   emits('handlerDrawerClose')
 }
 
-/**
+/**  获取 - 图片 detail  */
- * 获取 - 图片 detail
- */
 const getImageDetail = async (id) => {
   // 获取图片详细
   imageDetail.value = await ImageApi.getImageDetail(id)
 }
 
-/**
+/**  任务 - detail  */
- * 任务 - detail
- */
 const handlerTaskDetail = async () => {
   showDrawer.value = true
 }

src/views/ai/image/ImageTask.vue

@@ -28,16 +28,12 @@ const showImageDetailId = ref<number>(0) // 是否显示 task 详情
 
 // TODO @fan：如果是简单注释，建议用 /** */，主要是现在项目里是这种风格哈，保持一致好点~
 
-/**
+/**  抽屉 - close  */
- * 抽屉 - close
- */
 const handlerDrawerClose = async () => {
   isShowImageDetail.value = false
 }
 
-/**
+/**  任务 - detail  */
- * 任务 - detail
- */
 const handlerDrawerOpen = async () => {
   isShowImageDetail.value = true
 }
@@ -50,9 +46,7 @@ const getImageList = async () => {
   imageList.value = list
 }
 
-/**
+/**  图片 - btn click  */
- * 图片 - btn click
- */
 const handlerImageBtnClick = async (type, imageDetail: ImageDetailVO) => {
   // 获取 image detail id
   showImageDetailId.value = imageDetail.id
@@ -69,9 +63,7 @@ const handlerImageBtnClick = async (type, imageDetail: ImageDetailVO) => {
   }
 }
 
-/**
+/**  下载 - image  */
- * 下载 - image
- */
 // TODO @fan：貌似可以考虑抽到 download 里面，作为一个方法
 const downloadImage = async (imageUrl) => {
   const image = new Image()

src/views/ai/image/ImageTaskCard.vue

@@ -37,9 +37,7 @@ const props = defineProps({
   }
 })
 
-/**
+/**  按钮 - 点击事件  */
- * 按钮 - 点击事件
- */
 const handlerBtnClick = async (type, imageDetail: ImageDetailVO) => {
   emits('onBtnClick', type, imageDetail)
 }

src/views/ai/image/dall3/index.vue

@@ -186,9 +186,7 @@ const emits = defineEmits(['onDrawStart', 'onDrawComplete'])
 
 // TODO @fan：如果是简单注释，建议用 /** */，主要是现在项目里是这种风格哈，保持一致好点~
 // TODO @fan：handler 应该改成 handle 哈
-/**
+/** 热词 - click  */
- * 热词 - click
- */
 const handlerHotWordClick = async (hotWord: string) => {
   // 取消选中
   if (selectHotWord.value == hotWord) {
@@ -201,9 +199,7 @@ const handlerHotWordClick = async (hotWord: string) => {
   prompt.value = hotWord
 }
 
-/**
+/**  模型 - click  */
- * 模型 - click
- */
 const handlerModelClick = async (model: ImageModelVO) => {
   if (selectModel.value === model) {
     selectModel.value = {} as ImageModelVO
@@ -212,9 +208,7 @@ const handlerModelClick = async (model: ImageModelVO) => {
   selectModel.value = model
 }
 
-/**
+/**  样式 - click  */
- * 样式 - click
- */
 const handlerStyleClick = async (imageStyle: ImageModelVO) => {
   if (selectImageStyle.value === imageStyle) {
     selectImageStyle.value = {} as ImageModelVO
@@ -223,9 +217,7 @@ const handlerStyleClick = async (imageStyle: ImageModelVO) => {
   selectImageStyle.value = imageStyle
 }
 
-/**
+/**  size - click  */
- * size - click
- */
 const handlerSizeClick = async (imageSize: ImageSizeVO) => {
   if (selectImageSize.value === imageSize) {
     selectImageSize.value = {} as ImageSizeVO
@@ -234,9 +226,7 @@ const handlerSizeClick = async (imageSize: ImageSizeVO) => {
   selectImageSize.value = imageSize
 }
 
-/**
+/**  图片生产  */
- * 图片生产
- */
 const handlerGenerateImage = async () => {
   try {
     // 加载中

src/views/ai/image/index.vue

@@ -33,17 +33,13 @@ const selectModel = ref('DALL3绘画')
 const modelOptions = ['DALL3绘画', 'MJ绘画']
 const drawIn = ref<boolean>(false)  // 生成中
 
-/**
+/**  绘画 - start  */
- * 绘画 - start
- */
 const handlerDrawStart = async (type) => {
   // todo
   drawIn.value = true
 }
 
-/**
+/**  绘画 - complete  */
- * 绘画 - complete
- */
 const handlerDrawComplete = async (type) => {
   drawIn.value = false
   // todo

src/views/ai/image/midjourney/index.vue

@@ -198,9 +198,7 @@ const selectVersion = ref<any>('6.0') // 选中的 version
 // 定义 Props
 const props = defineProps({})
 
-/**
+/**  热词 - click  */
- * 热词 - click
- */
 const handlerHotWordClick = async (hotWord: string) => {
   // 取消
   if (selectHotWord.value == hotWord) {
@@ -213,9 +211,7 @@ const handlerHotWordClick = async (hotWord: string) => {
   prompt.value = hotWord
 }
 
-/**
+/**  size - click  */
- * size - click
- */
 const handlerSizeClick = async (imageSize: ImageSizeVO) => {
   if (selectImageSize.value === imageSize) {
     selectImageSize.value = {} as ImageSizeVO
@@ -224,23 +220,17 @@ const handlerSizeClick = async (imageSize: ImageSizeVO) => {
   selectImageSize.value = imageSize
 }
 
-/**
+/**  模型 - click  */
- * 模型 - click
- */
 const handlerModelClick = async (model: ImageModelVO) => {
   selectModel.value = model
 }
 
-/**
+/**  version - click  */
- * version - click
- */
 const handlerChangeVersion = async (version) => {
   console.log('version', version)
 }
 
-/**
+/** 图片生产  */
- * 图片生产
- */
 const handlerGenerateImage = async () => {
   // todo @范 图片生产逻辑
   try {