@kevisual/ai 0.0.19 → 0.0.20

package/dist/ai-provider.d.ts

@@ -5,8 +5,8 @@ type ChatMessage = {
     role?: 'user' | 'assistant' | 'system' | 'tool';
     content: string;
 };
-type ChatMessageOptions = {
-    messages: ChatMessage[];
+type ChatMessageOptions<T = {}> = {
+    messages?: ChatMessage[];
     /**
     * 模型名称
     */
@@ -46,7 +46,7 @@ type ChatMessageOptions = {
     stream?: boolean;
     /**
      * 是否能够思考
-     * 如果会话是千文，服务器的接口，默认为 true
+     * 如果会话是千文，服务器的接口，默认为 false
      */
     enable_thinking?: boolean;
     response_format?: 'text' | 'json' | 'xml' | 'html';
@@ -54,7 +54,8 @@ type ChatMessageOptions = {
      * 工具调用参数
      */
     tool_calls?: any;
-};
+    [key: string]: any;
+} & T;
 type Choice = {
     finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | 'function_call';
     index: number;
@@ -161,6 +162,7 @@ type EmbeddingMessageComplete = {
     usage: Usage;
 };
 interface BaseChatInterface {
+    chat(options: ChatMessageOptions): Promise<ChatMessageComplete>;
     chat(messages: ChatMessage[], options?: ChatMessageOptions): Promise<ChatMessageComplete>;
 }
 interface Usage {
@@ -305,8 +307,10 @@ declare class BaseChat implements BaseChatInterface, Usage {
     /**
      * 聊天
      */
+    chat(options: ChatMessageOptions): Promise<ChatMessageComplete>;
     chat(messages: ChatMessage[], options?: ChatMessageOptions): Promise<ChatMessageComplete>;
-    chatStream(messages: ChatMessage[], options?: ChatMessageOptions): Promise<ChatStream>;
+    chatStream(options: ChatMessageOptions): AsyncGenerator<ChatMessageComplete>;
+    chatStream(messages: ChatMessage[], options?: ChatMessageOptions): AsyncGenerator<ChatMessageComplete>;
     /**
      * 简单提问接口
      * @param message
@@ -323,6 +327,11 @@ declare class BaseChat implements BaseChatInterface, Usage {
         total_tokens: number;
         completion_tokens: number;
     };
+    setChatUsage(usage: {
+        prompt_tokens?: number;
+        total_tokens?: number;
+        completion_tokens?: number;
+    }): void;
     getHeaders(headers?: Record<string, string>): {
         'Content-Type': string;
         Authorization: string;
@@ -362,7 +371,6 @@ type OllamaModel = {
 declare class Ollama extends BaseChat {
     static BASE_URL: string;
     constructor(options: OllamaOptions$1);
-    chat(messages: ChatMessage[], options?: ChatMessageOptions): Promise<ChatMessageComplete>;
     /**
      * 获取模型列表
      * @returns
@@ -400,7 +408,6 @@ declare class SiliconFlow extends BaseChat {
     static BASE_URL: string;
     constructor(options: SiliconFlowOptions);
     getUsageInfo(): Promise<SiliconFlowUsageResponse>;
-    chat(messages: ChatMessage[], options?: ChatMessageOptions): Promise<ChatMessageComplete>;
 }
 
 type OllamaOptions = BaseChatOptions;

package/dist/ai-provider.js

@@ -1350,10 +1350,10 @@ class BaseChat {
   baseURL;
   model;
   apiKey;
-  prompt_tokens;
-  total_tokens;
-  completion_tokens;
-  responseText;
+  prompt_tokens = 0;
+  total_tokens = 0;
+  completion_tokens = 0;
+  responseText = "";
   utils = AIUtils;
   constructor(options) {
     this.baseURL = options.baseURL;
@@ -1385,11 +1385,14 @@ class BaseChat {
       }
     }).then((res) => res.json());
   }
-  async chat(messages, options) {
+  async chat(messagesOrOptions, options) {
+    const isFirstParamOptions = !Array.isArray(messagesOrOptions);
+    const messages = isFirstParamOptions ? messagesOrOptions.messages : messagesOrOptions;
+    const opts = isFirstParamOptions ? messagesOrOptions : options || {};
     const requestBody = {
       model: this.model,
       messages,
-      ...options,
+      ...opts,
       stream: false
     };
     const response = await this.post(`${this.baseURL}/chat/completions`, { data: requestBody });
@@ -1398,20 +1401,21 @@ class BaseChat {
       throw new Error(`Chat API request failed: ${response.status} ${response.statusText} - ${errorText}`);
     }
     const res = await response.json();
-    this.prompt_tokens = res.usage?.prompt_tokens ?? 0;
-    this.total_tokens = res.usage?.total_tokens ?? 0;
-    this.completion_tokens = res.usage?.completion_tokens ?? 0;
+    this.setChatUsage(res.usage);
     this.responseText = res.choices[0]?.message?.content || "";
     return res;
   }
-  async chatStream(messages, options) {
-    if (options?.response_format) {
+  async* chatStream(messagesOrOptions, options) {
+    const isFirstParamOptions = !Array.isArray(messagesOrOptions);
+    const messages = isFirstParamOptions ? messagesOrOptions.messages : messagesOrOptions;
+    const opts = isFirstParamOptions ? messagesOrOptions : options || {};
+    if (opts.response_format) {
       throw new Error("response_format is not supported in stream mode");
     }
     const requestBody = {
       model: this.model,
       messages,
-      ...options,
+      ...opts,
       stream: true
     };
     const response = await this.post(`${this.baseURL}/chat/completions`, { data: requestBody });
@@ -1465,6 +1469,11 @@ class BaseChat {
       completion_tokens: this.completion_tokens
     };
   }
+  setChatUsage(usage) {
+    this.prompt_tokens = usage.prompt_tokens ?? this.prompt_tokens;
+    this.total_tokens = usage.total_tokens ?? this.total_tokens;
+    this.completion_tokens = usage.completion_tokens ?? this.completion_tokens;
+  }
   getHeaders(headers) {
     return {
       "Content-Type": "application/json",
@@ -1505,11 +1514,6 @@ class Ollama extends BaseChat {
     const baseURL = options.baseURL || Ollama.BASE_URL;
     super({ ...options, baseURL });
   }
-  async chat(messages, options) {
-    const res = await super.chat(messages, options);
-    console.log("thunk", this.getChatUsage());
-    return res;
-  }
   async listModels() {
     const _url = new URL(this.baseURL);
     const tagsURL = new URL("/api/tags", _url);
@@ -1532,10 +1536,6 @@ class SiliconFlow extends BaseChat {
   async getUsageInfo() {
     return this.get("/user/info");
   }
-  async chat(messages, options) {
-    const res = await super.chat(messages, options);
-    return res;
-  }
 }
 
 // src/provider/chat-adapter/custom.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kevisual/ai",
-  "version": "0.0.19",
+  "version": "0.0.20",
   "description": "AI Center Services",
   "main": "index.js",
   "basename": "/root/ai-center-services",
@@ -13,6 +13,13 @@
     "src",
     "types"
   ],
+  "scripts": {
+    "build": "npm run clean && bun bun.config.mjs",
+    "dev": "bun run --watch bun.config.mjs",
+    "test": "tsx  test/**/*.ts",
+    "clean": "rm -rf dist",
+    "pub": "envision pack -p -u"
+  },
   "keywords": [
     "kevisual",
     "ai",
@@ -20,6 +27,7 @@
   ],
   "author": "abearxiong <xiongxiao@xiongxiao.me> (https://www.xiongxiao.me)",
   "license": "MIT",
+  "packageManager": "pnpm@10.28.0",
   "type": "module",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -45,34 +53,27 @@
     }
   },
   "devDependencies": {
-    "@kevisual/router": "0.0.36",
+    "@kevisual/router": "0.0.52",
     "@kevisual/types": "^0.0.10",
     "@kevisual/use-config": "^1.0.21",
-    "@types/bun": "^1.3.4",
+    "@types/bun": "^1.3.5",
     "@types/crypto-js": "^4.2.2",
     "@types/formidable": "^3.4.6",
-    "@types/node": "^24.10.1",
+    "@types/node": "^25.0.5",
     "cross-env": "^10.1.0",
     "crypto-js": "^4.2.0",
     "dayjs": "^1.11.19",
     "dotenv": "^17.2.3",
     "formidable": "^3.5.4",
-    "openai": "6.10.0",
+    "openai": "6.16.0",
     "pm2": "^6.0.14",
     "rimraf": "^6.1.2",
     "typescript": "^5.9.3",
-    "vite": "^7.2.6"
+    "vite": "^7.3.1"
   },
   "dependencies": {
     "@kevisual/logger": "^0.0.4",
     "@kevisual/permission": "^0.0.3",
-    "@kevisual/query": "^0.0.31"
-  },
-  "scripts": {
-    "build": "npm run clean && bun bun.config.mjs",
-    "dev": "bun run --watch bun.config.mjs",
-    "test": "tsx  test/**/*.ts",
-    "clean": "rm -rf dist",
-    "pub": "envision pack -p -u"
+    "@kevisual/query": "^0.0.35"
   }
 }

package/src/jimeng/core.ts

@@ -1,51 +1,121 @@
-import { adapter } from '@kevisual/query/query'
-export type CoreOpts = {
-  baseURL?: string;
-  token?: string;
+import { Result } from '@kevisual/query'
+export interface JimengOptions {
+  /** API密钥，用于认证请求 */
+  apiKey: string;
+  /** API基础URL */
+  baseUrl: string;
+  /** 请求超时时间（毫秒） */
+  timeout: number;
 }
-export class Core {
-  baseURL: string = 'https://jimeng-api.kevisual.cn/v1';
-  token?: string;
-  constructor(opts: CoreOpts = {}) {
-    console.log("Core initialized");
-    if (opts.baseURL) {
-      this.baseURL = opts.baseURL;
-    }
-    if (opts.token) {
-      this.token = opts.token;
-    }
+
+export interface JimengGenerateOptions {
+  /** 图片生成提示词 */
+  prompt: string;
+  /** 使用的模型版本，默认 jimeng-4.0 */
+  model?: string;
+  /** 图片比例，默认 1:1 */
+  ratio?: string;
+  /** 图片分辨率，默认 2k */
+  resolution?: string;
+}
+
+interface JimengResponse {
+  /** 请求创建时间戳 */
+  created: number;
+  /** 生成的图片列表 */
+  data: Array<{
+    /** 图片URL */
+    url: string;
+  }>;
+}
+
+export class JimengService {
+  private apiKey: string;
+  private baseUrl: string;
+  private timeout: number;
+
+  constructor(options: JimengOptions) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl || 'https://jimeng-api.kevisual.cn/v1';
+    this.timeout = options.timeout;
   }
-  makeHeader() {
-    return {
-      Authorization: this.token ? `Bearer ${this.token}` : undefined,
-      'Content-Type': 'application/json'
+
+  async generateImage(options: JimengGenerateOptions): Promise<Result<JimengResponse>> {
+    const {
+      prompt,
+      model = 'jimeng-4.6',
+      ratio = '1:1',
+      resolution = '2k'
+    } = options;
+
+    try {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+
+      const response = await fetch(`${this.baseUrl}/images/generations`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'Authorization': `Bearer ${this.apiKey}`,
+        },
+        body: JSON.stringify({
+          model,
+          prompt,
+          ratio,
+          resolution,
+        }),
+        signal: controller.signal,
+      });
+
+      clearTimeout(timeoutId);
+
+      if (!response.ok) {
+        throw new Error(`jimeng API error: ${response.status} ${response.statusText}`);
+      }
+
+      const result = await response.json() as JimengResponse;
+      return { code: 200, data: result };
+    } catch (error: any) {
+      return { code: 500, message: error.message || 'Unknown error' };
     }
   }
-  generateImage({ model = 'jimeng-4.0', prompt, resolution = '2k' }: ImageOptions) {
-    const url = `${this.baseURL}/images/generations`;
-    return adapter({
-      url,
-      headers: this.makeHeader(),
-      body: {
-        model,
-        prompt,
-        resolution
+
+  async downloadImage(url: string): Promise<Uint8Array> {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+
+    try {
+      const response = await fetch(url, {
+        signal: controller.signal,
+      });
+
+      clearTimeout(timeoutId);
+
+      if (!response.ok) {
+        throw new Error(`Failed to download image: ${response.statusText}`);
+      }
+
+      const arrayBuffer = await response.arrayBuffer();
+      return new Uint8Array(arrayBuffer);
+    } catch (error: any) {
+      clearTimeout(timeoutId);
+      if (error.name === 'AbortError') {
+        throw new Error('Image download timeout');
       }
-    });
+      throw error;
+    }
+  }
+  /** 获取图片过期时间 */
+  async getExpiredTime(url: string): Promise<{ expiredAt: number, expired: boolean }> {
+    // https://p3-dreamina-sign.byteimg.com/tos-cn-i-tb4s082cfz/c018e06ee6654dd78ccacb29eff4744e~tplv-tb4s082cfz-aigc_resize:0:0.png?lk3s=43402efa&x-expires=1767852000&x-signature=34yf37N955BP37eLaYEzKeLQn0Q%3D&format=.png
+    const urlObj = new URL(url);
+    let expires = urlObj.searchParams.get('x-expires');
+    if (!expires) {
+      expires = '0';
+    }
+    const expiredAt = parseInt(expires) * 1000;
+    const expired = Date.now() > expiredAt;
+    return { expiredAt, expired };
   }
 }
 
-export type ImageOptions = {
-  model?: string;
-  prompt: string;
-  /**
-   * 宽高比，如 "16:9", "4:3", "1:1" 等
-   */
-  ratio?: string;
-  /**
-   *  
-   * 图片分辨率，如 "1024x768", "512x512" 等
-   *  4k 2k
-   */
-  resolution?: string;
-}

package/src/provider/chat-adapter/mimo.ts

@@ -0,0 +1,10 @@
+import { BaseChat, type BaseChatOptions } from "../chat.ts";
+
+type MimoOptions = Partial<BaseChatOptions>;
+export class MimoChat extends BaseChat {
+  static BASE_URL = 'https://api.xiaomimimo.com/v1';
+  constructor(options: MimoOptions) {
+    const baseURL = options.baseURL || MimoChat.BASE_URL;
+    super({ ...(options as BaseChatOptions), baseURL: baseURL });
+  }
+}

package/src/provider/chat-adapter/ollama.ts

@@ -25,11 +25,6 @@ export class Ollama extends BaseChat {
     const baseURL = options.baseURL || Ollama.BASE_URL;
     super({ ...(options as BaseChatOptions), baseURL: baseURL });
   }
-  async chat(messages: ChatMessage[], options?: ChatMessageOptions) {
-    const res = await super.chat(messages, options);
-    console.log('thunk', this.getChatUsage());
-    return res;
-  }
   /**
    * 获取模型列表
    * @returns

package/src/provider/chat-adapter/siliconflow.ts

@@ -32,8 +32,4 @@ export class SiliconFlow extends BaseChat {
   async getUsageInfo(): Promise<SiliconFlowUsageResponse> {
     return this.get('/user/info');
   }
-  async chat(messages: ChatMessage[], options?: ChatMessageOptions) {
-    const res = await super.chat(messages, options);
-    return res;
-  }
 }

package/src/provider/core/chat.ts

@@ -50,10 +50,10 @@ export class BaseChat implements BaseChatInterface, Usage {
    * 默认apiKey
    */
   apiKey: string;
-  prompt_tokens: number;
-  total_tokens: number;
-  completion_tokens: number;
-  responseText: string;
+  prompt_tokens: number = 0;
+  total_tokens: number = 0;
+  completion_tokens: number = 0;
+  responseText: string = '';
   utils = AIUtils;
   constructor(options: BaseChatOptions) {
     this.baseURL = options.baseURL;
@@ -88,11 +88,17 @@ export class BaseChat implements BaseChatInterface, Usage {
   /**
    * 聊天
    */
-  async chat(messages: ChatMessage[], options?: ChatMessageOptions): Promise<ChatMessageComplete> {
+  chat(options: ChatMessageOptions): Promise<ChatMessageComplete>;
+  chat(messages: ChatMessage[], options?: ChatMessageOptions): Promise<ChatMessageComplete>;
+  async chat(messagesOrOptions: ChatMessage[] | ChatMessageOptions, options?: ChatMessageOptions): Promise<ChatMessageComplete> {
+    const isFirstParamOptions = !Array.isArray(messagesOrOptions);
+    const messages: ChatMessage[] = isFirstParamOptions ? messagesOrOptions.messages! : messagesOrOptions;
+    const opts: ChatMessageOptions = isFirstParamOptions ? messagesOrOptions : options || {};
+
     const requestBody = {
       model: this.model,
       messages,
-      ...options,
+      ...opts,
       stream: false,
     };
 
@@ -105,21 +111,26 @@ export class BaseChat implements BaseChatInterface, Usage {
 
     const res = await response.json() as ChatMessageComplete;
 
-    this.prompt_tokens = res.usage?.prompt_tokens ?? 0;
-    this.total_tokens = res.usage?.total_tokens ?? 0;
-    this.completion_tokens = res.usage?.completion_tokens ?? 0;
+    this.setChatUsage(res.usage);
+    
     this.responseText = res.choices[0]?.message?.content || '';
     return res;
   }
-  async chatStream(messages: ChatMessage[], options?: ChatMessageOptions) {
-    if (options?.response_format) {
+  chatStream(options: ChatMessageOptions): AsyncGenerator<ChatMessageComplete>;
+  chatStream(messages: ChatMessage[], options?: ChatMessageOptions): AsyncGenerator<ChatMessageComplete>;
+  async *chatStream(messagesOrOptions: ChatMessage[] | ChatMessageOptions, options?: ChatMessageOptions) {
+    const isFirstParamOptions = !Array.isArray(messagesOrOptions);
+    const messages: ChatMessage[] = isFirstParamOptions ? messagesOrOptions.messages! : messagesOrOptions;
+    const opts: ChatMessageOptions = isFirstParamOptions ? messagesOrOptions : options || {};
+
+    if (opts.response_format) {
       throw new Error('response_format is not supported in stream mode');
     }
 
     const requestBody = {
       model: this.model,
       messages,
-      ...options,
+      ...opts,
       stream: true,
     };
 
@@ -191,6 +202,11 @@ export class BaseChat implements BaseChatInterface, Usage {
       completion_tokens: this.completion_tokens,
     };
   }
+  setChatUsage(usage: { prompt_tokens?: number; total_tokens?: number; completion_tokens?: number }) {
+    this.prompt_tokens = usage.prompt_tokens ?? this.prompt_tokens;
+    this.total_tokens = usage.total_tokens ?? this.total_tokens;
+    this.completion_tokens = usage.completion_tokens ?? this.completion_tokens;
+  }
 
   getHeaders(headers?: Record<string, string>) {
     return {

package/src/provider/core/type.ts

@@ -2,8 +2,8 @@ export type ChatMessage = {
   role?: 'user' | 'assistant' | 'system' | 'tool';
   content: string;
 }
-export type ChatMessageOptions = {
-  messages: ChatMessage[];
+export type ChatMessageOptions<T = {}> = {
+  messages?: ChatMessage[];
   /**
   * 模型名称
   */
@@ -43,7 +43,7 @@ export type ChatMessageOptions = {
   stream?: boolean;
   /**
    * 是否能够思考
-   * 如果会话是千文，服务器的接口，默认为 true
+   * 如果会话是千文，服务器的接口，默认为 false
    */
   enable_thinking?: boolean;
   response_format?: 'text' | 'json' | 'xml' | 'html';
@@ -53,7 +53,9 @@ export type ChatMessageOptions = {
    */
   tool_calls?: any;
 
-};
+  [key: string]: any;
+
+} & T;
 
 type Choice = {
   finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | 'function_call';
@@ -167,6 +169,7 @@ export type EmbeddingMessageComplete = {
 
 
 export interface BaseChatInterface {
+  chat(options: ChatMessageOptions): Promise<ChatMessageComplete>;
   chat(messages: ChatMessage[], options?: ChatMessageOptions): Promise<ChatMessageComplete>;
 }