Repository navigation
v3.12.5
v3.12.5
主界面重构之后欠下的四个功能补齐了,顺带修掉六处「看起来在保护、实际上没生效」的判定缺陷,并把所有出网决策收敛到一个入口。本版主体来自 @qiao-obs 的 PR #17。
新功能
暂停守护 / 完全恢复网络提到了主界面。 以前要点进设置、翻到折叠组里才能暂停;现在主卡下方常驻一行动作,暂停、完全恢复(先解除隔离再撤销守护)、立即观察各一个按钮。两个破坏性动作都要求连点两次确认,四秒内不点第二下自动失效。
24 小时时间线。 主界面多了一张时间线卡,96 格代表最近 24 小时,每 15 分钟一格,按正常 / 熔断 / 暂停三色铺开。它喂自日志与当前状态两路:守护器重启后仍能从日志里把当天断网时段画出来。键盘左右键可在格子间移动,读屏会播报该格状态。日志行也统一补上了 MM-DD HH:MM:SS 时间戳。
设置页即时搜索。 折叠组变多以后找一项设置要点开好几层。搜索框按标题与提示文字过滤,命中项所在的组会自动展开,清空搜索恢复原状。
首次运行向导防呆。 白名单两个框都留空时,以前会静默进入守护,约 30 秒后按设计熔断并隔离网络——对新用户来说这像是软件坏了。现在「以后再说」会先弹二次确认,说明后果;真留空也会停在第 1 步给出内联错误。
判定与兜底
这一版的重点在「不要谎报」。
- 轮次处置的死分支。
all_pass && !failing.is_empty()恒为假,未熔断资产的部分失败从来没被写进状态也没记日志。抽成decide_round_outcome真值表后,失败原因与具体目标会如实上报并去重。 - 防火墙解除两侧都要成功。 原来
a || b会让一侧失败被另一侧成功掩盖,回执上写「已解除」而规则还在。改为两侧都验,并且规则本来就不存在时按幂等算成功,不再误报失败。 - 隔离意图先回查再记账。
sync_lockdown不再持锁跨子进程 IO,改在锁外跑 netsh / PowerShell 再回查规则数,核验通过才写入lockdown_last;没通过就下一轮按原意图重试,而不是记成「已生效」。 - 断网后置核验按 GUID。 网卡查不到以前被读成「已断开」,等于假定断网成功。现在
parse_nic_status对空结果、Missing、本地化未知一律 fail-closed。 - 配置目录不再落在工作目录。
%APPDATA%取不到时逐级降级到 LOCALAPPDATA / ProgramData / 临时目录并写日志,而不是悄悄在当前目录建一份配置。 - 退出与自更新前统一走恢复闸门。 自更新安装完以前直接
process::exit(0),绕过了恢复流程,可能把用户留在防火墙封锁状态。现在先shutdown_before_exit,恢复失败就中止更新。
出网
新增 netpol::client 与 EgressIntent,客户端更新、飞书通知、自更新检查都从同一个入口决定走代理还是直连。规则没有放宽:填了代理就必须走代理,代理不可用就直接失败并如实报告,不会静默回退到直连。飞书通知保持原本的直连行为。
有一点需要说明:客户端更新检查在「配置里代理字段为空」时会直连——这是自更新检查一直以来的口径,不是本版新引入的。如果你靠系统代理出网却没在设置里填代理地址,这项检查不会走代理;填上代理地址即可。
依赖
aes-gcm0.11.1、libloading0.9.0、winreg0.56.0(dependabot #14 / #15 / #16)- 此前已合入的
hmac0.13 +sha20.11、zip9、quick-xml0.42 一并进入本版
文档
- README 改为英文主版并新增
README.zh-CN.md中文版,补了 FAQ、三步上手与封号潮背景 - 新增
CHANGELOG.md、CONTRIBUTING.md、SECURITY.md,以及 Issue / PR 模板 - 测试夹具与界面占位符里的真实出口地址全部换成 TEST-NET(
198.51.100.98),共 9 个文件
升级
直接覆盖安装即可,%APPDATA%\ClaudeGuard 下的配置与账本格式不变(version: 3)。静默升级:ClaudeGuard-v3.12.5-setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART。
已知限制没有变化:自更新只有 GitHub 提供的 SHA-256 摘要校验,没有独立签名清单;进程仍整体以管理员权限运行;macOS 分支尚未在真机验收。