@userdaoo/iflow-api-bridge 0.1.0

package/README.md

@@ -0,0 +1,195 @@
+# iFlow API Bridge
+
+将 iFlow（心流）CLI 的无限 LLM 服务暴露为 OpenAI 兼容的 API，使 Claude Code、OpenCode 等 Agent 可以直接使用。
+
+## 特性
+
+- 🚀 **OpenAI API 兼容**：支持 `OPENAI_BASE_URL` 环境变量配置
+- 🔄 **流式输出**：完整的 SSE 流式响应支持
+- 🔌 **零配置**：自动检测和启动 iFlow 进程
+- 🌐 **CORS 支持**：开箱即用的跨域支持
+- 🔐 **可选认证**：支持 API Key 认证
+- 📦 **无状态**：不存储会话状态，每次请求独立处理
+
+## 安装
+
+```bash
+npm install -g @iflow-ai/iflow-api-bridge
+```
+
+## 快速开始
+
+### 1. 启动服务
+
+```bash
+# 使用默认配置（端口 8080）
+iflow-api-server
+
+# 自定义端口
+iflow-api-server --port 3000
+
+# 指定模型（用于API标识，需在iFlow中预先配置）
+iflow-api-server --model claude
+
+# 启用 API Key 认证
+iflow-api-server --api-key sk-your-secret-key
+```
+
+### 2. 在其他 Agent 中配置
+
+```bash
+# 设置环境变量
+export OPENAI_BASE_URL=http://localhost:8080/v1
+export OPENAI_API_KEY=sk-anything  # 如果没有启用认证，可以填任意值
+
+# 启动 Claude Code
+claude
+
+# 或使用 OpenCode
+opencode
+```
+
+## API 端点
+
+### 聊天完成
+
+```bash
+curl http://localhost:8080/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer sk-anything" \
+  -d '{
+    "model": "iflow-default",
+    "messages": [{"role": "user", "content": "Hello!"}],
+    "stream": false
+  }'
+```
+
+### 流式响应
+
+```bash
+curl http://localhost:8080/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer sk-anything" \
+  -d '{
+    "model": "iflow-default",
+    "messages": [{"role": "user", "content": "讲个故事"}],
+    "stream": true
+  }'
+```
+
+### 模型列表
+
+```bash
+curl http://localhost:8080/v1/models
+```
+
+### 健康检查
+
+```bash
+curl http://localhost:8080/health
+```
+
+## CLI 选项
+
+```
+选项:
+  -p, --port <port>       服务端口 (默认: 8080)
+  -h, --host <host>       服务主机 (默认: 0.0.0.0)
+  --no-cors               禁用 CORS
+  -k, --api-key <key>     API Key 认证
+  -m, --model <model>     指定使用的模型 (如 claude, gpt-4)
+  -c, --config <path>     配置文件路径
+  --log-level <level>     日志级别 (DEBUG|INFO|WARN|ERROR) (默认: INFO)
+  -V, --version           显示版本号
+  --help                  显示帮助信息
+```
+
+## 配置文件
+
+创建 `iflow-api.config.json`：
+
+```json
+{
+  "port": 8080,
+  "host": "0.0.0.0",
+  "cors": true,
+  "apiKey": "sk-your-secret-key",
+  "model": "claude",
+  "logLevel": "INFO"
+}
+```
+
+配置文件优先级（从高到低）：
+1. CLI 参数
+2. 环境变量
+3. 配置文件
+4. 默认值
+
+## 环境变量
+
+| 变量名 | 说明 | 默认值 |
+|--------|------|--------|
+| `IFLOW_API_PORT` | 服务端口 | `8080` |
+| `IFLOW_API_HOST` | 服务主机 | `0.0.0.0` |
+| `IFLOW_API_KEY` | API Key | - |
+| `IFLOW_API_MODEL` | 指定模型名称 | - |
+| `IFLOW_API_LOG_LEVEL` | 日志级别 | `INFO` |
+| `IFLOW_API_CORS` | 启用 CORS | `true` |
+
+## 模型配置
+
+**注意**：`--model` 参数（或 `IFLOW_API_MODEL` 环境变量）主要用于 API 响应标识，实际的模型选择需要在 iFlow CLI 中配置：
+
+1. **启动桥接服务时指定模型名称**（用于 API 响应）：
+   ```bash
+   iflow-api-server --model claude-3-opus
+   ```
+
+2. **在 iFlow CLI 中配置实际模型**：
+   - 运行 `iflow` 进入交互界面
+   - 使用 `/model` 或相关命令切换模型
+   - 或使用 iFlow 的配置文件指定默认模型
+
+3. **客户端请求时指定模型**：
+   ```bash
+   curl http://localhost:8080/v1/chat/completions \
+     -H "Content-Type: application/json" \
+     -d '{
+       "model": "claude-3-opus",
+       "messages": [{"role": "user", "content": "Hello!"}]
+     }'
+   ```
+
+桥接服务会将模型信息传递给 iFlow，但实际使用的模型取决于 iFlow 的配置。
+
+## 与 Claude Code 集成
+
+1. 启动 iflow-api-server：
+   ```bash
+   iflow-api-server --port 8080
+   ```
+
+2. 配置 Claude Code：
+   ```bash
+   export OPENAI_BASE_URL=http://localhost:8080/v1
+   export OPENAI_API_KEY=sk-iflow
+   ```
+
+3. 启动 Claude Code 并选择 OpenAI 模型：
+   ```bash
+   claude
+   # 在 Claude Code 中选择使用 OpenAI 模型
+   ```
+
+## 架构
+
+```
+┌─────────────┐      HTTP/OpenAI API      ┌─────────────┐      WebSocket      ┌─────────┐
+│ Claude Code │ ─────────────────────────> │ iflow-api   │ ──────────────────> │ iFlow   │
+│ OpenCode    │                            │ -server     │                     │  CLI    │
+└─────────────┘                            └─────────────┘                     └─────────┘
+```
+
+## 许可证
+
+MIT

package/dist/adapter.d.ts

@@ -0,0 +1,59 @@
+/**
+ * iFlow SDK 适配器（使用子进程模式）
+ * 封装与 iFlow CLI 的通信
+ */
+export interface IFlowResponse {
+    content: string;
+    toolCalls?: Array<{
+        name: string;
+        status: string;
+    }>;
+    stopReason: 'end_turn' | 'max_tokens' | 'error';
+}
+export interface StreamChunk {
+    type: 'content' | 'tool_call' | 'done' | 'error';
+    content?: string;
+    toolName?: string;
+    toolStatus?: string;
+    error?: string;
+}
+export interface IFlowAdapterOptions {
+    model?: string;
+    apiKey?: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+/**
+ * iFlow 适配器 - 使用子进程模式
+ */
+export declare class IFlowAdapter {
+    private options;
+    private defaultTimeout;
+    constructor(options?: IFlowAdapterOptions);
+    /**
+     * 发送消息并获取完整响应（非流式）
+     */
+    sendMessage(prompt: string): Promise<IFlowResponse>;
+    /**
+     * 发送消息并获取流式响应
+     */
+    sendMessageStream(prompt: string): AsyncGenerator<StreamChunk>;
+    /**
+     * 解析 iFlow 输出，提取实际回复内容
+     */
+    private parseResponse;
+    /**
+     * 连接到 iFlow
+     */
+    connect(): Promise<void>;
+    /**
+     * 断开连接
+     */
+    disconnect(): void;
+    /**
+     * 检查是否已连接
+     */
+    isConnected(): boolean;
+}
+export default IFlowAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,UAAU,EAAE,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;CACjD;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,cAAc,CAAU;gBAEpB,OAAO,GAAE,mBAAwB;IAI7C;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAoDzD;;OAEG;IACI,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC;IA2ErE;;OAEG;IACH,OAAO,CAAC,aAAa;IAsBrB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,WAAW,IAAI,OAAO;CAIvB;AAED,eAAe,YAAY,CAAC"}

package/dist/adapter.js

@@ -0,0 +1,171 @@
+"use strict";
+/**
+ * iFlow SDK 适配器（使用子进程模式）
+ * 封装与 iFlow CLI 的通信
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IFlowAdapter = void 0;
+const child_process_1 = require("child_process");
+/**
+ * iFlow 适配器 - 使用子进程模式
+ */
+class IFlowAdapter {
+    options;
+    defaultTimeout = 120000; // 2分钟默认超时
+    constructor(options = {}) {
+        this.options = options;
+    }
+    /**
+     * 发送消息并获取完整响应（非流式）
+     */
+    async sendMessage(prompt) {
+        console.log('[Adapter] 发送消息（非流式）:', prompt.substring(0, 100));
+        return new Promise((resolve, reject) => {
+            const args = ['-p', prompt];
+            if (this.options.model) {
+                args.push('-m', this.options.model);
+            }
+            console.log('[Adapter] 启动 iflow:', args.join(' '));
+            const child = (0, child_process_1.spawn)('iflow', args, {
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let stdout = '';
+            let stderr = '';
+            const timeout = setTimeout(() => {
+                child.kill('SIGTERM');
+                reject(new Error(`iFlow 响应超时 (${this.defaultTimeout}ms)`));
+            }, this.options.timeout || this.defaultTimeout);
+            child.stdout?.on('data', (data) => {
+                stdout += data.toString();
+            });
+            child.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
+            child.on('error', (err) => {
+                clearTimeout(timeout);
+                reject(new Error(`启动 iFlow 失败: ${err.message}`));
+            });
+            child.on('exit', (code) => {
+                clearTimeout(timeout);
+                console.log('[Adapter] iFlow 退出，code:', code);
+                if (code !== 0 && code !== null) {
+                    console.error('[Adapter] iFlow stderr:', stderr);
+                }
+                // 解析响应
+                const content = this.parseResponse(stdout);
+                resolve({
+                    content,
+                    stopReason: code === 0 ? 'end_turn' : 'error',
+                });
+            });
+        });
+    }
+    /**
+     * 发送消息并获取流式响应
+     */
+    async *sendMessageStream(prompt) {
+        console.log('[Adapter] 发送消息（流式）:', prompt.substring(0, 100));
+        const args = ['-p', prompt];
+        if (this.options.model) {
+            args.push('-m', this.options.model);
+        }
+        console.log('[Adapter] 启动 iflow:', args.join(' '));
+        const child = (0, child_process_1.spawn)('iflow', args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let buffer = '';
+        let isDone = false;
+        const timeout = setTimeout(() => {
+            if (!isDone) {
+                child.kill('SIGTERM');
+                isDone = true;
+                console.error('[Adapter] 流式响应超时');
+            }
+        }, this.options.timeout || this.defaultTimeout);
+        child.stdout?.on('data', (data) => {
+            buffer += data.toString();
+        });
+        child.stderr?.on('data', (data) => {
+            const msg = data.toString();
+            console.log('[Adapter] iFlow stderr:', msg.trim());
+        });
+        // 模拟流式输出 - 逐字符发送
+        let lastSentIndex = 0;
+        while (!isDone) {
+            // 检查进程是否结束
+            if (child.exitCode !== null) {
+                isDone = true;
+            }
+            // 发送新内容
+            if (buffer.length > lastSentIndex) {
+                const newContent = buffer.slice(lastSentIndex);
+                lastSentIndex = buffer.length;
+                // 逐行或逐字符发送
+                const lines = newContent.split('\n');
+                for (const line of lines) {
+                    if (line.trim()) {
+                        yield {
+                            type: 'content',
+                            content: line + '\n',
+                        };
+                    }
+                }
+            }
+            if (!isDone) {
+                await new Promise((resolve) => setTimeout(resolve, 50));
+            }
+        }
+        clearTimeout(timeout);
+        // 发送剩余内容
+        if (buffer.length > lastSentIndex) {
+            yield {
+                type: 'content',
+                content: buffer.slice(lastSentIndex),
+            };
+        }
+        yield { type: 'done' };
+    }
+    /**
+     * 解析 iFlow 输出，提取实际回复内容
+     */
+    parseResponse(stdout) {
+        // 尝试提取 <Execution Info> 之前的内容作为回复
+        const executionInfoMatch = stdout.match(/<Execution Info>[\s\S]*$/);
+        if (executionInfoMatch) {
+            return stdout.substring(0, executionInfoMatch.index).trim();
+        }
+        // 如果没有 Execution Info，返回全部内容（去掉开头的警告）
+        const lines = stdout.split('\n');
+        const startIndex = lines.findIndex((line) => !line.includes('DeprecationWarning') &&
+            !line.includes('node:') &&
+            line.trim());
+        if (startIndex >= 0) {
+            return lines.slice(startIndex).join('\n').trim();
+        }
+        return stdout.trim();
+    }
+    /**
+     * 连接到 iFlow
+     */
+    async connect() {
+        // 子进程模式不需要持久连接
+        console.log('[Adapter] 子进程模式已就绪');
+    }
+    /**
+     * 断开连接
+     */
+    disconnect() {
+        // 子进程模式不需要断开连接
+        console.log('[Adapter] 子进程模式断开（无操作）');
+    }
+    /**
+     * 检查是否已连接
+     */
+    isConnected() {
+        // 子进程模式总是"已连接"
+        return true;
+    }
+}
+exports.IFlowAdapter = IFlowAdapter;
+exports.default = IFlowAdapter;
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * CLI 入口
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;GAEG"}

package/dist/cli.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * CLI 入口
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const server_js_1 = require("./server.js");
+const config_js_1 = require("./config.js");
+const program = new commander_1.Command();
+program
+    .name('iflow-api-server')
+    .description('将 iFlow LLM 服务暴露为 OpenAI 兼容 API')
+    .version('0.1.0');
+program
+    .option('-p, --port <port>', '服务端口', '8080')
+    .option('-h, --host <host>', '服务主机', '0.0.0.0')
+    .option('--no-cors', '禁用 CORS')
+    .option('-k, --api-key <key>', 'API Key 认证')
+    .option('-m, --model <model>', '指定使用的模型 (如 claude, gpt-4)', 'kimi-k2.5')
+    .option('-c, --config <path>', '配置文件路径')
+    .option('--log-level <level>', '日志级别 (DEBUG|INFO|WARN|ERROR)', 'INFO')
+    .action(async (options) => {
+    try {
+        // 加载配置
+        const fileConfig = (0, config_js_1.loadConfig)(options.config);
+        const envConfig = (0, config_js_1.loadEnvConfig)();
+        const cliConfig = {
+            port: options.port ? parseInt(options.port, 10) : undefined,
+            host: options.host,
+            cors: options.cors,
+            apiKey: options.apiKey,
+            model: options.model,
+            logLevel: options.logLevel,
+        };
+        // 合并配置
+        const config = (0, config_js_1.mergeConfig)(fileConfig, envConfig, cliConfig);
+        // 创建并启动服务器
+        const server = new server_js_1.IFlowAPIServer(config);
+        // 处理退出信号
+        const shutdown = async (signal) => {
+            console.log(`\n${signal} 收到，正在关闭服务器...`);
+            await server.stop();
+            process.exit(0);
+        };
+        process.on('SIGINT', () => shutdown('SIGINT'));
+        process.on('SIGTERM', () => shutdown('SIGTERM'));
+        // 启动
+        await server.start();
+    }
+    catch (error) {
+        console.error('启动失败:', error);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AAEA;;GAEG;;AAEH,yCAAoC;AACpC,2CAA6C;AAC7C,2CAAkF;AAElF,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,kBAAkB,CAAC;KACxB,WAAW,CAAC,iCAAiC,CAAC;KAC9C,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,MAAM,CAAC,mBAAmB,EAAE,MAAM,EAAE,MAAM,CAAC;KAC3C,MAAM,CAAC,mBAAmB,EAAE,MAAM,EAAE,SAAS,CAAC;KAC9C,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC;KAC9B,MAAM,CAAC,qBAAqB,EAAE,YAAY,CAAC;KAC3C,MAAM,CAAC,qBAAqB,EAAE,2BAA2B,EAAE,WAAW,CAAC;KACvE,MAAM,CAAC,qBAAqB,EAAE,QAAQ,CAAC;KACvC,MAAM,CAAC,qBAAqB,EAAE,8BAA8B,EAAE,MAAM,CAAC;KACrE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,OAAO;QACP,MAAM,UAAU,GAAG,IAAA,sBAAU,EAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,IAAA,yBAAa,GAAE,CAAC;QAClC,MAAM,SAAS,GAAoB;YACjC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;YAC3D,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC;QAEF,OAAO;QACP,MAAM,MAAM,GAAG,IAAA,uBAAW,EAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAE7D,WAAW;QACX,MAAM,MAAM,GAAG,IAAI,0BAAc,CAAC,MAAM,CAAC,CAAC;QAE1C,SAAS;QACT,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;YACxC,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,gBAAgB,CAAC,CAAC;YACzC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QAEjD,KAAK;QACL,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 配置管理
+ */
+export interface Config {
+    port: number;
+    host: string;
+    cors: boolean;
+    apiKey?: string;
+    model?: string;
+    logLevel: 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
+}
+export declare const DEFAULT_CONFIG: Config;
+/**
+ * 从文件加载配置
+ */
+export declare function loadConfig(configPath?: string): Partial<Config>;
+/**
+ * 从环境变量加载配置
+ */
+export declare function loadEnvConfig(): Partial<Config>;
+/**
+ * 合并配置
+ */
+export declare function mergeConfig(fileConfig: Partial<Config>, envConfig: Partial<Config>, cliConfig: Partial<Config>): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC/C;AAED,eAAO,MAAM,cAAc,EAAE,MAM5B,CAAC;AAEF;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB/D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CA+B/C;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,EAC3B,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,EAC1B,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,GACzB,MAAM,CAOR"}

package/dist/config.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * 配置管理
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = void 0;
+exports.loadConfig = loadConfig;
+exports.loadEnvConfig = loadEnvConfig;
+exports.mergeConfig = mergeConfig;
+const fs_1 = require("fs");
+const path_1 = require("path");
+exports.DEFAULT_CONFIG = {
+    port: 8080,
+    host: '0.0.0.0',
+    cors: true,
+    model: 'kimi-k2.5',
+    logLevel: 'INFO',
+};
+/**
+ * 从文件加载配置
+ */
+function loadConfig(configPath) {
+    const paths = configPath
+        ? [configPath]
+        : [
+            './iflow-api.config.json',
+            './.iflow-api.json',
+            '~/.iflow-api/config.json',
+        ];
+    for (const path of paths) {
+        const fullPath = (0, path_1.resolve)(path.replace(/^~/, process.env.HOME || ''));
+        if ((0, fs_1.existsSync)(fullPath)) {
+            try {
+                const content = (0, fs_1.readFileSync)(fullPath, 'utf-8');
+                return JSON.parse(content);
+            }
+            catch (error) {
+                console.warn(`无法加载配置文件 ${path}:`, error);
+            }
+        }
+    }
+    return {};
+}
+/**
+ * 从环境变量加载配置
+ */
+function loadEnvConfig() {
+    const config = {};
+    if (process.env.IFLOW_API_PORT) {
+        config.port = parseInt(process.env.IFLOW_API_PORT, 10);
+    }
+    if (process.env.IFLOW_API_HOST) {
+        config.host = process.env.IFLOW_API_HOST;
+    }
+    if (process.env.IFLOW_API_KEY) {
+        config.apiKey = process.env.IFLOW_API_KEY;
+    }
+    if (process.env.IFLOW_API_LOG_LEVEL) {
+        const level = process.env.IFLOW_API_LOG_LEVEL;
+        if (['DEBUG', 'INFO', 'WARN', 'ERROR'].includes(level)) {
+            config.logLevel = level;
+        }
+    }
+    if (process.env.IFLOW_API_CORS) {
+        config.cors = process.env.IFLOW_API_CORS === 'true';
+    }
+    if (process.env.IFLOW_API_MODEL) {
+        config.model = process.env.IFLOW_API_MODEL;
+    }
+    return config;
+}
+/**
+ * 合并配置
+ */
+function mergeConfig(fileConfig, envConfig, cliConfig) {
+    return {
+        ...exports.DEFAULT_CONFIG,
+        ...fileConfig,
+        ...envConfig,
+        ...cliConfig,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAyBH,gCAsBC;AAKD,sCA+BC;AAKD,kCAWC;AAjGD,2BAA8C;AAC9C,+BAA+B;AAWlB,QAAA,cAAc,GAAW;IACpC,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,MAAM;CACjB,CAAC;AAEF;;GAEG;AACH,SAAgB,UAAU,CAAC,UAAmB;IAC5C,MAAM,KAAK,GAAG,UAAU;QACtB,CAAC,CAAC,CAAC,UAAU,CAAC;QACd,CAAC,CAAC;YACE,yBAAyB;YACzB,mBAAmB;YACnB,0BAA0B;SAC3B,CAAC;IAEN,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAA,cAAO,EAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QACrE,IAAI,IAAA,eAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAChD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa;IAC3B,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC3C,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAyC,CAAC;QACpE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACvD,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,MAAM,CAAC;IACtD,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAChC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC7C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CACzB,UAA2B,EAC3B,SAA0B,EAC1B,SAA0B;IAE1B,OAAO;QACL,GAAG,sBAAc;QACjB,GAAG,UAAU;QACb,GAAG,SAAS;QACZ,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * iFlow API Bridge
+ * 将 iFlow LLM 服务暴露为 OpenAI 兼容 API
+ */
+export { IFlowAdapter, type IFlowResponse, type StreamChunk } from './adapter.js';
+export { IFlowAPIServer, type ServerOptions } from './server.js';
+export { loadConfig, loadEnvConfig, mergeConfig, DEFAULT_CONFIG, type Config, } from './config.js';
+export * from './openai/types.js';
+export { generateId, getTimestamp, messagesToIFlowPrompt, createCompletionResponse, createStreamChunk, calculateUsage, formatSSE, SSE_DONE, AVAILABLE_MODELS, getDefaultModel, } from './openai/transformer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,KAAK,MAAM,GACZ,MAAM,aAAa,CAAC;AACrB,cAAc,mBAAmB,CAAC;AAClC,OAAO,EACL,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,eAAe,GAChB,MAAM,yBAAyB,CAAC"}