核心用法
BrainRepo 是一套本地优先的个人知识管理系统，采用 PARA 方法（Projects/Projects/Areas/Resources/Archive）结合 Zettelkasten 卡片盒笔记法，将所有知识存储为可版本控制的 Markdown 文件。
捕获流程：用户通过自然语言指令（"save this", "remember", "brain dump"）快速将信息转储至 Inbox/ 文件夹，避免打断工作流。系统支持多种内容类型：灵感碎片、决策记录、联系人信息、项目更新、待办事项、外部链接等。
处理机制：每日晚间进行 5-10 分钟回顾，将 Inbox 内容迁移至永久位置（Projects/Areas/Notes/Resources），并更新当日 Journal。每周日执行 15 分钟系统级审查，归档已完成项目、检查责任领域状态。
检索能力：用户以自然语言查询（"What do I know about X?"），AI 基于文件命名约定、YAML frontmatter 标签、[[wiki-links]] 双向链接网络进行语义搜索与关联推荐。
显著优点
- 完全本地可控：数据以纯文本 Markdown 存储于
~/Documents/brainrepo/，无需订阅、无厂商锁定，兼容 Obsidian、VS Code、任何 Git 托管服务 - 渐进式组织："先倾倒、后整理"的设计降低认知负荷，避免完美主义导致的捕获 paralysis
- 跨代理兼容：标准化文件格式使任何支持 Markdown 的 AI 代理均可读取与操作
- 版本历史：可选 Git 初始化提供完整变更追踪与恢复能力
- 人际关系管理：独立的
People/目录支持联系人笔记与社交图谱维护
潜在缺点与局限性
- 固定路径约束：
~/Documents/brainrepo/不可配置，可能与现有工作流冲突 - 无原生同步：依赖用户自行配置 Git/Dropbox/iCloud 实现多设备同步
- 自动化程度有限："每日/每周回顾"依赖用户自律执行，系统无主动提醒机制
- 搜索质量边界：AI 检索效果受限于文件命名规范与标签一致性，缺乏全文搜索引擎的模糊匹配能力
- 移动场景薄弱：无专用移动端界面，手机捕获需通过其他工具中转
适合人群
- 重视数据主权、拒绝云笔记订阅制的隐私敏感用户
- 已使用 Obsidian/Logseq 等本地笔记工具、希望叠加 AI 辅助的进阶用户
- 需要项目与责任领域分离管理的知识工作者、自由职业者、小型团队负责人
- 愿意投入维护成本以换取长期知识复利的学习者
常规风险
- 数据丢失风险：无自动备份机制，用户需自行配置 Git 远程仓库或 Time Machine
- 结构腐化风险：长期不执行"Inbox 清零"将导致系统沦为混乱的文本堆
- 路径依赖风险：固定目录结构升级迭代困难，重度定制后难以迁移
- 隐私泄露风险：若启用 Git 同步至公共仓库，个人敏感笔记可能意外暴露