# ProtoLens

**Repository Path**: solidify-the-foundation/proto-lens

## Basic Information

- **Project Name**: ProtoLens
- **Description**: ProtoLens（协议透镜）是一个使用 Go 构建的可编程协议教学沙箱。项目把协议实现与抓包观察结合起来，帮助学习者理解原始字节、协议字段、请求响应关系和状态机之间的映射。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-12
- **Last Updated**: 2026-08-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ProtoLens

ProtoLens（协议透镜）是一个使用 Go 构建的可编程协议教学沙箱。项目把协议实现与抓包观察结合起来，帮助学习者理解原始字节、协议字段、请求响应关系和状态机之间的映射。

项目已完成工程初始化，下一阶段将实现 DNS 编解码。第一个可用版本将围绕 DNS 编解码、PCAP 分析、字节级注解和终端界面展开。

## 开始使用

环境要求：Go 1.24 或更高版本。

```bash
make test
make lint
make build
./bin/protolens --help
```

当前 CLI 已包含规划中的命令入口；协议行为将在对应里程碑实现。

```text
protolens dns query
protolens dns serve
protolens inspect file
protolens inspect live
protolens tui
```

## 文档

- [实施计划](docs/PLAN.md)
- [后续执行计划](docs/NEXT.md)
- [架构设计](docs/architecture.md)

## 当前里程碑

- M0：工程初始化
- M1：手写 DNS 编解码器
- M2：DNS 客户端与 Server
- M3：离线抓包和报文分层
- M4：字节级注解与会话关联
- M5：实时抓包
- M6：TUI 教学界面

详细任务、依赖和验收条件见实施计划。