ProxyWarden/CONTRIBUTING.md

Участие в разработке ProxyWarden

ProxyWarden остается локальной Windows-утилитой. Изменения не должны превращать проект в VPN-провайдер, proxy server, SaaS или облачный control plane. Перед работой прочитайте AGENTS.md и релевантный skill из .agent/skills.

Локальная проверка

npm ci
npm run format:check
npm run lint
npm run typecheck
npm test -- --run
npm run build

Push-Location src-tauri
cargo fmt --all -- --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test --all-targets
Pop-Location

npm run tauri -- info
& .\scripts\install-control-app.ps1 -PlanOnly
& .\scripts\install-proxyfier.ps1 -PlanOnly
& .\scripts\install-singbox.ps1 -PlanOnly
& .\scripts\audit-windows-smoke.ps1 -Mode PlanOnly

Windows service, UAC, installer и реальный routing нельзя считать проверенными только по unit-тестам. Для таких изменений укажите выполненный ручной сценарий или явно оставьте этот пробел в отчете.

Изменения

• Держите src/api/tauriCommands.ts единственным TypeScript facade над Tauri invoke.
• Не показывайте subscription URL, credentials, proxy password или X-HWID в логах и UI.
• Не добавляйте скрытые install/start/stop/uninstall действия в apply.
• Добавляйте минимальный тест для новой ветвящейся логики.
• Не коммитьте runtime-файлы из C:\ProgramData\ProxyWarden и generated output.

В pull request кратко опишите поведение, затронутые файлы, выполненные проверки и оставшиеся Windows/manual риски.