江山时序:用时间轴探索中国2400年历史地图
一个把中国2400年疆域、古城和人物路线放进时间轴的交互地图,能对比古今边界而非只看静态地图。
GitHub DeanChensj/jiangshan-map 更新 2026-11-17 分支 main 星标 6.7K 分叉 793
JavaScript CSS HTML Python Dockerfile 中国历史地图 时间轴 GeoJSON 浏览器应用

🧭 决策指南

适合,如果你

  • 你要展示403 BCE至今的中国疆域变化,并需要18个历史时期切换
    README正文“Why It's Fun to Explore”说明项目覆盖2,400+年、18个历史时期,并可拖动时间轴
  • 你需要在同一画布比较七雄、三国或宋辽西夏等多政权
    README Feature 1 的“Multi-Polity Confrontations on a Single Canvas”章节
  • 你要查询长安、咸阳等古城的名称、行政沿革和事件
    README Feature 2 的“Trace Place”章节说明可查看2400年行政谱系和地点事件
  • 你需要用Person Chronicle展示秦始皇或张骞的历史路线
    README Feature 3列出Qin Shi Huang与Zhang Qian的Chronicle示例

不适合,如果你

  • 你需要现代地图之外的通用地理数据,而不是403 BCE至今的中国历史内容
    README将项目定义为“Interactive Historical Atlas of China from the Warring States (403 BCE) to the Present”
  • 你的分发模式不能接受GNU GPLv3许可
    项目元数据标注许可协议为GNU General Public License v3.0
  • 你必须立即获得本地运行命令和明确版本要求
    提供材料只列出Run Locally章节名称,未提供其具体内容、命令或版本

前置条件

  • 使用Voice Narration时,需要“a browser with speech synthesis”。
  • 交互内容以浏览器中的Live Demo为入口,README提供https://deanchen.me/jiangshan-map/?lang=en。
  • 项目技术栈包含JavaScript、CSS、HTML、Python和Dockerfile,但材料未给出本地安装版本。

要注意

  • 语音讲解不是独立语音引擎,而是浏览器内置speech synthesis
    README Feature 1 的“Voice Narration”明确写明requires a browser with speech synthesis
  • 查看现代省界时需确认Layers中的Provinces默认开启
    README Feature 1说明Provinces is on by default,Prov. Names用于显示省名
  • 时间轴短时期缩放需拖动两端句柄,双击才恢复总览
    README Feature 1 的“Zoomable Timeline”章节

材料未说明

  • README材料未提供Run Locally和Run with Docker的具体命令、镜像名称或版本要求。
  • 材料未说明数据源的具体名称、数据校验方法和历史边界的准确率。
  • 材料未说明浏览器兼容性、移动端表现和大规模缩放时的性能指标。
  • 材料仅列出AI Agent、MCP、GeoJSON Export和window.atlasAPI章节名称,未提供其调用方式与接口稳定性。
  • 材料未说明项目是否接受外部贡献、Issue响应时间和未来版本计划。

💡 深度解析

6
适合 我维护一个 JavaScript 教学网站,需要把江山时序嵌入页面,并用 URL 固定年份、中心位置、悬停对象和语言;这个项目是否适合做可复用组件?
适合读者: 维护 JavaScript 教学网站、希望把历史地图嵌入页面并通过深链接固定年份和地点的前端工程师

适合:README 同时提供页面嵌入、可分享深链接和浏览器 JavaScript API,能够支持教学页面中的固定视图。

  • 项目核心语言是 JavaScript,交互地图本身运行在浏览器中,不要求用户安装专业 GIS 软件。
  • README 给出了可复现的链接示例:?year=1415&zoom=1.75&center=115.8,33.2&hover=Yingtian%20Prefecture&lang=en,可固定年份、缩放、中心、悬停对象和语言。
  • “Embed in Your Page”与 window.atlasAPI 表明项目考虑了嵌入和程序化控制,不只是独立网页。
  • 界面支持简体中文、繁体中文、英文和日文,适合多语言课程页面。

不过,提供的 README 摘要没有说明嵌入代码、API 方法签名、跨域策略、移动端适配细节或版本兼容承诺;因此正式集成前仍需核对完整章节。

  • 项目核心数据:main_language 为 JavaScript
  • README:"Embed in Your Page"、"Browser JavaScript API (`window.atlasAPI`)"
  • README Feature 1:`?year=1415&zoom=1.75&center=115.8,33.2&hover=Yingtian%20Prefecture&lang=en`
  • README 顶部:English、简体中文、繁體中文、日本語
材料未说明:嵌入方式、API 的具体方法、返回值和事件机制未在提供的正文中展示;项目是否提供稳定的 npm 包、iframe 约定或生产环境版本锁定方式未说明
适合 我在中学或大学中国史课程中,需要用浏览器演示从战国 403 BCE 到现代的政权变化,并让学生查看古城沿革和人物路线;这个项目适合课堂使用吗?
适合读者: 需要为中学或大学中国史课程制作中文、英文或日文互动演示的历史教师,课堂设备主要使用浏览器

适合:它把时间轴、政权、古城沿革和人物活动放在同一浏览器界面中,正好对应课堂上的时空解释需求。

  • README 将 403 BCE 至今、18 个历史时期和 2,400 多年历史放在单一交互地图中,教师可以拖动时间轴观察阶段变化。
  • 多政权同图支持战国七雄、三国、南北朝、五代十国以及宋辽西夏金等并存局面,适合演示“同一时期多政权对峙”。
  • Trace Place 能展示古城跨时代的名称、行政归属、都城身份和地点事件;人物编年功能则把活动节点与地图连接起来。
  • 项目支持中、繁中、英、日界面,并提供浏览器 Speech Synthesis 语音讲述,可用于多语言或听觉辅助演示。

需要注意,图层、路线和时间轴入口较多,移动端触控和语音效果也依赖浏览器环境;README 还明确说明历史边界是重建或概化结果,不应作为唯一学术结论。

  • README:"from the Warring States (403 BCE) to the Present"、"18 historical periods"、"2,400+ years"
  • README Feature 1:"Multi-Polity Confrontations on a Single Canvas"
  • README Feature 2:"Trace Place" 与 "2,400-Year Administrative Genealogy"
  • README:"Voice Narration",requires a browser with speech synthesis
  • 项目洞察 user_experience:基础浏览可通过时间轴、地图对象和搜索框开始
材料未说明:课堂离线使用、资源加载大小和弱网络下的可用性未说明;语音内容的完整语言覆盖、自动播放限制和无障碍规范支持程度未说明
适合 我正在制作苏轼、韩愈和岳飞相关的古典诗词专题页面,需要把黄州、蓝关、朱仙镇等地点与事件、人物路线和特定年份关联起来;这个项目能否减少我手工拼接地图和年表的工作?
适合读者: 使用桌面浏览器制作古典诗词和历史人物专题页面、需要把地点、事件和路线固定到文章链接中的中文内容创作者

适合:项目已经把古代地点谱系、事件跳转、人物编年和诗文地标放进同一套时间—空间交互中,能减少文章作者手工拼接地图与年表的工作。

  • README 直接列出 Jiankang、Huangzhou、Languan Pass 和 Zhuxianzhen 等地点,并以诗文和历史事件作为探索入口。
  • Trace Place 会展示地点跨 18 个历史时期的名称、行政归属、都城身份和现场事件,点击事件即可跳转到对应年份。
  • Feature 3 的 Person Chronicles 将人物生平节点、战役、出使或迁徙路线标到动态历史地图上,适合构建人物专题。
  • Shareable Deep Links 和 Embed in Your Page 可把固定年份、中心位置、地点和语言写进文章或嵌入页面。

但项目中的人物路线、诗文地标和事件关联具有叙事编排属性,不能自动视为唯一的学术解释。README 摘要也没有说明是否能为每条内容导出独立引用、来源注释或稳定的事件 ID。

  • README Why It's Fun to Explore:Jiankang、Huangzhou、Languan Pass、Zhuxianzhen
  • README Feature 2:"Trace Place"、"Site-Specific Landmark Events",点击事件可 time-travel 到对应年份
  • 项目洞察 solution_analysis:Person Chronicle 将人物生平、战役、出使或迁徙路线标注到地图
  • README 省略章节列表:"Shareable Deep Links"、"Embed in Your Page"
材料未说明:每个地点、人物和事件是否有稳定 ID、独立引用格式和来源脚注未说明;深链接是否能同时固定人物路线、事件筛选和图层状态未说明
视情况 我负责一个开源数字人文站点,要求用 Docker 部署江山时序,并允许团队修改 JavaScript、CSS 和 HTML;在 GPLv3 与数据授权约束下,这个项目是否适合作为基础?
适合读者: 需要在 Docker 中部署一个可访问的中国历史地图站点、同时受 GPLv3 和第三方数据授权约束的开源项目维护者

视情况适合:项目提供 Docker 运行方式且代码采用 GPLv3,但代码许可证并不自动覆盖历史数据、文字、图片和第三方资源。

  • 项目主要由 JavaScript、CSS 和 HTML 构成,适合前端团队阅读和修改;项目数据还包含少量 Python 与 Dockerfile。
  • README 的 “Run with Docker” 表明部署路径已被考虑,适合将交互地图作为独立 Web 服务运行。
  • 项目许可证是 GNU GPLv3,允许在相应条件下使用和修改项目代码,但再发布时需要遵守 GPLv3 的源代码和许可要求。
  • 项目洞察明确指出,数据、文字、图片、历史资料及第三方资源可能分别受授权约束;商业部署或再发布不能只检查仓库许可证。

因此它适合作为代码基础,不代表所有地图数据都能自由打包或商业使用。现有 README 摘要没有列出每项数据的独立许可证、Docker 生产配置或外部资源清单。

  • 项目核心数据:license 为 GNU General Public License v3.0
  • README 省略章节列表:"Run with Docker"
  • 项目核心数据:语言分布包含 JavaScript、CSS、HTML、Python 和 Dockerfile
  • 项目洞察 usage_limitations:数据、文字、图片、历史资料及第三方资源可能受各自授权约束
材料未说明:Docker 镜像构建参数、端口、持久化需求和生产部署配置未提供;各数据集、图片、文字和第三方地图资源的具体许可证及归属未列出;项目对修改版发布、品牌标识和外部服务依赖的额外要求未说明
视情况 我正在用 QGIS 或 Leaflet 研究中国历史地理,需要处理 403 BCE 至今、18 个历史时期和 198 个疆域快照;这个项目能否作为可复用的历史空间数据来源?
适合读者: 使用 QGIS 或 Leaflet 做中国历史地理研究、需要对照古代行政区与现代省界的数字人文研究人员

视情况适合:它明确提供 GeoJSON 导出和历史图层,但不应直接当作精确测绘或完整史料数据库。

  • 项目把疆域、古代行政区、现代省界、河流、湖泊、长城、运河和路线作为分层数据,适合导入 Leaflet、MapLibre 或 QGIS 做可视化对照。
  • 数据覆盖 18 个历史时期、198 个疆域快照,适合研究主要阶段变化;Ghost Boundary Diff 还能表达相邻阶段的领土增减。
  • README 明确提醒古代疆域、海岸线和行政区属于重建或概化结果,不能直接用于精确边界认定。
  • 研究结论还需要回到项目列出的数据来源和原始史料核验,尤其是争议性疆域、人物路线和事件关联。

README 未说明 GeoJSON 的完整字段定义、坐标系、数据版本策略和每个图层的精度等级,因此能否直接满足定量研究仍取决于数据结构。

  • 项目洞察 solution_analysis:提供 GeoJSON 导出,可用于 Leaflet / MapLibre / QGIS
  • README Feature 1:"18 historical periods"、"198 territory snapshots"
  • README Feature 1:"Ghost Boundary Diff"
  • 项目洞察 usage_limitations:古代疆域、行政区、海岸线属于重建或概化结果
材料未说明:GeoJSON 的字段、坐标系、几何精度和数据文件组织方式未在提供的 README 正文中说明;各历史图层是否拥有独立来源、版本号和不确定性标注未说明
视情况 我正在开发一个 JavaScript AI 工具,需要让模型查询古城沿革、按年份定位地图,并处理单年或多年的路线;这个项目的 MCP、CLI 和浏览器 API 能否作为调用入口?
适合读者: 开发 AI 工具或 MCP 客户端、希望让模型查询历史年份、地点和路线的 JavaScript 工程师

视情况适合:README 明确提供 MCP/LLM、CLI 和浏览器 API 入口,但完整的工具协议和数据返回契约未在现有摘要中展开。

  • “AI Agent, MCP & LLM Integration”以及 navigator.modelContext 表明项目考虑了面向 AI 工具的模型上下文接口。
  • “CLI One-Command Screenshot & JSON Lookup”支持截图和 JSON 查询,适合代理执行地图定位、读取结构化结果或生成可视化证据。
  • README 还列出 0D Pinpoint、1D Same-Year Route 和 4D Multi-Year Route URL Protocol,说明查询可以表达地点、同年路线和跨年份路线。
  • window.atlasAPI 为浏览器内 JavaScript 调用提供了另一条路径,适合已经运行在网页中的 AI 功能。

但是否能直接接入生产 AI 编排,取决于 MCP 工具名、参数 schema、JSON 字段、错误处理、认证和截图命令的实际定义。项目数据只有 4 个 release,不能据此推断接口长期稳定性。

  • README 省略章节列表:"AI Agent, MCP & LLM Integration"
  • README 省略章节列表:"CLI One-Command Screenshot & JSON Lookup (for Agent Tool Calls)"
  • README 省略章节列表:"Browser JavaScript API (`window.atlasAPI`) & In-Browser WebMCP (`navigator.modelContext`)"
  • README 省略章节列表:"0D Pinpoint / 1D Same-Year Route / 4D Multi-Year Route"
  • 项目核心数据:latest_release 为 v1.3.0,release_count 为 4
材料未说明:MCP 工具列表、参数 schema、返回 JSON 结构和错误码未提供;CLI 的实际命令、运行时依赖、认证方式和接口稳定性承诺未说明;是否支持远程 MCP 服务或只支持本地浏览器上下文未说明

✨ 核心亮点

  • 覆盖403 BCE至今、18个历史时期和198个疆域快照
  • Ghost Boundary Diff直观看出历次疆域增减
  • Trace Place串联古城2400年名称与行政沿革
  • 支持多政权并置、现代省界叠加和动态河道
  • Person Chronicle展示曹操、张骞等人物行迹

🔧 工程化

  • 拖动时间轴切换秦、唐、元、清等时期疆域
  • 点击古城打开Trace Place行政谱系与事件卡
  • Layers菜单叠加Provinces与Prov. Names
  • 浏览器语音合成可朗读年份与历史事件
  • Person Chronicle追踪秦始皇、张骞等人物路线

⚠️ 风险

  • Voice Narration要求浏览器支持speech synthesis
  • README未提供Run Locally的具体命令与版本
  • 项目仅有10位贡献者和4个版本发布
  • GPLv3许可不适合需要非GPL分发条件的项目

👥 适合谁?

  • 研究中国历史疆域与行政沿革的开发者
  • 需要古城、关隘和诗文路线交互展示的前端团队
  • 希望用JavaScript浏览器应用探索历史地图的用户