结构化知识管理 · 跨会话研究追踪

结构化知识管理工具，支持多主题研究笔记的增删改查、标签分类、全局搜索及安全导出，适合长期项目追踪与知识沉淀。

基本信息

• 技能名称?Research Assistant
• 中文名称?结构化知识管理 · 跨会话研究追踪
• 作者?johstracke
• 分类?专业技能
• 版本?1.0.1
• 标签?knowledge-management, research, note-taking, productivity, data-persistence, markdown-export, session-management

使用方法

使用说明
核心用法
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 文件损坏或误删无内置备份机制，建议定期手动备份
   路径验证绕过 ：虽实现基础路径白名单，但需关注符号链接、路径遍历等绕过可能性（报告中未详述防御深度）
   敏感信息泄露 ：笔记内容无加密，共享工作区或备份时需注意敏感数据
   存储膨胀 ：长期积累大量笔记可能影响搜索性能，需定期归档清理