Claude Code Guard

帮助用户更稳定地使用 Claude Code 的桌面工具：分步准备（时区台北 → 清理中转残留 → 官方登录引导）。

功能（一期）

1. 时区：检测 / 一键设为台北 / 打开系统日期时间设置
2. 清理：扫描并清除 ANTHROPIC_* 环境变量、配置中转字段、shell / PowerShell profile
3. 备份恢复、官方 OAuth 重登引导
4. 网络代理：二期（见路线图）

开发

cd claude-code-guard
npm install
npm run dev

npm run typecheck
npm test
npm run build
npm run build:mac   # 或 build:win

Windows

见 docs/WINDOWS.md（路径、真机验收清单、与专家脚本对照）。

npm run build:win

自动构建（GitHub Actions）

Push 到 main 或打 v* 标签会触发 Build & Release：

平台	产物
macOS Apple Silicon	*-mac-arm64.dmg / .zip
macOS Intel	*-mac-x64.dmg / .zip
Windows x64	*-win-x64-setup.exe 安装包 + *-win-x64-portable.exe 绿色版

构建结果出现在仓库 Releases 页，无需本机打包。

• push 到 main → 预发布 ci-<短sha>
• git tag v0.1.0 && git push --tags → 正式 Release v0.1.0

macOS CI 产物默认未签名。DMG 做成安装引导盘：

内容	作用
1-一键安装助手	双击：自动清除「已损坏」隔离 → 装到应用程序 → 启动（推荐）
2-仅解除已损坏	已手动拖入后仍打不开时，只清隔离
安装说明.txt	图文步骤
App + Applications	也可传统拖拽安装

全程不用手打 xattr 命令。正式签名/公证后一般可直接拖入使用。

文档与任务

• 清理规格
• Windows 验收
• 代理路线图
• 任务档案
• Agent 体系说明

Agent 协作

协议真源 AGENTS.md；skill 在 .claude/skills/（.grok/skills / .codex/skills 软链同源）。

续接：

读 @AGENTS.md 协议 + @docs/tasks/phase1-cleaner.md 任务档案，按档案「新会话启动指令」续接开发。

技术栈

Electron + electron-vite + React + Tailwind + TypeScript