@legendzd/ai-agent-vue 1.0.4 → 1.0.6

package/dist/src/api/agent.d.ts

@@ -5,14 +5,21 @@ export declare function setAgentOptions(options: AgentPluginOptions): void;
 export declare function getAgentOptions(): AgentPluginOptions;
 /**
  * 创建会话
- * POST ${apiUrl}/agent/chat/session
+ * GET ${apiUrl}/external/chat/sessions
+ * 携带 agent_id（必传）、ext_user_id
  */
 export declare function createChatSession(options?: AgentPluginOptions): Promise<string>;
 /**
  * 获取历史会话列表
- * GET ${apiUrl}/agent/chat/sessions?userId=xxx
+ * GET ${apiUrl}/external/chat/sessions
+ * 携带 agent_id（必传）、ext_user_id
  */
 export declare function getChatSessions(options?: AgentPluginOptions): Promise<SessionInfo[]>;
+/**
+ * 获取历史会话的消息列表
+ * GET ${apiUrl}/external/chat/sessions/{id}/messages
+ */
+export declare function getSessionMessages(sessionId: number | string, options?: AgentPluginOptions): Promise<any[]>;
 /**
  * 流式文本生成接口
  * 使用 fetch + ReadableStream 实现 SSE 流式读取

package/dist/src/components/ChatMessage.vue.d.ts

@@ -1,6 +1,10 @@
 import { ChatMessage } from '../../types/agent';
 type __VLS_Props = {
     message: ChatMessage;
+    /** 用户头像 URL（svg/png/jpg 等） */
+    userAvatar?: string;
+    /** AI 助手头像 URL（svg/png/jpg 等） */
+    assistantAvatar?: string;
 };
 declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/src/stores/chat.d.ts

@@ -1,4 +1,4 @@
-import { AgentPluginOptions, ChatMessage, SessionInfo, SourceInfo } from '../../types/agent';
+import { AgentPluginOptions, ChatMessage, ChatMessageRole, ChatMessageStatus, SessionInfo, SourceInfo } from '../../types/agent';
 /** 聊天 store 实例类型 */
 export type ChatStoreInstance = ReturnType<ReturnType<typeof createChatStoreDefinition>>;
 /** 获取或创建聊天实例 */
@@ -13,19 +13,19 @@ export declare function destroyChatInstance(instanceId: string): void;
 declare function createChatStoreDefinition(instanceId: string): import('pinia').StoreDefinition<`agent-chat-${string}`, Pick<{
     sessionId: import('vue').Ref<string, string>;
     sessions: import('vue').Ref<{
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[], SessionInfo[] | {
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[]>;
     messages: import('vue').Ref<{
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -41,9 +41,9 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
         }[] | undefined;
     }[], ChatMessage[] | {
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -62,8 +62,10 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
     isSessionLoading: import('vue').Ref<boolean, boolean>;
     initSession: () => Promise<void>;
     loadSessions: () => Promise<void>;
-    switchSession: (id: string) => void;
-    newChat: () => Promise<void>;
+    isVirtualSession: import('vue').ComputedRef<boolean>;
+    syncSessionFromHistory: () => Promise<void>;
+    switchSession: (id: number | string) => Promise<void>;
+    newChat: () => void;
     addUserMessage: (content: string) => ChatMessage;
     addAssistantPlaceholder: () => ChatMessage;
     appendStreamContent: (content: string) => void;
@@ -78,19 +80,19 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
 }, "sessionId" | "sessions" | "messages" | "isStreaming" | "isSessionLoading">, Pick<{
     sessionId: import('vue').Ref<string, string>;
     sessions: import('vue').Ref<{
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[], SessionInfo[] | {
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[]>;
     messages: import('vue').Ref<{
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -106,9 +108,9 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
         }[] | undefined;
     }[], ChatMessage[] | {
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -127,8 +129,10 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
     isSessionLoading: import('vue').Ref<boolean, boolean>;
     initSession: () => Promise<void>;
     loadSessions: () => Promise<void>;
-    switchSession: (id: string) => void;
-    newChat: () => Promise<void>;
+    isVirtualSession: import('vue').ComputedRef<boolean>;
+    syncSessionFromHistory: () => Promise<void>;
+    switchSession: (id: number | string) => Promise<void>;
+    newChat: () => void;
     addUserMessage: (content: string) => ChatMessage;
     addAssistantPlaceholder: () => ChatMessage;
     appendStreamContent: (content: string) => void;
@@ -140,22 +144,22 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
     markStreamDone: (reportId?: number, title?: string) => void;
     markStreamError: (errorMessage: string) => void;
     clearMessages: () => void;
-}, never>, Pick<{
+}, "isVirtualSession">, Pick<{
     sessionId: import('vue').Ref<string, string>;
     sessions: import('vue').Ref<{
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[], SessionInfo[] | {
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[]>;
     messages: import('vue').Ref<{
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -171,9 +175,9 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
         }[] | undefined;
     }[], ChatMessage[] | {
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -192,8 +196,10 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
     isSessionLoading: import('vue').Ref<boolean, boolean>;
     initSession: () => Promise<void>;
     loadSessions: () => Promise<void>;
-    switchSession: (id: string) => void;
-    newChat: () => Promise<void>;
+    isVirtualSession: import('vue').ComputedRef<boolean>;
+    syncSessionFromHistory: () => Promise<void>;
+    switchSession: (id: number | string) => Promise<void>;
+    newChat: () => void;
     addUserMessage: (content: string) => ChatMessage;
     addAssistantPlaceholder: () => ChatMessage;
     appendStreamContent: (content: string) => void;
@@ -205,24 +211,24 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
     markStreamDone: (reportId?: number, title?: string) => void;
     markStreamError: (errorMessage: string) => void;
     clearMessages: () => void;
-}, "initSession" | "loadSessions" | "switchSession" | "newChat" | "addUserMessage" | "addAssistantPlaceholder" | "appendStreamContent" | "updateStatusText" | "updateSql" | "updateData" | "updateChartConfig" | "updateSources" | "markStreamDone" | "markStreamError" | "clearMessages">>;
+}, "initSession" | "loadSessions" | "syncSessionFromHistory" | "switchSession" | "newChat" | "addUserMessage" | "addAssistantPlaceholder" | "appendStreamContent" | "updateStatusText" | "updateSql" | "updateData" | "updateChartConfig" | "updateSources" | "markStreamDone" | "markStreamError" | "clearMessages">>;
 /** 默认聊天 store 实例（instanceId = 'default'） */
 export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pick<{
     sessionId: import('vue').Ref<string, string>;
     sessions: import('vue').Ref<{
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[], SessionInfo[] | {
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[]>;
     messages: import('vue').Ref<{
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -238,9 +244,9 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
         }[] | undefined;
     }[], ChatMessage[] | {
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -259,8 +265,10 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
     isSessionLoading: import('vue').Ref<boolean, boolean>;
     initSession: () => Promise<void>;
     loadSessions: () => Promise<void>;
-    switchSession: (id: string) => void;
-    newChat: () => Promise<void>;
+    isVirtualSession: import('vue').ComputedRef<boolean>;
+    syncSessionFromHistory: () => Promise<void>;
+    switchSession: (id: number | string) => Promise<void>;
+    newChat: () => void;
     addUserMessage: (content: string) => ChatMessage;
     addAssistantPlaceholder: () => ChatMessage;
     appendStreamContent: (content: string) => void;
@@ -275,19 +283,19 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
 }, "sessionId" | "sessions" | "messages" | "isStreaming" | "isSessionLoading">, Pick<{
     sessionId: import('vue').Ref<string, string>;
     sessions: import('vue').Ref<{
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[], SessionInfo[] | {
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[]>;
     messages: import('vue').Ref<{
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -303,9 +311,9 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
         }[] | undefined;
     }[], ChatMessage[] | {
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -324,8 +332,10 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
     isSessionLoading: import('vue').Ref<boolean, boolean>;
     initSession: () => Promise<void>;
     loadSessions: () => Promise<void>;
-    switchSession: (id: string) => void;
-    newChat: () => Promise<void>;
+    isVirtualSession: import('vue').ComputedRef<boolean>;
+    syncSessionFromHistory: () => Promise<void>;
+    switchSession: (id: number | string) => Promise<void>;
+    newChat: () => void;
     addUserMessage: (content: string) => ChatMessage;
     addAssistantPlaceholder: () => ChatMessage;
     appendStreamContent: (content: string) => void;
@@ -337,22 +347,22 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
     markStreamDone: (reportId?: number, title?: string) => void;
     markStreamError: (errorMessage: string) => void;
     clearMessages: () => void;
-}, never>, Pick<{
+}, "isVirtualSession">, Pick<{
     sessionId: import('vue').Ref<string, string>;
     sessions: import('vue').Ref<{
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[], SessionInfo[] | {
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[]>;
     messages: import('vue').Ref<{
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -368,9 +378,9 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
         }[] | undefined;
     }[], ChatMessage[] | {
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -389,8 +399,10 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
     isSessionLoading: import('vue').Ref<boolean, boolean>;
     initSession: () => Promise<void>;
     loadSessions: () => Promise<void>;
-    switchSession: (id: string) => void;
-    newChat: () => Promise<void>;
+    isVirtualSession: import('vue').ComputedRef<boolean>;
+    syncSessionFromHistory: () => Promise<void>;
+    switchSession: (id: number | string) => Promise<void>;
+    newChat: () => void;
     addUserMessage: (content: string) => ChatMessage;
     addAssistantPlaceholder: () => ChatMessage;
     appendStreamContent: (content: string) => void;
@@ -402,5 +414,5 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
     markStreamDone: (reportId?: number, title?: string) => void;
     markStreamError: (errorMessage: string) => void;
     clearMessages: () => void;
-}, "initSession" | "loadSessions" | "switchSession" | "newChat" | "addUserMessage" | "addAssistantPlaceholder" | "appendStreamContent" | "updateStatusText" | "updateSql" | "updateData" | "updateChartConfig" | "updateSources" | "markStreamDone" | "markStreamError" | "clearMessages">>;
+}, "initSession" | "loadSessions" | "syncSessionFromHistory" | "switchSession" | "newChat" | "addUserMessage" | "addAssistantPlaceholder" | "appendStreamContent" | "updateStatusText" | "updateSql" | "updateData" | "updateChartConfig" | "updateSources" | "markStreamDone" | "markStreamError" | "clearMessages">>;
 export {};

package/dist/src/types/agent.d.ts

@@ -3,8 +3,28 @@ import { ComputedRef, InjectionKey } from 'vue';
 export type AgentThemeMode = 'dark' | 'light';
 /** 主题变量覆盖：键为 CSS 变量名（含 --agent- 前缀），值为 CSS 值 */
 export type AgentThemeOverrides = Record<string, string>;
+/** 自定义请求参数 key 名称，用于适配不同后端接口的参数命名 */
+export interface ParamKeys {
+    /** 智能体 ID 参数名，默认 'agent_id' */
+    agent_id?: string;
+    /** 查询内容参数名，默认 'query' */
+    query?: string;
+    /** 会话 ID 参数名，默认 'session_id' */
+    session_id?: string;
+    /** 外部用户 ID 参数名，默认 'ext_user_id' */
+    ext_user_id?: string;
+}
+/** 解析后的参数 key 名称（合并默认值后所有字段必填） */
+export interface ResolvedParamKeys {
+    agent_id: string;
+    query: string;
+    session_id: string;
+    ext_user_id: string;
+}
 /** 拖拽约束模式 */
 export type DragConstrainMode = 'viewport' | 'none';
+/** 弹窗方位（9 个方向，类似 ElPopover/ElTooltip 的 placement） */
+export type AgentWindowPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'right' | 'auto';
 /** 智能体插件配置（所有字段均可选，由组件 props 或 install 时传入） */
 export interface AgentPluginOptions {
     /** API 基础地址（如 http://host:port/api/v2） */
@@ -13,16 +33,22 @@ export interface AgentPluginOptions {
     getAccessToken?: () => string;
     /** 认证 session 获取函数 */
     getSession?: () => string;
-    /** 用户 ID 获取函数，用于创建/查询会话（动态场景优先使用） */
-    getUserId?: () => string;
-    /** 用户 ID 静态值（简化用法，getUserId 优先） */
-    userId?: string;
-    /** LLM 提供商 ID */
-    llmProviderId?: number;
-    /** 提示词模板 ID */
-    promptTemplateId?: number;
-    /** 自定义提示词 */
-    customPrompt?: string;
+    /** 智能体 ID 获取函数（动态场景优先使用，agent_id 为必传值） */
+    getAgentId?: () => string;
+    /** 智能体 ID 静态值（必传，getAgentId 优先） */
+    agentId?: string;
+    /** 外部用户 ID 获取函数，用于创建/查询会话（动态场景优先使用） */
+    getExtUserId?: () => string;
+    /** 外部用户 ID 静态值（简化用法，getExtUserId 优先） */
+    extUserId?: string;
+    /** 自定义请求参数 key 名称，默认 { agent_id, query, session_id, ext_user_id } */
+    paramKeys?: ParamKeys;
+    /** 应用 Key，用于自动生成 X-App-Key 等安全签名头（与 appSecret 配合使用） */
+    appKey?: string;
+    /** 应用密钥，用于 HMAC-SHA256 签名（与 appKey 配合使用） */
+    appSecret?: string;
+    /** 安全请求头获取函数，优先级高于 appKey/appSecret 自动签名，用于完全自定义签名逻辑 */
+    getSecurityHeaders?: () => Record<string, string>;
     /** 窗口标题文本 */
     headerTitle?: string;
     /** 空状态提示文本 */
@@ -43,6 +69,16 @@ export interface AgentPluginOptions {
     draggable?: boolean;
     /** 拖拽约束模式：'viewport' 限制在视口内，'none' 不限制（但仍不超出可见区域），默认 'viewport' */
     dragConstrain?: DragConstrainMode;
+    /** 弹窗相对按钮的方位，默认 'top-end'（按钮上方右对齐） */
+    placement?: AgentWindowPlacement;
+    /** 用户头像 URL（支持 svg/png/jpg 等图片格式，不传则使用默认图标） */
+    userAvatar?: string;
+    /** AI 助手头像 URL（支持 svg/png/jpg 等图片格式，不传则使用默认图标） */
+    assistantAvatar?: string;
+    /** 是否显示欢迎气泡，默认 true */
+    showWelcome?: boolean;
+    /** 欢迎词文本，默认 '请问有什么可以帮你？' */
+    welcomeMessage?: string;
 }
 /** provide/inject key */
 export declare const AGENT_CONFIG_KEY: InjectionKey<ComputedRef<AgentPluginOptions>>;
@@ -90,15 +126,16 @@ export interface ChatMessage {
 }
 /** 会话信息 */
 export interface SessionInfo {
-    id: string;
+    id: number | string;
     title: string;
     created_at: string;
 }
 /** 流式请求参数 */
 export interface StreamRequestData {
-    sessionId: string;
+    /** 会话 ID（可选，选择历史记录后传入对应 session_id） */
+    sessionId?: string;
+    /** 用户查询内容 */
     query: string;
-    userId?: string;
 }
 /** 流式事件类型 */
 export type StreamEventType = 'status' | 'sql' | 'data' | 'chart_config' | 'sources' | 'analysis_chunk' | 'delta' | 'done' | 'error';

package/dist/src/views/AgentChat.vue.d.ts

@@ -9,7 +9,7 @@ declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {
     sessionId: string;
     /** 历史会话列表 */
     sessions: {
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[];
@@ -42,9 +42,9 @@ declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {
     /** 加载历史会话列表 */
     loadSessions: () => Promise<void>;
     /** 切换到指定会话 */
-    switchSession: (id: string) => void;
+    switchSession: (id: number | string) => Promise<void>;
     /** 新建聊天 */
-    newChat: () => Promise<void>;
+    newChat: () => void;
     /** 清空对话消息 */
     clearMessages: () => void;
     /** 切换窗口显示 */

package/dist/src/views/AgentChatFull.vue.d.ts

@@ -7,7 +7,7 @@ declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {
     sessionId: string;
     /** 历史会话列表 */
     sessions: {
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[];
@@ -40,9 +40,9 @@ declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {
     /** 加载历史会话列表 */
     loadSessions: () => Promise<void>;
     /** 切换到指定会话 */
-    switchSession: (id: string) => void;
+    switchSession: (id: number | string) => Promise<void>;
     /** 新建聊天 */
-    newChat: () => Promise<void>;
+    newChat: () => void;
     /** 清空对话消息 */
     clearMessages: () => void;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {

package/dist/src/views/AgentChatMobile.vue.d.ts

@@ -9,7 +9,7 @@ declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {
     sessionId: string;
     /** 历史会话列表 */
     sessions: {
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[];
@@ -42,9 +42,9 @@ declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {
     /** 加载历史会话列表 */
     loadSessions: () => Promise<void>;
     /** 切换到指定会话 */
-    switchSession: (id: string) => void;
+    switchSession: (id: number | string) => Promise<void>;
     /** 新建聊天 */
-    newChat: () => Promise<void>;
+    newChat: () => void;
     /** 清空对话消息 */
     clearMessages: () => void;
     /** 历史抽屉可见 */