@spacex110/core 0.1.14 → 0.1.15

package/dist/channel-manager.d.ts

@@ -0,0 +1,276 @@
+import { AIConfig, Provider, Model, ModelCapability, StorageAdapter, ApiFormat } from './types';
+
+/** 通道配置（扩展 AIConfig，包含更多元数据） */
+export interface ChannelConfig extends AIConfig {
+    /** 通道唯一标识 */
+    id: string;
+    /** 通道名称（用户自定义） */
+    name?: string;
+    /** Provider 名称 */
+    providerName: string;
+    /** 模型显示名称 */
+    modelName: string;
+    /** API 格式 */
+    apiFormat: ApiFormat;
+    /** 模型能力列表 */
+    capabilities?: ModelCapability[];
+    /** 上下文窗口大小 */
+    contextLength?: number;
+    /** 创建时间 */
+    createdAt: number;
+    /** 最后使用时间 */
+    lastUsedAt?: number;
+    /** 连接状态 */
+    status?: 'untested' | 'connected' | 'error';
+    /** 最后错误信息 */
+    lastError?: string;
+}
+/** 通道管理器配置选项 */
+export interface ChannelManagerOptions {
+    /** 存储适配器（默认使用加密存储） */
+    storageAdapter?: StorageAdapter;
+    /** 存储键名前缀 */
+    storagePrefix?: string;
+    /** 当前激活通道的存储键 */
+    activeChannelKey?: string;
+    /** 能力默认通道的存储键 */
+    capabilityDefaultsKey?: string;
+    /** 后端代理地址（可选，用于解决 CORS 问题） */
+    proxyUrl?: string;
+}
+/** 通道查询过滤条件 */
+export interface ChannelFilter {
+    /** 按 Provider ID 过滤 */
+    providerId?: string;
+    /** 按 API 格式过滤 */
+    apiFormat?: ApiFormat;
+    /** 按模型能力过滤 */
+    capability?: ModelCapability;
+    /** 按连接状态过滤 */
+    status?: ChannelConfig['status'];
+    /** 关键字搜索（匹配名称、模型名、Provider 名） */
+    keyword?: string;
+}
+/** 聊天结果 */
+export interface ChatResult {
+    success: boolean;
+    content?: string;
+    message?: string;
+    latencyMs?: number;
+    channelId?: string;
+    model?: string;
+}
+/** 事件类型 */
+export type ChannelEventType = 'add' | 'update' | 'delete' | 'activate' | 'chat' | 'test' | 'clear';
+type ChannelEventListener = (data: any) => void;
+export declare class AIChannelManager {
+    private storageAdapter;
+    private channels;
+    private activeChannelId;
+    private storagePrefix;
+    private activeChannelKey;
+    private capabilityDefaultsKey;
+    private capabilityDefaults;
+    private proxyUrl?;
+    private listeners;
+    constructor(options?: ChannelManagerOptions);
+    /** 监听事件 */
+    on(event: ChannelEventType, listener: ChannelEventListener): () => void;
+    /** 取消监听 */
+    off(event: ChannelEventType, listener: ChannelEventListener): void;
+    private emit;
+    private getStorageKey;
+    private loadChannels;
+    private loadActiveChannel;
+    private saveChannel;
+    private deleteChannelFromStorage;
+    private saveActiveChannel;
+    private loadCapabilityDefaults;
+    private saveCapabilityDefaults;
+    /** 添加通道 */
+    addChannel(config: AIConfig, name?: string): Promise<ChannelConfig>;
+    /** 删除通道 */
+    deleteChannel(id: string): void;
+    /** 更新通道 */
+    updateChannel(id: string, config: Partial<AIConfig>, name?: string): Promise<ChannelConfig>;
+    /** 获取所有通道 */
+    getChannels(): ChannelConfig[];
+    /** 根据 ID 获取通道 */
+    getChannel(id: string): ChannelConfig | undefined;
+    /** 按 Provider ID 过滤通道 */
+    getChannelsByProvider(providerId: string): ChannelConfig[];
+    /** 按模型能力过滤通道（如 vision, reasoning, audio） */
+    getChannelsByCapability(capability: ModelCapability): ChannelConfig[];
+    /** 按 API 格式过滤通道（如 openai, anthropic, gemini） */
+    getChannelsByFormat(format: ApiFormat): ChannelConfig[];
+    /** 按连接状态过滤通道 */
+    getChannelsByStatus(status: ChannelConfig['status']): ChannelConfig[];
+    /** 综合条件查询通道 */
+    queryChannels(filter: ChannelFilter): ChannelConfig[];
+    /** 获取通道数量 */
+    getChannelCount(): number;
+    /** 获取当前激活的通道 */
+    getActiveChannel(): ChannelConfig | undefined;
+    /** 设置当前激活的通道 */
+    setActiveChannel(id: string): void;
+    /** 清除当前激活的通道 */
+    clearActiveChannel(): void;
+    /**
+     * 为指定能力类型设置默认通道
+     * 当调用 getChannelForCapability 时，优先返回此通道
+     */
+    setDefaultForCapability(capability: ModelCapability, channelId: string): void;
+    /**
+     * 获取指定能力类型的默认通道 ID
+     * 返回 undefined 表示未设置
+     */
+    getDefaultForCapability(capability: ModelCapability): string | undefined;
+    /**
+     * 清除指定能力类型的默认通道
+     */
+    clearDefaultForCapability(capability: ModelCapability): void;
+    /**
+     * 获取所有能力类型的默认通道映射
+     * 返回 { capability: channelId } 的对象
+     */
+    getAllCapabilityDefaults(): Record<string, string>;
+    /**
+     * 根据能力类型获取最适合的通道（带降级链）
+     *
+     * 降级链：
+     *   1. 该能力类型的显式默认通道
+     *   2. 具有该能力且最后使用时间最新的通道
+     *   3. 全局激活通道
+     *   4. 第一个可用通道
+     */
+    getChannelForCapability(capability: ModelCapability): ChannelConfig | undefined;
+    /**
+     * 使用指定能力类型的默认通道发送聊天请求
+     * 自动选择合适的通道，无需手动指定 channelId
+     */
+    chatForCapability(capability: ModelCapability, message: string, options?: {
+        messages?: Array<{
+            role: string;
+            content: string;
+        }>;
+        maxTokens?: number;
+    }): Promise<ChatResult>;
+    /**
+     * 使用指定能力类型的默认通道发送流式聊天请求
+     */
+    chatStreamForCapability(capability: ModelCapability, message: string, options?: {
+        messages?: Array<{
+            role: string;
+            content: string;
+        }>;
+        maxTokens?: number;
+        signal?: AbortSignal;
+        onDelta?: (full: string) => void;
+    }): Promise<ChatResult>;
+    /** 获取 Provider 的可用模型列表（动态获取 + 静态兜底） */
+    getProviderModels(providerId: string, apiKey?: string, baseUrl?: string): Promise<Model[]>;
+    /** 获取通道对应的 Provider 的模型列表 */
+    getChannelModels(id: string): Promise<Model[]>;
+    /** 获取 Provider 的静态模型列表（不发起网络请求） */
+    getStaticModelList(providerId: string): Model[];
+    /** 按能力过滤模型列表 */
+    getModelsByCapability(models: Model[], capability: ModelCapability): Model[];
+    /** 获取所有已配置的模型摘要列表 */
+    getConfiguredModels(): Array<{
+        channelId: string;
+        providerId: string;
+        providerName: string;
+        model: string;
+        modelName: string;
+        apiFormat: ApiFormat;
+        capabilities: ModelCapability[];
+        status: ChannelConfig['status'];
+    }>;
+    /** 更新通道的 API Key */
+    updateApiKey(id: string, apiKey: string): Promise<ChannelConfig>;
+    /** 验证 API Key 格式（简单校验，非空且长度合理） */
+    validateApiKey(providerId: string, apiKey: string): {
+        valid: boolean;
+        message?: string;
+    };
+    /** 脱敏显示 API Key（如 sk-••••••••J4xK） */
+    maskApiKey(apiKey: string): string;
+    /** 获取通道的脱敏 API Key */
+    getMaskedApiKey(id: string): string;
+    /** 使用当前激活的通道发送聊天请求 */
+    chat(message: string, options?: {
+        messages?: Array<{
+            role: string;
+            content: string;
+        }>;
+        maxTokens?: number;
+    }): Promise<ChatResult>;
+    /** 使用指定通道发送聊天请求 */
+    chatWith(channelId: string, message: string, options?: {
+        messages?: Array<{
+            role: string;
+            content: string;
+        }>;
+        maxTokens?: number;
+    }): Promise<ChatResult>;
+    /** 使用当前激活通道发送流式聊天。onDelta 每次收到「累计完整文本」。 */
+    chatStream(message: string, options: {
+        messages?: Array<{
+            role: string;
+            content: string;
+        }>;
+        maxTokens?: number;
+        onDelta: (full: string) => void;
+        signal?: AbortSignal;
+    }): Promise<ChatResult>;
+    /** 使用指定通道发送流式聊天。onDelta 每次收到「累计完整文本」。 */
+    chatWithStream(channelId: string, message: string, options: {
+        messages?: Array<{
+            role: string;
+            content: string;
+        }>;
+        maxTokens?: number;
+        onDelta: (full: string) => void;
+        signal?: AbortSignal;
+    }): Promise<ChatResult>;
+    /** 测试指定通道的连接 */
+    testChannel(id: string): Promise<{
+        success: boolean;
+        latencyMs?: number;
+        message?: string;
+    }>;
+    /** 测试所有通道连接 */
+    testAllChannels(): Promise<Array<{
+        id: string;
+        channel: ChannelConfig;
+        result: {
+            success: boolean;
+            latencyMs?: number;
+            message?: string;
+        };
+    }>>;
+    /** 获取所有可用的 Provider */
+    getAvailableProviders(): Provider[];
+    /** 获取单个 Provider 信息 */
+    getProvider(providerId: string): Provider | undefined;
+    /** 按 API 格式获取 Provider 列表 */
+    getProvidersByFormat(format: ApiFormat): Provider[];
+    /** 导出所有通道配置（不包含 API Key 明文） */
+    exportChannels(includeApiKeys?: boolean): string;
+    /** 导入通道配置 */
+    importChannels(json: string, merge?: boolean): Promise<ChannelConfig[]>;
+    /** 清空所有通道 */
+    clearAllChannels(): void;
+    /** 批量删除通道 */
+    deleteChannels(ids: string[]): void;
+    /** 获取统计信息 */
+    getStats(): {
+        total: number;
+        byStatus: Record<string, number>;
+        byFormat: Record<string, number>;
+        byProvider: Record<string, number>;
+        byCapability: Record<string, number>;
+    };
+}
+export {};
+//# sourceMappingURL=channel-manager.d.ts.map

package/dist/index.d.ts

@@ -564,6 +564,7 @@ export declare const PROVIDER_ID: {
     readonly OLLAMA: "ollama";
     readonly DOUBAO: "doubao";
     readonly MINIMAX: "minimax";
+    readonly MINIMAX_CN: "minimax-cn";
     readonly CUSTOM: "custom";
 };