作品说明
把 TiDB 看不见的内部机制做成可动手的模拟器:Region 分裂与选主、两阶段提交、HTAP、在线 DDL、扩缩容、向量搜索,配真实 SQL。方向:产品特性解读 / 技术概念可视化。
作品展示
- 在线体验:https://39.107.157.237/tidb/ (右上角可切换中文 / EN)
- 发布短片视频(60 秒):【https://39.107.157.237/tidb】发布短片区域
- 功能演示视频(2.5 分钟,全程真实录屏):【https://39.107.157.237/tidb】功能演示视频区域
六个章节,每章都是一个可以动手的模拟器:
- Multi-Raft:持续写入,Region 超过 384MiB 自动分裂(v8.4+ 默认 region-split-size 256MiB);让某个 TiKV「宕机」,看 Follower 等待选举超时后由多数派选出新 Leader,PD 做 balance-leader / balance-region。
- 分布式事务:Percolator 两阶段提交逐步演示(start_ts → prewrite → commit_ts → 先提交 primary → 异步提交 secondary),TSO 按 物理时间 << 18 | 逻辑位 解码;打开「并发冲突」可看到乐观事务的
ERROR 9007 (HY000): Write conflict。 - HTAP:TiKV 行存与 TiFlash 列存(Raft Learner 异步复制);OLAP 查询演示 read_index / wait_index 一致性读,并对比行存与列存扫描量。
- 在线 DDL:ADD INDEX 在 none → delete only → write only → write reorganization → public 间推进,边写边建索引,最后校验「索引与数据一致」。
- 弹性扩缩容:scale-out 后 PD 把 Region 迁到新节点;scale-in 时 store 状态 Up → Offline → Tombstone。
- 向量搜索:VECTOR 类型、四种距离函数、HNSW 分层检索动画;只有余弦 / L2 距离能用向量索引。
每章都有:
- 「显示 SQL」:动画背后的真实语句;
- 「查看真实集群」:直接查询部署在云服务器上的单节点 TiDB v8.5.8(tiup 部署,含 TiFlash),展示真实的 Region 表、EXPLAIN ANALYZE(
mpp[tiflash])、DDL 任务和走annIndex的向量查询计划; - 所有技术参数对照 TiDB v8.5 官方文档逐条核对,简化之处在页面上明确标注。
使用的 AIGC 工具
- Claude Code( Opus 5):从方案、事实核查(逐条对照 TiDB v8.5 文档)、全部前后端代码、单节点 TiDB 部署到上线,均由 Claude Code 及其子代理完成;我负责选题、决策和验收。
- 建模:程序化建模 TiDB 集群三维主视觉(TiDB / PD / TiKV / TiFlash),多角度渲染关键帧。
- 火山引擎 Seedance(豆包视频生成):以关键帧做图生视频,生成发布短片镜头与两条竖版 AI 主讲视频;Claude Code 逐镜抽帧自查,不合格的重新生成。生成镜头只用抽象隐喻,产品界面一律取自站点真实录屏。
- 语音合成:中文旁白;字幕按实测语音时长自动排版。
- 功能演示视频:Playwright 自动录屏 + 语音合成播报 + 自动生成字幕,脚本同样由 Claude Code 编写。
- 技术栈:React + TypeScript + Apache ECharts,风格致敬 OSSInsight。
社媒传播
- 小红书:【发布后贴链接】
- 抖音 :【1.51 https://v.douyin.com/_dasjjUJaY8/ 复制此链接,打开抖音搜索,直接观看视频! :1pm zTy:/ 02/24 M@W.zG 】【2.38 https://v.douyin.com/vqq5I2MA8ZI/ 复制此链接,打开抖音搜索,直接观看视频! :6pm v@s.re 01/16 bAG:/ 】