docs: 全站点版本迭代至 v0.5.1 + 功能描述与实现对齐（移除已删 utils/Slotted 宣称、补加密/页面化/锁/维护语句、修正 walSyncMode 默认值、数字校准 1009 测试/87.3%）

2026-08-10 12:44:26 +08:00
parent 334067d89e
commit 2668bd47cf
6 changed files with 688 additions and 636 deletions
@@ -3,7 +3,7 @@
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>🧪 在线演示 — MetonaSqlark v0.4.4</title>
+<title>🧪 在线演示 — MetonaSqlark v0.5.1</title>
 <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'><rect width='32' height='32' rx='8' fill='%236366f1'/><text x='16' y='22' text-anchor='middle' font-size='20' fill='white'>◈</text></svg>">
 <style>
  :root {
@@ -84,7 +84,7 @@
    <a href="demo.html" class="nav-active">演示</a>
    <a href="benchmark.html">基准</a>
  </nav>
-  <div class="status"><span class="dot" id="engine-dot"></span> <span id="engine-status">Memory</span> 模式 — v0.4.4</div>
+  <div class="status"><span class="dot" id="engine-dot"></span> <span id="engine-status">Memory</span> 模式 — v0.5.1</div>
  <button class="btn btn-preset" onclick="switchEngine('memory')" id="btn-memory" style="margin:6px 4px 6px 0;padding:6px 12px;">⚡ Memory</button>
  <button class="btn btn-preset" onclick="switchEngine('aria')" id="btn-aria" style="margin:6px 0;padding:6px 12px;color:#ec4899;border-color:#ec4899;">🌲 Aria</button>
 </header>
@@ -92,7 +92,7 @@
 <div class="main">
  <div class="editor-panel">
    <div class="editor-area">
-<textarea id="sql-input" placeholder="输入 SQL 语句...&#10;&#10;SELECT * FROM users;&#10;INSERT INTO users VALUES ('4', 'Diana', 'diana@test.com', 28);&#10;SELECT u.name, o.amount FROM users u INNER JOIN orders o ON u.id = o.user_id;">-- 🚀 MetonaSqlark v0.4.4 在线演示
+<textarea id="sql-input" placeholder="输入 SQL 语句...&#10;&#10;SELECT * FROM users;&#10;INSERT INTO users VALUES ('4', 'Diana', 'diana@test.com', 28);&#10;SELECT u.name, o.amount FROM users u INNER JOIN orders o ON u.id = o.user_id;">-- 🚀 MetonaSqlark v0.5.1 在线演示
 	-- 已预置 users / orders / products 表数据
 	-- 新特性: ALTER TABLE · TRUNCATE TABLE · WAL同步 · MVCC · SQL注入防护
 	
@@ -134,6 +134,7 @@
        <button class="btn btn-preset" onclick="loadPreset('onupdate')" style="color:#fbbf24;border-color:#fbbf24;">🔄 ON UPDATE</button>
        <button class="btn btn-preset" onclick="loadPreset('repair')" style="color:#22c55e;border-color:#22c55e;">🛡 自愈</button>
        <button class="btn btn-preset" onclick="loadPreset('aria')" style="color:#ec4899;border-color:#ec4899;">🌲 Aria</button>
+        <button class="btn btn-preset" onclick="loadPreset('maint')" style="color:#22c55e;border-color:#22c55e;">🛠 v0.5.1 维护语句</button>
      </div>
    </div>
  </div>
@@ -554,7 +555,7 @@ SELECT COUNT(*) as total FROM temp_logs;

 -- 清理
 DROP TABLE temp_logs;`,
-	  aria: `-- 🌲 AriaEngine 演示 (v0.4.4)
+	  aria: `-- 🌲 AriaEngine 演示 (v0.5.1)
 	-- 点击右上角「🌲 Aria」按钮切换数据库引擎到 AriaEngine
 	-- 当前数据库即运行在 Aria 引擎上（LSM-Tree · WAL 崩溃恢复 · MVCC · BloomFilter）
 	-- 基础 CRUD 与 Memory 引擎完全兼容
@@ -589,18 +590,42 @@ DROP TABLE temp_logs;`,
 	
 	-- AriaEngine 特性:
 	-- • LSM-Tree: MemTable (红黑树) → SSTable 多级索引
-	-- • WAL: 原子写入 + 崩溃恢复（残缺 SSTable 打开自动跳过）+ 批量组提交
+	-- • WAL: 分片文件 + 标准 CRC32 + 空洞检测 + 崩溃恢复（残缺 SSTable 自动跳过）
 	-- • MVCC: 版本链 + 快照隔离
-	-- • Buffer Pool: SSTable LRU 缓存 (256页 ~ 1MB) ✅ 已生效
+	-- • 页面化物理存储: SSTable 4KB 页面 + BufferPool LRU 缓存 (v0.5.0)
+	-- • 完整性: 整文件 CRC-32 校验（数据腐坏自动清理自愈）
 	-- • Bloom Filter: FNV-1a + Murmur 双哈希
 	-- • 二级索引: 每列独立 LSM + 跨重启自动恢复
-	-- • 外键级联: ON DELETE / ON UPDATE — CASCADE / SET NULL / RESTRICT (v0.4.2)
-	-- • 自愈: db.repair() 无需删库重建 (v0.4.2)
+	-- • 外键级联: ON DELETE / ON UPDATE — CASCADE / SET NULL / RESTRICT
+	-- • 自愈: db.repair() 无需删库重建（含孤儿页面/残留清理）
+	-- • 维护语句: EXPLAIN / ANALYZE / REINDEX / VACUUM / SAVEPOINT (v0.5.1)
 	
 	-- 生产环境 API（与演示页右上角切换等价）
 	-- const db = await MetonaSqlark.create({
 	--   name: 'my-app', mode: 'aria'
 	-- });`,
+	maint: `-- 🛠 维护语句 (v0.5.1)
+	-- EXPLAIN: 输出查询计划（任何引擎可用）
+	EXPLAIN SELECT * FROM users WHERE age > 18;
+	
+	-- ANALYZE: 收集表统计信息（仅 Aria 引擎）
+	ANALYZE TABLE users;
+	
+	-- REINDEX: 重建二级索引（仅 Aria 引擎）
+	REINDEX TABLE users;
+	
+	-- VACUUM: 压缩 LSM + 清理碎片（仅 Aria 引擎）
+	VACUUM;
+	
+	-- SAVEPOINT: 嵌套事务保存点（仅 Aria 引擎）
+	BEGIN;
+	UPDATE users SET age = age + 1 WHERE id = '1';
+	SAVEPOINT sp1;
+	UPDATE users SET age = 0 WHERE id = '1';
+	ROLLBACK TO SAVEPOINT sp1;
+	RELEASE SAVEPOINT sp1;
+	COMMIT;
+	SELECT id, age FROM users WHERE id = '1';`,
 	casewhen: `-- 🎯 CASE WHEN 条件表达式 (v0.3.1 / v0.3.2)

 -- SELECT 列：多 WHEN + ELSE