feat: add usage count

.env.example

@@ -134,6 +134,12 @@ FORCE_URL_CONTEXT=false
 # Default: true
 ENABLE_AUTH_UPDATE=true
 
+# Enable request usage statistics
+# When disabled, the service will not load local stats, will not write stats,
+# and /api/usage-stats will return an empty payload
+# Default: true
+ENABLE_USAGE_STATS=true
+
 # ===================================
 # Account Switching Configuration
 # ===================================

.gitignore

@@ -27,8 +27,12 @@ auth-*.json
 users.csv
 cache/
 
+# Usage statistics data
+data/
+
 # Temporary files
 tmp/
+temp/
 ui/dist/
 *.css
 test/

README.md

@@ -50,6 +50,7 @@
    API 服务将在 `http://localhost:7860` 上运行。
 
    服务启动后，您可以在浏览器中访问 `http://localhost:7860` 打开 Web 控制台主页，在这里可以查看账号状态和服务状态。
+   请求统计数据会持久化保存到 `/data/usage-stats.jsonl`。
 
 5. 更新到最新版本（已有本地部署时）：
 
@@ -73,6 +74,7 @@ docker run -d \
   --name aistudio-to-api \
   -p 7860:7860 \
   -v /path/to/auth:/app/configs/auth \
+  -v /path/to/data:/app/data \
   -e API_KEYS=your-api-key-1,your-api-key-2 \
   -e TZ=Asia/Shanghai \
   --restart unless-stopped \
@@ -83,8 +85,9 @@ docker run -d \
 
 参数说明：
 
-- `-p 7860:7860`：API 服务器端口（如果使用反向代理，强烈建议改成 127.0.0.1:7860）
+- `-p 7860:7860`：API 服务器端口（如果使用反向代理，强烈建议改成 `127.0.0.1:7860`）
 - `-v /path/to/auth:/app/configs/auth`：挂载包含认证文件的目录
+- `-v /path/to/data:/app/data`：挂载统计数据持久化目录（`/app/data/usage-stats.jsonl`）
 - `-e API_KEYS`：用于身份验证的 API 密钥列表（使用逗号分隔）
 - `-e TZ=Asia/Shanghai`：时区设置（可选，默认使用系统时区）
 
@@ -106,6 +109,8 @@ services:
     volumes:
       # 挂载包含认证文件的目录
       - ./auth:/app/configs/auth
+      # 挂载统计数据持久化目录
+      - ./data:/app/data
     environment:
       # 用于身份验证的 API 密钥列表（使用逗号分隔）
       API_KEYS: your-api-key-1,your-api-key-2
@@ -132,6 +137,7 @@ services:
      --name aistudio-to-api \
      -p 7860:7860 \
      -v /path/to/auth:/app/configs/auth \
+     -v /path/to/data:/app/data \
      -e API_KEYS=your-api-key-1,your-api-key-2 \
      -e TZ=Asia/Shanghai \
      --restart unless-stopped \
@@ -235,6 +241,7 @@ services:
 | :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------- |
 | `INITIAL_AUTH_INDEX`            | 启动时使用的初始身份验证索引。                                                                                                                                      | `0`       |
 | `ENABLE_AUTH_UPDATE`            | 是否启用自动保存凭证更新。默认为启用状态，将在每次登录/切换账号成功时以及每 24 小时自动更新 auth 文件。设为 `false` 禁用。                                          | `true`    |
+| `ENABLE_USAGE_STATS`            | 是否启用请求统计。默认为启用；设为 `false` 后，不读取本地统计、不写入统计，`/api/usage-stats` 返回空数据。                                                          | `true`    |
 | `MAX_RETRIES`                   | 请求失败后的最大重试次数（仅对假流式和非流式生效）。                                                                                                                | `3`       |
 | `RETRY_DELAY`                   | 两次重试之间的间隔（毫秒）。                                                                                                                                        | `2000`    |
 | `SWITCH_ON_USES`                | 自动切换帐户前允许的请求次数（设为 `0` 禁用）。                                                                                                                     | `40`      |

README_EN.md

@@ -50,6 +50,7 @@ A tool that wraps Google AI Studio web interface to provide OpenAI API, Gemini A
    The API server will be available at `http://localhost:7860`
 
    After the service starts, you can access `http://localhost:7860` in your browser to open the web console homepage, where you can view account status and service status.
+   Request usage statistics are persisted locally at `/data/usage-stats.jsonl`.
 
 5. Update to the latest version (for existing local deployments):
 
@@ -73,6 +74,7 @@ docker run -d \
   --name aistudio-to-api \
   -p 7860:7860 \
   -v /path/to/auth:/app/configs/auth \
+  -v /path/to/data:/app/data \
   -e API_KEYS=your-api-key-1,your-api-key-2 \
   -e TZ=America/New_York \
   --restart unless-stopped \
@@ -85,6 +87,7 @@ Parameters:
 
 - `-p 7860:7860`: API server port (if using a reverse proxy, strongly consider `127.0.0.1:7860`)
 - `-v /path/to/auth:/app/configs/auth`: Mount directory containing auth files
+- `-v /path/to/data:/app/data`: Mount persistent data directory for usage statistics (`/app/data/usage-stats.jsonl`)
 - `-e API_KEYS`: Comma-separated list of API keys for authentication
 - `-e TZ=America/New_York`: Timezone for logs (optional, defaults to system timezone)
 
@@ -106,6 +109,8 @@ services:
     volumes:
       # Mount directory containing auth files
       - ./auth:/app/configs/auth
+      # Mount persistent data directory for usage statistics
+      - ./data:/app/data
     environment:
       # Comma-separated list of API keys for authentication
       API_KEYS: your-api-key-1,your-api-key-2
@@ -130,6 +135,7 @@ If you prefer to build the Docker image yourself, you can use the following comm
      --name aistudio-to-api \
      -p 7860:7860 \
      -v /path/to/auth:/app/configs/auth \
+     -v /path/to/data:/app/data \
      -e API_KEYS=your-api-key-1,your-api-key-2 \
      -e TZ=America/New_York \
      --restart unless-stopped \
@@ -233,6 +239,7 @@ This endpoint forwards requests to the official Gemini API format endpoint.
 | :------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------- |
 | `INITIAL_AUTH_INDEX`            | Initial authentication index to use on startup.                                                                                                                                                                                                                       | `0`       |
 | `ENABLE_AUTH_UPDATE`            | Whether to enable automatic auth credential updates. Defaults to enabled. The auth file will be automatically updated upon successful login/account switch and every 24 hours. Set to `false` to disable.                                                             | `true`    |
+| `ENABLE_USAGE_STATS`            | Whether to enable request usage statistics. Defaults to enabled. Set to `false` to skip loading local stats, skip writing stats, and make `/api/usage-stats` return an empty payload.                                                                                 | `true`    |
 | `MAX_RETRIES`                   | Maximum number of retries for failed requests (only effective for fake streaming and non-streaming).                                                                                                                                                                  | `3`       |
 | `RETRY_DELAY`                   | Delay between retries in milliseconds.                                                                                                                                                                                                                                | `2000`    |
 | `SWITCH_ON_USES`                | Number of requests before automatically switching accounts (`0` to disable).                                                                                                                                                                                          | `40`      |

docs/en/claw-cloud-run.md

@@ -22,8 +22,12 @@ This guide will help you deploy the `aistudio-to-api` service on [Claw Cloud Run
    - **Public Access**: Toggle **On** (Leave the URL usage as is).
 
    **Local Storage**:
-   - **Capacity**：1
-   - **Mount Path**：/app/configs/auth
+   - **Storage 1**
+     - **Capacity**：1
+     - **Mount Path**：/app/configs/auth
+   - **Storage 2**
+     - **Capacity**：1
+     - **Mount Path**：/app/data
 
    **Environment Variables**:
 

docs/zh/claw-cloud-run.md

@@ -22,8 +22,12 @@
    - **Public Access**：开启（Toggle **On**，后面的网址选项不用动）。
 
    **Local Storage**:
-   - **Capacity**：1
-   - **Mount Path**：/app/configs/auth
+   - **存储卷 1**
+     - **Capacity**：1
+     - **Mount Path**：/app/configs/auth
+   - **存储卷 2**
+     - **Capacity**：1
+     - **Mount Path**：/app/data
 
    **环境变量（Environment Variables）**:
 

src/core/ProxyServerSystem.js

@@ -12,13 +12,15 @@ const http = require("http");
 const https = require("https");
 const fs = require("fs");
 const net = require("net");
+const path = require("path");
 const { URL } = require("url");
 
 const LoggingService = require("../utils/LoggingService");
 const AuthSource = require("../auth/AuthSource");
 const BrowserManager = require("./BrowserManager");
 const ConnectionRegistry = require("./ConnectionRegistry");
 const RequestHandler = require("./RequestHandler");
+const UsageStatsService = require("./UsageStatsService");
 const ConfigLoader = require("../utils/ConfigLoader");
 const WebRoutes = require("../routes/WebRoutes");
 
@@ -40,6 +42,12 @@ class ProxyServerSystem extends EventEmitter {
 
         this.authSource = new AuthSource(this.logger);
         this.browserManager = new BrowserManager(this.logger, this.config, this.authSource);
+        this.usageStatsService = new UsageStatsService(
+            this.authSource,
+            this.logger,
+            path.join(process.cwd(), "data"),
+            this.config.enableUsageStats
+        );
 
         // Create ConnectionRegistry with lightweight reconnect callback
         // When WebSocket connection is lost but browser is still running,
@@ -351,6 +359,7 @@ class ProxyServerSystem extends EventEmitter {
         app.use((req, res, next) => {
             if (
                 req.path !== "/api/status" &&
+                req.path !== "/api/usage-stats" &&
                 req.path !== "/" &&
                 req.path !== "/favicon.ico" &&
                 req.path !== "/login" &&
@@ -440,7 +449,6 @@ class ProxyServerSystem extends EventEmitter {
         });
 
         // Serve static files from ui/dist (Vite build output)
-        const path = require("path");
         app.use(express.static(path.join(__dirname, "..", "..", "ui", "dist")));
 
         // Serve additional public assets under ui/public