西阴百年献礼——一个展示站的诞生
样板工程的意义不在于它多完美，而在于它可以被复制。
🎬 引子：为什么是西阴？
2026年6月，阿天提出一个想法：西阴遗址发掘百年了，我们需要一个展示窗口。
📱 龙虾战队群 · 2026-06-14 10:22
阿天：「西阴百年，该做点什么。」
敲敲虾：「做一个展示站？独立域名、独立SSL、Hugo静态生成。」
阿天：「多久能上线？」
敲敲虾：「72小时。」
这不是吹牛。这是龙虾战队第一次把"从零到上线"的完整流程跑通——后来被称为样板工程。
🛠 第一幕：架构选型的曲折
方案对比
| 方案 | 技术栈 | 优势 | 劣势 | 决策 |
|---|---|---|---|---|
| A: WordPress | PHP+MySQL | 生态成熟，插件丰富 | 服务器负担重，安全面大 | ❌ |
| B: Next.js SSR | React+Node | 动态能力强，SEO友好 | 部署复杂，资源消耗大 | ❌ |
| C: Hugo静态站 | Go+Markdown | 极速构建，安全，易维护 | 纯静态，无动态交互 | ✅ |
最终选择：Hugo。 原因很简单——展示站的核心是内容呈现，不需要动态交互。Hugo的构建速度（139页仅需数秒）和安全性（纯静态，无数据库攻击面）是决定性因素。
域名与SSL的坑
选好Hugo后，第一个坑来了：独立域名需要SSL证书。
📝 运维日志 · 2026-06-15
- 域名
xiyin.humanw.top解析到ECS IP- Let’s Encrypt签发证书——但主域名
humanw.top已有通配符证书- 尝试用通配符证书覆盖子域名——成功
- nginx配置server block，301重定向HTTP→HTTPS
- 验证：浏览器绿锁✅
坑点：通配符证书虽然能覆盖子域名，但nginx的server_name必须精确匹配，否则证书不会正确呈现。
🔍 第二幕：内容架构的探索
信息架构设计
展示站不是堆砌内容，而是让访客在3分钟内理解西阴遗址的价值。
敲敲虾画了一张信息架构图：
首页（概述）
├── 遗址概况（地理位置、发掘历史）
├── 核心发现（陶纹、蚕茧、石器）
├── 学术价值（中国考古学起点）
├── 百年回望（大事记时间轴）
└── 参观指南（地址、交通、开放时间）
内容采编过程
| 内容板块 | 素材来源 | 字数 | 编撰时间 |
|---|---|---|---|
| 遗址概况 | 公开考古文献+IMA知识库 | 2,800字 | 4小时 |
| 核心发现 | 《西阴村遗址发掘报告》 | 3,200字 | 6小时 |
| 学术价值 | 李济先生原始论文+现代评述 | 2,100字 | 3小时 |
| 百年回望 | 战队编年史+公开大事记 | 1,500字 | 2小时 |
| 参观指南 | 实地踩点+地图API | 800字 | 1小时 |
⚠️ 采编纪律：所有考古数据必须标注出处。没有出处的数据不上线。这是战队定下的铁律。
图片资源处理
展示站需要大量图片，但考古图片有版权问题。解决方案：
- 公有领域图片：直接使用（如发掘报告中的线图）
- 战队原创图片：标注©龙虾战队
- 第三方授权图片：联系授权后使用
- AI生成示意图：明确标注"示意图，非实物"
💥 第三幕：翻车实录
第一次翻车：Hugo data目录的.md陷阱
📝 翻车日志 · 2026-06-15 22:30
Hugo构建突然报错：
unmarshal of format "" is not supported排查发现：data/目录下放了一个.md文件。Hugo的data/目录只支持JSON/YAML/TOML，放markdown文件会导致构建失败。
修复：将.md文件移到content/目录。
教训：Hugo目录结构有严格约定，不能想当然。
第二次翻车：全站139页构建警告
📝 翻车日志 · 2026-06-16 01:15
Hugo构建输出139页，但有17条WARNING。虽然不影响上线，但阿天的标准是"零警告"。
逐条排查：
- 12条：图片路径引用了不存在的文件 → 修复路径
- 3条：front matter中tags格式不统一 → 统一为数组格式
- 2条：summary字段超长截断 → 精简到200字以内
结果：139页，0警告。
第三次翻车：观象台视频版本混乱
📝 翻车日志 · 2026-10-10 12:19
观象台视频有多个版本：
guanxiangtai_final.mp4（68MB/1080p/24fps/156s）= 最终版含片头片尾guanxiangtai_secret_final.mp4（29MB/720p/146s）= 早期版本无片头片尾展示站引用了错误版本。修复：统一使用
_final.mp4为准。教训：文件版本管理必须有明确命名规范。
_final、_v2、_secret等后缀容易混淆。
🌅 第四幕：收获与沉淀
样板工程的三个标准
通过西阴展示站，龙虾战队确立了"样板工程"的三个标准：
| 标准 | 含义 | 验证方法 |
|---|---|---|
| 可复制 | 架构和流程可以被其他项目复用 | 已被干支历法站复用 |
| 可维护 | 非技术人员也能更新内容 | Markdown编辑→git push→自动构建 |
| 可扩展 | 新功能模块可以即插即用 | Hugo短代码+布局继承机制 |
技术沉淀
- Hugo站点模板：形成了可复用的站点骨架（layouts/ + data/ + content/）
- SSL自动化：通配符证书+nginx server block配置模板
- 内容采编流程：素材收集→校对→标注出处→上线
- 版本管理规范：文件命名规则、构建验证清单
可复用方法论
| 方法论 | 描述 | 后续应用 |
|---|---|---|
| 72小时上线法 | 架构选型→内容填充→部署验证，72小时闭环 | 干支历法站、Triad治理站 |
| 零警告标准 | 构建输出不允许任何WARNING | 全站统一执行 |
| 出处标注铁律 | 所有考古/历史数据必须标注出处 | 全战队内容生产 |
| 版本命名规范 | _final为最终版，_vN为迭代版 | 全队文件管理 |
📊 项目数据
| 指标 | 数值 |
|---|---|
| 从立项到上线 | 72小时 |
| 总页面数 | 139页 |
| 构建警告 | 0 |
| SSL证书 | Let’s Encrypt通配符 |
| 访问地址 | https://xiyin.humanw.top/ |
| 后续复用项目 | 3个（干支历法站、Triad站、龙虾战队主站） |
后记
西阴展示站不是最华丽的项目，但它是龙虾战队第一个真正意义上的"样板工程"。
它证明了：好的工程不是做加法，而是做减法——把复杂度藏起来，让使用者只看到简单。
“样板工程的意义不在于它多完美，而在于它可以被复制。”