@wwlocal/aibot-plugin-node 20260409.20.0

package/dist/esm/types/src/adapters/base-adapter.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 适配器基础抽象类
+ *
+ * 提供所有适配器共用的能力：
+ * - 超时控制
+ * - 请求头构建
+ * - SSE 流式解析工具方法
+ * - 日志工具
+ */
+import type { AgentEndpoint, RuntimeLogger } from "../interface.js";
+import type { AgentAdapter, AdapterRequest, AdapterCallbacks } from "./types.js";
+/**
+ * 适配器基础抽象类
+ */
+export declare abstract class BaseAdapter implements AgentAdapter {
+    abstract readonly name: string;
+    abstract readonly displayName: string;
+    /**
+     * 执行转发（子类必须实现）
+     */
+    abstract forward(request: AdapterRequest, endpoint: AgentEndpoint, callbacks: AdapterCallbacks): Promise<string>;
+    /**
+     * 构建通用请求头
+     */
+    protected buildHeaders(endpoint: AgentEndpoint): Record<string, string>;
+    /**
+     * 创建带超时的 AbortController
+     *
+     * @param timeoutMs 超时时间（毫秒）
+     * @param externalSignal 外部中止信号（可选）
+     * @returns { controller, timeoutId }
+     */
+    protected createTimeoutController(timeoutMs: number, externalSignal?: AbortSignal): {
+        controller: AbortController;
+        timeoutId: NodeJS.Timeout;
+    };
+    /**
+     * 包装 Promise 添加超时控制
+     */
+    protected withTimeout<T>(promise: Promise<T>, timeoutMs: number, timeoutMessage?: string): Promise<T>;
+    /**
+     * 解析单行 SSE 数据
+     *
+     * @param line 原始 SSE 行
+     * @returns { event, data } 或 null（非 data 行或空行）
+     */
+    protected parseSSELine(line: string): {
+        event?: string;
+        data?: string;
+    } | null;
+    /**
+     * 创建 SSE 流读取器
+     *
+     * 返回一个异步生成器，逐行产出 SSE 数据
+     */
+    protected readSSEStream(reader: ReadableStreamDefaultReader<Uint8Array>, runtime?: RuntimeLogger): AsyncGenerator<{
+        event?: string;
+        data: string;
+    }, void, unknown>;
+    /**
+     * 发起 HTTP 请求并处理错误
+     */
+    protected fetchWithErrorHandling(url: string, options: RequestInit, runtime?: RuntimeLogger): Promise<Response>;
+    /**
+     * 日志前缀
+     */
+    protected get logPrefix(): string;
+    /**
+     * 打印日志
+     */
+    protected log(runtime: RuntimeLogger | undefined, message: string): void;
+    /**
+     * 打印错误日志
+     */
+    protected logError(runtime: RuntimeLogger | undefined, message: string): void;
+}

package/dist/esm/types/src/adapters/deepseek-adapter.d.ts

@@ -0,0 +1,87 @@
+/**
+ * DeepSeek 适配器
+ *
+ * 适用于：DeepSeek Chat (deepseek-chat) 和 DeepSeek Reasoner (deepseek-reasoner) 模型
+ *
+ * 与 OpenAI 适配器的差异：
+ * - 响应中额外包含 reasoning_content 字段（思维链）
+ * - 支持 reasoningDisplay 配置：show/hide/collapse（默认）
+ * - Reasoner 模型自动添加 thinking 参数
+ *
+ * 推理内容折叠展示格式（collapse 模式）：
+ * <think>
+ * {reasoning_content}
+ * </think>
+ *
+ * {content}
+ */
+import type { AgentEndpoint } from "../interface.js";
+import { OpenAIAdapter } from "./openai-adapter.js";
+import type { ChatMessage, ChatCompletionsRequest, StreamDelta, ChatCompletionsResponse } from "./types.js";
+/**
+ * DeepSeek 适配器
+ */
+export declare class DeepSeekAdapter extends OpenAIAdapter {
+    readonly name: string;
+    readonly displayName: string;
+    private accumulatedReasoning;
+    /**
+     * 获取推理内容展示模式
+     */
+    private getReasoningDisplayMode;
+    /**
+     * 是否为 Reasoner 模型
+     */
+    private isReasonerModel;
+    /**
+     * 构建请求体（覆写以添加 thinking 参数）
+     */
+    protected buildRequestBody(messages: ChatMessage[], endpoint: AgentEndpoint): ChatCompletionsRequest;
+    /**
+     * 解析流式 delta 内容（覆写以处理 reasoning_content）
+     */
+    protected parseStreamDelta(parsed: StreamDelta): {
+        content?: string;
+        reasoningContent?: string;
+    };
+    /**
+     * 累积内容（覆写以处理推理内容）
+     *
+     * 注意：此方法需要知道 endpoint 配置，但父类签名不包含
+     * 因此使用实例变量 accumulatedReasoning 来跨调用保持状态
+     */
+    protected accumulateContent(accumulated: string, content?: string, reasoningContent?: string): string;
+    /**
+     * 格式化最终输出（根据 displayMode 配置）
+     */
+    private formatOutput;
+    /**
+     * 处理流式响应（覆写以支持推理内容格式化）
+     */
+    protected handleStreamResponse(params: {
+        response: Response;
+        deliver: any;
+        onReplyStart?: any;
+        onError?: any;
+        runtime?: any;
+        endpoint?: AgentEndpoint;
+    }): Promise<string>;
+    /**
+     * 解析非流式响应内容（覆写以处理 reasoning_content）
+     */
+    protected parseNonStreamResponse(data: ChatCompletionsResponse): string;
+    /**
+     * 转发请求（覆写以传递 endpoint 到流式处理）
+     */
+    forward(request: any, endpoint: AgentEndpoint, callbacks: any): Promise<string>;
+    /**
+     * 处理 DeepSeek 流式响应
+     *
+     * 注意：节流逻辑已移至 monitor 层统一控制，适配器层每个有效 delta 都直接 deliver
+     */
+    private handleDeepSeekStreamResponse;
+    /**
+     * 处理 DeepSeek 非流式响应
+     */
+    private handleDeepSeekNonStreamResponse;
+}

package/dist/esm/types/src/adapters/dify-adapter.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Dify 适配器
+ *
+ * 适用于：Dify 平台的 Chat 应用（ChatBot / Chatflow）
+ *
+ * 与 OpenAI 的核心差异：
+ * - 接口路径：/v1/chat-messages（而非 /v1/chat/completions）
+ * - 请求格式：{ query, user, conversation_id, response_mode, inputs, files }
+ * - 流式标识：response_mode: "streaming"
+ * - SSE 事件类型：
+ *   - ChatBot 模式：message（answer 字段）
+ *   - Chatflow 模式：text_chunk（text 字段）+ workflow/node/iteration/loop 事件
+ * - 会话管理：conversation_id（有状态多轮对话）
+ * - 文件上传：/v1/files/upload（multipart form-data）
+ */
+import type { AgentEndpoint } from "../interface.js";
+import { BaseAdapter } from "./base-adapter.js";
+import type { AdapterRequest, AdapterCallbacks } from "./types.js";
+/**
+ * Dify 适配器
+ */
+export declare class DifyAdapter extends BaseAdapter {
+    readonly name = "dify";
+    readonly displayName = "Dify";
+    private static conversationCache;
+    /**
+     * 获取 Dify 配置选项
+     */
+    private getOptions;
+    /**
+     * 转发请求到 Dify API
+     */
+    forward(request: AdapterRequest, endpoint: AgentEndpoint, callbacks: AdapterCallbacks): Promise<string>;
+    /**
+     * 构建 Dify 请求体
+     */
+    private buildDifyRequest;
+    /**
+     * 处理流式响应
+     */
+    private handleStreamResponse;
+    /**
+     * 处理非流式（blocking）响应
+     */
+    private handleBlockingResponse;
+    /**
+     * 准备 Dify 文件参数
+     *
+     * 根据 Dify 文档，文件有两种传输方式：
+     * - remote_url：直接传 URL，Dify 自行下载（适用于远程 URL）
+     * - local_file：先通过 /v1/files/upload 上传，再传 upload_file_id（适用于本地文件）
+     *
+     * @returns DifyFile 列表（处理失败的跳过并记录日志）
+     */
+    private prepareDifyFiles;
+    /**
+     * 上传本地文件到 Dify（/v1/files/upload）
+     *
+     * @returns 上传成功的 DifyFile，失败返回 undefined
+     */
+    private uploadLocalFile;
+    /**
+     * 从 URL 中提取文件名
+     */
+    private extractFilename;
+    /**
+     * 根据文件名猜测 Content-Type
+     */
+    private guessContentType;
+    /**
+     * 从 URL 中猜测 Content-Type
+     */
+    private guessContentTypeFromUrl;
+    /**
+     * 根据 Content-Type 推断 Dify 文件类型
+     */
+    private inferDifyFileType;
+    /**
+     * 拼接 Dify API URL
+     *
+     * 支持多种 baseUrl 格式：
+     * - http://host/v1 → http://host/v1/chat-messages
+     * - http://host/v1/ → http://host/v1/chat-messages
+     * - http://host → http://host/v1/chat-messages
+     * - http://host/v1/chat-messages → http://host/v1/chat-messages (不变)
+     */
+    private buildChatMessagesUrl;
+    /**
+     * 拼接 Dify API 通用路径
+     */
+    private buildApiUrl;
+    /**
+     * 解析文件 URL（处理相对路径）
+     *
+     * Dify 返回的 message_file.url 可能是：
+     * - 完整的 HTTP URL → 直接使用
+     * - 相对路径（如 /files/xxx/preview） → 拼接 baseUrl
+     */
+    private resolveFileUrl;
+}

package/dist/esm/types/src/adapters/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 适配器注册表
+ *
+ * 管理所有智能体适配器的注册与发现
+ */
+import type { AgentEndpoint } from "../interface.js";
+import type { AgentAdapter, IAdapterRegistry } from "./types.js";
+/**
+ * 适配器注册表实现
+ */
+declare class AdapterRegistry implements IAdapterRegistry {
+    private adapters;
+    /**
+     * 注册适配器
+     */
+    register(adapter: AgentAdapter): void;
+    /**
+     * 按 provider 名称获取适配器
+     */
+    get(provider: string): AgentAdapter | undefined;
+    /**
+     * 列出所有已注册适配器
+     */
+    list(): AgentAdapter[];
+    /**
+     * 解析并返回适配器
+     *
+     * 解析优先级：
+     * 1. 优先使用 endpoint.provider 指定的适配器
+     * 2. 若 provider 未配置，尝试从 url 自动推断
+     * 3. 兜底使用 openai 适配器
+     */
+    resolve(endpoint: AgentEndpoint): AgentAdapter;
+    /**
+     * 从 URL 推断 provider 类型
+     */
+    private inferProviderFromUrl;
+}
+/**
+ * 全局适配器注册表
+ */
+export declare const adapterRegistry: AdapterRegistry;
+export type { AgentAdapter, AdapterRequest, AdapterCallbacks, AdapterContext, IAdapterRegistry, ChatMessage, ChatContentPart, ChatCompletionsRequest, StreamDelta, ChatCompletionsResponse, ReasoningDisplayMode, DeepSeekProviderOptions, AnthropicProviderOptions, AnthropicMessage, AnthropicContentBlock, AnthropicMessagesRequest, AnthropicMessagesResponse, AnthropicSSEEventType, AnthropicSSEEvent, DifyAppType, DifyProviderOptions, DifyChatRequest, DifyFile, DifyEventType, DifySSEEvent, WebhookProviderOptions, } from "./types.js";
+export { BaseAdapter } from "./base-adapter.js";
+export { OpenAIAdapter } from "./openai-adapter.js";
+export { DeepSeekAdapter } from "./deepseek-adapter.js";
+export { AnthropicAdapter } from "./anthropic-adapter.js";
+export { DifyAdapter } from "./dify-adapter.js";
+export { WebhookAdapter } from "./webhook-adapter.js";
+/**
+ * 获取已注册适配器列表（用于启动日志）
+ */
+export declare function getRegisteredAdapters(): Array<{
+    name: string;
+    displayName: string;
+}>;
+/**
+ * 根据端点配置解析适配器
+ */
+export declare function resolveAdapter(endpoint: AgentEndpoint): AgentAdapter;

package/dist/esm/types/src/adapters/openai-adapter.d.ts

@@ -0,0 +1,82 @@
+/**
+ * OpenAI 适配器
+ *
+ * 适用于：OpenAI、Azure OpenAI、Ollama、vLLM、LocalAI 及任何 OpenAI Chat Completions API 兼容服务
+ *
+ * 特性：
+ * - 请求：{ messages, model, stream }
+ * - 流式响应：SSE data: {...} → 提取 choices[0].delta.content
+ * - 非流式响应：JSON → 提取 choices[0].message.content
+ * - 认证：Authorization: Bearer {apiKey}
+ */
+import type { AgentEndpoint } from "../interface.js";
+import { BaseAdapter } from "./base-adapter.js";
+import type { AdapterRequest, AdapterCallbacks, ChatMessage, ChatCompletionsRequest, StreamDelta, ChatCompletionsResponse } from "./types.js";
+/**
+ * OpenAI 适配器
+ */
+export declare class OpenAIAdapter extends BaseAdapter {
+    readonly name: string;
+    readonly displayName: string;
+    /**
+     * 转发请求到 OpenAI 兼容 API
+     */
+    forward(request: AdapterRequest, endpoint: AgentEndpoint, callbacks: AdapterCallbacks): Promise<string>;
+    /**
+     * 将企微消息构建为 OpenAI messages 数组
+     */
+    protected buildMessages(options: {
+        text: string;
+        mediaPaths?: Array<{
+            path: string;
+            contentType?: string;
+        }>;
+        quoteContent?: string;
+        systemPrompt?: string;
+        historyMessages?: Array<{
+            role: "user" | "assistant";
+            content: string;
+        }>;
+    }): ChatMessage[];
+    /**
+     * 构建请求体
+     */
+    protected buildRequestBody(messages: ChatMessage[], endpoint: AgentEndpoint): ChatCompletionsRequest;
+    /**
+     * 处理流式响应
+     *
+     * 注意：节流逻辑已移至 monitor 层统一控制，适配器层每个有效 delta 都直接 deliver
+     */
+    protected handleStreamResponse(params: {
+        response: Response;
+        deliver: AdapterCallbacks["deliver"];
+        onReplyStart?: AdapterCallbacks["onReplyStart"];
+        onError?: AdapterCallbacks["onError"];
+        runtime?: AdapterRequest["runtime"];
+    }): Promise<string>;
+    /**
+     * 解析流式 delta 内容（子类可覆写）
+     */
+    protected parseStreamDelta(parsed: StreamDelta): {
+        content?: string;
+        reasoningContent?: string;
+    };
+    /**
+     * 累积内容（子类可覆写以自定义格式）
+     */
+    protected accumulateContent(accumulated: string, content?: string, _reasoningContent?: string): string;
+    /**
+     * 处理非流式响应
+     */
+    protected handleNonStreamResponse(params: {
+        response: Response;
+        deliver: AdapterCallbacks["deliver"];
+        onReplyStart?: AdapterCallbacks["onReplyStart"];
+        onError?: AdapterCallbacks["onError"];
+        runtime?: AdapterRequest["runtime"];
+    }): Promise<string>;
+    /**
+     * 解析非流式响应内容（子类可覆写）
+     */
+    protected parseNonStreamResponse(data: ChatCompletionsResponse): string;
+}