Cc Fix

CC-Fix

CC-Fix 是面向 Windows 的环境一致性检测与可恢复保护工具。它提供独立桌面应用、CLI 和本地 GUI，用同一套耐久事务管理环境变量、系统时区、浏览器策略以及可选的语言/区域画像。

当前版本：`0.2.0-rc.1` · 协议：MIT · 目标平台：Windows 10/11 x64

功能亮点

• 三档保护模式：daily / standard / deep，可随时查看健康状态与切换。
• 耐久事务：写前计划、写后读回验证、失败自动补偿、完整还原，不依赖“备份文件是否存在”推断安全。
• 只读网络检测：VPN、路由、网卡、DNS、hosts 与 DoH 风险只检测、解释和提醒，绝不修改这些网络配置。
• 浏览器策略：标准保护管理 Chrome/Edge 各 3 个 HKCU 策略槽（语言与 WebRTC 防泄漏）。
• 多端一致：桌面应用、CLI 与本地 GUI 共用同一套核心逻辑和状态语义。
• 低门槛安装：当前用户安装、无需管理员权限，自带 Node.js 24 私有运行时与 WebView2 离线安装程序。
• 可追溯发布：发布载荷包含 SHA-256、CycloneDX SBOM、第三方声明、构建信息与来源证明。

重要边界

• CC-Fix 会检测出口网络、VPN、路由、网卡、DNS、hosts 与 DoH 风险，但只给出提醒，绝不修改这些网络配置。
• “标准保护”会修改当前用户的 TZ、LANG、LC_ALL，Windows 系统时区，以及 Chrome/Edge 的 6 个受管策略槽。
• “深度保护”还会修改 LocaleName、首选语言列表和用户 Culture，因此会更明显地影响日常 Windows 体验。
• 所有受管值在首次保护前写入不可变日常快照；关闭保护时逐项读回验证并完整还原。
• 安装包目前未进行 Authenticode 签名，Windows SmartScreen 可能显示未知发布者警告。请先核对随包 SHA-256。

安装

Windows 桌面版（推荐）

运行 `CC-Fix-Setup-0.2.0-rc.1-x64.exe`。安装器：

• 安装到 %LOCALAPPDATA%\Programs\CC-Fix，无需管理员权限；
• 自带 Node.js 24 私有运行时，不要求系统安装 Node.js；
• 自带 x64 WebView2 离线安装程序，系统缺失时自动安装并复检；
• 创建开始菜单入口，可选桌面快捷方式和当前用户 PATH；
• 升级/修复前检查未完成事务；普通卸载会先执行完整日常还原。

安装包和校验文件由以下命令生成：

pnpm build:installer
pnpm release:evidence

npm CLI（兼容渠道）

如果只需要 CLI，也可使用系统 Node.js 20 或更高版本：

npm install -g cc-fix
cc-fix --version

仓库中的 `scripts/install.ps1` 与 `scripts/cc-fix.bat` 仅用于旧 npm CLI 兼容，不是独立 Windows 安装器。

快速开始

# 检测；地区支持 us / eu / jp / sg
cc-fix check --region us

# 默认标准保护
cc-fix persist on --region us

# 深度保护（会额外改变语言和区域画像）
cc-fix persist on --level deep --region jp

# 查看已提交模式、健康状态和事务
cc-fix persist status
cc-fix persist status --json

# 继续未完成的恢复事务
cc-fix persist recover

# 完整还原日常配置
cc-fix persist off

# 只在子进程中注入目标环境，不改变持久状态
cc-fix run --region eu claude

桌面应用和 `cc-fix gui` 共用经过会话认证的 `127.0.0.1` 服务。启动令牌一次性使用，API/SSE 同时检查 Host、Origin 和会话 Cookie。

三种模式

模式	受管范围	适用场景
daily	不施加保护；保留偏好地区	日常使用