explain-my-curl

explain-my-curl 是一个本地优先的命令行界面（CLI），用于理解 curl 命令在 DNS、TLS 和 HTTP 层面的行为。

本仓库目前包含：

• 一个解析并解释 curl 输入的命令行工具
• 一个用于交互式探索的启动 TUI
• 针对 DNS、TCP 连接、TLS 握手以及首字节时间的执行遥测
• 命令显示和错误字符串的敏感信息遮蔽
• 支持协议透明度的证据标签（Observed、Inferred、Estimated）
• 位于 docs/transparency-contract.md 的透明度契约

快速开始

go mod tidy
go run ./cmd/explain-my-curl explain "curl https://example.com -I"
go run ./cmd/explain-my-curl tui
go run ./cmd/explain-my-curl doctor
go run ./cmd/explain-my-curl version

TUI 控制

• Enter：运行当前 curl 输入
• Esc：切换到检查模式
• Tab：切换输入/检查焦点
• i：聚焦输入模式
• j/k 或方向键：移动选中的时间线步骤
• Space：折叠/展开选中的时间线步骤
• Ctrl+R：切换响应诊断面板
• Ctrl+B：切换响应体预览可见性
• q：退出

发布

• 标记版本（v*）通过 GitHub Actions 使用 GoReleaser 自动构建。
• CI 在推送和拉取请求时验证 go test ./...。
• CI 还持续运行 GoReleaser 快照构建，以验证发布配置。
• 工件发布到 macOS/Linux/Windows 的 amd64 和 arm64 平台。
• 发布二进制文件包含嵌入的构建元数据（version、commit、date）。
• 发布期间在 Formula/ 中生成 Homebrew 配方（tap 使用同一仓库）。

当前状态

本地执行遥测、分窗格 TUI、敏感信息遮蔽、测试、透明度契约以及发布自动化均已就位。