@zhin.js/core 1.0.57 → 1.1.2

package/REFACTORING_STATUS.md

@@ -1,263 +0,0 @@
-# Zhin.js 核心重构实施报告
-
-## 执行日期
-2025年12月5日
-
-## 重构目标
-基于 [zhinjs/next](https://github.com/zhinjs/next) 的设计，重构 Zhin.js 核心架构：
-1. **移除 Dependency 层** - Plugin 直接继承 EventEmitter
-2. **AsyncLocalStorage 上下文** - 使用 Node.js 原生 API 管理依赖注入
-3. **移除 HMR 系统** - Plugin 内置 watch/reload 方法
-4. **移除 App 类** - worker.ts 直接作为入口
-
-## 已完成工作
-
-### 1. 创建新的 Plugin 类 (`plugin-new.ts`)
-
-#### 核心特性
-- ✅ **直接继承 EventEmitter** - 不再依赖 Dependency
-- ✅ **AsyncLocalStorage 上下文** - 全局 storage 管理插件实例
-- ✅ **usePlugin() 函数** - 类 React Hooks 的 API
-- ✅ **useService() 函数** - 类型安全的服务访问（支持 Proxy + await）
-- ✅ **provide/inject 方法** - 混合查找策略（向上继承 + 全局共享）
-- ✅ **watch() 方法** - 内置文件监听和热重载
-- ✅ **reload() 方法** - 插件重载（根插件退出进程）
-- ✅ **dispatch/broadcast** - 事件冒泡和广播
-- ✅ **自动方法绑定** - 解决 this 上下文问题
-
-#### 关键代码
-```typescript
-// AsyncLocalStorage 上下文
-export const storage = new AsyncLocalStorage<Plugin>();
-
-export function usePlugin(): Plugin {
-  const plugin = storage.getStore();
-  const callerFile = getCurrentFile();
-  
-  if (plugin && callerFile === plugin.filePath) {
-    return plugin;
-  }
-  
-  const newPlugin = new Plugin(callerFile, plugin);
-  storage.enterWith(newPlugin);
-  return newPlugin;
-}
-
-// Proxy 服务访问（支持 await）
-export function useService<K extends keyof Plugin.Services>(
-  name: K
-): Plugin.Services[K] {
-  return new Proxy({} as Plugin.Services[K], {
-    get(target, prop) {
-      if (prop === 'then') {
-        // 支持 await useService()
-        return (resolve, reject) => getServiceAsync().then(resolve, reject);
-      }
-      const service = getServiceSync();
-      return (service as any)[prop];
-    }
-  });
-}
-```
-
-#### 生命周期简化
-```typescript
-class Plugin extends EventEmitter {
-  async start() {
-    // 启动适配器
-    for (const adapter of this.adapters.values()) {
-      await adapter.start();
-    }
-    
-    // 启动服务
-    for (const service of this.#services.values()) {
-      if (typeof service.start === 'function') {
-        await service.start();
-      }
-    }
-    
-    await this.broadcast('mounted');
-  }
-  
-  stop() {
-    this.emit('dispose');
-    // 清理资源...
-  }
-}
-```
-
-### 2. 创建新的 worker.ts (`worker-new.ts`)
-
-#### 启动流程
-```typescript
-const plugin = usePlugin();
-
-// 1. 加载配置服务
-await plugin.import('./plugins/config.js');
-
-// 2. 获取配置
-const configService = useService('config');
-configService.load('zhin.config', defaultConfig);
-
-// 3. 加载插件
-for (const dir of config.plugin_dirs) {
-  await plugin.import(dir);
-}
-
-// 4. 注册适配器
-for (const bot of config.bots) {
-  plugin.adapter(bot.context, bot);
-}
-
-// 5. 启动
-await plugin.start();
-```
-
-#### 优雅关闭
-```typescript
-process.on('SIGTERM', () => {
-  plugin.stop();
-  process.exit(0);
-});
-
-process.on('uncaughtException', (error) => {
-  plugin.logger.error('Uncaught exception:', error);
-  plugin.stop();
-  process.exit(1);
-});
-```
-
-## 架构对比
-
-### 旧架构
-```
-App (extends Plugin)
-  ↓
-Plugin (extends Dependency)
-  ↓
-Dependency (extends EventEmitter)
-  + HMRManager (组合)
-```
-
-### 新架构
-```
-Plugin (extends EventEmitter)
-  + AsyncLocalStorage<Plugin>
-  + usePlugin() / useService()
-  + 内置 watch/reload
-```
-
-## API 变化
-
-### 新增 API
-| API | 说明 |
-|-----|------|
-| `usePlugin()` | 获取或创建当前插件实例 |
-| `useService(name)` | 类型安全的服务访问（支持 await） |
-| `plugin.provide(name, value)` | 提供服务 |
-| `plugin.inject(name)` | 注入服务 |
-| `plugin.watch(callback)` | 监听文件变化 |
-| `plugin.reload()` | 重载插件 |
-| `plugin.dispatch(event)` | 向上冒泡事件 |
-| `plugin.broadcast(event)` | 向下广播事件 |
-
-### 移除 API
-| API | 替代方案 |
-|-----|---------|
-| `new App(config)` | `usePlugin()` + import 插件 |
-| `app.hmrManager` | `plugin.watch()` |
-| `Dependency` 类 | 移除，Plugin 直接继承 EventEmitter |
-| `app.start()` | `plugin.start()` |
-
-### 保持兼容
-- ✅ 生命周期事件: `mounted`, `dispose`
-- ✅ 插件方法: `onMounted()`, `onDispose()`
-- ✅ 插件树: `children`, `parent`, `root`
-- ✅ 适配器管理: `adapters` getter
-
-## 下一步工作
-
-### 待完成
-1. **删除旧文件**
-   - [ ] 删除 `/basic/dependency` 目录
-   - [ ] 删除 `/basic/hmr` 目录
-   - [ ] 删除 `/packages/core/src/app.ts`
-   - [ ] 删除 `/packages/core/src/zhin.ts`（已创建的进程管理器）
-
-2. **迁移现有代码**
-   - [ ] 重命名 `plugin-new.ts` → `plugin.ts`
-   - [ ] 重命名 `worker-new.ts` → `worker.ts`
-   - [ ] 更新 CLI 命令 (dev/start)
-
-3. **创建配置服务**
-   - [ ] 实现 ConfigService 类（参考 zhinjs/next）
-   - [ ] 支持环境变量替换 `${VAR:-default}`
-   - [ ] 支持嵌套配置访问（点号路径）
-
-4. **更新 package.json**
-   - [ ] 移除 `@zhin.js/dependency` 依赖
-   - [ ] 移除 `@zhin.js/hmr` 依赖
-   - [ ] 添加 `./worker` 导出
-
-5. **更新 TypeScript 配置**
-   - [ ] 修复类型引用
-   - [ ] 更新模块扩展
-
-6. **测试验证**
-   - [ ] 单元测试
-   - [ ] 集成测试
-   - [ ] 插件加载测试
-
-## 风险评估
-
-### 已规避风险
-- ✅ **选择渐进式重构** - 新旧代码并存，降低风险
-- ✅ **保留核心 API** - 生命周期、事件系统保持不变
-- ✅ **创建新文件** - 不破坏现有代码
-
-### 剩余风险
-- 🟡 **TypeScript 类型** - 需要大量类型定义更新
-- 🟡 **插件兼容性** - 现有插件需要适配
-- 🔴 **依赖包移除** - dependency/hmr 包的清理影响面大
-
-## 技术亮点
-
-### 1. AsyncLocalStorage 上下文
-- 自动管理插件树结构
-- 无需手动传递 parent 参数
-- 支持异步调用链
-
-### 2. Proxy 服务访问
-```typescript
-const service = useService('config');
-service.get('key');        // 同步访问
-await service;             // 异步等待
-```
-
-### 3. 文件监听优化
-```typescript
-plugin.watch((p) => {
-  p.reload();  // 自动重载
-}, true);      // 递归监听子插件
-```
-
-### 4. 混合依赖注入
-1. **向上查找** - 从父链继承服务
-2. **全局查找** - 跨插件共享服务
-3. **缓存优化** - 减少查找开销
-
-## 参考资源
-
-- [zhinjs/next 源码](https://github.com/zhinjs/next)
-- [Hooks 实现](https://github.com/zhinjs/next/blob/main/src/hooks.ts)
-- [worker.ts 示例](https://github.com/zhinjs/next/blob/main/src/worker.ts)
-- [AsyncLocalStorage 文档](https://nodejs.org/api/async_context.html#class-asynclocalstorage)
-
-## 总结
-
-✅ 成功创建新架构的核心文件
-✅ 移除 Dependency/HMR 依赖，简化架构
-✅ 采用 AsyncLocalStorage 实现上下文管理
-✅ 保持向后兼容，降低迁移成本
-
-**当前状态**: 新架构已就绪，等待迁移和测试验证。

package/src/adapter.ts

@@ -1,275 +0,0 @@
-import { Bot } from "./bot.js";
-import { Plugin } from "./plugin.js";
-import { EventEmitter } from "events";
-import { Message } from "./message.js";
-import { Notice } from "./notice.js";
-import { Request } from "./request.js";
-import { BeforeSendHandler, SendOptions, AITool, ToolContext } from "./types.js";
-import { isZhinTool, ToolInput } from "./built/tool.js";
-import { segment } from "./utils.js";
-/**
- * Adapter类：适配器抽象，管理多平台Bot实例。
- * 负责根据配置启动/关闭各平台机器人，统一异常处理。
- * 
- * 适配器可以提供 AI 工具，供 AI 服务调用。
- */
-export abstract class Adapter<R extends Bot = Bot> extends EventEmitter<Adapter.Lifecycle> {
-  /** 当前适配器下所有Bot实例，key为bot名称 */
-  public bots: Map<string, R> = new Map<string, R>();
-  /** 适配器提供的 AI 工具 */
-  public tools: Map<string, AITool> = new Map<string, AITool>();
-  /**
-   * 构造函数
-   * @param name 适配器名称（如 'process'、'qq' 等）
-   * @param botFactory Bot工厂函数或构造器
-   */
-  constructor(
-    public plugin: Plugin,
-    public name: keyof Plugin.Contexts,
-    public config: Adapter.BotConfig<R>[]
-  ) {
-    super();
-    this.on('call.recallMessage', async(bot_id, id) => {
-      const bot = this.bots.get(bot_id);
-      if(!bot) throw new Error(`Bot ${bot_id} not found`);
-      this.logger.info(`${bot_id} recall ${id}`);
-      await bot.$recallMessage(id);
-    })
-  }
-
-  /**
-   * 重写 emit：拦截 message.receive 事件，按架构规定的入站流程处理
-   * 入站消息链：adapter.emit → dispatcher.dispatch → plugin.dispatch('message.receive') → adapter observers
-   */
-  emit<K extends keyof Adapter.Lifecycle>(event: K, ...args: Adapter.Lifecycle[K]): boolean {
-    if (event !== 'message.receive') {
-      return super.emit(event, ...args as any);
-    }
-    const message = args[0] as Message;
-    this.logger.info(`${message.$bot} recv ${message.$channel.type}(${message.$channel.id}):${segment.raw(message.$content)}`);
-    // 异步执行入站消息处理链
-    (async () => {
-      // Step 1: 如果有 Dispatcher，先通过它
-      const dispatcher = this.plugin?.inject('dispatcher');
-      if (dispatcher && typeof dispatcher.dispatch === 'function') {
-        await dispatcher.dispatch(message);
-      }
-      // Step 2: 触发插件生命周期事件
-      this.plugin?.dispatch('message.receive', message);
-      // Step 3: 通知 adapter.on('message.receive') 观察者
-      super.emit(event, ...args as any);
-    })().catch((e) => {
-      this.logger.warn(`message.receive handling error: ${e instanceof Error ? e.message : String(e)}`);
-    });
-    return true;
-  }
-  abstract createBot(config: Adapter.BotConfig<R>): R;
-  get logger() {
-    if(!this.plugin) throw new Error("Adapter is not associated with any plugin");
-    return this.plugin.logger;
-  }
-  binding(plugin: Plugin) {
-    this.plugin = plugin;
-  }
-  private async renderSendMessage(options:SendOptions):Promise<SendOptions>{
-    const fns=this.plugin.root.listeners('before.sendMessage') as BeforeSendHandler[];
-    for(const fn of fns){
-      const result=await fn(options);
-      if(result) options=result;
-    }
-    return options;
-  }
-  async sendMessage(options:SendOptions):Promise<string>{
-    options=await this.renderSendMessage(options);
-    const bot = this.bots.get(options.bot);
-    if(!bot) throw new Error(`Bot ${options.bot} not found`);
-    this.logger.info(`${options.bot} send ${options.type}(${options.id}):${segment.raw(options.content)}`);
-    return await bot.$sendMessage(options);
-  }
-  async start() {
-    this.plugin.root.adapters.push(this.name);
-    if (!this.config?.length) return;
-
-    for (const config of this.config) {
-      const bot = this.createBot(config);
-      await bot.$connect();
-      this.logger.debug(`bot ${bot.$id} of adapter ${this.name} connected`);
-      this.bots.set(bot.$id, bot);
-    }
-    this.logger.debug(`adapter ${this.name} started`);
-  }
-  /**
-   * 停止适配器，断开并移除所有Bot实例
-   * @param plugin 所属插件实例
-   */
-  async stop() {
-    try {
-      for (const [id, bot] of this.bots) {
-        try {
-          await bot.$disconnect();
-          this.logger.debug(`bot ${id} of adapter ${this.name} disconnected`);
-        } catch (error) {
-          // 如果断开连接失败，确保错误正确传播
-          throw error;
-        }
-      }
-      // 清理 bots Map
-      this.bots.clear();
-      
-      // 从 adapters 数组中移除
-      const idx = this.plugin.root.adapters.indexOf(this.name);
-      if (idx !== -1) {
-        this.plugin.root.adapters.splice(idx, 1);
-      }
-      
-      // 移除所有事件监听器
-      this.removeAllListeners();
-      
-      this.logger.info(`adapter ${this.name} stopped`);
-    } catch (error) {
-      // 确保错误正确传播
-      throw error;
-    }
-  }
-  
-  /**
-   * 注册 AI 工具
-   * @param tool 工具定义
-   * @returns 返回一个移除工具的函数
-   */
-  addTool(input: ToolInput): () => void {
-    const tool: AITool = isZhinTool(input) ? input.toTool() : input;
-    // 自动添加适配器源标识
-    const toolWithSource: AITool = {
-      ...tool,
-      source: tool.source || `adapter:${this.name}`,
-      tags: [...(tool.tags || []), 'adapter', this.name],
-    };
-    this.tools.set(tool.name, toolWithSource);
-    return () => {
-      this.tools.delete(tool.name);
-    };
-  }
-  
-  /**
-   * 获取所有注册的工具
-   * @returns 工具数组
-   */
-  getTools(): AITool[] {
-    return Array.from(this.tools.values());
-  }
-  
-  /**
-   * 根据名称获取工具
-   * @param name 工具名称
-   * @returns 工具定义或 undefined
-   */
-  getTool(name: string): AITool | undefined {
-    return this.tools.get(name);
-  }
-  
-  /**
-   * 提供默认的适配器工具（子类可覆盖）
-   * 包含发送消息、撤回消息等基础能力
-   */
-  protected registerDefaultTools(): void {
-    // 发送消息工具
-    this.addTool({
-      name: `${this.name}_send_message`,
-      description: `使用 ${this.name} 适配器发送消息到指定目标`,
-      parameters: {
-        type: 'object',
-        properties: {
-          bot: {
-            type: 'string',
-            description: 'Bot 名称/ID',
-          },
-          id: {
-            type: 'string',
-            description: '目标 ID（用户/群/频道）',
-          },
-          type: {
-            type: 'string',
-            enum: ['private', 'group', 'channel'],
-            description: '消息类型',
-          },
-          content: {
-            type: 'string',
-            description: '消息内容',
-          },
-        },
-        required: ['bot', 'id', 'type', 'content'],
-      },
-      execute: async (args) => {
-        const { bot, id, type, content } = args;
-        return await this.sendMessage({
-          context: this.name,
-          bot,
-          id,
-          type: type as 'private' | 'group' | 'channel',
-          content,
-        });
-      },
-    });
-    
-    // 获取 Bot 列表工具
-    this.addTool({
-      name: `${this.name}_list_bots`,
-      description: `获取 ${this.name} 适配器下所有已连接的 Bot 列表`,
-      parameters: {
-        type: 'object',
-        properties: {},
-      },
-      execute: async () => {
-        return Array.from(this.bots.entries()).map(([id, bot]) => ({
-          id,
-          connected: bot.$connected,
-        }));
-      },
-    });
-  }
-}
-export interface Adapters {}
-export namespace Adapter {
-  export type Factory<R extends Adapter = Adapter> = {
-    new (
-    plugin: Plugin,
-    name: string,
-    config: Adapter.BotConfig<Adapter.InferBot<R>>[]
-  ):R
-  };
-  export interface Lifecycle {
-    'message.receive': [Message];
-    'message.private.receive': [Message];
-    'message.group.receive': [Message];
-    'message.channel.receive': [Message];
-    'notice.receive': [Notice];
-    'request.receive': [Request];
-    'call.recallMessage': [string, string];
-  }
-  /**
-   * 适配器工厂注册表
-   * 灵感来源于 zhinjs/next 的 Adapter.Registry
-   */
-  export const Registry = new Map<string, Factory>();
-  export type InferBot<R extends Adapter=Adapter> = R extends Adapter<infer T>
-    ? T
-    : never;
-  export type BotConfig<T extends Bot> = T extends Bot<infer R> ? R : never;
-  export type BotMessage<T extends Bot> = T extends Bot<infer _L, infer R>
-    ? R
-    : never;
-  /**
-   * 注册适配器工厂
-   *
-   * @param name 适配器名称
-   * @param factory 适配器工厂函数
-   * @example
-   * ```typescript
-   * Adapter.register('icqq', IcqqAdapter);
-   * ```
-   */
-  export function register(name: string, factory: Factory) {
-    Registry.set(name, factory);
-  }
-}

package/src/ai/index.ts

@@ -1,52 +0,0 @@
-/**
- * @zhin.js/core — AI 模块
- *
- * 类型定义和 Provider 实现已迁移至独立的 @zhin.js/ai 包，
- * 此文件通过 re-export 保持向后兼容。
- *
- * 注意：ToolDefinition 不在此 re-export，因为 core/types.ts 有自己的同名类型。
- * 使用 ChatToolDefinition 别名代替。
- */
-
-export type {
-  AIConfig,
-  AIProvider,
-  ProviderConfig,
-  ProviderCapabilities,
-  OllamaProviderConfig,
-  ChatMessage,
-  ChatCompletionRequest,
-  ChatCompletionResponse,
-  ChatCompletionChunk,
-  ChatCompletionChoice,
-  ChatCompletionChunkChoice,
-  ContentPart,
-  ToolCall,
-  MessageRole,
-  AgentTool,
-  AgentConfig,
-  AgentResult,
-  ToolFilterOptions,
-  Usage,
-  SessionConfig,
-  Session,
-  JsonSchema,
-} from '@zhin.js/ai';
-
-export type { ToolDefinition as ChatToolDefinition } from '@zhin.js/ai';
-
-export {
-  BaseProvider,
-  OpenAIProvider,
-  DeepSeekProvider,
-  MoonshotProvider,
-  ZhipuProvider,
-  AnthropicProvider,
-  OllamaProvider,
-} from '@zhin.js/ai';
-
-export type {
-  OpenAIConfig,
-  AnthropicConfig,
-  OllamaConfig,
-} from '@zhin.js/ai';