

ProxyClean · 功能说明
代理异常退出后,不必先重启电脑:脚本会把死本地端口和不能继续工作的配置指出来,只在实际条件满足时执行相应清理。
当前情况:已发布图形入口提供检查、中文修复预览、确认后修改与基础网页检查。仍工作的代理会保留;这次只核对了源码、现有说明和一次本机只读状态,没有查看截图,也没有对当前网络执行修复或删路由。
这页内容按北京时间 2026-10-11 的源码写定(当时最后一次提交在 10 月 6 日 05:52),11 月 4 日再对照现行来源,没发现要改的;具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库

ProxyClean · 功能说明
代理异常退出后,不必先重启电脑:脚本会把死本地端口和不能继续工作的配置指出来,只在实际条件满足时执行相应清理。
当前情况:已发布图形入口提供检查、中文修复预览、确认后修改与基础网页检查。仍工作的代理会保留;这次只核对了源码、现有说明和一次本机只读状态,没有查看截图,也没有对当前网络执行修复或删路由。
这页内容按北京时间 2026-10-11 的源码写定(当时最后一次提交在 10 月 6 日 05:52),11 月 4 日再对照现行来源,没发现要改的;具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库


系统代理、环境变量、Git 与路由表各自保存状态。只修其中一处可能仍然断网;盲目删默认路由又可能雪上加霜。因此主入口先判断活监听与 TUN,再对每类配置分别决定保留、清理或拒绝动作。
“代理退了,网页还报连接旧代理失败。”我在首页点检查并修复,先看到失效设置的中文预览;确认后才关闭指向死端口的系统代理并清理相关用户/Git 设置。界面分别显示配置回读与基础网页检查结果(不走显式代理,用 IPv4 依次请求百度和微软的连通性测试页);旧终端可能要重开。
窗口逐项告诉我哪些失效代理设置已清、哪些仍在工作的设置被保留、旧网络路线是否因为缺少安全退路而没有动,以及基础网页是否打开。任一测试页正常返回就算打开;全部因为域名解析失败才报“域名解析失败”,其他情况报“未确认能上网”。这一项通过不代表海外网站或 AI 服务可用,也不证明绕开了 TUN。

系统代理、环境变量、Git 与路由表各自保存状态。只修其中一处可能仍然断网;盲目删默认路由又可能雪上加霜。因此主入口先判断活监听与 TUN,再对每类配置分别决定保留、清理或拒绝动作。
“代理退了,网页还报连接旧代理失败。”我在首页点检查并修复,先看到失效设置的中文预览;确认后才关闭指向死端口的系统代理并清理相关用户/Git 设置。界面分别显示配置回读与基础网页检查结果(不走显式代理,用 IPv4 依次请求百度和微软的连通性测试页);旧终端可能要重开。
窗口逐项告诉我哪些失效代理设置已清、哪些仍在工作的设置被保留、旧网络路线是否因为缺少安全退路而没有动,以及基础网页是否打开。任一测试页正常返回就算打开;全部因为域名解析失败才报“域名解析失败”,其他情况报“未确认能上网”。这一项通过不代表海外网站或 AI 服务可用,也不证明绕开了 TUN。

确认失效的本机设置已清,仍在工作的代理保持原样;设置与网页测试分别报告,旧终端可能要重开。
找不到可靠的物理上网路线时,所有默认路线都保持原样;其他可安全处理的设置仍按预览逐项说明。
需要删除系统路线时,保持同一用户的身份核对,需要时自动提权;自动提权失败则停止这一步并明确报错。

确认失效的本机设置已清,仍在工作的代理保持原样;设置与网页测试分别报告,旧终端可能要重开。
找不到可靠的物理上网路线时,所有默认路线都保持原样;其他可安全处理的设置仍按预览逐项说明。
需要删除系统路线时,保持同一用户的身份核对,需要时自动提权;自动提权失败则停止这一步并明确报错。

双击根目录“00-打开 ProxyClean.vbs”,在首页点“检查并修复上网问题”,读中文预览后才点“开始修复”。
- 网页或命令行出现的故障
- 是否还需要正在运行的代理
- 预览后是否同意执行


双击根目录“00-打开 ProxyClean.vbs”,在首页点“检查并修复上网问题”,读中文预览后才点“开始修复”。
- 网页或命令行出现的故障
- 是否还需要正在运行的代理
- 预览后是否同意执行


这里保留实现、关键条件、精确入口、历史记录和验证结果。
物理默认路由保护已修复;隔离回归通过,真实网络未改动


- ProxyClean.Notifications 组件声明 SendMessageTimeout(HWND_BROADCAST, WM_SETTINGCHANGE, 'Environment', timeout(等待超时)=200ms)。
- 同一组件声明 InternetSetOption(SETTINGS_CHANGED 39, REFRESH 37)。
- Get-PCListenerState 严格检验回环、通配地址和地址族的监听状态;监听集合改由 Get-PCTcpListener 的原生监听者专表提供,快照和 Test-LocalProxyDead 都换了这个入口。读不到时仍保留 unknown,不把未知端口当死端口。11 月 6 日 05:16 只读观察,没有执行清理。
- Test-PCPhysicalRoute 检查网卡 Status 为 Up 且 NextHop 非 0.0.0.0 且非 198.18/198.19 fake-ip 网段。

这里保留实现、关键条件、精确入口、历史记录和验证结果。
物理默认路由保护已修复;隔离回归通过,真实网络未改动


- ProxyClean.Notifications 组件声明 SendMessageTimeout(HWND_BROADCAST, WM_SETTINGCHANGE, 'Environment', timeout(等待超时)=200ms)。
- 同一组件声明 InternetSetOption(SETTINGS_CHANGED 39, REFRESH 37)。
- Get-PCListenerState 严格检验回环、通配地址和地址族的监听状态;监听集合改由 Get-PCTcpListener 的原生监听者专表提供,快照和 Test-LocalProxyDead 都换了这个入口。读不到时仍保留 unknown,不把未知端口当死端口。11 月 6 日 05:16 只读观察,没有执行清理。
- Test-PCPhysicalRoute 检查网卡 Status 为 Up 且 NextHop 非 0.0.0.0 且非 198.18/198.19 fake-ip 网段。

- Test-LocalProxyDead 解析代理端点,仅在全部端点为本地回环且无活跃监听时才断定为死代理。
- Test-PCPhysicalRoute 在删除前与删除后共同检查 HardwareInterface=true;信息未知不充当物理路由证据。
- ProxyClean.Operations.ps1 在效果前把原值和步骤写进本机 %LOCALAPPDATA%\
ProxyClean\ last-operation.json(UTF-8 JSON,原样保存恢复值,不另加密,靠当前 Windows 账户的文件权限),用主文件与 .previous 两个位置轮流保存:保留最近一份有效记录,把新记录写进另一份,强制落盘并读回核对后才退役旧槽,所以不会覆盖唯一的恢复文件;兼容 EFS 加密目录。预览不创建记录。以前用 DPAPI(Windows 自带的按账户加密)保护的 last-operation.dpapi 及其 .previous 仍能读来恢复,单纯读取不迁移格式;下次保存时先完整写好并回读 JSON 双槽,再退役旧槽。临写比较原值,写后回读,失败逆序恢复。外来修改保留为 recovery_required 并阻止新配置写入;只处理当前轮可撤销对象,文件不是跨设备恢复包。


- Test-LocalProxyDead 解析代理端点,仅在全部端点为本地回环且无活跃监听时才断定为死代理。
- Test-PCPhysicalRoute 在删除前与删除后共同检查 HardwareInterface=true;信息未知不充当物理路由证据。
- ProxyClean.Operations.ps1 在效果前把原值和步骤写进本机 %LOCALAPPDATA%\
ProxyClean\ last-operation.json(UTF-8 JSON,原样保存恢复值,不另加密,靠当前 Windows 账户的文件权限),用主文件与 .previous 两个位置轮流保存:保留最近一份有效记录,把新记录写进另一份,强制落盘并读回核对后才退役旧槽,所以不会覆盖唯一的恢复文件;兼容 EFS 加密目录。预览不创建记录。以前用 DPAPI(Windows 自带的按账户加密)保护的 last-operation.dpapi 及其 .previous 仍能读来恢复,单纯读取不迁移格式;下次保存时先完整写好并回读 JSON 双槽,再退役旧槽。临写比较原值,写后回读,失败逆序恢复。外来修改保留为 recovery_required 并阻止新配置写入;只处理当前轮可撤销对象,文件不是跨设备恢复包。





| 名词 | 意思 |
|---|---|
| Orphan Route Precondition(孤儿路由前置条件) | 在删除候选默认路由前,源码要求至少存在一条 HardwareInterface=true、Up、NextHop 非零且非 fake-ip 的物理默认路由;它明确要求 Windows 标记为物理接口,仍不等于主动测得网关或公网可达。 |
| Direct Mode(强制直连模式) | 显式 -Direct 会关闭 WinINET、清空列出的用户代理变量并 unset Git 代理,即使值仍活跃或指向远程;它不结束客户端进程或切 TUN。 |
| Loopback Dead Discrimination(本地死端口鉴别) | 严格区分 127.0.0.1 本地回环与远程代理服务器,只清已死的本地端口,避免误伤正常的远程代理配置。 |

区分本地死端口、活代理与远程配置;PInvoke(平台调用)负责通知,清理后分别回读路由和连通性



区分本地死端口、活代理与远程配置;PInvoke(平台调用)负责通知,清理后分别回读路由和连通性

解决什么
防止代理崩溃后因残留系统代理和孤儿 fake-ip 路由导致全机断网,防止网络修复工具误删物理路由引发二次灾难。


- 现场没有符合条件的备用默认路由: 脚本打印黄色警告并跳过全部路由删除,提示先确认 WLAN 或以太网;其余代理配置清理仍按各自条件继续。
- 系统代理指向的端口正在正常监听: 脚本认定为活动代理,不关闭系统代理,仅提示交由客户端维护,保持现场不动。
- 默认模式下 Git 代理同时包含有效远程代理与本地死端口: 默认保留无法安全定位的配置,Direct也不越过Git来源边界;先明确可写的通用全局配置,不删除含糊或URL专属项。
- WinINET 活端口与活动 fake-ip TUN 同时存在: 默认模式只告警多路径,不替用户选择或关闭客户端;用户先决定保留哪一条,或明确选择 -Direct。

解决什么
防止代理崩溃后因残留系统代理和孤儿 fake-ip 路由导致全机断网,防止网络修复工具误删物理路由引发二次灾难。


- 现场没有符合条件的备用默认路由: 脚本打印黄色警告并跳过全部路由删除,提示先确认 WLAN 或以太网;其余代理配置清理仍按各自条件继续。
- 系统代理指向的端口正在正常监听: 脚本认定为活动代理,不关闭系统代理,仅提示交由客户端维护,保持现场不动。
- 默认模式下 Git 代理同时包含有效远程代理与本地死端口: 默认保留无法安全定位的配置,Direct也不越过Git来源边界;先明确可写的通用全局配置,不删除含糊或URL专属项。
- WinINET 活端口与活动 fake-ip TUN 同时存在: 默认模式只告警多路径,不替用户选择或关闭客户端;用户先决定保留哪一条,或明确选择 -Direct。

- ProxyClean.ps1: 命令行清理入口,预览、修复、撤销都调用与图形首页相同的共享流程(ProxyClean.Common.psm1、ProxyClean.Operations.ps1 等),实现死端口鉴别、候选孤儿默认路由条件处理与系统广播
- ProxyClean.test.ps1: 测试执行入口,先检查全部脚本能否解析,再运行 tests/ 下 15 个测试文件
- 早先单文件测试验证过本地/远程/混合代理解析、活/死本地端口、隔离 Git 配置和只读状态 JSON;现在测试拆到 tests/ 下 15 个文件,共展开 385 个用例(北京时间 11 月 4 日 08:35 只做发现计数,没有运行;10 月 11 日数出的是 317 个),全套运行结果未知。
- 2026-09-24 当时的变更记录载明 12 项新增注册表回归及整仓 193 项通过(该记录文件 9 月 26 日已从仓库删除,可在 Git 历史查到);9 月 25 日版本 277 项在两版 PowerShell 通过也是历史记录;9 月 22 日隔离客户端流程验证保留原日期。这些都未在本人当前网络关闭代理,也不证明公网或所有应用恢复。
- 源 857b110 的新增回归包含 9 个判定场景与 3 个实际清理条件分支:只有虚拟备用时零删除、活动 TUN 保留、Direct 模式下符合条件的孤儿清理。旧实现先失败,新实现双 PowerShell 通过。
首页“检查并修复上网问题”的配置修复核心,也是命令行默认清理与显式直连的技术依据;普通修复不自动刷新 DNS。

- ProxyClean.ps1: 命令行清理入口,预览、修复、撤销都调用与图形首页相同的共享流程(ProxyClean.Common.psm1、ProxyClean.Operations.ps1 等),实现死端口鉴别、候选孤儿默认路由条件处理与系统广播
- ProxyClean.test.ps1: 测试执行入口,先检查全部脚本能否解析,再运行 tests/ 下 15 个测试文件
- 早先单文件测试验证过本地/远程/混合代理解析、活/死本地端口、隔离 Git 配置和只读状态 JSON;现在测试拆到 tests/ 下 15 个文件,共展开 385 个用例(北京时间 11 月 4 日 08:35 只做发现计数,没有运行;10 月 11 日数出的是 317 个),全套运行结果未知。
- 2026-09-24 当时的变更记录载明 12 项新增注册表回归及整仓 193 项通过(该记录文件 9 月 26 日已从仓库删除,可在 Git 历史查到);9 月 25 日版本 277 项在两版 PowerShell 通过也是历史记录;9 月 22 日隔离客户端流程验证保留原日期。这些都未在本人当前网络关闭代理,也不证明公网或所有应用恢复。
- 源 857b110 的新增回归包含 9 个判定场景与 3 个实际清理条件分支:只有虚拟备用时零删除、活动 TUN 保留、Direct 模式下符合条件的孤儿清理。旧实现先失败,新实现双 PowerShell 通过。
首页“检查并修复上网问题”的配置修复核心,也是命令行默认清理与显式直连的技术依据;普通修复不自动刷新 DNS。
数字截至 2026 年 11 月 6 日
复制 AI 续作说明
项目:代理退出后,只修理失效设置;仓库:wlyaaaaa/ProxyClean;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








