RecordStore V2 验证与历史资料仓库

活动程序集已并入 D:\Git Space\Runtime\Iwesun.Runtime.Data。本仓库不再生成或发布 Iwesun.Data.dll，只保留 RecordStore V2 测试、规模验证和历史文档。

当前正在验证的隔离实现是：

RecordStoreV2<TValue, TPrimaryKey>

它提供多 Key、业务主键、稳定记录身份、自适应索引、唯一约束、过滤与限制、自动 Merge、Publish、 Snapshot、View、Clone、JSON 持久化和可选访问 Gate。Source 坚持单写者模型；其他线程主要消费已完成的 只读 Snapshot。

DList及其JSON转换器已从活动程序集删除。旧消费者必须按迁移指南改用RecordStore V2，不能恢复 兼容别名。

当前状态

• 程序集版本：1.0.25；
• 目标框架：.NET 10 / net10.0；
• V2功能、异常安全、空桶生命周期和消费者数据路径已完成本轮验证；
• V2仍保持隔离名称，单位记录内存和整体性能未达到正式晋升门槛；
• 不得把当前状态描述为“已与1.0.25性能等价”或直接改名为正式RecordStore。

文档入口

• 开发与发布状态
• 完整文档索引
• V2唯一设计权威
• 空索引桶生命周期审查与整改证据
• V2对外API说明
• 完整功能、安全与性能复验报告
• 发布更新记录

项目结构

../Runtime/Iwesun.Runtime.Data/  唯一活动源码与程序集
Iwesun.Runtime.Data.Tests/      RecordStore V2 功能、契约、异常和安全测试
Iwesun.Runtime.Data.ScaleTest/  大规模内存、索引、发布与长期运行测试
docs/                   设计、API、迁移和验证资料
archive/                已忽略的废止源码存档，不参与编译和发布

构建与测试

dotnet build Data.slnx -c Debug
dotnet build Data.slnx -c Release
dotnet test Data.slnx -c Debug
dotnet test Data.slnx -c Release

当前活动测试基线为 Debug/Release 各 86 项。规模测试独立运行：

dotnet run --project Iwesun.Runtime.Data.ScaleTest/Iwesun.Runtime.Data.ScaleTest.csproj -c Release -- --target-mb 128 --mode publish
dotnet run --project Iwesun.Runtime.Data.ScaleTest/Iwesun.Runtime.Data.ScaleTest.csproj -c Release --no-build -- --target-mb 256 --mode aggregate
dotnet run --project Iwesun.Runtime.Data.ScaleTest/Iwesun.Runtime.Data.ScaleTest.csproj -c Release --no-build -- --records 100000 --mode hotpath
dotnet run --project Iwesun.Runtime.Data.ScaleTest/Iwesun.Runtime.Data.ScaleTest.csproj -c Release --no-build -- --mode churn

本轮128/256 MiB普通与聚合发布、10万次Update/废止热路径、固定1万Active连续替换100万次均通过。 性能数据用于同机同轮比较，不是跨机器承诺；详细数字以复验报告为准。

维护原则

• RecordStore保持业务无关，消费者业务类型不得进入本项目；
• 公开API变更必须同步设计、API、迁移、样例和测试；
• 比较器和业务委托只在准备阶段运行，提交阶段不得重新调用用户代码；
• 稳定顺序、StoreRecordId、值所有权、Snapshot边界和Schema恢复契约不得回退；
• 不恢复DList活动源码或兼容类型。