feat(ai): 新增AI助手功能及相关组件

refactor(websocket): 重构WebSocket服务管理及字典同步功能 style(login): 优化登录页面样式及背景图 perf(menu): 改进菜单项展开状态监听逻辑 build: 更新依赖并添加prettier和lint-staged配置 docs: 更新README和注释说明 chore: 清理无用代码和文件
2026-09-24 05:26:58 +00:00 · 2025-12-16 01:29:43 +08:00
parent 156aaf5af6
commit 854d37dcdc
25 changed files with 3118 additions and 104 deletions
@@ -0,0 +1,180 @@
+import request from "@/utils/request";
+
+/**
+ * AI 命令请求参数
+ */
+export interface AiCommandRequest {
+  /** 用户输入的自然语言命令 */
+  command: string;
+  /** 当前页面路由（用于上下文） */
+  currentRoute?: string;
+  /** 当前激活的组件名称 */
+  currentComponent?: string;
+  /** 额外上下文信息 */
+  context?: Record<string, any>;
+}
+
+/**
+ * 函数调用参数
+ */
+export interface FunctionCall {
+  /** 函数名称 */
+  name: string;
+  /** 函数描述 */
+  description?: string;
+  /** 参数对象 */
+  arguments: Record<string, any>;
+}
+
+/**
+ * AI 命令解析响应
+ */
+export interface AiCommandResponse {
+  /** 解析日志ID（用于关联执行记录） */
+  parseLogId?: string;
+  /** 是否成功解析 */
+  success: boolean;
+  /** 解析后的函数调用列表 */
+  functionCalls: FunctionCall[];
+  /** AI 的理解和说明 */
+  explanation?: string;
+  /** 置信度 (0-1) */
+  confidence?: number;
+  /** 错误信息 */
+  error?: string;
+  /** 原始 LLM 响应（用于调试） */
+  rawResponse?: string;
+}
+
+/**
+ * AI 命令执行请求
+ */
+export interface AiExecuteRequest {
+  /** 关联的解析日志ID */
+  parseLogId?: string;
+  /** 原始命令（用于审计） */
+  originalCommand?: string;
+  /** 要执行的函数调用 */
+  functionCall: FunctionCall;
+  /** 确认模式：auto=自动执行, manual=需要用户确认 */
+  confirmMode?: "auto" | "manual";
+  /** 用户确认标志 */
+  userConfirmed?: boolean;
+  /** 幂等性令牌（防止重复执行） */
+  idempotencyKey?: string;
+  /** 当前页面路由 */
+  currentRoute?: string;
+}
+
+/**
+ * AI 命令执行响应
+ */
+export interface AiExecuteResponse {
+  /** 是否执行成功 */
+  success: boolean;
+  /** 执行结果数据 */
+  data?: any;
+  /** 执行结果说明 */
+  message?: string;
+  /** 影响的记录数 */
+  affectedRows?: number;
+  /** 错误信息 */
+  error?: string;
+  /** 记录ID（用于追踪） */
+  recordId?: string;
+  /** 需要用户确认 */
+  requiresConfirmation?: boolean;
+  /** 确认提示信息 */
+  confirmationPrompt?: string;
+}
+
+export interface AiCommandRecordPageQuery extends PageQuery {
+  keywords?: string;
+  executeStatus?: number;
+  parseStatus?: number;
+  userId?: number;
+  aiProvider?: string;
+  aiModel?: string;
+  functionName?: string;
+  createTime?: [string, string];
+}
+
+export interface AiCommandRecordVO {
+  id: string;
+  userId: number;
+  username: string;
+  originalCommand: string;
+  aiProvider?: string;
+  aiModel?: string;
+  parseStatus?: number;
+  functionCalls?: string;
+  explanation?: string;
+  confidence?: number;
+  parseErrorMessage?: string;
+  inputTokens?: number;
+  outputTokens?: number;
+  parseDurationMs?: number;
+  functionName?: string;
+  functionArguments?: string;
+  executeStatus?: number;
+  executeErrorMessage?: string;
+  ipAddress?: string;
+  createTime?: string;
+  updateTime?: string;
+}
+
+/**
+ * AI 命令 API
+ */
+class AiCommandApi {
+  /**
+   * 解析自然语言命令
+   *
+   * @param data 命令请求参数
+   * @returns 解析结果
+   */
+  static parseCommand(data: AiCommandRequest): Promise<AiCommandResponse> {
+    return request<any, AiCommandResponse>({
+      url: "/api/v1/ai/command/parse",
+      method: "post",
+      data,
+    });
+  }
+
+  /**
+   * 执行已解析的命令
+   *
+   * @param data 执行请求参数
+   * @returns 执行结果数据（成功时返回，失败时抛出异常）
+   */
+  static executeCommand(data: AiExecuteRequest): Promise<any> {
+    return request<any, any>({
+      url: "/api/v1/ai/command/execute",
+      method: "post",
+      data,
+    });
+  }
+
+  /**
+   * 获取命令记录分页列表
+   */
+  static getCommandRecordPage(queryParams: AiCommandRecordPageQuery) {
+    return request<any, PageResult<AiCommandRecordVO[]>>({
+      url: "/api/v1/ai/command/records",
+      method: "get",
+      params: queryParams,
+    });
+  }
+
+  /**
+   * 撤销命令执行（如果支持）
+   */
+  static rollbackCommand(logId: string) {
+    return request({
+      url: `/api/v1/ai/command/rollback/${logId}`,
+      method: "post",
+    });
+  }
+}
+
+export default AiCommandApi;