[Nexisato]

概要

新增 run-*.swanlab 本地持久化：一条 Record 可靠落盘、原样读回，进程崩溃留下的半条记录不会污染读取。文件格式与 Python core_python.store 完全一致。

变更内容

只新增 core/internal/store，不改动 proto / manager / service，零新增第三方依赖。

文件	内容
store.go	文件格式（7 字节文件头、32 KiB 分块、chunk 类型、带类型基值的 CRC32、错误哨兵）；Writer（Create 排他创建、FULL/FIRST/MIDDLE/LAST 分块、块尾补零、偏移记账、Flush 与幂等 Close）；Reader（OpenOffset(path, offset, limit) 从任意记录边界起读并以 limit 为上界，Scan 区分 EOF / 截断 / 损坏 / 坏文件头，Position 供增量扫描）
async.go	AsyncWriter：定量 / 定时 / Close 三条刷盘路径，原子发布 (flushedStoreSeq, flushedOffset)，OnError 供上层置 storeDegraded

关键行为：

• 进度只在整条记录的全部物理分块写入且显式 Flush 成功后才发布，因此并发 Reader 以 flushedOffset 为上界时不会读到半条跨块记录；发布允许滞后，但不会超前。
• 首次写入或刷盘失败回调一次 OnError，之后丢弃本地写入但继续消费入口，不阻断上传主链路。
• Reader.Scan 遇到尾部半条记录返回 ErrTruncated，此前读出的记录仍然有效；CRC 或帧结构非法返回 ErrCorrupt。
• Writer.Offset() 在异步写入下只反映已被消费的部分，异步场景应使用 Flushed() 或事后用 Reader 扫描。

验证

• go build ./...、go vet ./...、go test -race ./... 通过；internal/store 语句覆盖率 90.0%；golangci-lint（仓库 .golangci.yml）0 issues。
• 单测覆盖跨两块 / 三块、块尾补零、空记录、字节布局、排他创建、CRC 损坏、非法 chunk 类型、非零填充、半条记录、偏移与 limit、并发读不越过 flushedOffset、AsyncWriter 三条刷盘路径与降级丢弃。
• 与 Python core_python.store 双向互读 200 条混合记录：条数、num 序列、每条 payload sha256 一致；两语言对同一记录序列写出的文件整份字节相同；截断与定点读取符合预期。

Base: feat/core/io-model。