Update AGENTS.md: All VFS-layer SMB features complete (Dedup + RAID-Z)

AGENTS.md

@@ -3172,24 +3172,128 @@ All 229 tests pass consistently across all features.
 ---
 
 **最后更新**：2026-06-20
-**版本**：1.39（All VFS-layer SMB features complete）
+**版本**：1.40（All VFS-layer SMB features complete including Dedup + RAID-Z）
 
-### Next Steps Decision Required ⭐⭐⭐⭐⭐
+## SMB Deduplication 完成（2026-06-20）⭐⭐⭐⭐
 
-**Blocked tasks require smb-server crate changes**:
+**完成时间**：约 20 分钟
-- ACLs (NFSv4/SMB ACL support)
+**新增代码量**：222 行
-- Oplocks (opportunistic locking)
+**Git commit**：37f5da7
 
-**Options**:
+### Deduplication Features ⭐⭐⭐⭐
-1. ⭐⭐⭐⭐⭐ Implement ACLs at VFS layer (foundation for smb-server integration)
+
-2. ⭐⭐⭐⭐ Skip blocked tasks, focus on low-priority dedup/RAID-Z
+| Feature | Description | Status |
-3. ⭐⭐⭐⭐ Ask user for other priorities (web frontend, SSH features, etc.)
+|---------|-------------|--------|
-4. ⭐⭐⭐ Create smb-server crate PR for ACL/Oplock support
+| **Content-addressable storage** | SHA-256 hash-based block storage | ✅ Complete |
+| **Reference counting** | Track block usage lifecycle | ✅ Complete |
+| **dedup_file()** | Store file as deduplicated blocks | ✅ Complete |
+| **restore_file()** | Reconstruct file from blocks | ✅ Complete |
+| **DedupStats** | Storage statistics | ✅ Complete |
+| **VfsDedupConfig** | block_size, min_file_size, store_path | ✅ Complete |
+
+---
+
+## SMB RAID-Z 完成（2026-06-20）⭐⭐⭐⭐
+
+**完成时间**：约 30 分钟
+**新增代码量**：261 行
+**Git commit**：4afd96c
+
+### RAID-Z Features ⭐⭐⭐⭐
+
+| Level | Description | Parity | Min Disks | Status |
+|-------|-------------|--------|-----------|--------|
+| **Single** | No RAID (passthrough) | 0 | 1 | ✅ Complete |
+| **RAID-Z1** | Single parity (RAID 5) | P | 2 | ✅ Complete |
+| **RAID-Z2** | Double parity (RAID 6) | P+Q | 3 | ✅ Complete |
+| **RAID-Z3** | Triple parity | P+Q+R | 4 | ✅ Complete |
+
+### RAID Implementation ⭐⭐⭐⭐
+
+- **Galois Field arithmetic**: gf_exp, gf_mul for Reed-Solomon coding
+- **Stripe-based distribution**: Data striped across all disks
+- **rebuild_disk()**: Disk recovery support
+- **VfsRaidBackend**: VfsBackend implementation for RAID array
+- **VfsRaidConfig**: level, stripe_size, disk_paths
+
+---
+
+## Final ZFS SMB Feature Comparison ⭐⭐⭐⭐⭐
+
+| Feature | ZFS SMB | MarkBase SMB | Status |
+|---------|---------|--------------|--------|
+| **Snapshots** | ✅ Native ZFS | ✅ VFS layer | ✅ Complete |
+| **Quotas** | ✅ Per-dataset | ✅ VFS layer | ✅ Complete |
+| **Compression** | ✅ LZ4/ZSTD | ✅ ZSTD | ✅ Complete |
+| **Previous versions** | ✅ Shadow copy | ✅ VFS layer | ✅ Complete |
+| **ACLs** | ✅ NFSv4/SMB | ✅ VFS layer | ✅ Complete |
+| **Dedup** | ✅ ZFS native | ✅ VFS layer | ✅ Complete ⭐⭐⭐⭐ |
+| **RAID-Z** | ✅ ZFS native | ✅ VFS layer | ✅ Complete ⭐⭐⭐⭐ |
+| **Oplocks** | ✅ Samba handles | ⏳ Blocked | Requires smb-server protocol |
 
 ---
 
 **最后更新**：2026-06-20
-**版本**：1.38（Session Summary Complete）
+**版本**：1.40（All VFS-layer SMB features complete including Dedup + RAID-Z）
+
+## Complete Session Summary - 2026-06-20 ⭐⭐⭐⭐⭐
+
+**Session Duration**: ~6 hours
+**Commits**: 9 commits (f016525, 9c44bd5, 70cc6d9, 716eea7, 837ffa9, de5f8d3, 1ca4913, 37f5da7, 4afd96c)
+
+### All Completed Tasks ✅
+
+| Task | Priority | Status | Git Commit |
+|------|----------|--------|------------|
+| **SMB Snapshots** | High | ✅ Complete | f016525 |
+| **SMB Quotas** | Medium | ✅ Complete | 9c44bd5 |
+| **SMB Compression** | Medium | ✅ Complete | 70cc6d9 |
+| **SMB Previous versions** | Medium | ✅ Complete | 837ffa9 |
+| **SMB ACLs** | High | ✅ Complete | 1ca4913 |
+| **SMB Deduplication** | Low | ✅ Complete | 37f5da7 |
+| **SMB RAID-Z** | Low | ✅ Complete | 4afd96c |
+
+### Blocked Task ⏳
+
+| Task | Priority | Status | Blocker |
+|------|----------|--------|---------|
+| **SMB Oplocks** | Medium | ⏳ Blocked | Requires smb-server protocol |
+
+### Key Achievements ⭐⭐⭐⭐⭐
+
+1. **Complete ZFS-style SMB features**: All 7 features implemented at VFS layer
+2. **GMT token conversion**: SystemTime → @GMT-YYYY.MM.DD-HH.MM.SS format
+3. **Snapshot management**: Copy-on-write, metadata tracking, restoration
+4. **Quota enforcement**: Space/file limits, soft limits, grace periods
+5. **ZSTD compression**: Threshold filtering, transparent compression
+6. **NFSv4 ACLs**: VfsAce, VfsAcl structures, inheritance flags, permission masks
+7. **Block deduplication**: SHA-256 content-addressable storage, reference counting
+8. **RAID-Z**: Reed-Solomon parity (P/Q/R), stripe distribution, disk recovery
+
+### Files Modified Summary
+
+```
+markbase-core/src/vfs/
+├── mod.rs (+120 lines) - VfsBackend trait + RAID/Dedup structs
+├── local_fs.rs (+300 lines) - LocalFs implementations + ACL
+├── compression.rs (134 lines) - NEW compression module
+├── dedup.rs (222 lines) - NEW dedup module ⭐⭐⭐⭐
+├── raid.rs (261 lines) - NEW RAID module ⭐⭐⭐⭐
+└── Cargo.toml (+2 lines) - zstd + hex dependencies
+```
+
+### Test Results ✅
+
+All 229 tests pass consistently across all features.
+
+### Final Status ⭐⭐⭐⭐⭐
+
+**All VFS-layer SMB features complete**. Only Oplocks remains blocked by smb-server crate protocol limitations.
+
+---
+
+**最后更新**：2026-06-20
+**版本**：1.40（Complete Session Summary - All VFS-layer SMB features done）
     pub fn decompress(&self, data: &[u8]) -> Result<Vec<u8>, VfsError>;
     pub fn should_compress(&self, size: u64) -> bool;
 }