▶ 在线体验（免安装）  · 

两宋（960—1279）及辽、西夏、金、大理的结构化资料库：1049 条结构化条目 + 五朝帝系族谱 + 人物关系图谱 + 势力舆图。 SQLite 存储、Python 标准库 API、零依赖前端，可一键构建为纯静态站点。

如果这个项目对你有帮助，点一个 ⭐ Star 是最好的支持。

另有 1,857 个标签、3,463 条条目关联、13 个身份分组、11 组统计面板。

已富化维基百科条目 660 条 / 1049 条（62.9%）；保留修订号、Wikidata QID 与 CC BY-SA 4.0 署名。

宋词专题：名篇类共 204 条 —— 词作 82 首、词牌 58 个、词集 29 部、词论 4 种、选本 5 种、笔记 6 种。词人、词集、词作、词牌之间已建立双向关联（tools/link_ci.py），82 首词作全部有作者，81 首有对应词牌。

名篇全文：82 首词、13 首诗、3 篇散文、1 篇辞赋均附正文（body 字段），在条目详情弹窗与独立条目页优先展示；词牌、词论、笔记、词集、选本等书目类条目仍以提要为主。

当前体检：完全孤立 0 条、正文过短 0 条、单向关联 0 条；仍有 370 条缺参考出处，是下一步内容补全的重点。

人物支持多身份分组：如李清照同时属于「女性」「文豪」，梁红玉同时属于「女性」「名将」。

这是资料型通览库，不是学术定本。人口、财政等数字各家估算差异大，页面内已标注口径；争议问题（如《满江红》作者、缠足起源）在详述中注明“一说”。正式引用请回原始史料。

cd song-dynasty

# 1) 初始化数据库（只需一次）
python3 db/init_db.py

# 2) 启动（自动建库/升级旧库 + 起服务）
./start.sh
# 或指定端口
./start.sh --port 9000

# 3) 打开
open http://127.0.0.1:8000

不要直接双击 index.html：浏览器在 file:// 下禁止读取 API，页面会提示启动命令。

环境要求：Python 3.8+（仅标准库）、SQLite 3.35+。无需 npm、无需联网。

公网不要运行 server/app.py。 这是一个只读数据集，正确的部署形态是构建成静态站点：

python3 build.py --base-url https://你的域名
# 产物全部在 dist/，上传到 CDN / 对象存储 / nginx 即可

dist/
├── index.html            单页应用（CSS/JS 引用自动加内容哈希）
├── api/bootstrap.json    首屏数据
├── api/items/<id>.json   条目详情（含维基富化）
├── item/<id>.html        每条一页，可被搜索引擎收录、可分享预览
├── sitemap.xml         需要 --base-url 才会生成
├── robots.txt  404.html  .nojekyll
├── _headers          ← 仅供 Cloudflare Pages / Netlify（GitHub Pages 会忽略）

构建期会做一次数据体检（悬空关联、非法 id、年表缺年份等），有问题直接打印出来。

仓库带了发布脚本（单提交强制推送 gh-pages，不会膨胀历史）：

./deploy.sh            # 自动推导 https://<owner>.github.io/<repo>
BASE_URL=https://你的域名 ./deploy.sh

首次使用需在 Settings → Pages 把 Source 设为 gh-pages 分支（或执行脚本末尾打印的 gh api 命令）。构建会自动生成 .nojekyll，避免 Jekyll 处理 _headers 等文件。

如果你偏好 GitHub Actions 发布，可加一个 workflow 调 actions/deploy-pages；注意推送 workflow 文件需要 token 具备 workflow scope（gh auth refresh -s workflow）。

nginx 最小配置：

server {
  listen 443 ssl http2;
  root /var/www/song-dynasty/dist;
  location / { try_files $uri $uri/ =404; }
  location /api/ { add_header Cache-Control "public, max-age=300"; }
  location ~* ^/(css|js)/ { add_header Cache-Control "public, max-age=31536000, immutable"; }
  gzip on; gzip_types application/json text/css application/javascript;
}

如果你确实需要动态服务（比如接写接口），必须放在 nginx/Caddy 之后，用 --host 127.0.0.1 只监听回环。服务端已改为静态白名单 + 路径归一化（早期版本可以用 curl --path-as-is '/css/../db/song.db' 直接下载整个数据库，已修复），并按只读方式打开 SQLite。

旧库需要升到 WAL 时，跑一次 python3 tools/manage.py --db db/song.db stats 即可；db/*.db* 已在 .gitignore 中。

song-dynasty/
├── index.html              前端单页
├── css/style.css           宋韵视觉（宣纸 / 朱砂 / 青绿）
├── js/app.js               渲染与交互（零依赖）
├── build.py                静态站点构建 → dist/（公网部署用这个）
├── deploy.sh               构建并发布到 GitHub Pages
├── server/app.py           HTTP + JSON API（开发/内网，仅标准库）
├── db/
│   ├── schema.sql          表结构、索引、触发器、视图
│   ├── init_db.py          由 seed.json 建库
│   ├── seed.json           可提交的种子快照（原创内容）
│   ├── wiki_cache.json     维基富化缓存（CC BY-SA 4.0）
│   └── song.db             运行时数据库（已 gitignore）
├── tools/manage.py         增删改查 / 导入导出 CLI
├── tools/audit.py          覆盖与质量体检（门类×政权、孤立条目、重名、缺字段）
├── tools/enrich_wiki.py    维基百科 / 维基数据富化
└── start.sh                本地一键启动

数据流是单向的：seed.json + wiki_cache.json →（init_db.py）song.db →（build.py）dist/。数据库是构建产物，不是线上状态；内容改动请走 manage.py export 刷新 seed.json。

categories 1─n items n─n tags
                  └─n item_relations (自关联)
dynasties / sources / data_panels / meta   辅助展示

items 一张表承载十二门类；人物与帝王通过 ptype / birth / death 扩展，避免为每类建表导致维护碎片化。 v_items 视图把分类名与标签串拼好，API 直接读取。

关键字段：

同一套接口既可跑动态服务（server/app.py），也对应静态构建产物，.json 后缀可省略：

示例：

curl 'http://127.0.0.1:8000/api/items?cat=military&era=南宋&limit=5'
curl 'http://127.0.0.1:8000/api/search?q=岳飞'
curl 'http://127.0.0.1:8000/api/items/ppl-yuefei'

原创的 summary / detail / body 保留不变；详情页的「百科条目」来自中文维基百科正文，单独存放在 item_sources 表，并保留：

• 条目标题、URL、修订号（revision_id）
• 许可（CC BY-SA 4.0）与抓取时间
• 维基数据 QID，可跳转 Wikidata
• 匹配置信度，低于阈值的条目不写入
• 类型校验：词作只接受具体词作页，词牌只接受词牌页；同名但不同类型（如「小池」→「小池百合子」）会被拒绝

# 小批量试跑
python3 tools/enrich_wiki.py --limit 20

# 全量（已缓存的跳过；可反复运行）
python3 tools/enrich_wiki.py

# 抓正文前 4000 字（默认只抓导言）
python3 tools/enrich_wiki.py --full

# 只把偏短的条目升级为正文
python3 tools/enrich_wiki.py --full --upgrade-short 600

# 只做人物 / 强制刷新 / 只报告不写库
python3 tools/enrich_wiki.py --cat people
python3 tools/enrich_wiki.py --refresh
python3 tools/enrich_wiki.py --dry-run

# 清理历史误配来源（不联网）
python3 tools/enrich_wiki.py --prune

抓取结果同时写入 db/wiki_cache.json，重建数据库时会自动导入，因此离线也能保留富化内容；报告见 db/wiki_report.json（含未命中与低置信度候选）。

许可与来源：维基百科正文遵循 CC BY-SA 4.0，详情页已保留署名、链接、修订号与许可说明；二次分发时请同样保留。维基数据以 CC0 提供。

关于百度百科：详情页提供「百度百科」外链，但不抓取、不复制正文。原因是没有类似 CC 的开放许可，且站点有反爬限制；直接批量搬运会有版权与合规风险。

chixie.html 是一个独立子页面，顶栏与主站一致，内容为《持械入宋》（茶根儿，番茄小说）的四卷结构、人物关系图、人物名录、小说人物 × 史实对照、年份对照、关键章节与 502 章目录。

• 人物与史实双向跳转：详情面板、对照表、年份卡里的「查看条目」都在本页弹窗中打开主站词条（/api/items/<id>），不离开页面；弹窗底部可「在主站打开」。
• 深链：chixie.html#p=yuefei（选中人物）、chixie.html#year=1127（筛选年份）、chixie.html#item=tl-1127（直接弹出词条）。
• 章节目录数据在 js/chixie-chapters.js（仅标题层，不含正文）。
• 年份为叙事推定，页面内已标注；「灭西夏」等情节属架空。

db/lineages.json 是独立的数据源，init_db.py 会把它导入 lineages / lineage_nodes 两张表， api.bootstrap 一并输出，前端 #lineage 页面渲染成族谱。

• 覆盖 赵宋、耶律辽、完颜金、嵬名西夏、段氏大理 五朝，共 110 个节点（含 19 位后妃、8 位帝姬/公主）
• 每个节点标注：庙号（太祖/世宗…）、姓名、在位年、支系（太祖系/东丹系/濮王系…）、 排行（嫡长子/第三子/侄…）、嫡庶；即位的皇帝加金色「帝」角标
• 过继/养父子另画青绿点线（标「嗣」）：英宗—仁宗、孝宗—高宗、理宗—宁宗、度宗—理宗
• 后妃以虚线小框贴在帝王右侧，虚线为婚线，标注身份与「生某宗」
• 帝姬、公主随父入谱：茂德帝姬赵福金、柔福帝姬赵多富、嘉德/荣德/安德帝姬、福康公主、岐国公主、耶律质古
• 兄弟姊妹按长幼自左向右排列；追尊与未即位的宗室用虚框显示
• 节点 id 直接复用 items 里的 emp-*，点节点即打开该皇帝的详情弹窗

对齐《红楼梦图谱》的岛屿簇式布局：

• 分簇：按身份（帝王/名臣/名将/文豪/思想家/科学家/艺术家/女性/僧道/起义/外族）分成岛屿， 货架式排布 + 每行居中 + 岛内向日葵式铺点，节点不重叠
• 连线分类：君臣（赤）、同朝（青）、同袍（铁红）、文友（紫）、其他（灰）； 君臣与跨类长线默认压暗，点「显示跨类 / 君臣连线」再展开
• 悬停：按「指针到线段距离」判定最近连线并高亮，两端人物描红、其余整体置灰， 中点浮出关系类别；悬停人物则显名所有邻座
• 点击连线：右侧显示二人对照卡（身份、共同身份、简介）
• 搜索：输入姓名回车，自动解除筛选、居中放大并脉冲标出

「人物」页新增 列表 / 关系图谱 切换：

• 201 位有互相关联的人物、227 条关系，来自 item_relations
• 力导向布局：按身份（帝王/名臣/名将/文豪/女性/僧道/外族…）分簇，锚点聚合 + 斥力 + 弹簧，布局确定性（刷新不变）
• 交互：悬停高亮邻域、点击看详情与关联人、拖拽平移、滚轮或 −/＋ 缩放、重置
• 与上方搜索、身份筛选联动：筛选后只亮相关节点
• 详情面板可继续跳关联人物，或「打开词条」进入完整词条

#timeline 现在默认是图谱视图：

• 横轴为年份（907—1279），纵向按政权分泳道（北宋、南宋、辽、西夏、金、大理、五代、元…）
• 每个节点是一件事，连线来自条目 related 关联；节点大小区分「大事/次要」
• 标签自动避让（同一泳道内多行排布），左列为固定泳道表头
• 支持政权筛选、仅看大事、缩放（−／＋／适应）、点击节点开词条；悬停才淡出无关节点，关闭弹窗后自动复原
• 保留「列表」视图，可随时切回原有编年列表

#map 是新增的宋代疆域与势力分布图：

• 等距圆柱投影手绘简化边界（非精确测绘），覆盖北宋、南宋、辽、党项/西夏、金、大理、吐蕃诸部、西辽、蒙古/元
• 11 个关键年份：960、1000、1044、1111、1120、1125、1127、1142、1200、1234、1279，可点选、拖滑杆或自动播放
• 右侧「势力分布」按多边形投影面积计算占比（示意），可点政权看简介与相关条目
• 26 座城市（都城／重镇／战场）可点击跳词条；黄河、长江作为定位参照
• 深链：index.html#map/1127、index.html#map/1279
• 数据在 js/map-data.js，渲染在 js/map.js

用 CLI 维护，避免手改二进制。日常流程是：manage.py 改库 → manage.py export 刷新 db/seed.json 快照 → python3 build.py 出静态站；tools/link_ci.py 在默认库上会自动执行 export。seed.json + wiki_cache.json 是随仓库分发的可复现内容源，song.db 可随时删掉重建：

# 查看
python3 tools/manage.py stats
python3 tools/manage.py list --cat customs
python3 tools/manage.py search 缠足
python3 tools/manage.py show cus-yuanxiao

# 体检：门类×政权 覆盖矩阵、完全孤立条目、重名、缺字段
python3 tools/audit.py
python3 tools/audit.py --orphans      # 只列出无任何关联的 id
python3 tools/audit.py --strict       # 重名或字段异常时非零退出（可接 CI）

# 一键 CI：临时库 + audit --strict + 静态构建
bash tools/check.sh

# 新增（准备 item.json）
python3 tools/manage.py add item.json
python3 tools/manage.py add batch.json --upsert

# 修改（只需写要改的字段，tags 会整体替换）
python3 tools/manage.py update ppl-yuefei patch.json

# 删除
python3 tools/manage.py rm ppl-yuefei --yes

# 备份 / 迁移
python3 tools/manage.py export --out db/seed.json
python3 tools/manage.py import db/seed.json

# 旧库升级：只补缺失列（如 items.body），不重建、不丢数据
python3 db/init_db.py --upgrade

# 词学关联：词人 ↔ 词集 ↔ 词作 ↔ 词牌（幂等，默认自动 export；--no-export 可跳过）
python3 tools/link_ci.py

# 把单向关联补成双向（幂等，默认自动 export）
python3 tools/symmetrize_relations.py

# 为完全孤立条目补 1–2 条基于标签/门类/政权的兜底关联（默认自动 export）
python3 tools/auto_link_orphans.py

# 清理维基同名误配来源（不联网）
python3 tools/enrich_wiki.py --prune

新增条目最小 JSON：

{
  "id": "cus-example",
  "cat": "customs",
  "type": "节令",
  "name": "示例节",
  "era": "南宋",
  "year": 1200,
  "tags": ["节令", "临安"],
  "summary": "一句话提要。",
  "detail": "赏析与背景叙述。",
  "body": "名篇正文（可选）。",
  "refs": "《梦粱录》"
}

修改后刷新浏览器即可；API 不缓存。若改了 schema.sql，需自行写迁移或 python3 db/init_db.py --force 重建（会丢失库内手工修改，先 export）。

• 全局检索（⌘K / Ctrl+K / /），支持 #分类、@人物 语法
• 十二门类浏览 + 政权 / 类型 / 年代筛选
• 年表：年代轴（按政权着色、点击定位）+ 十年分段 + 按政权筛选计数 + 「仅看大事」；条目卡片直出相关人物/条目
• 人物志按身份分组、按生年排序
• 条目详情弹窗，关联条目可跳转，键盘 ← → 翻页
• 数据面板（人口、财政、军备、科举、城市）
• 响应式 + 打印样式

1. 全文检索：现在前端是内存子串匹配，数据量到万级再考虑。注意 SQLite FTS5 的 trigram 分词器最短 3 字，岳飞/苏轼 这类两字查询会返回空；中文要么用 jieba 预分词影子列，要么用 bigram。
2. 写接口 / 管理后台：server/app.py 目前只读；可加本地 token 保护的 POST/PUT/DELETE。
3. 地图：接入 Leaflet/MapLibre + 历史政区 GeoJSON（需另找数据源）。
4. 谱系图：人物关系已入 item_relations，可做力导向图。
5. 版本化：items 增加 revisions 表，保留编辑历史。
6. 多语言：条目增加 lang 维度。

.github/workflows/ci.yml 在 push / pull request 时运行 bash tools/check.sh：临时建库、audit.py --strict、build.py --strict。本地可先跑同一条命令，避免把悬空关联或非法字段带进提交。

内容为公开史料与常见研究综述的整理，供学习、检索与二次开发使用。 历史数据与叙述难免疏漏，欢迎按上表结构补充、校正。

如果它帮你省下了翻《宋史》查世系的时间，点一个 ⭐ Star 能让更多读宋史的人看到它。

• 把它分享给一个对宋史感兴趣的朋友
• 发现世系、年份或人物关系有误，提一个 Issue
• 想补充条目（人物、事件、名篇），数据源是 db/seed.json，欢迎 PR