WuKongIM 统一本地存储库 pkg/db 实施指南:用 Pebble 底座重构消息日志与元数据存储

原创2026-10-15 21:26:042,128 阅读
文章标签:即时通讯后端

WuKongIM 统一本地存储库 pkg/db 实施指南:用 Pebble 底座重构消息日志与元数据存储

导读

本文基于 WuKongIM 仓库中的 Unified DB 实施计划 及其配套 Unified DB 设计文档,系统讲解如何把原来各自独立的 pkg/channel/store(频道消息日志)与 pkg/slot/meta(哈希槽元数据)两套 Pebble 存储实现,收敛为单一的 pkg/db 存储库,并对外暴露类型化的 MessageDB 与 MetaDB API。读完本文,你将掌握该库的钥匙空间(keyspace)骨架、值信封(value envelope)与行编码、Pebble 引擎封装、组提交协调器,以及 27 个 TDD 任务的完整实施路线与验收清单。结合仓库中已经落地的 pkg/db 源码,本文同时给出每个设计要点的真实实现证据与关键文件路径。

背景与动机:两套"长得像、实现各异"的存储层

在统一之前,WuKongIM 有两个基于 Pebble 的存储包,解决相似问题却各自为战:

  • pkg/channel/store:存储频道维度的消息日志、checkpoint、epoch 历史、快照、保留(retention)状态与幂等索引;
  • pkg/slot/meta:存储哈希槽维度的元数据表,包括用户、频道、订阅者、频道运行时元数据、会话、迁移任务、插件绑定与哈希槽迁移行。

两者都已在 Pebble 之上实现了小型表层:稳定的表/族/列/索引 ID、有序键编码、族值编码、二级索引、原子 Pebble 批量、前缀扫描与范围删除、快照导入导出、热路径缓存。但它们在键布局、值校验和、批处理、锁粒度、schema 校验、持久化协调上各不相同——这种重复让存储层难以阅读和扩展。因此设计文档明确:项目尚未发布,这是一次可破坏性(breaking)重构,旧 API 与旧磁盘数据都不需要保留(见 设计文档第 1 节)。

总体目标与架构决策

实施计划定义的目标(Goal)与架构约束(Architecture)非常清晰:

  • 目标:用新的 Pebble 支撑的 pkg/db 库替换 pkg/channel/store 与 pkg/slot/meta,对外暴露类型化的 MessageDB 与 MetaDB API;
  • 架构顺序:先构建共享存储内核(shared storage internals),再在其上实现 pkg/db/message 与 pkg/db/meta,然后迁移调用方,最后删除旧存储包;
  • 隔离原则:Pebble 类型严格封装在 pkg/db/internal/* 内,禁止泄漏到领域包或调用方;
  • 领域职责下沉:领域不变量(domain invariants)保留在 message 与 meta 领域包中,而不是塞进一个通用 ORM;
  • 技术栈:Go 1.23、Pebble v2、复用 WuKongIM 已有的 channel/slot/domain 类型,配套 Go 单元测试与基准测试。

设计文档进一步给出非目标:不做 SQL 引擎/ORM/反射行映射器,不做可插拔物理 KV 引擎,第一版不覆盖 pkg/raftlog、controller 元数据与 channelv2 原生存储。这意味着 pkg/db 是一套强类型、领域贴近的存储库,而不是通用数据框架。

目标文件结构

实施计划给出了完整的落盘文件清单(计划第 23-137 行):

pkg/db/
  FLOW.md  db.go  errors.go  options.go  types.go
  internal/
    engine/      # Pebble 封装:db.go batch.go iter.go span.go
    keycodec/    # 有序键编码:codec.go builder.go span.go
    rowcodec/    # 行值编码:codec.go envelope.go value.go
    schema/      # 表结构描述符:schema.go validate.go
    commit/      # 组提交协调器:coordinator.go batch.go
    cache/       # 有界类型化缓存:tiny.go
  message/       # MessageDB:db.go channel_log.go append.go read.go
                 #   indexes.go checkpoint.go history.go snapshot.go
                 #   retention.go idempotency.go catalog.go ...
  meta/          # MetaDB:db.go shard.go batch.go table_user.go
                 #   table_device.go table_channel.go table_subscriber.go
                 #   table_runtime_meta.go table_conversation.go ...

这些文件在当前仓库中均已存在,读者可直接对照源码阅读:根包见 pkg/db/db.go 与 pkg/db/options.go,领域包见 pkg/db/message 与 pkg/db/meta。

关键设计一:统一 Keyspace 骨架与 Key Codec

设计文档规定所有新键遵循同一个有序骨架:

[domain:1][partition-kind:1][partition-id:N][space:1][table-id:4][rest...]

真实实现中,internal/keycodec 定义了(见 codec.go):

  • Domain:0x01 message、0x02 meta;
  • PartitionKind:0x00 global(如 catalog)、0x01 channel(消息行)、0x02 hash-slot(元数据行);
  • Space:0x10 row、0x11 index、0x12 system、0x13 catalog。

键编码规则(与设计文档第 6 节一致,均已落地):

类型 编码方式
string uint16 长度 + 字节(AppendString/ReadString,长度上限 1<<16-1)
uint64 大端序(AppendUint64)
int64 有序 符号位翻转 + 大端序(AppendInt64Ordered)
int64 降序 符号位翻转后按位取反(AppendInt64Desc),用于会话活跃索引"最近优先"正向扫描
family ID uint16 大端序

前缀区间统一使用半开区间 Span{Start, End},NewPrefixSpan 与 PrefixEnd 负责生成"包含某前缀全部键"的扫描边界(见 span.go)。Builder 提供 Reset/Domain/Partition/Row/Index/System/Catalog/String/Uint64/Int64Ordered/Int64Desc/Family/Key 链式构建能力;只有 internal/keycodec 能构建/解码键,领域包只能调用类型化辅助函数,禁止直接拼原始字节。

消息域键示例(消息行、索引、系统态、全局 catalog 各自落入对应 Space),以及 meta 域键(<a href="https://link.gitcode.com/i/c4419d0fc9155261504e19d40bccb92d" target="_blank">meta][hash-slot][uint16][row][user_table][uid][family])都在设计文档第 6 节有完整推导,可在 [pkg/db/message/keys.go 中看到实现,例如 encodeMessageRowKey(channelKey, seq, familyID) 保留一次完整键分配、encodeGlobalMessageIDIndexKey 走 global 分区。

关键设计二:Value Envelope 与行编码

所有行值与系统值共用一种值信封(见 envelope.go):

[version:1][codec:1][flags:1][checksum:4][payload...]
  • Codec 值:0x01 列族增量编码、0x02 原始字节、0x03 定长二进制;
  • 校验和为 CRC32C(Castagnoli 表),覆盖 key + 头部(校验和位置填零)+ payload;
  • 第一版所有行值与系统值都启用校验和(FlagChecksum),索引值同样启用;校验和不匹配返回 db.ErrChecksumMismatch。

列族编码按列 ID 升序写 <a href="https://link.gitcode.com/i/1c304440dcccbdf7bf16f4e9c9d243ca" target="_blank">column-delta + type tag][value],支持 String/Bytes/Int64/Uint64/Bool/Uint8 六种类型(见 [codec.go)。规则:

  • 编码器必须按列 ID 升序写入;
  • 解码器跳过未知的可选列(保证前向兼容);
  • 缺失必填列、类型不匹配都返回 ErrCorruptValue;
  • 族布局把大 payload 与高频读取的头部隔离开。

这正是计划第 9 步"message row codec"的实现基础:消息表 header 族与 payload 族分离(消息表的 family 0 含全部头部列 + payload 列、family 1 为便携备份专用,见 schema.go)。

关键设计三:Schema 描述符与校验

internal/schema 提供 Table/Column/Family/Index/Type 描述符与 ValidateTable 校验函数,防止 ID 冲突并支撑调试工具(schema.go):

type Table struct {
    ID       uint32
    Name     string
    Columns  []Column
    Families []Family
    Primary  Index
    Indexes  []Index
}

校验覆盖:重复列 ID、重复族 ID、索引引用未知列、族引用未知列。pkg/db/message 与 pkg/db/meta 都通过该机制声明自己的表,例如消息表 MessageTable 定义了主键 pk_message(message_seq)与六个二级索引(含唯一索引 uidx_global_message_id、uidx_client_msg_no_from_uid、uidx_server_will_from_uid),见 pkg/db/message/schema.go。

关键设计四:Pebble 引擎封装

internal/engine 把 Pebble 包起来,只向领域包暴露必要原语(db.go):

func Open(path string, opts Options) (*DB, error)
func (e *DB) Get(key []byte) ([]byte, bool, error)
func (e *DB) NewBatch() *Batch          // Batch: Set / SetDeferred / Delete / DeleteRange / Commit(sync bool) / Close
func (e *DB) NewIter(span Span, opts IterOptions) (*Iter, error)

要点:

  • SetDeferred 是消息追加热路径必需的,用于保留 Pebble 的分配优化(计划 Task 5 明确要求);
  • 迭代器包装器在"键逸出迭代移动"时复制键(Get 返回独立副本),杜绝借用缓冲区越界;
  • 默认引擎参数(源码常量):块缓存 128 MiB、memtable 32 MiB、L0CompactionThreshold=8、L0StopWritesThreshold=24、Experimental.L0CompactionConcurrency=6、每个 level 使用 10-bit bloom filter;写停滞(write stall)与慢盘事件被记录为指标,可通过 DiskSlowThreshold 覆盖 Pebble 默认的 5 秒健康检查阈值。

根包通过 NodeStore 同时打开 message 与 meta 两个物理 Pebble 实例(两套目录,便于按领域分别调优写放大/缓存/压缩/扫描/fsync 模式):

store, err := db.OpenNodeStore(db.NodeStoreOptions{
    MessagePath: messagePath,
    MetaPath:    metaPath,
})
msgDB := store.Messages()   // *message.MessageDB
metaDB := store.Meta()      // *metastore.MetaDB

DefaultNodeStoreOptions(basePath) 自动补全 basePath/message 与 basePath/meta 路径、500µs 刷新窗口与 1024 队列大小(见 options.go)。重复调用 Messages() 返回同一个规范(canonical)消息注册表;Close 先排空消息域再关闭 meta,且幂等。

关键设计五:组提交协调器(Commit Coordinator)

原来跨频道的 fsync 批处理被移到 internal/commit 并领域化。Lane 标识逻辑提交流(含优先级),Request 携带 Lane/Partition/Records/Bytes/Build/Publish/Finalize:

  • 同频道微批发生在跨频道组提交之前;
  • Publish 只在 Pebble 提交成功之后执行(缓存发布、LEO 提升等);
  • 失败提交会失败本批内的所有请求;
  • Close 先停止接收新工作,再排空或失败待处理工作;
  • 批上限包括刷新窗口、请求数、记录数、字节数。

真实实现的 Coordinator 支持多分片路由(按 partition 的 FNV 哈希分片,见 coordinator.go),并区分高/普通优先级队列(PriorityHigh 留给消息追加热路径),默认刷新窗口 500µs、队列 1024;meta 域在构造时使用 FlushWindow: 500us, QueueSize: 1024, MaxRequests: 128(见 pkg/db/meta/db.go)。SubmitWithOutcome 返回精确的终结证据(OutcomeDefinitelyNotCommitted / OutcomeCommitted / OutcomeUnknown),用于区分"肯定未落盘"与"结果不确定",避免把不确定的物理提交错误重试。协调器还通过 Observer 暴露低基数事件(批量收集时长、请求/记录/字节数、队列深度、提交时长、结果),与既有 send trace 用法兼容。

关键设计六:MessageDB 领域(消息日志语义)

pkg/db/message 负责频道日志语义(db.go、channel_log.go):

func (db *MessageDB) Channel(key ChannelKey, id ChannelID) (*ChannelLog, error)
// ChannelLog:
//   Append(ctx, records, opts AppendOptions) (AppendResult, error)
//   ApplyFetch(ctx, req ApplyFetchRequest) (ApplyFetchResult, error)
//   Read / ReadReverse / GetBySeq / GetByMessageID / ListByClientMsgNo
//   LEO(ctx) (uint64, error)
//   Truncate(ctx, toSeq uint64) error

设计要点(均已实现):

  • 纯 seq 术语:首条消息 seq=1,空日志 LEO=0,存储层彻底移除 offset 兼容,offset 转换只在频道复制/处理器边界进行(见 types.go 中 ReadOptions/AppendResult/Message 等类型定义);
  • 追加流程(append.go):锁频道追加路径 → 恢复或读取缓存 LEO → 把 Record 解码为行并分配连续 seq → 严格模式下检查既有唯一索引与批内重复,可信模式下跳过既有索引读但仍查批内重复 → 暂存 header 族/payload 族/二级索引 → 提交到追加协调器 → 提交成功后才发布 LEO;
  • AppendMode 三种:AppendStrict(写前查唯一索引)、AppendServerAllocatedMessageID(跳过 message-ID 读但保留幂等键读)、AppendTrustedContiguous(调用方已验证,跳过既有索引读);
  • 幂等:IdempotencyKey{FromUID, ClientMsgNo, ServerWillKey} 与 IdempotencyHit;负缓存过滤 + 可能命中时走持久索引/消息数据双验证,饱和只会增加读、绝不放行重复;
  • ApplyFetch 显式 BaseSeq:与本地 LEO 不匹配时返回 ErrConflict,由复制层决定截断或拉取;checkpoint 单调写有独立锁,提交游标写有独立单调锁;
  • LEO 恢复:recoverLEO 用消息行前缀构造前缀区间扫描 header 族取最大 seq,并综合 retention 状态中的 RetainedMaxSeq(防止尾部全被裁剪时 LEO 回退);
  • 系统态:checkpoint、epoch 历史、快照 payload、committed dispatch cursor、retention 状态都存于消息系统键(SpaceSystem,systemID 1-5 等);保留裁剪会先扫描 header 行删除二级索引,再在同一批中范围删除行族并更新保留状态;ListChannels 依赖首次持久追加或系统态变更时写入的 catalog 键(global 分区)。

关键设计七:MetaDB 领域(哈希槽分片、MetaBatch 与守卫)

pkg/db/meta 负责哈希槽维度元数据语义(db.go、shard.go):

func (db *MetaDB) HashSlot(hashSlot HashSlot) *Shard     // HashSlot = uint16
func (db *MetaDB) HashSlots(hashSlots []HashSlot) []*Shard
func (db *MetaDB) NewBatch() *Batch

并发模型的升级是本次重构的核心收益之一:用哈希槽分片锁取代原来整库全局锁。单哈希槽读写取该槽读写锁;多哈希槽批处理按哈希槽升序加锁(orderedHashSlots 先去重再排序,杜绝死锁),非哈希槽范围的全局迁移行使用小型全局 meta 锁。这让单哈希槽的 Raft apply 保持安全,同时允许相互独立的哈希槽并行推进。

MetaBatch 的提交管线(batch.go):暂存类型化操作 → 提交时收集触及的哈希槽并按序加锁 → 建立批量局部 overlay 实现 read-your-writes → 校验并应用每个操作 → 检查守卫 → Sync 提交 → 发布缓存更新(只有提交成功后才发布/失效缓存)。ChannelRuntimeMetaGuard 显式携带 ChannelID/ChannelType/ExpectedChannelEpoch/ExpectedLeaderEpoch/ExpectedLeader/ExpectedRouteGeneration/ExpectedWriteFenceToken/ExpectedWriteFenceVersion,让迁移与运行时元数据不变量显式化。频道运行时元数据单调更新返回显式结果:MonotonicApplied / MonotonicIgnoredStale / MonotonicConflict。订阅者变更在写前对 UID 排序去重,并按 max(existing, requestVersion) 推进 subscriber_mutation_version。

设计文档给出初始表 ID 分配(1 user、2 channel、3 channel_runtime_meta、4 device、5 subscriber、6 user_conversation_state、7 reserved、8 channel_migration_task、9 cmd_conversation_state、10 plugin_user_binding、11-13 hashslot 迁移三表)。值得注意的是,落地后会话投影改用 UID 目录表(user_channel_membership / user_cmd_channel_membership),meta/FLOW.md 明确"没有会话表,表 ID 6/7 保持保留且不得复用"。哈希槽迁移表以哈希槽为分区键,同时在类型化 Go 值中保留自描述,但不重复作为键列。

分阶段实施路线图:27 个 TDD 任务一览

实施计划把整个重构拆成 27 个任务,每个任务遵循"先写失败测试 → 跑测试确认失败 → 实现 → 跑测试确认通过 → 提交"五步循环,并给出每个任务的提交信息。整体分五个阶段:

阶段一:构建 pkg/db 共享内核(Task 1-7)

任务 内容 提交信息
Task 1 根包骨架:共享错误、Options、占位类型 feat(db): add root storage package skeleton
Task 2 Key Codec:有序键编码与前缀区间 feat(db): add ordered key codec
Task 3 Row Codec 与值信封(CRC32C) feat(db): add row value codec
Task 4 Schema 描述符与校验 feat(db): add schema descriptors
Task 5 Pebble 引擎封装(含 SetDeferred) feat(db): wrap pebble engine
Task 6 提交协调器(组提交) feat(db): add commit coordinator
Task 7 有界类型化小缓存 feat(db): add bounded typed cache

阶段二:构建 pkg/db/message(Task 8-13) 消息 schema/keys → 消息行 codec → 追加与读取(空追加、连续 seq 分配、重开后 LEO 恢复、正/反向读、max bytes、同频道串行化)→ 二级索引与幂等(message-id 查询、client_msg_no 分页、严格/可信追加、批内重复)→ 系统态(checkpoint 单调拒绝、epoch 追加/截断、原子快照安装)→ apply-fetch/truncate/retention/catalog(显式 BaseSeq、ErrConflict、保留裁剪分块删除并同步清索引、首次持久追加写 catalog)。

阶段三:构建 pkg/db/meta(Task 14-22) meta schema/keys/分片锁 → user/device/channel 核心表与频道缓存 → 订阅者表(UID 去重、mutation version 推进)→ 频道运行时元数据(单调三态)→ 会话状态表(降序活跃索引)→ 插件绑定与哈希槽迁移表 → MetaBatch 与守卫(read-your-writes、创建唯一守卫、多哈希槽锁序、迁移活跃唯一性、提交后发布缓存、守卫失败回滚)→ 频道迁移任务与操作(claim/advance/fence/learner/leader transfer/abort)→ 快照、DeleteHashSlotData 与基准。

阶段四:迁移调用方并删除旧包(Task 23-26) 先记录旧导入面(rg 'pkg/slot/meta|metadb' pkg/slot pkg/cluster -g'*.go'),替换导入路径时保留 metadb 别名以减少改动;调整显式单调结果、显式哈希槽 API、新批行为与新快照选项名;频道侧把旧 offset 语义在复制/handler 边界换算为 seq;最后确认无 Go 调用方引用旧包后删除 pkg/channel/store 与 pkg/slot/meta,并更新 AGENTS.md 目录结构、wukongim.conf.example(若存储路径键变化)与 docs/development/PROJECT_KNOWLEDGE.md(记录"pkg/db 是唯一的本地存储库,单节点部署仍是单节点集群")。

阶段五:最终验证与性能基线(Task 27) gofmt/git diff --check → go test ./pkg/db/... → 迁移包测试 → 全量单元测试(可选)→ 基准冒烟 → 撰写 docs/superpowers/reports/2026-05-25-unified-db-verification.md 验证报告。

测试驱动开发:每个任务的标准命令

计划中所有任务统一采用"红-绿-提交"节奏。例如 Task 1 的根包测试:

func TestDefaultOptionsFillPathsAndDurability(t *testing.T) {
    opts := db.DefaultNodeStoreOptions(t.TempDir())
    if opts.MessagePath == "" || opts.MetaPath == "" {
        t.Fatalf("paths not filled: %#v", opts)
    }
    if opts.Commit.FlushWindow <= 0 {
        t.Fatalf("flush window not filled: %#v", opts.Commit)
    }
}

func TestErrorsSupportErrorsIs(t *testing.T) {
    if !errors.Is(fmt.Errorf("wrap: %w", db.ErrNotFound), db.ErrNotFound) {
        t.Fatal("ErrNotFound does not support errors.Is")
    }
}

对应运行 go test ./pkg/db -run 'TestDefaultOptions|TestErrorsSupport' -count=1:实现前应 FAIL(包不存在或导出名缺失),实现后应 PASS。其余任务的关键验证命令(均出自计划原文,可直接执行):

# Task 2 键编码:有序 int64 数值序排序
go test ./pkg/db/internal/keycodec -count=1

# Task 3 值信封:CRC32C 校验和不匹配检测
go test ./pkg/db/internal/rowcodec -count=1

# Task 5/6 引擎与协调器
go test ./pkg/db ./pkg/db/internal/engine -count=1
go test ./pkg/db/internal/commit -count=1

# Task 8-13 消息域
go test ./pkg/db/message -run 'TestMessageSchema|TestMessageKeys' -count=1
go test ./pkg/db/message -run 'TestChannelLogAppend|TestChannelLogRead|TestChannelLogLEO' -count=1
go test ./pkg/db/message -run 'TestMessageIndex|TestIdempotency|TestAppendStrict|TestAppendTrusted' -count=1
go test ./pkg/db/message -run 'TestCheckpoint|TestHistory|TestSnapshot' -count=1
go test ./pkg/db/message -run 'TestApplyFetch|TestTruncate|TestRetention|TestCatalog' -count=1

# Task 14-22 meta 域
go test ./pkg/db/meta -run 'TestMetaSchema|TestMetaKeys|TestShardLocks' -count=1
go test ./pkg/db/meta -run 'TestUser|TestDevice|TestChannel' -count=1
go test ./pkg/db/meta -run 'TestSubscriber|TestChannelCache' -count=1
go test ./pkg/db/meta -run 'TestChannelRuntimeMeta' -count=1
go test ./pkg/db/meta -run 'TestUserConversation|TestCMDConversation' -count=1
go test ./pkg/db/meta -run 'TestPlugin|TestHashSlotMigration' -count=1
go test ./pkg/db/meta -run 'TestMetaBatch|Test.*Guard' -count=1
go test ./pkg/db/meta -run 'TestChannelMigration' -count=1
go test ./pkg/db/meta -run 'TestSnapshot|TestDeleteHashSlotData' -count=1

# Task 23-26 迁移
go test ./pkg/slot/fsm ./pkg/slot/proxy -count=1
go test ./pkg/channel/... ./pkg/channelv2/... ./internal/app -count=1
go test ./internal/... ./pkg/... -count=1

# Task 27 最终验证
go test ./pkg/db/... -count=1
go test ./... -count=1

计划还强调两条纪律:不要默认运行带 integration 标签的测试,除非任务显式要求;若某个包有 FLOW.md,修改前先读、行为变化时同步更新。这正是仓库内三个 FLOW.md(pkg/db/FLOW.md、message/FLOW.md、meta/FLOW.md)的维护约定。

基准测试:验证重构不牺牲吞吐

消息域与 meta 域都要求补充基准并追踪 ns/op、allocs/op、bytes/op、提交批大小、写停滞与追加 p95/p99 延迟。计划给出的命令与用例:

go test -run '^$' -bench BenchmarkChannelLogAppend -benchmem ./pkg/db/message
go test -run '^$' -bench BenchmarkUserGet -benchmem ./pkg/db/meta
go test -run '^$' -bench . -benchmem ./pkg/db/message ./pkg/db/meta
  • 消息域:1/32/256 条记录的追加;1/4/16/64 频道并行追加;1/32/256 行正/反向读;按 message-id 查询;分块保留裁剪。仓库中已存在 BenchmarkChannelLogAppend、BenchmarkChannelLogAppendMatrix、BenchmarkChannelLogAppendParallel、BenchmarkChannelLogAppendParallelManyChannels 等(见 message_benchmark_integration_test.go);
  • meta 域:用户创建/读取/更新、频道创建/按 channel-id 列出/缓存读取、订阅者添加与分页、运行时元数据 upsert、混合 MetaBatch 应用、快照导出/导入。

Review Checklist:最终验收清单

实施完成前,计划要求逐项核验(计划第 1248-1261 行):

  • 没有任何 Go 文件 import pkg/channel/store 或 pkg/slot/meta;
  • Pebble 类型未暴露在 pkg/db/internal/* 之外(仓库中已有 message/import_boundary_test.go 这类边界测试);
  • 消息存储内部使用 seq 术语;
  • offset 换算只发生在频道协议/复制边界;
  • meta 写入不再使用单一整库全局锁;
  • 哈希槽快照导入导出使用 row/index/system 三种区间;
  • 频道缓存只在提交成功后发布;
  • FLOW.md 反映真实代码流;
  • AGENTS.md 目录结构保持最新;
  • 相关测试与基准冒烟有新鲜证据。

仓库现状与延伸阅读

从当前仓库看,pkg/db 已按本计划大规模落地:根包、internal/{engine,keycodec,rowcodec,schema,commit}、message 与 meta 领域包、transfer 离线导入导出工具均已实现;pkg/slot/meta 已不存在(pkg/slot 下只剩 fsm、multiraft、proxy),pkg/channel/store 仍保留(其中已演化为 adapter.go、channel_adapter.go、memory.go 等适配/内存实现形态,供频道层继续引用)。若需要基于本计划继续推进迁移,可按 Task 23-26 的"先记录导入面、再替换导入、最后删除"步骤操作。

延伸阅读建议:

登录后查看全文
WuKongIM