目标

构建一个能长期积累的个人知识库,与主网站保持品牌关系,但内容、部署和迭代可以独立进行。

首版决策

项目决策
域名计划使用 knowledge.heimaoai.xyz
生成器Quartz 5,Markdown 作为内容源
语言中文默认 /,英文 /en/
部署目标计划使用 Cloudflare Pages;当前没有部署
发布保护只有 publish: true 的笔记进入构建
搜索与关系图中文、英文分别构建,不混用索引
字体本机系统字体,不依赖远程字体

双语实现

中文和英文文件使用镜像的 ASCII 路径,例如:

content/zh/ai-basics/ai-agent.md
content/en/ai-basics/ai-agent.md

构建时先生成中文站,再把英文站生成到 public/en/。语言切换通过相同相对路径跳转,因此以后增加第三种语言时可以继续采用同一规则。

安全边界

  • 腾讯云仍负责域名注册;目前没有改动 DNS。
  • 腾讯云高防尚未绑定业务 IP,也不属于这个静态知识库首版链路。
  • 当前只在本机完成构建和预览,没有上线、没有创建云端项目。
  • publish: false 的测试草稿会由自动检查确认没有进入公开目录。

当前阶段

首版已完成结构、双语构建、基础设计和本地验收。持续记录见项目根目录的 PROJECT_LOG.mdproject-docs/

相关:工具与工作流问题排查