@astack-tech/integrations 0.1.1-beta.0

package/dist/model-provider/index.js

@@ -0,0 +1,178 @@
+// src/model-provider/deepseek/index.ts
+import { Component } from "@astack-tech/core";
+import OpenAI from "openai";
+var Deepseek = class extends Component {
+  constructor(config) {
+    super({});
+    this.client = new OpenAI({
+      apiKey: config.apiKey,
+      baseURL: config.baseURL || "https://api.deepseek.com/v1"
+    });
+    this.model = config.model || "deepseek-chat";
+    this.temperature = config.temperature ?? 0.7;
+    this.maxTokens = config.maxTokens;
+    this.topP = config.topP;
+    this.systemPrompt = config.systemPrompt;
+    if (config.rawTools && config.rawTools.length > 0) {
+      this.tools = config.rawTools.map((tool) => ({
+        type: "function",
+        function: {
+          name: tool.name,
+          description: tool.description,
+          parameters: tool.parameters || {}
+        }
+      }));
+    } else {
+      this.tools = config.tools;
+    }
+    Component.Port.I("prompt").attach(this);
+    Component.Port.I("messages").attach(this);
+    Component.Port.O("completion").attach(this);
+    Component.Port.O("message").attach(this);
+  }
+  /**
+   * 生成文本完成
+   * @param prompt 提示文本
+   * @returns 生成的文本
+   */
+  async generateCompletion(prompt) {
+    const messages = [];
+    if (this.systemPrompt) {
+      messages.push({
+        role: "system",
+        content: this.systemPrompt
+      });
+    }
+    messages.push({
+      role: "user",
+      content: prompt
+    });
+    const requestParams = {
+      model: this.model,
+      messages,
+      temperature: this.temperature,
+      max_tokens: this.maxTokens,
+      top_p: this.topP
+    };
+    if (this.tools && this.tools.length > 0) {
+      requestParams.tools = this.tools;
+    }
+    const response = await this.client.chat.completions.create(requestParams);
+    if (response.choices[0].message.tool_calls && response.choices[0].message.tool_calls.length > 0) {
+      return JSON.stringify(response.choices[0].message);
+    }
+    return response.choices[0].message.content || "";
+  }
+  /**
+   * 处理对话消息
+   * @param messages 对话消息数组
+   * @param options 可选的调用选项，包含临时工具列表
+   * @returns 生成的响应消息
+   */
+  async chatCompletion(messages, options) {
+    const formattedMessages = [];
+    if (this.systemPrompt) {
+      formattedMessages.push({
+        role: "system",
+        content: this.systemPrompt
+      });
+    }
+    formattedMessages.push(
+      ...messages.map((msg) => {
+        const formattedMsg = {
+          role: msg.role,
+          content: msg.content
+        };
+        if (msg.role === "tool" && msg.tool_call_id) {
+          formattedMsg.tool_call_id = msg.tool_call_id;
+        }
+        return formattedMsg;
+      })
+    );
+    const requestParams = {
+      model: this.model,
+      messages: formattedMessages,
+      temperature: this.temperature,
+      max_tokens: this.maxTokens,
+      top_p: this.topP
+    };
+    const toolsToUse = options?.temporaryTools || this.tools;
+    if (toolsToUse && toolsToUse.length > 0) {
+      const formattedTools = toolsToUse.map((tool) => {
+        const typedTool = tool;
+        if (typedTool.type === "function") {
+          return tool;
+        }
+        return {
+          type: "function",
+          function: {
+            name: typedTool.name,
+            description: typedTool.description,
+            parameters: typedTool.parameters || {}
+          }
+        };
+      });
+      requestParams.tools = formattedTools;
+    }
+    const response = await this.client.chat.completions.create(requestParams);
+    const responseMessage = response.choices[0].message;
+    const result = {
+      role: "assistant",
+      content: responseMessage.content || ""
+    };
+    if (responseMessage.tool_calls && responseMessage.tool_calls.length > 0) {
+      result.tool_calls = responseMessage.tool_calls.map((toolCall) => ({
+        id: toolCall.id,
+        tool_name: toolCall.function.name,
+        arguments: JSON.parse(toolCall.function.arguments || "{}")
+      }));
+    }
+    return result;
+  }
+  /**
+   * 在独立模式下运行组件
+   * @param input 输入参数，可以是提示文本或对话消息数组
+   * @returns 生成的文本或响应消息
+   */
+  async run(input) {
+    if (typeof input === "string") {
+      return this.generateCompletion(input);
+    } else {
+      return this.chatCompletion(input);
+    }
+  }
+  /**
+   * 在流水线中运行组件
+   * @param $i 输入端口
+   * @param $o 输出端口
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _transform($i, $o) {
+    $i("prompt").receive(async (prompt) => {
+      try {
+        const completion = await this.generateCompletion(prompt);
+        $o("completion").send(completion);
+      } catch (error) {
+        console.error("Deepseek API \u8C03\u7528\u9519\u8BEF:", error);
+        $o("completion").send("API \u8C03\u7528\u9519\u8BEF");
+      }
+    });
+    $i("messages").receive(async (messages) => {
+      try {
+        const responseMessage = await this.chatCompletion(messages);
+        $o("message").send(responseMessage);
+      } catch (error) {
+        console.error("Deepseek API \u8C03\u7528\u9519\u8BEF:", error);
+        $o("message").send({
+          role: "assistant",
+          content: "API \u8C03\u7528\u9519\u8BEF"
+        });
+      }
+    });
+  }
+};
+var deepseek_default = Deepseek;
+export {
+  deepseek_default as Deepseek
+};
+//# sourceMappingURL=index.js.map

package/dist/model-provider/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/model-provider/deepseek/index.ts"],"sourcesContent":["import { Component } from '@astack-tech/core';\nimport OpenAI from 'openai';\n\n/**\n * Deepseek 模型提供者配置\n */\nexport interface DeepseekConfig {\n  /**\n   * API 密钥\n   */\n  apiKey: string;\n\n  /**\n   * 使用的模型名称\n   * 默认为 'deepseek-chat'\n   */\n  model?: string;\n\n  /**\n   * 自定义 API 基础 URL\n   * 默认为 Deepseek 官方 API 地址\n   */\n  baseURL?: string;\n\n  /**\n   * 温度参数，控制输出的随机性\n   */\n  temperature?: number;\n\n  /**\n   * 最大生成的 token 数\n   */\n  maxTokens?: number;\n\n  /**\n   * 采样概率\n   */\n  topP?: number;\n\n  /**\n   * 系统提示消息\n   */\n  systemPrompt?: string;\n\n  /**\n   * 工具实例数组，直接传递工具实例\n   * 每个工具应具有 name、description 和 parameters 属性\n   */\n  rawTools?: Array<{\n    name: string;\n    description: string;\n    parameters?: Record<string, unknown>;\n  }>;\n\n  /**\n   * API 格式的工具定义数组，与 rawTools 二选一\n   * 使用 OpenAI 兼容的工具定义格式\n   */\n  tools?: unknown[];\n}\n\n/**\n * 消息角色类型\n */\nexport type MessageRole = 'system' | 'user' | 'assistant' | 'tool';\n\n/**\n * 工具调用\n */\nexport interface ToolCall {\n  /**\n   * 工具调用 ID\n   */\n  id?: string;\n\n  /**\n   * 工具名称\n   */\n  tool_name: string;\n\n  /**\n   * 工具调用参数\n   */\n  arguments: Record<string, unknown>;\n}\n\n/**\n * 对话消息类型\n */\nexport interface Message {\n  /**\n   * 消息角色\n   */\n  role: MessageRole;\n\n  /**\n   * 消息内容\n   */\n  content?: string;\n\n  /**\n   * 工具调用\n   */\n  tool_calls?: ToolCall[];\n\n  /**\n   * 工具调用 ID，用于工具响应消息\n   */\n  tool_call_id?: string;\n}\n\n/**\n * Deepseek 组件\n *\n * 使用 OpenAI 兼容接口调用 Deepseek 模型\n *\n * 输入:\n *   - prompt: 文本提示\n *   - messages: 对话消息数组\n *\n * 输出:\n *   - completion: 生成的文本完成\n *   - message: 生成的响应消息\n */\nclass Deepseek extends Component {\n  // OpenAI 客户端实例\n  private client: OpenAI;\n\n  // 配置选项\n  private model: string;\n  private temperature: number;\n  private maxTokens?: number;\n  private topP?: number;\n  private systemPrompt?: string;\n  private tools?: unknown[];\n\n  constructor(config: DeepseekConfig) {\n    super({});\n\n    // 配置客户端\n    this.client = new OpenAI({\n      apiKey: config.apiKey,\n      baseURL: config.baseURL || 'https://api.deepseek.com/v1',\n    });\n\n    // 保存基本配置\n    this.model = config.model || 'deepseek-chat';\n    this.temperature = config.temperature ?? 0.7;\n    this.maxTokens = config.maxTokens;\n    this.topP = config.topP;\n    this.systemPrompt = config.systemPrompt;\n\n    // 处理工具配置，优先使用 rawTools\n    if (config.rawTools && config.rawTools.length > 0) {\n      // 将工具实例转换为 API 格式\n      this.tools = config.rawTools.map(tool => ({\n        type: 'function',\n        function: {\n          name: tool.name,\n          description: tool.description,\n          parameters: tool.parameters || {},\n        },\n      }));\n    } else {\n      // 使用直接提供的 API 格式工具\n      this.tools = config.tools;\n    }\n\n    // 重命名端口\n    Component.Port.I('prompt').attach(this);\n    Component.Port.I('messages').attach(this);\n    Component.Port.O('completion').attach(this);\n    Component.Port.O('message').attach(this);\n  }\n\n  /**\n   * 生成文本完成\n   * @param prompt 提示文本\n   * @returns 生成的文本\n   */\n  async generateCompletion(prompt: string): Promise<string> {\n    const messages: Array<OpenAI.Chat.ChatCompletionMessageParam> = [];\n\n    // 添加系统提示\n    if (this.systemPrompt) {\n      messages.push({\n        role: 'system',\n        content: this.systemPrompt,\n      });\n    }\n\n    // 添加用户提示\n    messages.push({\n      role: 'user',\n      content: prompt,\n    });\n\n    // 创建请求参数\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const requestParams: any = {\n      model: this.model,\n      messages,\n      temperature: this.temperature,\n      max_tokens: this.maxTokens,\n      top_p: this.topP,\n    };\n\n    // 如果有工具定义，添加到请求中\n    if (this.tools && this.tools.length > 0) {\n      requestParams.tools = this.tools;\n    }\n\n    // 调用 API\n    const response = await this.client.chat.completions.create(requestParams);\n\n    // 处理工具调用结果\n    if (\n      response.choices[0].message.tool_calls &&\n      response.choices[0].message.tool_calls.length > 0\n    ) {\n      return JSON.stringify(response.choices[0].message);\n    }\n\n    return response.choices[0].message.content || '';\n  }\n\n  /**\n   * 处理对话消息\n   * @param messages 对话消息数组\n   * @param options 可选的调用选项，包含临时工具列表\n   * @returns 生成的响应消息\n   */\n  async chatCompletion(\n    messages: Message[],\n    options?: { temporaryTools?: unknown[] }\n  ): Promise<Message> {\n    // 转换消息格式\n    const formattedMessages: Array<OpenAI.Chat.ChatCompletionMessageParam> = [];\n\n    // 添加系统提示\n    if (this.systemPrompt) {\n      formattedMessages.push({\n        role: 'system',\n        content: this.systemPrompt,\n      });\n    }\n\n    // 添加用户提供的消息\n    formattedMessages.push(\n      ...messages.map(msg => {\n        // 基本消息结构\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const formattedMsg: any = {\n          role: msg.role,\n          content: msg.content,\n        };\n\n        // 如果有工具调用 ID，添加到消息中\n        if (msg.role === 'tool' && msg.tool_call_id) {\n          formattedMsg.tool_call_id = msg.tool_call_id;\n        }\n\n        return formattedMsg;\n      })\n    );\n\n    // 创建请求参数\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const requestParams: any = {\n      model: this.model,\n      messages: formattedMessages,\n      temperature: this.temperature,\n      max_tokens: this.maxTokens,\n      top_p: this.topP,\n    };\n\n    // 决定使用哪些工具\n    // 如果提供了临时工具，优先使用临时工具\n    const toolsToUse = options?.temporaryTools || this.tools;\n\n    // 如果有工具定义，添加到请求中\n    if (toolsToUse && toolsToUse.length > 0) {\n      // 检查工具格式并转换，确保符合 Deepseek API 要求\n      const formattedTools = toolsToUse.map(tool => {\n        // 使用类型断言来处理 unknown 类型\n        type ToolType = {\n          type?: string;\n          name?: string;\n          description?: string;\n          parameters?: Record<string, unknown>;\n        };\n\n        const typedTool = tool as ToolType;\n\n        // 如果工具已经是 API 格式，直接返回\n        if (typedTool.type === 'function') {\n          return tool;\n        }\n\n        // 如果是简单工具实例，转换为 API 格式\n        return {\n          type: 'function',\n          function: {\n            name: typedTool.name,\n            description: typedTool.description,\n            parameters: typedTool.parameters || {},\n          },\n        };\n      });\n\n      requestParams.tools = formattedTools;\n    }\n\n    // 调用 API\n    const response = await this.client.chat.completions.create(requestParams);\n\n    // 解析响应\n    const responseMessage = response.choices[0].message;\n\n    // 转换为内部消息格式\n    const result: Message = {\n      role: 'assistant',\n      content: responseMessage.content || '',\n    };\n\n    // 如果有工具调用，添加到结果中\n    if (responseMessage.tool_calls && responseMessage.tool_calls.length > 0) {\n      result.tool_calls = responseMessage.tool_calls.map(toolCall => ({\n        id: toolCall.id,\n        tool_name: toolCall.function.name,\n        arguments: JSON.parse(toolCall.function.arguments || '{}'),\n      }));\n    }\n\n    return result;\n  }\n\n  /**\n   * 在独立模式下运行组件\n   * @param input 输入参数，可以是提示文本或对话消息数组\n   * @returns 生成的文本或响应消息\n   */\n  async run(input: string | Message[]): Promise<string | Message> {\n    if (typeof input === 'string') {\n      return this.generateCompletion(input);\n    } else {\n      return this.chatCompletion(input);\n    }\n  }\n\n  /**\n   * 在流水线中运行组件\n   * @param $i 输入端口\n   * @param $o 输出端口\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  _transform($i: any, $o: any) {\n    // 处理文本提示输入\n    $i('prompt').receive(async (prompt: string) => {\n      try {\n        const completion = await this.generateCompletion(prompt);\n        $o('completion').send(completion);\n      } catch (error) {\n        console.error('Deepseek API 调用错误:', error);\n        $o('completion').send('API 调用错误');\n      }\n    });\n\n    // 处理对话消息输入\n    $i('messages').receive(async (messages: Message[]) => {\n      try {\n        const responseMessage = await this.chatCompletion(messages);\n        $o('message').send(responseMessage);\n      } catch (error) {\n        console.error('Deepseek API 调用错误:', error);\n        $o('message').send({\n          role: 'assistant',\n          content: 'API 调用错误',\n        });\n      }\n    });\n  }\n}\n\n// 默认导出组件\nexport default Deepseek;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@astack-tech/integrations",
+  "version": "0.1.1-beta.0",
+  "description": "Integrations for the Astack AI Framework.",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./dist/index.d.ts",
+        "require": "./dist/index.d.cts"
+      },
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./model-provider": {
+      "types": {
+        "import": "./dist/model-provider/index.d.ts",
+        "require": "./dist/model-provider/index.d.cts"
+      },
+      "import": "./dist/model-provider/index.js",
+      "require": "./dist/model-provider/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "ai-framework",
+    "ai-agent",
+    "ai"
+  ],
+  "author": "xiaoa",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.11.5",
+    "eslint": "^8.56.0",
+    "rimraf": "^5.0.5",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.3",
+    "vitest": "^1.2.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "openai": "^4.98.0",
+    "@astack-tech/core": "0.1.1-beta.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "lint": "eslint src --ext .ts,.tsx",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rimraf dist"
+  }
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Astack 集成包
+ *
+ * 提供与各种外部服务和平台的集成组件
+ */
+
+// 导出模型提供者组件
+export * as ModelProvider from './model-provider';

package/src/model-provider/deepseek/index.ts

@@ -0,0 +1,386 @@
+import { Component } from '@astack-tech/core';
+import OpenAI from 'openai';
+
+/**
+ * Deepseek 模型提供者配置
+ */
+export interface DeepseekConfig {
+  /**
+   * API 密钥
+   */
+  apiKey: string;
+
+  /**
+   * 使用的模型名称
+   * 默认为 'deepseek-chat'
+   */
+  model?: string;
+
+  /**
+   * 自定义 API 基础 URL
+   * 默认为 Deepseek 官方 API 地址
+   */
+  baseURL?: string;
+
+  /**
+   * 温度参数，控制输出的随机性
+   */
+  temperature?: number;
+
+  /**
+   * 最大生成的 token 数
+   */
+  maxTokens?: number;
+
+  /**
+   * 采样概率
+   */
+  topP?: number;
+
+  /**
+   * 系统提示消息
+   */
+  systemPrompt?: string;
+
+  /**
+   * 工具实例数组，直接传递工具实例
+   * 每个工具应具有 name、description 和 parameters 属性
+   */
+  rawTools?: Array<{
+    name: string;
+    description: string;
+    parameters?: Record<string, unknown>;
+  }>;
+
+  /**
+   * API 格式的工具定义数组，与 rawTools 二选一
+   * 使用 OpenAI 兼容的工具定义格式
+   */
+  tools?: unknown[];
+}
+
+/**
+ * 消息角色类型
+ */
+export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+
+/**
+ * 工具调用
+ */
+export interface ToolCall {
+  /**
+   * 工具调用 ID
+   */
+  id?: string;
+
+  /**
+   * 工具名称
+   */
+  tool_name: string;
+
+  /**
+   * 工具调用参数
+   */
+  arguments: Record<string, unknown>;
+}
+
+/**
+ * 对话消息类型
+ */
+export interface Message {
+  /**
+   * 消息角色
+   */
+  role: MessageRole;
+
+  /**
+   * 消息内容
+   */
+  content?: string;
+
+  /**
+   * 工具调用
+   */
+  tool_calls?: ToolCall[];
+
+  /**
+   * 工具调用 ID，用于工具响应消息
+   */
+  tool_call_id?: string;
+}
+
+/**
+ * Deepseek 组件
+ *
+ * 使用 OpenAI 兼容接口调用 Deepseek 模型
+ *
+ * 输入:
+ *   - prompt: 文本提示
+ *   - messages: 对话消息数组
+ *
+ * 输出:
+ *   - completion: 生成的文本完成
+ *   - message: 生成的响应消息
+ */
+class Deepseek extends Component {
+  // OpenAI 客户端实例
+  private client: OpenAI;
+
+  // 配置选项
+  private model: string;
+  private temperature: number;
+  private maxTokens?: number;
+  private topP?: number;
+  private systemPrompt?: string;
+  private tools?: unknown[];
+
+  constructor(config: DeepseekConfig) {
+    super({});
+
+    // 配置客户端
+    this.client = new OpenAI({
+      apiKey: config.apiKey,
+      baseURL: config.baseURL || 'https://api.deepseek.com/v1',
+    });
+
+    // 保存基本配置
+    this.model = config.model || 'deepseek-chat';
+    this.temperature = config.temperature ?? 0.7;
+    this.maxTokens = config.maxTokens;
+    this.topP = config.topP;
+    this.systemPrompt = config.systemPrompt;
+
+    // 处理工具配置，优先使用 rawTools
+    if (config.rawTools && config.rawTools.length > 0) {
+      // 将工具实例转换为 API 格式
+      this.tools = config.rawTools.map(tool => ({
+        type: 'function',
+        function: {
+          name: tool.name,
+          description: tool.description,
+          parameters: tool.parameters || {},
+        },
+      }));
+    } else {
+      // 使用直接提供的 API 格式工具
+      this.tools = config.tools;
+    }
+
+    // 重命名端口
+    Component.Port.I('prompt').attach(this);
+    Component.Port.I('messages').attach(this);
+    Component.Port.O('completion').attach(this);
+    Component.Port.O('message').attach(this);
+  }
+
+  /**
+   * 生成文本完成
+   * @param prompt 提示文本
+   * @returns 生成的文本
+   */
+  async generateCompletion(prompt: string): Promise<string> {
+    const messages: Array<OpenAI.Chat.ChatCompletionMessageParam> = [];
+
+    // 添加系统提示
+    if (this.systemPrompt) {
+      messages.push({
+        role: 'system',
+        content: this.systemPrompt,
+      });
+    }
+
+    // 添加用户提示
+    messages.push({
+      role: 'user',
+      content: prompt,
+    });
+
+    // 创建请求参数
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const requestParams: any = {
+      model: this.model,
+      messages,
+      temperature: this.temperature,
+      max_tokens: this.maxTokens,
+      top_p: this.topP,
+    };
+
+    // 如果有工具定义，添加到请求中
+    if (this.tools && this.tools.length > 0) {
+      requestParams.tools = this.tools;
+    }
+
+    // 调用 API
+    const response = await this.client.chat.completions.create(requestParams);
+
+    // 处理工具调用结果
+    if (
+      response.choices[0].message.tool_calls &&
+      response.choices[0].message.tool_calls.length > 0
+    ) {
+      return JSON.stringify(response.choices[0].message);
+    }
+
+    return response.choices[0].message.content || '';
+  }
+
+  /**
+   * 处理对话消息
+   * @param messages 对话消息数组
+   * @param options 可选的调用选项，包含临时工具列表
+   * @returns 生成的响应消息
+   */
+  async chatCompletion(
+    messages: Message[],
+    options?: { temporaryTools?: unknown[] }
+  ): Promise<Message> {
+    // 转换消息格式
+    const formattedMessages: Array<OpenAI.Chat.ChatCompletionMessageParam> = [];
+
+    // 添加系统提示
+    if (this.systemPrompt) {
+      formattedMessages.push({
+        role: 'system',
+        content: this.systemPrompt,
+      });
+    }
+
+    // 添加用户提供的消息
+    formattedMessages.push(
+      ...messages.map(msg => {
+        // 基本消息结构
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const formattedMsg: any = {
+          role: msg.role,
+          content: msg.content,
+        };
+
+        // 如果有工具调用 ID，添加到消息中
+        if (msg.role === 'tool' && msg.tool_call_id) {
+          formattedMsg.tool_call_id = msg.tool_call_id;
+        }
+
+        return formattedMsg;
+      })
+    );
+
+    // 创建请求参数
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const requestParams: any = {
+      model: this.model,
+      messages: formattedMessages,
+      temperature: this.temperature,
+      max_tokens: this.maxTokens,
+      top_p: this.topP,
+    };
+
+    // 决定使用哪些工具
+    // 如果提供了临时工具，优先使用临时工具
+    const toolsToUse = options?.temporaryTools || this.tools;
+
+    // 如果有工具定义，添加到请求中
+    if (toolsToUse && toolsToUse.length > 0) {
+      // 检查工具格式并转换，确保符合 Deepseek API 要求
+      const formattedTools = toolsToUse.map(tool => {
+        // 使用类型断言来处理 unknown 类型
+        type ToolType = {
+          type?: string;
+          name?: string;
+          description?: string;
+          parameters?: Record<string, unknown>;
+        };
+
+        const typedTool = tool as ToolType;
+
+        // 如果工具已经是 API 格式，直接返回
+        if (typedTool.type === 'function') {
+          return tool;
+        }
+
+        // 如果是简单工具实例，转换为 API 格式
+        return {
+          type: 'function',
+          function: {
+            name: typedTool.name,
+            description: typedTool.description,
+            parameters: typedTool.parameters || {},
+          },
+        };
+      });
+
+      requestParams.tools = formattedTools;
+    }
+
+    // 调用 API
+    const response = await this.client.chat.completions.create(requestParams);
+
+    // 解析响应
+    const responseMessage = response.choices[0].message;
+
+    // 转换为内部消息格式
+    const result: Message = {
+      role: 'assistant',
+      content: responseMessage.content || '',
+    };
+
+    // 如果有工具调用，添加到结果中
+    if (responseMessage.tool_calls && responseMessage.tool_calls.length > 0) {
+      result.tool_calls = responseMessage.tool_calls.map(toolCall => ({
+        id: toolCall.id,
+        tool_name: toolCall.function.name,
+        arguments: JSON.parse(toolCall.function.arguments || '{}'),
+      }));
+    }
+
+    return result;
+  }
+
+  /**
+   * 在独立模式下运行组件
+   * @param input 输入参数，可以是提示文本或对话消息数组
+   * @returns 生成的文本或响应消息
+   */
+  async run(input: string | Message[]): Promise<string | Message> {
+    if (typeof input === 'string') {
+      return this.generateCompletion(input);
+    } else {
+      return this.chatCompletion(input);
+    }
+  }
+
+  /**
+   * 在流水线中运行组件
+   * @param $i 输入端口
+   * @param $o 输出端口
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _transform($i: any, $o: any) {
+    // 处理文本提示输入
+    $i('prompt').receive(async (prompt: string) => {
+      try {
+        const completion = await this.generateCompletion(prompt);
+        $o('completion').send(completion);
+      } catch (error) {
+        console.error('Deepseek API 调用错误:', error);
+        $o('completion').send('API 调用错误');
+      }
+    });
+
+    // 处理对话消息输入
+    $i('messages').receive(async (messages: Message[]) => {
+      try {
+        const responseMessage = await this.chatCompletion(messages);
+        $o('message').send(responseMessage);
+      } catch (error) {
+        console.error('Deepseek API 调用错误:', error);
+        $o('message').send({
+          role: 'assistant',
+          content: 'API 调用错误',
+        });
+      }
+    });
+  }
+}
+
+// 默认导出组件
+export default Deepseek;

package/src/model-provider/index.ts

@@ -0,0 +1,7 @@
+export {
+  default as Deepseek,
+  type Message as DeepseekMessage,
+  type ToolCall as DeepseekToolCall,
+  type DeepseekConfig,
+  type MessageRole as DeepseekMessageRole,
+} from './deepseek';