历史课本只给你一张地图,他给了你两千四百年
- 2026-11-21 12:11:51

读唐诗读到「雪拥蓝关马不前」,你会不会突然卡一下——蓝关,今天在哪儿?
读宋词读到「问汝平生功业,黄州惠州儋州」,会不会想:这三座城,连起来是一条什么样的路?
我每次都会去搜。搜完就忘了。因为搜出来的是一张现代地图上的一个红点,而脑子里想的是「韩愈被贬潮州,走到秦岭,大雪封山,马不肯往前」——这两件事对不上。
历史课本里其实有地图。但它是一张纸:一个朝代,一张图,翻过去就没了。你想看「上一百年这儿是谁的」,得往前翻二十页;想看「这条河当年从哪儿入海」,没有。
有个理科生把这件事记了很多年。今年十月,他花了两个半星期、提交了两百多次代码,做出一张能拖动时间轴的中国历史地图,扔到了 GitHub 上。
到今天,它有两千四百年的跨度、3642 颗星,和一条让我看了很久的评论:
拖动时间轴的那一刻,朝代不再是课本上的名词,而是脚下可以反复往返的山河。
这条评论是从别人的截图里看到的。项目叫「江山时序」,地址是 deanchen.me/jiangshan-map,代码在 GitHub 上叫 jiangshan-map,GPL-3.0。
01 那个想法在他心里存了很多年
作者叫 Dean,是个程序员。他在自己的博客里写过一句话,我看的时候笑了一下:
「我是个理科生,但从小就喜欢历史,也喜欢看地图。上学那会儿,历史、地理经常考全班最高分,一度很想选文科。可惜政治实在太差,一看到论述题就头疼,只好忍痛学了理科。」
喜欢的那部分,他一直没丢。上学时最爱翻的就是课本里的地图——看大唐的疆域,幻想贞观开元;翻到宋朝,为燕云十六州的丢失默默叹气;看到清朝全盛时期的「秋海棠」,又会兴奋半天。
工作以后读史书,这种冲动更强。印象最深的是渤海小吏的《两晋悲歌》和《南北归一》,每次读到五胡十六国,看到那一团浆糊似的政权更迭,脑子里总想拼出一张地图,却怎么也拼不清楚。
「要是有这么一张地图,能把整部中国历史的朝代更替都装进去,拖一下就能看变迁,可太酷了。」
这个念头存了很多年。他从没想过自己动手——直到今年七月,Vibe Coding 这件事慢慢流行起来,他第一次觉得,好像真能把脑子里的画面做出来。
七月他试过一次,想做的是个历史地理小游戏。做到一半发现,比起游戏,他真正想看的其实还是那张地图本身;加上原型效果一般,就扔在一边了。
十月,模型能力又上了一个台阶。他把项目重新捡起来,这次只做纯粹的地图,给 AI 的第一句 prompt 只有一行:
帮我做一个能够拖动时间轴的中国历史地图。
AI 没花多少时间就交出了第一版:没有山川河流,只有几个粗糙的色块,朝代分得很粗,边界全是一条条直线和锯齿。
但当他拖动底部的时间轴,看着那几个色块随年份变大变小,还是被惊艳到了。
我完全理解那一下。所有做过可视化的人都知道那个瞬间:数据第一次动起来的时候,你会突然意识到自己手里拿的不是一张图,是一段时间。
02 先立一根横轴:时间
从那天起,这个项目就停不下来了。两个半星期,两百多次提交,大半是在深夜和周末写的。
他先把时间这条横轴做扎实。打开网站,最下面是一条色带,从公元前 403 年一直铺到今天。拖动它,上面那张地图会跟着换。
实机演示(已压缩):拖动时间轴,两千年疆域流转,点开长安看十八朝沿革,再跟着苏东坡一路贬到海南。
换一个年份,变的不只是色块。同一时刻跟着变的有:
疆域。同屏可以并立好几个政权——战国七雄加周、越、巴蜀、中山、义渠;三国时袁绍、曹操、刘备、孙权、公孙氏辽东;南北朝;五代十国;宋、辽、西夏、大理、金、蒙古。鼠标移到左下角图例上,对应政权立刻高亮;点一下,镜头直接飞过去。
州郡。一级政区(郡、道、路、布政使司)用「宣纸衬底」的双重描边画出来,放大后悬停任意一个,就能看到它的辖境和今天的省。还有一个叫「透视镜」的开关,能把现代省界直接投到古舆图上。
水系与工程。黄河历代改道、云梦泽的消长、罗布泊(蒲昌海)的进退,战国秦汉明长城的位置,隋唐大运河与京杭大运河,丝绸之路,郑和航线——全都跟着年代走。
最后这一条其实是整个项目里最容易被低估的部分。多数历史地图只画疆域,因为疆域最好画:一块地,一个颜色。但真正决定一个朝代能养多少人的,是河怎么流、湖还在不在、运河通不通。
你在图上拖到北宋,会发现黄河是往北流进渤海的;拖到南宋,它改道南下了。这种变化在文字里要写三百字,在图上只需要你松一下手。
03 两千四百年,装得下吗
时间轴一共切了十八段:战国、秦、西汉、东汉、三国、西晋、东晋、南北朝、隋、唐、五代、北宋、南宋、元、明、清、民国、今。
拖动的时候,色带是一段段填满的,年份和朝代名同时在跳。下面这段动画是从公元前 403 年一路拖到今年的样子——注意看中间那一段几乎一闪而过。
从三家分晋到 2026 年。轴按真实年代比例排,所以秦只有五个像素宽。
我做这张图的时候,被一个数字绊了一下。
上面那条细线才是真实长度,下面十八格为了读得清被拉成一样宽。秦在真实比例尺上只有五个像素。
从公元前 403 年到今年,是两千四百二十九年。秦朝占十四年,0.6%。清占二百六十八年,11%。唐占二百八十九年,12%。
但历史课本给秦的篇幅,绝对不止 0.6%。它给了「统一六国」「书同文车同轨」「郡县制」「焚书坑儒」,给了整整一章。
这不是课本偏心。这是因为历史的重量不按年数分配。十四年里定下的那套制度,往后两千年都在用。地图只能画出面积,画不出重量——这是所有历史地图共同的局限,也是它们迷人的地方:你得自己知道该往哪儿多看两眼。
另一个数字更硬:164 个疆域快照。
十八个朝代,为什么要一百六十四张图?因为一个朝代的疆域不是一块不变的颜色。西汉从初年的休养生息,到武帝打通河西走廊、设河西四郡,到昭宣之后西域都护府,中间变了多少次;唐从贞观到开元到安史之乱之后,又是多少次。
所以这个项目的做法是:每一个重大开疆或失地的节点,单独存一张快照。
公元前 316 年司马错灭巴蜀、前 300 年燕将秦开破东胡辟辽东五郡、43 年马援平交趾立铜柱、238 年司马懿平公孙渊收辽东、635 年李靖平吐谷浑、648 年置安西四镇与王玄策破中天竺、1288 年元设宣政院直辖西藏、1404 年明置哈密卫与关西七卫、1881 年曾纪泽签《中俄伊犁条约》收复伊犁、1898 年列强强租胶州湾与旅大、1945 年抗战胜利台湾光复、1946 年外蒙古独立后版图由「秋海棠」变为「雄鸡」……
每一个节点,都是一张独立的图。点一下,版图立刻切换。
04 一根轴不够,他加了第二根
时间这条横轴做出来以后,他开始想另一件事:能不能从每座城市出发,走一走地理这条纵轴?
于是有了「点地溯源」:在地图上点任意一座古城、任意一道名关(或者双击地图任意位置),会展开一张卡片。
卡片顶部是该城专属的「名城判词」和一段小传;下面是一张沿革表,从战国与秦的郡,一路看到汉的刺史部、唐的道、宋的路、元明清的行省与府州,直到今天的省市。哪些朝代在这里建过都,会挂一个「王朝都城」的徽章。
每一行下面,还嵌着当年发生在这块地上的事。点右上角的「史事纪要」可以一键筛出「有大事」的朝代;点任意一条事件,时间轴和版图会直接穿越回那一年。
盛唐开元二十九年(741 年),点开长安:左边是地图,右边是它从战国到今天的沿革,每一行下面挂着当年发生在这座城的事。
我拿长安试了这张卡片,得到一个有点意外的结论。
「西安」这个名字,从 1369 年(明洪武二年改奉元路为西安府)算起,到现在六百五十七年。
「西安」这个名字,只有六百多年。
这块地方换过的名字,粗粗一数就是这个样子:
战国时它叫咸阳,长安只是咸阳下面的一个乡。西汉高祖五年置长安县,惠帝开始筑城,从此「长安」这个名字用了两千年。王莽篡汉,改长安为「常安」,用了十几年。隋文帝营新都,取名「大兴城」,唐又改回长安。元世祖至元年间改京兆府为安西路,皇庆元年又改奉元路。直到明洪武二年,奉元路改成西安府——「西安」才第一次出现。
一个城市在两千多年里换过这么多身份,而地图只画它一个点。这件事地图不记,史书才记。所以他把史书那部分,也塞进了地图里。
05 有了天地,人就该走进来了
这是他自己的说法:「有了横纵两条坐标轴,天与地都有了,那作为历史主角的人,是不是也能自然而然地走进这张地图?」
于是有了第三个玩法,「点人溯事」。在左上角的万能搜索框里输入任意一个名字——曹操、司马迁、岳飞、郑和——或者在网址后面加一个参数,就能把这个人一生的行迹画在版图上。
点人溯事:苏东坡从眉山出发,眉州、汴京、密州、徐州、湖州、黄州、惠州、儋州……每一站标着那一年,右边是这个人在那一站做了什么。
目前做了七条:秦始皇一统六国(前 238—前 221)、张骞凿空西域(前 138—前 126)、诸葛亮出山北伐(207—234)、玄奘西行求法(627—645)、李白仗剑壮游(701—762)、苏轼宦海贬谪(1056—1101)、王阳明心学立功(1472—1529)。
最动人的是苏轼那条。从出川赴京开始,密州超然台赏月,乌台诗案之后贬黄州写下《赤壁赋》,再贬惠州,最后跨海远谪海南儋州。
你按一下「下一站」,底下的年份、在位皇帝、年号、王朝版图,全都会跟着他的脚步一起变。当前这一段行程用一条朱砂弧线高亮,旁边配着《赤壁赋》《定风波》里的原句。
这个设计里有个细节我特别喜欢:苏轼那四站不是同一年的。湖州是 1079,黄州是 1080,惠州是 1094,儋州是 1097。所以网址里年份也是个列表:?year=1079,1080,1094,1097&place=湖州,黄州,惠州,儋州,年份和地名一一对应。
点其中任何一站,地图会切到那一年的版图。也就是说,你在同一条路线上,能看见北宋的疆域一层层缩下去。
「问汝平生功业,黄州惠州儋州。」这十个字,从此有了经纬度。
06 朱砂虚线那一笔,才是野心所在
前面这些,一个认真的历史地理爱好者都能想到。真正让我觉得「这个人想清楚了」的,是一个很小的视觉设计。
换年份的时候,新图会叠在旧图上,上一阶段的边界不会消失,而是变成一条朱砂虚线留在那里。
前 316 年,司马错伐蜀。合并之后整块变成一个颜色,只有中间那道朱砂虚线还记得原来的界线。
示意图:左边两片颜色共用一条边,右边合成一片,虚线就是旧界。真实地图的边界是几千个点连成的多边形,这里只保留「一块吃掉另一块」这件事。
为什么这一笔重要?因为历史叙事的主干就是「得」与「失」。
你看到 1881 年曾纪泽签《中俄伊犁条约》收复伊犁,光看一张图,只会看到一块地的边界挪了一点。加上残影,你能直接看到「挪了多少、原来在哪儿」。
你看 1898 年列强强租胶州湾、旅大、威海卫、九龙新界,光看颜色,看不出这些是「租借地」而不是「割让」。加上残影和标注,差别就出来了。
同理,1945 年抗战胜利、台湾光复,版图重光;1946 年外蒙古独立,版图从「秋海棠」变成「雄鸡」。这两笔,是二十世纪中国地图上最大的两次形变,而它们只隔一年。
一个静态地图做不到这件事。它只能给你「结果」。而残影给你的是「变化本身」——历史最有信息量的部分,从来都藏在动词里,不在名词里。
07 一百六十四张地图,怎么塞进一个网页
到这里,一个工程问题就躲不掉了:一百六十四张多边形地图,每张几千个坐标点,怎么可能放进一个网页?
答案是两件事:相邻的边只存一次;坐标不存绝对值,存「跟上一个点差多少」。
拓扑去重 + 增量编码 + 六十二进制,这是地图领域的通用做法,Google 的 Encoded Polyline 用的是同一套思路。
第一件事解决的是「重复」。两个政权接壤的地方,边界是同一条线。各存一遍,就是两倍的字节,而且渲染时容易出现肉眼可见的缝隙。所以项目把拓扑做了去重:一条共享边只存一份,两边引用同一个点序列。
第二件事解决的是「精度」。经纬度写成 116.397, 39.908,一对就是十四个字符。做法是乘一千取整,然后只记与上一个点的差值——边界上的点彼此很近,差值大多是个小整数。再把这些整数用六十二进制(A-Z、a-z、0-9 再加两个符号)编码,一个数就变成一个字符。
结果:整个两千年的几何数据,压进了一个 1.9 MB 的 js 文件。
我特意去仓库里数了一下体量:核心交互逻辑 app.js 一万五千九百八十二行,文史数据 lore_data.js 两万五千三百零三行,双语词条 384 KB,几何快照 1.9 MB。
而且——没有依赖,没有构建步骤。
整个项目是纯静态的。克隆下来,起一个静态服务器,打开就能跑:
SHELL · 两条命令,本地跑起来
git clone https://github.com/DeanChensj/jiangshan-map.git cd jiangshan-map python3 -m http.server 8000或者用 Docker,一条命令,端口 8008。镜像就是个 nginx:alpine,把这个仓库当静态文件发出去。
这一点在这个时代反而稀有。我们习惯了「先 npm install,再 npm run dev,然后发现 node 版本不对」。一个装了两千年历史的网页,装它自己只需要 Python 自带的一个命令。
代价当然有:数据不再是能直接读的。想改一个点,得先解码。所以作者另写了一个导出脚本,一条命令就能把一百六十四张快照还原成标准 GeoJSON,喂给 Leaflet、MapLibre 或者 QGIS。
08 它给 AI 留了一个后门,而且留得很聪明
这是我读 README 时最意外的一段。
大多数个人项目做到「好看好用」就停了。这个项目还额外做了一件事:把自己变成一个 AI 可以直接调用的工具。
三种维度,同一个地址栏:单点、同年多站、跨年多站。模型只要给出年份和地名。
它的协议只有两个参数:哪一年,哪个地名。
就这么两个。不需要经纬度,不需要 bounding box,不需要知道投影。
理由写得很清楚:「模型永远不需要猜经纬度坐标。」
这句话背后是一个很实用的判断。大语言模型不擅长算什么,它擅长从文本里抽出语义。你让它「把蓝关的坐标算出来」,它给你一个看着像那么回事、实际上偏了八十公里的数;你让它「从『雪拥蓝关马不前』里抽出年份和地名」,它做得又准又快。
所以接口设计就该顺着模型的长处来。让人和模型都只说人话,把坐标这种事留给地图自己。
这个双参数协议支持三种维度:
单点(0D):?year=819&place=蓝关 —— 跳到唐元和十四年,在秦岭上落一个针,展开蓝关的沿革卡。
同年多站(1D):?year=763&place=剑外,巴峡,巫峡,襄阳,洛阳 —— 杜甫「即从巴峡穿巫峡,便下襄阳向洛阳」。五站朱砂弧线,视野自动框住整条路。
跨年多站(4D):?year=1079,1080,1094,1097&place=湖州,黄州,惠州,儋州 —— 苏轼的后半生。年份与地名一一对应。
在这之上,它给了三种接入方式:
一个零依赖的本地 MCP 服务。一个 node 脚本,直接加进 Claude Desktop、Cursor、Windsurf 的配置里:
JSON · 接进 Claude Desktop / Cursor
{ "mcpServers": { "jiangshan-atlas": { "command": "node", "args": ["/path/to/jiangshan-map/scripts/mcp_server.js"] } } }它暴露三个工具:inspect_place(查某年某地的君主、政权、政区、今地名、沿革)、inspect_person(查人物的生平落点)、search_atlas(全库检索)。零第三方依赖,单次查询小于五毫秒。
一个 Agent Skill。带一个零依赖的 Python 脚本,可以一条命令出图:
SHELL · 一句话出一张诗境截图
python3 skills/jiangshan-atlas/scripts/jiangshan.py \ --year 1079,1080,1094,1097 \ --place 湖州,黄州,惠州,儋州 \ --out /tmp/sushi.png一个浏览器端 API。页面挂了 window.atlasAPI,也注册了 WebMCP 的三个工具,Playwright 之类的自动化环境可以直接驱动它。
我之所以说这个设计「聪明」,是因为它没有把 AI 当成一个附加功能(那种页面右下角飘一个对话气泡的东西),而是重新想了一遍:如果一个 Agent 要用这张地图,它需要什么?
答案是:它需要两个语义参数,和一个不会算错的坐标解析器。就这些。
09 最难的部分不是画图,是校勘
写到这里,我要说一件容易被忽略的事:这个项目最大的工作量,不在代码里。
我把仓库里的文史数据逐条数了一遍,大概是这样:
这些数字不是估的,是从仓库的 lore_data.js 里逐条数出来的。
六百九十四条地点史事、一百八十六条地名沿革、一百二十四位人物、一百一十个政权、八十七篇名城判词、二十座名关、三百五十一个年号——每一条都要有人确认它对不对。
而这种确认,是没法外包给模型的。作者在自述里写了两个细节,我看了很久。
第一个:「有一次我放大地图才发现,辽国的都城上京,居然被画在了辽国疆域外面,只好回头把辽北部的疆域和上京道一点点补齐。」
第二个:「还有一次,横跨欧亚的蒙古帝国,在罗布泊那儿莫名其妙破了个窟窿,查了半天才补上。」
明永乐十三年(1415 年),应天府悬停:两京十三布政使司,右下角还挂着这一朝的大事年表。
这种错误,只有在自己真的把图放大、一行一行看过去的时候才会发现。它不是 bug,是史料的错——数据集里这条边就是这样,画出来就是错的。
他的做法是和 AI 一起在网上翻各种开源数据集,再对照《资治通鉴》和各朝正史一点点纠错。等五胡十六国那一段修好,他把《两晋悲歌》又翻出来重读了一遍——「以前怎么也分不清的前秦、后秦、西秦,这回终于理顺了。」
我特别喜欢这句话。它说明这个项目不是为了炫技做的。他是真的想搞明白。
而这个项目的诚实,也体现在数据来源这一页上。
谭其骧《中国历史地图集》作底本,CHGIS、Hartwell 数据集补充,aourednik 提供周边,DataV 提供现代省界。
底本是谭其骧主编的《中国历史地图集》——八册,中国历史地理的公认基准。府州郡边界与战国疆域用了 CHGIS(哈佛燕京学社与复旦大学的项目)和 Robert M. Hartwell 的数据集。周边政权用了开源项目 aourednik/historical-basemaps。现代省界用 DataV GeoAtlas。古琴录音来自 Wikimedia Commons 的公有领域录音。
然后是一句我认为所有历史类项目都该抄的话:
历史疆域轮廓与州郡政区边界为示意性近似,旨在直观呈现各时期大致统治与管辖范围,非精确现代测绘边界。
这句话不是免责套话。它决定了这个项目能做什么、不能做什么:它能用来讲课、读诗、看大势;不能用来划界、举证、打官司。
还有一处更少见的诚实:项目整体是 GPL-3.0,但 README 里专门标了一个例外——来自 CHGIS V6 和 Hartwell 的府州郡边界与战国疆域,仍受原始条款约束(仅限学术、非商业用途),不随本项目一并授权。
很多项目会把这行字省掉。省掉之后用起来更「自由」,但那是拿别人的授权在自由。他标出来了。
10 四面碰壁,最后是被别人捞起来的
地图有了样子之后,他先发在同事群和朋友圈。不少喜欢历史的朋友提了建议,还有同事受启发做了衍生版本——有人做自己家乡的历史地图,有人拿它来背唐诗。
刚上 GitHub 那会儿没几个人看,他还「厚着脸皮发朋友圈找好友帮忙点 star」。
为了更多人看到,他加了英文版,发到 LinkedIn 和 Reddit。LinkedIn 上毫无水花。Reddit 上反响不错,有位在海外的中国网友留言说,他用这张地图给孩子讲中国历史,孩子特别喜欢。
但回到中文平台,几乎试一个碰壁一个:自己发小红书、发知乎都被限流;投稿给几个知名的中文 GitHub 推荐社群,也没什么动静。
转机来自 X 上的「知识分享官」。转发之后,几天之内涨了一千多个 star。
然后是他自己都觉得好笑的一段:「我自己发小红书被限流,火了之后倒有不少人在小红书和公众号上搬运我的地图,他们反倒拿到了不少流量。」
——写到这里我停了一下。因为这篇也是公众号,也是「写别人的东西」。区别大概只在于:我会把名字、地址、许可证、数据来源和那道没解决的坎,都写清楚。
火了之后,项目迎来了第一批外部贡献者:有人优化了渲染性能,有人加了 GeoJSON 导出,有人把它做成了能装到手机桌面的应用,中国台湾的朋友帮他加了繁体中文版,后台还收到不少鼓励的私信。
其中一条 GitHub 回复只有一句话:「我儿子被这网站硬控好几天。」
他在博客里回了这么一句:「做这张地图的这些天,我把那些朝代翻来覆去温习了好多遍,常常一坐就到了半夜。我也是那个被硬控的小孩。」
两周半,两百多次提交,从几十颗星到 1400,再到今天的 3642。这个数字在开源世界里不算什么大项目,但它的增长路径很典型:中文平台限流,海外社区认可,最后被一个大号捞起来。
11 彩蛋:测测你在古代能当几品官
如果前面那些还不够让你去点开它,这里还有一个。
舆图寻址:地名全被隐去,只给当朝掌故和史事线索,凭山河水系的直觉落针。
搜索框旁边有个很小的入口,叫「舆图寻址 · 古地名小试」。
规则很简单:地图上所有城池标注被隐去,系统给你十道题,题目是「请标出西汉时期的姑臧」「请标出南宋时期的泉州」「请标出六朝古都建康」,附一句当朝掌故作为线索,但不告诉你这地方今天叫什么。
你凭山河水系的直觉落针,点确定,会弹出同心圆环,按大圆距离算分。十题打完,系统按总分给你一个传统官阶:「太史令 · 舆图大家」「职方郎中」「州郡从事」。
我试了三题,最好的成绩是「州郡从事」。这个设置很坏,也很妙——它逼你把「地名」和「地形」分开想。真实的古代地理能力,本来就不是背名字。
12 为什么一张静态地图不够
回到开头那个问题:蓝关在哪儿。
现在你可以打开那个链接,输入「蓝关」,地图会跳到唐元和十四年,落一个朱砂针在秦岭上,右边弹出它的沿革卡。你再往右滑一年,看看那年韩愈走到哪儿了。
这件事本身很小。但它背后有一个大判断:地图是空间,历史是时间,而我们的教育一直把这两样东西分开教。
地理课给你一张今天的地图;历史课给你一张某个朝代的图,还不能动。所以大多数人对「中国历史地理」的认知,是一堆互相不连通的碎片:知道长安,不知道长安是咸阳旁边的一个乡;知道黄州,不知道它在长江边上;知道燕云十六州,不知道它为什么那么要命。
把时间轴和地图叠在一起之后,这些碎片才开始互相咬合。你会自己发现:为什么守江必守淮;为什么从关中打天下容易;为什么大运河一断,元明清的政治中心就得往北挪。
这些结论,课本上都写着。但只有你自己在图上拖出来一遍,它才变成你的。
作者在博客最后写了一句,我原样抄在这里:
谁说理工男不懂浪漫呢?把两千多年的山河、城池和古人走过的路装进同一张图里,看到这么多人跟我共享着同一份热爱,何尝不是一种幸福。
这个项目当然不完美。它的边界是近似的,它只做了七条人物行迹,它的时间轴在秦那一段窄得几乎看不见,它的古琴会自动播放(如果你不想听,右上角能关掉)。
但它做成了一件很多同类项目没做成的事:它让「读史」这件事,从翻页变成了拖拽。
而拖拽,是会让人上瘾的。
项目地址:github.com/DeanChensj/jiangshan-map 在线把玩:deanchen.me/jiangshan-map 许可:GPL-3.0(府州郡边界数据另受原始条款约束) 数据来源:谭其骧《中国历史地图集》、CHGIS、Hartwell、aourednik/historical-basemaps、DataV GeoAtlas
文中的数据(3642 stars、432 forks、164 个疆域快照、694 条地点史事、186 条地名、124 位人物、110 个政权、20 座名关、351 个年号、15982 行 app.js)取自 2026 年 11 月 3 日的仓库与其源码统计;作者自述引自其博客《从历史课本里的插图,到 GitHub 1k star》。文中实机截图与演示动图来自项目仓库的 assets 目录,动图经压缩处理。