@chatbi-v/core 2.0.1 → 2.0.3

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-O74KYN5N.mjs

@@ -0,0 +1 @@
+var s=class{config=new Map;set(t,e){this.config.set(t,e)}get(t){return this.config.get(t)}merge(t){Object.keys(t).forEach(e=>{let i=this.config.get(e),n=t[e];i&&typeof i=="object"&&n&&typeof n=="object"?this.config.set(e,{...i,...n}):this.config.set(e,n)})}getAll(){return Object.fromEntries(this.config)}},c=new s;export{s as a,c as b};

package/dist/config-manager-LQITPSUA.mjs

@@ -0,0 +1 @@
+import{a,b}from"./chunk-O74KYN5N.mjs";export{a as ConfigManager,b as 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';
 /**