Gemini Go Web - Node.js 版 (精简版)

Google 账号自动化管理工具，基于 Node.js + Express + Playwright 构建的 Web 版本。

功能

• Google 账号管理（批量导入、查看、删除）
• 自动登录 / 2FA 绑定 / 2FA 更换
• 密码修改 / 重置
• 检查 GCP (Google Cloud Platform) 限制及状态
• 提取凭证 / Captcha 登录
• 代理配置
• 截图记录操作过程
• SSE 实时日志推送

目录结构

nodejs-app/
├── server.js          # Express 服务器入口
├── src/
│   ├── core/          # 核心模块（配置、数据库、SSE）
│   ├── routes/        # API 路由
│   ├── services/      # 业务逻辑服务
│   ├── workers/       # 后台任务
│   └── utils/         # 工具函数
├── public/            # 前端静态资源
└── data/
    └── screenshots/   # 操作截图（自动生成，不纳入版本控制）

环境要求

• Node.js >= 18.0.0
• pnpm（推荐）或 npm

安装与启动

方式一：手动

# 安装依赖
pnpm install
# 或
npm install

# 安装 Playwright 浏览器
npx playwright install chromium

# 启动服务
node server.js

启动后访问 http://localhost:3001

端口由 src/core/config.js 中的 PORT 决定（当前为 3001），也可用环境变量 PORT 临时覆盖。 启动程序.bat 会自动读取该端口并打开对应地址，修改端口时只需改 config.js 一处。

方式二：Windows 批处理

双击运行 安装依赖.bat 完成依赖安装，然后双击 启动程序.bat 启动服务。

启动程序.bat 会：结束占用端口的旧 node 进程 → 启动服务器（窗口标题 "Gemini Go Server"，最小化）→ 等待端口就绪 → 自动打开浏览器。 若 30 秒内未就绪，会提示到 "Gemini Go Server" 窗口查看报错（该窗口在出错时不会自动关闭）。

浏览器自动化功能依赖本机运行的「比特浏览器」（本地接口 127.0.0.1:54345）。服务器本身不需要它即可启动，但执行"打开浏览器"等任务前必须先启动比特浏览器，否则日志会出现 ECONNREFUSED 127.0.0.1:54345。

主要依赖

包	用途
express	Web 服务器框架
better-sqlite3	本地 SQLite 数据库
playwright	浏览器自动化
axios	HTTP 请求
otpauth	TOTP/2FA 验证码生成
uuid	唯一 ID 生成

API 路由

路径	说明
/api/accounts	账号 CRUD
/api/settings	系统设置（代理等）
/api/operations	自动化操作执行
/screenshots/*	操作截图静态访问

数据存储

• 数据库：data/accounts.db（SQLite，不纳入版本控制）
• 截图：data/screenshots/（不纳入版本控制）

项目知识库

充值、套餐查询、退款、飞书同步、定时任务、状态机和故障经验见 知识库总索引。知识库只保存可复用的工程事实，不保存账号、令牌、代理凭据、卡密或运行数据。