From 0fca751850f17659916727bd1dfe779e627da2b9 Mon Sep 17 00:00:00 2001 From: wonder Date: Wed, 1 Jul 2026 22:45:02 +0800 Subject: [PATCH] vault backup: 2026-07-01 22:45:02 --- .gitignore | 3 + CLAUDE.md | 181 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 184 insertions(+) create mode 100644 .gitignore create mode 100644 CLAUDE.md diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..993917a --- /dev/null +++ b/.gitignore @@ -0,0 +1,3 @@ +.obsidian/ +.claude/ +.claudian/ \ No newline at end of file diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..b5c16ae --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,181 @@ +# Claude Code 配置 — 七牛云暑期实习笔记库 + +此知识库级别的配置为 Claude 操作提供指导说明。 +在行动前，先列计划（工具调用）。 + +## 知识库上下文 + +- **用途**：记录七牛云暑期实习期间的内容 +- **主要分类**：技术学习 / 项目实战 / 周报日报 +- **标签风格**：英文为主（如 `#go`、`#redis`、`#k8s`） + +## 文件创建规范 + +### Frontmatter 模板 + +```yaml +--- +tags: [] +create time: YYYY-MM-DD HH:mm +--- +``` + +| 字段 | 格式 | 说明 | +|------|------|------| +| `tags` | 数组 | 必须存在 `[]`，智能填充相关英文标签 | +| `create time` | `YYYY-MM-DD HH:mm` | 当前系统时间 | + +### 文档结构 + +1. **## 概述** — 简短描述文档内容，不留占位文本 +2. **## 正文** — 主要内容，详略得当，注重拓展进阶 +3. **## 关联笔记** — Wiki-links 形式的 `.md` 文件链接；若无此项可移除 + +### 子文档规则 + +创建子文档时，先在同级目录下建立同名文件夹，将文件放入其中，再在父文档适当位置插入链接。示例： + +- `notes/redis.md → notes/redis/redis-internals.md` +- 并在父文档中添加 `- [[redis/redis-internals]]` + +## 文件夹命名约定 + +| 目录 | 用途 | 示例 | +|------|------|------| +| `technical/` | 技术知识点 | Go、Redis、K8s 等 | +| `projects/` | 开发项目记录 | 具体参与的模块或系统 | +| `weekly/` | 周/日报 | 按周归档的工作总结 | + +- 文件名统一使用 **kebab-case**（小写 + 短横线），如 `redis-hash-internals.md` +- 日期类文件在文件名中包含日期，如 `2026-w25-weekly-report.md` + +## 分类专属规范 + +以下规范以通用规范为基础，各目录追加其特有的格式和内容要求。 + +### technical/ — 技术学习笔记 + +侧重**知识传递与理解深化**。 + +#### 结构模板 + +```markdown +--- +tags: [技术标签] +create time: YYYY-MM-DD HH:mm +--- + +# <知识点名称> + +## 概述 +[一句话说明这个知识点是什么，解决什么问题] + +## 核心概念 +[原理、机制、关键设计决策。使用 `> [!info]` / `> [!tip]` / `> [!warning]` 等提示块突出重点] + +## 代码示例 +[Go / React/TS 优先，点到为止。注释精简，仅体现核心逻辑] + +## 常见陷阱与最佳实践 +[踩过的坑、容易误解的地方、团队约定] + +## 延伸阅读 +- 推荐阅读链接或相关笔记 +``` + +#### 写作要求 +- 穿插 **启发式问题**（如「为什么 Redis 选择跳表而非平衡树？」）引导思考 +- 关键流程必须用 **Mermaid** 图表说明，避免纯文字 ASCII 图 +- 每个代码示例后必须有 **1-2 句文字解释** +- 如果涉及对比（A vs B），用表格呈现更清晰 + +--- + +### projects/ — 项目实战记录 + +侧重**技术方案与实施过程的完整记录**。 + +#### 结构模板 + +```markdown +--- +tags: [项目标签] +create time: YYYY-MM-DD HH:mm +status: active | completed | on-hold # 可选状态字段 +--- + +# <项目/模块名称> + +## 背景 +[为什么要做？业务需求和技术动机] + +## 技术方案 +- 选型及理由 +- 架构概览（可附 Mermaid 架构图） +- 接口设计要点 + +## 实现细节 +- 关键代码片段（附解释） +- 遇到的问题及解决过程 +- 性能优化或权衡取舍 + +## 结果与验证 +- 上线效果 / 测试覆盖 / 监控指标 +- 后续 TODO 或改进方向 + +## 关联笔记 +- [[相关笔记]] +``` + +#### 写作要求 +- 保持 **客观记录风格**，少抒情多事实 +- 每次迭代或里程碑更新时补充进度，而非重写全文 +- API 变更、数据库 schema 调整等应附带具体 diff 或结构说明 + +--- + +### weekly/ — 周报/日报 + +侧重**结构化总结与快速回顾**。 + +#### 结构模板 + +```markdown +--- +tags: [weekly] +create time: YYYY-MM-DD HH:mm +week: W25 # 第几周 +--- + +# 2026-W25 Weekly Report + +## 本周完成 +- [ ] 任务描述 + 简要成果 +- [ ] 任务描述 + 简要成果 + +## 问题 / 阻塞 +- 描述当前卡点及影响范围 +- 已尝试的解决方案 + +## 收获 / 反思 +- 学到的新知识点 +- 做得好的 / 可以改进的地方 +- 待办事项 & 下周计划 +``` + +#### 写作要求 +- 简洁条目式，不展开长段落 +- 每条完成后打 `[x]`，未完成保留 `[ ]` +- 「问题 / 阻塞」板块用于向上同步风险，务必诚实标注 +- 日期按周归档，文件名格式：`2026-w25-weekly-report.md` + +--- + +## 内容风格 + +以下为贯穿所有分类的基础原则： + +- **文风**：严谨但不失"活人感"，循序渐进，深入浅出。 +- **最小读取**：只读取完成任务所必需的文件，减少 Token 消耗。 +- **不确定时先问**：对文件归属分类存疑时，使用 AskUserQuestion 询问用户，而非自行猜测。 +- **不碰 .obsidian/**：内部插件配置和缓存文件不在操作范围内。