# 江山时序 · 奥尊镜像改动说明（CHANGES-aozsoft）

本目录是开源项目 **江山时序 / Jiangshan Atlas** 的镜像，经 **新疆奥尊智联网络科技有限公司（aozsoft.com）** 做网络本地化修改，供微信服务号「奥尊智问」菜单「教育课件」内使用。

- 原项目：https://github.com/DeanChensj/jiangshan-map （原作者 DeanChensj 及 Jiangshan Atlas Contributors）
- 原站：https://deanchen.me/jiangshan-map/
- 基于上游提交：`f1520c2ef5b3455b4ce34aba27359f1a12f198ac`（2026-11-02）
- 许可证：GNU GPL-3.0，全文见同目录 `LICENSE`（未改动）。本镜像整体（含修改）同样按 GPL-3.0 提供；
  本目录下发布的 HTML/CSS/JS 即为修改后的完整对应源码，可直接获取。
- 镜像日期：2026-11-02

## 改动清单

### 1. 只保留运行所需文件
保留：`index.html`、`css/`、`js/`（运行时脚本）、`topics/`（静态专题页）、`assets/favicon.svg`、`assets/icons/`、`assets/terrain_relief.webp`、`manifest.webmanifest`、`LICENSE`。
未带：`.git/`、`.github/`、`scripts/`、`skills/`、`docs/`、`geojson/`（开发/外部集成示例，页面未引用，且 demo 依赖 unpkg）、README/CONTRIBUTING、`hero_demo_*.webp`、`preview_*.webp`、`sitemap.xml`、`robots.txt`、`llms.txt`。

### 2. 去外部依赖（国内网络可用）
- 删除 Google Fonts（Noto Serif SC / Noto Sans SC / Ma Shan Zheng）及 preconnect；改用系统字体栈（`css/style.css` 中 `--serif-stack` / `--sans-stack` 增加 Noto CJK、思源、华文宋体、冬青黑等本机字体候选），未引入任何字体文件。
- 删除 Cloudflare Web Analytics（static.cloudflareinsights.com）与 vercount 计数（events.vercount.one）——index.html 与全部 topics/*.html。
- 古琴雅乐 5 首音频原外链 upload.wikimedia.org：下载到 `assets/audio/` 并转码为 MP3 单声道 40kbps（署名见 `assets/audio/ATTRIBUTION.txt`）；`js/lore_data.js` 中 `GUQIN_TRACKS` 改为相对路径，`ogg` 字段置空；`js/app.js` 播放器的 ogg 回退改为“有 ogg 才回退”（两处小改，带 `aozsoft` 注释）。
- 写死的 `https://deanchen.me/jiangshan-map/`：
  - index.html：删除 canonical、hreflang alternate、og:url、og:image、twitter:image、JSON-LD 结构化数据；隐藏 SEO 目录里的链接改为相对路径 `./`。
  - topics/*.html：同样删除 canonical / mobile-agent / og:url / og:image / twitter:image / JSON-LD；站内链接改为相对路径 `../`；页脚原站链接改为原作者署名 + GitHub 源码链接，去掉 Sitemap / LLMs.txt 链接。
  - js/app.js：`baseSiteUrl` 两处改为 `'./'`（仅用于动态 SEO meta 与隐藏目录）。
- `manifest.webmanifest`：name 标注“奥尊镜像”。

### 3. 不被搜索引擎收录
index.html 与 topics/*.html 的 robots 改为 `noindex, nofollow`（仅微信内使用的镜像，避免与原站重复）。

### 4. 仅微信内打开
新增 `wx-gate.js`（与奥尊 edu-3d-lab 相同判断：UA 含 MicroMessenger 放行，127.0.0.1/localhost 本地预览放行，无访问码），在 index.html 与 topics/*.html 的 `<head>` 最前加载；非微信环境停止加载并显示「请在微信中打开，关注服务号「奥尊智问」点菜单「教育课件」进入」。

### 5. 署名
index.html 侧栏免责声明下方新增一行小字：原项目名、原作者、GPL-3.0、GitHub 源码链接、LICENSE、本改动说明、古琴音频署名。原作者版权声明、GitHub 按钮与 LICENSE 均保留未删。

界面默认中文（上游默认即简体中文，未改）。以上 1–5 项只做网络本地化，未改地图数据与历史内容；2026-11-02 的内容修订见文末。

## 2026-11-02 追加
- 去掉右上角 GitHub Star 按钮；页面内所有 GitHub 超链接改为纯文字源码地址（国内无法访问 GitHub），源码出处仍保留以符合 GPL-3.0。

## 2026-11-02 内容修订（按国内通行表述校对时间轴）
依据同日审校记录，修改「必须改」2 项、「建议改」9 项；「可不改」几项保持原样。数据改在 `js/` 源数据里，专题页 `topics/*.html` 和 index.html 隐藏目录用上游生成脚本 `scripts/build_seo_topics.js` 重新生成，英文版一起改。修订脚本：`patch_2026_11_02.py`、`regen_topics_2026_11_02.py`、`rehash_2026_11_02.py`。
- **南海断续线与示意图声明**：
  - 现代（中华人民共和国）图层的南海断续线原来就有，用的是 `js/china_geo_data.js` 里公开 DataV 底图的 `100000_JD` 几何，本次没有新造坐标。现在改成深灰色。
  - 新增 `js/aoz_scs.js` 和 `css` 末尾的 `aoz-scs` 样式：现代图层在地图右下角显示「南海诸岛」附图框，只显示，不响应点击；地图左下角常驻提示「本图为历史示意图，疆域与界线为示意性近似，非精确测绘，不作为权属依据。」。
  - 侧栏免责框、专题页页脚、英文免责文字同步更新。
- **1949 渡江战役**：改为「解放南京，宣告国民党在大陆统治的覆灭；国民党残余势力退踞台湾」。
- **朝代起止年**：战国、秦、西汉、西晋、南北朝、元的标注年份改为教科书通行年份（前475、前206、8、265、589、1271）。地图图层的实际范围保持不变，朝代年份处的悬停说明和专题页「图层说明」写明图层的实际起止。专题总览注明本图集起于战国，不含夏商周。
- **1281 澎湖巡检司**：改为「隶泉州路，管辖澎湖、琉求（今台湾）」。
- **1931、1937**：改为「中国局部抗战开始」和「全民族抗战开始」。
- **台北地标**：「宝岛首府」改为「台湾省会」。
- **英文译名**：
  - 唐宋时期政权译为 Tubo；元以后的地区和当代地名译为 Xizang（如 Xizang Autonomous Region、Qinghai–Xizang Railway）。
  - 17 条协议的英文表述按官方说法修订。
  - 「经营西番」一条按审校意见保留原文。
- **英文用词**：阿古柏政权、准噶尔与大小和卓叛乱的英文措辞改为平定、收复；郑成功一条改为驱逐荷兰殖民者、收复台湾；明郑政权译为 Ming-Zheng Regime (Dongning)。
- **1912—1949 邻国标注**：俄国、苏俄、苏联按年份分别标注；外蒙古标为「外蒙古（中华民国·自治）」或「外蒙古（中华民国领土，苏联控制）」，1946 年后的标注不变。
- **台湾建省**：年份由 1887 年改为 1885 年，表述为「清政府设立台湾省」。
- index.html 中静态资源的 `?v=` 缓存版本号已按文件内容重新计算。
- 网络本地化各项保持不变：无 GitHub 超链接，无外部请求，保留 wx-gate.js 微信访问限制和 noindex，古琴音频仍为本地文件。