loop-uh
26c10c0dfe
Some checks failed
Windows project source guards / test (push) Has been cancelled
Изменил видимое пользователю — в той же задаче обнови заметки wiki, которые пересказывают приложение, и затронутые скриншоты (решение владельца 15.10.2026). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
29 lines
5.9 KiB
Markdown
29 lines
5.9 KiB
Markdown
# Project Rules
|
||
|
||
- Do not create new Git branches unless the user explicitly asks for one. By default, keep work on `main` and commit/push requested changes directly to `main`.
|
||
- Stable production releases use the one-command `python3 scripts/release_windows.py --change ...` workflow defined by `$zapret-kvn-release` in `.agents/skills/zapret-kvn-release/SKILL.md`. A release request authorizes the runner's local Windows dev/stable builds, immutable Forgejo publication, and stable-only Telegram delivery unless the user excludes it. Do not manually replay successful runner phases. Forgejo Actions validates portable source in the background; it does not own Windows release publication.
|
||
- For sing-box and Xray proxy/native TUN modes, the active raw JSON config is the routing and DNS source of truth. Keep versioned defaults under `data/templates/sing-box` and `data/templates/xray`, using only the original native core schemas.
|
||
- Do not introduce a custom routing DSL, overlay, `${APP_ROUTE_RULES}`-style compiler, or hidden Python injection of product routing policy. Runtime mutations must stay limited to app-owned transport and safety contracts.
|
||
- The same active raw JSON owns routing for an engine's proxy and native TUN modes. The hybrid Xray sidecar owns only its `proxy` path, while tun2socks remains a separate legacy path.
|
||
- The updater preserves `data/`, while remote builds carry current native templates in `assets/template-update`. On startup, `template_sync.py` replaces shipped templates and merges each same-path active config per top-level section: a section (`dns`, `route`, `outbounds`…) still equal to the previously installed template follows the new template, every section the user edited is kept verbatim. The app never rewrites user sections outside that update merge; returning to stock is a manual action (whole config or one section) in the routing GUI.
|
||
- The «Маршрутизация» pages are a structured editor of the same active native sing-box JSON, driven by the pinned core's own schema (`assets/sing-box-schema/`, regenerated by `scripts/generate_singbox_schema.py` after a sing-box pin change). They edit the parsed JSON in place and serialize it back; they must not introduce their own routing model. Wording and emphasis live in `xray_fluent/singbox_config/catalog.py`; field names, types and allowed values come only from the schema.
|
||
- For JSON routing work, follow the project skill `$zapret-kvn-json-routing` in `.agents/skills/zapret-kvn-json-routing/SKILL.md`.
|
||
- Keep page-level surfaces transparent. Do not add local background fills or page/root/scroll-area style sheets that block Windows 11 Mica.
|
||
- Prefer built-in `qfluentwidgets` appearance over custom page styling. Add local UI styling only when the user explicitly asks for it or when the library cannot provide the needed result.
|
||
- Do not force `WA_TranslucentBackground` on full pages, scroll areas, or their viewports unless it is explicitly needed and visually verified; prefer the same built-in page behavior used by working screens.
|
||
- Do not rebuild or smoke-start the app automatically after UI changes. The user will build it manually unless they explicitly ask for a build or startup verification.
|
||
- Do not change Xray proxy template/config `listen` addresses from `0.0.0.0` to localhost-only. In this project that is an intentional feature so the app can share the local proxy with other devices/apps when the user wants proxy distribution.
|
||
- When a build is explicitly requested, use the project builder `python build.py` from the repo root instead of calling PyInstaller directly.
|
||
- Before building, make sure `dist/ZapretKVN/ZapretKVN.exe` is not running; if needed, stop `ZapretKVN.exe` first or the clean step can fail because the old binary is locked.
|
||
- The builder is WSL-aware and converts paths for the Windows virtualenv automatically, so prefer it even when working from WSL.
|
||
|
||
## Пользовательские гайды следуют за приложением
|
||
|
||
- Zapret KVN для Windows пересказывают заметки хранилища wiki `/home/codex-pve/Privacy`: `Zapret/premium.md` (гайд для новичка, https://wiki.zapret.moe/Zapret/premium), `premium/apps.md` (раздел Windows), `premium/discord.md` (локальный прокси на порту `1390`, discord-drover) и `premium/v2rayn.md` (режим прокси и TUN).
|
||
- Изменил видимое пользователю — добавление подписки, названия страниц и кнопок, порт локального прокси, режимы прокси и TUN, шаблоны маршрутизации, установку и обновление, — в той же задаче обнови эти заметки и затронутые скриншоты. Задача не закрыта, пока гайд описывает старое приложение (решение владельца 15.10.2026).
|
||
- Скриншоты Windows снимаются на машине `win10` (VM 100); личные данные и ссылки подписок на снимках закрашиваются.
|
||
- Правка заметок — по навыку хранилища `/home/codex-pve/Privacy/.claude/skills/vault-note/SKILL.md`; публикация — коммит и `git push` хранилища (сайт пересобирается сам) и `"$HOME/.local/bin/obsidian" vault="Privacy" publish:add path=<файл>` для зеркала. Подробная процедура и проверка сайта — навык `vpnbot-maintain-user-guides` в `/home/codex-pve/vpnbot/vpnbot_codex/.claude/skills/`.
|
||
|
||
## Оформление ответа
|
||
|
||
Правила оформления ответа общие для всех проектов: раздел «Оформление ответа» в `/home/codex-pve/AGENTS.md`. Прочитай его и соблюдай в каждом сеансе; менять правила только там.
|