# 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

## 安装与启动

### 方式一：手动

```bash
# 安装依赖
pnpm install
# 或
npm install

# 安装 Playwright 浏览器
npx playwright install chromium

# 启动服务
node server.js
```

启动后访问 [http://localhost:3001](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/`（不纳入版本控制）

## 项目知识库

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