网关保活 · .NET 托盘版

Windows 上的主路由 / 旁路由保活工具。旁路由连续检测失败时回退直连，稳定恢复后切回旁路由；也可以固定模式或暂停自动切换。

基于 PowerShell 原项目 重写，使用 C#、.NET 10、WinForms。托盘交互参考相邻的雷蛇鼠标控制器项目。完整设计见 PLAN.md。

当前版本

这是 0.1.0 初版，包含托盘面板、中文设置、分层探测、自动策略、可补偿的路由/DNS切换、快照恢复、日志与最高权限登录任务。

默认未配置且暂停。首次运行必须显式选择网卡并保存，程序不会按网卡名字猜测并立即修改网络。只管理选择网卡的 IPv4 默认路径；IPv6、VPN 路由和其他网卡不接管。

故障回退到主路由	首次未配置

设置分为连接、保活规则、检测与提醒三页，默认只展示当前页需要的选项。

连接	保活规则	检测与提醒

运行

使用 Windows x64。依赖运行时版需要 .NET 10 Desktop Runtime，独立版包含运行时。托盘模式会请求管理员权限；只读诊断和预览不提权。

• 左键图标：显示/隐藏面板；Esc 或点外部：收起面板。
• 自动：按连续阈值和冷却切换；直连/旁路由：固定模式，失败时提示。
• 暂停：继续监测，停止自动改网络。
• 恢复：恢复接管前快照并暂停。存在未完成切换时，先处理那次切换的恢复。
• 默认退出保留当前网络；“退出时恢复”可在设置中开启。
• 登录后启动：创建当前用户的交互式最高权限计划任务，程序路径移动后重新设置。

首次设置的示例网关为 192.168.6.1 / 192.168.6.2，SOCKS5 端口为 1070，请按实际网络调整。旁路由探测默认使用 www.google.com；直连探测另用 www.baidu.com、www.microsoft.com，避免直连无法访问代理目标导致错误回滚。默认各要求至少一个目标成功。

构建与测试

安装 .NET 10 SDK 后运行：

.\build.ps1 -Test
.\build.ps1 -Test -Publish                 # 依赖运行时版
.\build.ps1 -Test -Publish -SelfContained  # 包含运行时版

脚本优先使用 $env:GATEWAY_DOTNET、$env:USERPROFILE\.dotnet-sdk\dotnet.exe，其次使用 PATH 中的 dotnet。产物在 artifacts/publish/，编译与测试不会修改系统网络。

测试不依赖外部 NuGet 包，采用有退出码的控制台测试集，覆盖状态机、故障补偿、外部修改保护、持久化、SOCKS5 分片和 DNS 报文边界；不是用 dotnet test 运行。当前结果见 验证记录。

只读诊断

发布目录的 diagnostics/GatewayKeepalive.Cli.exe 不修改网络，也不创建自启任务：

.\GatewayKeepalive.Cli.exe --diagnose --output report.json
.\GatewayKeepalive.Cli.exe --probe --adapter <网卡GUID>
.\GatewayKeepalive.Cli.exe --dry-run --adapter <网卡GUID> --proxy
.\GatewayKeepalive.Cli.exe --dry-run --adapter <网卡GUID> --direct

--config 路径 指定 JSON 配置；--probe 会发送 DNS / SOCKS5 / TLS 网络请求，仍不会改网关。--dry-run 只生成计划。托盘 exe 也支持上述参数与 --preview 目录。

数据与恢复

数据位于 %LocalAppData%\GatewayKeepalive\：settings.json、session.json、switch-journal.json、logs/。JSON 采用临时文件写入、刷新落盘与替换，保留上一版 .bak。日志保留 14 天。

路由与 DNS 没有系统级跨操作原子事务。程序写前保存记录，分步写入、读回验证并探测真实 IPv4 TLS 出口；失败时补偿。发现外部修改、陌生网络或补偿失败会停止自动写入。进程被强行终止后，需要下次启动识别未完成记录再恢复；没有独立后台服务替已退出的进程实时修复网络。

接管范围与手动恢复步骤见 网络行为说明。界面截图在 artifacts/preview/（./build.ps1 后运行托盘程序 --preview <目录> 可重新生成）。