介绍
# BrainRepo
您的个人知识库。快速捕捉，自动整理，即时检索。
## Brain Location
**固定路径：** `~/Documents/brainrepo/`
这是不可配置的。所有大脑数据都存放在这里。
## First Run Check
**执行任何操作之前**，检查 brainrepo 是否已初始化：
1. 检查 `~/Documents/brainrepo/` 是否存在且具有预期的结构（Inbox/, Projects/, Areas/） 2. 如果未找到 → **自动运行入门引导** 3. 如果已找到 → 继续处理用户请求
## Onboarding
在首次交互时自动触发，或者当用户说“set up brainrepo”时触发：
1. 在 `~/Documents/brainrepo/` 创建大脑 2. 创建文件夹结构：
```bash mkdir -p <path>/{Inbox,Projects,Areas/personal-growth,Areas/family,Notes,Resources,Journal,People,Tasks,Archive} ```
3. 从 `assets/templates/` 中的模板创建初始文件： - `Tasks/index.md` — 任务中心 - `Areas/personal-growth/index.md` — 个人成长领域 - `Areas/family/index.md` — 家庭领域
4. 初始化 git（可选）： ```bash cd <path> && git init && git add -A && git commit -m "init: brainrepo" ```
5. 确认设置并显示快速开始命令
## Core Concept
**DUMP → PROCESS → RETRIEVE**
1. **Dump（转储）** — 将所有内容捕捉到 Inbox/（暂不整理） 2. **Process（处理）** — 晚间复盘：Inbox → 永久归宿 3. **Retrieve（检索）** — 让 AI 查找任何内容
## Repository Structure
``` brainrepo/ ├── Inbox/ # Quick capture (clear daily) ├── Projects/ # Active work with deadlines ├── Areas/ # Ongoing responsibilities (no deadline) ├── Notes/ # Permanent atomic knowledge ├── Resources/ # External links, articles, references ├── Journal/ # Daily notes (YYYY-MM-DD.md) ├── People/ # One note per person ├── Tasks/ # Centralized task tracking └── Archive/ # Completed projects ```
详细信息请参阅 [references/structure.md](references/structure.md)。
## Capture Rules
### What to Capture (Immediately)
| 类型 | 目标位置 | 示例 | |------|-------------|---------| | 快速想法 | `Inbox/` | “也许我们应该……” | | 做出的决定 | `Inbox/` 或 `Notes/` | “决定使用 Next.js” | | 人员信息 | `People/` | 新联系人或更新信息 | | 项目更新 | `Projects/<name>/` | 会议记录，进度 | | 任务/待办 | `Tasks/index.md` | “需要完成 X” | | 链接/文章 | `Resources/` 或 `Inbox/` | 带有上下文的 URL | | 个人成长 | `Areas/personal-growth/` | 健康，习惯，学习 | | 家庭信息 | `Areas/family/` | 重要日期，笔记 |
### What NOT to Capture
- 没有信息价值的闲聊 - 临时查询（例如“现在几点了”） - 网上容易搜索到的信息
## Note Format
每条笔记都使用最简 frontmatter：
```markdown --- created: YYYY-MM-DD tags: [tag1, tag2] related: ["[[Other Note]]"] ---
# Title
Content here. Link to [[Related Notes]] freely. ```
创建新笔记时，请使用 `assets/templates/` 中的模板。
## Daily Workflow
### During Day（白天） - 将所有内容转储到 `Inbox/` - 不要整理 —— 只管捕捉
### Evening（晚间，5-10 分钟） 处理 Inbox/： 1. 每个项目 → 移至永久位置或删除 2. 更新 `Journal/YYYY-MM-DD.md` 并添加摘要 3. `git commit -am "daily processing"`
## Weekly Review (Sunday, 15 min)
1. 复盘所有 Projects/ — 是否仍然活跃？ 2. 检查 Areas/ — 是否有被忽视的内容？ 3. 将已完成的项目移至 Archive/ 4. 更新 `Tasks/index.md`
详细工作流程请参阅 [references/workflows.md](references/workflows.md)。
## Commands
| 用户说 | 操作 | |-----------|--------| | "Set up brainrepo" | 运行入门引导，创建结构 | | "Save this: [text]" | 捕捉到 Inbox/ | | "New project: [name]" | 使用模板创建 Projects/name/ | | "Add person: [name]" | 使用模板创建 People/name.md | | "What do I know about X?" | 搜索并检索 | | "Daily review" | 处理 Inbox/，更新 Journal/ | | "Weekly review" | 全系统复盘 |
## Linking
使用 `[[wiki-links]]` 连接笔记：
```markdown Met with [[People/john]] about [[Projects/acme/index|ACME Project]]. Relevant insight: [[Notes/negotiation-tactics]] ```
## Projects vs Areas
| Projects（项目） | Areas（领域） | |----------|-------| | 有截止日期 | 无结束日期 | | 可以“完成” | 永久维护 | | 特定结果 | 维持的标准 |
## File Naming
- 文件夹：`kebab-case/` - 文件：`kebab-case.md` - 日期：`YYYY-MM-DD.md` - 人员：`firstname-lastname.md`
## References
- [Structure Guide](references/structure.md) — 详细文件夹说明 - [Workflows](references/workflows.md) — 每日/每周/每月工作流程 - [Templates](assets/templates/) — 笔记模板