CLAUDE.md - Notes 知识库维护指南

本文件用于指导 Claude 在后期维护此知识库时的行为。

📁 知识库结构 (PARA)

本知识库采用 PARA 方法 组织：

0-Inbox/              # 收件箱 - 临时笔记，待整理
1-Projects/           # 项目 - 当前进行的项目
2-Areas/              # 领域 - 长期维护的技术/责任领域
3-Resources/          # 资源 - 参考资料、速查表
4-Archive/            # 归档 - 已完成的内容
5-MOC/                # 内容地图 - 索引和导航

详细说明

2-Areas/ 技术栈分类：

  • 工作/数据库开发/ - 当前工作相关（向量索引等）
  • 技术栈/Go/ - Go 语言
  • 技术栈/Redis/ - Redis
  • 技术栈/数据库/ - MySQL, MongoDB, GORM
  • 技术栈/网络与安全/ - 网络安全
  • 技术栈/微服务与分布式/ - gRPC, K8s, Docker
  • 技术栈/机器学习/ - PyTorch 等
  • 个人成长/ - AI 工具、学习方法

4-Archive/ 归档分类：

  • 项目归档/ - Aorb, Scoreboard, 课程系统等已完成项目
  • 求职归档/ - 面试准备资料（已上岸）
  • 学业归档/ - 大学课程笔记
  • 论文/ - 学术论文

📝 笔记规范

Frontmatter 格式

所有笔记必须包含以下 frontmatter：

---
title: "笔记标题"
date: 2026-04-10
tags:
  - tag1
  - tag2
draft: false  # true = 不发布到博客
---

标签体系

技术标签： #go #redis #mongodb #mysql #docker #kubernetes #grpc #微服务

类型标签： #项目 #笔记 #命令速查 #面试 #问题记录

状态标签： #draft #published #archived

PARA 标签： #para-project #para-area #para-resource #para-archive

🔄 博客发布流程

本知识库通过 Git 子模块与 Hugo 博客关联：

Obsidian Vault (iCloud) 
    ↓ 手动/自动同步
Notes Repo (private) 
    ↓ Git 子模块
Hugo Blog (public) → GitHub Pages

发布步骤

  1. 编辑笔记（Obsidian 或 Notes 仓库）
  2. 设置发布状态：
    • draft: true - 私密/未完成，不发布
    • draft: false - 发布到博客
  3. 提交到 Notes 仓库：
    cd /Users/hao/Developer/Projects/Notes
git add .
git commit -m "update: xxx"
git push
  4. 更新博客子模块：
    cd /Users/hao/Developer/Projects/sirius2alpha.github.io
git add content/posts/Notes
git commit -m "update: 同步 Notes"
git push
  5. 编译部署：
    ~/bin/hugo --gc --minify
# 或使用 blog-commit.sh 脚本
./blog-commit.sh

🔧 常用维护任务

添加新笔记

  1. 放入 0-Inbox/ 暂存
  2. 整理到对应 PARA 分类
  3. 添加 frontmatter 和标签
  4. 在 5-MOC/README.md 中更新索引
  5. 提交到 Git

整理收件箱

定期清理 0-Inbox/，将笔记移动到正确的 PARA 分类。

归档已完成的项目

  1. 将 1-Projects/ 中的项目移动到 4-Archive/项目归档/
  2. 更新 5-MOC/ 中的相关索引
  3. 修改 frontmatter 添加 #archived 标签

同步 Obsidian 到 Notes

如果使用 Obsidian（iCloud）编辑：

rsync -av --exclude='.obsidian' --exclude='.git' \
    "/Users/hao/Library/Mobile Documents/com~apple~CloudDocs/ObsidianVault/" \
    /Users/hao/Developer/Projects/Notes/

📍 重要路径

位置路径
Notes 仓库/Users/hao/Developer/Projects/Notes
Obsidian Vault/Users/hao/Library/Mobile Documents/com~apple~CloudDocs/ObsidianVault
Hugo 博客/Users/hao/Developer/Projects/sirius2alpha.github.io
Hugo 可执行文件~/bin/hugo
博客子模块content/posts/Notes

⚠️ 注意事项

  1. 不要删除 .obsidian/ 文件夹 - 包含 Obsidian 配置
  2. 保持 frontmatter 完整 - Hugo 编译依赖这些元数据
  3. 中文文件夹名 - 已使用中文 PARA 文件夹名，保持统一
  4. draft 控制发布 - 只有 draft: false 的笔记会发布到博客
  5. 子模块更新 - 修改 Notes 后记得更新博客子模块引用

🆘 常见问题

博客编译失败

检查 Hugo 版本：

~/bin/hugo version

检查 frontmatter 格式是否正确（YAML 语法）。

子模块未更新

cd /Users/hao/Developer/Projects/sirius2alpha.github.io
git submodule update --init --recursive

笔记同步冲突

优先以 Obsidian Vault（iCloud）为准，rsync 前备份 Notes 仓库。

📅 维护记录

  • 2026-04-10 - 重构为 PARA 体系结构

本文件由 Claude 生成，用于后续维护指导