@chatbi-v/core 2.0.1 → 2.0.2

package/README.md

@@ -2,35 +2,60 @@
 
 ChatBI 核心模块，提供插件管理、基础设施接口及通用 API 引擎。
 
-## 架构原则 (Architecture Principles)
+## 模块功能说明
 
-- **业务无关性 (Business Agnostic)**: `core` 包禁止包含任何具体的业务模型、业务逻辑或业务常量。
-- **共享契约 (Shared Contract)**: `core` 只定义通用的技术契约（如 `Plugin`, `StoragePort`, `ApiAdapter`）。
-- **插件驱动 (Plugin Driven)**: 所有的业务逻辑应由插件实现。
+- **微内核架构**: 实现插件的注册、生命周期管理与隔离。
+- **领域驱动设计**: 严格区分领域逻辑 (`domain`)、外部接口 (`ports`) 和具体实现 (`adapters`)。
+- **API 引擎**: 统一的 API 请求管理，支持同步、流式请求及拦截器。
+- **存储管理**: 提供隔离的存储适配器，确保插件数据互不干扰。
 
-## 目录结构
+## 安装和使用方法
 
-- `adapters/`: 基础设施的具体实现（如 LocalStorage, Axios）。
-- `api/`: 通用 API 请求引擎。
-- `domain/`: 核心领域逻辑（插件管理器、运行时、沙箱）。
-- `ports/`: 核心接口定义（端口）。
-
-## 功能
+### 安装
 
-- **PluginManager**: 管理插件的注册和生命周期。
-- **ApiEngine**: 统一的 API 请求管理。支持请求拦截器 (`ApiInterceptor`)，且拦截器能力已覆盖普通请求 (`call`) 和流式请求 (`stream`)。
-- **Sandbox**: 提供插件运行时的样式和全局变量隔离。
+```bash
+pnpm add @chatbi-v/core
+```
 
-## 使用方法
+### 使用示例
 
 ```typescript
-import { pluginManager } from '@chatbi/core';
+import { PluginManager, LocalStorageAdapter } from '@chatbi-v/core';
+
+// 初始化插件管理器
+const storage = new LocalStorageAdapter();
+const pluginManager = new PluginManager(storage);
 
-// 注册插件
+// 注册并初始化插件
 pluginManager.register({
   id: 'my-plugin',
-  init: (context) => {
-    console.log('Plugin initialized');
-  },
+  metadata: { name: 'My Plugin', type: 'business' },
+  onLoad: async (context) => {
+    console.log('Plugin loaded', context.pluginId);
+  }
 });
 ```
+
+## API 文档链接
+
+详细 API 文档请参考 [docs/index.html](https://github.com/your-repo/docs/index.html) 或运行 `npm run docs:dev` 本地查看。
+
+## 开发注意事项
+
+- **禁止引入 UI 框架**: 本模块为纯逻辑层，不得包含 React/AntD 等 UI 依赖。
+- **禁止反向依赖**: `core` 不得依赖 `plugins` 或 `apps` 中的任何代码。
+- **类型安全**: 优先使用 `ports` 中定义的接口。
+
+## 架构原则 (Architecture Principles)
+
+- **业务无关性 (Business Agnostic)**: `core` 包禁止包含任何具体的业务模型、业务逻辑或业务常量。
+- **共享契约 (Shared Contract)**: `core` 只定义通用的技术契约（如 `Plugin`, `StoragePort`, `ApiAdapter`）。
+- **插件驱动 (Plugin Driven)**: 所有的业务逻辑应由插件实现。
+
+## 目录结构
+
+- `adapters/`: 基础设施的具体实现（如 LocalStorage, Axios）。
+- `api/`: 通用 API 请求引擎。
+- `domain/`: 核心领域逻辑（插件管理器、运行时、沙箱）。
+- `ports/`: 核心接口定义（端口）。
+- `utils/`: 通用工具函数。

package/dist/chunk-G3OU7D3Y.mjs

@@ -0,0 +1,47 @@
+// src/config-manager.ts
+var ConfigManager = class {
+  /** 存储配置的 Map */
+  config = /* @__PURE__ */ new Map();
+  /**
+   * 设置配置项
+   * @param key 配置键
+   * @param value 配置值
+   */
+  set(key, value) {
+    this.config.set(key, value);
+  }
+  /**
+   * 获取配置项
+   * @param key 配置键
+   */
+  get(key) {
+    return this.config.get(key);
+  }
+  /**
+   * 合并配置
+   * @param config 配置对象
+   */
+  merge(config) {
+    Object.keys(config).forEach((key) => {
+      const existing = this.config.get(key);
+      const incoming = config[key];
+      if (existing && typeof existing === "object" && incoming && typeof incoming === "object") {
+        this.config.set(key, { ...existing, ...incoming });
+      } else {
+        this.config.set(key, incoming);
+      }
+    });
+  }
+  /**
+   * 获取所有配置
+   */
+  getAll() {
+    return Object.fromEntries(this.config);
+  }
+};
+var configManager = new ConfigManager();
+
+export {
+  ConfigManager,
+  configManager
+};

package/dist/{config-manager-YVMVSPES.mjs → config-manager-ZARQENTB.mjs}

@@ -1,7 +1,7 @@
 import {
   ConfigManager,
   configManager
-} from "./chunk-IOE2RMEZ.mjs";
+} from "./chunk-G3OU7D3Y.mjs";
 export {
   ConfigManager,
   configManager

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

@@ -1,3 +1,8 @@
+/**
+ * @file plugin-manager.ts
+ * @description 插件管理器，负责插件的注册、生命周期管理、状态持久化及扩展点收集
+ * @author ChatBI Team
+ */
 import { DefaultEventBus } from '../event-bus';
 import { Plugin, PluginExtension, RouteConfig, SlotPosition } from '../ports/plugin-port';
 import { StoragePort } from '../ports/storage-port';
@@ -133,6 +138,10 @@ export declare class PluginManager {
      * @param config 插件配置
      */
     loadRemotePlugin(pluginId: string, url: string, config: any): Promise<Plugin | null>;
+    /**
+     * IIFE 模式加载插件
+     */
+    private loadIIFEPlugin;
     /**
      * 实例化插件
      */

package/dist/domain/plugin-runtime.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @file plugin-runtime.ts
+ * @description 插件运行时，封装单个插件的生命周期（load/mount/unmount）、沙箱环境和隔离上下文
+ * @author ChatBI Team
+ */
 import { Plugin, PluginContext } from '../ports/plugin-port';
 import { StorageManager } from './storage-manager';
 /**

package/dist/index.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @file index.ts
+ * @description Core 模块入口文件，导出所有公共 API、领域逻辑、组件和 Hooks
+ * @author ChatBI Team
+ */
 export * from './ports/api-port';
 export * from './ports/event-bus-port';
 export * from './ports/plugin-port';
@@ -19,6 +24,7 @@ export * from './adapters/scoped-storage-adapter';
 export * from './event-bus';
 export * from './plugin-context';
 export * from './api';
+export * from './sandbox/proxy-sandbox';
 export * from './utils';
 export * from './hooks/use-storage-state';
 export * from './hooks/use-plugin-loader';