跳到内容
当前位置:首页>高中教材>历史课本只给你一张地图,他给了你两千四百年

历史课本只给你一张地图,他给了你两千四百年

  • 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 目录,动图经压缩处理。

基本 文件 流程 错误 SQL 调试
  1. 请求信息 : 2026-11-23 07:08:14 HTTP/1.1 GET : http://c.sjds.net/a/485432.html
  2. 运行时间 : 0.075483s [ 吞吐率:13.25req/s ] 内存消耗:4,547.57kb 文件加载:140
  3. 缓存信息 : 0 reads,0 writes
  4. 会话信息 : SESSION_ID=5ecc759f46bf662a4272337905c741e1
  1. /www/wwwroot/c.sjds.net/public/index.php ( 0.79 KB )
  2. /www/wwwroot/c.sjds.net/vendor/autoload.php ( 0.17 KB )
  3. /www/wwwroot/c.sjds.net/vendor/composer/autoload_real.php ( 2.49 KB )
  4. /www/wwwroot/c.sjds.net/vendor/composer/platform_check.php ( 0.90 KB )
  5. /www/wwwroot/c.sjds.net/vendor/composer/ClassLoader.php ( 14.03 KB )
  6. /www/wwwroot/c.sjds.net/vendor/composer/autoload_static.php ( 4.90 KB )
  7. /www/wwwroot/c.sjds.net/vendor/topthink/think-helper/src/helper.php ( 8.34 KB )
  8. /www/wwwroot/c.sjds.net/vendor/topthink/think-validate/src/helper.php ( 2.19 KB )
  9. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/helper.php ( 1.47 KB )
  10. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/stubs/load_stubs.php ( 0.16 KB )
  11. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Exception.php ( 1.69 KB )
  12. /www/wwwroot/c.sjds.net/vendor/topthink/think-container/src/Facade.php ( 2.71 KB )
  13. /www/wwwroot/c.sjds.net/vendor/symfony/deprecation-contracts/function.php ( 0.99 KB )
  14. /www/wwwroot/c.sjds.net/vendor/symfony/polyfill-mbstring/bootstrap.php ( 8.26 KB )
  15. /www/wwwroot/c.sjds.net/vendor/symfony/polyfill-mbstring/bootstrap80.php ( 9.78 KB )
  16. /www/wwwroot/c.sjds.net/vendor/symfony/var-dumper/Resources/functions/dump.php ( 1.49 KB )
  17. /www/wwwroot/c.sjds.net/vendor/topthink/think-dumper/src/helper.php ( 0.18 KB )
  18. /www/wwwroot/c.sjds.net/vendor/symfony/var-dumper/VarDumper.php ( 4.30 KB )
  19. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/App.php ( 15.30 KB )
  20. /www/wwwroot/c.sjds.net/vendor/topthink/think-container/src/Container.php ( 15.76 KB )
  21. /www/wwwroot/c.sjds.net/vendor/psr/container/src/ContainerInterface.php ( 1.02 KB )
  22. /www/wwwroot/c.sjds.net/app/provider.php ( 0.19 KB )
  23. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Http.php ( 6.04 KB )
  24. /www/wwwroot/c.sjds.net/vendor/topthink/think-helper/src/helper/Str.php ( 7.29 KB )
  25. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Env.php ( 4.68 KB )
  26. /www/wwwroot/c.sjds.net/app/common.php ( 0.03 KB )
  27. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/helper.php ( 18.78 KB )
  28. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Config.php ( 5.54 KB )
  29. /www/wwwroot/c.sjds.net/config/app.php ( 0.95 KB )
  30. /www/wwwroot/c.sjds.net/config/cache.php ( 0.78 KB )
  31. /www/wwwroot/c.sjds.net/config/console.php ( 0.23 KB )
  32. /www/wwwroot/c.sjds.net/config/cookie.php ( 0.56 KB )
  33. /www/wwwroot/c.sjds.net/config/database.php ( 2.48 KB )
  34. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/facade/Env.php ( 1.67 KB )
  35. /www/wwwroot/c.sjds.net/config/filesystem.php ( 0.61 KB )
  36. /www/wwwroot/c.sjds.net/config/lang.php ( 0.91 KB )
  37. /www/wwwroot/c.sjds.net/config/log.php ( 1.35 KB )
  38. /www/wwwroot/c.sjds.net/config/middleware.php ( 0.19 KB )
  39. /www/wwwroot/c.sjds.net/config/route.php ( 1.89 KB )
  40. /www/wwwroot/c.sjds.net/config/session.php ( 0.57 KB )
  41. /www/wwwroot/c.sjds.net/config/trace.php ( 0.34 KB )
  42. /www/wwwroot/c.sjds.net/config/view.php ( 0.82 KB )
  43. /www/wwwroot/c.sjds.net/app/event.php ( 0.25 KB )
  44. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Event.php ( 7.67 KB )
  45. /www/wwwroot/c.sjds.net/app/service.php ( 0.13 KB )
  46. /www/wwwroot/c.sjds.net/app/AppService.php ( 0.26 KB )
  47. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Service.php ( 1.64 KB )
  48. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Lang.php ( 7.35 KB )
  49. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/lang/zh-cn.php ( 13.70 KB )
  50. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/initializer/Error.php ( 3.31 KB )
  51. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/initializer/RegisterService.php ( 1.33 KB )
  52. /www/wwwroot/c.sjds.net/vendor/services.php ( 0.14 KB )
  53. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/service/PaginatorService.php ( 1.52 KB )
  54. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/service/ValidateService.php ( 0.99 KB )
  55. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/service/ModelService.php ( 2.04 KB )
  56. /www/wwwroot/c.sjds.net/vendor/topthink/think-trace/src/Service.php ( 0.77 KB )
  57. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Middleware.php ( 6.72 KB )
  58. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/initializer/BootService.php ( 0.77 KB )
  59. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/Paginator.php ( 11.86 KB )
  60. /www/wwwroot/c.sjds.net/vendor/topthink/think-validate/src/Validate.php ( 63.20 KB )
  61. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/Model.php ( 23.55 KB )
  62. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/model/concern/Attribute.php ( 21.05 KB )
  63. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/model/concern/AutoWriteData.php ( 4.21 KB )
  64. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/model/concern/Conversion.php ( 6.44 KB )
  65. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/model/concern/DbConnect.php ( 5.16 KB )
  66. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/model/concern/ModelEvent.php ( 2.33 KB )
  67. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/model/concern/RelationShip.php ( 28.29 KB )
  68. /www/wwwroot/c.sjds.net/vendor/topthink/think-helper/src/contract/Arrayable.php ( 0.09 KB )
  69. /www/wwwroot/c.sjds.net/vendor/topthink/think-helper/src/contract/Jsonable.php ( 0.13 KB )
  70. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/model/contract/Modelable.php ( 0.09 KB )
  71. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Db.php ( 2.88 KB )
  72. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/DbManager.php ( 8.52 KB )
  73. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Log.php ( 6.28 KB )
  74. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Manager.php ( 3.92 KB )
  75. /www/wwwroot/c.sjds.net/vendor/psr/log/src/LoggerTrait.php ( 2.69 KB )
  76. /www/wwwroot/c.sjds.net/vendor/psr/log/src/LoggerInterface.php ( 2.71 KB )
  77. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Cache.php ( 4.92 KB )
  78. /www/wwwroot/c.sjds.net/vendor/psr/simple-cache/src/CacheInterface.php ( 4.71 KB )
  79. /www/wwwroot/c.sjds.net/vendor/topthink/think-helper/src/helper/Arr.php ( 16.63 KB )
  80. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/cache/driver/File.php ( 7.84 KB )
  81. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/cache/Driver.php ( 9.03 KB )
  82. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/contract/CacheHandlerInterface.php ( 1.99 KB )
  83. /www/wwwroot/c.sjds.net/app/Request.php ( 0.09 KB )
  84. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Request.php ( 55.78 KB )
  85. /www/wwwroot/c.sjds.net/app/middleware.php ( 0.25 KB )
  86. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Pipeline.php ( 2.61 KB )
  87. /www/wwwroot/c.sjds.net/vendor/topthink/think-trace/src/TraceDebug.php ( 3.40 KB )
  88. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/middleware/SessionInit.php ( 1.94 KB )
  89. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Session.php ( 1.80 KB )
  90. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/session/driver/File.php ( 6.27 KB )
  91. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/contract/SessionHandlerInterface.php ( 0.87 KB )
  92. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/session/Store.php ( 7.12 KB )
  93. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Route.php ( 23.73 KB )
  94. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/route/RuleName.php ( 5.75 KB )
  95. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/route/Domain.php ( 2.53 KB )
  96. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/route/RuleGroup.php ( 22.43 KB )
  97. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/route/Rule.php ( 26.95 KB )
  98. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/route/RuleItem.php ( 9.78 KB )
  99. /www/wwwroot/c.sjds.net/route/app.php ( 1.72 KB )
  100. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/facade/Route.php ( 4.70 KB )
  101. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/route/dispatch/Controller.php ( 4.74 KB )
  102. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/route/Dispatch.php ( 10.44 KB )
  103. /www/wwwroot/c.sjds.net/app/controller/Index.php ( 4.81 KB )
  104. /www/wwwroot/c.sjds.net/app/BaseController.php ( 2.05 KB )
  105. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/facade/Db.php ( 0.93 KB )
  106. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/connector/Mysql.php ( 5.44 KB )
  107. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/PDOConnection.php ( 52.47 KB )
  108. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/Connection.php ( 8.39 KB )
  109. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/ConnectionInterface.php ( 4.57 KB )
  110. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/builder/Mysql.php ( 16.58 KB )
  111. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/Builder.php ( 24.06 KB )
  112. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/BaseBuilder.php ( 27.50 KB )
  113. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/Query.php ( 15.71 KB )
  114. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/BaseQuery.php ( 45.13 KB )
  115. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/TimeFieldQuery.php ( 7.43 KB )
  116. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/AggregateQuery.php ( 3.26 KB )
  117. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/ModelRelationQuery.php ( 20.07 KB )
  118. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/ParamsBind.php ( 3.66 KB )
  119. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/ResultOperation.php ( 7.01 KB )
  120. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/WhereQuery.php ( 19.37 KB )
  121. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/JoinAndViewQuery.php ( 7.11 KB )
  122. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/TableFieldInfo.php ( 2.63 KB )
  123. /www/wwwroot/c.sjds.net/vendor/topthink/think-orm/src/db/concern/Transaction.php ( 2.77 KB )
  124. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/log/driver/File.php ( 5.96 KB )
  125. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/contract/LogHandlerInterface.php ( 0.86 KB )
  126. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/log/Channel.php ( 3.89 KB )
  127. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/event/LogRecord.php ( 1.02 KB )
  128. /www/wwwroot/c.sjds.net/vendor/topthink/think-helper/src/Collection.php ( 16.47 KB )
  129. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/facade/View.php ( 1.70 KB )
  130. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/View.php ( 4.39 KB )
  131. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Response.php ( 8.81 KB )
  132. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/response/View.php ( 3.29 KB )
  133. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/Cookie.php ( 6.06 KB )
  134. /www/wwwroot/c.sjds.net/vendor/topthink/think-view/src/Think.php ( 8.38 KB )
  135. /www/wwwroot/c.sjds.net/vendor/topthink/framework/src/think/contract/TemplateHandlerInterface.php ( 1.60 KB )
  136. /www/wwwroot/c.sjds.net/vendor/topthink/think-template/src/Template.php ( 46.61 KB )
  137. /www/wwwroot/c.sjds.net/vendor/topthink/think-template/src/template/driver/File.php ( 2.41 KB )
  138. /www/wwwroot/c.sjds.net/vendor/topthink/think-template/src/template/contract/DriverInterface.php ( 0.86 KB )
  139. /www/wwwroot/c.sjds.net/runtime/temp/52e0794259aeabc01163982c3f0015ae.php ( 8.05 KB )
  140. /www/wwwroot/c.sjds.net/vendor/topthink/think-trace/src/Html.php ( 4.42 KB )
  1. CONNECT:[ UseTime:0.000639s ] mysql:host=172.18.0.4;port=3306;dbname=c_sjds;charset=utf8mb4
  2. SHOW FULL COLUMNS FROM `fenlei` [ RunTime:0.001467s ]
  3. SELECT * FROM `fenlei` WHERE `fid` = 0 [ RunTime:0.000456s ]
  4. SELECT * FROM `fenlei` WHERE `fid` = 63 [ RunTime:0.000354s ]
  5. SHOW FULL COLUMNS FROM `set` [ RunTime:0.000548s ]
  6. SELECT * FROM `set` [ RunTime:0.000287s ]
  7. SHOW FULL COLUMNS FROM `article` [ RunTime:0.000696s ]
  8. SELECT * FROM `article` WHERE `id` = 485432 LIMIT 1 [ RunTime:0.000445s ]
  9. UPDATE `article` SET `lasttime` = 1795388894 WHERE `id` = 485432 [ RunTime:0.002106s ]
  10. SELECT * FROM `fenlei` WHERE `id` = 66 LIMIT 1 [ RunTime:0.000326s ]
  11. SELECT * FROM `article` WHERE `id` < 485432 ORDER BY `id` DESC LIMIT 1 [ RunTime:0.000426s ]
  12. SELECT * FROM `article` WHERE `id` > 485432 ORDER BY `id` ASC LIMIT 1 [ RunTime:0.000387s ]
  13. SELECT * FROM `article` WHERE `id` < 485432 ORDER BY `id` DESC LIMIT 10 [ RunTime:0.000562s ]
  14. SELECT * FROM `article` WHERE `id` < 485432 ORDER BY `id` DESC LIMIT 10,10 [ RunTime:0.000832s ]
  15. SELECT * FROM `article` WHERE `id` < 485432 ORDER BY `id` DESC LIMIT 20,10 [ RunTime:0.000619s ]
0.086484s