SuperAPI AI 工具集

hivemind-memory

办公与效率

查看项目

更新于 10-15 11:25

技能介绍

Hivemind Memory 是 Activeloop 推出的全局记忆插件,用于让团队与组织内的会话、用户和智能体共享同一份记忆,并与 Claude 内置的按项目个人记忆配合使用。

用途

该插件用于在组织范围内统一保存与检索上下文信息。官方说明中强调:当用户要求回忆、记住或查找任何信息时,必须同时查询内置记忆和 Hivemind 记忆两个来源。内置记忆路径为 ~/.claude/,属于个人按项目的笔记;Hivemind 全局记忆路径为 ~/.deeplake/memory/,在所有会话、用户和智能体之间共享。

记忆结构

全局记忆目录采用分层结构:

  • index.md:入口文件,包含所有会话的表格。
  • summaries/:存放按会话生成的 wiki 摘要,例如 session-abc.md。
  • sessions/<username>/:存放原始会话数据,为 JSONL 文件,文件名形如 user_org_ws_slug.jsonl。

检索方式

官方的检索顺序是先读取 ~/.deeplake/memory/index.md 快速浏览所有会话的日期、项目与描述;如需细节,再读取 summaries/ 下对应会话的摘要;只有需要原始数据时才读取 sessions/ 中的 JSONL 文件。也可以使用 grep 进行关键词搜索,例如 pattern="keyword" path="~/.deeplake/memory"。官方明确提示:不要直接跳到读取原始 JSONL 文件,应始终从 index.md 和 summaries 开始。

组织管理

插件的认证命令路径会在会话开始时注入,使用时需采用会话上下文中给出的确切路径。每个参数应分开书写,不要把子命令合并加引号。可用的操作包括:login(SSO 登录)、whoami(显示当前用户与组织)、org list(列出组织)、org switch <name-or-id>(切换组织)、workspaces(列出工作区)、workspace <id>(切换工作区)、invite <email> <ADMIN|WRITE|READ>(邀请成员,官方要求必须先询问用户选择哪种角色)、members(列出成员)、remove <user-id>(移除成员)以及 --help(显示全部命令)。

技能管理(skillify)

Hivemind 可以从智能体会话日志中挖掘可复用的技能,并在团队内共享。命令同样要求参数分开书写。主要能力包括:

  • hivemind skillify:显示当前范围、团队、安装位置和按项目的状态。
  • pull:把组织表中的项目技能同步到本地文件系统。支持 --user <email>(仅该作者)、--users <a,b,c>(多作者 CSV)、--all-users(明确的“无作者过滤”,默认)、--to <project|global>(安装位置)、--dry-run(预览不落盘)、--force(覆盖本地文件,会创建 .bak),也可以直接跟技能名只拉取该技能。
  • push <skill-name>:把本地技能上传到组织表,是 pull 的反向操作,重新推送会生成新版本。支持 --from <project|global> 指定读取哪个本地技能目录(默认 project)和 --dry-run。
  • unpull:移除此前由 pull 安装的所有技能。支持 --user <email>(仅该作者)、--not-mine(除自己外的全部)、--dry-run。
  • scope <me|team>:设置新挖掘技能的共享范围。
  • install <project|global>:设置新技能的默认安装位置。
  • promote <skill-name>:把项目技能移动到全局位置。
  • team add|remove|list <username>:管理团队成员列表。
  • mine-local:一次性从本地会话挖掘技能,无需认证。

语义记忆搜索(embeddings)

该能力为可选开启,配置持久化在 ~/.deeplake/config.json 中。相关命令:install(下载依赖约 600MB、建立智能体符号链接并设置 enabled:true)、enable(把 enabled 设为 true,依赖缺失需先 install)、disable(设为 false 并终止守护进程,依赖保留在磁盘)、uninstall [--prune](移除智能体符号链接并禁用,--prune 连依赖一起清除)、status(显示配置、依赖和各智能体链接状态)。

使用限制

官方强调:与 ~/.deeplake/memory/ 交互时只能使用 bash 命令(如 cat、ls、grep、echo、jq、head、tail、sed、awk 等),不要使用 python、python3、node、curl 或其他解释器,它们在记忆文件系统中不可用;如果任务看起来需要 Python,应改用 bash 工具实现,例如 cat file.json | jq 'keys | length'。另外如果某个文件在两次尝试后仍返回空内容,应跳过并继续,报告已找到的内容,而不是反复重试。

快速开始与配置

安装插件后,先运行 /hivemind:login 完成认证,随后即可开始使用记忆,提问时 Claude 会自动捕获并检索。配置项包括:设置 HIVEMIND_DEBUG=1 后运行 claude 可把详细日志写入 ~/.deeplake/hook-debug.log;设置 HIVEMIND_CAPTURE=false 后运行 claude 可关闭会话捕获。