Initial commit: SRDB - High-performance LSM-Tree database

- Core engine with MemTable, SST, WAL - B+Tree indexing for SST files - Leveled compaction strategy - Multi-table database management - Schema validation and secondary indexes - Query builder with complex conditions - Web UI with HTMX for data visualization - Command-line tools for diagnostics
2025-10-08 06:38:12 +08:00
commit ae87c38776
61 changed files with 15475 additions and 0 deletions
--- a/examples/README.md
+++ b/examples/README.md
@@ -0,0 +1,481 @@
+# SRDB Examples
+
+本目录包含 SRDB 数据库的示例程序和工具。
+
+## 目录结构
+
+```
+examples/
+└── webui/              # Web UI 和命令行工具集
+    ├── main.go         # 主入口点
+    ├── commands/       # 命令实现
+    │   ├── webui.go            # Web UI 服务器
+    │   ├── check_data.go       # 数据检查工具
+    │   ├── check_seq.go        # 序列号检查工具
+    │   ├── dump_manifest.go    # Manifest 导出工具
+    │   ├── inspect_all_sst.go  # SST 文件批量检查
+    │   ├── inspect_sst.go      # SST 文件检查工具
+    │   ├── test_fix.go         # 修复测试工具
+    │   └── test_keys.go        # 键存在性测试工具
+    └── README.md       # WebUI 详细文档
+```
+
+---
+
+## WebUI - 数据库管理工具
+
+一个集成了 Web 界面和命令行工具的 SRDB 数据库管理工具。
+
+### 功能特性
+
+#### 🌐 Web UI
+- **表列表展示** - 可视化查看所有表及其 Schema
+- **数据分页浏览** - 表格形式展示数据，支持分页和列选择
+- **Manifest 查看** - 查看 LSM-Tree 结构和 Compaction 状态
+- **响应式设计** - 基于 HTMX 的现代化界面
+- **大数据优化** - 自动截断显示，点击查看完整内容
+
+#### 🛠️ 命令行工具
+- **数据检查** - 检查表和数据完整性
+- **序列号验证** - 验证特定序列号的数据
+- **Manifest 导出** - 导出 LSM-Tree 层级信息
+- **SST 文件检查** - 检查和诊断 SST 文件问题
+
+### 快速开始
+
+#### 1. 启动 Web UI
+
+```bash
+cd examples/webui
+
+# 使用默认配置（数据库：./data，端口：8080）
+go run main.go serve
+
+# 或指定自定义配置
+go run main.go serve -db ./mydb -addr :3000
+```
+
+然后打开浏览器访问 `http://localhost:8080`
+
+#### 2. 查看帮助
+
+```bash
+go run main.go help
+```
+
+输出：
+```
+SRDB WebUI - Database management tool
+
+Usage:
+  webui <command> [flags]
+
+Commands:
+  webui, serve       Start WebUI server (default: :8080)
+  check-data         Check database tables and row counts
+  check-seq          Check specific sequence numbers
+  dump-manifest      Dump manifest information
+  inspect-all-sst    Inspect all SST files
+  inspect-sst        Inspect a specific SST file
+  test-fix           Test fix for data retrieval
+  test-keys          Test key existence
+  help               Show this help message
+
+Examples:
+  webui serve -db ./mydb -addr :3000
+  webui check-data -db ./mydb
+  webui inspect-sst -file ./data/logs/sst/000046.sst
+```
+
+---
+
+## 命令详解
+
+### serve / webui - 启动 Web 服务器
+
+启动 Web UI 服务器，提供数据可视化界面。
+
+```bash
+# 基本用法
+go run main.go serve
+
+# 指定数据库路径和端口
+go run main.go webui -db ./mydb -addr :3000
+```
+
+**参数**：
+- `-db` - 数据库目录路径（默认：`./data`）
+- `-addr` - 服务器地址（默认：`:8080`）
+
+**功能**：
+- 自动创建示例表（users, products, logs）
+- 后台自动插入测试数据（每秒一条）
+- 提供 Web UI 和 HTTP API
+
+---
+
+### check-data - 检查数据
+
+检查数据库中所有表的记录数。
+
+```bash
+go run main.go check-data -db ./data
+```
+
+**输出示例**：
+```
+Found 3 tables: [users products logs]
+Table 'users': 5 rows
+Table 'products': 6 rows
+Table 'logs': 1234 rows
+```
+
+---
+
+### check-seq - 检查序列号
+
+验证特定序列号的数据是否存在。
+
+```bash
+go run main.go check-seq -db ./data
+```
+
+**功能**：
+- 检查 seq=1, 100, 729 等特定序列号
+- 显示总记录数
+- 验证数据完整性
+
+---
+
+### dump-manifest - 导出 Manifest
+
+导出数据库的 Manifest 信息，检查文件重复。
+
+```bash
+go run main.go dump-manifest -db ./data
+```
+
+**输出示例**：
+```
+Level 0: 5 files
+Level 1: 3 files
+Level 2: 1 files
+```
+
+---
+
+### inspect-all-sst - 批量检查 SST 文件
+
+检查所有 SST 文件的完整性。
+
+```bash
+go run main.go inspect-all-sst -dir ./data/logs/sst
+```
+
+**输出示例**：
+```
+Found 10 SST files
+
+File #1 (000001.sst):
+  Header: MinKey=1 MaxKey=100 RowCount=100
+  Actual: 100 keys [1 ... 100]
+
+File #2 (000002.sst):
+  Header: MinKey=101 MaxKey=200 RowCount=100
+  Actual: 100 keys [101 ... 200]
+  *** MISMATCH: Header says 101-200 but file has 105-200 ***
+```
+
+---
+
+### inspect-sst - 检查单个 SST 文件
+
+详细检查特定 SST 文件。
+
+```bash
+go run main.go inspect-sst -file ./data/logs/sst/000046.sst
+```
+
+**输出示例**：
+```
+File: ./data/logs/sst/000046.sst
+Size: 524288 bytes
+
+Header:
+  RowCount: 100
+  MinKey: 332
+  MaxKey: 354
+  DataSize: 512000 bytes
+
+Actual keys in file: 100 keys
+  First key: 332
+  Last key: 354
+  All keys: [332 333 334 ... 354]
+
+Trying to get key 332:
+  FOUND: seq=332, time=1234567890
+```
+
+---
+
+### test-fix - 测试修复
+
+测试数据检索的修复功能。
+
+```bash
+go run main.go test-fix -db ./data
+```
+
+**功能**：
+- 测试首部、中部、尾部记录
+- 验证 Get() 操作的正确性
+- 显示修复状态
+
+---
+
+### test-keys - 测试键存在性
+
+测试特定键是否存在。
+
+```bash
+go run main.go test-keys -db ./data
+```
+
+**功能**：
+- 测试预定义的键列表
+- 统计找到的键数量
+- 显示首尾记录
+
+---
+
+## 编译安装
+
+### 编译二进制
+
+```bash
+cd examples/webui
+go build -o webui main.go
+```
+
+### 全局安装
+
+```bash
+go install ./examples/webui@latest
+```
+
+然后可以在任何地方使用：
+
+```bash
+webui serve -db ./mydb
+webui check-data -db ./mydb
+```
+
+---
+
+## Web UI 使用
+
+### 界面布局
+
+访问 `http://localhost:8080` 后，你会看到：
+
+**左侧边栏**：
+- 表列表，显示每个表的字段数
+- 点击展开查看 Schema 详情
+- 点击表名切换到该表
+
+**右侧主区域**：
+- **Data 视图**：数据表格，支持分页和列选择
+- **Manifest 视图**：LSM-Tree 结构和 Compaction 状态
+
+### HTTP API 端点
+
+#### 获取表列表
+```
+GET /api/tables-html
+```
+
+#### 获取表数据
+```
+GET /api/tables-view/{table_name}?page=1&pageSize=20
+```
+
+#### 获取 Manifest
+```
+GET /api/tables-view/{table_name}/manifest
+```
+
+#### 获取 Schema
+```
+GET /api/tables/{table_name}/schema
+```
+
+#### 获取单条数据
+```
+GET /api/tables/{table_name}/data/{seq}
+```
+
+详细 API 文档请参考：[webui/README.md](webui/README.md)
+
+---
+
+## 在你的应用中集成
+
+### 方式 1：使用 WebUI 包
+
+```go
+package main
+
+import (
+    "net/http"
+    "code.tczkiot.com/srdb"
+    "code.tczkiot.com/srdb/webui"
+)
+
+func main() {
+    db, _ := srdb.Open("./mydb")
+    defer db.Close()
+
+    // 创建 WebUI handler
+    handler := webui.NewWebUI(db)
+
+    // 启动服务器
+    http.ListenAndServe(":8080", handler)
+}
+```
+
+### 方式 2：挂载到现有应用
+
+```go
+mux := http.NewServeMux()
+
+// 你的其他路由
+mux.HandleFunc("/api/myapp", myHandler)
+
+// 挂载 SRDB Web UI 到 /admin/db 路径
+mux.Handle("/admin/db/", http.StripPrefix("/admin/db", webui.NewWebUI(db)))
+
+http.ListenAndServe(":8080", mux)
+```
+
+### 方式 3：使用命令工具
+
+将 webui 工具的命令集成到你的应用：
+
+```go
+import "code.tczkiot.com/srdb/examples/webui/commands"
+
+// 检查数据
+commands.CheckData("./mydb")
+
+// 导出 manifest
+commands.DumpManifest("./mydb")
+
+// 启动服务器
+commands.StartWebUI("./mydb", ":8080")
+```
+
+---
+
+## 开发和调试
+
+### 开发模式
+
+在开发时，使用 `go run` 可以快速测试：
+
+```bash
+# 启动服务器
+go run main.go serve
+
+# 在另一个终端检查数据
+go run main.go check-data
+
+# 检查 SST 文件
+go run main.go inspect-all-sst
+```
+
+### 清理数据
+
+```bash
+# 删除数据目录
+rm -rf ./data
+
+# 重新运行
+go run main.go serve
+```
+
+---
+
+## 注意事项
+
+1. **数据目录**：默认在当前目录创建 `./data` 目录
+2. **端口占用**：确保端口未被占用
+3. **并发访问**：Web UI 支持多用户并发访问
+4. **只读模式**：Web UI 仅用于查看，不提供数据修改功能
+5. **生产环境**：建议添加身份验证和访问控制
+6. **性能考虑**：大表分页查询性能取决于数据分布
+
+---
+
+## 技术栈
+
+- **后端**：Go 标准库（net/http）
+- **前端**：HTMX + 原生 JavaScript + CSS
+- **渲染**：服务端 HTML 渲染（Go）
+- **数据库**：SRDB (LSM-Tree)
+- **部署**：所有静态资源通过 embed 嵌入，无需单独部署
+
+---
+
+## 故障排除
+
+### 常见问题
+
+**1. 启动失败 - 端口被占用**
+```bash
+Error: listen tcp :8080: bind: address already in use
+```
+解决：使用 `-addr` 指定其他端口
+```bash
+go run main.go serve -addr :3000
+```
+
+**2. 数据库打开失败**
+```bash
+Error: failed to open database: invalid header
+```
+解决：删除损坏的数据目录
+```bash
+rm -rf ./data
+```
+
+**3. SST 文件损坏**
+使用 `inspect-sst` 或 `inspect-all-sst` 命令诊断：
+```bash
+go run main.go inspect-all-sst -dir ./data/logs/sst
+```
+
+---
+
+## 更多信息
+
+- **WebUI 详细文档**：[webui/README.md](webui/README.md)
+- **SRDB 主文档**：[../README.md](../README.md)
+- **Compaction 说明**：[../COMPACTION.md](../COMPACTION.md)
+- **压力测试报告**：[../STRESS_TEST_RESULTS.md](../STRESS_TEST_RESULTS.md)
+
+---
+
+## 贡献
+
+欢迎贡献新的示例和工具！请遵循以下规范：
+
+1. 在 `examples/` 下创建新的子目录
+2. 提供清晰的 README 文档
+3. 添加示例代码和使用说明
+4. 更新本文件
+
+---
+
+## 许可证
+
+与 SRDB 项目相同的许可证。
--- a/examples/webui/README.md
+++ b/examples/webui/README.md
@@ -0,0 +1,254 @@
+# SRDB Web UI Example
+
+这个示例展示了如何使用 SRDB 的内置 Web UI 来可视化查看数据库中的表和数据。
+
+## 功能特性
+
+- 📊 **表列表展示** - 左侧显示所有表及其行数
+- 🔍 **Schema 查看** - 点击箭头展开查看表的字段定义
+- 📋 **数据分页浏览** - 右侧以表格形式展示数据，支持分页
+- 🎨 **响应式设计** - 现代化的界面设计
+- ⚡ **零构建** - 使用 HTMX 从 CDN 加载，无需构建步骤
+- 💾 **大数据优化** - 自动截断显示，悬停查看，点击弹窗查看完整内容
+- 📏 **数据大小显示** - 超过 1KB 的单元格自动显示大小标签
+- 🔄 **后台数据插入** - 自动生成 2KB~512KB 的测试数据（每秒一条）
+
+## 运行示例
+
+```bash
+# 进入示例目录
+cd examples/webui
+
+# 运行
+go run main.go
+```
+
+程序会：
+1. 创建/打开数据库目录 `./data`
+2. 创建三个示例表：`users`、`products` 和 `logs`
+3. 插入初始示例数据
+4. **启动后台协程** - 每秒向 `logs` 表插入一条 2KB~512KB 的随机数据
+5. 启动 Web 服务器在 `http://localhost:8080`
+
+## 使用界面
+
+打开浏览器访问 `http://localhost:8080`，你将看到：
+
+### 左侧边栏
+- 显示所有表的列表
+- 显示每个表的字段数量
+- 点击 ▶ 图标展开查看字段信息
+- 点击表名选择要查看的表（蓝色高亮显示当前选中）
+
+### 右侧主区域
+- **Schema 区域**：显示表结构和字段定义
+- **Data 区域**：以表格形式显示数据
+  - 支持分页浏览（每页 20 条）
+  - 显示系统字段（_seq, _time）和用户字段
+  - **自动截断长数据**：超过 400px 的内容显示省略号
+  - **鼠标悬停**：悬停在单元格上查看完整内容
+  - **点击查看**：点击单元格在弹窗中查看完整内容
+  - **大小指示**：超过 1KB 的数据显示大小标签
+
+### 大数据查看
+1. **表格截断**：单元格最大宽度 400px，超长显示 `...`
+2. **悬停展开**：鼠标悬停自动展开，黄色背景高亮
+3. **模态框**：点击单元格弹出窗口
+   - 等宽字体显示（适合查看十六进制数据）
+   - 显示数据大小
+   - 支持滚动查看超长内容
+
+## API 端点
+
+Web UI 提供了以下 HTTP API：
+
+### 获取所有表
+```
+GET /api/tables
+```
+
+返回示例：
+```json
+[
+  {
+    "name": "users",
+    "rowCount": 5,
+    "dir": "./data/users"
+  }
+]
+```
+
+### 获取表的 Schema
+```
+GET /api/tables/{name}/schema
+```
+
+返回示例：
+```json
+{
+  "fields": [
+    {"name": "name", "type": "string", "required": true},
+    {"name": "email", "type": "string", "required": true},
+    {"name": "age", "type": "int", "required": false}
+  ]
+}
+```
+
+### 获取表数据（分页）
+```
+GET /api/tables/{name}/data?page=1&pageSize=20
+```
+
+参数：
+- `page` - 页码，从 1 开始（默认：1）
+- `pageSize` - 每页行数，最大 100（默认：20）
+
+返回示例：
+```json
+{
+  "page": 1,
+  "pageSize": 20,
+  "totalRows": 5,
+  "totalPages": 1,
+  "rows": [
+    {
+      "_seq": 1,
+      "_time": 1234567890,
+      "name": "Alice",
+      "email": "alice@example.com",
+      "age": 30
+    }
+  ]
+}
+```
+
+### 获取表基本信息
+```
+GET /api/tables/{name}
+```
+
+## 在你的应用中使用
+
+你可以在自己的应用中轻松集成 Web UI：
+
+```go
+package main
+
+import (
+    "net/http"
+    "code.tczkiot.com/srdb"
+)
+
+func main() {
+    // 打开数据库
+    db, _ := database.Open("./mydb")
+    defer db.Close()
+
+    // 获取 HTTP Handler
+    handler := db.WebUI()
+
+    // 启动服务器
+    http.ListenAndServe(":8080", handler)
+}
+```
+
+或者将其作为现有 Web 应用的一部分：
+
+```go
+mux := http.NewServeMux()
+
+// 你的其他路由
+mux.HandleFunc("/api/myapp", myHandler)
+
+// 挂载 SRDB Web UI 到 /admin/db 路径
+mux.Handle("/admin/db/", http.StripPrefix("/admin/db", db.WebUI()))
+
+http.ListenAndServe(":8080", mux)
+```
+
+## 技术栈
+
+- **后端**: Go + 标准库 `net/http`
+- **前端**: [HTMX](https://htmx.org/) + 原生 JavaScript + CSS
+- **渲染**: 服务端 HTML 渲染（Go 模板生成）
+- **字体**: Google Fonts (Inter)
+- **无构建**: 直接从 CDN 加载 HTMX，无需 npm、webpack 等工具
+- **部署**: 所有静态资源通过 `embed.FS` 嵌入到二进制文件中
+
+## 测试大数据
+
+### logs 表自动生成
+
+程序会在后台持续向 `logs` 表插入大数据：
+
+- **频率**：每秒一条
+- **大小**：2KB ~ 512KB 随机
+- **格式**：十六进制字符串
+- **字段**：
+  - `timestamp` - 插入时间
+  - `data` - 随机数据（十六进制）
+  - `size_bytes` - 数据大小（字节）
+
+你可以选择 `logs` 表来测试大数据的显示效果：
+1. 单元格会显示数据大小标签（如 `245.12 KB`）
+2. 内容被自动截断，显示省略号
+3. 点击单元格在弹窗中查看完整数据
+
+终端会实时输出插入日志：
+```
+Inserted record #1, size: 245.12 KB
+Inserted record #2, size: 128.50 KB
+Inserted record #3, size: 487.23 KB
+```
+
+## 注意事项
+
+- Web UI 是只读的，不提供数据修改功能
+- 适合用于开发、调试和数据查看
+- 生产环境建议添加身份验证和访问控制
+- 大数据量表的分页查询性能取决于数据分布
+- `logs` 表会持续增长，可手动删除 `./data/logs` 目录重置
+
+## Compaction 状态
+
+由于后台持续插入大数据，会产生大量 SST 文件。SRDB 会自动运行 compaction 合并这些文件。
+
+### 检查 Compaction 状态
+
+```bash
+# 查看 SST 文件分布
+./check_sst.sh
+
+# 观察 webui 日志中的 [Compaction] 信息
+```
+
+### Compaction 改进
+
+- **触发阈值**: L0 文件数量 ≥2 就触发（之前是 4）
+- **运行频率**: 每 10 秒自动检查
+- **日志增强**: 显示详细的 compaction 状态和统计
+
+详细说明请查看 [COMPACTION.md](./COMPACTION.md)
+
+## 常见问题
+
+### `invalid header` 错误
+
+如果看到类似错误：
+```
+failed to open table logs: invalid header
+```
+
+**快速修复**：
+```bash
+./fix_corrupted_table.sh logs
+```
+
+详见：[QUICK_FIX.md](./QUICK_FIX.md) 或 [TROUBLESHOOTING.md](./TROUBLESHOOTING.md)
+
+## 更多信息
+
+- [FEATURES.md](./FEATURES.md) - 详细功能说明
+- [COMPACTION.md](./COMPACTION.md) - Compaction 机制和诊断
+- [TROUBLESHOOTING.md](./TROUBLESHOOTING.md) - 故障排除指南
+- [QUICK_FIX.md](./QUICK_FIX.md) - 快速修复常见错误
--- a/examples/webui/commands/check_data.go
+++ b/examples/webui/commands/check_data.go
@@ -0,0 +1,40 @@
+package commands
+
+import (
+	"fmt"
+	"log"
+
+	"code.tczkiot.com/srdb"
+)
+
+// CheckData 检查数据库中的数据
+func CheckData(dbPath string) {
+	// 打开数据库
+	db, err := srdb.Open(dbPath)
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer db.Close()
+
+	// 列出所有表
+	tables := db.ListTables()
+	fmt.Printf("Found %d tables: %v\n", len(tables), tables)
+
+	// 检查每个表的记录数
+	for _, tableName := range tables {
+		table, err := db.GetTable(tableName)
+		if err != nil {
+			fmt.Printf("Error getting table %s: %v\n", tableName, err)
+			continue
+		}
+
+		result, err := table.Query().Rows()
+		if err != nil {
+			fmt.Printf("Error querying table %s: %v\n", tableName, err)
+			continue
+		}
+
+		count := result.Count()
+		fmt.Printf("Table '%s': %d rows\n", tableName, count)
+	}
+}
--- a/examples/webui/commands/check_seq.go
+++ b/examples/webui/commands/check_seq.go
@@ -0,0 +1,69 @@
+package commands
+
+import (
+	"fmt"
+	"log"
+
+	"code.tczkiot.com/srdb"
+)
+
+// CheckSeq 检查特定序列号的数据
+func CheckSeq(dbPath string) {
+	db, err := srdb.Open(dbPath)
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer db.Close()
+
+	table, err := db.GetTable("logs")
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	// Check seq 1
+	row1, err := table.Get(1)
+	if err != nil {
+		fmt.Printf("Error getting seq=1: %v\n", err)
+	} else if row1 == nil {
+		fmt.Println("Seq=1: NOT FOUND")
+	} else {
+		fmt.Printf("Seq=1: FOUND (time=%d)\n", row1.Time)
+	}
+
+	// Check seq 100
+	row100, err := table.Get(100)
+	if err != nil {
+		fmt.Printf("Error getting seq=100: %v\n", err)
+	} else if row100 == nil {
+		fmt.Println("Seq=100: NOT FOUND")
+	} else {
+		fmt.Printf("Seq=100: FOUND (time=%d)\n", row100.Time)
+	}
+
+	// Check seq 729
+	row729, err := table.Get(729)
+	if err != nil {
+		fmt.Printf("Error getting seq=729: %v\n", err)
+	} else if row729 == nil {
+		fmt.Println("Seq=729: NOT FOUND")
+	} else {
+		fmt.Printf("Seq=729: FOUND (time=%d)\n", row729.Time)
+	}
+
+	// Query all records
+	result, err := table.Query().Rows()
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	count := result.Count()
+	fmt.Printf("\nTotal rows from Query: %d\n", count)
+
+	if count > 0 {
+		first, _ := result.First()
+		if first != nil {
+			data := first.Data()
+			fmt.Printf("First row _seq: %v\n", data["_seq"])
+		}
+	}
+}
--- a/examples/webui/commands/dump_manifest.go
+++ b/examples/webui/commands/dump_manifest.go
@@ -0,0 +1,58 @@
+package commands
+
+import (
+	"fmt"
+	"log"
+
+	"code.tczkiot.com/srdb"
+)
+
+// DumpManifest 导出 manifest 信息
+func DumpManifest(dbPath string) {
+	db, err := srdb.Open(dbPath)
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer db.Close()
+
+	table, err := db.GetTable("logs")
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	engine := table.GetEngine()
+	versionSet := engine.GetVersionSet()
+	version := versionSet.GetCurrent()
+
+	// Check for duplicates in each level
+	for level := 0; level < 7; level++ {
+		files := version.GetLevel(level)
+		if len(files) == 0 {
+			continue
+		}
+
+		// Track file numbers
+		fileMap := make(map[int64][]struct {
+			minKey int64
+			maxKey int64
+		})
+
+		for _, f := range files {
+			fileMap[f.FileNumber] = append(fileMap[f.FileNumber], struct {
+				minKey int64
+				maxKey int64
+			}{f.MinKey, f.MaxKey})
+		}
+
+		// Report duplicates
+		fmt.Printf("Level %d: %d files\n", level, len(files))
+		for fileNum, entries := range fileMap {
+			if len(entries) > 1 {
+				fmt.Printf("  [DUPLICATE] File #%d appears %d times:\n", fileNum, len(entries))
+				for i, e := range entries {
+					fmt.Printf("    Entry %d: min=%d max=%d\n", i+1, e.minKey, e.maxKey)
+				}
+			}
+		}
+	}
+}
--- a/examples/webui/commands/inspect_all_sst.go
+++ b/examples/webui/commands/inspect_all_sst.go
@@ -0,0 +1,72 @@
+package commands
+
+import (
+	"fmt"
+	"log"
+	"os"
+	"path/filepath"
+	"sort"
+	"strconv"
+	"strings"
+
+	"code.tczkiot.com/srdb/sst"
+)
+
+// InspectAllSST 检查所有 SST 文件
+func InspectAllSST(sstDir string) {
+	// List all SST files
+	files, err := os.ReadDir(sstDir)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	var sstFiles []string
+	for _, file := range files {
+		if strings.HasSuffix(file.Name(), ".sst") {
+			sstFiles = append(sstFiles, file.Name())
+		}
+	}
+
+	sort.Strings(sstFiles)
+
+	fmt.Printf("Found %d SST files\n\n", len(sstFiles))
+
+	// Inspect each file
+	for _, filename := range sstFiles {
+		sstPath := filepath.Join(sstDir, filename)
+
+		reader, err := sst.NewReader(sstPath)
+		if err != nil {
+			fmt.Printf("%s: ERROR - %v\n", filename, err)
+			continue
+		}
+
+		header := reader.GetHeader()
+		allKeys := reader.GetAllKeys()
+
+		// Extract file number
+		numStr := strings.TrimPrefix(filename, "000")
+		numStr = strings.TrimPrefix(numStr, "00")
+		numStr = strings.TrimPrefix(numStr, "0")
+		numStr = strings.TrimSuffix(numStr, ".sst")
+		fileNum, _ := strconv.Atoi(numStr)
+
+		fmt.Printf("File #%d (%s):\n", fileNum, filename)
+		fmt.Printf("  Header: MinKey=%d MaxKey=%d RowCount=%d\n", header.MinKey, header.MaxKey, header.RowCount)
+		fmt.Printf("  Actual: %d keys", len(allKeys))
+		if len(allKeys) > 0 {
+			fmt.Printf(" [%d ... %d]", allKeys[0], allKeys[len(allKeys)-1])
+		}
+		fmt.Printf("\n")
+
+		// Check if header matches actual keys
+		if len(allKeys) > 0 {
+			if header.MinKey != allKeys[0] || header.MaxKey != allKeys[len(allKeys)-1] {
+				fmt.Printf("  *** MISMATCH: Header says %d-%d but file has %d-%d ***\n",
+					header.MinKey, header.MaxKey, allKeys[0], allKeys[len(allKeys)-1])
+			}
+		}
+
+		reader.Close()
+	}
+}
--- a/examples/webui/commands/inspect_sst.go
+++ b/examples/webui/commands/inspect_sst.go
@@ -0,0 +1,75 @@
+package commands
+
+import (
+	"fmt"
+	"log"
+	"os"
+
+	"code.tczkiot.com/srdb/sst"
+)
+
+// InspectSST 检查特定 SST 文件
+func InspectSST(sstPath string) {
+	// Check if file exists
+	info, err := os.Stat(sstPath)
+	if err != nil {
+		log.Fatal(err)
+	}
+	fmt.Printf("File: %s\n", sstPath)
+	fmt.Printf("Size: %d bytes\n", info.Size())
+
+	// Open reader
+	reader, err := sst.NewReader(sstPath)
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer reader.Close()
+
+	// Get header
+	header := reader.GetHeader()
+	fmt.Printf("\nHeader:\n")
+	fmt.Printf("  RowCount: %d\n", header.RowCount)
+	fmt.Printf("  MinKey: %d\n", header.MinKey)
+	fmt.Printf("  MaxKey: %d\n", header.MaxKey)
+	fmt.Printf("  DataSize: %d bytes\n", header.DataSize)
+
+	// Get all keys using GetAllKeys()
+	allKeys := reader.GetAllKeys()
+	fmt.Printf("\nActual keys in file: %d keys\n", len(allKeys))
+	if len(allKeys) > 0 {
+		fmt.Printf("  First key: %d\n", allKeys[0])
+		fmt.Printf("  Last key: %d\n", allKeys[len(allKeys)-1])
+
+		if len(allKeys) <= 30 {
+			fmt.Printf("  All keys: %v\n", allKeys)
+		} else {
+			fmt.Printf("  First 15: %v\n", allKeys[:15])
+			fmt.Printf("  Last 15: %v\n", allKeys[len(allKeys)-15:])
+		}
+	}
+
+	// Try to get a specific key
+	fmt.Printf("\nTrying to get key 332:\n")
+	row, err := reader.Get(332)
+	if err != nil {
+		fmt.Printf("  Error: %v\n", err)
+	} else if row == nil {
+		fmt.Printf("  NULL\n")
+	} else {
+		fmt.Printf("  FOUND: seq=%d, time=%d\n", row.Seq, row.Time)
+	}
+
+	// Try to get key based on actual first key
+	if len(allKeys) > 0 {
+		firstKey := allKeys[0]
+		fmt.Printf("\nTrying to get actual first key %d:\n", firstKey)
+		row, err := reader.Get(firstKey)
+		if err != nil {
+			fmt.Printf("  Error: %v\n", err)
+		} else if row == nil {
+			fmt.Printf("  NULL\n")
+		} else {
+			fmt.Printf("  FOUND: seq=%d, time=%d\n", row.Seq, row.Time)
+		}
+	}
+}
--- a/examples/webui/commands/test_fix.go
+++ b/examples/webui/commands/test_fix.go
@@ -0,0 +1,59 @@
+package commands
+
+import (
+	"fmt"
+	"log"
+
+	"code.tczkiot.com/srdb"
+)
+
+// TestFix 测试修复
+func TestFix(dbPath string) {
+	db, err := srdb.Open(dbPath)
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer db.Close()
+
+	table, err := db.GetTable("logs")
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	// Get total count
+	result, err := table.Query().Rows()
+	if err != nil {
+		log.Fatal(err)
+	}
+	totalCount := result.Count()
+	fmt.Printf("Total rows in Query(): %d\n", totalCount)
+
+	// Test Get() for first 10, middle 10, and last 10
+	testRanges := []struct {
+		name  string
+		start int64
+		end   int64
+	}{
+		{"First 10", 1, 10},
+		{"Middle 10", 50, 59},
+		{"Last 10", int64(totalCount) - 9, int64(totalCount)},
+	}
+
+	for _, tr := range testRanges {
+		fmt.Printf("\n%s (keys %d-%d):\n", tr.name, tr.start, tr.end)
+		foundCount := 0
+		for seq := tr.start; seq <= tr.end; seq++ {
+			row, err := table.Get(seq)
+			if err != nil {
+				fmt.Printf("  Seq %d: ERROR - %v\n", seq, err)
+			} else if row == nil {
+				fmt.Printf("  Seq %d: NULL\n", seq)
+			} else {
+				foundCount++
+			}
+		}
+		fmt.Printf("  Found: %d/%d\n", foundCount, tr.end-tr.start+1)
+	}
+
+	fmt.Printf("\n✅ If all keys found, the bug is FIXED!\n")
+}
--- a/examples/webui/commands/test_keys.go
+++ b/examples/webui/commands/test_keys.go
@@ -0,0 +1,66 @@
+package commands
+
+import (
+	"fmt"
+	"log"
+
+	"code.tczkiot.com/srdb"
+)
+
+// TestKeys 测试键
+func TestKeys(dbPath string) {
+	db, err := srdb.Open(dbPath)
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer db.Close()
+
+	table, err := db.GetTable("logs")
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	// Test keys from different ranges
+	testKeys := []int64{
+		1, 100, 331, 332, 350, 400, 447, 500, 600, 700, 800, 850, 861, 862, 900, 1000, 1500, 1665, 1666, 1723,
+	}
+
+	fmt.Println("Testing key existence:")
+	foundCount := 0
+	for _, key := range testKeys {
+		row, err := table.Get(key)
+		if err != nil {
+			fmt.Printf("Key %4d: NOT FOUND (%v)\n", key, err)
+		} else if row == nil {
+			fmt.Printf("Key %4d: NULL\n", key)
+		} else {
+			fmt.Printf("Key %4d: FOUND (time=%d)\n", key, row.Time)
+			foundCount++
+		}
+	}
+
+	fmt.Printf("\nFound %d out of %d test keys\n", foundCount, len(testKeys))
+
+	// Query all
+	result, err := table.Query().Rows()
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	count := result.Count()
+	fmt.Printf("Total rows from Query: %d\n", count)
+
+	if count > 0 {
+		first, _ := result.First()
+		if first != nil {
+			data := first.Data()
+			fmt.Printf("First row _seq: %v\n", data["_seq"])
+		}
+
+		last, _ := result.Last()
+		if last != nil {
+			data := last.Data()
+			fmt.Printf("Last row _seq: %v\n", data["_seq"])
+		}
+	}
+}
--- a/examples/webui/commands/webui.go
+++ b/examples/webui/commands/webui.go
@@ -0,0 +1,192 @@
+package commands
+
+import (
+	"crypto/rand"
+	"fmt"
+	"log"
+	"math/big"
+	"net/http"
+	"slices"
+	"time"
+
+	"code.tczkiot.com/srdb"
+	"code.tczkiot.com/srdb/webui"
+)
+
+// StartWebUI 启动 WebUI 服务器
+func StartWebUI(dbPath string, addr string) {
+	// 打开数据库
+	db, err := srdb.Open(dbPath)
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer db.Close()
+
+	// 创建示例 Schema
+	userSchema := srdb.NewSchema("users", []srdb.Field{
+		{Name: "name", Type: srdb.FieldTypeString, Indexed: false, Comment: "User name"},
+		{Name: "email", Type: srdb.FieldTypeString, Indexed: false, Comment: "Email address"},
+		{Name: "age", Type: srdb.FieldTypeInt64, Indexed: false, Comment: "Age"},
+		{Name: "city", Type: srdb.FieldTypeString, Indexed: false, Comment: "City"},
+	})
+
+	productSchema := srdb.NewSchema("products", []srdb.Field{
+		{Name: "product_name", Type: srdb.FieldTypeString, Indexed: false, Comment: "Product name"},
+		{Name: "price", Type: srdb.FieldTypeFloat, Indexed: false, Comment: "Price"},
+		{Name: "quantity", Type: srdb.FieldTypeInt64, Indexed: false, Comment: "Quantity"},
+		{Name: "category", Type: srdb.FieldTypeString, Indexed: false, Comment: "Category"},
+	})
+
+	// 创建表（如果不存在）
+	tables := db.ListTables()
+	hasUsers := false
+	hasProducts := false
+	for _, t := range tables {
+		if t == "users" {
+			hasUsers = true
+		}
+		if t == "products" {
+			hasProducts = true
+		}
+	}
+
+	if !hasUsers {
+		table, err := db.CreateTable("users", userSchema)
+		if err != nil {
+			log.Printf("Create users table failed: %v", err)
+		} else {
+			// 插入一些示例数据
+			users := []map[string]interface{}{
+				{"name": "Alice", "email": "alice@example.com", "age": 30, "city": "Beijing"},
+				{"name": "Bob", "email": "bob@example.com", "age": 25, "city": "Shanghai"},
+				{"name": "Charlie", "email": "charlie@example.com", "age": 35, "city": "Guangzhou"},
+				{"name": "David", "email": "david@example.com", "age": 28, "city": "Shenzhen"},
+				{"name": "Eve", "email": "eve@example.com", "age": 32, "city": "Hangzhou"},
+			}
+			for _, user := range users {
+				table.Insert(user)
+			}
+			log.Printf("Created users table with %d records", len(users))
+		}
+	}
+
+	if !hasProducts {
+		table, err := db.CreateTable("products", productSchema)
+		if err != nil {
+			log.Printf("Create products table failed: %v", err)
+		} else {
+			// 插入一些示例数据
+			products := []map[string]interface{}{
+				{"product_name": "Laptop", "price": 999.99, "quantity": 10, "category": "Electronics"},
+				{"product_name": "Mouse", "price": 29.99, "quantity": 50, "category": "Electronics"},
+				{"product_name": "Keyboard", "price": 79.99, "quantity": 30, "category": "Electronics"},
+				{"product_name": "Monitor", "price": 299.99, "quantity": 15, "category": "Electronics"},
+				{"product_name": "Desk", "price": 199.99, "quantity": 5, "category": "Furniture"},
+				{"product_name": "Chair", "price": 149.99, "quantity": 8, "category": "Furniture"},
+			}
+			for _, product := range products {
+				table.Insert(product)
+			}
+			log.Printf("Created products table with %d records", len(products))
+		}
+	}
+
+	// 启动后台数据插入协程
+	go autoInsertData(db)
+
+	// 启动 Web UI
+	handler := webui.NewWebUI(db)
+
+	fmt.Printf("SRDB Web UI is running at http://%s\n", addr)
+	fmt.Println("Press Ctrl+C to stop")
+	fmt.Println("Background data insertion is running...")
+
+	if err := http.ListenAndServe(addr, handler); err != nil {
+		log.Fatal(err)
+	}
+}
+
+// generateRandomData 生成指定大小的随机数据 (2KB ~ 512KB)
+func generateRandomData() string {
+	minSize := 2 * 1024              // 2KB
+	maxSize := (1 * 1024 * 1024) / 2 // 512KB
+
+	sizeBig, _ := rand.Int(rand.Reader, big.NewInt(int64(maxSize-minSize)))
+	size := int(sizeBig.Int64()) + minSize
+
+	data := make([]byte, size)
+	rand.Read(data)
+
+	return fmt.Sprintf("%x", data)
+}
+
+// autoInsertData 在后台自动插入数据
+func autoInsertData(db *srdb.Database) {
+	ticker := time.NewTicker(time.Second)
+	defer ticker.Stop()
+
+	counter := 1
+
+	for range ticker.C {
+		tables := db.ListTables()
+		var logsTable *srdb.Table
+
+		hasLogs := slices.Contains(tables, "logs")
+
+		if !hasLogs {
+			logsSchema := srdb.NewSchema("logs", []srdb.Field{
+				{Name: "timestamp", Type: srdb.FieldTypeString, Indexed: false, Comment: "Timestamp"},
+				{Name: "data", Type: srdb.FieldTypeString, Indexed: false, Comment: "Random data"},
+				{Name: "size_bytes", Type: srdb.FieldTypeInt64, Indexed: false, Comment: "Data size in bytes"},
+			})
+
+			var err error
+			logsTable, err = db.CreateTable("logs", logsSchema)
+			if err != nil {
+				log.Printf("Failed to create logs table: %v", err)
+				continue
+			}
+			log.Println("Created logs table for background data insertion")
+		} else {
+			var err error
+			logsTable, err = db.GetTable("logs")
+			if err != nil || logsTable == nil {
+				log.Printf("Failed to get logs table: %v", err)
+				continue
+			}
+		}
+
+		data := generateRandomData()
+		sizeBytes := len(data)
+
+		record := map[string]any{
+			"timestamp":  time.Now().Format(time.RFC3339),
+			"data":       data,
+			"size_bytes": int64(sizeBytes),
+		}
+
+		err := logsTable.Insert(record)
+		if err != nil {
+			log.Printf("Failed to insert data: %v", err)
+		} else {
+			sizeStr := formatBytes(sizeBytes)
+			log.Printf("Inserted record #%d, size: %s", counter, sizeStr)
+			counter++
+		}
+	}
+}
+
+// formatBytes 格式化字节大小显示
+func formatBytes(bytes int) string {
+	const unit = 1024
+	if bytes < unit {
+		return fmt.Sprintf("%d B", bytes)
+	}
+	div, exp := int64(unit), 0
+	for n := bytes / unit; n >= unit; n /= unit {
+		div *= unit
+		exp++
+	}
+	units := []string{"KB", "MB", "GB", "TB"}
+	return fmt.Sprintf("%.2f %s", float64(bytes)/float64(div), units[exp])
+}
--- a/examples/webui/main.go
+++ b/examples/webui/main.go
@@ -0,0 +1,98 @@
+package main
+
+import (
+	"flag"
+	"fmt"
+	"os"
+
+	"code.tczkiot.com/srdb/examples/webui/commands"
+)
+
+func main() {
+	if len(os.Args) < 2 {
+		printUsage()
+		os.Exit(1)
+	}
+
+	command := os.Args[1]
+	args := os.Args[2:]
+
+	switch command {
+	case "webui", "serve":
+		serveCmd := flag.NewFlagSet("webui", flag.ExitOnError)
+		dbPath := serveCmd.String("db", "./data", "Database directory path")
+		addr := serveCmd.String("addr", ":8080", "Server address")
+		serveCmd.Parse(args)
+		commands.StartWebUI(*dbPath, *addr)
+
+	case "check-data":
+		checkDataCmd := flag.NewFlagSet("check-data", flag.ExitOnError)
+		dbPath := checkDataCmd.String("db", "./data", "Database directory path")
+		checkDataCmd.Parse(args)
+		commands.CheckData(*dbPath)
+
+	case "check-seq":
+		checkSeqCmd := flag.NewFlagSet("check-seq", flag.ExitOnError)
+		dbPath := checkSeqCmd.String("db", "./data", "Database directory path")
+		checkSeqCmd.Parse(args)
+		commands.CheckSeq(*dbPath)
+
+	case "dump-manifest":
+		dumpCmd := flag.NewFlagSet("dump-manifest", flag.ExitOnError)
+		dbPath := dumpCmd.String("db", "./data", "Database directory path")
+		dumpCmd.Parse(args)
+		commands.DumpManifest(*dbPath)
+
+	case "inspect-all-sst":
+		inspectAllCmd := flag.NewFlagSet("inspect-all-sst", flag.ExitOnError)
+		sstDir := inspectAllCmd.String("dir", "./data/logs/sst", "SST directory path")
+		inspectAllCmd.Parse(args)
+		commands.InspectAllSST(*sstDir)
+
+	case "inspect-sst":
+		inspectCmd := flag.NewFlagSet("inspect-sst", flag.ExitOnError)
+		sstPath := inspectCmd.String("file", "./data/logs/sst/000046.sst", "SST file path")
+		inspectCmd.Parse(args)
+		commands.InspectSST(*sstPath)
+
+	case "test-fix":
+		testFixCmd := flag.NewFlagSet("test-fix", flag.ExitOnError)
+		dbPath := testFixCmd.String("db", "./data", "Database directory path")
+		testFixCmd.Parse(args)
+		commands.TestFix(*dbPath)
+
+	case "test-keys":
+		testKeysCmd := flag.NewFlagSet("test-keys", flag.ExitOnError)
+		dbPath := testKeysCmd.String("db", "./data", "Database directory path")
+		testKeysCmd.Parse(args)
+		commands.TestKeys(*dbPath)
+
+	case "help", "-h", "--help":
+		printUsage()
+
+	default:
+		fmt.Printf("Unknown command: %s\n\n", command)
+		printUsage()
+		os.Exit(1)
+	}
+}
+
+func printUsage() {
+	fmt.Println("SRDB WebUI - Database management tool")
+	fmt.Println("\nUsage:")
+	fmt.Println("  webui <command> [flags]")
+	fmt.Println("\nCommands:")
+	fmt.Println("  webui, serve       Start WebUI server (default: :8080)")
+	fmt.Println("  check-data         Check database tables and row counts")
+	fmt.Println("  check-seq          Check specific sequence numbers")
+	fmt.Println("  dump-manifest      Dump manifest information")
+	fmt.Println("  inspect-all-sst    Inspect all SST files")
+	fmt.Println("  inspect-sst        Inspect a specific SST file")
+	fmt.Println("  test-fix           Test fix for data retrieval")
+	fmt.Println("  test-keys          Test key existence")
+	fmt.Println("  help               Show this help message")
+	fmt.Println("\nExamples:")
+	fmt.Println("  webui serve -db ./mydb -addr :3000")
+	fmt.Println("  webui check-data -db ./mydb")
+	fmt.Println("  webui inspect-sst -file ./data/logs/sst/000046.sst")
+}