核心用法
Research Assistant 是一个面向 Agent 的研究组织与知识管理工具，通过命令行接口实现笔记的结构化存储与检索。核心功能包括：
1. 笔记管理：add 添加带标签的笔记，list 浏览主题，show 查看详情
2. 全局搜索：search 跨所有笔记和主题进行不区分大小写的内容检索
3. 安全导出：export 将主题导出为 Markdown 文件，支持版本控制与分享
数据以 JSON 格式存储于 ~/.openclaw/workspace/research_db.json，包含创建时间、更新时间、标签等元数据。
显著优点
- 会话持久化：解决 Agent 无状态会话的知识流失问题，实现跨会话研究追踪
- 标签化组织：支持多标签分类，便于构建复杂的知识图谱
- 安全边界：导出功能实施路径白名单（仅允许 workspace、home、/tmp），阻止系统敏感路径写入
- Markdown 友好：导出格式整洁，含时间戳、标签哈希格式，适合直接发布或版本控制
潜在局限
- 单用户设计：无多用户隔离或权限管理
- 存储位置固定：数据路径硬编码，不支持自定义存储后端
- 搜索功能基础：仅支持简单字符串匹配，无正则、模糊搜索或相关性排序
- 无冲突解决：并发写入可能导致数据损坏（JSON 文件覆盖写）
适合人群
- 需要长期追踪研究项目的 Agent 开发者
- 进行多轮实验迭代的自动化工作流
- 需要结构化知识沉淀的内容创作者
- 构建技能库或知识库的个人/小团队
常规风险
- 数据丢失：JSON 文件损坏或误删无内置备份机制，建议定期手动备份
- 路径验证绕过：虽实现基础路径白名单，但需关注符号链接、路径遍历等绕过可能性（报告中未详述防御深度）
- 敏感信息泄露：笔记内容无加密，共享工作区或备份时需注意敏感数据
- 存储膨胀：长期积累大量笔记可能影响搜索性能，需定期归档清理