@chatbi-v/core 1.0.2

package/dist/plugin-context.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import { PluginManager } from './domain/plugin-manager';
+export interface PluginProviderProps {
+    manager: PluginManager;
+    children: React.ReactNode;
+}
+export declare const PluginProvider: React.FC<PluginProviderProps>;
+export declare const usePluginManager: () => PluginManager;

package/dist/ports/api-port.d.ts

@@ -0,0 +1,71 @@
+/**
+ * HTTP 请求方法
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+/**
+ * 错误处理策略
+ */
+export type ErrorStrategy = 'reject' | 'resolve' | 'silent';
+export interface ApiEndpointConfig {
+    /** 接口路径 (支持 :param 语法) */
+    url: string;
+    /** 请求方法 */
+    method: HttpMethod;
+    /** 描述 */
+    desc?: string;
+    /** Mock 响应 Schema */
+    responseSchema?: any;
+    /** 错误处理策略 */
+    errorStrategy?: ErrorStrategy;
+}
+export interface ApiRequestConfig {
+    url: string;
+    method: HttpMethod;
+    data?: any;
+    params?: any;
+    headers?: any;
+    /** 用于取消请求的信号 */
+    signal?: AbortSignal;
+}
+/**
+ * 流式响应回调
+ */
+export interface StreamCallbacks {
+    onMessage?: (data: any) => void;
+    onError?: (error: any) => void;
+    onFinish?: () => void;
+}
+/**
+ * API 适配器端口
+ * @description 所有请求引擎（Fetch, Axios, Mock）都必须实现此接口
+ */
+export interface ApiAdapter {
+    request<T = any>(config: ApiRequestConfig, endpointConfig?: ApiEndpointConfig): Promise<T>;
+    /**
+     * 发起流式请求
+     */
+    stream?(config: ApiRequestConfig, callbacks: StreamCallbacks, endpointConfig?: ApiEndpointConfig): Promise<void>;
+}
+/**
+ * API 配置集合 (按模块分组)
+ */
+export interface ApiConfig {
+    [module: string]: {
+        [action: string]: ApiEndpointConfig;
+    };
+}
+/**
+ * 请求选项
+ */
+export interface RequestOptions extends Partial<ApiRequestConfig> {
+    /** 是否跳过错误处理 */
+    skipErrorHandler?: boolean;
+    /** 路径参数 (替换 url 中的 :param) */
+    params?: any;
+    /** 流式响应回调 */
+    onMessage?: (data: any) => void;
+    onError?: (error: any) => void;
+    onFinish?: () => void;
+    /** 允许其他属性 (例如 axios 配置) */
+    [key: string]: any;
+}

package/dist/ports/event-bus-port.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 事件总线端口接口
+ */
+export interface EventBusPort {
+    /**
+     * 订阅事件
+     * @param event 事件名称
+     * @param callback 回调函数
+     * @returns 取消订阅函数
+     */
+    on(event: string, callback: (...args: any[]) => any): () => void;
+    /**
+     * 取消订阅
+     * @param event 事件名称
+     * @param callback 回调函数
+     */
+    off(event: string, callback: (...args: any[]) => any): void;
+    /**
+     * 触发事件
+     * @param event 事件名称
+     * @param args 事件参数
+     */
+    emit(event: string, ...args: any[]): void;
+    /**
+     * 订阅一次性事件
+     * @param event 事件名称
+     * @param callback 回调函数
+     */
+    once(event: string, callback: (...args: any[]) => any): void;
+}

package/dist/ports/plugin-port.d.ts

@@ -0,0 +1,192 @@
+import React from 'react';
+import { ApiConfig } from './api-port';
+import { EventBusPort } from './event-bus-port';
+/**
+ * 插件类型定义
+ */
+export declare const PLUGIN_TYPES: readonly ["business", "functional", "view", "theme", "renderer", "system"];
+export type PluginType = typeof PLUGIN_TYPES[number];
+/**
+ * 路由配置
+ */
+export interface RouteConfig {
+    path: string;
+    component: React.ComponentType<any>;
+    meta?: Record<string, any>;
+}
+/**
+ * 插件插槽位置
+ * @description 定义插件可以注入 UI 的标准位置
+ */
+export declare const Slot: {
+    readonly Sidebar: "sidebar";
+    readonly SidebarPanel: "sidebar-panel";
+    readonly Header: "header";
+    readonly StatusBar: "status-bar";
+    readonly Settings: "settings";
+    readonly MessageRenderer: "message-renderer";
+    readonly MessageContentRenderer: "message-content-renderer";
+    readonly SidebarSystem: "sidebar-system";
+    readonly SidebarBottom: "sidebar-bottom";
+    readonly Custom: "custom";
+};
+export type SlotType = typeof Slot[keyof typeof Slot];
+export type SlotPosition = SlotType | string;
+/**
+ * 插件扩展 (插槽)
+ */
+export interface PluginExtension {
+    slot: SlotPosition;
+    component: React.ComponentType<any>;
+    order?: number;
+    /** @internal 插件 ID，由系统自动注入 */
+    _pluginId?: string;
+    meta?: {
+        icon?: React.ReactNode;
+        label?: string;
+        description?: string;
+        key?: string;
+        [key: string]: any;
+    };
+}
+export interface PluginConfigItem {
+    key: string;
+    type: 'string' | 'number' | 'boolean' | 'select';
+    label: string;
+    description?: string;
+    default?: any;
+    options?: {
+        label: string;
+        value: any;
+    }[];
+    mode?: 'multiple' | 'tags';
+    min?: number;
+    max?: number;
+}
+/**
+ * 插件能力定义 (Behavioral Capabilities)
+ * @description 定义插件的行为特征。注意：路由(routes)和扩展(extensions)属于结构化能力，直接通过 metadata 字段声明，不在此列。
+ */
+export interface PluginCapabilities {
+    /**
+     * 是否支持配置设置
+     * @default false (如果 metadata.configuration 存在，则可能被隐式视为 true，建议显式声明)
+     */
+    configurable?: boolean;
+    /**
+     * 是否可嵌入其他页面
+     * @description 声明该插件是否可以作为 Widget 被其他插件引用
+     */
+    embeddable?: boolean;
+    /**
+     * 是否支持多实例
+     * @description 默认为 false (单例)。如果在聊天窗口中每个会话都需要独立状态，则设为 true
+     */
+    multiInstance?: boolean;
+    /**
+     * 是否需要后台运行
+     * @description 如果为 true，即使 UI 不可见，插件也不会被卸载
+     */
+    background?: boolean;
+    [key: string]: boolean | undefined;
+}
+export interface StorageItemSchema {
+    key: string;
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    default?: any;
+    description?: string;
+    scope?: 'plugin' | 'shared';
+}
+/**
+ * 插件生命周期 Hooks
+ */
+export interface PluginLifecycle {
+    /**
+     * 插件加载时调用
+     * @description 用于初始化内部状态、注册服务等。此时 UI 尚未挂载。
+     */
+    onLoad?: (context: PluginContext) => void | Promise<void>;
+    /**
+     * 插件挂载到 UI 时调用
+     */
+    onMount?: (context: PluginContext) => void;
+    /**
+     * 插件从 UI 卸载时调用
+     */
+    onUnmount?: (context: PluginContext) => void;
+    /**
+     * 插件配置发生变化时调用
+     */
+    onConfigChange?: (newConfig: any, oldConfig: any) => void;
+}
+/**
+ * 插件上下文
+ * @description 传递给插件生命周期钩子的对象，提供核心能力的访问
+ */
+export interface PluginContext {
+    pluginId: string;
+    api: any;
+    events: EventBusPort;
+    storage: {
+        get: <T = any>(key: string) => T | null;
+        set: <T = any>(key: string, value: T) => void;
+        remove: (key: string) => void;
+        shared: {
+            get: <T = any>(key: string) => T | null;
+            set: <T = any>(key: string, value: T) => void;
+            remove: (key: string) => void;
+        };
+    };
+    logger: {
+        debug: (...args: any[]) => void;
+        info: (...args: any[]) => void;
+        warn: (...args: any[]) => void;
+        error: (...args: any[]) => void;
+    };
+    /** 访问其他插件提供的服务 */
+    getService: <T = any>(serviceName: string) => T | undefined;
+    /** 注册自己的服务供他人使用 */
+    registerService: (serviceName: string, service: any) => void;
+    /** 宿主环境 Window (沙箱) */
+    window: WindowProxy;
+}
+/**
+ * 完整的插件接口定义
+ */
+export interface Plugin extends PluginLifecycle {
+    /**
+     * 插件 ID
+     * @description 必须与 metadata.id 一致，方便快速访问
+     */
+    id: string;
+    metadata: PluginMetadata;
+    /** 插件提供的组件（可选） */
+    components?: Record<string, React.ComponentType<any>>;
+    /** 插件提供的工具函数（可选） */
+    utils?: Record<string, any>;
+    /** 默认配置（可选） */
+    defaultConfig?: Record<string, any>;
+}
+export interface PluginMetadata {
+    id: string;
+    name: string;
+    version: string;
+    type: PluginType;
+    description?: string;
+    author?: string;
+    icon?: React.ReactNode;
+    /** 插件依赖的其他插件 ID 列表 */
+    dependencies?: string[];
+    /** 路由配置 */
+    routes?: RouteConfig[];
+    /** 插槽扩展 */
+    extensions?: PluginExtension[];
+    /** API 配置 */
+    api?: ApiConfig;
+    /** 插件能力声明 */
+    capabilities?: PluginCapabilities;
+    /** 插件配置定义 */
+    configuration?: PluginConfigItem[];
+    /** 存储定义（Schema） */
+    storage?: StorageItemSchema[];
+}

package/dist/ports/storage-port.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 存储端口接口
+ * @description 定义数据持久化的契约
+ */
+export interface StoragePort {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+    /**
+     * 返回存储对象中存储的数据项数量。
+     */
+    readonly length: number;
+    /**
+     * 返回存储中第 n 个键的名称。
+     * @param index 一个整数，表示要获取名称的键的编号。
+     */
+    key(index: number): string | null;
+}

package/dist/sandbox/proxy-sandbox.d.ts

@@ -0,0 +1,45 @@
+/**
+ * ProxySandbox 类
+ * @description 基于 Proxy 的 JS 沙箱实现，模拟独立的 Window 环境
+ */
+export declare class ProxySandbox {
+    /** 沙箱名称 */
+    name: string;
+    /** 代理后的 Window 对象 */
+    proxy: WindowProxy;
+    /** 沙箱是否激活 */
+    running: boolean;
+    /** 记录新增/修改的全局变量 */
+    private updatedValueSet;
+    /** 副作用记录池 */
+    private effectPool;
+    /** 真实的 Window 对象 */
+    private globalContext;
+    /** 白名单全局变量（允许透传访问真实 Window） */
+    private static globalWhitelist;
+    constructor(name: string, globalContext?: Window & typeof globalThis);
+    /**
+     * 激活沙箱
+     */
+    active(): void;
+    /**
+     * 销毁沙箱
+     */
+    inactive(): void;
+    /**
+     * 在沙箱中执行代码
+     * @param code JS 代码字符串
+     * @returns 执行结果
+     */
+    eval(code: string): any;
+    /**
+     * 创建伪造的 Window 对象
+     */
+    private createFakeWindow;
+    private isConstructor;
+    private isNativeFunction;
+    /**
+     * 劫持全局副作用 API
+     */
+    private patchGlobalEffects;
+}

package/dist/sandbox/style-isolation.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+interface SandboxContainerProps {
+    children?: React.ReactNode;
+    name: string;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * 样式隔离容器
+ * @description 使用 Shadow DOM 实现完全的样式隔离
+ */
+export declare const SandboxContainer: React.FC<SandboxContainerProps>;
+export {};

package/dist/testing/plugin-contract.d.ts

@@ -0,0 +1,6 @@
+import { Plugin } from '../ports/plugin-port';
+/**
+ * 插件契约测试套件
+ * @description 验证插件实现是否符合核心契约
+ */
+export declare function verifyPluginContract(plugin: Plugin): void;

package/dist/utils/date.d.ts

@@ -0,0 +1,32 @@
+import dayjs from 'dayjs';
+import 'dayjs/locale/zh-cn';
+/**
+ * 日期时间格式化工具类
+ */
+export declare const dateUtils: {
+    /**
+     * 格式化日期为 YYYY-MM-DD
+     */
+    formatDate(date?: dayjs.ConfigType): string;
+    /**
+     * 格式化时间为 HH:mm:ss
+     */
+    formatTime(date?: dayjs.ConfigType): string;
+    /**
+     * 格式化日期时间为 YYYY-MM-DD HH:mm:ss
+     */
+    formatDateTime(date?: dayjs.ConfigType): string;
+    /**
+     * 获取当前时间戳（毫秒）
+     */
+    now(): number;
+    /**
+     * 获取相对时间（例如：几分钟前）
+     */
+    fromNow(date: dayjs.ConfigType): string;
+    /**
+     * 原始 dayjs 对象，用于更复杂的场景
+     */
+    dayjs: typeof dayjs;
+};
+export default dateUtils;

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from './logger';
+export * from './stream-parser';
+export * from './date';
+export declare const version = "1.0.0";

package/dist/utils/logger.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 日志等级枚举
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    NONE = 4
+}
+/**
+ * 日志工具类
+ * @description 支持日志等级控制和统一前缀格式，方便治理和排查问题
+ */
+export declare class Logger {
+    /** 全局默认日志等级 */
+    private static level;
+    /** 当前实例的前缀 */
+    private prefix;
+    /**
+     * 构造函数
+     * @param prefix 日志前缀，默认为 'App'
+     */
+    constructor(prefix?: string);
+    /**
+     * 设置全局日志等级
+     * @param level 日志等级
+     */
+    static setLevel(level: LogLevel): void;
+    /**
+     * 获取当前日志等级
+     * @returns 当前全局日志等级
+     */
+    static getLevel(): LogLevel;
+    /**
+     * 打印 DEBUG 级别日志
+     */
+    get debug(): (...args: any[]) => void;
+    /**
+     * 打印 INFO 级别日志
+     */
+    get info(): (...args: any[]) => void;
+    /**
+     * 打印 WARN 级别日志
+     */
+    get warn(): (...args: any[]) => void;
+    /**
+     * 打印 ERROR 级别日志
+     */
+    get error(): (...args: any[]) => void;
+    /**
+     * 开始一个日志分组
+     * @param label 分组标签
+     * @param collapsed 是否默认折叠，默认为 false
+     */
+    group(label: string, collapsed?: boolean): void;
+    /**
+     * 结束当前日志分组
+     */
+    get groupEnd(): () => void;
+}
+/** 默认 Logger 实例 */
+export declare const logger: Logger;
+/**
+ * 创建带特定前缀的 Logger 实例
+ * @param prefix 日志前缀
+ * @returns Logger 实例
+ */
+export declare const createLogger: (prefix: string) => Logger;

package/dist/utils/stream-parser.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 流数据事件接口
+ * @description 定义流式传输中的事件结构
+ */
+export interface StreamEvent {
+    /** 事件类型：消息、数据、待办事项、日志或错误 */
+    event: 'message' | 'data' | 'todos' | 'log' | 'error' | 'think' | 'page';
+    /** 事件携带的数据 */
+    data: any;
+}
+/**
+ * 解析流数据块
+ * @description 将 SSE (Server-Sent Events) 格式的字符串解析为事件对象数组
+ *
+ * 支持的格式:
+ * 格式 1:
+ * event: 'message' | 'data' | 'todos' | 'error'
+ * data: object | string
+ *
+ * 格式 2:
+ * data: object | string
+ *
+ * @param chunk 接收到的流数据块字符串
+ * @returns 解析后的事件数组
+ */
+export declare function parseStreamChunk(chunk: string): StreamEvent[];

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@chatbi-v/core",
+  "version": "1.0.2",
+  "main": "dist/index.mjs",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "axios": "^1.13.2"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "@chatbi-v/cli": "1.0.2"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "vite": "^5.4.21",
+    "@chatbi-v/tsconfig": "1.0.2"
+  },
+  "scripts": {
+    "build": "chatbi-cli build",
+    "dev": "chatbi-cli build --watch",
+    "test": "vitest",
+    "lint": "eslint src/"
+  }
+}