gemini-proxy-client 1.0.11 → 1.0.13

package/README.md

@@ -6,13 +6,13 @@
 
 - **反指纹检测**: 使用 Camoufox (基于 Firefox) 防止 Google 检测多账号
 - **自动登录管理**: 首次需要手动登录，之后自动保持登录状态
+- **自动连接**: 自动点击 "Continue to the app" 和 "Connect WS" 按钮
+- **连接验证**: 自动检测 WebSocket 连接是否成功（按钮文字变为 "Disconnect WS"）
 - **自动保活**: 每 2 小时检查登录状态，断线自动重连
 - **无头运行**: 登录后可在后台无头运行，节省资源
 
 ## 安装
 
-### 方式 1: 从 npm 安装（推荐）
-
 ```bash
 npm install -g gemini-proxy-client
 ```
@@ -23,19 +23,9 @@ npm install -g gemini-proxy-client
 npx camoufox-js fetch
 ```
 
-### 方式 2: 从源码安装
-
-```bash
-git clone https://github.com/user/gemini-proxy-panel.git
-cd gemini-proxy-panel/client
-npm install
-npm run build
-npm link  # 可选，全局安装
-```
-
 ## 使用方法
 
-### 1. 启动客户端
+### 启动客户端
 
 ```bash
 # 连接到代理服务器
@@ -47,17 +37,81 @@ gemini-client start -s wss://your-server.com/v1/ws
 
 **首次运行**会打开浏览器窗口，请登录您的 Google 账号。登录成功后，cookies 会自动保存，之后运行将使用无头模式。
 
-### 2. 指定 Token
+**成功启动**后会显示：
+
+```
+✅ 点击了 "Continue to the app" 按钮
+✅ 点击了连接按钮
+  检测按钮文字: "Disconnect WS"
+✅ WebSocket 连接成功！
+```
+
+### 后台运行
+
+#### 方式 1: 使用 nohup（简单）
 
 ```bash
-# 不指定 token 会自动生成 gp_client_YYYY_MM_DD_HH_mm_ss 格式
-gemini-client start -s wss://your-server.com/v1/ws
+nohup gemini-client start -s wss://your-server.com/v1/ws > gemini-client.log 2>&1 &
+
+# 查看日志
+tail -f gemini-client.log
 
-# 指定自定义 token
-gemini-client start -s wss://your-server.com/v1/ws -t my-custom-token
+# 停止
+kill $(ps aux | grep 'gemini-client start' | grep -v grep | awk '{print $2}')
 ```
 
-### 3. 其他命令
+#### 方式 2: 使用 screen
+
+```bash
+# 安装 screen
+sudo apt-get install screen  # Ubuntu/Debian
+sudo yum install screen      # CentOS/RHEL
+
+# 创建会话并运行
+screen -S gemini
+gemini-client start
+
+# 按 Ctrl+A 然后按 D 分离会话
+# 重新连接: screen -r gemini
+# 查看所有会话: screen -ls
+```
+
+#### 方式 3: 使用 pm2（推荐）
+
+```bash
+# 安装 pm2
+npm install -g pm2
+
+# 启动
+pm2 start "gemini-client start" --name gemini-client
+
+# 查看日志
+pm2 logs gemini-client
+
+# 停止
+pm2 stop gemini-client
+
+# 重启
+pm2 restart gemini-client
+
+# 开机自启
+pm2 startup
+pm2 save
+```
+
+#### 方式 4: 使用 Xvfb（无图形界面服务器）
+
+如果是纯命令行服务器，需要安装虚拟显示：
+
+```bash
+# Ubuntu/Debian
+sudo apt-get install xvfb
+
+# 使用 xvfb-run 运行
+nohup xvfb-run gemini-client start -s wss://your-server.com/v1/ws > gemini-client.log 2>&1 &
+```
+
+### 其他命令
 
 ```bash
 # 单独登录 Google 账号
@@ -77,42 +131,14 @@ gemini-client --help
 
 ### start - 启动客户端
 
-```bash
-gemini-client start [options]
-```
-
 | 选项 | 说明 | 默认值 |
 |------|------|--------|
 | `-s, --server <url>` | 代理服务器 WebSocket 地址 | `ws://localhost:5345/v1/ws` |
-| `-t, --token <token>` | 客户端认证令牌 | 自动生成 |
+| `-t, --token <token>` | 客户端认证令牌 | 自动生成 `gp_client_YYYY_MM_DD_HH_mm_ss` |
 | `-d, --daemon` | 后台运行模式 | false |
 | `--headless` | 强制无头模式 | 自动判断 |
 | `--data-dir <path>` | 数据目录路径 | `~/.gemini-client` |
 
-### login - 登录 Google
-
-```bash
-gemini-client login [options]
-```
-
-打开浏览器让用户登录 Google 账号，保存 cookies 供后续使用。
-
-### status - 查看状态
-
-```bash
-gemini-client status [options]
-```
-
-显示当前登录状态和配置信息。
-
-### logout - 清除登录
-
-```bash
-gemini-client logout [options]
-```
-
-清除保存的 Google 登录 cookies。
-
 ## 数据存储
 
 默认数据目录: `~/.gemini-client/`
@@ -122,10 +148,21 @@ gemini-client logout [options]
 | `cookies.json` | Google 登录 cookies |
 | `config.json` | 配置信息 |
 
+## 工作流程
+
+1. 启动 Camoufox 浏览器
+2. 打开 Build App 页面
+3. 检查 Google 登录状态，未登录则等待用户手动登录
+4. 点击 "Continue to the app" 按钮（如果存在）
+5. 关闭可能遮挡的模态框
+6. 在 Build App iframe 中点击 "Connect WS" 按钮
+7. 验证连接成功（按钮文字变为 "Disconnect WS"）
+8. 启动保活机制（每 2 小时检查登录状态）
+
 ## 保活机制
 
 - **登录状态检查**: 每 2 小时检查一次 Google 登录状态
-- **连接状态检查**: 每 30 秒检查一次 WebSocket 连接
+- **连接状态检查**: 每 30 秒检查一次页面是否正常
 - **自动重连**: 连接断开时自动尝试重新连接
 - **登录过期处理**: 登录过期时会弹出浏览器让用户重新登录
 
@@ -134,39 +171,36 @@ gemini-client logout [options]
 - Node.js >= 18.0.0
 - 能够访问 GitHub（下载 Camoufox 浏览器）
 - 能够访问 Google AI Studio（非中国大陆 IP）
+- 图形界面或 Xvfb（虚拟显示）
 
 ## 常见问题
 
 ### Q: Camoufox 下载失败怎么办？
 
-A: 可能是网络问题，尝试使用代理或手动下载：
+设置代理或手动下载：
 
 ```bash
-# 设置代理
 export https_proxy=http://127.0.0.1:7890
-
-# 重新下载
 npx camoufox-js fetch
 ```
 
 ### Q: Google 登录状态能保持多久？
 
-A: 通常 1-2 周，但可能因以下原因提前失效：
-- IP 地址变化
-- 长时间无活动
-- Google 安全检测
-
-客户端会每 2 小时检查一次，失效时会提示重新登录。
+通常 1-2 周，但可能因 IP 变化、长时间无活动或 Google 安全检测而提前失效。
 
 ### Q: 可以同时运行多个客户端吗？
 
-A: 可以，使用不同的 `--data-dir` 参数：
+可以，使用不同的 `--data-dir` 参数：
 
 ```bash
 gemini-client start -s wss://server.com/v1/ws --data-dir ~/.gemini-client-1
 gemini-client start -s wss://server.com/v1/ws --data-dir ~/.gemini-client-2
 ```
 
+### Q: 如何查看客户端是否连接成功？
+
+启动后查看日志，如果看到 `✅ WebSocket 连接成功！` 和 `检测按钮文字: "Disconnect WS"`，说明连接成功。
+
 ## License
 
 MIT

package/dist/browser/manager.js

@@ -2,7 +2,7 @@ import { Camoufox } from 'camoufox-js';
 import fs from 'fs';
 import path from 'path';
 import chalk from 'chalk';
-import { sleep, formatUptime } from '../utils/helpers.js';
+import { sleep, formatUptime, getRandomFingerprint } from '../utils/helpers.js';
 // Build App URL
 const BUILD_APP_URL = 'https://aistudio.google.com/apps/drive/1JqM2cAKs9japdW99aJwkg2k6GZSeCSHR?showPreview=true&pli=1&showAssistant=true';
 const GOOGLE_LOGIN_URL = 'https://accounts.google.com/';
@@ -28,12 +28,16 @@ export class BrowserManager {
      * 启动浏览器
      */
     async launch() {
+        // 获取随机指纹配置（同一 dataDir 会保持一致）
+        const fingerprint = getRandomFingerprint(this.options.dataDir);
+        console.log(chalk.gray(`指纹配置: ${fingerprint.viewport.width}x${fingerprint.viewport.height}, ${fingerprint.locale}, ${fingerprint.timezoneId}`));
         this.browser = await Camoufox({
             headless: this.options.headless,
         });
         this.context = await this.browser.newContext({
-            viewport: { width: 1280, height: 800 },
-            locale: 'en-US',
+            viewport: fingerprint.viewport,
+            locale: fingerprint.locale,
+            timezoneId: fingerprint.timezoneId,
         });
         // 加载已保存的 cookies
         await this.loadCookies();

package/dist/cli.js

@@ -12,7 +12,7 @@ const program = new Command();
 program
     .name('gemini-client')
     .description('Gemini Proxy Build App 客户端 - 使用 Camoufox 自动保持连接')
-    .version('1.0.11');
+    .version('1.0.13');
 program
     .command('start')
     .description('启动客户端，连接到代理服务器')

package/dist/commands/start.js

@@ -79,7 +79,7 @@ export async function startClient(options) {
     }
     const spinner = ora('启动 Camoufox 浏览器...').start();
     try {
-        const browserManager = new BrowserManager({
+        let browserManager = new BrowserManager({
             headless,
             dataDir,
             serverUrl: server,
@@ -103,14 +103,29 @@ export async function startClient(options) {
             // 保存 cookies
             await browserManager.saveCookies();
             console.log(chalk.green('✅ Google 登录成功！已保存登录状态'));
-            spinner.start('继续连接...');
+            // 关闭有界面的浏览器，以无头模式重新启动
+            console.log(chalk.gray('🔄 切换到无头模式...'));
+            await browserManager.close();
+            // 创建新的无头浏览器实例
+            browserManager = new BrowserManager({
+                headless: true,
+                dataDir,
+                serverUrl: server,
+                token,
+            });
+            // 重新设置信号处理
+            setupSignalHandlers(browserManager);
+            spinner.start('以无头模式重新启动...');
+            await browserManager.launch();
+            spinner.text = '打开 Build App 页面...';
+            await browserManager.openBuildApp();
         }
         // 点击连接按钮
         spinner.text = '点击 ws connect 按钮...';
         await browserManager.clickConnectButton();
         spinner.succeed(chalk.green('已连接到代理服务器！'));
         console.log(chalk.gray('─'.repeat(50)));
-        console.log(chalk.green(`✅ 客户端已启动`));
+        console.log(chalk.green(`✅ 客户端已启动 (无头模式)`));
         console.log(chalk.white(`   Token: ${token}`));
         console.log(chalk.gray('   按 Ctrl+C 退出'));
         console.log(chalk.gray('─'.repeat(50)));

package/dist/utils/helpers.js

@@ -55,3 +55,75 @@ export function formatUptime(startTime) {
 export function sleep(ms) {
     return new Promise(resolve => setTimeout(resolve, ms));
 }
+// 常见的屏幕分辨率
+const VIEWPORTS = [
+    { width: 1920, height: 1080 },
+    { width: 1366, height: 768 },
+    { width: 1536, height: 864 },
+    { width: 1440, height: 900 },
+    { width: 1280, height: 720 },
+    { width: 1600, height: 900 },
+    { width: 1280, height: 800 },
+    { width: 1680, height: 1050 },
+    { width: 1360, height: 768 },
+    { width: 1280, height: 1024 },
+];
+// 常见的语言区域
+const LOCALES = [
+    'en-US',
+    'en-GB',
+    'en-AU',
+    'en-CA',
+    'zh-CN',
+    'zh-TW',
+    'ja-JP',
+    'ko-KR',
+    'de-DE',
+    'fr-FR',
+];
+// 常见的时区
+const TIMEZONES = [
+    'America/New_York',
+    'America/Los_Angeles',
+    'America/Chicago',
+    'Europe/London',
+    'Europe/Paris',
+    'Europe/Berlin',
+    'Asia/Tokyo',
+    'Asia/Shanghai',
+    'Asia/Seoul',
+    'Australia/Sydney',
+];
+/**
+ * 生成随机指纹配置
+ * 如果提供了 dataDir，会尝试加载/保存固定的指纹配置
+ */
+export function getRandomFingerprint(dataDir) {
+    const fingerprintPath = dataDir ? path.join(dataDir, 'fingerprint.json') : null;
+    // 尝试加载已保存的指纹
+    if (fingerprintPath && fs.existsSync(fingerprintPath)) {
+        try {
+            const saved = JSON.parse(fs.readFileSync(fingerprintPath, 'utf-8'));
+            return saved;
+        }
+        catch (e) {
+            // 忽略，生成新的
+        }
+    }
+    // 生成新的随机指纹
+    const fingerprint = {
+        viewport: VIEWPORTS[Math.floor(Math.random() * VIEWPORTS.length)],
+        locale: LOCALES[Math.floor(Math.random() * LOCALES.length)],
+        timezoneId: TIMEZONES[Math.floor(Math.random() * TIMEZONES.length)],
+    };
+    // 保存指纹以便下次使用（同一账号应该保持一致的指纹）
+    if (fingerprintPath) {
+        try {
+            fs.writeFileSync(fingerprintPath, JSON.stringify(fingerprint, null, 2));
+        }
+        catch (e) {
+            // 忽略保存错误
+        }
+    }
+    return fingerprint;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gemini-proxy-client",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "description": "Gemini Proxy Build App 客户端 - 使用 Camoufox 自动保持连接",
   "main": "dist/index.js",
   "bin": {