ClaudeGuard v2.10.1

终审修复版

上线前的全量核查（性能 / 兼容 / 运行 / 体验）结果与修复：

修复

• guard.log 增加大小上限：超过 1MB 自动裁剪保留最近约 400KB，按行边界切齐、临时文件原子替换，长期常驻不再无限增长（默认检查频率下数月触发一次）

核查结论（实测数据）

• 性能：冷启动到首次检测结果 5.2s（由出口探测网络耗时主导）；守卫进程常驻内存 30.2MB（另 WebView2 约 128MB，Chromium 底噪）；45 秒空闲 CPU 占单核 0.28%
• 运行：真机全链路演练——出口配置投毒 → 自动熔断（结束 14 个进程、加 20 条防火墙规则）→ 恢复配置 → 下一次检查自动解除隔离（0 条残留规则）
• 运行：--check 命令行 JSON 输出与退出码（0 通过 / 2 失败）回归通过
• 体验：内置用户指南开合 / Esc / 焦点归还复验通过；指南文案与界面实际用词逐字一致；无调试残留、无 transition: all、无裸 ease-in
• 质量：fmt / clippy -D warnings / 测试 16/16 通过

完整变更: v2.10.0...v2.10.1

ClaudeGuard v2.10.0

详情卡与设置卡精修

按用户要求撤销了 v2.9.0 的底栏常驻吸附，底栏回到文档流。

本轮聚焦两个最常用的卡片：

设置卡

• 「检测」分组内 3 处多余分隔线移除，恢复"组内紧凑、组间疏离"的层级节奏
• 多 IP 列表：新增行与已录入行左缘严格对齐；左侧标签顶对齐不再悬空居中
• 出口地区下拉：定宽 140px，切换选项不再宽度跳变；自绘箭头解决原生箭头压字
• 设置项标题真实 500 字重，说明文字行高放宽
• IP 删除钮由字符 × 改为矢量图标（消除跨字体基线漂移）；「添加 IP」输入槽虚线边框，聚焦转实底
• 开关：禁用态不再产生按压形变，光标 not-allowed；正常态 hover 色反馈；补 role=switch 无障碍语义

检查详情卡

• 步骤时间线竖线两端收进圆点圆心，不再露出尖刺；步骤名 500 字重；行内留白对称化

完整变更: v2.9.0...v2.10.0

ClaudeGuard v2.9.0

用户指南，点击即看

底栏的「用户指南」不再是外部浏览器链接，而是窗口内建的指南浮层：快速上手、主界面解读、全部设置说明、托盘与 FAQ，一次看全。Esc / 点击遮罩 / 右上角关闭，三种方式关闭；打开时焦点自动管理，关闭后回到原位。

底栏现在常驻可视——内容再长也不用滚到底找指南和安装入口。

动效与布局精修

• 卡片展开箭头改为绕自身中心旋转（修正偏心自转）
• 待机状态三个圆点依次渐显；运行日志新增行轻微落位；向导步骤圆点当前项放大
• 主按钮行上下留出呼吸感；设置行右列加宽防溢出

完整变更: v2.8.1...v2.9.0

v2.8.1

v2.8.1 UI 精修

Gemini 子代理设计审计协作首轮：12 条建议逐条核实，采纳 9 条、驳回 3 条（论据存疑或与现有决策冲突）。

修复清单

• fail 环图标从加号改为感叹号（v2.3 引入的真 bug，加号与"失败"语义冲突）
• 折叠卡箭头展开方向 180°→90°（右箭头转下=内容向下，P0 以来的方向 bug）
• restore 还原图标去掉补丁色块（hover/按压下不再露浅灰底）
• btn-outline 增加禁用态样式，hover/active 加 :not(:disabled) 守卫
• 数字启用 tabular-nums（版本号、端口、IP 等宽对齐不跳动）
• 输入框焦点光环 3px 柔和蓝/红（invalid:focus 红），补 box-shadow transition
• 首屏 boot 编排补状态行入场（此前状态行无过渡突现）
• 横幅退场补对称位移（与 @starting-style 入场对称）
• 圆环转场整体提速约 20%（340/380/400→260/260/280ms，感知更利落）

验证

CDP 逐项实测 9/9 通过；本地 fmt / clippy --locked -D warnings / test 15 项全绿。

v2.8 布局精简与用户指南

改进

• 主/次按钮同一行：“启动 Claude” 与 “重新检查” 并排，主屏省出 44px 高度
• 状态行按段断行：过宽时整段落到第二行，不再把词劈成两半；去掉与详情卡重复的“上次”尾段，常见状态一行放下
• 副标题更干净：“出口 x.x.x.x” 不再显示 (via ipify) 这类技术后缀
• 页脚新增“用户指南”：打开仓库内新写的中文使用文档 docs/GUIDE.md（快速上手/设置逐项/托盘/FAQ）

验证

• CDP 实测：CTA 行 44px 同行、状态行 16.8px 单行、页脚 4 链接、open_guide 命令回路
• 质量门 fmt/clippy -D/单测 15/15 全绿

v2.7.0 多 agent 守护

新增

• 守护对象可勾选：Claude 桌面版 / ChatGPT 桌面版 / 反重力桌面版（Antigravity），熔断时对勾选的全部执行结束进程+断网
• CLI 只提醒不处理：检测 Claude Code / Codex / Gemini CLI 运行状态，出口不对时在日志与横幅提醒，绝不杀终端进程
• 状态行显示守护对象运行状态（多进程 ×N）与 CLI 运行段
• 老用户默认只守护 Claude，行为与 v2.6 完全一致

验证

• 单测 15/15（含 GUI/CLI 进程指纹、防火墙规则名兼容）
• 实机 CDP：Claude×14 检出、真实 Codex CLI 检出、设置卡开关读写回路、配置自动迁移

ClaudeGuard v2.6.0

新增

• Claude 运行状态：状态行实时显示 Claude 桌面端是否在运行
• 约定出口支持多个 IP：设置卡改为列表编辑器（增删改），命中任一即放行
• 出口地区放行：没有固定 IP 的节点，可按国家（US/JP/SG/HK/TW/KR/GB/DE/FR/CA/AU）放行；IP 与地区任一命中即通过
• 旧版单 IP 配置自动迁移，无需手动改

防误杀语义

• 网络失败拿不到出口信息 → 不熔断（与旧版一致）
• 地区模式下本次没拿到地区数据（如 ipinfo 失败只有 ipify 兜底）→ 不熔断

完整变更：https://github.com/daha209/ClaudeGuard/compare/v2.5.0...v2.6.0

ClaudeGuard v2.5.0

后台自动检查静默化：不再转圈、不禁用按钮，环保持当前状态，界面零打扰；手动检查（首次/点按钮）保留转圈反馈。新增守护状态行：绿点·自动守护中·每 N 秒·上次 X 秒前，暂停/熔断/检查中各有对应颜色与文案。

ClaudeGuard v2.4.0

托盘新增「暂停守护 30 分钟」与「打开数据文件夹」；熔断/恢复时发系统气泡通知（首次点击后授权）；检查中「重新检查」按钮禁用；详情卡显示「X 秒前」相对时间；暂停期间检查照常但不再结束 Claude 进程或断网。

ClaudeGuard v2.3.0

动效精修：签名转场（检查中弧线减速收拢成满环，对勾延迟描画）、首屏进场编排（环→标题→副标题 40ms 步进）、卡片展开内容错峰、开关旋钮按压弹性、日志行 hover 显形、副标题数据变化淡换。全部只动 transform/opacity，reduced-motion 下全量降级。