ANTIMERIDIAN
目录 →
研究与项目 / 研究文库 / Antimeridian 工程手册
The Antimeridian Engineering Handbook · 03

02 · 构建与部署:一条命令

全站的生死线:python3 buildsite.py 一条命令从源文件重建整站(含 68 部展品重新加密),wrangler pages deploy 一条命令上站,三路 SHA 验收。构建不过就拒绝产出——坏构建永远到不了线上。

Chapter 3/7字符 964结构标题 4表格 0
English library directory → · 正文保留原文语言
PLATE 01 / CHAPTER STRUCTURE02 · 构建与部署:一条命令01构建流水线02加密体系(68 部付费)03部署与验收04方法学沉淀CHAPTER3/7CHARACTERS964PARAGRAPHS5TABLES0
按原文章节顺序展示前五个结构节点;不足三个标题时补入原文句子。箭头表示阅读顺序,不表示因果关系。
BOOK SKYLINE & CHAPTER POSITION · 03 / 07Antimeridian 工程手册CURRENT CHARS964SECTIONS4POSITION3/7
Plate 02 · 全集 7 篇的字符数;黄色为当前篇。高度按全集最长篇归一化。
PLATE 03 / SECTIONS 1–5段落结构与篇幅 / 字符数导言 · 02 · 构建与部…120构建流水线375加密体系(68 部付费)154部署与验收175方法学沉淀140
按标题至下一标题的独占区间统计非空白字符(含 Markdown 标记)。每幅图独立归一化;篇幅不代表重要性或证据强度。
核心命题结构拆解边界条件原文核验
全站的生死线:python3 buildsite.py 一条命令从源文件重建整站(含 68 部展品重新加密),wrangler pages deploy 一条命令上站,三路 SHA 验收。构建不过就拒绝产出——坏构建永远到不了线上。构建流水线 → 加密体系(68 部付费) → 部署与验收 → 方法学沉淀原文《02 · 构建与部署:一条命令》未单列边界标题;请在正文核对假设、时间与适用范围。回到下方原文核对“构建流水线”;本章 4 个结构标题、0 张表。

全站的生死线:python3 build_site.py 一条命令从源文件重建整站(含 68 部展品重新加密),wrangler pages deploy 一条命令上站,三路 SHA 验收。构建不过就拒绝产出——坏构建永远到不了线上。


构建流水线

manifest.json(单一事实源:展品/文集/双语对照)
   ↓ 结构校验(中英 shape 一致,不一致拒绝构建)
   ├─ md2html:文库 md 母本 → 确定性再生 HTML(悬空内链即失败)
   │    └─ /library/ 大门(集合网格 + 统计 + 搜索框)也在此生成
   ├─ storefront:展品分流——free 原样拷贝(注入 OG 与片头)
   │    paid 全部 HTML → AES-256-GCM 加密 → payload.js + 锁页
   ├─ 静态页:services / about / search 复制进 dist 根
   ├─ 搜索索引:全站标题+摘要 → search/index.json(构建时生成)
   └─ robots.txt + sitemap.xml

确定性是设计出来的:同一份源永远产出同一份站——加密有随机 IV 但按内容指纹版本化(?v=),缓存指纹保证换钥全端即刻失效。

加密体系(68 部付费)

部署与验收

部署 7 秒完成,但验收才是重点:

  1. 三路 SHA——apex、www、pages.dev 三域名抽样对拍,逐字节一致才算过
  2. 缓存陷阱——图片有 4 小时边缘缓存,裸 URL 首查可能是旧值;?cb= 复查后才下结论
  3. 付费链路抽验——payload.js 存在且是密文、锁页正常、(换钥时)新钥能解开 68 码而旧钥被 GCM 拒绝

方法学沉淀

「构建即验证」——所有检查(结构校验、悬空链接、加密对拍)长在构建里而不是靠人想起来再跑:能自动化的验收就不是验收,是构建的一部分。

部署便宜、验收贵——wrangler 七秒,验收要做三路 SHA、抽样、链路测试;省验收的每一分钟都在给线上埋雷。