为您整理好的 Markdown 格式文档,优化了排版与结构,方便您直接放入 README.md 中:
这是一个用于可视化 Claude Code 运行状态的桌面红绿灯工具。
组件采用竖排 3 灯(红/黄/绿)结合横排胶囊形状的设计,实时反映 Claude Code 的当前工作状态:
- 🔴 红灯闪烁:出错(Error)
- 🟡 黄灯闪烁:等待确认(Prompt / Waiting)
- 🟢 绿灯长亮:工作中(Thinking / Executing)
- ⚫ 全灭:空闲(Idle)
-
注册 Hooks:右键点击
install.ps1$\rightarrow$ 选择 “使用 PowerShell 运行”(此操作会自动注册全局 hooks,只需执行一次)。 -
启动程序:双击
start_traffic_light.vbs即可启动红绿灯。
你可以通过以下两种方式关闭工具:
-
直接关闭:右键点击红绿灯界面
$\rightarrow$ 选择 Close -
托盘关闭:右键点击系统托盘的绿色图标
$\rightarrow$ 选择 Close Code Light
如果需要完全卸载该工具,请按以下步骤操作:
- 直接删除整个项目文件夹。
- 打开
~\.claude\settings.json配置文件,手动清理其中关联的hooks配置即可。
├── traffic_light.ps1 # 红绿灯主程序
├── install.ps1 # 一键安装脚本(用于注册全局 hooks)
├── start_traffic_light.vbs # 静默启动脚本(双击运行,无后台黑窗口)
├── .code-light/hooks/ # PowerShell hook 脚本(共 6 个)
└── .claude/settings.json # 项目级 hooks 配置文件