江山时序:GPL-3.0 的中国历史交互地图,198 张疆域快照与 2400 年地名沿革

资源概览

江山时序是一个中国历史交互地图的 Web 应用,仓库为 DeanChensj/jiangshan-map,主体用 JavaScript 编写,采用 GPL-3.0 许可证,截至 2026 年 11 月在 GitHub 上约有 6750 颗 star。项目自述覆盖公元前 403 年到今天的疆域变化,划分为 18 个历史时期,共 198 张疆域快照,时间跨度约 2400 年。它不做学术 GIS 那种层层叠加的图层管理,而是把「时间」做成一条可以直接拖动的轴。

界面上的核心就是这条时间轴。拖动它,地图上的疆域随年代收缩或扩张,轴上方的小气泡显示当朝的君主与年号,让人能立刻把年份对应到具体的帝王纪年;疆域的得失用「虚线幽灵边界」标出,前一版图与当前版图的差异因此变成可见的轮廓,而不是两串需要心算的年份。这种表达方式牺牲了一部分拓扑精度,换来的是「一眼看懂变了什么」。

数据的组织方式值得单独说明。198 张快照并非逐帧动画,而是按关键节点切分的历史切片,每个切片代表一个时期内相对稳定的疆域形态。这样既能控制数据体积,也让「跳到某一年」这类查询可以快速定位到最近的切片,再做细节展示。整个项目是纯前端应用,静态文件起一个服务就能跑,不依赖后端数据库;离线可用程度取决于数据文件是否随仓库完整分发,使用前建议先确认仓库内的数据目录与构建产物。

核心功能亮点

时间轴与幽灵边界

时间轴是整个应用的主控件。把滑块从战国拖到近现代,疆域会按时期切换,气泡同步显示在位君主与年号。更实用的是幽灵边界:当某个时期发生较大幅度的疆域变动时,地图会用虚线把上一时期的轮廓叠在当前图层上,哪些地方得、哪些地方失,不需要查表就能判断。讲解「某朝为何在此设郡」这类问题时,这个视觉提示比文字描述有效得多。

溯地卡片的沿革数据

点击地图上的任意古城或关隘,会弹出「溯地」卡片。卡片里不是一条简介,而是一份跨越 2400 年的行政沿革:这个地名在哪些朝代属于哪个郡、哪一路、哪一府,中间改过几次名字,当地发生过哪些载入史册的事件。卡片内的历史事件可以点击,点了之后地图会穿越到那一年,等于把「查资料」和「看地图」两步合成一步。

人物编年与同屏对比

搜索框可以搜人名,比如曹操、苏轼、玄奘,地图会按编号标出这个人的生平轨迹,从出生地到贬所、从仕宦到游历,按时间顺序连成一条线。更有意思的是多人同屏:同时选中几个人物,各自的轨迹并列显示,相遇或同在一年身处同一区域的节点会被标出。做文学史或政治史的时间线梳理时,这种对照比读年表直观。

18 个时期 198 张快照的数据分片

把 2400 年切成 18 个时期、198 张快照,是一个刻意做出的折中。历史地图的难点从来不是画一张图,而是决定「以哪一年为准」;把每个时期压成若干关键切片,等价于承认疆域是在变动的,同时给使用者一个可以稳定引用的版本。这个设计也解释了为什么拖动时间轴时疆域是跳变的而不是连续插值的——它展示的是史料能够支撑的节点,而不是算法补出来的中间态。

MCP、CLI 与浏览器 API 三种接入面

除了给人看,项目还留了给程序用的口子:一个 MCP 服务、一个命令行工具,以及一套浏览器内可调用的 API。前两者适合让 agent 在回答历史地理问题时直接取数据,后者适合在做课件或做页面时嵌入一张可交互的地图。三种接入面共享同一份数据,因此从界面看到的结果和接口返回的内容是一致的。

适用场景

历史与语文教学是最直接的一类。讲《过秦论》时把时间轴拖到战国末,讲《岳阳楼记》时点开岳州看它的沿革,学生对「郡—州—路—府」的演变会有一个具体的印象,比背表格有效。教师可以把某个时间点与某条人物轨迹固定下来,做成课件里的一屏。

读古籍查古地名是第二类。读到「贬至潮州」「徙知密州」,多数人知道大致方位,但说不清当时的行政区划与今天的对应关系。溯地卡片给出的沿革链条正好补上这一段,尤其是同名异地、异地同名的情况,配合年代看会清楚很多。

内容创作者的考据是第三类。写历史类稿件、做视频脚本,需要确认某地在某年归谁管辖、某个关隘是否已经废弃。手里有一个可以拖动的时间轴,比在多个网页之间来回比对要快,至少能先框定范围,再去查权威史料。

给 agent 接历史地理知识是第四类。MCP 与 CLI 的存在意味着可以把「某年某地的归属」作为工具能力接进对话流程,避免模型凭记忆编造行政区划。

下载与安装

官方渠道是 GitHub 仓库 https://github.com/DeanChensj/jiangshan-map,源码、数据与构建说明都在里面;项目也提供线上版本,只想看效果的话直接访问即可,不必本地部署。要在本机跑起来,先克隆仓库。

git clone https://github.com/DeanChensj/jiangshan-map.git
cd jiangshan-map

克隆之后有两种起静态服务的办法。用 Python 的最省事,多数系统自带,进入项目根目录执行即可;如果仓库要求先构建,则先按 README 的说明安装依赖并打包,再对产物目录起服务。

python3 -m http.server 8080
npx serve -l 8080 .

启动后浏览器访问 http://localhost:8080 就能看到地图。若页面空白,通常是入口文件不在根目录或需要先构建,按仓库内的说明调整服务目录即可。部署到内网服务器时把端口换成合适的值,前面套一层反向代理,静态资源本身的缓存策略按常规处理。

快速上手

进入页面后先做一件事:把时间轴从头到尾拖一遍。这一步不是玩,而是建立对数据粒度的直觉——你会看到疆域在哪些年份跳变,哪些时期切片密集、哪些稀疏。知道这一点,后面查具体年代时才不会误以为地图上没变就是历史上没变。

接着试地名检索。输入一个熟悉的古地名,比如长安、洛阳、幽州,看它落在哪张切片上,再点开溯地卡片,从最早的建置一路读到近代的改名。卡片里的沿革是按时间排序的,读的时候注意每一次改朝换代往往伴随行政区划调整,同名不同治所的情况要看清备注。

人物轨迹的对比建议这样用:先搜一个人,看轨迹与编号;再搜第二个人,观察两条线在哪些年份靠得很近。相遇节点会被标出,但它只说明两人同年在相近区域,不等于见过面,解读时要留一分余地。

如果要在自己的页面里调用数据,可以用浏览器 API。下面的片段演示按年份跳转与按地名取详情的基本形态,实际字段名与方法签名以官方文档和仓库内的示例为准,不同版本可能有调整。

// 等待地图实例就绪后再调用
const map = window.jiangshan || window.JiangshanMap;

// 跳到指定年份(负数为公元前)
map.gotoYear(-221);

// 查询某地的沿革详情
const place = map.getPlace('长安');
console.log(place?.timeline);

// 叠加两个人物轨迹做对比
map.comparePeople(['曹操', '刘备']);

同类资源对比

维度江山时序CHGIS维基共享历史地图纸质历史地图集
许可GPL-3.0学术使用条款,需遵守引用规范各文件不同,多为 CC 系列受版权保护
交互性时间轴拖动、人物轨迹、事件跳转GIS 图层,需专业软件操作静态图片,无交互无
数据粒度18 时期 198 张快照点位与边界的矢量数据集单一年代整幅单一年代整幅
可离线静态部署后可离线需本地 GIS 环境可下载图片天然离线
上手成本低,浏览器即可高,需要 GIS 基础低低

注意事项

许可证是使用前必须看清的一条。GPL-3.0 具有传染性:如果基于这个项目修改并对外分发,衍生作品需要同样以 GPL-3.0 开放源代码,并保留版权声明与许可文本。仅仅自己部署、内部使用不构成分发,义务较轻;但如果把它嵌进商业产品、SaaS 或对外发布的课件平台,就要评估是否构成衍生作品,必要时咨询法务,或改为只引用数据、自行实现展示层。

史料层面需要保持谨慎。历史疆域的画法在学界本就有争议,不同学者对羁縻地区、名义归属与实际控制的理解并不一致,一张图上的边界线往往代表某一种取舍而不是定论。用于教学或写作时,建议交叉核对权威历史地图集与正史地理志,并在引用时注明数据来源与版本,不要把交互地图当成唯一依据。

性能方面,198 张快照与沿革数据在前端加载,首次打开会有一定的资源请求量,网络较差时首屏可能偏慢;移动端小屏幕上时间轴与卡片的操作空间有限,横屏体验更好。已知限制以项目文档为准,例如部分年代的数据仍在补充、个别人物轨迹的年份存在异说。教学场景中把地图当作引子而非结论,是更稳妥的用法。