开源个人知识库技能，支持分类存储人物、地点、科技、媒体等实体信息，内置语义搜索与附件管理，可选QMD增强检索
说明：
## Brain Skill 综合评估
Brain 是 OpenClaw 框架下的**个人知识管理（PKM）技能**，旨在构建用户专属的”第二大脑”，用于捕获、组织和检索关于人物、地点、事物及想法的结构化信息。
### 核心用法
该技能采用**分类目录架构**，将知识实体划分为8大类别：人物（people）、地点（places）、游戏（games）、科技（tech）、事件（events）、媒体（media）、想法（ideas）和组织（orgs）。每个实体以独立 Markdown 文件存储，支持 YAML 前置元数据与维基链接式实体关联，便于构建知识图谱。
**触发机制**高度智能化——当用户提及”remember”、”met this person”、”visited”等关键词，或询问”what do I know about”时自动激活。技能会优先检索现有条目，避免重复创建；若存在歧义（如多个”John”），则启动消歧协议，列出候选项供用户确认。
搜索层面提供双重方案：
– **基础模式**：直接调用 OpenClaw 内置的 `memory_search` 和 `memory_get` 工具，零配置即用
– **增强模式**：可选集成 QMD（Query My Documents）后端，支持 BM25 + 向量嵌入 + 重排序的混合检索，显著提升语义搜索精度
**附件管理**是亮点功能——用户发送的照片、PDF、音视频等原始文件**强制保存**至 `attachments/` 目录，同时提取文字内容写入主体文件，实现”可搜索的摘要 + 可溯源的原件”双重保障。
### 显著优点
1. **零外部依赖的默认方案**：内置搜索能力确保开箱即用，降低入门门槛
2. **优雅的降级设计**：QMD 可选安装，未配置时自动回退至基础检索，系统健壮性强
3. **严格的实体优先级规则**：明确区分 brain 条目与 daily log 的边界，避免知识碎片化
4. **结构化模板驱动**：预设8类模板规范数据录入，保证长期可维护性
5. **双模式搜索策略**：兼顾简单关键词匹配与复杂语义查询场景
### 潜在局限与风险
1. **本地文件系统依赖**：所有数据存储于 `~/.openclaw/workspace/brain/`，无内置云同步机制，跨设备使用需自行配置同步方案
2. **QMD 增强功能门槛**：虽然标注为”可选”，但若要获得生产级语义搜索体验，需安装 Bun 运行时并全局安装 QMD CLI，对非技术用户存在操作成本
3. **附件存储膨胀风险**：强制保存原始媒体的策略，在长期高频使用下可能导致存储体积快速增长，缺乏自动清理或压缩机制
4. **消歧协议的人机交互成本**：遇到常见姓名时需用户手动确认，在高频交互场景中可能产生摩擦
5. **Markdown 格式的可移植性限制**：虽便于版本控制，但与 Notion、Obsidian 等商业 PKM 工具的互操作性有限
### 适合人群
– 注重**数据主权**、倾向本地优先存储的技术从业者
– 已有 OpenClaw 使用基础、希望扩展个人知识管理的现有用户
– 需要**高频记录人脉、行程、消费体验**的重度信息囤积者
– 愿意投入时间维护结构化笔记、追求长期知识复利的学习者
### 常规风险提示
– **数据备份责任完全在用户**：本地存储意味着丢失风险，建议配合 Git 或云同步工具使用
– **附件敏感信息泄露**：原始照片/文档可能包含 EXIF 地理位置、财务信息等敏感元数据，需注意存储安全
– **QMD 后端的状态一致性**：若切换后端或路径配置，可能出现索引失效，需手动重建
