想把 CBDB 人物资料放进 SQLite 查询，第一步先下载项目的 latest.json。这份清单会告诉你当前数据库叫什么、从哪里下载，以及下载后应当得到哪个校验值。把它和数据库一起保存，后续写研究记录时就能说明自己用的是哪一版数据。
GitHub 上找说明，按清单下载数据库
CBDB SQLite 项目的中文指南把获取流程分成三步：读取版本清单，按清单中的 Hugging Face 链接下载 ZIP 压缩包，再解压成 SQLite 文件。GitHub 仓库提供使用说明、处理脚本和入口；具体数据库包的位置由清单给出。需要历史版本时，指南也提供了 history 目录。
2026 年 10 月 16 日读取到的清单指向 cbdb_20261010.sqlite3，生成时间为 2026-10-10T19:17:07Z。下载地址位于 history/cbdb_202610/cbdb_20261010.zip。这里的文件名和时间明确记录了一次数据库生成；以后 latest.json 更新，保存下来的旧清单仍能说明原先的查询条件。
几个字段分别管什么
latest.json 里有三个字段要对照着看。sqlite_filename 是解压后得到的数据库文件名，这次清单里是 cbdb_20261010.sqlite3；huggingface_url 是 ZIP 压缩包的下载地址，下载下来的压缩包要先解压，才能用 SQLite 打开；sha256 校验的是解压出来的 SQLite 文件，所以要对 .sqlite3 文件本身计算哈希，用 ZIP 包算出的值和清单对不上。校验一致后，把这份 latest.json 和数据库存进同一个文件夹，文件名、下载地址和校验值就一起留作这份数据的版本记录。
清单中的时间使用 UTC。记录研究材料时，可以同时保存原始时间字符串和文件名，避免把本机下载时间当成数据库的生成日期。若更换版本后结果发生变化，先比较清单和查询语句，就能分清是数据更新，还是查询条件改了。
打开之后，先认识表结构
官方指南给出了 BIOG_MAIN 人物主表、ALTNAME_DATA 别名表和 BIOG_ADDR_DATA 人物地址关联表的查询入口。初次使用时先查看表结构，再做少量记录查询，保留 c_personid 这类人物标识。姓名相同不等于同一个人，字、号等别名也需要结合人物记录来辨认。
对于国学、历史和文献研究，SQLite 版的便利在于能够把一次检索写成可重复执行的语句：同样的数据文件、同样的条件，可以再次得到同一批记录。正式开始整理人物关系前，把版本清单、原始数据库与自己的查询脚本放在一起，会比只留下几张结果截图更方便复查。
项目入口：CBDB SQLite；中文使用指南；latest.json。本文记录的清单读取日期为 2026 年 10 月 16 日。