Rewrite README

README.md

@@ -1,85 +1,43 @@
-# Autoreg - Python Backend
+# Autoreg (Kiro Account Manager)
 
-Бэкенд для автоматической регистрации AWS Builder ID аккаунтов и управления Kiro.
+用于管理 Kiro 账号、配额与自动注册的 Python 后端与 Web 管理界面。包含 FastAPI 服务、CLI、自动化注册与调试工具。
 
-## Структура
+## 主要功能
+
+- Web 管理面板（FastAPI + WebSocket）
+- 账号/配额/Token 管理
+- 自动注册与多种邮箱策略
+- 防指纹与浏览器伪装模块
+- 调试与抓包分析工具
+- 可选 LLM API 兼容服务
+
+## 目录结构
 
 ```
 autoreg/
-├── core/                 # Базовые утилиты
-│   ├── config.py         # Конфигурация из JSON/env
-│   ├── paths.py          # Пути к файлам
-│   ├── exceptions.py     # Исключения
-│   └── email_generator.py # Генерация email по стратегиям
-│
-├── registration/         # Логика регистрации
-│   ├── browser.py        # Browser automation (DrissionPage)
-│   ├── mail_handler.py   # IMAP для получения кодов
-│   ├── oauth_device.py   # OAuth Device Flow
-│   ├── oauth_pkce.py     # OAuth PKCE Flow
-│   ├── register.py       # Главный оркестратор
-│   └── register_auto.py  # Авто-регистрация с email стратегиями
-│
-├── spoofers/             # Anti-fingerprint модули (20+)
-│   ├── cdp_spoofer.py    # CDP-based spoofing
-│   ├── navigator.py      # Navigator spoofing
-│   ├── canvas.py         # Canvas fingerprint
-│   ├── webgl.py          # WebGL fingerprint
-│   ├── audio.py          # Audio fingerprint
-│   ├── screen.py         # Screen resolution
-│   ├── timezone.py       # Timezone sync
-│   ├── fonts.py          # Font list
-│   ├── behavior.py       # Human-like behavior
-│   └── ...               # И другие
-│
-├── services/             # Сервисы для Kiro
-│   ├── kiro_patcher_service.py  # Патчинг extension.js
-│   ├── kiro_service.py          # Управление Kiro IDE
-│   ├── token_service.py         # CRUD токенов
-│   ├── quota_service.py         # Отслеживание usage
-│   ├── machine_id_service.py    # Machine ID rotation
-│   └── sso_import_service.py    # Импорт из SSO cookie
-│
-├── debugger/             # Инструменты отладки
-│   ├── collectors/       # Network, DOM, Cookies, Console, CDP
-│   ├── analyzers/        # Request, Timing, Fingerprint, Redirect
-│   ├── exporters/        # JSON, HAR, HTML
-│   ├── core.py           # DebugSession class
-│   └── run.py            # Запуск debug сессии
-│
-├── llm/                  # LLM API Server
-│   ├── llm_server.py     # FastAPI OpenAI-compatible server
-│   ├── token_pool.py     # Token pool management
-│   ├── codewhisperer_client.py  # AWS API client
-│   └── run_llm_server.py # Entry point
-│
-├── app/                  # Standalone Web App
-│   ├── main.py           # FastAPI entry point
-│   ├── websocket.py      # WebSocket handler
-│   └── api/              # REST API endpoints
-│
-├── scripts/              # Dev утилиты
-│   ├── test_fingerprint.py
-│   ├── test_strategy.py
-│   └── ...
-│
-├── cli.py                # CLI entry point
-├── run.py                # Standalone app entry point
-├── spoof.py              # Фасад для spoofers
-└── requirements.txt      # Python зависимости
+  app/                  # Web App (FastAPI)
+  core/                 # 核心配置与工具
+  registration/         # 注册与 OAuth 流程
+  spoofers/             # 指纹伪装模块
+  services/             # 业务服务层
+  debugger/             # 调试/抓包分析
+  llm/                  # LLM API Server
+  scripts/              # 开发脚本
+  cli.py                # CLI 入口
+  run.py                # Web App 入口
 ```
 
-## Быстрый старт
+## 快速开始
 
-### Установка зависимостей
+### 1) 安装依赖
 
 ```bash
 pip install -r requirements.txt
 ```
 
-### Настройка
+### 2) 配置环境变量
 
-Создай `.env` файл:
+复制 `.env.example` 为 `.env`，按需填写：
 
 ```env
 # IMAP
@@ -87,139 +45,78 @@ IMAP_SERVER=imap.gmail.com
 IMAP_USER=your@gmail.com
 IMAP_PASSWORD=app-password
 
-# Email стратегия: single, plus_alias, catch_all, pool
+# Email 策略: single, plus_alias, catch_all, pool
 EMAIL_STRATEGY=plus_alias
 
-# Для catch_all
+# catch_all
 EMAIL_DOMAIN=mydomain.com
 
-# Для pool
+# pool
 EMAIL_POOL=["user1@mail.ru", "user2@mail.ru:password"]
 ```
 
-## Запуск
+### 3) 启动 Web App
+
+```bash
+python run.py
+# 默认访问 http://127.0.0.1:8420
+```
+
+## 常用命令
 
 ### CLI
 
 ```bash
-# Статус системы
 python cli.py status
-
-# Список токенов
 python cli.py tokens list
-
-# Переключить аккаунт
 python cli.py tokens switch <name>
-
-# Квоты всех аккаунтов
 python cli.py quota --all
-
-# Статус патча
 python cli.py patch status
-
-# Применить патч
 python cli.py patch apply
-
-# Сгенерировать новый Machine ID
 python cli.py patch generate-id
-
-# Импорт из SSO cookie
 python cli.py sso-import <cookie> -a
 ```
 
-### Регистрация
+### 自动注册
 
 ```bash
-# Авто-регистрация (использует EMAIL_STRATEGY)
 python -m registration.register_auto
-
-# С конкретным email
 python -m registration.register --email user@domain.com
-
-# Batch (5 аккаунтов)
 python -m registration.register --count 5
-
-# Headless
 python -m registration.register --email user@domain.com --headless
 ```
 
-### Standalone Web App
-
-```bash
-python run.py
-# Открыть http://127.0.0.1:8420
-```
-
 ### LLM API Server
 
 ```bash
 python -m llm.run_llm_server
-# API на http://127.0.0.1:8421
+# 默认 http://127.0.0.1:8421
 ```
 
 ### Debug Session
 
 ```bash
 python -m debugger.run
-# Результаты в debug_sessions/
+# 输出到 debug_sessions/
 ```
 
-## Email стратегии
-
-| Стратегия | Описание | Пример |
-|-----------|----------|--------|
-| `single` | Один email = один аккаунт | `user@gmail.com` |
-| `plus_alias` | Gmail/Outlook алиасы | `user+kiro123@gmail.com` |
-| `catch_all` | Catch-all домен | `random123@mydomain.com` |
-| `pool` | Пул готовых email'ов | `["user1@mail.ru", "user2@mail.ru:password"]` |
-
-## Anti-Fingerprint
-
-Встроенные модули спуфинга:
+## 邮箱策略说明
 
-- Canvas, WebGL, Audio fingerprint
-- Navigator (userAgent, platform, languages)
-- Screen resolution
-- Timezone (синхронизация с IP)
-- WebRTC (скрытие локального IP)
-- Fonts list
-- Behavior (человеческие задержки)
+| 策略 | 说明 | 示例 |
+|------|------|------|
+| `single` | 单邮箱 | `user@gmail.com` |
+| `plus_alias` | Plus 别名 | `user+abc@gmail.com` |
+| `catch_all` | 域名 Catch-all | `any@domain.com` |
+| `pool` | 邮箱池 | `["a@mail.ru", "b@mail.ru:pass"]` |
 
-Профили сохраняются для каждого email в `~/.kiro-manager-wb/profiles/`.
+## 数据与隐私
 
-## Конфигурация
+- 本地数据默认保存在 `~/.kiro-manager-wb/`
+- 敏感信息请放入 `.env`，不要提交到仓库
+- 建议开启 `.gitignore` 保护 `accounts/`、`tokens/`、日志等
 
-Настройки в `~/.kiro-manager-wb/config.json` или через `.env`.
+## 依赖说明
 
-### Основные параметры
+- FastAPI + Uvicorn 用于 Web 服务
+- DrissionPage 用于浏览器自动化（需要系统浏览器）
 
-```python
-# Browser
-browser.headless = False
-browser.realistic_typing = True
-browser.human_delays = True
-
-# Timeouts
-timeouts.page_load = 2
-timeouts.element_wait = 1
-timeouts.verification_code = 60
-timeouts.allow_access_wait = 90
-
-# Debug
-debug.verbose = False
-debug.save_html_on_error = False
-```
-
-## Данные
-
-Все данные в `~/.kiro-manager-wb/`:
-
-```
-~/.kiro-manager-wb/
-├── tokens/           # Токены аккаунтов
-├── profiles/         # IMAP профили и fingerprint profiles
-├── backups/          # Бэкапы патчей
-├── machine-id.txt    # Кастомный Machine ID
-├── config.json       # Конфигурация
-└── autoreg.log       # Логи
-```