feat：【antd/ele】【ai】优化 api 格式

apps/web-antd/src/api/ai/chat/conversation/index.ts

@@ -15,7 +15,6 @@ export namespace AiChatConversationApi {
     maxTokens: number; // 单条回复的最大 Token 数量
     maxContexts: number; // 上下文的最大 Message 数量
     createTime?: Date; // 创建时间
-    // 额外字段
     systemMessage?: string; // 角色设定
     modelName?: string; // 模型名字
     roleAvatar?: string; // 角色头像
@@ -24,52 +23,52 @@ export namespace AiChatConversationApi {
   }
 }
 
-// 获得【我的】聊天对话
+/** 获得【我的】聊天对话 */
 export function getChatConversationMy(id: number) {
   return requestClient.get<AiChatConversationApi.ChatConversation>(
     `/ai/chat/conversation/get-my?id=${id}`,
   );
 }
 
-// 新增【我的】聊天对话
+/** 新增【我的】聊天对话 */
 export function createChatConversationMy(
   data: AiChatConversationApi.ChatConversation,
 ) {
   return requestClient.post('/ai/chat/conversation/create-my', data);
 }
 
-//  更新【我的】聊天对话
+/** 更新【我的】聊天对话 */
 export function updateChatConversationMy(
   data: AiChatConversationApi.ChatConversation,
 ) {
   return requestClient.put(`/ai/chat/conversation/update-my`, data);
 }
 
-//  删除【我的】聊天对话
+/** 删除【我的】聊天对话 */
 export function deleteChatConversationMy(id: number) {
   return requestClient.delete(`/ai/chat/conversation/delete-my?id=${id}`);
 }
 
-//  删除【我的】所有对话，置顶除外
+/** 删除【我的】所有对话，置顶除外 */
 export function deleteChatConversationMyByUnpinned() {
   return requestClient.delete(`/ai/chat/conversation/delete-by-unpinned`);
 }
 
-//  获得【我的】聊天对话列表
+/** 获得【我的】聊天对话列表 */
 export function getChatConversationMyList() {
   return requestClient.get<AiChatConversationApi.ChatConversation[]>(
     `/ai/chat/conversation/my-list`,
   );
 }
 
-//  获得【我的】聊天对话列表
+/** 获得【我的】聊天对话列表 */
 export function getChatConversationPage(params: any) {
   return requestClient.get<
     PageResult<AiChatConversationApi.ChatConversation[]>
   >(`/ai/chat/conversation/page`, { params });
 }
 
-//  管理员删除消息
+/** 管理员删除消息 */
 export function deleteChatConversationByAdmin(id: number) {
   return requestClient.delete(`/ai/chat/conversation/delete-by-admin?id=${id}`);
 }

apps/web-antd/src/api/ai/chat/message/index.ts

@@ -46,7 +46,7 @@ export namespace AiChatMessageApi {
   }
 }
 
-// 消息列表
+/** 消息列表 */
 export function getChatMessageListByConversationId(
   conversationId: null | number,
 ) {
@@ -55,7 +55,7 @@ export function getChatMessageListByConversationId(
   );
 }
 
-// 发送 Stream 消息
+/** 发送 Stream 消息 */
 export function sendChatMessageStream(
   conversationId: number,
   content: string,
@@ -89,25 +89,27 @@ export function sendChatMessageStream(
   });
 }
 
-// 删除消息
+/** 删除消息 */
 export function deleteChatMessage(id: number) {
   return requestClient.delete(`/ai/chat/message/delete?id=${id}`);
 }
 
-// 删除指定对话的消息
+/** 删除指定对话的消息 */
 export function deleteByConversationId(conversationId: number) {
   return requestClient.delete(
     `/ai/chat/message/delete-by-conversation-id?conversationId=${conversationId}`,
   );
 }
-// 获得消息分页
+
+/** 获得消息分页 */
 export function getChatMessagePage(params: any) {
   return requestClient.get<PageResult<AiChatMessageApi.ChatMessage>>(
     '/ai/chat/message/page',
     { params },
   );
 }
-// 管理员删除消息
+
+/** 管理员删除消息 */
 export function deleteChatMessageByAdmin(id: number) {
   return requestClient.delete(`/ai/chat/message/delete-by-admin?id=${id}`);
 }

apps/web-antd/src/api/ai/image/index.ts

@@ -3,14 +3,7 @@ import type { PageParam, PageResult } from '@vben/request';
 import { requestClient } from '#/api/request';
 
 export namespace AiImageApi {
-  export interface ImageMidjourneyButtons {
-    customId: string; // MJ::JOB::upsample::1::85a4b4c1-8835-46c5-a15c-aea34fad1862 动作标识
-    emoji: string; // 图标 emoji
-    label: string; // Make Variations 文本
-    style: number; // 样式: 2（Primary）、3（Green）
-  }
-
-  /** AI 绘图 */
+  /** 绘图 */
   export interface Image {
     id: number; // 编号
     userId: number;
@@ -30,7 +23,14 @@ export namespace AiImageApi {
     finishTime: Date; // 完成时间
   }
 
-  export interface ImageDrawReq {
+  export interface ImageMidjourneyButtons {
+    customId: string; // MJ::JOB::upsample::1::85a4b4c1-8835-46c5-a15c-aea34fad1862 动作标识
+    emoji: string; // 图标 emoji
+    label: string; // Make Variations 文本
+    style: number; // 样式: 2（Primary）、3（Green）
+  }
+
+  export interface ImageDrawReqVO {
     prompt: string; // 提示词
     modelId: number; // 模型
     style: string; // 图像生成的风格
@@ -39,7 +39,7 @@ export namespace AiImageApi {
     options: object; // 绘制参数，Map<String, String>
   }
 
-  export interface ImageMidjourneyImagineReq {
+  export interface ImageMidjourneyImagineReqVO {
     prompt: string; // 提示词
     modelId: number; // 模型
     base64Array?: string[]; // size不能为空
@@ -54,60 +54,62 @@ export namespace AiImageApi {
   }
 }
 
-// 获取【我的】绘图分页
+/** 获取【我的】绘图分页 */
 export function getImagePageMy(params: PageParam) {
   return requestClient.get<PageResult<AiImageApi.Image>>('/ai/image/my-page', {
     params,
   });
 }
 
-// 获取【我的】绘图记录
+/** 获取【我的】绘图记录 */
 export function getImageMy(id: number) {
   return requestClient.get<AiImageApi.Image>(`/ai/image/get-my?id=${id}`);
 }
 
-// 获取【我的】绘图记录列表
+/** 获取【我的】绘图记录列表 */
 export function getImageListMyByIds(ids: number[]) {
   return requestClient.get<AiImageApi.Image[]>(`/ai/image/my-list-by-ids`, {
     params: { ids: ids.join(',') },
   });
 }
 
-// 生成图片
-export function drawImage(data: AiImageApi.ImageDrawReq) {
+/** 生成图片 */
+export function drawImage(data: AiImageApi.ImageDrawReqVO) {
   return requestClient.post(`/ai/image/draw`, data);
 }
 
-// 删除【我的】绘画记录
+/** 删除【我的】绘画记录 */
 export function deleteImageMy(id: number) {
   return requestClient.delete(`/ai/image/delete-my?id=${id}`);
 }
 
-// ================ midjourney 专属 ================
+/** ================ midjourney 专属 ================ */
 
-// 【Midjourney】生成图片
-export function midjourneyImagine(data: AiImageApi.ImageMidjourneyImagineReq) {
+/** 【Midjourney】生成图片 */
+export function midjourneyImagine(
+  data: AiImageApi.ImageMidjourneyImagineReqVO,
+) {
   return requestClient.post(`/ai/image/midjourney/imagine`, data);
 }
 
-// 【Midjourney】Action 操作（二次生成图片）
+/** 【Midjourney】Action 操作（二次生成图片） */
 export function midjourneyAction(data: AiImageApi.ImageMidjourneyAction) {
   return requestClient.post(`/ai/image/midjourney/action`, data);
 }
 
-// ================ 绘图管理 ================
+/** ================ 绘图管理 ================ */
 
-// 查询绘画分页
+/** 查询绘画分页 */
 export function getImagePage(params: any) {
   return requestClient.get<AiImageApi.Image[]>(`/ai/image/page`, { params });
 }
 
-// 更新绘画发布状态
+/** 更新绘画发布状态 */
 export function updateImage(data: any) {
   return requestClient.put(`/ai/image/update`, data);
 }
 
-// 删除绘画
+/** 删除绘画 */
 export function deleteImage(id: number) {
   return requestClient.delete(`/ai/image/delete?id=${id}`);
 }

apps/web-antd/src/api/ai/knowledge/document/index.ts

@@ -15,39 +15,39 @@ export namespace AiKnowledgeDocumentApi {
   }
 }
 
-// 查询知识库文档分页
+/** 查询知识库文档分页 */
 export function getKnowledgeDocumentPage(params: PageParam) {
   return requestClient.get<
     PageResult<AiKnowledgeDocumentApi.KnowledgeDocument>
   >('/ai/knowledge/document/page', { params });
 }
 
-// 查询知识库文档详情
+/** 查询知识库文档详情 */
 export function getKnowledgeDocument(id: number) {
   return requestClient.get(`/ai/knowledge/document/get?id=${id}`);
 }
 
-// 新增知识库文档（单个）
+/** 新增知识库文档（单个） */
 export function createKnowledge(data: any) {
   return requestClient.post('/ai/knowledge/document/create', data);
 }
 
-// 新增知识库文档（多个）
+/** 新增知识库文档（多个） */
 export function createKnowledgeDocumentList(data: any) {
   return requestClient.post('/ai/knowledge/document/create-list', data);
 }
 
-// 修改知识库文档
+/** 修改知识库文档 */
 export function updateKnowledgeDocument(data: any) {
   return requestClient.put('/ai/knowledge/document/update', data);
 }
 
-// 修改知识库文档状态
+/** 修改知识库文档状态 */
 export function updateKnowledgeDocumentStatus(data: any) {
   return requestClient.put('/ai/knowledge/document/update-status', data);
 }
 
-// 删除知识库文档
+/** 删除知识库文档 */
 export function deleteKnowledgeDocument(id: number) {
   return requestClient.delete(`/ai/knowledge/document/delete?id=${id}`);
 }

apps/web-antd/src/api/ai/knowledge/knowledge/index.ts

@@ -13,7 +13,7 @@ export namespace AiKnowledgeKnowledgeApi {
   }
 }
 
-// 查询知识库分页
+/** 查询知识库分页 */
 export function getKnowledgePage(params: PageParam) {
   return requestClient.get<PageResult<AiKnowledgeKnowledgeApi.Knowledge>>(
     '/ai/knowledge/page',
@@ -21,29 +21,29 @@ export function getKnowledgePage(params: PageParam) {
   );
 }
 
-// 查询知识库详情
+/** 查询知识库详情 */
 export function getKnowledge(id: number) {
   return requestClient.get<AiKnowledgeKnowledgeApi.Knowledge>(
     `/ai/knowledge/get?id=${id}`,
   );
 }
 
-// 新增知识库
+/** 新增知识库 */
 export function createKnowledge(data: AiKnowledgeKnowledgeApi.Knowledge) {
   return requestClient.post('/ai/knowledge/create', data);
 }
 
-// 修改知识库
+/** 修改知识库 */
 export function updateKnowledge(data: AiKnowledgeKnowledgeApi.Knowledge) {
   return requestClient.put('/ai/knowledge/update', data);
 }
 
-// 删除知识库
+/** 删除知识库 */
 export function deleteKnowledge(id: number) {
   return requestClient.delete(`/ai/knowledge/delete?id=${id}`);
 }
 
-// 获取知识库简单列表
+/** 获取知识库简单列表 */
 export function getSimpleKnowledgeList() {
   return requestClient.get<AiKnowledgeKnowledgeApi.Knowledge[]>(
     '/ai/knowledge/simple-list',

apps/web-antd/src/api/ai/knowledge/segment/index.ts

@@ -3,7 +3,6 @@ import type { PageParam, PageResult } from '@vben/request';
 import { requestClient } from '#/api/request';
 
 export namespace AiKnowledgeSegmentApi {
-  // AI 知识库分段
   export interface KnowledgeSegment {
     id: number; // 编号
     documentId: number; // 文档编号
@@ -18,7 +17,7 @@ export namespace AiKnowledgeSegmentApi {
   }
 }
 
-// 查询知识库分段分页
+/** 查询知识库分段分页 */
 export function getKnowledgeSegmentPage(params: PageParam) {
   return requestClient.get<PageResult<AiKnowledgeSegmentApi.KnowledgeSegment>>(
     '/ai/knowledge/segment/page',
@@ -26,28 +25,28 @@ export function getKnowledgeSegmentPage(params: PageParam) {
   );
 }
 
-// 查询知识库分段详情
+/** 查询知识库分段详情 */
 export function getKnowledgeSegment(id: number) {
   return requestClient.get<AiKnowledgeSegmentApi.KnowledgeSegment>(
     `/ai/knowledge/segment/get?id=${id}`,
   );
 }
 
-// 新增知识库分段
+/** 新增知识库分段 */
 export function createKnowledgeSegment(
   data: AiKnowledgeSegmentApi.KnowledgeSegment,
 ) {
   return requestClient.post('/ai/knowledge/segment/create', data);
 }
 
-// 修改知识库分段
+/** 修改知识库分段 */
 export function updateKnowledgeSegment(
   data: AiKnowledgeSegmentApi.KnowledgeSegment,
 ) {
   return requestClient.put('/ai/knowledge/segment/update', data);
 }
 
-// 修改知识库分段状态
+/** 修改知识库分段状态 */
 export function updateKnowledgeSegmentStatus(id: number, status: number) {
   return requestClient.put('/ai/knowledge/segment/update-status', {
     id,
@@ -55,26 +54,26 @@ export function updateKnowledgeSegmentStatus(id: number, status: number) {
   });
 }
 
-// 删除知识库分段
+/** 删除知识库分段 */
 export function deleteKnowledgeSegment(id: number) {
   return requestClient.delete(`/ai/knowledge/segment/delete?id=${id}`);
 }
 
-// 切片内容
+/** 切片内容 */
 export function splitContent(url: string, segmentMaxTokens: number) {
   return requestClient.get('/ai/knowledge/segment/split', {
     params: { url, segmentMaxTokens },
   });
 }
 
-// 获取文档处理列表
+/** 获取文档处理列表 */
 export function getKnowledgeSegmentProcessList(documentIds: number[]) {
   return requestClient.get('/ai/knowledge/segment/get-process-list', {
     params: { documentIds: documentIds.join(',') },
   });
 }
 
-// 搜索知识库分段
+/** 搜索知识库分段 */
 export function searchKnowledgeSegment(params: any) {
   return requestClient.get('/ai/knowledge/segment/search', {
     params,

apps/web-antd/src/api/ai/mindmap/index.ts

@@ -8,7 +8,6 @@ const { apiURL } = useAppConfig(import.meta.env, import.meta.env.PROD);
 const accessStore = useAccessStore();
 
 export namespace AiMindmapApi {
-  // AI 思维导图
   export interface MindMap {
     id: number; // 编号
     userId: number; // 用户编号
@@ -19,12 +18,12 @@ export namespace AiMindmapApi {
     errorMessage: string; // 错误信息
   }
 
-  // AI 思维导图生成
   export interface AiMindMapGenerateReqVO {
     prompt: string;
   }
 }
 
+/** 生成思维导图 Stream */
 export function generateMindMap({
   data,
   onClose,

apps/web-antd/src/api/ai/music/index.ts

@@ -26,19 +26,19 @@ export namespace AiMusicApi {
   }
 }
 
-// 查询音乐分页
+/** 查询音乐分页 */
 export function getMusicPage(params: PageParam) {
   return requestClient.get<PageResult<AiMusicApi.Music>>(`/ai/music/page`, {
     params,
   });
 }
 
-// 更新音乐
+/** 更新音乐 */
 export function updateMusic(data: any) {
   return requestClient.put('/ai/music/update', data);
 }
 
-// 删除音乐
+/** 删除音乐 */
 export function deleteMusic(id: number) {
   return requestClient.delete(`/ai/music/delete?id=${id}`);
 }

apps/web-antd/src/api/ai/write/index.ts

@@ -36,6 +36,7 @@ export namespace AiWriteApi {
   }
 }
 
+/** 写作 Stream */
 export function writeStream({
   data,
   onClose,

apps/web-antd/src/views/ai/image/index/modules/common/index.vue

@@ -63,7 +63,7 @@ async function handleGenerateImage() {
       width: width.value, // 图片宽度
       height: height.value, // 图片高度
       options: {},
-    } as unknown as AiImageApi.ImageDrawReq;
+    } as unknown as AiImageApi.ImageDrawReqVO;
     await drawImage(form);
   } finally {
     // 回调

apps/web-antd/src/views/ai/image/index/modules/dall3/index.vue

@@ -116,7 +116,7 @@ async function handleGenerateImage() {
       options: {
         style: style.value, // 图像生成的风格
       },
-    } as AiImageApi.ImageDrawReq;
+    } as AiImageApi.ImageDrawReqVO;
     // 发送请求
     await drawImage(form);
   } finally {

apps/web-antd/src/views/ai/image/index/modules/midjourney/index.vue

@@ -103,7 +103,7 @@ async function handleGenerateImage() {
       height: imageSize.height,
       version: selectVersion.value,
       referImageUrl: referImageUrl.value,
-    } as AiImageApi.ImageMidjourneyImagineReq;
+    } as AiImageApi.ImageMidjourneyImagineReqVO;
     await midjourneyImagine(req);
   } finally {
     // 回调

apps/web-antd/src/views/ai/image/index/modules/stable-diffusion/index.vue

@@ -103,7 +103,7 @@ async function handleGenerateImage() {
         clipGuidancePreset: clipGuidancePreset.value, // 文本提示相匹配的图像 CLIP
         stylePreset: stylePreset.value, // 风格
       },
-    } as unknown as AiImageApi.ImageDrawReq;
+    } as unknown as AiImageApi.ImageDrawReqVO;
     await drawImage(form);
   } finally {
     // 回调