s-xray-gate 0.2.0__tar.gz

s_xray_gate-0.2.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.pyc
+*.egg-info/
+build/
+dist/
+.venv/
+.pytest_cache/
+.ruff_cache/
+*.log
+*.pid
+*.tmp
+# рантайм-указатели/состояние шлюза (НЕ публиковать — могут нести приватные подписки/ноды)
+.sh-xray.json
+.sh-gateway.json

s_xray_gate-0.2.0/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+Все заметные изменения s-xray-gate. Формат — по мотивам Keep a Changelog; версии — SemVer.
+
+## [0.2.0] — 2026-07-08
+
+### Added
+- **TROJAN-поддержка в egress-пуле.** Ядро `_core.py`:
+  - `_parse_trojan(url)` — парсер `trojan://password@host:port?params#name` (userinfo =
+    url-decoded пароль, `proto="trojan"`, `uuid=None`, security по умолчанию `tls`,
+    type `tcp`); устойчив к URL без `?params` и без `#frag`. Полный transport-парсер
+    (reality/tls/ws/grpc/xhttp/alpn) общий с vless.
+  - `_make_config` собирает trojan-outbound (`protocol:"trojan"`, `settings.servers[].password`)
+    поверх той же `streamSettings`; тег outbound остаётся `vless-out` (routing по порядку,
+    не по имени тега — обратная совместимость).
+  - `refresh_profiles` парсит и `trojan://`-строки подписки.
+- **Разметка подписки (source).** Каждому профилю проставляется `p["subscription"]` —
+  короткая метка подписки-источника через `_sub_label(url)` (`panel.pragmati.ru`→`pragmati`,
+  `oversub.cloud`→`oversecure`, generic → SLD). Dedup-ключ теперь `(host, port, uuid|password)`
+  — корректен для trojan (uuid=None).
+- **Пул: фильтр по подписке + PIN на конкретный хост.** `pool.resolve_hosts`:
+  - `selector.subscription` → только профили этой подписки (нет таких → пусто, изоляция
+    подписок, last-known-good у вызывающего).
+  - `selector.host` → PIN на КОНКРЕТНУЮ ноду по имени или `host:port` (без ранга); высший
+    приоритет над subscription/geo/rank.
+  - `pool_add(..., host=...)` и CLI `xray-gate pool add --host … --subscription …`.
+- `make_pool_config` (BAL) и `_proxy_outbound` собирают набор и из trojan-хостов
+  (`_vless_outbound` оставлен тонким алиасом для обратной совместимости).
+
+### Changed
+- Версия ядра/CLI `0.1.0` → `0.2.0`.
+
+### Compatibility
+- VLESS-путь, легаси-egress `default` (алиас `state.json`), существующий CLI и pool.json —
+  без изменений формата. Профили без ключа `subscription` читаются штатно (get с дефолтом).

s_xray_gate-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dmitry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

s_xray_gate-0.2.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: s-xray-gate
+Version: 0.2.0
+Summary: Единый VLESS-шлюз (xray-core): один не-RU egress со smart-routing для проброса прокси в любой проект/сервис; обход гео-блокировок и РКН-DPI. Импорт подписки, авто-обновление, пинг/выбор лучших нод, self-heal, autostart; фасад Gateway + адаптеры httpx/requests/playwright/telethon.
+Author: Dmitry
+License: MIT
+License-File: LICENSE
+Keywords: egress,geo-bypass,proxy,reality,socks5,subscription,vless,xray
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: Proxy Servers
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.11
+Requires-Dist: s-clikit>=0.1.0
+Requires-Dist: s-librarykit>=0.1.8
+Provides-Extra: adapters
+Requires-Dist: httpx[socks]>=0.27; extra == 'adapters'
+Requires-Dist: requests[socks]>=2.31; extra == 'adapters'
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Provides-Extra: socks
+Requires-Dist: httpx[socks]>=0.27; extra == 'socks'
+Requires-Dist: pysocks>=1.7; extra == 'socks'
+Description-Content-Type: text/markdown
+
+# sh-xray — единый VPN-шлюз (skill-hub xray) для всех AI-навыков
+
+Один общий SOCKS5-прокси (xray-core) с НЕ-российской нодой и smart-routing
+(РУ/CN → напрямую, остальное → за рубеж). Пишет общий указатель
+**`~/.sh-xray.json`**, который читают ВСЕ навыки (паттерн `open_client._apply_proxy`).
+Системный трафик НЕ трогает (только opt-in инструменты через `ALL_PROXY`) — РУ-сервисы не ломаются.
+
+## Команды
+CLI `xray-gate` — на [clikit](https://gitlab.com/S-kits/clikit) (даёт `--json`/`--help`/`--version`):
+```
+xray-gate install            # xray binary + geoip/geosite (качает с GitHub-релиза XTLS/Xray-core)
+xray-gate test               # выбрать рабочую НЕ-RU ноду (проверка реального выхода через ipinfo.io)
+xray-gate start [--port N]   # поднять + записать ~/.sh-xray.json (порт по умолч. 10810)
+xray-gate status             # alive + live exit country
+xray-gate stop
+xray-gate ensure             # self-heal: поднять, если процесс умер (после reboot/краша)
+xray-gate autostart          # Windows Task Scheduler: ensure каждые 10 мин (переживает reboot)
+xray-gate autostart --remove
+xray-gate add-sub <url>      # своя VLESS-подписка (vless/base64; авто-обновление по интервалу подписки)
+```
+Без установки китов (свежая машина, handoff-бандл) — тот же набор через **dep-free ядро**:
+`python xray_gate/_core.py <команда>` (чистый stdlib, никаких зависимостей). Именно его
+дёргает watchdog (`ensure` каждые 10 мин), чтобы self-heal не зависел от китов.
+
+## Построен на Китах (S-kits)
+sh-xray — НЕ кит, а супернавык/сервис, который *строится* на [китах](https://gitlab.com/S-kits):
+**clikit** даёт человеческий CLI (`xray_gate/cli.py`), **librarykit.config_util** — атомарную
+запись общих указателей (`~/.sh-xray.json`, `~/.sh-gateway.json`). Ядро-движок
+(`xray_gate/_core.py`, бывший top-level `gateway.py`) намеренно остаётся на чистом stdlib —
+у обоих kit-обращений есть stdlib-фолбэк, поэтому self-heal работает даже без китов.
+gateway-роутер потребляет egress sh-xray через свой `ProxyProvider` (читает `~/.sh-xray.json`).
+
+## Переживает перезагрузку
+`autostart` ставит задачу планировщика (`ensure` каждые 10 мин, `StartWhenAvailable`). После reboot
+старый pid мёртв → `ensure` поднимает xray заново (при старте/в течение ~10 мин). `~/.sh-xray.json`
+обновляется новым pid, все навыки снова ходят через прокси. Без `autostart` — поднимать вручную `start`.
+
+## Общий указатель `~/.xray-gate/state.json`
+```json
+{"http_proxy": "http://127.0.0.1:10811", "all_proxy": "socks5h://127.0.0.1:10810", "node": "...", "backend": "xray-gate"}
+```
+Потребители читают его и ходят через ОДИН egress (важно: один IP для логина И API, иначе Google убивает сессию).
+Всё хозяйство рантайма — под `~/.xray-gate/` (state.json/routing.json/byedpi/zapret/бинарь).
+
+## Потребление в проектах (egress «из коробки»)
+xray-gate — **источник пути** (его знает он, не нейтральный librarykit-корень). Потребитель ставит
+его как egress-расширение и берёт прокси у его адаптеров. Установка (на PyPI НЕТ — из git):
+```bash
+uv add --optional egress "s-xray-gate @ git+https://gitlab.com/s-skills/s-xray-gate.git"  # запишет в pyproject+lock
+uv sync --extra egress                                   # или: pip install git+https://gitlab.com/s-skills/s-xray-gate.git
+```
+4 способа взять прокси (нет указателя/шлюз не поднят → `None` → проект идёт напрямую):
+```python
+import xray_gate.adapters as eg
+httpx.Client(proxy=eg.httpx_proxy())                       # socks5h://127.0.0.1:10810
+sess = eg.requests_session()                                # requests.Session с прокси
+browser.launch(proxy=eg.playwright_proxy())                 # {"server":"socks5://..."}
+TelegramClient(s, api_id, api_hash, proxy=eg.telethon_proxy())
+
+# через нейтральный librarykit-транспорт (проект на китах):
+from librarykit import HttpClient, HttpxTransport
+HttpClient(HttpxTransport(proxy=eg.httpx_proxy()), auth, errmap)
+
+# env-wide (subprocess/curl/любой ALL_PROXY-клиент):
+from xray_gate import apply_to_env; apply_to_env("notebooklm")   # по карте ~/.xray-gate/routing.json
+
+# zero-dep (без установки пакета — просто JSON):
+import json, pathlib
+proxy = json.loads((pathlib.Path.home()/".xray-gate"/"state.json").read_text())["all_proxy"]
+```
+Реальный пример-потребитель — bublictr (`adapters/_common/browser.py`): `BUBLICTR_BROWSER_PROXY=shxray`
+→ `xray_gate.adapters.playwright_proxy()`.
+
+## Портативность / другие устройства
+`install` качает xray-core сам. `add-sub <url>` + `test` подберёт не-RU ноду. Так работает на любой машине/агенте.
+
+## Замечание по нодам
+Качество зависит от подписки. Нестабильная нода → таймауты (xray ретраит, но лучше иметь несколько не-RU нод).
+`status` показывает live exit; `test` перевыбирает рабочую.

s_xray_gate-0.2.0/README.md

@@ -0,0 +1,79 @@
+# sh-xray — единый VPN-шлюз (skill-hub xray) для всех AI-навыков
+
+Один общий SOCKS5-прокси (xray-core) с НЕ-российской нодой и smart-routing
+(РУ/CN → напрямую, остальное → за рубеж). Пишет общий указатель
+**`~/.sh-xray.json`**, который читают ВСЕ навыки (паттерн `open_client._apply_proxy`).
+Системный трафик НЕ трогает (только opt-in инструменты через `ALL_PROXY`) — РУ-сервисы не ломаются.
+
+## Команды
+CLI `xray-gate` — на [clikit](https://gitlab.com/S-kits/clikit) (даёт `--json`/`--help`/`--version`):
+```
+xray-gate install            # xray binary + geoip/geosite (качает с GitHub-релиза XTLS/Xray-core)
+xray-gate test               # выбрать рабочую НЕ-RU ноду (проверка реального выхода через ipinfo.io)
+xray-gate start [--port N]   # поднять + записать ~/.sh-xray.json (порт по умолч. 10810)
+xray-gate status             # alive + live exit country
+xray-gate stop
+xray-gate ensure             # self-heal: поднять, если процесс умер (после reboot/краша)
+xray-gate autostart          # Windows Task Scheduler: ensure каждые 10 мин (переживает reboot)
+xray-gate autostart --remove
+xray-gate add-sub <url>      # своя VLESS-подписка (vless/base64; авто-обновление по интервалу подписки)
+```
+Без установки китов (свежая машина, handoff-бандл) — тот же набор через **dep-free ядро**:
+`python xray_gate/_core.py <команда>` (чистый stdlib, никаких зависимостей). Именно его
+дёргает watchdog (`ensure` каждые 10 мин), чтобы self-heal не зависел от китов.
+
+## Построен на Китах (S-kits)
+sh-xray — НЕ кит, а супернавык/сервис, который *строится* на [китах](https://gitlab.com/S-kits):
+**clikit** даёт человеческий CLI (`xray_gate/cli.py`), **librarykit.config_util** — атомарную
+запись общих указателей (`~/.sh-xray.json`, `~/.sh-gateway.json`). Ядро-движок
+(`xray_gate/_core.py`, бывший top-level `gateway.py`) намеренно остаётся на чистом stdlib —
+у обоих kit-обращений есть stdlib-фолбэк, поэтому self-heal работает даже без китов.
+gateway-роутер потребляет egress sh-xray через свой `ProxyProvider` (читает `~/.sh-xray.json`).
+
+## Переживает перезагрузку
+`autostart` ставит задачу планировщика (`ensure` каждые 10 мин, `StartWhenAvailable`). После reboot
+старый pid мёртв → `ensure` поднимает xray заново (при старте/в течение ~10 мин). `~/.sh-xray.json`
+обновляется новым pid, все навыки снова ходят через прокси. Без `autostart` — поднимать вручную `start`.
+
+## Общий указатель `~/.xray-gate/state.json`
+```json
+{"http_proxy": "http://127.0.0.1:10811", "all_proxy": "socks5h://127.0.0.1:10810", "node": "...", "backend": "xray-gate"}
+```
+Потребители читают его и ходят через ОДИН egress (важно: один IP для логина И API, иначе Google убивает сессию).
+Всё хозяйство рантайма — под `~/.xray-gate/` (state.json/routing.json/byedpi/zapret/бинарь).
+
+## Потребление в проектах (egress «из коробки»)
+xray-gate — **источник пути** (его знает он, не нейтральный librarykit-корень). Потребитель ставит
+его как egress-расширение и берёт прокси у его адаптеров. Установка (на PyPI НЕТ — из git):
+```bash
+uv add --optional egress "s-xray-gate @ git+https://gitlab.com/s-skills/s-xray-gate.git"  # запишет в pyproject+lock
+uv sync --extra egress                                   # или: pip install git+https://gitlab.com/s-skills/s-xray-gate.git
+```
+4 способа взять прокси (нет указателя/шлюз не поднят → `None` → проект идёт напрямую):
+```python
+import xray_gate.adapters as eg
+httpx.Client(proxy=eg.httpx_proxy())                       # socks5h://127.0.0.1:10810
+sess = eg.requests_session()                                # requests.Session с прокси
+browser.launch(proxy=eg.playwright_proxy())                 # {"server":"socks5://..."}
+TelegramClient(s, api_id, api_hash, proxy=eg.telethon_proxy())
+
+# через нейтральный librarykit-транспорт (проект на китах):
+from librarykit import HttpClient, HttpxTransport
+HttpClient(HttpxTransport(proxy=eg.httpx_proxy()), auth, errmap)
+
+# env-wide (subprocess/curl/любой ALL_PROXY-клиент):
+from xray_gate import apply_to_env; apply_to_env("notebooklm")   # по карте ~/.xray-gate/routing.json
+
+# zero-dep (без установки пакета — просто JSON):
+import json, pathlib
+proxy = json.loads((pathlib.Path.home()/".xray-gate"/"state.json").read_text())["all_proxy"]
+```
+Реальный пример-потребитель — bublictr (`adapters/_common/browser.py`): `BUBLICTR_BROWSER_PROXY=shxray`
+→ `xray_gate.adapters.playwright_proxy()`.
+
+## Портативность / другие устройства
+`install` качает xray-core сам. `add-sub <url>` + `test` подберёт не-RU ноду. Так работает на любой машине/агенте.
+
+## Замечание по нодам
+Качество зависит от подписки. Нестабильная нода → таймауты (xray ретраит, но лучше иметь несколько не-RU нод).
+`status` показывает live exit; `test` перевыбирает рабочую.

s_xray_gate-0.2.0/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: xray-gate
+version: 0.1.0
+description: "Единый VLESS-шлюз (xray-core) для всех AI-навыков/проектов: один не-RU egress со smart-routing (РУ/CN→direct, остальное→за рубеж). Обходит ГЕО-блокировки (NotebookLM, Gemini, OpenAI/ChatGPT) и РКН-DPI (Telegram, Reality/VLESS). CLI `xray-gate` (install/test/start/status/ensure/autostart) + Python-фасад Gateway.ensure() + адаптеры httpx/requests/playwright/telethon. Пишет общий указатель ~/.sh-xray.json — навыки ходят через ОДИН IP (Google не убивает сессию на прыжках). Не трогает системный трафик (opt-in через ALL_PROXY). EN triggers: proxy for skill, bypass geo-block, geo blocked NotebookLM/Gemini/OpenAI, VLESS reality proxy, xray gateway, single egress proxy, socks5 for httpx/playwright/telethon, RKN DPI bypass, ensure proxy up, autostart proxy, rotate node, proxy health check, sh-xray, one shared proxy. RU triggers: прокси для навыка, обход блокировок, гео-блокировка, обход гео, NotebookLM/Gemini/OpenAI заблокированы из РФ, vless reality прокси, xray шлюз, единый прокси для всех навыков, socks5 для httpx/playwright/telethon, обход РКН DPI, подними прокси, автозапуск прокси, ротация ноды, проверить прокси, sh-xray, один общий egress."
+kind: tooling
+---
+
+# xray-gate
+
+Respond in the user's language.
+
+> Один общий не-RU SOCKS5-egress (xray-core, VLESS/Reality) для ВСЕХ навыков и проектов. Гео-блокировки и РКН-DPI обходятся в одном месте; навыки читают `~/.sh-xray.json` и ходят через единый IP.
+
+## When activated (router)
+
+Определи задачу и иди в нужную секцию:
+
+- **«Навык/код не достаёт гео-сервис» (NotebookLM, Gemini, OpenAI/ChatGPT, заблокировано из РФ)** → раздел **1. Быстрый старт** (подними шлюз) + **2. Из кода** (адаптер под клиента).
+- **«Подключить прокси к httpx / requests / playwright / telethon»** → раздел **2. Из кода (адаптеры)**.
+- **«Проверить/поднять/перезапустить прокси, ротация ноды, health»** → раздел **3. Жизненный цикл и self-heal**.
+- **«Чтобы прокси сам поднимался после reboot»** → раздел **4. Автозапуск (Win/Linux/macOS)**.
+- **«Своя подписка / другое устройство / выбор ноды»** → раздел **5. Подписки, ноды, портативность**.
+
+Особенно: **если упоминается гео-блокировка, обход блокировок, VLESS/Reality, «прокси для навыка», sh-xray → это здесь.**
+
+## Instructions
+
+### 1. Быстрый старт
+
+```bash
+# установка пакета (CLI xray-gate + Python-фасад)
+pip install s-xray-gate          # PyPI; либо из репо: pip install -e . ; extras: "s-xray-gate[socks]"
+
+xray-gate add-sub '<vless-sub>'  # своя VLESS-подписка (vless/base64)
+xray-gate install                # xray-core + geoip/geosite (качает с GitHub-релиза XTLS/Xray-core)
+xray-gate test                   # подобрать рабочую НЕ-RU ноду (реальный выход через ipinfo.io)
+xray-gate start                  # поднять + записать ~/.sh-xray.json (socks 10810 + http 10811)
+xray-gate status                 # alive + живая страна выхода
+```
+
+После `start` любой навык, читающий `~/.sh-xray.json`, автоматически ходит через не-RU egress. РУ/CN-домены и приватные IP идут напрямую (smart-routing), системный трафик не затрагивается.
+
+### 2. Из кода (адаптеры)
+
+Один egress — разные форматы под библиотеки. Импорт `from xray_gate import Gateway, adapters`.
+
+```python
+from xray_gate import Gateway, adapters
+
+gw = Gateway.ensure()                       # idempotent: жив+рабочий → как есть; иначе поднять
+# gw.proxies() -> {'http','https','all'}    gw.httpx_proxy() -> 'socks5h://127.0.0.1:10810'
+
+import httpx
+httpx.Client(proxy=gw.httpx_proxy())        # httpx (нужен extra [socks])
+
+sess = adapters.requests_session()          # requests.Session с примонтированным прокси
+pw   = adapters.playwright_proxy()          # {'server': 'socks5://127.0.0.1:10810'} → browser.launch(proxy=pw)
+tg   = adapters.telethon_proxy()            # ('socks5','127.0.0.1',10810) → TelegramClient(proxy=tg)
+```
+
+Если шлюз не поднят (`~/.sh-xray.json` нет), адаптеры возвращают `None` — код ходит напрямую (то же поведение, что `xray_gate.proxy_for`). Для гарантии egress сначала `Gateway.ensure()`.
+
+Per-service маршрут (когда часть сервисов direct, часть через xray) — `xray_gate.apply_to_env("notebooklm")` по карте `~/.sh-gateway.json` (см. onboard).
+
+### 3. Жизненный цикл и self-heal
+
+```python
+gw = Gateway.ensure()        # подними при необходимости (install+start) или ротация при флапе
+gw.health()                  # {'alive': True, 'country': 'FI', 'ip': '...', 'latency_ms': 312}
+gw.rotate()                  # → следующая рабочая нода из ранга
+gw.stop()
+```
+
+`Gateway.ensure()` идемпотентен: если процесс жив И реальный выход рабочий — ничего не делает. Если pid мёртв — поднимает; если живой, но выход глушится/флапает — ротация ноды (двойная проверка против транзиента). То же из CLI: `xray-gate ensure`.
+
+### 4. Автозапуск (переживает reboot)
+
+```bash
+xray-gate autostart            # Win → Task Scheduler; Linux → systemd --user timer; macOS → launchd
+xray-gate autostart --remove
+```
+
+Все три варианта **без прав администратора/sudo** (`ensure` каждые 10 мин + на boot). На Linux при headless без активной user-сессии: `loginctl enable-linger $USER`, чтобы таймер пережил logout. Без autostart — поднимать вручную через `start`/`ensure`.
+
+### 5. Подписки, ноды, портативность
+
+```bash
+xray-gate add-sub '<vless-subscription-URL>'   # своя подписка (vless/base64; авто-обновление по интервалу)
+xray-gate test                                 # ранжирует ноды по latency, выбирает лучшую
+```
+
+Парсер VLESS понимает Reality/TCP и транспорты **ws / grpc / xhttp** (+ tls alpn) — подойдут разные провайдеры. `install` качает xray-core сам → работает на любой машине/агенте.
+
+## Notes / risks
+
+- Приватные токены подписки в репозитории навыка НЕ хранятся — задавай свою через `add-sub` или env.
+- Качество egress зависит от подписки: нестабильная нода → таймауты; `status`/`rotate`/`test` лечат.
+- Ядро использует системный `curl` для health-проб (есть на Win10+/Linux/macOS).

s_xray_gate-0.2.0/_skill_meta.toml

@@ -0,0 +1,41 @@
+# Hub publishing manifest для навыка xray-gate.
+# Читается skills-hub client/manifest_builder.py (description/triggers/tags/dependencies)
+# + расширенные поля модели навыков (kind/has_cli/[[cli]]/runtime_dependencies, E6).
+
+kind = "tooling"
+has_cli = true
+has_mcp = false
+
+description = "Единый VLESS-шлюз (xray-core) для всех навыков: один не-RU egress со smart-routing, обход гео-блокировок (NotebookLM/Gemini/OpenAI) и РКН-DPI (Telegram/Reality). CLI xray-gate + Python-фасад Gateway + адаптеры httpx/requests/playwright/telethon."
+
+# Триггеры для роутинга/поиска в хабе (RU+EN).
+triggers = [
+  "прокси для навыка", "обход блокировок", "гео-блокировка", "обход гео",
+  "vless reality прокси", "xray шлюз", "единый прокси для всех навыков",
+  "обход ркн dpi", "подними прокси", "автозапуск прокси", "ротация ноды",
+  "socks5 для httpx", "socks5 для playwright", "socks5 для telethon", "sh-xray",
+  "proxy for skill", "bypass geo-block", "geo blocked notebooklm gemini openai",
+  "vless reality proxy", "xray gateway", "single egress proxy", "rkn dpi bypass",
+  "ensure proxy up", "autostart proxy", "rotate node", "proxy health check",
+  "socks5 for httpx playwright telethon", "one shared proxy",
+]
+
+tags = ["proxy", "xray", "vless", "geo-bypass", "rkn", "networking", "tooling"]
+
+# Установленный консольный скрипт (project.scripts.xray-gate → xray_gate.cli:main, на clikit).
+[[cli]]
+command = "xray-gate"
+description = "Единый VLESS-шлюз: install/test/start/status/stop/ensure/rotate/autostart"
+entrypoint = "xray_gate.cli:main"
+
+# Рантайм-зависимости (опциональные extras пакета xray-gate).
+[runtime_dependencies]
+python = ">=3.11"
+# socks-egress для httpx/requests (extra [socks] / [adapters]):
+optional = ["httpx[socks]>=0.27", "PySocks>=1.7", "requests[socks]>=2.31"]
+# системный бинарь, используемый ядром для health-проб:
+system = ["curl"]
+# xray-core НЕ декларируется как pip-зависимость — `xray-gate install` качает его сам.
+
+# Зависимости от других навыков хаба (нет).
+dependencies = []