autoreg-skills-max: initial public release (restored, redacted, hardened)

skills/th-autoreg/references/gmail-alias-flow.md

@@ -0,0 +1,93 @@
+# Gmail+alias TokenHarbor Flow
+
+Полный цикл регистрации TokenHarbor через Gmail +alias с $5 gift claim.
+
+## Почему Gmail, не t-online.de
+
+t-online.de блокирует письма от tokenharbor.ai на уровне сервера — ни inbox, ни spam.
+Проверено на 10+ аккаунтах 2026-08-09. Gmail принимает мгновенно.
+
+## Gmail аккаунт
+
+- Email: `[REDACTED-NAME]@gmail.com`
+- App password: [REDACTED]
+- IMAP: `imap.gmail.com:993`, SSL
+- Алиасы: `[REDACTED-NAME]+th{N}@gmail.com` — без настройки, работает из коробки
+
+## Поиск verify-письма
+
+```python
+mail.search(None, f'TO "[REDACTED-NAME]+th{id}@gmail.com"')
+```
+
+Письмо от TokenHarbor с subject: "Verify your email to start using the Token Harbor API".
+Ссылка в теле: `https://tokenharbor.ai/verify-email?token=...`
+
+## Полный цикл (90 сек на аккаунт)
+
+### 1. Signup (15 сек)
+```
+Page.navigate → https://tokenharbor.ai/login?mode=signup
+Заполнить email + password через nativeSet
+Клик "Create account"
+Ждать редиректа на /dashboard
+```
+
+### 2. Email verification (10-30 сек)
+```
+Gmail IMAP: поиск verify-письма по TO "[REDACTED-NAME]+th{N}@gmail.com"
+Извлечь https://tokenharbor.ai/verify-email?token=...
+Page.navigate → verify link
+Ждать редиректа verify=success или /dashboard
+```
+
+### 3. $5 Gift claim (10 сек)
+```
+Page.navigate → /dashboard
+Клик: button с текстом "gift" + "ready" (в хедере, "1 gift ready to claim")
+Ждать модалку (2 сек)
+Клик: button с текстом.trim() === "Claim" (внутри модалки)
+Ждать подтверждения (3 сек)
+```
+
+### 4. API key creation (20 сек)
+```
+Page.navigate → https://tokenharbor.ai/dashboard/api-keys
+Ждать загрузки: "API keys" in text AND "LOADING" not in text AND "Create and manage" in text
+Клик: button с "New key" И offsetParent !== null
+Ждать форму (3 сек)
+Заполнить label через nativeSet (visible input: offsetParent !== null)
+Клик: button с text === "Create key" И !disabled И offsetParent !== null
+Ждать появления ключа (5 сек)
+Извлечь thk_live_... из document.body.innerText
+```
+
+### 5. Push to VPS (2 сек)
+```
+POST https://[REDACTED-NAME].loc.cc/th/provider/add?provider=tokenharbor
+Authorization: Bearer [REDACTED-KEY]
+Body: {"key": "thk_live_..."}
+```
+
+## Rate limiting
+
+При регистрации быстрее 1 акк/мин TokenHarbor начинает реджектить signup.
+Симптом: после клика "Create account" URL остаётся `/login?mode=signup`.
+Решение: `time.sleep(2)` между регистрациями. При массовых фейлах — 5-10 сек.
+
+## Проверка баланса
+
+```python
+GET https://tokenharbor.ai/v1/models
+Authorization: Bearer thk_live_...
+```
+200 = ключ работает (баланс > 0 или есть $5). 401 = invalid. 402 = no balance.
+
+Нет публичного API для проверки точного баланса — только через dashboard.
+
+## Питфолы Gmail IMAP
+
+- Gmail требует app password (не основной пароль)
+- `imaplib.IMAP4_SSL("imap.gmail.com", 993)` — стандартный порт
+- Поиск по `TO` работает с полным адресом включая `+alias`
+- При частых запросах Gmail может темпорарно блокировать — добавить задержки