Quartz 4

CLAUDE

4 min read

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

项目概述

这是一个基于 Obsidian 的个人知识管理系统 (PKM)，包含279个Markdown文件，总大小90MB。主要存储技术笔记、书籍摘要、工作记录和学习资料。

目录结构

采用数字编号的层次化组织：

  • 0-Inbox/ - 临时记录和想法收集
  • 1-Source/ - 主要知识源，包含技术书籍和网页内容
    • 11-Web/ - 网页相关内容
    • 12-Book/ - 书籍阅读笔记（约15本技术书籍）
  • 2-MOC/ - 内容地图（Map of Content），知识体系的入口点
  • 3-Weekly/ - 周报和定期总结
  • 4-Project/ - 项目相关笔记
  • 5-Dashboard/ - 仪表板和导航页面
  • 6-Cards/ - 知识卡片（约60+张），存储精炼的知识点
  • 7-Work/ - 工作相关技术记录，包含Mixer时延优化等
  • 8-Private/ - 私人内容
  • 9-daily/ - 日记（通过daily notes插件）
  • Clippings/ - 网页剪藏内容
  • z-System/ - 系统配置和模板
  • copilot-custom-prompts/ - AI助手自定义提示词（13个模板）

核心技术栈

  • Obsidian - 主要知识管理工具
  • Dataview - 数据查询和展示
  • Periodic Notes - 定期笔记管理（周报已启用）
  • Syncthing - 文件同步
  • Quartz 4 - 静态网站构建
  • Caddy - Web服务器

主要内容领域

  • C++开发 - 并发编程、性能优化、Protobuf
  • 系统架构 - 分布式系统、数据库设计、微服务
  • 云原生技术 - Kubernetes、Docker、DevOps
  • 数据库技术 - ClickHouse、存储引擎
  • 网络编程 - 高性能网络服务设计

开发规范

基于 7-Work/ 目录中的记录，遵循以下开发实践：

  • 构建系统: 使用Blade
  • 代码风格: Google C++代码规范
  • 测试框架: gtest单元测试
  • 配置管理: gflags
  • 版本控制: Git（配置了GitLens autolinks）

常用操作

添加新内容

  1. 临时记录放入 0-Inbox/
  2. 定期整理到对应分类目录
  3. 在 2-MOC/ 中更新知识地图

创建周报

使用 3-Weekly/ 目录，格式为 YYYY-Wxx.md

知识卡片

在 6-Cards/ 中创建精炼知识点，使用 YYYYMMDDHHmm 命名格式

Dataview查询

在 5-Dashboard/ 中使用Dataview插件创建动态视图，例如：

  • 读书进度追踪
  • 项目状态汇总
  • 最近修改的文件

同步和部署

  • 通过Syncthing实现多设备同步
  • 使用Quartz 4构建静态网站进行发布
  • Caddy作为Web服务器

提示词模板

copilot-custom-prompts/ 包含13个AI助手模板，支持：

  • 中英翻译
  • 内容总结
  • 语法纠错
  • 长度调整
  • 生成目录和术语表

注意事项

  • 这是一个知识库而非软件项目，主要是Markdown文档管理
  • 使用Obsidian的双向链接语法 [[wikilink]]
  • 遵循渐进式总结的工作流程
  • 技术内容偏向C++高性能开发和系统架构

Graph View