@chatbi-v/vue 3.0.0 → 3.1.1

package/README.md

@@ -0,0 +1,36 @@
+# @chatbi-v/vue
+
+ChatBI-V Vue 3 适配器层，提供 Vue 3 组件与核心模块的桥接。
+
+## 模块功能
+
+- **Vue 3 集成**: 为 Vue 3 应用提供 ChatBI 核心能力
+- **组合式 API**: 使用 Vue 3 Composition API 设计
+- **类型支持**: 完整的 TypeScript 类型推导
+
+## 安装
+
+```bash
+pnpm add @chatbi-v/vue
+```
+
+## 使用
+
+```vue
+<script setup>
+import { usePlugin, useTheme } from '@chatbi-v/vue';
+
+const { plugin } = usePlugin('my-plugin');
+const { tokens } = useTheme();
+</script>
+
+<template>
+  <div>{{ plugin?.name }}</div>
+</template>
+```
+
+## API
+
+- `usePlugin(id)` - 获取插件实例
+- `useTheme()` - 获取主题 Token
+- `useFeature(featureId)` - 获取功能状态

package/dist/core/src/adapters/AdapterInterface.d.ts

@@ -0,0 +1,111 @@
+/**
+ * @file AdapterInterface.ts
+ * @description UI 适配器接口定义，提供统一的适配器契约
+ * @author ChatBI Team
+ */
+interface DesignSystemTokens {
+    meta: {
+        id: string;
+        name: string;
+        version: string;
+        mode: 'light' | 'dark' | 'system';
+    };
+    primitives: Record<string, any>;
+    semantics: Record<string, any>;
+    semanticsDark?: Record<string, any>;
+    components: Record<string, any>;
+    componentsDark?: Record<string, any>;
+}
+/**
+ * UI 适配器接口
+ * 定义所有 UI 库适配器必须实现的契约
+ */
+export interface UIAdapter {
+    /** 适配器唯一标识符 */
+    readonly id: string;
+    /** 适配器显示名称 */
+    readonly name: string;
+    /** 适配器版本 */
+    readonly version: string;
+    /** 目标 UI 库标识 (如: 'antd', 'mui', 'chakra') */
+    readonly targetLibrary: string;
+    /** 兼容的 UI 库版本 */
+    readonly compatibleVersion?: string;
+    /**
+     * 将 DesignSystem 转换为目标 UI 库的主题配置
+     * @param tokens 设计系统 Token
+     * @param options 转换选项
+     * @returns 目标 UI 库的主题配置对象
+     */
+    transform(tokens: DesignSystemTokens, options?: TransformOptions): any;
+    /**
+     * 应用主题到目标 UI 库
+     * @param theme 转换后的主题配置
+     */
+    apply(theme: any): void;
+    /**
+     * 移除已应用的主题
+     */
+    remove(): void;
+}
+/**
+ * Token 转换选项
+ */
+export interface TransformOptions {
+    /** 颜色方案 */
+    colorScheme?: 'light' | 'dark';
+    /** 组件级别覆盖配置 */
+    componentOverrides?: Record<string, any>;
+    /** CSS 变量前缀 */
+    prefix?: string;
+}
+/**
+ * 适配器工厂函数类型
+ */
+export interface AdapterFactory {
+    /** 创建适配器实例 */
+    create(config?: any): UIAdapter;
+}
+/**
+ * 适配器状态类型
+ */
+export type AdapterStatus = 'registered' | 'active' | 'inactive' | 'error';
+/**
+ * 适配器运行时状态
+ */
+export interface AdapterState {
+    /** 适配器实例 */
+    adapter: UIAdapter;
+    /** 当前状态 */
+    status: AdapterStatus;
+    /** 错误信息 (仅在 error 状态时有效) */
+    error?: Error;
+    /** 注册时间 */
+    registeredAt: Date;
+    /** 激活时间 */
+    activatedAt?: Date;
+}
+/**
+ * 适配器抽象基类
+ * 提供通用的适配器实现模板
+ */
+export declare abstract class BaseAdapter implements UIAdapter {
+    abstract readonly id: string;
+    abstract readonly name: string;
+    abstract readonly version: string;
+    abstract readonly targetLibrary: string;
+    /**
+     * 模板方法 - 三层变换默认实现
+     * primitives -> semantics -> component tokens
+     */
+    protected transformTokens(tokens: DesignSystemTokens, options?: TransformOptions): any;
+    /**
+     * 将语义 Token 转换为组件级别配置
+     * 由子类实现具体转换逻辑
+     */
+    protected semanticsToComponents(semantics: any, options?: TransformOptions): any;
+    transform(tokens: DesignSystemTokens, options?: TransformOptions): any;
+    abstract apply(theme: any): void;
+    abstract remove(): void;
+}
+export {};

package/dist/core/src/adapters/AdapterRegistry.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @file AdapterRegistry.ts
+ * @description 适配器注册发现机制，管理 UI 适配器的注册、激活和查询
+ * @author ChatBI Team
+ */
+import type { AdapterState, TransformOptions, UIAdapter } from './AdapterInterface';
+/**
+ * 适配器注册表
+ * 提供适配器的注册、注销、激活和查询功能
+ */
+export declare class AdapterRegistry {
+    private adapters;
+    private states;
+    private activeAdapterId;
+    private currentTokens;
+    /**
+     * 注册适配器
+     * @param adapter 要注册的 UIAdapter 实例
+     */
+    register(adapter: UIAdapter): void;
+    /**
+     * 注销适配器
+     * @param adapterId 要注销的适配器 ID
+     * @returns 是否成功注销
+     */
+    unregister(adapterId: string): boolean;
+    /**
+     * 获取指定适配器
+     * @param adapterId 适配器 ID
+     * @returns 适配器实例或 undefined
+     */
+    get(adapterId: string): UIAdapter | undefined;
+    /**
+     * 获取所有已注册的适配器
+     * @returns 所有适配器实例数组
+     */
+    getAll(): UIAdapter[];
+    /**
+     * 获取所有适配器状态
+     * @returns 所有适配器状态数组
+     */
+    getAllStates(): AdapterState[];
+    /**
+     * 设置活跃适配器
+     * @param adapterId 要激活的适配器 ID
+     * @returns 是否成功激活
+     */
+    setActive(adapterId: string): boolean;
+    /**
+     * 获取当前活跃适配器
+     * @returns 活跃适配器实例或 undefined
+     */
+    getActive(): UIAdapter | undefined;
+    /**
+     * 使用当前活跃适配器转换 Token
+     * @param tokens DesignSystem Token
+     * @param options 转换选项
+     * @returns 转换后的主题配置
+     */
+    transform(tokens: any, options?: TransformOptions): any;
+    /**
+     * 检查是否支持指定目标库
+     * @param targetLibrary 目标库标识
+     * @returns 是否支持
+     */
+    supports(targetLibrary: string): boolean;
+    /**
+     * 获取支持指定目标库的所有适配器
+     * @param targetLibrary 目标库标识
+     * @returns 适配器数组
+     */
+    getAdaptersForTarget(targetLibrary: string): UIAdapter[];
+    /**
+     * 设置当前 DesignSystem Token
+     * @param tokens DesignSystem 实例
+     */
+    setTokens(tokens: any): void;
+    /**
+     * 获取当前 DesignSystem Token
+     * @returns 当前 Token
+     */
+    getTokens(): any;
+    /**
+     * 内部方法 - 更新适配器状态
+     */
+    private updateState;
+}
+export declare const adapterRegistry: AdapterRegistry;

package/dist/core/src/adapters/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @file adapter/index.ts
+ * @description UI Adapter 模块导出
+ * @author ChatBI Team
+ */
+export * from './AdapterInterface';
+export * from './AdapterRegistry';

package/dist/core/src/adapters/local-storage-adapter.d.ts

@@ -0,0 +1,61 @@
+import { StoragePort } from '../ports/storage-port';
+/**
+ * 浏览器本地存储 (LocalStorage) 适配器
+ * @description 实现 `StoragePort` 接口，封装了对原生 `localStorage` 的访问。
+ * 支持可选的命名空间前缀隔离，确保在同一个域下不同模块的数据互不干扰。
+ */
+export declare class LocalStorageAdapter implements StoragePort {
+    /** 命名空间前缀，所有存入的键名都会自动添加此前缀 */
+    private prefix;
+    /**
+     * 初始化适配器
+     * @param prefix - 可选的命名空间前缀（如 'chatbi'），默认为空字符串
+     */
+    constructor(prefix?: string);
+    /**
+     * 内部方法：计算实际存储的键名
+     * @param key - 业务层传入的原始键名
+     * @returns 拼接前缀后的物理键名
+     */
+    private getKey;
+    /**
+     * 内部方法：从物理键名还原业务键名
+     * @param namespacedKey - 物理存储中的完整键名
+     * @returns 还原后的原始键名，若前缀不匹配则返回 null
+     */
+    private getOriginalKey;
+    /**
+     * 读取存储项
+     * @param key - 原始键名
+     * @returns 存储的字符串内容，不存在则返回 null
+     */
+    getItem(key: string): string | null;
+    /**
+     * 写入存储项
+     * @param key - 原始键名
+     * @param value - 待存储的字符串值
+     */
+    setItem(key: string, value: string): void;
+    /**
+     * 移除特定的存储项
+     * @param key - 原始键名
+     */
+    removeItem(key: string): void;
+    /**
+     * 清空存储空间
+     * @description
+     * - 若定义了前缀：仅删除以该前缀开头的键名，不影响其他数据。
+     * - 若未定义前缀：调用原生 `localStorage.clear()` 清空所有数据。
+     */
+    clear(): void;
+    /**
+     * 返回当前命名空间下的存储项总数
+     */
+    get length(): number;
+    /**
+     * 根据索引获取对应的原始键名
+     * @param index - 索引位置
+     * @returns 对应的业务键名，不存在则返回 null
+     */
+    key(index: number): string | null;
+}

package/dist/core/src/adapters/scoped-storage-adapter.d.ts

@@ -0,0 +1,61 @@
+import { StoragePort } from '../ports/storage-port';
+/**
+ * 作用域存储适配器 (ScopedStorageAdapter)
+ * @description 采用装饰器模式实现。它包装一个现有的 `StoragePort` 实例，
+ * 并为所有存储操作透明地注入一个前缀（命名空间），从而实现逻辑上的存储隔离。
+ * 常用于为插件分配独立的存储空间，而无需修改插件代码。
+ */
+export declare class ScopedStorageAdapter implements StoragePort {
+    private underlyingStorage;
+    private prefix;
+    /**
+     * 初始化作用域适配器
+     * @param underlyingStorage - 被装饰的底层存储适配器实例
+     * @param prefix - 用于隔离的作用域前缀字符串
+     */
+    constructor(underlyingStorage: StoragePort, prefix: string);
+    /**
+     * 内部方法：计算实际存储的键名
+     * @param key - 业务层传入的原始键名
+     * @returns 拼接前缀后的物理键名
+     */
+    private getKey;
+    /**
+     * 内部方法：从物理键名还原业务键名
+     * @param namespacedKey - 物理存储中的完整键名
+     * @returns 还原后的原始键名，若前缀不匹配则返回 null
+     */
+    private getOriginalKey;
+    /**
+     * 读取当前作用域下的存储项
+     * @param key - 原始键名
+     * @returns 字符串内容，不存在则返回 null
+     */
+    getItem(key: string): string | null;
+    /**
+     * 写入当前作用域下的存储项
+     * @param key - 原始键名
+     * @param value - 字符串内容
+     */
+    setItem(key: string, value: string): void;
+    /**
+     * 移除当前作用域下的特定存储项
+     * @param key - 原始键名
+     */
+    removeItem(key: string): void;
+    /**
+     * 清空当前作用域下的所有存储项
+     * @description 仅删除匹配当前前缀的键值对，不会影响底层存储中的其他数据。
+     */
+    clear(): void;
+    /**
+     * 返回当前作用域下的存储项总数
+     */
+    get length(): number;
+    /**
+     * 根据索引获取当前作用域下的原始键名
+     * @param index - 索引位置
+     * @returns 对应的业务键名，不存在则返回 null
+     */
+    key(index: number): string | null;
+}

package/dist/core/src/ai/function/index.d.ts

@@ -0,0 +1 @@
+export { ToolRegistry } from './registry';

package/dist/core/src/ai/function/registry.d.ts

@@ -0,0 +1,28 @@
+import { AITool } from '../types';
+/**
+ * 工具注册表
+ * 管理 AI 函数的注册和执行
+ */
+export declare class ToolRegistry {
+    private tools;
+    /**
+     * 注册工具
+     */
+    register(tool: AITool): void;
+    /**
+     * 注销工具
+     */
+    unregister(name: string): void;
+    /**
+     * 获取工具
+     */
+    get(name: string): AITool | null;
+    /**
+     * 列出所有工具
+     */
+    list(): AITool[];
+    /**
+     * 执行工具
+     */
+    execute(name: string, args: Record<string, unknown>): Promise<unknown>;
+}

package/dist/core/src/ai/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AI 能力抽象层入口
+ */
+export * from './function';
+export * from './providers';
+export * from './session';
+export { aiStore, createAIStore } from './store';
+export * from './types';

package/dist/core/src/ai/providers/index.d.ts

@@ -0,0 +1,2 @@
+export { MockAIProvider } from './mock';
+export { OpenAIProvider } from './openai';

package/dist/core/src/ai/providers/mock.d.ts

@@ -0,0 +1,28 @@
+import { AIChunk, AIMessage, AIProvider, AITool, ChatOptions, FunctionCallResult } from '../types';
+/**
+ * Mock AI Provider
+ * 用于演示和测试环境，返回预设的智能回复
+ */
+export declare class MockAIProvider implements AIProvider {
+    private responses;
+    /**
+     * 生成回复
+     */
+    private generateResponse;
+    /**
+     * 生成唯一 ID
+     */
+    private generateId;
+    /**
+     * 聊天（非流式）
+     */
+    chat(messages: AIMessage[], options?: ChatOptions): Promise<AIMessage>;
+    /**
+     * 流式响应
+     */
+    stream(messages: AIMessage[], options?: ChatOptions): AsyncIterable<AIChunk>;
+    /**
+     * 函数调用
+     */
+    functionCall(messages: AIMessage[], tools: AITool[], options?: ChatOptions): Promise<FunctionCallResult>;
+}

package/dist/core/src/ai/providers/openai.d.ts

@@ -0,0 +1,17 @@
+import { AIChunk, AIMessage, AIProvider, ChatOptions, FunctionCallResult } from '../types';
+/**
+ * OpenAI Provider 实现
+ * 支持 chat、stream、functionCall 方法
+ */
+export declare class OpenAIProvider implements AIProvider {
+    private client;
+    private defaultOptions;
+    constructor(apiKey: string, defaultOptions?: ChatOptions);
+    chat(messages: AIMessage[], options?: ChatOptions): Promise<AIMessage>;
+    stream(messages: AIMessage[], options?: ChatOptions): AsyncIterable<AIChunk>;
+    functionCall(messages: AIMessage[], tools: import('../types').AITool[], options?: ChatOptions): Promise<FunctionCallResult>;
+    private toOpenAIMessages;
+    private toOpenAITools;
+    private fromOpenAIMessage;
+    private fromOpenAIToolCall;
+}

package/dist/core/src/ai/session/index.d.ts

@@ -0,0 +1,3 @@
+export * from './manager';
+export * from './storage';
+export * from './types';

package/dist/core/src/ai/session/manager.d.ts

@@ -0,0 +1,19 @@
+import { AIMessage, Session } from '../types';
+import { SessionManagerInterface, SessionStorage } from './types';
+/**
+ * 会话管理器
+ * 提供会话的创建、查询、删除、消息管理等功能
+ */
+export declare class SessionManager implements SessionManagerInterface {
+    private sessions;
+    private storage?;
+    constructor(storage?: SessionStorage);
+    createSession(name?: string): Session;
+    getSession(id: string): Session | null;
+    listSessions(): Session[];
+    deleteSession(id: string): void;
+    addMessage(sessionId: string, message: AIMessage): void;
+    clearMessages(sessionId: string): void;
+    private loadFromStorage;
+    private saveToStorage;
+}

package/dist/core/src/ai/session/storage.d.ts

@@ -0,0 +1,9 @@
+import { Session, SessionStorage } from './types';
+/**
+ * LocalStorage 适配器，用于会话持久化
+ * 注意：仅在浏览器环境可用
+ */
+export declare class SessionLocalStorageAdapter implements SessionStorage {
+    save(sessions: Session[]): void;
+    load(): Session[];
+}

package/dist/core/src/ai/session/types.d.ts

@@ -0,0 +1,14 @@
+import { AIMessage, Session as AISession } from '../types';
+export type { AISession as Session };
+export interface SessionStorage {
+    save(sessions: AISession[]): void;
+    load(): AISession[];
+}
+export interface SessionManagerInterface {
+    createSession(name?: string): AISession;
+    getSession(id: string): AISession | null;
+    listSessions(): AISession[];
+    deleteSession(id: string): void;
+    addMessage(sessionId: string, message: AIMessage): void;
+    clearMessages(sessionId: string): void;
+}

package/dist/core/src/ai/store.d.ts

@@ -0,0 +1,23 @@
+import { ToolRegistry } from './function/registry';
+import { SessionManager } from './session/manager';
+import { AIMessage, AIProvider, AITool, Session } from './types';
+interface AIState {
+    provider: AIProvider | null;
+    setProvider: (provider: AIProvider) => void;
+    sessions: Session[];
+    currentSessionId: string | null;
+    sessionManager: SessionManager;
+    toolRegistry: ToolRegistry;
+    createSession: (name?: string) => Session;
+    selectSession: (id: string) => void;
+    deleteSession: (id: string) => void;
+    addMessage: (message: AIMessage) => void;
+    registerTool: (tool: AITool) => void;
+    unregisterTool: (name: string) => void;
+    sendMessage: (content: string) => Promise<void>;
+    clearCurrentSession: () => void;
+    streamMessage: (content: string, onChunk: (chunk: string) => void) => Promise<void>;
+}
+export declare const aiStore: import("zustand/vanilla").StoreApi<AIState>;
+export declare function createAIStore(apiKey: string, defaultModel?: string): void;
+export {};

package/dist/core/src/ai/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * AI 能力抽象层类型定义
+ */
+export interface AIMessage {
+    id: string;
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+    name?: string;
+    toolCallId?: string;
+    toolCalls?: ToolCall[];
+    createdAt?: number;
+}
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface ChatOptions {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    tools?: AITool[];
+    stream?: boolean;
+    systemPrompt?: string;
+}
+export interface AIProvider {
+    chat(messages: AIMessage[], options?: ChatOptions): Promise<AIMessage>;
+    stream(messages: AIMessage[], options?: ChatOptions): AsyncIterable<AIChunk>;
+    functionCall(messages: AIMessage[], tools: AITool[], options?: ChatOptions): Promise<FunctionCallResult>;
+}
+export interface AIChunk {
+    type: 'content' | 'tool-call' | 'done' | 'error';
+    content?: string;
+    toolCall?: ToolCall;
+    error?: string;
+}
+export interface FunctionCallResult {
+    message: AIMessage;
+    toolCalls: ToolCall[];
+}
+export interface Session {
+    id: string;
+    name: string;
+    messages: AIMessage[];
+    createdAt: number;
+    updatedAt: number;
+    metadata?: Record<string, unknown>;
+}
+export interface AITool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute: (args: Record<string, unknown>) => Promise<unknown>;
+}

package/dist/core/src/ai/utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * AI 模块工具函数
+ */
+/**
+ * 生成唯一 ID
+ */
+export declare function generateId(): string;

package/dist/core/src/api/adapters/axios-adapter.d.ts

@@ -0,0 +1,10 @@
+import { ApiAdapter, ApiEndpointConfig, ApiRequestConfig, StreamCallbacks } from '../../ports/api-port';
+/**
+ * 基于 Axios 的默认请求适配器
+ */
+export declare class AxiosAdapter implements ApiAdapter {
+    private client;
+    constructor(baseURL?: string, timeout?: number);
+    request<T = any>(config: ApiRequestConfig): Promise<T>;
+    stream(config: ApiRequestConfig, callbacks: StreamCallbacks, _endpointConfig?: ApiEndpointConfig): Promise<void>;
+}