江山时序:拖一条时间轴,看中国两千年疆域和地名怎么变

一、这个项目解决的是什么问题

读史书最烦的一件事是脑子里没有图。书上写某年某将出某关,你知道这件事重要,但不知道那个关在今天哪个省,离长安多远,当时归谁管。纸质的《中国历史地图集》能查,可它一页只能放一个朝代,前后对照要来回翻,翻两下就不想看了。

江山时序把这个过程搬到了浏览器里。一条时间轴,一张可以缩放的羊皮纸色地图,从战国一直拖到今天,两千四百多年,十八个历史时期,198 张疆域快照。拖动的时候,版图、政权名称、在位皇帝、河道走向一起变。

它不做百科,也不做资料库。它做的是把一句话放回地图上这件事:你在诗里读到蓝关,输入蓝关,地图跳到秦岭那一带,顺手把韩愈那一年经过这里的记录摆出来。

二、核心设计机制

整个项目是纯静态的,一堆页面、脚本和预先算好的几何数据,没有后端。地图在浏览器里渲染,疆域数据被打包成去重过的拓扑格式,按快照切片,拖到哪一年就加载哪一片。所以它打开快,也不需要账号。

时间轴不是一根普通滑杆。两端有把手,可以往里拖,把范围缩到秦、三国、五代这种短朝代;双击回到全览。关掉图层面板里的事件层,它只在疆域真的发生变化的年份停,不会一年一年空转。时间轴上方的气泡显示当前年份在位的皇帝,中文界面还会带上年号,比如唐太宗贞观四年。

地名解析是第二个核心。你不需要知道经纬度,只要给年份和地名两个参数,它自己去匹配古今地名、定位、切换对应的朝代底图。这个设计后来被做成了接口:项目里带一个零依赖的本地 MCP 服务,暴露三个工具,查地点、查人物、搜全站;也带一个命令行脚本,能直接截一张指定年份指定地点的图。

三、功能拆解

拖时间轴看疆域是主线。每条疆域变化的关键节点都能点,点了会切换底图,同时用虚线朱红标出上一阶段的边界差,谁多了一块谁少了一块,一眼能看出来。左下角图例可以悬停高亮某个政权,点开是它的存续时间、都城和一段简介。

点地图上任何一座古城或关隘,弹出的是溯地卡片。上面一段这个城市的诗文题记和小传,下面按十八个时期排一张行政沿革表,从战国郡县、汉代刺史部、唐代道、宋代路,一路排到元明清的省和今天的市。每一行下面还挂着发生在这个地点上的事件,点事件直接跳去那一年。函谷关、潼关、剑门关、玉门关、山海关这些关隘有单独的城楼图标和地形说明。

左上角的搜索框可以查人物。输入苏轼,地图上会按年份依次标出他人生的每一站,眉山、开封、密州、黄州、惠州、儋州,连线带编号,时间轴跟着走。也可以一次输两三个人,比如李白、杜甫、高适,几条路线用不同颜色叠在一张图上,还标出他们同年同地相遇的节点。事件线也一样,秦灭六国、楚汉相争、安史之乱、靖康之变都能一站一站放。

还有一个彩蛋,地图定位小游戏。十轮,难度递增,只给朝代线索不给今天的地名,你自己在地图上点,按大圆距离算分,打完给一个古代官职头衔。

四、适合谁,不适合谁

适合读史的人,尤其是读诗读传的人;适合中学历史老师做课堂演示,深链接可以直接钉到某年某地某事件,扔给学生就行;适合写历史类内容的人找素材,截图和导出都方便;也适合做智能应用的人,它把年份加地名变成了一个可以调用的接口。

不适合想找权威边界数据的人。这个必须说清楚:它的疆域是示意性的近似轮廓,不是测绘边界,项目自己在文档里写了不要当作精确或权威引用。也不适合想离线塞进手机当应用用的人,它是网页。想嵌进公众号、知乎、小红书的人也会碰壁,这几个平台不允许内嵌框架,只能发普通链接。

五、几个需要提前知道的限制

第一是数据许可不统一。代码和项目自绘的数据是 GPL-3.0,但郡、州、府这一级边界来自 CHGIS,不在 GPL 覆盖范围内,只能学术非商用,不许再分发。项目默认导出地理数据时会把这一层排除,要加 --with-prefectures 才带出来,而且明确说了不要公开。

第二是导出范围有边界。地理数据导出只覆盖公元前 403 年到 1948 年,之后的年份和现代省界层不在里面。

第三是语音讲解依赖浏览器的语音合成,浏览器没有这个能力就没有声音。

第四是容器镜像只在本机构建,项目没有把它发布到任何镜像仓库,想要容器化得自己构建。

第五是内容量。十八个时期、198 张快照听着多,但每一张都是粗粒度的示意,细节靠卡片和事件补,别指望它替代专门的历史地理工具书。

六、项目现状

版本 v1.4.0,星标八千六百多,GPL-3.0。官方站点在线,简体、繁体、英文、日文四种界面。除了网页,仓库里还有 MCP 服务、命令行截图脚本、浏览器端脚本接口、地理数据导出脚本、容器部署文件和一份给机器读的说明文档。数据勘误走公开的问题反馈流程,项目鼓励提交带出处的修正。它还在更新,但节奏取决于作者本人的时间,以项目文档为准。

七、常见问题

问:需要装什么吗?

答:网页版什么都不用装,打开官网就能用。想本地跑,项目是纯静态的,克隆下来用任意静态服务器起一下就行,不需要构建,也不需要数据库。

问:手机上能用吗?

答:能打开,但体验是按桌面设计的。时间轴拖动、悬停高亮、右键这些交互在触屏上会打折,建议平板横屏或者电脑。

问:能嵌到自己的网站里吗?

答:可以,地址后面加 embed=1 就能嵌框架,还能用 from 和 to 限定时间范围,用 lock=1 冻结在某一年。公众号、知乎、小红书不行,它们不让用内嵌框架。

问:地图上的边界准不准?

答:不准,是示意。项目自己写明了是粗略轮廓,不是测绘边界,不要拿去当权威引用。

问:能让智能助手直接调用吗?

答:可以。仓库里有一个零依赖的本地 MCP 服务,配到支持 MCP 的客户端里,就有查地点、查人物、搜全站三个工具,给年份和地名两个参数就够。

问:能导出数据自己用吗?

答:能。项目带地理数据导出脚本,输出标准格式,能喂给 Leaflet、MapLibre、QGIS。但郡州府那一层涉及第三方许可,默认不导出。

下载地址

夸克网盘(永久有效):https://pan.quark.cn/s/846b9ae04a3f

本教程由「宝藏星球屋」整理,更多软件、游戏、开源项目都在 https://cbge.top。

本站全部免费,如果觉得内容有用,可打赏支持服务器续费打赏支持
固定文章缩略图

新人必看的入站详细说明指南

解决的你的各种疑难杂症以及各种相关教程

前往查看 »
© 版权声明
THE END
喜欢就支持一下吧
点赞23 分享
评论 抢沙发
头像
欢迎您留下宝贵的见解!
提交
头像

昵称

取消
昵称表情代码图片

    暂无评论内容