protos/
└── swanlab/
    ├── record/
    │   └── v1/
    │       └── record.proto            # 顶层信封 Record
    │
    ├── run/
    │   └── v1/
    │       └── run.proto               # Run 生命周期（StartRecord、FinishRecord、RunState、ResumeMode）
    │
    ├── metric/
    │   ├── column/
    │   │   └── v1/
    │   │       └── column.proto        # 列定义（ColumnRecord），描述 metric 的展示与归类配置
    │   └── data/
    │       └── v1/
    │           └── data.proto          # 指标数据（ScalarRecord、MediaRecord）
    │
    ├── config/
    │   └── v1/
    │       └── config.proto            # 实验配置引用（ConfigRecord、UpdateType）
    │
    ├── env/
    │   └── v1/
    │       └── env.proto               # 软件环境与主机元数据引用（MetadataRecord、RequirementsRecord、CondaRecord）
    │
    ├── terminal/
    │   └── v1/
    │       └── log.proto               # 终端代理捕获的 stdout/stderr 输出（LogRecord、LogLevel）
    │
    ├── save/
    │   └── v1/
    │       └── save.proto              # 文件保存记录（SaveRecord、SavePolicy）
    │
    ├── settings/
    │   ├── core/
    │   │   └── v1/
    │   │       └── core.proto          # Core 同步服务配置（CoreSettings）
    │   └── probe/
    │       └── v1/
    │           └── probe.proto         # Probe 硬件采集服务配置（ProbeSettings）
    │
    └── grpc/
        ├── core/
        │   ├── v1/
        │   │   ├── core.proto          # CoreService gRPC 服务（接收实验记录）
        │   │   └── sync.proto          # CoreSyncService gRPC 服务（启动日志同步）
        │   └── ...
        └── probe/
            └── v1/
                └── probe.proto         # ProbeService gRPC 服务（启动硬件采集）

swanlab.init(...)
  → Record { start:        StartRecord        }   # Run 基本信息，写入一次
  → Record { metadata:     MetadataRecord     }   # 主机与环境快照引用，写入一次
  → Record { requirements: RequirementsRecord }   # Python 依赖引用，写入一次
  → Record { conda:        CondaRecord        }   # Conda 环境引用，写入一次
  → Record { config:       ConfigRecord       }   # 实验 config（INIT），写入一次

# 训练循环中，首次出现某 key 时先发送列定义
  → Record { column: ColumnRecord { key="loss", type=SCALAR, ... } }
  → Record { column: ColumnRecord { key="img",  type=IMAGE, ... } }
# 每个指标独立生成一条 Record，swanlab.log({"loss": 0.5, "img": Image(...)}, step=10) 产生两条：
  → Record { scalar: ScalarRecord { key="loss", step=10, ... } }
  → Record { media:  MediaRecord  { key="img",  step=10, ... } }

# 终端代理（每行）
  → Record { log: LogRecord { line="...", level=INFO } }

# 运行中 config 更新
  → Record { config: ConfigRecord { update_type=PATCH, ... } }

# 文件保存
  → Record { save: SaveRecord { name="...", policy=NOW } }

swanlab.finish()
  → Record { finish: FinishRecord { state=FINISHED } }