Skip to content

v3.12.5

Choose a tag to compare

@daha1216 daha1216 released this 10 Nov 21:57
· 13 commits to master since this release

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-gcm 0.11.1、libloading 0.9.0、winreg 0.56.0(dependabot #14 / #15 / #16)
  • 此前已合入的 hmac 0.13 + sha2 0.11、zip 9、quick-xml 0.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 分支尚未在真机验收。