v1.1 Quartz换MkDocs与站点加固

背景：需求迭代/2026-04/v1.1-Quartz换MkDocs与站点加固.md

---

1. 技术选型

1.1 Quartz → MkDocs Material

维度	Quartz（v1.0）	MkDocs Material
栈	Node	Python
Obsidian	wikilink 亲和	标准 Markdown / 链接为主
国内构建	OG 等外网字体依赖	pip 阿里云源相对稳
手机阅读	顶栏偏重	Material 侧栏与搜索成熟

结论：优先「手机可读 + 稳定构建」时选用 MkDocs；Obsidian 仍为唯一写作源。

1.2 安全与会话加固

• Gitea：关闭用户自助注册（仅管理员开户）。
• 移动端 Memos：Safari 添加到主屏幕 作为快捷入口（产品侧操作，不含服务器配置）。

---

2. 架构（增量）

仅 只读渲染层 由 Quartz/Node 换为 MkDocs/Python；Memos、Gitea、Nginx443、Obsidian-Git 不变。构建输出目录仍由 Nginx root 指向。

---

3. 模块

• 移除：Quartz 构建流水线（及其 Node 依赖、OG 插件等）。
• 新增/强化：Python 环境与 mkdocs-material；NO_MKDOCS_2_WARNING 等告警抑制（与 v1.3 运维一致，见 webhook 文档）。

---

4. 方案细节

4.1 Gitea app.ini

[service]
DISABLE_REGISTRATION = true

生效：docker restart gitea（路径以数据卷挂载为准）。

4.2 MkDocs 首页与 Markdown

• 仓库根保留 index.md 生成 index.html，避免 Nginx index.html 403，见问题 004。
• index.md 与根 README.md 二选一 参与站点首页，避免 MkDocs WARNING，见问题 011。
• 站内导航：标准相对链接；[[wikilink]] 在 MkDocs 不解析，见问题 013。

4.3 Memos（Nginx）

上传图：client_max_body_size，见问题 006。

4.4 Cron 日志命名

定时构建日志与当前栈一致（如 mkdocs-build.log），见问题 012。

---

5. 关联

部署命令全集见 搭建轻量个人知识库.md 第五节（已为 MkDocs 表述）。
Quartz 期典型故障见 问题修复记录 条目 003–004。