网站部署与维护

整个网站已生成到仓库的 html/ 文件夹，入口为 html/index.html。站点包含首页、全部文档阅读页、两份 PDF 预览页、原版旅行手册、版本导航、搜索以及原文件下载。

直接部署

将 html/ 文件夹内的所有内容原样上传到服务器网站目录，包括 assets/ 与 files/ 子目录。
将默认首页设为 index.html，保持 UTF-8 编码。
浏览器打开对应网址即可。不需要后端、数据库、Node.js、在线 Markdown 渲染器或外部 CDN。

可以部署到域名根目录，也可以部署到 /mangshi/ 等子目录。所有内部链接均为相对路径，不需要改域名或配置路由重写。服务器应提供标准 HTML、CSS、JavaScript、PDF MIME 类型。

不要只上传 index.html，也不要只上传 HTML 文件而漏掉 assets/ 和 files/。files/ 保留所有原始文档，PDF 预览也从该目录加载。

本地查看

直接双击 html/index.html 可以阅读页面和搜索。PDF 是否支持内嵌预览取决于浏览器；页面同时提供“打开原文件”和“下载原文件”。

也可在仓库目录运行本地静态服务器：

python -m http.server 8080 --directory html --bind 127.0.0.1

随后访问 http://127.0.0.1:8080/ 。

文档与版本

主攻略、随身速查、来源与核验、原版旅行手册分别有独立入口。
Claude / Opus 5.5、Grok 第一版、Grok 第二版、Gemini 3.8 Flash 分开归类。
参考资料的原文件不改写；网页只负责排版与导航。
首页搜索覆盖 Markdown 与原版 HTML 手册正文。PDF 仅按标题、版本和简介索引，正文可使用浏览器 PDF 阅读器查找。
原文清单以只读勾选框呈现，不保存勾选进度。
manifest.json 记录全部资料对应的网页、原文件路径及 SHA-256 校验值。
网站标题和版本标注用于区分来源，各参考版本不代表已合并进入主攻略。

更新后重新生成

仓库已经提交生成好的网站。以下步骤只在修改源文档、增加资料后需要执行，部署成品不需要安装任何依赖。

先创建 Python 虚拟环境：

python -m venv .venv-site

Windows PowerShell：

.\.venv-site\Scripts\python.exe -m pip install -r scripts/requirements-site.txt
.\.venv-site\Scripts\python.exe scripts/build_site.py
.\.venv-site\Scripts\python.exe scripts/check_site.py

Linux / macOS：

.venv-site/bin/python -m pip install -r scripts/requirements-site.txt
.venv-site/bin/python scripts/build_site.py
.venv-site/bin/python scripts/check_site.py

构建脚本读取仓库根目录及参考资料/中的 Markdown、PDF 和 HTML 文档。已知资料保持固定网页地址，新增资料自动生成入口。生成后重新上传整个 html/ 文件夹即可。

修改或删除源文件后，构建脚本会清理上一次生成且本次已不再需要的页面和原文件副本；不要在 html/ 内手工维护其他文件。源文档和参考资料目录才是维护入口。

便携性

首页、阅读页、样式与搜索均可离线使用。原文中的外部网站链接仍需联网。PDF 预览使用浏览器自带阅读器，不额外引入第三方服务。