# famzheng.me

自己维护的应用入口与博客，纯静态 HTML/CSS/JS。不再依赖 Hugo、PaperMod 或运行时后端。

## 开发与发布

源码：~/projects/fzc-src/blog（本机）；生产：ssh fzc。服务器只接收构建产物。

- make install：安装固定版本构建依赖。
- make test：文章完整性、站内链接、RSS、应用清单测试。
- make serve：http://127.0.0.1:4176 本地预览。
- make deploy：本机构建测试，rsync 产物，切换指定站点的挂载目录，公网验收。

应用清单集中在 apps.json：名称、简介、URL、分类、图标、访问提示。不要放密钥、分享令牌或管理初始化链接。

文章在 content/posts/<slug>.md，保留 YAML frontmatter（title/date/summary/draft/tags）。文件名就是永久 URL。原有 11 篇文章全文、/posts/、/about/、标签、归档、分页旧地址、RSS 和 /demos/ 均保留。

assets/ 是独立设计；首页无外部字体、分析脚本或 JS 框架。过滤是渐进增强，无 JS 仍可浏览全部入口。只有含 Mermaid 的文章按需加载固定版本渲染器，失败保留文本。

## 部署边界与回滚

沿用 gnoc-hugo/hugo 的 nginx、Service、Ingress 与 TLS；名称是历史兼容，不再运行 Hugo。
每次产物上传到 /var/gnoc/site-releases/<timestamp>-<commit>，只更新该 Deployment 的 site hostPath；失败恢复原目录。
原 /var/gnoc/hugo-public 和每版发布目录保留，可回滚 Deployment 或改回发布时显示的旧路径。
Gitea、其他子域名、数据库及私人应用数据不受影响。CI 仅校验，不再在服务器重建站点。

## 文风

第一人称、自然简洁。原文不为改版而改写；不要替作者捏造经历、观点或项目能力。