qwen-api-proxy 1.0.10 → 1.0.12

package/README.md

@@ -1,5 +1,10 @@
 # FreeQwenApi
 
+[![npm version](https://badge.fury.io/js/qwen-api-proxy.svg)](https://badge.fury.io/js/qwen-api-proxy)
+[![npm downloads](https://img.shields.io/npm/dm/qwen-api-proxy.svg)](https://www.npmjs.com/package/qwen-api-proxy)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
+
+> **📦 npm:** `npx qwen-api-proxy` или `npm install -g qwen-api-proxy`  
 > **🐳 Docker Hub:** https://hub.docker.com/r/endykaufman/qwen-api-proxy  
 > **🔧 Форк:** https://github.com/EndyKaufman/FreeQwenApi  
 > **🌐 Оригинал:** https://github.com/y13sint/FreeQwenApi
@@ -109,11 +114,12 @@ curl http://localhost:3264/api/chat/completions \
 ## Содержание
 
 1. [Быстрый старт](#быстрый-старт)
-2. [Docker Hub](#docker-hub) 🆕
-3. [Docker](#docker)
-4. [Управление аккаунтами](#управление-аккаунтами)
-5. [Авторизация API-ключами](#авторизация-api-ключами)
-6. [API Reference](#api-reference)
+2. [CLI команды](#-cli-команды) 🆕
+3. [Docker Hub](#docker-hub) 🆕
+4. [Docker](#docker)
+5. [Управление аккаунтами](#управление-аккаунтами)
+6. [Авторизация API-ключами](#авторизация-api-ключами)
+7. [API Reference](#api-reference)
    - [POST /api/chat](#post-apichat)
    - [POST /api/chat/completions](#post-apichatcompletions)
    - [GET /api/models](#get-apimodels)
@@ -122,19 +128,60 @@ curl http://localhost:3264/api/chat/completions \
    - [POST /api/files/upload](#post-apifilesupload)
    - [POST /api/files/getstsToken](#post-apifilesgetststoken)
    - [POST /api/images/generations](#post-apiimagesgenerations)
-7. [Работа с контекстом (API v2)](#работа-с-контекстом-api-v2)
-8. [Работа с изображениями](#работа-с-изображениями)
-9. [Генерация изображений](#генерация-изображений) 🆕
-10. [OpenAI SDK](#openai-sdk)
-11. [Python](#python-альтернативная-реализация)
-12. [Доступные модели](#доступные-модели)
-13. [Переменные окружения](#переменные-окружения)
-14. [Структура проекта](#структура-проекта)
+8. [Работа с контекстом (API v2)](#работа-с-контекстом-api-v2)
+9. [Работа с изображениями](#работа-с-изображениями)
+10. [Генерация изображений](#генерация-изображений) 🆕
+11. [OpenAI SDK](#openai-sdk)
+12. [Python](#python-альтернативная-реализация)
+13. [Доступные модели](#доступные-модели)
+14. [Переменные окружения](#переменные-окружения)
+15. [Структура проекта](#структура-проекта)
 
 ---
 
 ## Быстрый старт
 
+> 🆕 **Новые пользователи?** Начните с [QUICK_START.md](QUICK_START.md) - пошаговое руководство с устранением常见ных ошибок
+
+### 🌍 Кросс-платформенная поддержка
+
+Этот проект полностью поддерживает работу на:
+- ✅ **Windows** (10/11, Server 2019+)
+- ✅ **Linux** (Ubuntu 18.04+, Debian 10+, CentOS 8+)
+- ✅ **macOS** (10.15+, включая Apple Silicon)
+
+**Требования:**
+- Node.js >= 18.0.0 (рекомендуется 20.x или 22.x LTS)
+- Для команды `archive`: `zip` (Linux/macOS) или `zip`/`7-Zip`/PowerShell (Windows)
+
+> 📖 **Полное руководство:** [CROSS_PLATFORM.md](CROSS_PLATFORM.md)
+
+### 📦 Через npm (Рекомендуется)
+
+**Без установки (npx):**
+```bash
+# Инициализация директории
+npx qwen-api-proxy init
+
+# Запуск сервера
+npx qwen-api-proxy
+```
+
+**Глобальная установка:**
+```bash
+npm install -g qwen-api-proxy
+
+# Инициализация
+qwen-api-proxy init
+
+# Запуск сервера
+qwen-api-proxy
+```
+
+> 💡 **Подробнее:** [README_NPM.md](README_NPM.md) - полное руководство по npm пакету
+
+### 💻 Ручная установка
+
 ```bash
 # Node.js (Основной)
 git clone https://github.com/y13sint/FreeQwenApi
@@ -186,6 +233,62 @@ python main.py
 
 ---
 
+## 🛠️ CLI команды
+
+Все команды можно запускать через `npx` (без установки) или после глобальной установки:
+
+```bash
+# Без установки (рекомендуется для редкого использования)
+npx qwen-api-proxy <command>
+
+# После глобальной установки (для частого использования)
+qwen-api-proxy <command>
+```
+
+### Основные команды
+
+| Команда | Описание |
+|---------|----------|
+| `npx qwen-api-proxy` | Запуск сервера |
+| `npx qwen-api-proxy init` | Инициализация директории (без запуска) |
+| `npx qwen-api-proxy archive` | Создание архива сессии |
+| `npx qwen-api-proxy extend` | Продление сессий |
+| `npx qwen-api-proxy doctor` | Проверка здоровья системы |
+
+### Примеры использования
+
+```bash
+# Инициализация проекта
+npx qwen-api-proxy init
+
+# Создание архива сессии для backup
+npx qwen-api-proxy archive
+
+# Продление всех сессий
+npx qwen-api-proxy extend
+
+# Продление конкретного аккаунта
+npx qwen-api-proxy extend --account-id acc_1234567890
+
+# Проверка здоровья системы
+npx qwen-api-proxy doctor
+
+# С пользовательской директорией
+npx qwen-api-proxy archive --dir=/path/to/project
+```
+
+### 🔧 NPM Scripts (для разработчиков)
+
+```bash
+npm start                 # Запуск сервера
+npm run archive           # Создание архива
+npm run auth              # Добавить аккаунт
+npm run rebuild-tokens    # Перестроить tokens.json
+npm run check-sessions    # Проверить сессии
+```
+
+---
+
 ## Docker Hub
 
 Готовый Docker образ доступен на Docker Hub:
@@ -208,7 +311,7 @@ docker run -d \
   -v $(pwd)/logs:/app/logs \
   -v $(pwd)/uploads:/app/uploads \
   -v $(pwd)/temp:/app/temp \
-  endykaufman/qwen-api-proxy:1.0.10
+  endykaufman/qwen-api-proxy:1.0.12
 
 # 3. Смотрим логи
 docker logs -f qwen-proxy
@@ -217,7 +320,7 @@ docker logs -f qwen-proxy
 ### Доступные теги
 
 - `latest` - последняя стабильная версия
-- `1.0.10` - текущая версия
+- `1.0.12` - текущая версия
 - `1.0.x` - предыдущие версии
 
 > **💡 Важно:** Перед первым запуском добавьте аккаунт через `npm run auth` или загрузите сессию через Telegram бота.
@@ -238,7 +341,7 @@ docker logs -f qwen-proxy
 ```yaml
 services:
   qwen-proxy:
-    image: endykaufman/qwen-api-proxy:1.0.10
+    image: endykaufman/qwen-api-proxy:1.0.12
     container_name: qwen-proxy
     env_file:
       - .env
@@ -293,7 +396,7 @@ docker run -d \
   -v $(pwd)/logs:/app/logs \
   -v $(pwd)/uploads:/app/uploads \
   -v $(pwd)/temp:/app/temp \
-  endykaufman/qwen-api-proxy:1.0.10
+  endykaufman/qwen-api-proxy:1.0.12
 ```
 
 Файл `docker-compose.yml`:
@@ -302,7 +405,7 @@ docker run -d \
 services:
   qwen-proxy:
     build: .
-    image: endykaufman/qwen-api-proxy:1.0.10
+    image: endykaufman/qwen-api-proxy:1.0.12
     container_name: qwen-proxy
     env_file:
       - .env  # Автоматическая загрузка переменных

package/bin/qwen-api-proxy.js

@@ -10,7 +10,7 @@
  * 4. Passes control to the main index.js
  */
 
-import { fileURLToPath } from 'url';
+import { fileURLToPath, pathToFileURL } from 'url';
 import path from 'path';
 import fs from 'fs';
 import { execSync } from 'child_process';
@@ -151,15 +151,40 @@ npm-debug.log*
 }
 
 /**
- * Check if zip is available
+ * Check if zip is available (cross-platform)
  */
 function checkDependencies() {
+    const isWindows = process.platform === 'win32';
+    
     try {
-        execSync('zip --version', { stdio: 'ignore' });
-        console.log('   ✓ zip command available');
+        // On Windows, check for zip.exe or 7z.exe
+        if (isWindows) {
+            try {
+                execSync('zip --version', { stdio: 'ignore' });
+                console.log('   ✓ zip command available');
+                return;
+            } catch (e) {
+                // Try 7z as alternative
+                try {
+                    execSync('7z --help', { stdio: 'ignore' });
+                    console.log('   ✓ 7z command available (alternative to zip)');
+                    return;
+                } catch (e2) {
+                    // Neither available
+                }
+            }
+            console.warn('   ⚠️  zip/7z command not found (required for archive command)');
+            console.warn('      Install with: choco install zip or download 7-Zip from 7-zip.org');
+        } else {
+            // Unix-like systems (Linux, macOS)
+            execSync('zip --version', { stdio: 'ignore' });
+            console.log('   ✓ zip command available');
+        }
     } catch (error) {
-        console.warn('   ⚠️  zip command not found (required for archive command)');
-        console.warn('      Install with: sudo apt install zip (Ubuntu) or brew install zip (macOS)');
+        if (!isWindows) {
+            console.warn('   ⚠️  zip command not found (required for archive command)');
+            console.warn('      Install with: sudo apt install zip (Ubuntu) or brew install zip (macOS)');
+        }
     }
 }
 
@@ -184,6 +209,17 @@ function setup() {
     checkDependencies();
     
     console.log('\n✅ Working directory setup complete!\n');
+    console.log('📝 Next steps for first-time users:');
+    console.log('   1. Add an account: qwen-api-proxy (or npx qwen-api-proxy)');
+    console.log('      - Select "1 - Add new account"');
+    console.log('      - Browser will open for authentication');
+    console.log('      - Login to Qwen and press ENTER in console');
+    console.log('   2. Create archive: qwen-api-proxy archive');
+    console.log('   3. Start server: qwen-api-proxy');
+    console.log('\n💡 Alternative: Use Telegram bot to upload session files');
+    console.log('   - Configure TELEGRAM_BOT_TOKEN in .env file');
+    console.log('   - Send session archive to the bot');
+    console.log('\n');
     
     // Show warnings for missing .gitignore entries
     if (missingGitignoreDirs.length > 0) {
@@ -256,12 +292,34 @@ if (command === 'doctor') {
         issues.push(`Node.js ${nodeVersion} (✗ requires >= 18)`);
     }
     
-    // Check zip command
+    // Check zip command (cross-platform)
+    const isWindows = process.platform === 'win32';
+    let zipAvailable = false;
     try {
-        execSync('zip --version', { stdio: 'ignore' });
-        ok.push('zip command available');
+        if (isWindows) {
+            try {
+                execSync('zip --version', { stdio: 'ignore' });
+                zipAvailable = true;
+            } catch (e) {
+                try {
+                    execSync('7z --help', { stdio: 'ignore' });
+                    zipAvailable = true; // 7z can work as alternative
+                } catch (e2) {
+                    // Neither available
+                }
+            }
+        } else {
+            execSync('zip --version', { stdio: 'ignore' });
+            zipAvailable = true;
+        }
     } catch (error) {
-        warnings.push('zip command not found (required for archive command)');
+        // zip not available
+    }
+    
+    if (zipAvailable) {
+        ok.push('zip/7z command available');
+    } else {
+        warnings.push('zip/7z command not found (required for archive command)');
     }
     
     // Check working directory structure
@@ -358,22 +416,56 @@ if (command === 'doctor') {
         warnings.push('No accounts configured yet');
     }
     
-    // Check disk space
+    // Check disk space (cross-platform)
     try {
-        const dfOutput = execSync('df -k .', { encoding: 'utf8' });
-        const lines = dfOutput.split('\n');
-        if (lines.length >= 2) {
-            const parts = lines[1].split(/\s+/);
-            const availableKB = parseInt(parts[3]);
-            const availableGB = (availableKB / 1024 / 1024).toFixed(2);
-            if (availableGB > 1) {
-                ok.push(`Disk space: ${availableGB} GB available`);
-            } else {
-                warnings.push(`Low disk space: ${availableGB} GB available`);
+        if (isWindows) {
+            // Use PowerShell or wmic on Windows
+            try {
+                const wmicOutput = execSync('wmic logicaldisk where "DeviceID=\'C:\'" get FreeSpace /value', { encoding: 'utf8' });
+                const match = wmicOutput.match(/FreeSpace=(\d+)/);
+                if (match) {
+                    const availableBytes = parseInt(match[1]);
+                    const availableGB = (availableBytes / 1024 / 1024 / 1024).toFixed(2);
+                    if (availableGB > 1) {
+                        ok.push(`Disk space: ${availableGB} GB available`);
+                    } else {
+                        warnings.push(`Low disk space: ${availableGB} GB available`);
+                    }
+                }
+            } catch (e) {
+                // wmic might not be available, try PowerShell
+                try {
+                    const psOutput = execSync('powershell -Command "(Get-PSDrive C).Free"', { encoding: 'utf8' });
+                    const freeBytes = parseInt(psOutput.trim());
+                    if (!isNaN(freeBytes)) {
+                        const availableGB = (freeBytes / 1024 / 1024 / 1024).toFixed(2);
+                        if (availableGB > 1) {
+                            ok.push(`Disk space: ${availableGB} GB available`);
+                        } else {
+                            warnings.push(`Low disk space: ${availableGB} GB available`);
+                        }
+                    }
+                } catch (e2) {
+                    // Skip disk check on Windows if commands fail
+                }
+            }
+        } else {
+            // Unix-like systems
+            const dfOutput = execSync('df -k .', { encoding: 'utf8' });
+            const lines = dfOutput.split('\n');
+            if (lines.length >= 2) {
+                const parts = lines[1].split(/\s+/);
+                const availableKB = parseInt(parts[3]);
+                const availableGB = (availableKB / 1024 / 1024).toFixed(2);
+                if (availableGB > 1) {
+                    ok.push(`Disk space: ${availableGB} GB available`);
+                } else {
+                    warnings.push(`Low disk space: ${availableGB} GB available`);
+                }
             }
         }
     } catch (error) {
-        // df not available, skip
+        // df/wmic not available, skip
     }
     
     // Print results
@@ -411,4 +503,7 @@ if (needsSetup) {
 process.env.QWEN_API_PROXY_GLOBAL = 'true';
 
 // Import and run the main application
-await import(path.join(PACKAGE_ROOT, 'index.js'));
+// Convert path to file:// URL for cross-platform ESM compatibility
+const indexPath = path.join(PACKAGE_ROOT, 'index.js');
+const indexUrl = pathToFileURL(indexPath).href;
+await import(indexUrl);

package/index.js

@@ -108,13 +108,14 @@ async function handleShutdown() {
 }
 
 /**
- * Создает ZIP архив папки session/
+ * Создает ZIP архив папки session/ (cross-platform)
  */
 function createSessionArchive() {
     const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
     const archiveName = `session_backup_${timestamp}.zip`;
     const archivePath = path.resolve(process.cwd(), archiveName);
     const sessionPath = path.resolve(process.cwd(), SESSION_DIR);
+    const isWindows = process.platform === 'win32';
 
     console.log('\n📦 Создание архива сессии...');
     console.log(`📂 Путь к сессии: ${sessionPath}`);
@@ -132,10 +133,52 @@ function createSessionArchive() {
             throw new Error('Папка сессии пуста. Сначала выполните авторизацию.');
         }
 
-        // Создаем ZIP архив
-        const command = `cd "${process.cwd()}" && zip -r "${archiveName}" "${SESSION_DIR}/"`;
-        logInfo(`Выполнение команды: ${command}`);
-        execSync(command, { stdio: 'inherit' });
+        // Проверяем, есть ли реальные данные (accounts, tokens.json, и т.д.)
+        const hasAccounts = fs.existsSync(path.join(sessionPath, 'accounts')) && 
+                           fs.readdirSync(path.join(sessionPath, 'accounts')).length > 0;
+        const hasTokens = fs.existsSync(path.join(sessionPath, 'tokens.json'));
+        
+        if (!hasAccounts && !hasTokens) {
+            throw new Error('Папка сессии не содержит данных аккаунтов.');
+        }
+
+        // Показываем статистику
+        console.log('\n📊 Найденные данные:');
+        if (hasAccounts) {
+            const accounts = fs.readdirSync(path.join(sessionPath, 'accounts'));
+            console.log(`   ✓ Аккаунты: ${accounts.length} (${accounts.join(', ')})`);
+        }
+        if (hasTokens) {
+            try {
+                const tokens = JSON.parse(fs.readFileSync(path.join(sessionPath, 'tokens.json'), 'utf8'));
+                console.log(`   ✓ Токены: ${Array.isArray(tokens) ? tokens.length : 0} записей`);
+            } catch (e) {
+                console.log('   ⚠ tokens.json не удалось прочитать');
+            }
+        }
+
+        // Создаем ZIP архив (cross-platform)
+        let command;
+        if (isWindows) {
+            // Try zip first, fallback to PowerShell Compress-Archive
+            try {
+                command = `cd /d "${process.cwd()}" && zip -r "${archiveName}" "${SESSION_DIR}"`;
+                logInfo(`Выполнение команды: ${command}`);
+                execSync(command, { stdio: 'inherit' });
+            } catch (zipError) {
+                // Fallback to PowerShell Compress-Archive
+                logInfo('zip не найден, используем PowerShell Compress-Archive');
+                const psCommand = `Compress-Archive -Path "${sessionPath}" -DestinationPath "${archivePath}" -Force`;
+                command = `powershell -Command "${psCommand}"`;
+                logInfo(`Выполнение команды: ${command}`);
+                execSync(command, { stdio: 'inherit' });
+            }
+        } else {
+            // Unix-like systems (Linux, macOS)
+            command = `cd "${process.cwd()}" && zip -r "${archiveName}" "${SESSION_DIR}/"`;
+            logInfo(`Выполнение команды: ${command}`);
+            execSync(command, { stdio: 'inherit' });
+        }
 
         // Проверяем создание архива
         if (!fs.existsSync(archivePath)) {
@@ -215,6 +258,68 @@ async function handleCLICommand() {
         console.log('╚══════════════════════════════════════════════════════════╝\n');
 
         try {
+            // Проверяем, есть ли уже аккаунты
+            const tokensPath = path.join(process.cwd(), SESSION_DIR, 'tokens.json');
+            const accountsPath = path.join(process.cwd(), SESSION_DIR, ACCOUNTS_DIR);
+            
+            let hasAccounts = false;
+            
+            if (fs.existsSync(tokensPath)) {
+                try {
+                    const tokens = JSON.parse(fs.readFileSync(tokensPath, 'utf8'));
+                    if (Array.isArray(tokens) && tokens.length > 0) {
+                        hasAccounts = true;
+                    }
+                } catch (e) {
+                    // tokens.json corrupted
+                }
+            }
+            
+            if (!hasAccounts && fs.existsSync(accountsPath)) {
+                const accounts = fs.readdirSync(accountsPath);
+                if (accounts.length > 0) {
+                    hasAccounts = true;
+                }
+            }
+            
+            // Если аккаунтов нет, предлагаем добавить
+            if (!hasAccounts) {
+                console.log('📝 Аккаунты не найдены. Необходимо добавить аккаунт перед созданием архива.\n');
+                console.log('🔹 Вариант 1: Добавить аккаунт сейчас (откроется браузер)');
+                console.log('🔹 Вариант 2: Отправить файл сессии через Telegram бота');
+                console.log('🔹 Вариант 3: Выйти и запустить вручную: npx qwen-api-proxy\n');
+                
+                const { prompt } = await import('./src/utils/prompt.js');
+                const choice = await prompt('Ваш выбор (1/2/3, Enter = 1): ');
+                
+                if (choice === '2') {
+                    console.log('\n💡 Для использования Telegram бота:');
+                    console.log('   1. Добавьте TELEGRAM_BOT_TOKEN в .env файл');
+                    console.log('   2. Запустите: npx qwen-api-proxy');
+                    console.log('   3. Отправьте файл сессии боту\n');
+                    process.exit(0);
+                } else if (choice === '3') {
+                    console.log('\n👋 Выход. Запустите "npx qwen-api-proxy" для добавления аккаунта.\n');
+                    process.exit(0);
+                }
+                
+                // choice === '1' или Enter - добавляем аккаунт
+                console.log('\n🔐 Запуск браузера для добавления аккаунта...\n');
+                
+                const { addAccountInteractive } = await import('./src/utils/accountSetup.js');
+                const accountId = await addAccountInteractive();
+                
+                if (!accountId) {
+                    console.log('\n❌ Аккаунт не был добавлен. Архив не создан.\n');
+                    process.exit(1);
+                }
+                
+                console.log(`\n✅ Аккаунт ${accountId} успешно добавлен!\n`);
+            } else {
+                console.log('✅ Найден существующий аккаунт\n');
+            }
+            
+            // Теперь создаем архив
             const archivePath = createSessionArchive();
             console.log('\n🎉 ГОТОВО!');
             console.log(`📄 Архив: ${archivePath}`);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "qwen-api-proxy",
-    "version": "1.0.10",
+    "version": "1.0.12",
     "description": "Proxy server for accessing Qwen API through browser emulation with OpenAI-compatible API and Telegram bot",
     "license": "MIT",
     "author": {
@@ -45,6 +45,7 @@
         "start": "node index.js",
         "archive": "node index.js archive",
         "test": "echo \"Error: no test specified\" && exit 1",
+        "test:cross-platform": "node test-cross-platform.js",
         "check-permissions": "node scripts/checkPermissions.js",
         "fix-permissions": "bash fix-permissions.sh",
         "rebuild-tokens": "node scripts/rebuildTokens.js",