Uncategorized约 5 分钟

《江山时序》连更四版到 v1.3.0:给 AI 补一张历史地图,难的不是画出来

开源项目《江山时序》在不到一个月内连发四个大版本至 v1.3.0,它没有让大模型自己画地图,而是把两千四百年政区数据封装成 MCP 与 URL 协议。

《江山时序》连更四版到 v1.3.0:给 AI 补一张历史地图,难的不是画出来

2026年11月13日,开源中国历史交互地图项目《江山时序》(DeanChensj/jiangshan-map)在 GitHub 发布页 推出 v1.3.0。距离 v1.0.0 上线(10月17日)还不到一个月,作者连续推出四个大版本。相比古舆图视觉风格本身,更值得行业拆解的是它的系统分工:项目没有让大模型凭空生成地图或猜测坐标,而是把两千四百年的疆域与政区数据做成了可供 Agent 调用的确定性引擎。

四周连发四版,从静态看疆域走向动态演战局

顺着 v1.0.0、v1.1.0(10月27日)、v1.2.0(11月3日)到 v1.3.0 的迭代轨迹来看,产品定位正在从「按年代翻看疆域」转向「按人物与局势推演时空」。多阶段版图快照数量从 164 幅一路增至 183 幅、189 幅再到 198 幅,时间轴大事从 395 条扩至 471 条、485 条和 526 条,人物行迹则从最初 7 条扩展到 104 条与 124 条以上(llms.txt 中记录已超过 125 位),并补充了 110 个历代政权档案与 1,753 座古城映射。

最新发布的 v1.3.0 在结构上补了两块关键拼图。一是 9 处古海岸线演变遮罩,让渤海湾、苏北与珠三角的海岸及黄河、淮河、长江入海口按时代位置进退;二是「点事溯局」模式,将楚汉之争、安史之乱与靖康之变拆为 10 个节点、三幕推进,双色区分双方行军与攻防路线,跨越朝代时底图同步切换。在工程取舍上,作者没有堆叠 React 或 Vue 等重型前端框架,而是保持原生 JavaScript 搭配 SVG 与 Canvas 渲染,把首屏同步脚本从约 576 KB 压到 374 KB(gzip 压缩减少 35%),并把疆域多边形拆分到按朝代整理的 GeoJSON 源文件里,在 CI 流程中跑拓扑、政区和布局审计。

v1.3.0 更新日志截图
图:v1.3.0 更新日志列出古海岸线、双阵营沙盘与首屏脚本瘦身 35% 等改动(英文原图)

不让大模型猜经纬度,把 GIS 做成双参数外挂

拿通用大模型读史料、解古诗或做历史科普时,最容易出现幻觉的环节往往不是文意理解,而是时空坐标对齐。同样一个古地名,换个朝代可能已经搬到数百公里之外。项目在 llms.txt 规范 里举了一个直白的例子:同样叫「江州」,秦汉巴郡治所对应今天的重庆,而唐宋江南西路江州治所浔阳则在今天的江西九江。

针对这个痛点,《江山时序》把工作流切成了清晰的两段。语言模型只负责做它擅长的文本推理,从古文或诗句中抽取出两个语义参数——year 与 place;而古今地名消歧、18 个时期底图切换、多点弧线轨迹渲染、20 座名关与 349 个现代地级行政区沿革关联,全部交给确定性的本地图谱完成。无论在网页端调用 window.atlasAPI 和 WebMCP(navigator.modelContext),还是通过零 npm 依赖、离线响应低于 5ms 的本地 stdio MCP 服务器(scripts/mcp_server.js)或 skills/jiangshan-atlas 技能包接入 Claude Desktop、Cursor、Windsurf 与 Gemini CLI,大模型都不必自己计算一个经纬度数字。

大模型与 MCP 集成说明截图
图:仓库文档展示大模型免猜经纬度的参数提取方案与本地 MCP 配置(英文原图)
GitHub 仓库文件目录截图
图:GitHub 仓库目录结构,包含 Agent Skill、脚本工具与分朝代专题目录(英文原图)

真正卡住节奏的不是前端,而是史料审计与版权分层

渲染性能与交互体验可以在四周内快速迭代四个版本,但历史人文类 AI 工具的天花板并不在前端。v1.3.0 更新日志公布了一组很实在的进度:仓库新增了 data/sources/ 目录并把出处审计接入 CI,然而全库 1,455 条大事、事件、行迹与人物记录里,目前完成原始史籍出处标注的只有 139 条。官方网页端 底部也明确提示,图上的历史疆域与政区属于示意性近似,并非精确测绘边界。

另一道经常被忽略的门槛来自数据授权。尽管应用代码、手绘政权轮廓、古城与人物资料以及地形渲染图块均采用 GPL-3.0 协议,但州、郡、府一级政区边界衍生自 CHGIS V6 与 Robert M. Hartwell 中国历史地理信息系统(简化至 0.01°),必须遵守原数据库「仅限学术与非商业用途、禁止再分发」的条款。这解释了为什么仓库的 GeoJSON 导出脚本默认不输出政区层——作者在工程层面主动把可自由分发的开源代码与受限学术数据隔离开来,同时明确标出谭其骧主编《中国历史地图集》仅作学术考据参考,仓库内不包含其图像或数据。

数据来源与开源协议表截图
图:项目各图层的数据来源与开源协议表,州郡边界沿用 CHGIS 学术条款(英文原图)

垂直知识库接入 Agent 的一条务实路径

放回更大范围的 AI 应用生态来看,《江山时序》提供了一个很有参考价值的工程样本:在历史地理、法条考据、医疗典籍这类容错率极低的领域,靠提示词或微调硬背结构化事实既昂贵又容易漂移,不如先把可信数据沉淀成轻量本地索引,再通过 llms.txt、MCP 工具与语义化 URL 向 Agent 暴露接口。对于正在把专业知识库改造成 AI 工具的团队而言,这种「模型做语义解析、确定性引擎管事实与渲染」,并提前做好非商授权数据隔离的做法,比盲目追求端到端生成更有长远价值。

资料与来源

官方参考资料 ↗

SHARE THIS ARTICLE

复制链接,保存或分享这篇文章。

MORE ARTICLES

更多文章

全部文章 ↗