@chatbi-v/vue 3.0.0 → 3.1.1

package/dist/core/src/domain/models.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 成功状态码
+ */
+export declare const SUCCESS_CODE = "000000";
+/**
+ * 基础 API 响应接口
+ * @template T 响应数据的类型
+ */
+export interface BaseResponse<T = any> {
+    /** 业务状态码 */
+    code: string | number;
+    /** 响应消息提示 */
+    message: string;
+    /** 业务响应数据主体 */
+    data: T;
+}
+/**
+ * 业务场景实体接口
+ * @description 描述系统中的业务分析场景
+ */
+export interface Scene {
+    /** 场景唯一标识符 */
+    id: string;
+    /** 场景名称 */
+    name: string;
+    /** 场景详细描述 */
+    description: string;
+    /** 场景内部代码/标识 */
+    code: string;
+    /** 场景创建者 ID 或名称 */
+    creator: string;
+    /** 创建时间字符串 (ISO 格式) */
+    createTime: string;
+    /** 该场景关联的物理数据表数量 */
+    tableCount: number;
+    /** 该场景关联的知识库数量 */
+    kbCount: number;
+    /** 该场景关联的预设问答对数量 */
+    qaCount: number;
+    /** 场景封面图 URL (可选) */
+    cover?: string;
+}

package/dist/core/src/domain/performance/collector.d.ts

@@ -0,0 +1,70 @@
+import { PerformanceStorage } from './storage';
+import type { LifecycleMetric, LifecyclePhase, RuntimeMetric } from './types';
+/**
+ * 性能计时器
+ * @description 用于测量代码块执行耗时，自动计算 duration 并保存到存储
+ */
+export declare class PerformanceTimer {
+    private startTime;
+    private phase;
+    private pluginId;
+    private storage;
+    /**
+     * 构造函数
+     * @param phase - 生命周期阶段
+     * @param pluginId - 插件 ID
+     * @param storage - 性能存储实例
+     */
+    constructor(phase: LifecyclePhase, pluginId: string, storage: PerformanceStorage);
+    /**
+     * 开始计时
+     */
+    start(): void;
+    /**
+     * 结束计时并保存结果
+     * @param success - 是否成功
+     * @param error - 错误信息（可选）
+     */
+    end(success: boolean, error?: string): void;
+}
+/**
+ * 性能数据采集器
+ * @description 负责性能数据的采集和记录，提供计时器创建和运行时指标记录功能
+ */
+export declare class PerformanceCollector {
+    private storage;
+    /**
+     * 构造函数
+     * @param storage - 性能存储实例
+     */
+    constructor(storage: PerformanceStorage);
+    /**
+     * 开始测量指定生命周期阶段
+     * @param phase - 生命周期阶段
+     * @param pluginId - 插件 ID
+     * @returns PerformanceTimer 实例
+     */
+    startMeasure(phase: LifecyclePhase, pluginId: string): PerformanceTimer;
+    /**
+     * 记录运行时指标
+     * @param metric - 运行时指标（不包含 timestamp）
+     */
+    recordRuntimeMetric(metric: Omit<RuntimeMetric, 'timestamp'>): void;
+    /**
+     * 获取性能指标
+     * @param pluginId - 插件 ID（可选，不传则返回所有）
+     */
+    getMetrics(pluginId?: string): {
+        lifecycle: LifecycleMetric[];
+        runtime: RuntimeMetric[];
+    };
+    /**
+     * 清除性能数据
+     * @param pluginId - 插件 ID（可选，不传则清除所有）
+     */
+    clearMetrics(pluginId?: string): void;
+    /**
+     * 获取存储实例（供外部使用）
+     */
+    getStorage(): PerformanceStorage;
+}

package/dist/core/src/domain/performance/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @file performance/index.ts
+ * @description 性能监测模块统一导出
+ * @author ChatBI Team
+ */
+export type { LifecycleMetric, LifecyclePhase, PerformanceData, PerformanceSettings, RuntimeMetric, } from './types';
+export { DEFAULT_PERFORMANCE_SETTINGS } from './types';
+export { PerformanceCollector } from './collector';
+export { PerformanceTimer } from './collector';
+export { createLifecycleMonitor, LifecycleMonitor } from './lifecycle';
+export { PerformanceStorage } from './storage';
+import type { StorageManager } from '../storage-manager';
+import { PerformanceCollector } from './collector';
+import { LifecycleMonitor } from './lifecycle';
+import { PerformanceStorage } from './storage';
+import type { PerformanceSettings } from './types';
+/**
+ * 性能监测系统工厂函数
+ * @param storageManager - 存储管理器实例
+ * @param settings - 性能设置（可选）
+ * @returns 包含 collector, storage, monitor 的对象
+ */
+export declare function createPerformanceMonitor(storageManager: StorageManager, settings?: PerformanceSettings): {
+    collector: PerformanceCollector;
+    storage: PerformanceStorage;
+    createMonitor: (runtime: any) => LifecycleMonitor;
+};

package/dist/core/src/domain/performance/lifecycle.d.ts

@@ -0,0 +1,34 @@
+import type { PluginRuntime } from '../plugin-runtime';
+import { PerformanceCollector } from './collector';
+/**
+ * 生命周期监测器（装饰器模式）
+ * @description 通过代理模式包装 PluginRuntime，在生命周期各阶段自动记录耗时
+ */
+export declare class LifecycleMonitor {
+    private runtime;
+    private collector;
+    /**
+     * 构造函数
+     * @param runtime - 插件运行时实例
+     * @param collector - 性能采集器实例
+     */
+    constructor(runtime: PluginRuntime, collector: PerformanceCollector);
+    /**
+     * 包装插件运行时，返回代理对象
+     * @returns 包装后的运行时对象
+     */
+    wrap(): PluginRuntime;
+    /**
+     * 包装指定方法，在执行前后记录耗时
+     * @param phase - 生命周期阶段
+     * @param originalMethod - 原始方法
+     */
+    private wrapMethod;
+}
+/**
+ * 创建生命周期监测器
+ * @param runtime - 插件运行时实例
+ * @param collector - 性能采集器实例
+ * @returns LifecycleMonitor 实例
+ */
+export declare function createLifecycleMonitor(runtime: PluginRuntime, collector: PerformanceCollector): LifecycleMonitor;

package/dist/core/src/domain/performance/storage.d.ts

@@ -0,0 +1,79 @@
+import { StorageManager } from '../storage-manager';
+import type { LifecycleMetric, PerformanceData, PerformanceSettings, RuntimeMetric } from './types';
+/**
+ * 性能数据存储层
+ * @description 负责性能数据的持久化，支持生命周期指标和运行时采样数据的存储与查询
+ */
+export declare class PerformanceStorage {
+    private storageManager;
+    private systemStorage;
+    private settings;
+    private lifecycleCache;
+    private runtimeCache;
+    private readonly LIFECYCLE_KEY;
+    private readonly RUNTIME_KEY;
+    /**
+     * 构造函数
+     * @param storageManager - 存储管理器实例
+     * @param settings - 性能设置（可选，默认使用 DEFAULT_PERFORMANCE_SETTINGS）
+     */
+    constructor(storageManager: StorageManager, settings?: PerformanceSettings);
+    /**
+     * 从持久化存储加载数据到内存缓存
+     */
+    private loadFromStorage;
+    /**
+     * 保存生命周期指标
+     * @param metric - 生命周期指标
+     */
+    saveLifecycleMetric(metric: LifecycleMetric): void;
+    /**
+     * 保存运行时指标
+     * @param metric - 运行时指标
+     */
+    saveRuntimeMetric(metric: RuntimeMetric): void;
+    /**
+     * 保存指标（通用方法，自动识别类型）
+     * @param metric - 指标数据
+     */
+    saveMetric(metric: LifecycleMetric | RuntimeMetric): void;
+    /**
+     * 强制执行生命周期数据上限（FIFO）
+     */
+    private enforceLifecycleLimit;
+    /**
+     * 强制执行运行时数据上限（FIFO）
+     */
+    private enforceRuntimeLimit;
+    /**
+     * 持久化生命周期数据
+     */
+    private persistLifecycle;
+    /**
+     * 持久化运行时数据
+     */
+    private persistRuntime;
+    /**
+     * 获取生命周期指标
+     * @param pluginId - 插件 ID（可选，不传则返回所有）
+     */
+    getLifecycleMetrics(pluginId?: string): LifecycleMetric[];
+    /**
+     * 获取运行时指标
+     * @param pluginId - 插件 ID（可选，不传则返回所有）
+     */
+    getRuntimeMetrics(pluginId?: string): RuntimeMetric[];
+    /**
+     * 清除性能数据
+     * @param pluginId - 插件 ID（可选，不传则清除所有）
+     */
+    clearMetrics(pluginId?: string): void;
+    /**
+     * 获取所有性能数据
+     */
+    getAllData(): PerformanceData;
+    /**
+     * 获取指定插件的性能数据
+     */
+    getPluginData(pluginId: string): PerformanceData;
+}

package/dist/core/src/domain/performance/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @file performance/types.ts
+ * @description 性能监测数据类型定义
+ * @author ChatBI Team
+ */
+/**
+ * 插件生命周期阶段
+ */
+export type LifecyclePhase = 'load' | 'mount' | 'unmount';
+/**
+ * 生命周期性能指标
+ * 记录插件 load/mount/unmount 阶段的执行耗时
+ */
+export interface LifecycleMetric {
+    /** 插件 ID */
+    pluginId: string;
+    /** 生命周期阶段 */
+    phase: LifecyclePhase;
+    /** 执行耗时（毫秒） */
+    duration: number;
+    /** 时间戳 */
+    timestamp: number;
+    /** 是否成功 */
+    success: boolean;
+    /** 错误信息（仅在 success 为 false 时存在） */
+    error?: string;
+}
+/**
+ * 运行时性能指标
+ * 记录插件运行期间的内存、帧率等数据
+ */
+export interface RuntimeMetric {
+    /** 插件 ID */
+    pluginId: string;
+    /** 时间戳 */
+    timestamp: number;
+    /** 内存使用量（字节） */
+    memory?: number;
+    /** 帧率 */
+    fps?: number;
+    /** API 调用次数 */
+    apiCalls?: number;
+}
+/**
+ * 性能数据集合
+ */
+export interface PerformanceData {
+    /** 生命周期指标集合 */
+    lifecycle: LifecycleMetric[];
+    /** 运行时采样数据集合 */
+    samples: RuntimeMetric[];
+}
+/**
+ * 性能监测配置
+ */
+export interface PerformanceSettings {
+    /** 生命周期记录最大条数（默认 1000） */
+    maxLifecycleRecords: number;
+    /** 运行时采样最大条数（默认 500） */
+    maxRuntimeSamples: number;
+    /** 采样率（0-1 之间） */
+    sampleRate: number;
+}
+/**
+ * 默认性能监测配置
+ */
+export declare const DEFAULT_PERFORMANCE_SETTINGS: PerformanceSettings;

package/dist/core/src/domain/plugin-manager.d.ts

@@ -0,0 +1,327 @@
+/**
+ * @file plugin-manager.ts
+ * @description 插件管理器，负责插件的注册、生命周期管理、状态持久化及扩展点收集
+ * @author ChatBI Team
+ */
+import { DefaultEventBus } from '../event-bus';
+import type { PluginManifest } from '../manifest/PluginManifest';
+import { Plugin, PluginExtension, RouteConfig, SlotPosition } from '../ports/plugin-port';
+import { StoragePort } from '../ports/storage-port';
+import { PluginRuntime } from './plugin-runtime';
+import { StorageManager } from './storage-manager';
+/**
+ * 插件错误分类
+ */
+export declare enum PluginErrorType {
+    /** 可恢复错误：网络波动、超时等，可以重试 */
+    RECOVERABLE = "recoverable",
+    /** 致命错误：语法错误、循环依赖等，无法通过重试恢复 */
+    FATAL = "fatal",
+    /** 配置错误：插件配置无效 */
+    CONFIG = "config",
+    /** 依赖错误：依赖插件不存在或版本不匹配 */
+    DEPENDENCY = "dependency"
+}
+/**
+ * 插件错误
+ */
+export declare class PluginError extends Error {
+    pluginId: string;
+    type: PluginErrorType;
+    originalError?: Error;
+    retryCount: number;
+    constructor(pluginId: string, type: PluginErrorType, message: string, originalError?: Error, retryCount?: number);
+}
+/**
+ * 插件管理器
+ * @description 核心领域服务，负责插件的完整生命周期管理，包括扫描、注册、配置合并、状态切换及依赖解析。
+ */
+export declare class PluginManager {
+    /** 全局事件总线，用于插件间及插件与内核间的异步通信 */
+    readonly eventBus: DefaultEventBus;
+    /** 存储管理服务，负责插件私有存储和系统级状态的持久化 */
+    private storageManager;
+    /** 插件 ID 到运行时实例的映射表 */
+    private runtimes;
+    /** 插件 ID 到原始插件定义对象的映射表 */
+    private plugins;
+    /** 收集到的所有插件路由配置 */
+    private routes;
+    /** 收集到的所有插件扩展点配置，按插槽位置分组 */
+    private extensions;
+    /** 插件的启用状态和排序信息的内存缓存 */
+    private pluginStates;
+    /** 扩展点缓存，避免重复计算 */
+    private memoizedExtensions;
+    /** 路由缓存 */
+    private memoizedRoutes;
+    /** 传递给插件的共享上下文缓存 */
+    private sharedContext;
+    /** 收集到的插件工具函数集合 */
+    private utils;
+    /** 插件强制启用标记（系统插件不可禁用） */
+    private pluginForces;
+    /** 插件懒加载标记 */
+    private pluginLazyInit;
+    /** 插件默认启用状态 */
+    private pluginDefaultEnabled;
+    /** 是否正在初始化插件中，防止重入导致多次加载 */
+    private isInitializing;
+    /**
+     * 构造函数
+     * @param storage - 底层存储适配器
+     */
+    constructor(storage: StoragePort);
+    /**
+     * 从持久化存储中恢复插件状态 (启用/禁用、排序等)
+     */
+    private loadStates;
+    /**
+     * 将当前的插件状态持久化到存储中
+     */
+    private saveStates;
+    /**
+     * 订阅插件状态变更
+     * @param listener 回调函数，当插件状态变更时被调用
+     * @returns 取消订阅的函数
+     */
+    subscribe(listener: () => void): () => void;
+    /**
+     * 订阅路由变更
+     * @param listener 回调函数，当路由变更时被调用
+     * @returns 取消订阅的函数
+     */
+    subscribeToRoutes(listener: () => void): () => void;
+    /**
+     * 获取存储管理器实例
+     * @returns StorageManager 实例
+     */
+    getStorageManager(): StorageManager;
+    /**
+     * 用于调度状态更新的函数，可由外部宿主环境（如 React）注入
+     */
+    private stateUpdateScheduler;
+    /**
+     * 注入状态更新调度器
+     */
+    setUpdateScheduler(scheduler: (callback: () => void) => void): void;
+    /**
+     * 触发状态变更通知
+     * @description 统一使用 Zustand Store 进行状态管理，EventBus 仅用于一次性事件
+     * @param affectedSlot - (可选) 受影响的插槽位置
+     */
+    private notify;
+    /**
+     * 获取指定插件
+     * @param pluginId 插件 ID
+     */
+    getPlugin(pluginId: string): Plugin | undefined;
+    /**
+     * 检查插件是否已注册
+     * @param pluginId - 插件 ID
+     */
+    hasPlugin(pluginId: string): boolean;
+    /**
+     * 获取指定插件的运行时实例
+     * @param pluginId 插件 ID
+     * @returns 插件运行时实例，如果不存在则返回 undefined
+     */
+    getPluginRuntime(pluginId: string): PluginRuntime | undefined;
+    /**
+     * 激活插件
+     * @param pluginId - 插件 ID
+     */
+    activate(pluginId: string): Promise<void>;
+    /**
+     * 获取所有已注册的插件列表
+     * @description 结果会根据插件类型优先级和用户自定义排序进行排序
+     * @returns 排序后的插件数组
+     */
+    getPlugins(): Plugin[];
+    /**
+     * 获取指定插件的状态信息
+     * @param pluginId - 插件 ID
+     * @returns 包含启用状态和排序值的对象
+     */
+    getPluginState(pluginId: string): {
+        enabled: boolean;
+        order: number;
+    };
+    /**
+     * 检查指定插件是否处于启用状态
+     * @param pluginId - 插件 ID
+     * @returns 是否启用
+     */
+    isPluginEnabled(pluginId: string): boolean;
+    /**
+     * 检查插件是否可禁用
+     * @param pluginId - 插件 ID
+     * @returns 是否可禁用
+     */
+    canDisablePlugin(pluginId: string): boolean;
+    /**
+     * 检查插件是否应默认启用
+     * @param pluginId - 插件 ID
+     * @returns 是否默认启用
+     */
+    shouldEnableByDefault(pluginId: string): boolean;
+    /**
+     * 切换插件的启用/禁用状态
+     * @description 禁用插件会立即触发其卸载生命周期并销毁运行时。
+     * @param pluginId - 插件 ID
+     * @param enabled - 目标状态
+     */
+    togglePlugin(pluginId: string, enabled: boolean): void;
+    /**
+     * 删除插件及其所有关联状态
+     * @description 完整清理流程：禁用 -> 卸载运行时 -> 清理存储 -> 清理配置 -> 清理状态 -> 通知
+     * @param pluginId - 插件 ID
+     * @param cleanupStorage - 是否清理存储（默认 true）
+     */
+    deletePlugin(pluginId: string, cleanupStorage?: boolean): Promise<void>;
+    /**
+     * 更新插件元数据和包地址
+     * @description 更新流程：禁用旧版本 -> 卸载 -> 更新元数据 -> 重新加载并激活
+     * @param pluginId - 插件 ID
+     * @param newManifest - 新的插件清单
+     * @param newBundleUrl - 新的包地址（可选，如果不改变则传 undefined）
+     */
+    updatePlugin(pluginId: string, newManifest: Partial<PluginManifest>, newBundleUrl?: string): Promise<void>;
+    /**
+     * 设置插件的显示排序权重
+     * @param pluginId - 插件 ID
+     * @param order - 排序权重值
+     */
+    setPluginOrder(pluginId: string, order: number): void;
+    /**
+     * 获取指定插件的运行时状态
+     * @param pluginId - 插件 ID
+     * @returns 'error' | 'mounted' | 'loaded' | 'initial'
+     */
+    getPluginRuntimeStatus(pluginId: string): "error" | "mounted" | "loaded" | "initial";
+    /**
+     * 获取指定插件的运行时错误
+     * @param pluginId - 插件 ID
+     * @returns Error 对象或 null
+     */
+    getPluginError(pluginId: string): Error;
+    /**
+     * 报告插件运行时错误 (通常由 ErrorBoundary 调用)
+     * @param pluginId - 插件 ID
+     * @param error - 错误对象
+     */
+    reportPluginError(pluginId: string, error: Error): void;
+    /**
+     * 获取插件的完整能力声明
+     * @param pluginId - 插件 ID
+     * @returns 能力对象
+     */
+    getUnifiedCapabilities(pluginId: string): import("src").PluginCapabilities;
+    /**
+     * 更新指定插件的某项配置
+     * @description 该操作会同步更新内存中的配置、持久化到存储并触发全局事件通知。
+     * @param pluginId - 插件 ID
+     * @param key - 配置键名
+     * @param value - 新的配置值
+     */
+    updatePluginConfig(pluginId: string, key: string, value: any): void;
+    /**
+     * 获取指定插件的某项配置值
+     * @param pluginId - 插件 ID
+     * @param key - 配置键名
+     * @returns 配置值
+     */
+    getPluginConfig(pluginId: string, key: string): any;
+    /**
+     * 获取系统全局配置 (非插件特定)
+     * @param key - 系统配置键名
+     * @returns 配置值
+     */
+    getSystemConfig(key: string): any;
+    /**
+     * 获取由插件注册的服务实例
+     * @template T 服务接口类型
+     * @param name - 服务注册名称
+     * @returns 服务实例或 undefined
+     */
+    getService<T = any>(name: string): T | undefined;
+    /**
+     * 获取指定插槽位置的所有已启用插件的扩展
+     * @param slot - 插槽位置标识
+     * @returns 排序后的扩展配置数组
+     */
+    getExtensions(slot: SlotPosition | string): PluginExtension[];
+    /**
+     * 获取所有已启用插件注册的路由配置
+     * @returns 增强后的路由配置数组
+     */
+    getRoutes(): RouteConfig[];
+    /**
+     * 注册一个新插件到管理器中
+     * @description 此阶段会执行元数据校验、存储 Schema 注册、配置合并及扩展点收集。
+     * @param plugin - 插件对象
+     * @param notify - 是否在注册完成后触发状态变更通知
+     */
+    register(plugin: Plugin, notify?: boolean): void;
+    /**
+     * 手动挂载指定插件（支持按需加载）
+     * @description 如果插件依赖尚未挂载，会递归挂载所有依赖
+     * @param pluginId 插件 ID
+     */
+    mountPlugin(pluginId: string): Promise<void>;
+    /**
+     * 初始化所有插件
+     * @param sharedContext 共享上下文
+     * @param autoMount 是否自动挂载所有插件 (默认为 false，启用按需加载模式)
+     */
+    initPlugins(sharedContext?: Record<string, any>, autoMount?: boolean): Promise<void>;
+    /**
+     * 带重试机制的插件加载
+     */
+    private loadPluginWithRetry;
+    /**
+     * 带重试机制的插件挂载
+     */
+    private mountPluginWithRetry;
+    /**
+     * 获取排序后的插件 ID 列表 (处理依赖)
+     */
+    private getSortedPluginIds;
+    /**
+     * 加载插件列表
+     * @param configs 插件配置
+     * @param registry 插件注册表 (动态导入函数)
+     * @param notify 是否在加载完成后触发通知，默认为 true
+     */
+    loadPlugins(configs: Record<string, any>, registry: Record<string, () => Promise<any>>, notify?: boolean): Promise<void>;
+    /**
+     * 加载远程插件
+     * @param pluginId 插件 ID
+     * @param url 远程 URL
+     * @param config 插件配置
+     */
+    loadRemotePlugin(pluginId: string, url: string, config: any): Promise<Plugin | null>;
+    /**
+     * IIFE 模式加载插件
+     */
+    private loadIIFEPlugin;
+    /**
+     * 实例化插件
+     */
+    private instantiatePlugin;
+    private validatePlugin;
+    private handleBusinessPlugin;
+    private handleFunctionalPlugin;
+    private handleViewPlugin;
+    private handleThemePlugin;
+    private handleRendererPlugin;
+    private handleSystemPlugin;
+    /**
+     * 注册插件默认配置
+     */
+    private registerDefaultConfig;
+}
+/**
+ * 全局插件管理器实例
+ */
+export declare const pluginManager: PluginManager;