Glight CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

项目概述

Glight（原名 Claude Code Light；产出的二进制仍叫 claude-traffic-light.exe）— Windows 桌面红绿灯挂件，实时显示 Claude Code 工作状态。单一 .exe，存于 U 盘即插即用。

构建命令

Go 不在 PATH 中，需完整路径：

# 调试（带控制台看输出，不产生 exe 文件）
C:\Open Source Projects\go\bin\go.exe run .

# 编译 exe（本地试装 / 发行，唯一一条；dist 不存在先建）
# 发行版文件名格式：Glight-v<版本号>-windows-amd64.exe
C:\Open Source Projects\go\bin\go.exe build -trimpath -buildvcs=false -ldflags="-H windowsgui" -o dist\Glight-v1.5.1-windows-amd64.exe .

# 运行测试
C:\Open Source Projects\go\bin\go.exe test ./...

工作目录：D:\vs code projects\claude code light。完整流程见 docs/编译构建发行.md。

构建规则（铁律，凡是编译成 exe 一律遵守）

发行前强制流程（每次，无例外）

第一步：问版本号。 构建发行版前，必须先停下来问用户「当前要发哪个版本（Major.Minor.Patch）」，不许沿用 versioninfo.json 里的旧版本号直接构建。

第二步：改版本。 用户确认版本后，改 versioninfo.json 的 FileVersion、ProductVersion（FixedFileInfo 和 StringFileInfo 各有一处），再重生成 syso：

& "$env:USERPROFILE\go\bin\goversioninfo.exe" -icon="<绝对路径>\claude-traffic-light.ico" -o="<绝对路径>\rsrc_windows_amd64.syso"

第三步：构建。 syso 更新后，再跑下面那条唯一的构建命令。

第四步：验证版本信息。

(Get-Item "dist\claude-traffic-light.exe").VersionInfo | Select-Object ProductName, FileVersion, CompanyName

确认 ProductName / FileVersion / CompanyName 全部正确后，构建才算完成。

第五步：推 tag。 构建验证通过、所有提交已推送后，打带注释 tag 并推到远端：

git tag -a v1.x.x -m "Glight v1.x.x" <commit-hash>
git push origin v1.x.x

第六步：发 Release（用户操作）。 这台机器没有 gh CLI，Release 页由用户在 GitHub 网页完成： 进入 https://github.com/kiryusento2017/Glight/releases/new?tag=v1.x.x，选好 tag，填 Title、Release notes，上传 dist\claude-traffic-light.exe，点 Publish。 Claude 负责准备好 Release notes 正文和 SHA256 供用户粘贴。

---

核心原则：调试用 go run .（不产 exe、带控制台）；凡是产出 exe 文件，只有一条命令，所有防护一次带齐。

go build -trimpath -buildvcs=false -ldflags="-H windowsgui" -o dist\Glight-v<版本号>-windows-amd64.exe .

四件防护，缺一不可：

• -trimpath：清掉二进制里的本机绝对路径——GOROOT（C:\Open Source Projects\go）、Windows 用户名（cache 路径 C:\Users\<用户名>\...）、项目路径（D:\vs code projects\...）。换成模块相对路径，盘符/用户名/目录全清。
• -buildvcs=false：去掉嵌入的 git revision / 提交时间 / dirty 标记。
• -ldflags="-H windowsgui"：无控制台黑窗（GUI 程序）。
• -o dist\...：统一输出 dist/（已 gitignore），与源码隔离。go build 不自动建目录，dist 不存在先 mkdir dist。文件名格式 Glight-v<版本号>-windows-amd64.exe。
• 自动链接 rsrc_windows_amd64.syso（图标 + 版本信息），让裸 exe 有正规身份、降启发式误报。