Project / Agent 与工程

Messiahub

本站:原生 HTML/CSS + Node.js 的板块化静态站点。

Markdown 内容、模板与零依赖构建脚本;四个内容板块和项目档案共用一套设计系统。

运行中

Overview 项目概述

Messiahub 是本站本身:一个用原生 HTML/CSS、Node.js 和 Markdown 维护的项目与工程记录站点。

Motivation 为什么创建

希望有一个不依赖大型框架、可长期维护,能同时放项目档案、工程笔记和少量写作的站点。

Architecture 关键架构

  • content/ 下的 Markdown 与 frontmatter 是唯一内容源;templates/ 提供页面骨架;build.mjs 生成静态 HTML、sitemap 与板块主题变量。
  • assets/ 只包含手写 CSS、少量 JS、favicon 与文章配图;没有前端框架和运行时依赖。
  • server.mjs 是静态文件服务,带 CSP、X-Content-Type-Options、Referrer-Policy 等安全头;部署侧使用 Cloudflare Tunnel。
  • 项目档案由 projects.mjs 集中维护,四个内容板块的 URL 保持不变。

Capabilities 已实现能力

  • 四个内容板块、项目档案与全部文章索引;Markdown 文章、上下篇、阅读时间、标签、sitemap 与 robots。
  • 明暗主题、键盘可用的移动导航、减少动态偏好、语义化 HTML 与跳转链接。
  • 草稿标记:draft: true 的文章不进入公开列表、计数与 sitemap。

Limitations 已知限制

  • 没有站内搜索、CMS、评论或英文版;这些不在当前版本范围内。
  • 内容规模较小时不引入数据库;文章与项目均以文件维护。
  • 部署与生产发布是独立步骤,构建成功不等于已上线。

Validation 测试与验证

  • npm run build 生成静态站点;npm run check 检查内部链接、资源与 CSP 内联风险;浏览器检查覆盖桌面与移动断点。
  • 本次升级记录了基线、变更与验证结果;生产发布需单独授权。

Resources 公开文档与链接

← 返回项目档案

Menu