# 山河纪 · 源码说明

「山河纪」是开源项目 **江山时序（[DeanChensj/jiangshan-map](https://github.com/DeanChensj/jiangshan-map)）** 的改进版，
沿用其 **GPL-3.0** 许可证（见 [LICENSE](LICENSE)）。本站为纯静态 HTML/JS（另含一个 Cloudflare Pages Function），
所部署的文件即完整源码：`index.html`、`css/`、`js/`、`scripts/`、`functions/`。

## 相对上游的改动
1. **夏商周春秋**：时间轴上溯至约前 2070 年，新增夏（传说·示意）、商（2 阶段）、西周（2 阶段）、春秋（6 阶段）共 11 幅示意疆域，
   以及都城、事件、地名沿革条目。生成脚本：`scripts/preqin/`（数据 `preqin_data.py`，构建 `build_preqin.py`）。
2. **战役行军动画**：16 场战役的分步行军箭头（`js/battles.js`、`js/battles_data.js`），支持 `?battle=<key>` 深链与站内搜索。
3. **问史 · AI 问答上地图**：`js/ask.js` + `functions/api/ask.js`（Workers AI），回答并驱动地图（定位/路线/人物/战役）。

## 数据来源与限制
- 历史疆域与政区参考：谭其骧主编《中国历史地图集》、CHGIS、Robert M. Hartwell China Historical GIS、aourednik/historical-basemaps；现代省界：DataV GeoAtlas。
- 源自 CHGIS / Hartwell 的政区与疆域数据受其原始条款约束，**仅限学术、非商业用途**；本站不投放广告、不收费。
- 先秦疆域为依据城邑归属推定的**示意性近似**；前 841 年以前年代采夏商周断代工程，均为约数；夏代为传说时代。