vault backup: 2026-07-01 22:45:02

This commit is contained in:
2026-07-01 22:45:02 +08:00
parent eaa994afd9
commit 0fca751850
2 changed files with 184 additions and 0 deletions
+3
View File
@@ -0,0 +1,3 @@
.obsidian/
.claude/
.claudian/
+181
View File
@@ -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/**:内部插件配置和缓存文件不在操作范围内。