@plolink/sdk 0.0.10 → 0.0.11

package/README.md

@@ -65,6 +65,40 @@ const client = new PlolinkClient({
 
 SDK 提供多个业务模块，支持按需导入。
 
+### LLM 通用接口模块 (LLM)
+
+LLM 模块提供通用的大语言模型调用能力，兼容 OpenAI API 格式：
+
+- **聊天完成** (`chat`): 调用 LLM 模型进行对话，支持多轮对话
+- **模型列表** (`getModels`): 获取所有可用模型及价格信息
+
+```typescript
+import { PlolinkClient } from '@plolink/sdk';
+import { LLM } from '@plolink/sdk/llm';
+
+const client = new PlolinkClient({ token: 'sk-your-api-key' });
+const llm = new LLM(client);
+
+// 获取可用模型
+const models = await llm.getModels();
+console.log('可用模型：', models.map(m => m.name));
+
+// 调用聊天完成
+const response = await llm.chat({
+  model: 'deepseek-v3-1-terminus',
+  messages: [
+    { role: 'system', content: '你是一个专业的编程助手' },
+    { role: 'user', content: '如何用 TypeScript 实现单例模式？' }
+  ],
+  temperature: 0.7
+});
+
+console.log('回复：', response.choices[0].message.content);
+console.log('消耗 tokens：', response.usage.total_tokens);
+```
+
+详细文档请参考 [docs/modules/llm.md](./docs/modules/llm.md)
+
 ### 心理评测模块 (PsychologyTest)
 
 心理评测模块提供完整的心理评测能力，包括：
@@ -163,6 +197,54 @@ if (detail.status === 'COMPLETED') {
 
 详细文档请参考 [docs/modules/report-writer.md](./docs/modules/report-writer.md)
 
+### 预设Agent任务模块 (PresetAgentTask)
+
+预设Agent任务模块提供开箱即用的业务能力，完全隐藏底层Agent Task实现细节：
+
+- **预设管理** (`create`, `list`, `getById`, `update`, `delete`): 创建和管理预设配置
+- **预设执行** (`execute`): 通过code快速执行预设任务
+- **执行管理** (`listExecutions`, `getExecutionById`, `cancelExecution`, `retryExecution`): 查询和管理执行记录
+- **配置迁移** (`export`, `import`): 导出/导入预设配置，支持跨团队迁移
+
+```typescript
+import { PlolinkClient } from '@plolink/sdk';
+import { PresetAgentTask } from '@plolink/sdk/preset-agent-task';
+
+const client = new PlolinkClient({ token: 'your-token' });
+const presetAgentTask = new PresetAgentTask(client);
+
+// 执行预设任务
+const result = await presetAgentTask.execute({
+  code: 'talent-resume-parse',
+  additionalPrompt: '请特别关注技能匹配度',
+  inputFileId: 'file-resume-123'
+});
+
+console.log('执行ID:', result.executionId);
+
+// 轮询查询结果
+let execution;
+do {
+  await new Promise(resolve => setTimeout(resolve, 5000));
+  execution = await presetAgentTask.getExecutionById(result.executionId);
+  console.log('状态:', execution.status);
+} while (execution.status === 'INITIALIZING' || execution.status === 'RUNNING');
+
+// 获取结果
+if (execution.status === 'COMPLETED') {
+  console.log('输出文件:', execution.outputFileId);
+  console.log('费用:', execution.metrics.totalCost, 'USD');
+}
+
+// 或者通过Webhook接收结果通知
+// 在系统中配置Webhook订阅 "preset-agent-task" 模块
+```
+
+**注意事项：**
+- ✅ 完全隐藏Agent Task细节，不暴露 `agentTaskId`、`runId`
+- ✅ 支持轮询和Webhook两种方式获取执行结果
+- ✅ 支持配置导出/导入，方便跨团队迁移
+
 ### 其他模块
 
 其他业务模块的详细文档请参考 docs/modules/ 目录

package/dist/modules/llm/index.cjs

@@ -0,0 +1,105 @@
+'use strict';
+
+var chunkY3UJVC2L_cjs = require('../../chunk-Y3UJVC2L.cjs');
+
+// src/modules/llm/index.ts
+var LLM = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 聊天完成
+   * 
+   * @description
+   * 调用 LLM 模型进行聊天对话。支持多轮对话，自动处理计费扣费。
+   * 
+   * @param params - 聊天完成参数
+   * @returns 聊天完成响应，包含生成的内容和 token 使用信息
+   * @throws {PlolinkError} 当参数无效、余额不足或调用失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const response = await llm.chat({
+   *   model: 'deepseek-v3-1-terminus',
+   *   messages: [
+   *     { role: 'system', content: '你是一个专业的编程助手' },
+   *     { role: 'user', content: '如何用 TypeScript 实现单例模式？' }
+   *   ],
+   *   temperature: 0.7
+   * });
+   * 
+   * console.log('回复：', response.choices[0].message.content);
+   * console.log('输入 tokens：', response.usage.prompt_tokens);
+   * console.log('输出 tokens：', response.usage.completion_tokens);
+   * ```
+   */
+  async chat(params) {
+    if (!params.model) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("Model is required", "INVALID_PARAMS");
+    }
+    if (!params.messages || params.messages.length === 0) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("Messages array cannot be empty", "INVALID_PARAMS");
+    }
+    for (const message of params.messages) {
+      if (!message.role || !["system", "user", "assistant"].includes(message.role)) {
+        throw new chunkY3UJVC2L_cjs.PlolinkError(
+          `Invalid message role: ${message.role}. Must be one of: system, user, assistant`,
+          "INVALID_PARAMS"
+        );
+      }
+      if (!message.content) {
+        throw new chunkY3UJVC2L_cjs.PlolinkError("Message content cannot be empty", "INVALID_PARAMS");
+      }
+    }
+    if (params.temperature !== void 0) {
+      if (params.temperature < 0 || params.temperature > 2) {
+        throw new chunkY3UJVC2L_cjs.PlolinkError("Temperature must be between 0 and 2", "INVALID_PARAMS");
+      }
+    }
+    if (params.max_tokens !== void 0 && params.max_tokens <= 0) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("max_tokens must be a positive number", "INVALID_PARAMS");
+    }
+    if (params.top_p !== void 0) {
+      if (params.top_p < 0 || params.top_p > 1) {
+        throw new chunkY3UJVC2L_cjs.PlolinkError("top_p must be between 0 and 1", "INVALID_PARAMS");
+      }
+    }
+    this.client.logger.info("Calling LLM chat completion", {
+      model: params.model,
+      messageCount: params.messages.length
+    });
+    return this.client.axiosInstance.post("/api/v1/llm/chat/completions", params);
+  }
+  /**
+   * 获取所有可用模型列表
+   * 
+   * @description
+   * 获取所有可用的 LLM 模型及其详细信息，包括供应商和价格信息。
+   * 
+   * @returns 模型信息列表
+   * @throws {PlolinkError} 当请求失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const models = await llm.getModels();
+   * 
+   * console.log(`共有 ${models.length} 个可用模型`);
+   * 
+   * models.forEach(model => {
+   *   console.log(`模型：${model.name}`);
+   *   console.log(`  ID: ${model.id}`);
+   *   console.log(`  供应商: ${model.provider}`);
+   *   console.log(`  输入价格: ${model.inputPrice} 元/1000 tokens`);
+   *   console.log(`  输出价格: ${model.outputPrice} 元/1000 tokens`);
+   * });
+   * ```
+   */
+  async getModels() {
+    this.client.logger.info("Fetching available models");
+    return this.client.axiosInstance.get("/api/v1/llm/models");
+  }
+};
+
+exports.LLM = LLM;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/modules/llm/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/llm/index.ts"],"names":["PlolinkError"],"mappings":";;;;;AAgEO,IAAM,MAAN,MAAU;AAAA,EAGf,YAAY,MAAA,EAAuB;AACjC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA4BA,MAAa,KAAK,MAAA,EAA+D;AAE/E,IAAA,IAAI,CAAC,OAAO,KAAA,EAAO;AACjB,MAAA,MAAM,IAAIA,8BAAA,CAAa,mBAAA,EAAqB,gBAAgB,CAAA;AAAA,IAC9D;AAEA,IAAA,IAAI,CAAC,MAAA,CAAO,QAAA,IAAY,MAAA,CAAO,QAAA,CAAS,WAAW,CAAA,EAAG;AACpD,MAAA,MAAM,IAAIA,8BAAA,CAAa,gCAAA,EAAkC,gBAAgB,CAAA;AAAA,IAC3E;AAGA,IAAA,KAAA,MAAW,OAAA,IAAW,OAAO,QAAA,EAAU;AACrC,MAAA,IAAI,CAAC,OAAA,CAAQ,IAAA,IAAQ,CAAC,CAAC,QAAA,EAAU,MAAA,EAAQ,WAAW,CAAA,CAAE,QAAA,CAAS,OAAA,CAAQ,IAAI,CAAA,EAAG;AAC5E,QAAA,MAAM,IAAIA,8BAAA;AAAA,UACR,CAAA,sBAAA,EAAyB,QAAQ,IAAI,CAAA,yCAAA,CAAA;AAAA,UACrC;AAAA,SACF;AAAA,MACF;AACA,MAAA,IAAI,CAAC,QAAQ,OAAA,EAAS;AACpB,QAAA,MAAM,IAAIA,8BAAA,CAAa,iCAAA,EAAmC,gBAAgB,CAAA;AAAA,MAC5E;AAAA,IACF;AAGA,IAAA,IAAI,MAAA,CAAO,gBAAgB,MAAA,EAAW;AACpC,MAAA,IAAI,MAAA,CAAO,WAAA,GAAc,CAAA,IAAK,MAAA,CAAO,cAAc,CAAA,EAAG;AACpD,QAAA,MAAM,IAAIA,8BAAA,CAAa,qCAAA,EAAuC,gBAAgB,CAAA;AAAA,MAChF;AAAA,IACF;AAEA,IAAA,IAAI,MAAA,CAAO,UAAA,KAAe,MAAA,IAAa,MAAA,CAAO,cAAc,CAAA,EAAG;AAC7D,MAAA,MAAM,IAAIA,8BAAA,CAAa,sCAAA,EAAwC,gBAAgB,CAAA;AAAA,IACjF;AAEA,IAAA,IAAI,MAAA,CAAO,UAAU,MAAA,EAAW;AAC9B,MAAA,IAAI,MAAA,CAAO,KAAA,GAAQ,CAAA,IAAK,MAAA,CAAO,QAAQ,CAAA,EAAG;AACxC,QAAA,MAAM,IAAIA,8BAAA,CAAa,+BAAA,EAAiC,gBAAgB,CAAA;AAAA,MAC1E;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,IAAA,CAAK,6BAAA,EAA+B;AAAA,MACrD,OAAO,MAAA,CAAO,KAAA;AAAA,MACd,YAAA,EAAc,OAAO,QAAA,CAAS;AAAA,KAC/B,CAAA;AAED,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,aAAA,CAAc,IAAA,CAAK,gCAAgC,MAAM,CAAA;AAAA,EAC9E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA0BA,MAAa,SAAA,GAAkC;AAC7C,IAAA,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,IAAA,CAAK,2BAA2B,CAAA;AAEnD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,aAAA,CAAc,GAAA,CAAI,oBAAoB,CAAA;AAAA,EAC3D;AACF","file":"index.cjs","sourcesContent":["/**\n * LLM 模块\n * \n * @description\n * 提供通用的 LLM 调用能力，兼容 OpenAI API 格式。\n * 支持：\n * - 聊天完成（chat completions）\n * - 模型列表查询\n * - 自动计费扣费\n * \n * @example\n * ```typescript\n * import { PlolinkClient } from '@plolink/sdk';\n * import { LLM } from '@plolink/sdk/llm';\n * \n * const client = new PlolinkClient({\n *   token: 'sk-your-api-key'\n * });\n * \n * const llm = new LLM(client);\n * \n * // 获取模型列表\n * const models = await llm.getModels();\n * console.log('可用模型：', models.map(m => m.id));\n * \n * // 调用聊天完成\n * const response = await llm.chat({\n *   model: 'deepseek-v3-1-terminus',\n *   messages: [\n *     { role: 'system', content: '你是一个有帮助的助手' },\n *     { role: 'user', content: '你好，请介绍一下自己' }\n *   ],\n *   temperature: 0.7\n * });\n * \n * console.log('回复：', response.choices[0].message.content);\n * console.log('消耗 tokens：', response.usage);\n * ```\n * \n * @module llm\n */\n\nimport { PlolinkClient } from '../../core/client';\nimport { PlolinkError } from '../../core/error';\nimport type {\n  ChatCompletionParams,\n  ChatCompletionResponse,\n  ModelInfo,\n} from '../../types/llm';\n\n// Re-export 类型\nexport type {\n  MessageRole,\n  ChatMessage,\n  ChatCompletionParams,\n  ChatCompletionChoice,\n  TokenUsage,\n  ChatCompletionResponse,\n  ModelInfo,\n} from '../../types/llm';\n\n/**\n * LLM 模块类\n */\nexport class LLM {\n  private client: PlolinkClient;\n\n  constructor(client: PlolinkClient) {\n    this.client = client;\n  }\n\n  /**\n   * 聊天完成\n   * \n   * @description\n   * 调用 LLM 模型进行聊天对话。支持多轮对话，自动处理计费扣费。\n   * \n   * @param params - 聊天完成参数\n   * @returns 聊天完成响应，包含生成的内容和 token 使用信息\n   * @throws {PlolinkError} 当参数无效、余额不足或调用失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const response = await llm.chat({\n   *   model: 'deepseek-v3-1-terminus',\n   *   messages: [\n   *     { role: 'system', content: '你是一个专业的编程助手' },\n   *     { role: 'user', content: '如何用 TypeScript 实现单例模式？' }\n   *   ],\n   *   temperature: 0.7\n   * });\n   * \n   * console.log('回复：', response.choices[0].message.content);\n   * console.log('输入 tokens：', response.usage.prompt_tokens);\n   * console.log('输出 tokens：', response.usage.completion_tokens);\n   * ```\n   */\n  public async chat(params: ChatCompletionParams): Promise<ChatCompletionResponse> {\n    // 参数验证\n    if (!params.model) {\n      throw new PlolinkError('Model is required', 'INVALID_PARAMS');\n    }\n\n    if (!params.messages || params.messages.length === 0) {\n      throw new PlolinkError('Messages array cannot be empty', 'INVALID_PARAMS');\n    }\n\n    // 验证每条消息\n    for (const message of params.messages) {\n      if (!message.role || !['system', 'user', 'assistant'].includes(message.role)) {\n        throw new PlolinkError(\n          `Invalid message role: ${message.role}. Must be one of: system, user, assistant`,\n          'INVALID_PARAMS'\n        );\n      }\n      if (!message.content) {\n        throw new PlolinkError('Message content cannot be empty', 'INVALID_PARAMS');\n      }\n    }\n\n    // 验证可选参数\n    if (params.temperature !== undefined) {\n      if (params.temperature < 0 || params.temperature > 2) {\n        throw new PlolinkError('Temperature must be between 0 and 2', 'INVALID_PARAMS');\n      }\n    }\n\n    if (params.max_tokens !== undefined && params.max_tokens <= 0) {\n      throw new PlolinkError('max_tokens must be a positive number', 'INVALID_PARAMS');\n    }\n\n    if (params.top_p !== undefined) {\n      if (params.top_p < 0 || params.top_p > 1) {\n        throw new PlolinkError('top_p must be between 0 and 1', 'INVALID_PARAMS');\n      }\n    }\n\n    this.client.logger.info('Calling LLM chat completion', {\n      model: params.model,\n      messageCount: params.messages.length,\n    });\n\n    return this.client.axiosInstance.post('/api/v1/llm/chat/completions', params);\n  }\n\n  /**\n   * 获取所有可用模型列表\n   * \n   * @description\n   * 获取所有可用的 LLM 模型及其详细信息，包括供应商和价格信息。\n   * \n   * @returns 模型信息列表\n   * @throws {PlolinkError} 当请求失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const models = await llm.getModels();\n   * \n   * console.log(`共有 ${models.length} 个可用模型`);\n   * \n   * models.forEach(model => {\n   *   console.log(`模型：${model.name}`);\n   *   console.log(`  ID: ${model.id}`);\n   *   console.log(`  供应商: ${model.provider}`);\n   *   console.log(`  输入价格: ${model.inputPrice} 元/1000 tokens`);\n   *   console.log(`  输出价格: ${model.outputPrice} 元/1000 tokens`);\n   * });\n   * ```\n   */\n  public async getModels(): Promise<ModelInfo[]> {\n    this.client.logger.info('Fetching available models');\n\n    return this.client.axiosInstance.get('/api/v1/llm/models');\n  }\n}\n"]}

package/dist/modules/llm/index.d.cts

@@ -0,0 +1,179 @@
+import { P as PlolinkClient } from '../../client-CAjIQKPm.cjs';
+import '../../core-77EbLgbp.cjs';
+import 'axios';
+
+/**
+ * LLM 模块类型定义
+ */
+/**
+ * 消息角色
+ */
+type MessageRole = 'system' | 'user' | 'assistant';
+/**
+ * 聊天消息
+ */
+interface ChatMessage {
+    role: MessageRole;
+    content: string;
+}
+/**
+ * 聊天完成请求参数
+ */
+interface ChatCompletionParams {
+    /** 模型名称 */
+    model: string;
+    /** 消息列表 */
+    messages: ChatMessage[];
+    /** 温度参数，范围 0-2，默认 0.7 */
+    temperature?: number;
+    /** 最大 token 数 */
+    max_tokens?: number;
+    /** 采样参数，范围 0-1 */
+    top_p?: number;
+}
+/**
+ * 聊天完成响应中的选择项
+ */
+interface ChatCompletionChoice {
+    index: number;
+    message: ChatMessage;
+    finish_reason: string;
+}
+/**
+ * Token 使用情况
+ */
+interface TokenUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+/**
+ * 聊天完成响应
+ */
+interface ChatCompletionResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: ChatCompletionChoice[];
+    usage: TokenUsage;
+}
+/**
+ * 模型信息
+ */
+interface ModelInfo {
+    /** 模型 ID */
+    id: string;
+    /** 模型显示名称 */
+    name: string;
+    /** 供应商 */
+    provider: string;
+    /** 输入价格（元/1000 tokens） */
+    inputPrice: string;
+    /** 输出价格（元/1000 tokens） */
+    outputPrice: string;
+}
+
+/**
+ * LLM 模块
+ *
+ * @description
+ * 提供通用的 LLM 调用能力，兼容 OpenAI API 格式。
+ * 支持：
+ * - 聊天完成（chat completions）
+ * - 模型列表查询
+ * - 自动计费扣费
+ *
+ * @example
+ * ```typescript
+ * import { PlolinkClient } from '@plolink/sdk';
+ * import { LLM } from '@plolink/sdk/llm';
+ *
+ * const client = new PlolinkClient({
+ *   token: 'sk-your-api-key'
+ * });
+ *
+ * const llm = new LLM(client);
+ *
+ * // 获取模型列表
+ * const models = await llm.getModels();
+ * console.log('可用模型：', models.map(m => m.id));
+ *
+ * // 调用聊天完成
+ * const response = await llm.chat({
+ *   model: 'deepseek-v3-1-terminus',
+ *   messages: [
+ *     { role: 'system', content: '你是一个有帮助的助手' },
+ *     { role: 'user', content: '你好，请介绍一下自己' }
+ *   ],
+ *   temperature: 0.7
+ * });
+ *
+ * console.log('回复：', response.choices[0].message.content);
+ * console.log('消耗 tokens：', response.usage);
+ * ```
+ *
+ * @module llm
+ */
+
+/**
+ * LLM 模块类
+ */
+declare class LLM {
+    private client;
+    constructor(client: PlolinkClient);
+    /**
+     * 聊天完成
+     *
+     * @description
+     * 调用 LLM 模型进行聊天对话。支持多轮对话，自动处理计费扣费。
+     *
+     * @param params - 聊天完成参数
+     * @returns 聊天完成响应，包含生成的内容和 token 使用信息
+     * @throws {PlolinkError} 当参数无效、余额不足或调用失败时抛出
+     *
+     * @example
+     * ```typescript
+     * const response = await llm.chat({
+     *   model: 'deepseek-v3-1-terminus',
+     *   messages: [
+     *     { role: 'system', content: '你是一个专业的编程助手' },
+     *     { role: 'user', content: '如何用 TypeScript 实现单例模式？' }
+     *   ],
+     *   temperature: 0.7
+     * });
+     *
+     * console.log('回复：', response.choices[0].message.content);
+     * console.log('输入 tokens：', response.usage.prompt_tokens);
+     * console.log('输出 tokens：', response.usage.completion_tokens);
+     * ```
+     */
+    chat(params: ChatCompletionParams): Promise<ChatCompletionResponse>;
+    /**
+     * 获取所有可用模型列表
+     *
+     * @description
+     * 获取所有可用的 LLM 模型及其详细信息，包括供应商和价格信息。
+     *
+     * @returns 模型信息列表
+     * @throws {PlolinkError} 当请求失败时抛出
+     *
+     * @example
+     * ```typescript
+     * const models = await llm.getModels();
+     *
+     * console.log(`共有 ${models.length} 个可用模型`);
+     *
+     * models.forEach(model => {
+     *   console.log(`模型：${model.name}`);
+     *   console.log(`  ID: ${model.id}`);
+     *   console.log(`  供应商: ${model.provider}`);
+     *   console.log(`  输入价格: ${model.inputPrice} 元/1000 tokens`);
+     *   console.log(`  输出价格: ${model.outputPrice} 元/1000 tokens`);
+     * });
+     * ```
+     */
+    getModels(): Promise<ModelInfo[]>;
+}
+
+export { type ChatCompletionChoice, type ChatCompletionParams, type ChatCompletionResponse, type ChatMessage, LLM, type MessageRole, type ModelInfo, type TokenUsage };

package/dist/modules/llm/index.d.ts

@@ -0,0 +1,179 @@
+import { P as PlolinkClient } from '../../client-CwNikk7i.js';
+import '../../core-77EbLgbp.js';
+import 'axios';
+
+/**
+ * LLM 模块类型定义
+ */
+/**
+ * 消息角色
+ */
+type MessageRole = 'system' | 'user' | 'assistant';
+/**
+ * 聊天消息
+ */
+interface ChatMessage {
+    role: MessageRole;
+    content: string;
+}
+/**
+ * 聊天完成请求参数
+ */
+interface ChatCompletionParams {
+    /** 模型名称 */
+    model: string;
+    /** 消息列表 */
+    messages: ChatMessage[];
+    /** 温度参数，范围 0-2，默认 0.7 */
+    temperature?: number;
+    /** 最大 token 数 */
+    max_tokens?: number;
+    /** 采样参数，范围 0-1 */
+    top_p?: number;
+}
+/**
+ * 聊天完成响应中的选择项
+ */
+interface ChatCompletionChoice {
+    index: number;
+    message: ChatMessage;
+    finish_reason: string;
+}
+/**
+ * Token 使用情况
+ */
+interface TokenUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+/**
+ * 聊天完成响应
+ */
+interface ChatCompletionResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: ChatCompletionChoice[];
+    usage: TokenUsage;
+}
+/**
+ * 模型信息
+ */
+interface ModelInfo {
+    /** 模型 ID */
+    id: string;
+    /** 模型显示名称 */
+    name: string;
+    /** 供应商 */
+    provider: string;
+    /** 输入价格（元/1000 tokens） */
+    inputPrice: string;
+    /** 输出价格（元/1000 tokens） */
+    outputPrice: string;
+}
+
+/**
+ * LLM 模块
+ *
+ * @description
+ * 提供通用的 LLM 调用能力，兼容 OpenAI API 格式。
+ * 支持：
+ * - 聊天完成（chat completions）
+ * - 模型列表查询
+ * - 自动计费扣费
+ *
+ * @example
+ * ```typescript
+ * import { PlolinkClient } from '@plolink/sdk';
+ * import { LLM } from '@plolink/sdk/llm';
+ *
+ * const client = new PlolinkClient({
+ *   token: 'sk-your-api-key'
+ * });
+ *
+ * const llm = new LLM(client);
+ *
+ * // 获取模型列表
+ * const models = await llm.getModels();
+ * console.log('可用模型：', models.map(m => m.id));
+ *
+ * // 调用聊天完成
+ * const response = await llm.chat({
+ *   model: 'deepseek-v3-1-terminus',
+ *   messages: [
+ *     { role: 'system', content: '你是一个有帮助的助手' },
+ *     { role: 'user', content: '你好，请介绍一下自己' }
+ *   ],
+ *   temperature: 0.7
+ * });
+ *
+ * console.log('回复：', response.choices[0].message.content);
+ * console.log('消耗 tokens：', response.usage);
+ * ```
+ *
+ * @module llm
+ */
+
+/**
+ * LLM 模块类
+ */
+declare class LLM {
+    private client;
+    constructor(client: PlolinkClient);
+    /**
+     * 聊天完成
+     *
+     * @description
+     * 调用 LLM 模型进行聊天对话。支持多轮对话，自动处理计费扣费。
+     *
+     * @param params - 聊天完成参数
+     * @returns 聊天完成响应，包含生成的内容和 token 使用信息
+     * @throws {PlolinkError} 当参数无效、余额不足或调用失败时抛出
+     *
+     * @example
+     * ```typescript
+     * const response = await llm.chat({
+     *   model: 'deepseek-v3-1-terminus',
+     *   messages: [
+     *     { role: 'system', content: '你是一个专业的编程助手' },
+     *     { role: 'user', content: '如何用 TypeScript 实现单例模式？' }
+     *   ],
+     *   temperature: 0.7
+     * });
+     *
+     * console.log('回复：', response.choices[0].message.content);
+     * console.log('输入 tokens：', response.usage.prompt_tokens);
+     * console.log('输出 tokens：', response.usage.completion_tokens);
+     * ```
+     */
+    chat(params: ChatCompletionParams): Promise<ChatCompletionResponse>;
+    /**
+     * 获取所有可用模型列表
+     *
+     * @description
+     * 获取所有可用的 LLM 模型及其详细信息，包括供应商和价格信息。
+     *
+     * @returns 模型信息列表
+     * @throws {PlolinkError} 当请求失败时抛出
+     *
+     * @example
+     * ```typescript
+     * const models = await llm.getModels();
+     *
+     * console.log(`共有 ${models.length} 个可用模型`);
+     *
+     * models.forEach(model => {
+     *   console.log(`模型：${model.name}`);
+     *   console.log(`  ID: ${model.id}`);
+     *   console.log(`  供应商: ${model.provider}`);
+     *   console.log(`  输入价格: ${model.inputPrice} 元/1000 tokens`);
+     *   console.log(`  输出价格: ${model.outputPrice} 元/1000 tokens`);
+     * });
+     * ```
+     */
+    getModels(): Promise<ModelInfo[]>;
+}
+
+export { type ChatCompletionChoice, type ChatCompletionParams, type ChatCompletionResponse, type ChatMessage, LLM, type MessageRole, type ModelInfo, type TokenUsage };

package/dist/modules/llm/index.js

@@ -0,0 +1,103 @@
+import { PlolinkError } from '../../chunk-MD4O7FWT.js';
+
+// src/modules/llm/index.ts
+var LLM = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 聊天完成
+   * 
+   * @description
+   * 调用 LLM 模型进行聊天对话。支持多轮对话，自动处理计费扣费。
+   * 
+   * @param params - 聊天完成参数
+   * @returns 聊天完成响应，包含生成的内容和 token 使用信息
+   * @throws {PlolinkError} 当参数无效、余额不足或调用失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const response = await llm.chat({
+   *   model: 'deepseek-v3-1-terminus',
+   *   messages: [
+   *     { role: 'system', content: '你是一个专业的编程助手' },
+   *     { role: 'user', content: '如何用 TypeScript 实现单例模式？' }
+   *   ],
+   *   temperature: 0.7
+   * });
+   * 
+   * console.log('回复：', response.choices[0].message.content);
+   * console.log('输入 tokens：', response.usage.prompt_tokens);
+   * console.log('输出 tokens：', response.usage.completion_tokens);
+   * ```
+   */
+  async chat(params) {
+    if (!params.model) {
+      throw new PlolinkError("Model is required", "INVALID_PARAMS");
+    }
+    if (!params.messages || params.messages.length === 0) {
+      throw new PlolinkError("Messages array cannot be empty", "INVALID_PARAMS");
+    }
+    for (const message of params.messages) {
+      if (!message.role || !["system", "user", "assistant"].includes(message.role)) {
+        throw new PlolinkError(
+          `Invalid message role: ${message.role}. Must be one of: system, user, assistant`,
+          "INVALID_PARAMS"
+        );
+      }
+      if (!message.content) {
+        throw new PlolinkError("Message content cannot be empty", "INVALID_PARAMS");
+      }
+    }
+    if (params.temperature !== void 0) {
+      if (params.temperature < 0 || params.temperature > 2) {
+        throw new PlolinkError("Temperature must be between 0 and 2", "INVALID_PARAMS");
+      }
+    }
+    if (params.max_tokens !== void 0 && params.max_tokens <= 0) {
+      throw new PlolinkError("max_tokens must be a positive number", "INVALID_PARAMS");
+    }
+    if (params.top_p !== void 0) {
+      if (params.top_p < 0 || params.top_p > 1) {
+        throw new PlolinkError("top_p must be between 0 and 1", "INVALID_PARAMS");
+      }
+    }
+    this.client.logger.info("Calling LLM chat completion", {
+      model: params.model,
+      messageCount: params.messages.length
+    });
+    return this.client.axiosInstance.post("/api/v1/llm/chat/completions", params);
+  }
+  /**
+   * 获取所有可用模型列表
+   * 
+   * @description
+   * 获取所有可用的 LLM 模型及其详细信息，包括供应商和价格信息。
+   * 
+   * @returns 模型信息列表
+   * @throws {PlolinkError} 当请求失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const models = await llm.getModels();
+   * 
+   * console.log(`共有 ${models.length} 个可用模型`);
+   * 
+   * models.forEach(model => {
+   *   console.log(`模型：${model.name}`);
+   *   console.log(`  ID: ${model.id}`);
+   *   console.log(`  供应商: ${model.provider}`);
+   *   console.log(`  输入价格: ${model.inputPrice} 元/1000 tokens`);
+   *   console.log(`  输出价格: ${model.outputPrice} 元/1000 tokens`);
+   * });
+   * ```
+   */
+  async getModels() {
+    this.client.logger.info("Fetching available models");
+    return this.client.axiosInstance.get("/api/v1/llm/models");
+  }
+};
+
+export { LLM };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map